# 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](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-03/scaled-1680-/CiVimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-03/CiVimage.png)

- **Tener RUC: 20563023016**
- **Clave: .20563023016.**
- **Token: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczpcL1wvYXBpc2VydmljZXMuc2hhbG9tY29udHJvbC5jb21cL2FwaVwvdjFcL2F1dGhcL2xvZ2luIiwiaWF0IjoxNzY0Nzc5MTc0LCJuYmYiOjE3NjQ3NzkxNzQsImp0aSI6IkVCcnNQM3o1SnZPeHljTjciLCJzdWIiOjIsInBydiI6Ijg3ZTBhZjFlZjlmZDE1ODEyZmRlYzk3MTUzYTE0ZTBiMDQ3NTQ2YWEifQ.EcOh4uq7oYAf8kbK6u9G\_R1srqMbNAJLga9yCjKm3CY**

**INGRESAR EL TOKEN**

[![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-03/scaled-1680-/9GTimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-03/9GTimage.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](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-03/scaled-1680-/hheimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-03/hheimage.png)
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-03/scaled-1680-/pNbimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-03/pNbimage.png)
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-03/scaled-1680-/Pucimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-03/Pucimage.png)
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-03/scaled-1680-/D7qimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-03/D7qimage.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](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-03/scaled-1680-/o9Limage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-03/o9Limage.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](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-03/scaled-1680-/5hdimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-03/5hdimage.png)

---

### Resumen de Códigos de Respuesta

<table data-path-to-node="30" id="bkmrk-c%C3%B3digo-estado-signif"><thead><tr><td>**Código**</td><td>**Estado**</td><td>**Significado**</td></tr></thead><tbody><tr><td><span data-path-to-node="30,1,0,0">**200**</span></td><td><span data-path-to-node="30,1,1,0">Success</span></td><td><span data-path-to-node="30,1,2,0">La operación se realizó correctamente.</span></td></tr><tr><td><span data-path-to-node="30,2,0,0">**401**</span></td><td><span data-path-to-node="30,2,1,0">Unauthorized</span></td><td><span data-path-to-node="30,2,2,0">Credenciales ausentes o inválidas.</span></td></tr><tr><td><span data-path-to-node="30,3,0,0">**Default**</span></td><td><span data-path-to-node="30,3,1,0">Error</span></td><td><span data-path-to-node="30,3,2,0">Problema inesperado en el servidor.</span></td></tr></tbody></table>