Flujo general de Koncili

En esta página encontrarás los detalles sobre el flujo general en la API de Koncili.

---

Este flujo define el comportamiento general esperado de una aplicación integradora con la API de Koncili. La integración tiene como objetivo central apoyar el proceso de conciliación financiera de los pedidos realizados en marketplaces. El integrador debe:

1. Envío de los pedidos: Los pedidos deben enviarse a la API de Koncili. Con base en estos datos, el sistema podrá identificar los pedidos conciliables, cruzando la información proporcionada con los datos de movimiento(s) puestos a disposición posteriormente

2. Envío de la liquidación: Proporciona los datos necesarios para iniciar el proceso de conciliación en el sistema

3. Envío de los movimientos: Envía los movimientos relacionados con cada pedido

4. Resultado de la conciliación: Koncili procesa la conciliación y notifica cuando la conciliación se haya concluido

Información

Descripción del flujo de conciliación

Participantes:

• Integrador: Tu sistema, responsable de enviar pedidos y movimientos
• API: Interfaz segura para la comunicación con el sistema de conciliación
• Koncili: Núcleo de procesamiento que ejecuta la conciliación financiera

Flujo principal:

1. Consulta inicial de las cuentas

• El integrador consulta las cuentas disponibles (GET /my-accounts) para la validación previa

2. Envío de pedidos

• El integrador envía los pedidos a la API
• Flujo exitoso:
  • La API envía a Koncili → Koncili confirma la recepción → la API devuelve 200 Ok
• Escenario de error:
  • La API devuelve 4xx/5xx en caso de falla (datos inválidos, falla de autenticación, bloqueo, etc.)

3. Envío de la liquidación

• Después del envío exitoso de los pedidos:
  • El integrador envía datos complementarios para el envío de la liquidación
• Flujo exitoso:
  • API → Koncili → Confirmación → 201 Created
  • Escenario de error: respuesta 4xx/5xx

Bloqueo: No es posible enviar movimientos sin una conciliación creada

4. Envío de movimientos

• El integrador envía los movimientos financieros asociados a los pedidos
• Flujo exitoso:
  • API → Koncili → Confirmación → 200 OK
• Escenario de error:
  • Respuesta 4xx/5xx
  • Impacto: la conciliación no puede finalizarse

Bloqueo: No es posible enviar movimientos a una conciliación cerrada

5. Procesamiento y notificación

• Después de recibir todos los movimientos:
  • Koncili ejecuta la conciliación automáticamente y, al finalizar, notifica al integrador mediante la URL de notificación registrada (para más información sobre las notificaciones, accede a: Notificaciones)