Saltar al contenido principal

Flujo de conciliación

En esta página encontrarás los detalles sobre los flujos de conciliación en la API de Koncili.

Envío de la liquidación​

  • Nueva liquidación: Enviada por el integrador
  • API Koncili: Valida, procesa y envía los datos
  • Koncili: Almacena la información y prepara los datos para el envío de los movimientos
Validaciones

La solicitud enviada mediante POST /reconciliation pasa por diversas etapas de validación antes de ser aceptada:

  1. Validación del canal (account):
    La cuenta informada en el payload debe estar habilitada para importaciones vía API. De lo contrario, la solicitud será rechazada

  2. Validación del período de la liquidación:
    El campo periodInitDate debe ser anterior a periodEndDate

  3. Validación de conflictos de período:

    • Verifica si ya existe una liquidación activa para el canal informado
    • Verifica si el nuevo período enviado entra en conflicto con cualquier período ya registrado, ya sea por superposición total o parcial

Envío de movimientos​

Validaciones

La solicitud enviada mediante POST /reconciliation/release pasa por diversas etapas de validación antes de ser aceptada:

  1. Validación del canal (account):
    La cuenta informada en el payload debe estar habilitada para importaciones vía API. De lo contrario, la solicitud será rechazada

  2. Validación del tipo de movimiento:
    El campo releaseType debe ser IN_CASH para movimientos de pedidos

  3. Validación de los movimientos:
    Los tipos de movimientos aceptados son: COMISSION, SHIP, RETURN_COMISSION, RETURN_SHIP y SALE. Además, se validan los signos de los valores de cada uno de los movimientos

  4. Valida conflictos en los movimientos: Los movimientos no pueden existir previamente; si existen, se devolverá un error

Información

El proceso de conciliación ocurre de forma asíncrona. Después del envío de los movimientos, Koncili procesa la información y notifica al integrador cuando la conciliación se haya concluido; la notificación se hace mediante la URL registrada (para más información sobre las notificaciones, accede a: Notificaciones)