Flujo de pedidos

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

---

Envío de pedido

• Nuevo pedido: identificado y enviado por el integrador. Solo se aceptarán pedidos a partir del estado INVOICED (facturado)
• Actualización de pedido: cualquier cambio relevante, como estado o montos, también debe enviarse como un nuevo request completo
• API Koncili: valida, procesa y envía los datos
• Koncili: almacena la información y prepara los datos para la conciliación

Validaciones

La solicitud enviada mediante POST /order 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 type contenido en la lista de extracts acepta 3 valores válidos (SALE, COMISSION y SHIP). Cualquier otro valor resultará en error

3. Validación de fechas:
   Las fechas en el payload deben ser consistentes. Esto incluye el orden cronológico de los eventos y la presencia de campos obligatorios según el estado del pedido

4. Validación del estado del pedido (status): Los estados de pedidos aceptados incluyen INVOICED, PAID_WAITING_DELIVERY, CONCLUDED y CANCELED

   Para cada estado, los siguientes campos son obligatorios:

   Estado	Fechas obligatorias
   INVOICED	Ninguna adicional obligatoria
   PAID_WAITING_DELIVERY	sendDate, estimatedDeliveryDate
   CONCLUDED	sendDate, estimatedDeliveryDate, deliveryDate
   CANCELED	cancelDate

Buenas prácticas

Los pedidos deben enviarse mediante la operación POST y, ante cualquier cambio que sufra el pedido, deberá realizarse un nuevo request, en el mismo endpoint, con toda la información referente al pedido.

Consulta de pedido

La operación GET permite consultar los detalles de un pedido enviado previamente a Koncili.
Puede usarse para la verificación de datos, la sincronización entre sistemas o la validación del estado del envío.

Actualización del estado

Las actualizaciones se consolidan cada 30 minutos.
Si tu consulta no refleja la realidad del pedido, repite la consulta después de ese intervalo.

Validaciones

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

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

2. Consulta del pedido:
   El pedido consultado debe existir en Koncili. Si no se encuentra, la solicitud devolverá un error

Eliminación de pedido

La operación DELETE permite eliminar un pedido enviado previamente a Koncili.

Validaciones

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

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

2. Consulta del pedido:
   El pedido consultado debe existir en Koncili. Si no se encuentra, la solicitud devolverá un error

3. Verifica si el pedido se importó vía API:
   El pedido debe haberse enviado vía API. Si no es el caso, la solicitud devolverá un error

4. Verifica si el pedido está conciliado:
   El pedido no puede estar conciliado. Si lo está, la solicitud devolverá un error

¡Importante!

La eliminación de pedidos debe hacerse con cautela, pues una vez eliminado, el pedido no podrá recuperarse.