Vínculo de títulos
Na Integração Bling × Koncili o vínculo entre pedido e título é 100% automático — um job roda sozinho, 1× por dia, às 01:00 (horário de Brasília), sem nenhuma ação do time.
Como funciona — a cadeia de descoberta
O Bling liga um título de conta a receber a uma Nota Fiscal, não diretamente a uma venda — na prática, todo título vem de nota fiscal. O job segue essa cadeia sozinho:
Título em aberto
O job lista os títulos ainda não baixados no Bling.
Resolve a Nota Fiscal
Do título, descobre a Nota Fiscal e a venda de origem.
Resolve o número do pedido
Da venda, obtém o número do pedido no marketplace.
Casa com o pedido Koncili
Compara com o código do pedido já importado — evita casar pedidos de contas diferentes com o mesmo número.
Grava o vínculo
Pronto, quando a conciliação for enviada, o Koncili já sabe qual título baixar.
Regras
Nunca perde, sempre tenta de novo
O título fica "em aberto" no Bling até ser baixado — então reaparece em toda varredura diária. Uma falha (autenticação, indisponibilidade) só adia o vínculo, nunca perde.
Início da importação
Ao configurar a data de início da integração, o job irá buscar no Bling as contas a receber emitidas a partir dessa data que estejam em aberto.
Por exemplo, supondo que o Koncili tenha sido contratado para realizar a conciliação a partir de 01/07/2026, somente pedidos emitidos a partir dessa data serão importados para o Koncili.
Por isso, é importante alinhar corretamente essa data de início, evitando que o job consulte no Bling pedidos anteriores ao período em que o Koncili começou a realizar a conciliação. Esses pedidos nunca estarão disponíveis no Koncili e, consequentemente, não poderão ser conciliados.
Além de gerar consultas desnecessárias, isso pode impactar a performance do processo, principalmente em contas com um grande volume de pedidos, resultando em milhares de consultas ao Bling.
Consulta por dia, com margem de segurança
Cada consulta ao Bling contempla apenas um dia. O Koncili armazena a última data processada pelo job e, a cada nova execução, utiliza uma margem de segurança de 3 dias, por padrão, para reprocessar os dias anteriores. Dessa forma, é possível identificar pedidos que tenham sido disponibilizados no Koncili após a emissão do título no Bling.
Rede de segurança — se o job não vinculou a tempo
Resolução na hora da baixa
No momento da baixa, caso o título ainda não possua vínculo, o Koncili tenta realizar o vínculo imediatamente, buscando o respectivo pedido no Bling. Se o pedido for encontrado, o vínculo é realizado antes do envio da baixa. Caso o pedido ainda assim não seja localizado, a baixa falha, retornando o erro de documento não encontrado.