Integración directa con ERP
Documentación completa de la integración directa de Koncili con Olist/Tiny y Bling — conexión, configuración y aplicación automática del cobro de las cuentas por cobrar.
Olist/Tiny
1. Visión general del flujo
Cuando se analiza una conciliación en Koncili, se aplica el cobro del documento por cobrar correspondiente en Olist/Tiny (se marca como cobrado) — hoy, a partir de un envío que hace el equipo desde la pantalla de Conciliação (Conciliación).
2. Autenticación y credenciales
Registro inicial: crear la cuenta en Koncili, crear la aplicación en Olist/Tiny y conectar ambos extremos vía OAuth. Se hace una sola vez por cliente.
3. Configuración de la aplicación del cobro
Configuración única, hecha después de la conexión — vale para todas las aplicaciones de cobro siguientes de esa cuenta.
4. Vínculo de documentos por cobrar
Koncili necesita saber qué documento por cobrar, en el ERP, corresponde a cada pedido — hoy este vínculo no se descubre automáticamente. Es necesario importar esa relación manualmente siempre que haya pedidos nuevos sin vínculo.
5. Consulta y seguimiento
Pasos 7, 8 y 9: cómo el equipo acciona y valida efectivamente la aplicación del cobro, después de que la cuenta está conectada y configurada.
6. Limitaciones importantes
Lee con atención antes de habilitar la aplicación automática del cobro para un cliente — el proceso es nuevo (beta) y tiene comportamientos específicos. Se harán nuevas implementaciones en las próximas versiones.
7. Información técnica
Endpoints de la API de Olist/Tiny que Koncili consume efectivamente en esta integración — referencia para quien vaya a dar soporte o revisar el flujo.
Bling
1. Visión general del flujo
Cuando se analiza una conciliación en Koncili, se aplica el cobro del documento por cobrar correspondiente en Bling (se marca como cobrado) — hoy, a partir de un envío que hace el equipo desde la pantalla de Conciliação (Conciliación).
2. Autenticación y credenciales
Registro inicial: crear la cuenta en Koncili, crear la aplicación en Bling (en la Central de Extensões (Central de extensiones)) y conectar ambos extremos vía OAuth. Se hace una sola vez por cliente.
3. Configuración de la aplicación del cobro
Configuración única, hecha después de la conexión — vale para todas las aplicaciones de cobro siguientes de esa cuenta. Bling no tiene el campo Conta de Destino (Cuenta de destino), por lo que no hay un paso equivalente a "descubrir la cuenta de destino".
4. 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.
5. Consulta y seguimiento
Pasos 11, 12 y 13: cómo el equipo acciona y valida efectivamente la aplicación del cobro, después de que la cuenta está conectada y configurada.
6. Limitaciones importantes
Lee con atención antes de habilitar la aplicación automática del cobro para un cliente — el proceso es nuevo (beta) y tiene comportamientos específicos. Se harán nuevas implementaciones en las próximas versiones.
7. Información técnica
Endpoints de la API de Bling que Koncili consume efectivamente en esta integración — referencia para quien vaya a dar soporte o revisar el flujo.