Flujo de aplicación del cobro y resolución de pedidos
El proceso de aplicación del cobro y resolución de pedidos representa el ciclo completo de integración entre Koncili y el ERP:
- Koncili identifica los pedidos conciliados y los pone a disposición vía API.
- El ERP consulta los movimientos/documentos por cobrar disponibles.
- El ERP procesa y efectúa la aplicación del cobro del documento por cobrar y la contabilización.
- El ERP le devuelve a Koncili la confirmación de la acción realizada.
- Koncili actualiza el estado de la conciliación.
Etapas del flujo
- Consulta de movimientos pendientes en Koncili
- El ERP consume el endpoint de la API de Integración Financiera para obtener los documentos por cobrar disponibles para conciliación, que están con CONCILIED
- Procesamiento en el ERP
- El ERP interpreta los datos, aplica sus propias reglas contables y registra la aplicación del cobro en el sistema financiero/fiscal.
- Confirmación del ERP a Koncili
- Después de registrar el evento, el ERP le devuelve a Koncili el estado final:
- RESUELTO (movimiento conciliado y con el cobro aplicado);
- Si el evento no se resuelve, el ERP debe marcarlo como leído en el endpoint
- Después de registrar el evento, el ERP le devuelve a Koncili el estado final:
Disponibilidad de las conciliaciones
🕒 ¿Cuándo está lista una conciliación para su consulta?
Las conciliaciones solo quedan disponibles vía API después de la finalización completa del procesamiento del Archivo de Liquidación en Koncili.
Esto garantiza que el ERP siempre reciba datos validados, consistentes y confiables.
Cuando todo el ciclo siguiente se haya concluido con éxito:
- Recepción del Archivo de Liquidación - el marketplace envía el archivo de liquidación.
- Lectura completa - Koncili carga íntegramente el Archivo de Liquidación.
- Validaciones - se aplican reglas estructurales (formato, integridad) y financieras (montos, consistencia).
- Cruce de datos - los movimientos se asocian a los pedidos ya existentes en la plataforma.
- Generación de las conciliaciones - Koncili crea los registros conciliados con el estado inicial ABIERTA y, en cuanto se analiza, queda con el estado FINALIZADA
Solo cuando una conciliación queda con el estado Finalizada, los MOVIMIENTOS de las liquidaciones quedan disponibles para consulta en el endpoint de la API de Integración Financiera.
Ejemplos de pedidos y movimientos
🛒 Ejemplo de pedido
Un pedido representa la transacción original realizada en un marketplace. A continuación, un ejemplo simplificado:
| Campo | Valor | Descripción |
|---|---|---|
| pedidoId | PED-12345 | Identificador único del pedido en Koncili |
| marketplace | Amazon | Canal de origen del pedido |
| data | 2025-09-10 | Fecha de la venta |
| cliente | João da Silva | Comprador |
| valorTotal | 100.00 | Monto bruto de la venta (sin descuentos) |
💰 Ejemplo de movimientos de un pedido
Cada pedido puede tener movimientos financieros asociados, que representan entradas y salidas.
| movimientoId | tipo | valor | naturaleza | descripción |
|---|---|---|---|---|
| LAN-1 | SALE | 100.00 | Entrada | Monto bruto de la venta liquidado por el marketplace |
| LAN-2 | COMISSION | -10.00 | Salida | Comisión cobrada por el marketplace |
| LAN-3 | SHIP | 20.00 | Entrada | Envío pagado por el cliente y liquidado al seller |
📊 Resultado de la conciliación
| Campo | Valor | Descripción |
|---|---|---|
| pedidoId | PED-12345 | Identificador único del pedido en Koncili |
| marketplace | Amazon | Canal de origen del pedido |
| data | 2025-09-10 | Fecha de la venta |
| cliente | João da Silva | Comprador |
| valorTotal | 100.00 | Monto bruto de la venta (sin descuentos) |
En el ejemplo anterior, el pedido PED-12345 tiene:
- Entradas: R$ 100,00 (SALE) + R$ 20,00 (SHIP)
- Salidas: R$ 10,00 (COMISSION)
➡️ Saldo neto conciliado: R$ 110,00
A veces pueden ocurrir divergencias en los montos de la liquidación que generan movimientos distintos de lo esperado. Esto sucede en casos de cancelaciones, devoluciones o incluso en el propio monto de la comisión; en estos casos, mientras los movimientos no se analicen, la conciliación no se finalizará, garantizando así que solo se envíen datos consistentes al ERP.