Vínculo de documentos por cobrar
En la integración Bling × Koncili, el vínculo entre el pedido y el documento por cobrar es 100% automático — un job se ejecuta por sí solo, 1 vez al día, a las 01:00 (hora de Brasilia), sin ninguna acción del equipo.
Cómo funciona — la cadena de descubrimiento
Bling vincula un documento por cobrar a una nota fiscal, no directamente a una venta — en la práctica, todo documento por cobrar viene de una nota fiscal. El job sigue esa cadena por sí solo:
Documento por cobrar abierto
El job lista los documentos por cobrar que todavía no tienen el cobro aplicado en Bling.
Resuelve la nota fiscal
A partir del documento por cobrar, descubre la nota fiscal y la venta de origen.
Resuelve el número del pedido
A partir de la venta, obtiene el número del pedido en el marketplace.
Lo empareja con el pedido de Koncili
Lo compara con el código del pedido ya importado — evita emparejar pedidos de cuentas diferentes con el mismo número.
Graba el vínculo
Listo: cuando se envíe la conciliación, Koncili ya sabrá a qué documento por cobrar aplicarle el cobro.
Reglas
Nunca se pierde, siempre lo intenta de nuevo
El documento por cobrar queda "em aberto" (abierto) en Bling hasta que se le aplica el cobro — por eso reaparece en cada barrido diario. Una falla (autenticación, indisponibilidad) solo posterga el vínculo, nunca lo pierde.
Inicio de la importación
Al configurar la fecha de inicio de la integración, el job buscará en Bling las cuentas por cobrar emitidas a partir de esa fecha que estén abiertas.
Por ejemplo, suponiendo que Koncili haya sido contratado para realizar la conciliación a partir del 01/07/2026, solo se importarán a Koncili los pedidos emitidos a partir de esa fecha.
Por eso, es importante definir correctamente esa fecha de inicio, evitando que el job consulte en Bling pedidos anteriores al período en que Koncili empezó a realizar la conciliación. Esos pedidos nunca estarán disponibles en Koncili y, en consecuencia, no podrán conciliarse.
Además de generar consultas innecesarias, esto puede afectar el rendimiento del proceso, principalmente en cuentas con un gran volumen de pedidos, lo que resulta en miles de consultas a Bling.
Consulta por día, con margen de seguridad
Cada consulta a Bling abarca solo un día. Koncili almacena la última fecha procesada por el job y, en cada nueva ejecución, usa un margen de seguridad de 3 días, por defecto, para reprocesar los días anteriores. De esta forma, es posible identificar pedidos que se pusieron a disposición en Koncili después de la emisión del documento por cobrar en Bling.
Red de seguridad — si el job no hizo el vínculo a tiempo
Resolución en el momento de la aplicación del cobro
En el momento de la aplicación del cobro, si el documento por cobrar todavía no tiene vínculo, Koncili intenta hacer el vínculo inmediatamente, buscando el pedido respectivo en Bling. Si encuentra el pedido, el vínculo se hace antes del envío de la aplicación del cobro. Si aun así no se localiza el pedido, la aplicación del cobro falla y devuelve el error de documento no encontrado.