Ir al contenido principal

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.

image.png

  • Tener RUC: 20563023016
  • Clave: .20563023016.
  • Token: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczpcL1wvYXBpc2VydmljZXMuc2hhbG9tY29udHJvbC5jb21cL2FwaVwvdjFcL2F1dGhcL2xvZ2luIiwiaWF0IjoxNzY0Nzc5MTc0LCJuYmYiOjE3NjQ3NzkxNzQsImp0aSI6IkVCcnNQM3o1SnZPeHljTjciLCJzdWIiOjIsInBydiI6Ijg3ZTBhZjFlZjlmZDE1ODEyZmRlYzk3MTUzYTE0ZTBiMDQ3NTQ2YWEifQ.EcOh4uq7oYAf8kbK6u9G_R1srqMbNAJLga9yCjKm3CY

INGRESAR EL TOKEN

image.png

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
  • image.png

    image.png

    image.png

    image.png

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.

  • image.png

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.

  1. Endpoint: POST /cliente/orden/estados

  2. 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.

image.png


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.