Flujo Básico de Integración
En esta sección tienes disponible un diagrama de integración general entre Janis, eCommerce, Punto de Venta y Operador Logístico, además de ejemplos respectivo de WebHooks y API. Considera que esto es una forma general de integración y existen múltiples opciones:
WebHook Delivery Status Change
Este Webhook notifica los cambios de estado del Shipping:
-
Status "created":
{
"entity": "shipping",
"id": "620156bb829a680009cfbd06",
"status": "created"
} -
Status "scheduled":
{
"entity": "shipping",
"id": "620156bb829a680009cfbd06",
"status": "scheduled"
}
Una vez que el Shipping está en estado "scheduled", se puede proceder con el despacho.
Para Obtener toda la información del Pedido: API GET List Order
Ejemplo: https://oms.janisqa.in/api/order?filters[commerceId]=1209051416738-01
en dónde el valor del path es el ID de Pedido en Janis.
Para obtener el ID de la Orden (commerceId) deberán primero llamar a la API Shipping, ejemplo: https://delivery.janisqa.in/api/shipping?filters[id]=*620156bb829a680009cfbd06* en dónde el el id del path es el que se informa en el Webhook Delivery Status Change.
API Shipping Tracking, para notificar a Janis acerca de los cambios de estado del Shipping durante el despacho realizado por el operador Logístico :
Ejemplos:
Para Facturación se utilizan las siguientes API:
-
Lista de Invoices: En ella se obtiene la estructura a utilizar para enviar la facturación de lo Facturado a Janis.
Ejemplo: https://jef.janisqa.in/api/invoice-form?filters[orderId]=61eabcc3db53d80009b74a16 en dónde el "orderId" del path se obtiene desde el GET List Order en el campo "id" del response. -
Invoice : Para informar a Janis el resultado de la Facturación.
Updated about 1 year ago