Cómo integrar Facturación

Para integrar la facturación desde el punto de venta u otro sistema hacia JANIS, es necesario consumir 3 APIs:

• Notificación de pedido cuando está listo para facturación
• Get del formulario de facturación
• Post del resultado de la facturación desde el POS (u otro sistema) hacia JANIS

1. Notificación de pedido cuando está listo para facturación

JANIS ofrece la funcionalidad de notificar a un sistema externo de cliente pedidos en determinados estados. Para más detalle, consultar la siguiente documentación.

Para realizar el flujo de facturación, el estado que debe estar configurado es Ready-for-invoice, ya que ese es el estado en el cual los pedidos tendrán su formulario de facturación generado.

2. Get del formulario de facturación

Una vez que JANIS haya notificado al sistema encargado de realizar la facturación, este sistema externo tendrá que hacer un Get hacia JANIS para obtener los datos del formulario necesarios para avanzar con la facturación.

En este punto, los datos a considerar de forma excluyente en la respuesta de la API son los siguientes:

2.A. Id (dentro de Items): Este dato será necesitario en el POST de Invoice que debe realizarse para confirmar la facturación desde el POS hacia JANIS.

2.B. Price (dentro de Items): Este dato indica el precio unitario de cada item.

2.C. Quantity (dentro de Items): Este dato indica la cantidad pickeada de cada item.

📘

Filtro de formulario por ID de pedido

Para obtener el formulario asociado a un pedido específico, puede utilizarle el parámetro de orderCommerceId.

3. Post del resultado de la facturación desde el POS (u otro sistema) hacia JANIS

Para ingresar una factura a JANIS se debe invocar la API de Invoice. Para esto, hay 2 formas de realizarlo:

3.A. Notificar montos de ítems además de los montos de factura: Para estos casos además de los datos de factura, es necesario notificar los datos de item previamente capturados en el Get del formulario de facturación (ID, Price y Quantity).

📘

Campos requeridos

En el ejemplo se muesrtra un POST con todos los campos existentes. Sin embargo, no todos son requeridos. Por esto, verifique en la API los que sí se necesitan enviar.

3.B. Notificar sólo montos montos de factura: Para estos casos, sólo es requerido enviar orderId (Para poder asociar la factura a una orden) pero no es requerido enviar información de los ítems.