GENERAR GUÍA  CORPORATIVO DESDE  API

INTRODUCCIÓN


USUAROS CON ACCESO


PROCEDIMIENTO
A continuación, se detalla el flujo de trabajo estándar para utilizar los servicios de la API. 

 A. Consulta de Infraestructura (Agencias) 

 Antes de crear una orden, es necesario identificar los puntos de origen y destino válidos. 

 

 

 Tener RUC: 20563023016 

 Clave: .20563023016. 

 Token: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczpcL1wvYXBpc2VydmljZXMuc2hhbG9tY29udHJvbC5jb21cL2FwaVwvdjFcL2F1dGhcL2xvZ2luIiwiaWF0IjoxNzY0Nzc5MTc0LCJuYmYiOjE3NjQ3NzkxNzQsImp0aSI6IkVCcnNQM3o1SnZPeHljTjciLCJzdWIiOjIsInBydiI6Ijg3ZTBhZjFlZjlmZDE1ODEyZmRlYzk3MTUzYTE0ZTBiMDQ3NTQ2YWEifQ.EcOh4uq7oYAf8kbK6u9G_R1srqMbNAJLga9yCjKm3CY 

 

 INGRESAR EL TOKEN 

 

 

 B. Gestión de Órdenes de Servicio 

 Este es el núcleo de la API, donde se formaliza el envío. 

 1. Creación de Orden 

 Se deben enviar los parámetros de origen, destino, datos del remitente/destinatario y el tipo de producto. 

 

 

 Endpoint: POST /cliente/orden/crear 

 

 

 Dato Clave: Tras una creación exitosa, el sistema devolverá un codigo (alfanumérico) y una guia (numérica). Guarde estos datos para consultas futuras. 

 

 Para digitar  Origen y Destino solo se debe digitar la ID 

 

 

 

 

 

 

 

 

 2. Obtención de Información 

 

 Se debe ingresar el número de OS 

 Ingresar el código 

 

 Permite recuperar los detalles de una guía existente utilizando el número de guía y el código generado en el paso anterior. 

 

 

 Endpoint: POST /cliente/orden/obtener 

 

 

 Respuesta: Incluye montos, fecha de emisión, estado de pago y detalles de los terminales involucrados. 

 

 

 

 

 

 C. Seguimiento y Tracking (Estados) 

 

 Se debe ingresar el número de OS 

 Ingresar el código 

 

 Para conocer el progreso del envío, se utiliza el módulo de estados. 

 

 

 Endpoint: POST /cliente/orden/estados 

 

 

 Lógica de respuesta: El objeto data mostrará fechas en los campos correspondientes a medida que el paquete avanza: 

 

 

 registrado : Fecha de creación. 

 

 

 transito : Fecha de salida hacia destino. 

 

 

 entregado : Fecha de recepción final. 

 

 

 

 

 

 

 Resumen de Códigos de Respuesta 

 

 

 

 Código 

 Estado 

 Significado 

 

 

 

 

 200 

 Success 

 La operación se realizó correctamente. 

 

 

 401 

 Unauthorized 

 Credenciales ausentes o inválidas. 

 

 

 Default 

 Error 

 Problema inesperado en el servidor.