# SERVICIOS USADOS EN APP RASTREA

# Versiones

# /api/versiones-app/get_version

##### Servicio consumido por la app para una funcionalidad especifica.

### Detalles técnicos

- **Endpoint: /api/versiones-app/get\_version**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qahorario-salida.shalomcontrol.com/api/versiones-app/get_version
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 29.6772%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 70.2989%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 29.6772%;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 70.2989%;">[https://recursoshumanos.shalom.com.pe/api/versiones-app/get\_version](https://recursoshumanos.shalom.com.pe/api/versiones-app/get_version)</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 29.6772%;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 70.2989%;"> </td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 29.6772%;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 70.2989%;"> </td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
{
    "app":"roja_android"
}
```

```
{
    "app":"roja_android"
}
```

---

### 📤 Response

```json
{
    "valor": true,
    "msn": "Versión del app SHALOM RASTREA ANDROID: 2.7.7",
    "version": "2.7.7"
}

```

```json
{
    "valor": true,
    "msn": "Versión del app SHALOM RASTREA IOS: 3.0.7",
    "version": "3.0.7"
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo principal → Versiones**
    - **Evento:** Inicializacion de servicio.
    - **Uso:** Devuelve la version de la app.

---

### 🖼️ Pantallazos

- **Login:**
    
    [![login.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/scaled-1680-/login.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/login.png)

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- -

# Módulo Rastreo

# /android/search_guia_qr

##### Servicio consumido por la app para una funcionalidad especifica.

### Detalles técnicos

- **Endpoint: /android/search\_guia\_qr**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapadawan.shalomcontrol.com/android/search_guia_qr
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 164.8px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 25.7403%; height: 29.6px;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 74.2359%; height: 29.6px;">URL</th></tr></thead><tbody><tr style="height: 35.2px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 25.7403%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 74.2359%; height: 35.2px;">[https://servicespadawan.shalomcontrol.com/android/search\_guia\_qr](https://servicespadawan3.shalomcontrol.com/android/search_guia_qr)</td></tr><tr style="height: 35.2px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 25.7403%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 74.2359%; height: 35.2px;">[https://servicespadawan2.shalomcontrol.com/android/search\_guia\_qr](https://servicespadawan3.shalomcontrol.com/android/search_guia_qr)</td></tr><tr style="height: 35.2px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 25.7403%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 74.2359%; height: 35.2px;">[https://servicespadawan3.shalomcontrol.com/android/search\_guia\_qr](https://servicespadawan3.shalomcontrol.com/android/search_guia_qr)</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
idose:82742837
```

---

### 📤 Response

```json
{
    "valor": 1,
    "msn": "Guia encontrada con éxito",
    "data": [
        {
            "ose_codigo": "C3KM",
            "ose_nroguiacliente": "50013965"
        }
    ]
}
```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo principal → Rastreo**
    - **Evento:** Al presionar el boton de QR
    - **Uso:** Valida si existe la guia.

---

### 🖼️ Pantallazos

- **Rastreo:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/t75image.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/t75image.png)

### 📂 Archivos Flutter relacionados

- - Referencia principal en capa Services del módulo.

---

### 🗒️ Notas adicionales

- - Request/Response exactos pueden variar según pantalla y body enviado desde Bloc.

# /api/search_status_guia

#####   


### Detalles técnicos

- **Endpoint: /api/search\_status\_guia**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://sysqa.shalomcontrol.com/api/search_status_guia
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://syslima.shalomcontrol.com/api/search\_status\_guia</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://syslima.shalomcontrol.com/api/search\_status\_guia</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://syscontrol.shalomcontrol.com/api/search\_status\_guia</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "nroguia":"50013965",
    "code":"C3KM"
}
```

---

### 📤 Response

```json
{
    "valor": true,
    "msn": "Guia encontrada",
    "data": {
        "estado": 0
    }
}
```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo principal → Detalle envio**
    - **Evento:**
    - **Uso:** llamado desde servicios/bloc/pantallas del flujo asociado.

---

### 🖼️ Pantallazos

- **Principal:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/RBeimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/RBeimage.png)

### 📂 Archivos Flutter relacionados

- - Referencia principal en capa Services del módulo.

---

### 🗒️ Notas adicionales

- - Request/Response exactos pueden variar según pantalla y body enviado desde Bloc.

# /android/buscar_guia_new

##### Servicio consumido por la app para una funcionalidad especifica.

### Detalles técnicos

- **Endpoint: /android/buscar\_guia\_new**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapadawan.shalomcontrol.com/android/buscar_guia_new
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicespadawan.shalomcontrol.com/android/buscar\_guia\_new</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicespadawan2.shalomcontrol.com/android/buscar\_guia\_new</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicespadawan3.shalomcontrol.com/android/buscar\_guia\_new</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
serie:
numguia:50013965
aleatorio:C3KM
tipo:2
```

---

### 📤 Response

```json
{
    "valor": 1,
    "msn": "Orden encontrada con éxito",
    "data": [
        {
            "idOrden": "82742837",
            "creacion": "2026-06-15 09:56:02",
            "monto": "8.00",
            "recepcion_origen": "15-06-26 09:55",
            "recepcion_embarque": "15-06-26 22:46",
            "recepcion_desembarque": "15-06-26 22:47",
            "movilidad_reparto": null,
            "recepcion_inventario": "15-06-26 22:47",
            "inventario": "15-06-26 22:47",
            "recepcion_entrega": "18-06-26 16:51",
            "codigo_aleatorio": "C3KM",
            "guia": "GRT. E: V245-50013965",
            "origen": "LAS CONCHITAS",
            "origenId": "45",
            "tipo_origen": "origenLima",
            "ubigeo_origen": "150143",
            "destino": "AV PARRA 379 CO",
            "tipo_destino": "destinos24",
            "direccion_destino": "AV. PARRA 379 - Arequipa",
            "destinoId": "7",
            "remitentenombre": "DAISY CHIPANA LAPA",
            "destinatario_os": "DAISY CHIPANA LAPA",
            "destinatarionombre": "DAISY CHIPANA LAPA",
            "contenido": "1 SOBRE",
            "estado_pago": "CANCELADO",
            "tipo_cp": "FA",
            "comprobante": null,
            "seriecomp": null,
            "numerocomp": null,
            "nrooperacion": null,
            "fecha_detraccion": null,
            "razonsocial": "DEVOLUCION",
            "apellidopaterno": "DE",
            "apellidomaterno": "MERCADERIA",
            "nrodocumento": "35353535",
            "numcomprobante": null,
            "guiaremitente": "null",
            "idcomprobante": null,
            "destinoentrega": "7",
            "carguero": "763022",
            "tipo_web": null,
            "confirmado_web": null,
            "destinatariodoc": "72607245",
            "entreganombre": "DEVOLUCION DE MERCADERIA",
            "cargueros": [
                "763022"
            ],
            "mensajeEnvio": "",
            "reparto": false,
            "aereo": false,
            "demora": false,
            "mudanza": false,
            "send_message": 0,
            "traslado_punto_pro": false,
            "tiempo_llegada": "48 horas",
            "tiene_cambio_destino": true,
            "tiene_devolucion_mercaderia": true,
            "solicitante_tipo": "Remitente"
        }
    ]
}
```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo principal → Rastreo**
    - **Evento:** Al presionar el boton "Buscar".
    - **Uso:** Devuelve la informacion del orden de servicio.

---

### 🖼️ Pantallazos

- **Principal:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/uJUimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/uJUimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\pages\\cambioDestino\\Services\\cambio\_detino\_service.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /android/search_pdf_comprobante

#####   


### Detalles técnicos

- **Endpoint: /android/search\_pdf\_comprobante**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapadawan.shalomcontrol.com/android/search_pdf_comprobante
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicespadawan.shalomcontrol.com/android/search\_pdf\_comprobante</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicespadawan2.shalomcontrol.com/android/search\_pdf\_comprobante</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicespadawan3.shalomcontrol.com/android/search\_pdf\_comprobante</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "serie":"",
    "numero":""
}
```

---

### 📤 Response

```json
{
    "valor": 0,
    "msn": "Documento no existe",
    "data": []
}
```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo principal → Detalle envio**
    - **Evento:** Aal presionar el boton "Buscar".
    - **Uso:** llamado desde servicios/bloc/pantallas del flujo asociado.

---

### 🖼️ Pantallazos

- **Principal:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/THoimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/THoimage.png)

### 📂 Archivos Flutter relacionados

- - Referencia principal en capa Services del módulo.

---

### 🗒️ Notas adicionales

- - Request/Response exactos pueden variar según pantalla y body enviado desde Bloc.

# /api/v1/web/rastrea/grts

#####   


### Detalles técnicos

- **Endpoint: /api/v1/web/rastrea/grts**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qaservicesweb.shalomcontrol.com/api/v1/web/rastrea/grts
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 135.2px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%; height: 29.6px;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%; height: 29.6px;">URL</th></tr></thead><tbody><tr style="height: 35.2px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicesweb.shalomcontrol.com/api/v1/web/rastrea/grts</td></tr><tr style="height: 35.2px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicesweb.shalomcontrol.com/api/v1/web/rastrea/grts</td></tr><tr style="height: 35.2px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicesweb.shalomcontrol.com/api/v1/web/rastrea/grts</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742837"
}
```

---

### 📤 Response

```json
{
    "success": false,
    "message": "No se encontraron grts para el carguero",
    "data": []
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo principal → Rastreo**
    - **Evento:**
    - **Uso:** llamado desde servicios/bloc/pantallas del flujo asociado.

---

### 🖼️ Pantallazos

- **Principal:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/1nlimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/1nlimage.png)

### 📂 Archivos Flutter relacionados

- - Referencia principal en capa Services del módulo.

---

### 🗒️ Notas adicionales

- - Request/Response exactos pueden variar según pantalla y body enviado desde Bloc.

# Login y Registro

# /api/app/auth/login

##### Autentica al usuario.

### Detalles técnicos

- **Endpoint: /api/app/auth/login**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/app/auth/login
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://syslima.shalomcontrol.com/api/app/auth/login</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://syslima.shalomcontrol.com/api/app/auth/login</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://syscontrol.shalomcontrol.com/api/app/auth/login</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
email:dchipanalapa@gmail.com
password:Daisy123!
device_id:9bf5a481-59d4-483b-91bf-175da4e83d88
platform:android
model:Xiaomi 220733SL
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Usuario autenticado",
    "data": {
        "phone": "922749652",
        "document": "72607245",
        "full_name": "DAISY CHIPANA LAPA",
        "user": {
            "id": 89743,
            "password": "$2y$10$CnhjhSdsA7j.UqI0w7befeo6Uw4F.9qcF3pkep22CNWZXW0UM6Zmi",
            "email": "dchipanalapa@gmail.com",
            "document": "72607245",
            "full_name": "DAISY CHIPANA LAPA",
            "phone": 922749652,
            "updated_at": "2026-06-08 10:15:25"
        }
    }
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo principal → General**
    - **Evento:**
    - **Uso:** llamado desde servicios/bloc/pantallas del flujo asociado.

---

### 🖼️ Pantallazos

- **Login:**
    
    [![login.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/scaled-1680-/login.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/login.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\pages\\Login\\Services\\login\_services.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/app/auth/person/save

#####   


### Detalles técnicos

- **Endpoint: /api/app/auth/person/save**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/app/auth/person/save
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/person/save</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/person/save</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/person/save</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
{
    "documento":"75685586",
    "name":"Nayra",
    "firstname":"Vega",
    "lastname":"Vela",
    "phone":"963852741"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Cliente registrado correctamente",
    "data": {
        "documento": "75685586",
        "nombres": "Nayra",
        "apellido_paterno": "Vega",
        "apellido_materno": "Vela",
        "phone": 963852741,
        "email": "",
        "address": null
    },
    "campos": {
        "per_habilitado": "1"
    }
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Login → Registro**
    - **Evento:** Al presionar el boton "Guardar datos".
    - **Uso:** Registrar los datos de un nuevo persona.

---

### 🖼️ Pantallazos

- **Registro:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/FcBimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/FcBimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\pages\\Login\\Services\\login\_services.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/app/auth/phone/code

##### Solicita envio de codigo OTP.

### Detalles técnicos

- **Endpoint: /api/app/auth/phone/code**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/app/auth/phone/code
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/phone/code</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/phone/code</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/phone/code</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
document:72607245
phone:922749652
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Código de verificación enviado, revise su teléfono."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Login → Registro**
    - **Evento:** al presionar el boton "Enviar codigo de verificacion".
    - **Uso:** Envia el codigo a su numero de telefono.

---

### 🖼️ Pantallazos

- **Registro Usuario**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/WU2image.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/WU2image.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\pages\\Login\\Services\\login\_services.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/app/auth/phone/verify

#####   


### Detalles técnicos

- **Endpoint: /api/app/auth/phone/verify**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/app/auth/phone/verify
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/phone/verify</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/phone/verify</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/phone/verify</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "document":"72607245",
    "phone":"922749652",
    "code":"MMK7CK"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Teléfono verificado con éxito."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Login → Registro**
    - **Evento:** Al digitar todo el codigo completo.
    - **Uso:** Verifica si el codigo ingresado en correcto.

---

### 🖼️ Pantallazos

- **Registro:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/qlTimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/qlTimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\pages\\Login\\Services\\login\_services.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/app/auth/email/code

##### Solicita envio de codigo OTP.

### Detalles técnicos

- **Endpoint: /api/app/auth/email/code**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/app/auth/email/code
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/email/code</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/email/code</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/email/code</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
document:72607245
email:dchipanalapa@gmail.com
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Clave de validación enviada, revise su correo."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Login → Registro**
    - **Evento:** Al presionar el boton "Enviar codigo de verificacion".
    - **Uso:** Envia la clave al correo electronico.

---

### 🖼️ Pantallazos

- **Registro:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/YQbimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/YQbimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /api/app/auth/email/verify

##### Verifica codigo OTP.

### Detalles técnicos

- **Endpoint: /api/app/auth/email/verify**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/app/auth/email/verify
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
{
    "document":"72607245",
    "email":"dchipanalapa@gmail.com",
    "code":"3WP9HD"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Correo verificado."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Inicial → Vista Login**
    - **Evento:** Al digitar todo el codigo completo.
    - **Uso:** Verifica si el codigo ingresado en correcto.

---

### 🖼️ Pantallazos

- **Registro:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/Y62image.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/Y62image.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /api/app/auth/register

##### Registra usuario en la aplicacion.

### Detalles técnicos

- **Endpoint: /api/app/auth/register**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/app/auth/register
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 135.2px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%; height: 29.6px;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%; height: 29.6px;">URL</th></tr></thead><tbody><tr style="height: 35.2px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/register</td></tr><tr style="height: 35.2px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/register</td></tr><tr style="height: 35.2px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/register</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "document":"72607245",
    "email":"dchipanalapa@gmail.com",
    "password":"Daisy123!!",
    "repeat":"Daisy123!!",
    "phone":"922749652",
    "device_id":"7857878b-d996-4740-85d9-f21c296c6b0e",
    "platform":"android",
    "model": "Xiaomi 21091116AG"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "La contraseña se creo correctamente",
    "data": {
      "name": "DAISY"
    }
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo principal → General**
    - **Evento:** Al presionar el boton "Registrarse".
    - **Uso:** Registra al usuario.

---

### 🖼️ Pantallazos

- **Registro:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/nRhimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/nRhimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\pages\\Login\\Services\\login\_services.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/app/auth/email/password

##### Servicio del modulo General.

### Detalles técnicos

- **Endpoint: /api/app/auth/email/password**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/app/auth/email/password
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/email/password</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/email/password</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/email/password</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
email:dchipanalapa@gmail.com
```

---

### 📤 Response

```json
{
  "success":true,
  "message":"Enlace de recuperación de contraseña enviado, verifique su correo."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Inicial → Recuperar contraseña**
    - **Evento:**
    - **Uso:**

---

### 🖼️ Pantallazos

- **Recuperar contraseña:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/J1kimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/J1kimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# Ubigeo

# /api/v1/web/agencias/listar

#### Servicio del modulo General.

### Detalles técnicos

- **Endpoint: /api/v1/web/agencias/listar**
- **Método:** `GET`

### 🌐 Dominios

#### QA

```
https://qaservicesapp.shalomcontrol.com/api/v1/web/agencias/listar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.9762%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 66.1191%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.9762%;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 66.1191%;">https://servicesapp.shalomcontrol.com</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.9762%;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 66.1191%;">https://serviceapp2.shalomcontrol.com</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.9762%;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 66.1191%;">https://serviceapp2.shalomcontrol.com</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Lista de agencias.",
    "data": [
        {
            "ter_id": 3,
            "ter_abrebiatura": "CHH",
            "zona": "CHACHAPOYAS",
            "ter_zona": "ORIENTE 1",
            "provincia": "CHACHAPOYAS",
            "departamento": "AMAZONAS",
            "lugar": null,
            "latitud": "-6.238673290149498",
            "longitud": "-77.86800826533634",
            "sp": "2",
            "imagen": "img/local.jpg",
            "direccion": "JR. DOS DE MAYO CDRA. 15 S/N CHACHAPOYAS, REFERENCIA: JUNTO A TERMINAL DE COMBIS ETSA",
            "telefono": "(01) 500 7878",
            "hora_atencion": "LUNES A VIERNES - 8AM A 8PM",
            "hora_domingo": "DOMINGOS - 8:00 AM A 5:00 PM",
            "hora_entrega": null,
            "hora_entrega_domingo": null,
            "detalles": "La carga pesada o voluminosa deberán ser depositados 3 horas antes de del horario de partida para garantizar su salida. (Sujeto a evaluación)",
            "horario_atencion_lunes_inicio": "08:00:00",
            "horario_atencion_lunes_fin": "20:00:00",
            "horario_atencion_sabado_inicio": "08:00:00",
            "horario_atencion_sabado_fin": "20:00:00",
            "horario_atencion_domingo_inicio": "08:00:00",
            "horario_atencion_domingo_fin": "17:00:00",
            "estadoAgencia": "ATENDIENDO EN ESTE MOMENTO",
            "nombre": "AMAZONAS / CHACHAPOYAS / CHACHAPOYAS / CHACHAPOYAS CO DOS DE MAYO",
            "lugar_over": "CHACHAPOYAS CO DOS DE MAYO",
            "ter_tipo_destino": "destinos48",
            "ter_tipo_conexion": "",
            "ter_estado_agente": "0",
            "ter_reparto_habilitado": "1",
            "ter_habilitado_OS": 1,
            "origen": 1,
            "destino": 1,
            "web": 1,
            "ter_aereo": 1,
            "ter_estado_pro": "0",
            "ter_principal": 1,
            "ter_internacional": 1,
            "dep_id": 1,
            "prov_id": 1,
            "dist_id": 1,
            "ubi_id": 10101,
            "origenes_aereos": [
                  2,
                  4,
                  5,
                  6,
                  7,
                  8,
                  9,
                  10
              ],
            "destinos_aereos": [
                  7,
                  8,
                  9,
                  10,
                  11,
                  12,
                  13,
            ],
            ter_categoria": "GRANDE / CO",
            "ter_categoria_envia": "HASTA 1500 KG",
            "ter_categoria_recibe": "HASTA 1500 KG"
        },
        {
            "ter_id": 704,
            "ter_abrebiatura": "ACA2",
            "zona": "LEVANTO",
            "ter_zona": null,
            "provincia": "CHACHAPOYAS",
            "departamento": "AMAZONAS",
            "lugar": null,
            "latitud": null,
            "longitud": null,
            "sp": null,
            "imagen": null,
            "direccion": "Casita343",
            "telefono": null,
            "hora_atencion": null,
            "hora_domingo": null,
            "hora_entrega": null,
            "hora_entrega_domingo": null,
            "detalles": null,
            "horario_atencion_lunes_inicio": null,
            "horario_atencion_lunes_fin": null,
            "horario_atencion_sabado_inicio": null,
            "horario_atencion_sabado_fin": null,
            "horario_atencion_domingo_inicio": null,
            "horario_atencion_domingo_fin": null,
            "estadoAgencia": "ATENDIENDO EN ESTE MOMENTO",
            "nombre": "AMAZONAS / CHACHAPOYAS / LEVANTO / Prueba4aa",
            "lugar_over": "Prueba4aa",
            "ter_tipo_destino": null,
            "ter_tipo_conexion": null,
            "ter_estado_agente": null,
            "ter_reparto_habilitado": "0",
            "ter_habilitado_OS": 0,
            "origen": 0,
            "destino": 0,
            "web": 0,
            "ter_aereo": 1,
            "ter_estado_pro": null,
            "ter_principal": 0,
            "ter_internacional": 0,
            "dep_id": 1,
            "prov_id": 1,
            "dist_id": 11,
            "ubi_id": 10111,
            "origenes_aereos": [
                2,
                3,
                4,
            ],
            "destinos_aereos": [
                2,
                3,
                4,
                5,
                6,
                7,
                8
            ],
            "ter_categoria": "Terminal",
            "ter_categoria_envia": "",
            "ter_categoria_recibe": ""
        }
      ]
  }

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo principal → Inicializacion**
    - **Evento:** Al iniciar el app.
    - **Uso:** Devuelve el detalle de todas las terminales.

---

### 🖼️ Pantallazos

- **Login:**
    
    [![login.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/scaled-1680-/login.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/login.png)

### 📂 Archivos Flutter relacionados

- - Referencia principal en capa Services del módulo.

---

### 🗒️ Notas adicionales

- - Request/Response exactos pueden variar según pantalla y body enviado desde Bloc.

# /api/v1/web/agencias/departamentos

#####   


### Detalles técnicos

- **Endpoint: /api/v1/web/agencias/departamentos**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qaservicesweb.shalomcontrol.com/api/v1/web/agencias/departamentos
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 135.359px; width: 100%;"><thead class="text-left"><tr style="height: 29.7969px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%; height: 29.7969px;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%; height: 29.7969px;">URL</th></tr></thead><tbody><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://servicesweb.shalomcontrol.com/api/v1/web/agencias/departamentos</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://servicesweb.shalomcontrol.com/api/v1/web/agencias/departamentos</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://servicesweb.shalomcontrol.com/api/v1/web/agencias/departamentos</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
{}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Lista de departamentos",
    "data": [
        {
            "id": 1,
            "name": "AMAZONAS"
        },
        {
            "id": 2,
            "name": "ANCASH"
        },
        {
            "id": 3,
            "name": "APURIMAC"
        },
        {
            "id": 4,
            "name": "AREQUIPA"
        },
        {
            "id": 5,
            "name": "AYACUCHO"
        },
        {
            "id": 6,
            "name": "CAJAMARCA"
        },
        {
            "id": 7,
            "name": "CALLAO"
        },
        {
            "id": 8,
            "name": "CUSCO"
        },
        {
            "id": 9,
            "name": "HUANCAVELICA"
        },
        {
            "id": 10,
            "name": "HUANUCO"
        },
        {
            "id": 11,
            "name": "ICA"
        },
        {
            "id": 12,
            "name": "JUNIN"
        },
        {
            "id": 13,
            "name": "LA LIBERTAD"
        },
        {
            "id": 14,
            "name": "LAMBAYEQUE"
        },
        {
            "id": 15,
            "name": "LIMA"
        },
        {
            "id": 16,
            "name": "LORETO"
        },
        {
            "id": 17,
            "name": "MADRE DE DIOS"
        },
        {
            "id": 18,
            "name": "MOQUEGUA"
        },
        {
            "id": 19,
            "name": "PASCO"
        },
        {
            "id": 20,
            "name": "PIURA"
        },
        {
            "id": 21,
            "name": "PUNO"
        },
        {
            "id": 22,
            "name": "SAN MARTIN"
        },
        {
            "id": 23,
            "name": "TACNA"
        },
        {
            "id": 24,
            "name": "TUMBES"
        },
        {
            "id": 25,
            "name": "UCAYALI"
        }
    ]
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Perfil → Vista Perfil** 
    - **Evento:** Al presionar el item "Perfil"
    - **Uso:** Obtiene la informacion del usuario.

---

### 🖼️ Pantallazos

- **Perfil:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/MTXimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/MTXimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /api/v1/web/agencias/provincias

##### Servicio del modulo General.

### Detalles técnicos

- **Endpoint: /api/v1/web/agencias/provincias**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qaservicesweb.shalomcontrol.com/api/v1/web/agencias/provincias
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicesweb.shalomcontrol.com</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicesweb.shalomcontrol.com</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicesweb.shalomcontrol.com</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
depid:15
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Lista de provincias",
    "data": [
        {
            "id": 1,
            "name": "LIMA"
        },
        {
            "id": 2,
            "name": "BARRANCA"
        },
        {
            "id": 3,
            "name": "CAJATAMBO"
        },
        {
            "id": 4,
            "name": "CANTA"
        },
        {
            "id": 5,
            "name": "CAÑETE"
        },
        {
            "id": 6,
            "name": "HUARAL"
        },
        {
            "id": 7,
            "name": "HUAROCHIRI"
        },
        {
            "id": 8,
            "name": "HUAURA"
        },
        {
            "id": 9,
            "name": "OYON"
        },
        {
            "id": 10,
            "name": "YAUYOS"
        }
    ]
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Perfil → Perfil**  
    
    - **Evento:** Al escoger un departemento.
    - **Uso:** Lista las provincias segun el departamento elegido.

---

### 🖼️ Pantallazos

- **Perfil:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/JYlimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/JYlimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /api/envia_ya/terminals/validateDestinyTerminal

##### Lista de terminales por origen.

### Detalles técnicos

- **Endpoint: /api/envia\_ya/terminals/validateDestinyTerminal**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/envia_ya/terminals/validateDestinyTerminal
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/terminals/validateDestinyTerminal</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/terminals/validateDestinyTerminal</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/terminals/validateDestinyTerminal</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
{
    "id": "4"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "msn": "Valores obtenidos",
    "data": [
        {
            "ter_id": 2,
            "ter_nombre": "BAMBAMARCA",
            "ter_air_terminal_id": 365
        },
        {
            "ter_id": 4,
            "ter_nombre": "AV MEXICO CO",
            "ter_air_terminal_id": 365
        },
        {
            "ter_id": 5,
            "ter_nombre": "JR. LUNA PIZARRO",
            "ter_air_terminal_id": 365
        },
        {
            "ter_id": 6,
            "ter_nombre": "AV. LAS PALMERAS",
            "ter_air_terminal_id": 365
        },
        {
            "ter_id": 8,
            "ter_nombre": "ICA SAN JOAQUIN",
            "ter_air_terminal_id": 365
        },
        {
            "ter_id": 11,
            "ter_nombre": "CERRO DE PASCO",
            "ter_air_terminal_id": 365
        },
        {
            "ter_id": 13,
            "ter_nombre": "JAUJA",
            "ter_air_terminal_id": 365
        },
        {
            "ter_id": 16,
            "ter_nombre": "BARRANCA",
            "ter_air_terminal_id": 365
        },
        {
            "ter_id": 17,
            "ter_nombre": "AV ENRIQUE MEIGGS",
            "ter_air_terminal_id": 365
        },
        {
            "ter_id": 19,
            "ter_nombre": "SALAVERRY HUACHO CO",
            "ter_air_terminal_id": 365
        },
        {
            "ter_id": 22,
            "ter_nombre": "CAÑETE SAN VICENTE",
            "ter_air_terminal_id": 365
        },
        {
            "ter_id": 23,
            "ter_nombre": "PROLONG LUIS MASSARO",
            "ter_air_terminal_id": 365
        },
        {
            "ter_id": 24,
            "ter_nombre": "AV MARISCAL CASTILLA CO PARQUE INDUSTRIAL",
            "ter_air_terminal_id": 365
        },
    ]
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Registra → Registra**
    - **Evento:** Cuando toca el campo de "Destino"
    - **Uso:** Lista las terminales

---

### 🖼️ Pantallazos

- **Registra:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/EvWimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/EvWimage.png)

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/v1/web/agencias/distritos

##### Servicio del modulo General.

### Detalles técnicos

- **Endpoint: /api/v1/web/agencias/distritos**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qaservicesweb.shalomcontrol.com/api/v1/web/agencias/distritos
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicesweb.shalomcontrol.com/api/v1/web/agencias/distritos</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicesweb.shalomcontrol.com/api/v1/web/agencias/distritos</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicesweb.shalomcontrol.com/api/v1/web/agencias/distritos</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
depid:15
provid:1
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Lista de distritos",
    "data": [
        {
            "id": 1,
            "name": "LIMA(CERCADO)",
            "ubi_id": 150101
        },
        {
            "id": 2,
            "name": "ANCON",
            "ubi_id": 150102
        },
        {
            "id": 3,
            "name": "ATE-VITARTE",
            "ubi_id": 150103
        },
        {
            "id": 4,
            "name": "BARRANCO",
            "ubi_id": 150104
        },
        {
            "id": 5,
            "name": "BRENA",
            "ubi_id": 150105
        },
        {
            "id": 6,
            "name": "CARABAYLLO",
            "ubi_id": 150106
        },
        {
            "id": 7,
            "name": "CHACLACAYO",
            "ubi_id": 150107
        },
        {
            "id": 8,
            "name": "CHORRILLOS",
            "ubi_id": 150108
        },
        {
            "id": 9,
            "name": "CIENEGUILLA",
            "ubi_id": 150109
        },
        {
            "id": 10,
            "name": "COMAS",
            "ubi_id": 150110
        },
        {
            "id": 11,
            "name": "EL AGUSTINO",
            "ubi_id": 150111
        },
        {
            "id": 12,
            "name": "INDEPENDENCIA",
            "ubi_id": 150112
        },
        {
            "id": 13,
            "name": "JESUS MARIA",
            "ubi_id": 150113
        },
        {
            "id": 14,
            "name": "LA MOLINA",
            "ubi_id": 150114
        },
        {
            "id": 15,
            "name": "LA VICTORIA",
            "ubi_id": 150115
        },
        {
            "id": 16,
            "name": "LINCE",
            "ubi_id": 150116
        },
        {
            "id": 17,
            "name": "LOS OLIVOS",
            "ubi_id": 150117
        },
        {
            "id": 18,
            "name": "LURIGANCHO(CHOSICA)",
            "ubi_id": 150118
        },
        {
            "id": 19,
            "name": "LURIN",
            "ubi_id": 150119
        },
        {
            "id": 20,
            "name": "MAGDALENA DEL MAR",
            "ubi_id": 150120
        },
        {
            "id": 21,
            "name": "PUEBLO LIBRE",
            "ubi_id": 150121
        },
        {
            "id": 22,
            "name": "MIRAFLORES",
            "ubi_id": 150122
        },
        {
            "id": 23,
            "name": "PACHACAMAC",
            "ubi_id": 150123
        },
        {
            "id": 24,
            "name": "PUCUSANA",
            "ubi_id": 150124
        },
        {
            "id": 25,
            "name": "PUENTE PIEDRA",
            "ubi_id": 150125
        },
        {
            "id": 26,
            "name": "PUNTA HERMOSA",
            "ubi_id": 150126
        },
        {
            "id": 27,
            "name": "PUNTA NEGRA",
            "ubi_id": 150127
        },
        {
            "id": 28,
            "name": "RIMAC",
            "ubi_id": 150128
        },
        {
            "id": 29,
            "name": "SAN BARTOLO",
            "ubi_id": 150129
        },
        {
            "id": 30,
            "name": "SAN BORJA",
            "ubi_id": 150130
        },
        {
            "id": 31,
            "name": "SAN ISIDRO",
            "ubi_id": 150131
        },
        {
            "id": 32,
            "name": "SAN JUAN DE LURIGANCHO",
            "ubi_id": 150132
        },
        {
            "id": 33,
            "name": "SAN JUAN DE MIRAFLORES",
            "ubi_id": 150133
        },
        {
            "id": 34,
            "name": "SAN LUIS",
            "ubi_id": 150134
        },
        {
            "id": 35,
            "name": "SAN MARTIN DE PORRES",
            "ubi_id": 150135
        },
        {
            "id": 36,
            "name": "SAN MIGUEL",
            "ubi_id": 150136
        },
        {
            "id": 37,
            "name": "SANTA ANITA",
            "ubi_id": 150137
        },
        {
            "id": 38,
            "name": "SANTA MARIA DEL MAR ",
            "ubi_id": 150138
        },
        {
            "id": 39,
            "name": "SANTA ROSA",
            "ubi_id": 150139
        },
        {
            "id": 40,
            "name": "SANTIAGO DE SURCO",
            "ubi_id": 150140
        },
        {
            "id": 41,
            "name": "SURQUILLO",
            "ubi_id": 150141
        },
        {
            "id": 42,
            "name": "VILLA EL SALVADOR",
            "ubi_id": 150142
        },
        {
            "id": 43,
            "name": "VILLA MARIA DEL TRIUNFO",
            "ubi_id": 150143
        }
    ]
}
```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Perfil → Perfil**
    - **Evento:** Al escoger un departemento.
    - **Uso:** Lista

---

### 🖼️ Pantallazos

- **Perfil:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/VnMimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/VnMimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# Módulo Perfil

# /api/app/auth/user

##### Servicio del modulo General.

### Detalles técnicos

- **Endpoint: /api/app/auth/user**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/app/auth/user
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/user</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/user</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/user</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
document:72607245
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Datos encontrados.",
    "data": {
        "type_document": "DNI",
        "id": 89744,
        "document": "72607245",
        "name": "DAISY",
        "paternal_surname": "CHIPANA",
        "maternal_surname": "LAPA",
        "birthdate": null,
        "phone": 922749652,
        "email": "dchipanalapa@gmail.com",
        "address": null,
        "ubigeo": null,
        "departament_id": 0,
        "province_id": 0,
        "district_id": 0
    }
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Perfil → Perfil**
    - **Evento:** Al presionar el item "Perfil"
    - **Uso:** Obtiene la informacion del usuario.

---

### 🖼️ Pantallazos

- **Perfil:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/XsDimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/XsDimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/app/auth/user/update

##### Servicio del modulo General.

### Detalles técnicos

- **Endpoint: /api/app/auth/user/update**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/app/auth/user/update
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 135.2px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%; height: 29.6px;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%; height: 29.6px;">URL</th></tr></thead><tbody><tr style="height: 35.2px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/user/update</td></tr><tr style="height: 35.2px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/user/update</td></tr><tr style="height: 35.2px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/app/auth/user/update</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
document:75844645
birthdate:
address:Av. prueba2
ubigeo:150108
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Datos actualizados.",
    "data": {
        "document": "75844645",
        "birthdate": "1995-06-02",
        "address": "Av. prueba23",
        "ubigeo": 150108
    }
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Perfil → Perfil**
    - **Evento:** Al presionar el boton "Guardar datos".
    - **Uso:** Actualiza los datos del usuario.

---

### 🖼️ Pantallazos

- **Perfil:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/CsMimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/CsMimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/app/auth/password

##### Servicio del modulo General.

### Detalles técnicos

- **Endpoint: /api/app/auth/password**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```text
https://qapagalo.shalom.pe/api/app/auth/password
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 135.359px; width: 100%;"><thead class="text-left"><tr style="height: 29.7969px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%; height: 29.7969px;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%; height: 29.7969px;">URL</th></tr></thead><tbody><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/password</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/password</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/password</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
email:
phone:922749652
password:Shalom123!!
repeat:Shalom123!!
password_old:
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "La contraseña se creó correctamente."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Perfil → Perfil** 
    - **Evento:** Al presionar el boton "Actualizar contraseña".
    - **Uso:** Actualiza la contraseña del usuario.

---

### 🖼️ Pantallazos

- **Perfil:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/fmAimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/fmAimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/app/auth/account-deletion/check-send-limit

##### Servicio del modulo General.

### Detalles técnicos

- **Endpoint: /api/app/auth/account-deletion/check-send-limit**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```text
https://qapagalo.shalom.pe/api/app/auth/account-deletion/check-send-limit
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 135.359px; width: 100%;"><thead class="text-left"><tr style="height: 29.7969px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%; height: 29.7969px;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%; height: 29.7969px;">URL</th></tr></thead><tbody><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/account-deletion/check-send-limit</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/account-deletion/check-send-limit</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/account-deletion/check-send-limit</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
{
  "user_id": "89744",
  "method": "phone"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "blocked": false,
    "remainingAttempts": 3
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Perfil → Eliminar Cuenta**
    - **Evento:** Al presionar el boton "Continuar" luego de escoger una opcion.
    - **Uso:** Verifica la cantidad de intentos posibles.

---

### 🖼️ Pantallazos

- **Eliminar Cuenta:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/pGhimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/pGhimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/app/auth/account-deletion/send-otp

##### Servicio del modulo General.

### Detalles técnicos

- **Endpoint: /api/app/auth/account-deletion/send-otp**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```text
https://qapagalo.shalom.pe/api/app/auth/account-deletion/send-otp
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 135.359px; width: 100%;"><thead class="text-left"><tr style="height: 29.7969px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%; height: 29.7969px;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%; height: 29.7969px;">URL</th></tr></thead><tbody><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/account-deletion/send-otp</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/account-deletion/send-otp</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/account-deletion/send-otp</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
  "user_id": "89744",
  "method": "phone"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Código enviado correctamente",
    "method": "phone",
    "recipient": "92****652",
    "remainingResendAttempts": 0
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Perfil → Eliminar cuenta**
    - **Evento:** Al presionar el boton "Continuar" luego de escoger una opcion.
    - **Uso:** Solicita codigo segun la opcion que eligio.

---

### 🖼️ Pantallazos

- **Eliminar cuenta:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/RUkimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/RUkimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/app/auth/account-deletion/get-otp-info

##### Servicio del modulo General.

### Detalles técnicos

- **Endpoint: /api/app/auth/account-deletion/get-otp-info**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```text
https://qapagalo.shalom.pe/api/app/auth/account-deletion/get-otp-info
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 135.359px; width: 100%;"><thead class="text-left"><tr style="height: 29.7969px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%; height: 29.7969px;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%; height: 29.7969px;">URL</th></tr></thead><tbody><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/account-deletion/get-otp-info</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/account-deletion/get-otp-info</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/account-deletion/get-otp-info</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
  "user_id":"89744",
  "method":"phone"
}
```

---

### 📤 Response

```json
{
  "success":true,
  "remainingSeconds":118,
  "isBlocked":true,
  "failedAttempts":3,
  "remainingAttempts":0
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Perfil → Ellminar cuenta**
    - **Evento:** Al presionar el boton "Reenviar codigo" de la alerta "Se acabo el tiempo".
    - **Uso:** Obtiene la informacion de cuanto envios tiene segun la opcion que eligio.

---

### 🖼️ Pantallazos

- **Eliminar cuenta:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/WjNimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/WjNimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/app/auth/account-deletion/validate-otp

##### Servicio del modulo General.

### Detalles técnicos

- **Endpoint: /api/app/auth/account-deletion**/validate-otp
- **Método:** `POST`

### 🌐 Dominios

#### QA

```text
https://qapagalo.shalom.pe/api/app/auth/account-deletion/validate-otp
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 135.359px; width: 100%;"><thead class="text-left"><tr style="height: 29.7969px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%; height: 29.7969px;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%; height: 29.7969px;">URL</th></tr></thead><tbody><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/account-deletion/validate-otp</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/account-deletion/validate-otp</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/account-deletion/validate-otp</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
```

---

### 📤 Response

```json


```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo principal → General**
    - **Evento:**
    - **Uso:**

---

### 🖼️ Pantallazos

- **Login:**

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/app/auth/account-deletion/complete

##### Servicio del modulo General.

### Detalles técnicos

- **Endpoint: /api/app/auth/account-deletion**/complete
- **Método:** `POST`

### 🌐 Dominios

#### QA

```text
https://qapagalo.shalom.pe/api/app/auth/account-deletion/complete
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 135.359px; width: 100%;"><thead class="text-left"><tr style="height: 29.7969px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%; height: 29.7969px;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%; height: 29.7969px;">URL</th></tr></thead><tbody><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/account-deletion/complete</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/account-deletion/complete</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/account-deletion/complete</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
  "user_id":"89744"
}
```

---

### 📤 Response

```json
{
  "success":true,
  "message":"Tu cuenta ha sido eliminada correctamente"
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Perfil → Eliminar Cuenta**
    - **Evento:** Al presionar el boton "Validar codigo"
    - **Uso:** Elimina la cuenta.

---

### 🖼️ Pantallazos

- **Eliminar Cuenta:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/NIbimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/NIbimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/app/auth/account-deletion/submit-form-response

##### Servicio del modulo General.

### Detalles técnicos

- **Endpoint: /api/app/auth/account-deletion**/submit-form-response
- **Método:** `POST`

### 🌐 Dominios

#### QA

```text
https://qapagalo.shalom.pe/api/app/auth/account-deletion/submit-form-response
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 135.359px; width: 100%;"><thead class="text-left"><tr style="height: 29.7969px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%; height: 29.7969px;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%; height: 29.7969px;">URL</th></tr></thead><tbody><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/account-deletion/submit-form-response</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/account-deletion/submit-form-response</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/app/auth/account-deletion/submit-form-response</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
{
    "user_id":"89744",
    "reason":2,
    "suggestions":"prueba",
    "name":"Daisy Chipana Lapa",
    "document_type":"1",
    "document":"72607245",
    "phone":"922749652",
    "address":"Chorrillos"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Respuesta guardada correctamente"
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Perfil → Eliminar cuenta**
    - **Evento:** Al presionar el boton "Enviar"
    - **Uso:** Registra la razon del usuario porque decidio eliminar su cuenta.

---

### 🖼️ Pantallazos

- **Eliminar cuenta:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/WsTimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/WsTimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# Módulo Registra

# /api/envia_ya/products

##### Servicio del modulo General.

### Detalles técnicos

- **Endpoint: /api/envia\_ya/products**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/envia_ya/products
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/products</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/products</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/products</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
{}
```

---

### 📤 Response

```json
{
    "success": true,
    "data": [
        {
            "id": 3,
            "title": "Sobre",
            "img": "/img/ENVIA_YA/sobre.png",
            "content": "Documentos simples en sobre manila / Tamaño A4",
            "sub_content": "",
            "measurements": {
                "width": 0.15,
                "height": 0.1,
                "length": 0.1,
                "weight": 0.25
            }
        },
        {
            "id": 1096,
            "title": "Caja Paquete XXS",
            "img": "/img/ENVIA_YA/paquete_xxs.png",
            "content": "15 x 10 x 10 cm",
            "sub_content": "Peso máx. 250 gr",
            "measurements": {
                "width": 0.15,
                "height": 0.1,
                "length": 0.1,
                "weight": 0.25
            }
        },
        {
            "id": 1090,
            "title": "Caja Paquete XS",
            "img": "/img/ENVIA_YA/paquete_xs.png",
            "content": "15 x 20 x 12 cm",
            "sub_content": "Peso máx. 500 gr",
            "measurements": {
                "width": 0.15,
                "height": 0.2,
                "length": 0.2,
                "weight": 0.5
            }
        },
        {
            "id": 5,
            "title": "Caja Paquete S",
            "img": "/img/ENVIA_YA/paquete_s.png",
            "content": "20 x 30 x 12 cm",
            "sub_content": "Peso máx. 2 kg",
            "measurements": {
                "width": 0.2,
                "height": 0.3,
                "length": 0.12,
                "weight": 2
            }
        },
        {
            "id": 1093,
            "title": "Caja Paquete M",
            "img": "/img/ENVIA_YA/paquete_m.png",
            "content": "24 x 30 x 20 cm",
            "sub_content": "Peso máx. 5 kg",
            "measurements": {
                "width": 0.24,
                "height": 0.3,
                "length": 0.2,
                "weight": 5
            }
        },
        {
            "id": 2,
            "title": "Caja Paquete L",
            "img": "/img/ENVIA_YA/paquete_l.png",
            "content": "42 x 30 x 23 cm",
            "sub_content": "Peso máx. 10 kg",
            "measurements": {
                "width": 0.42,
                "height": 0.3,
                "length": 0.23,
                "weight": 10
            }
        },
        {
            "id": 4,
            "title": "Otra Medida",
            "img": "/img/ENVIA_YA/otra_medida.png",
            "content": "",
            "sub_content": "",
            "measurements": {
                "width": 0,
                "height": 0,
                "length": 0,
                "weight": 0
            }
        }
    ]
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Registra → Registra**
    - **Evento:** Al ingresar al modulo "Registra".
    - **Uso:** Muestra los tipos de productos que existen para enviar.

---

### 🖼️ Pantallazos

- **Registra:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/IQ0image.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/IQ0image.png)

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/pagalo/person/search

##### Servicio consumido por la app para una funcionalidad especifica.

### Detalles técnicos

- **Endpoint: /api/pagalo/person/search**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/pagalo/person/search
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/pagalo/person/search</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/pagalo/person/search</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/pagalo/person/search</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
{
    "document":"72607245",
    "type_document":"DNI"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Entidad encontrada",
    "data": {
        "type_document": "DNI",
        "document": "72607245",
        "name": "DAISY",
        "lastname": "CHIPANA",
        "surname": "LAPA",
        "full_name": "DAISY CHIPANA LAPA",
        "phone": 922749652,
        "email": "dchipanalapa@gmail.com",
        "address": "Chorrillos"
    }
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Registra → Vista "Estimacion de la tarifa"**
    - **Evento:** Al presionar el boton "continuar"
    - **Uso:** Obtiene los datos de la persona.
2. **Módulo Registra → Vista "Quien realiza el envio"**
    - **Evento:** Al digitar el dni completo.
    - **Uso:** Obtiene los datos de la persona.

---

### 🖼️ Pantallazos

- **Registra:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/cSiimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/cSiimage.png)

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/envia_ya/tariff

#####   


### Detalles técnicos

- **Endpoint: /api/envia\_ya/tariff**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/envia_ya/tariff
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/tariff</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/tariff</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/tariff</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
{
    "origen":"45",
    "destino":"7"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "tarifa",
    "data": {
        "tar_anotacion": "",
        "tar_antivuelcos": "0.00",
        "tar_base": "0.00",
        "tar_densidadbase": "0.00",
        "tar_igv": "1",
        "tar_jaulas": "0.00",
        "tar_minimopeso": "0.50",
        "tar_minimovolumen": "110.00",
        "tar_paqueteria": "12.00",
        "tar_paqueteriamin": "10.00",
        "tar_planchas": "0.00",
        "tar_preminimo": "14.00",
        "tar_presobre": "8.00",
        "tar_paquetexxs": "8.00",
        "Paquetito": "12.00",
        "tar_tolvas": "0.00",
        "distancia": 30,
        "origen": 0,
        "destino": 0,
        "tar_urldoc": null,
        "tar_tiempo_llegada": 24,
        "tar_ovz": "0",
        "tar_hea": "0",
        "conexion": {
            "min_peso": 0,
            "min_volumen": 0,
            "min_precio": 0,
            "min_paq_jr": 0,
            "min_paqueteria": 0,
            "min_paquetexs": 0,
            "min_paquetexxs": 0,
            "min_sobre": 0
        },
        "lead_time": ""
    }
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Registra → ¿A donde deseas enviar?**
    - **Evento:** Al presionar el boton "continuar".
    - **Uso:** Lista las tarifas.

---

### 🖼️ Pantallazos

- **Registra:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/5e2image.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/5e2image.png)

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/envia_ya/tariff/calculate

#####   


### Detalles técnicos

- **Endpoint: /api/envia\_ya/tariff/calculate**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/envia_ya/tariff/calculate
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/tariff/calculate</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/tariff/calculate</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/tariff/calculate</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "origin":"45",
    "destiny":"9",
    "width":"0.56",
    "height":"0.8",
    "length":"1.5",
    "weight":"2.0"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Calculo realizado",
    "data": {
        "price": 151,
        "tariff": {
            "peso": 1,
            "volumen": 226,
            "sobre": 8,
            "cajapaquetexxs": 8,
            "cajapaquetexs": 10,
            "cajapaquetes": 12,
            "cajapaquetem": 15,
            "cajapaquetel": 20,
            "ovz": 0,
            "hea": 0,
            "conexion_aerea": 0,
            "caja_aerea": 0
        },
        "message": "Cotización basada en el volumen",
        "type": "volumen"
    }
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Registra → Vista ¿A donde deseas enviar?**
    - **Evento:** Cuando se presiona el boton "continuar".
    - **Uso:** Obtiene el calculo del producto segun sus medidas.

---

### 🖼️ Pantallazos

- **Registra:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/wWtimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/wWtimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/envia_ya/person/save

#####   


### Detalles técnicos

- **Endpoint: /api/envia\_ya/person/save**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/envia_ya/person/save
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/person/save</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/person/save</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/person/save</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "documento":"72607245",
    "name":"DAISY",
    "firstname":"CHIPANA",
    "lastname":"LAPA",
    "phone":"922749652"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Cliente registrado correctamente",
    "data": {
        "documento": "72607245",
        "nombres": "DAISY",
        "apellido_paterno": "CHIPANA",
        "apellido_materno": "LAPA",
        "phone": 922749652,
        "email": "dchipanalapa@gmail.com"
    }
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Registra → Vista ¿Quien realiza el envio?**
    - **Evento:** Al presionar el boton "Registrar remitente".
    - **Uso:** Registre el cliente (remitente).
2. **Módulo Registra → Vista ¿Quien recibira el envio?**
    - **Evento:** Al presionar el boton "Registrar destinatario".
    - **Uso:** Registre el cliente (destinatario).

---

### 🖼️ Pantallazos

- **Registra :**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/PPwimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/PPwimage.png)

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/envia_ya/service_order/save

#####   


### Detalles técnicos

- **Endpoint: /api/envia\_ya/service\_order/save**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/service\_order/save</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/service\_order/save</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/service\_order/save</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "origen":"45",
    "destino":"7",
    "tipo_producto":"1096",
    "cantidad":"1",
    "peso":"0.25",
    "alto":"0.1",
    "ancho":"0.15",
    "costo":"8.0",
    "largo":"0.1",
    "remitente":"72607245",
    "destinatario":"72607245",
    "garantia":"null",
    "garantia_costo":"null",
    "garantia_monto":"null",
    "grrs":[
            {
                "serie":"123",
                "numero":"25896363"
            }
        ],
    "clave":"7896",
    "aereo":"0",
    "contacto_doc":"",
    "declaracion_jurada":""
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Orden de servicio registrada",
    "data": {
        "codigo": "J3HN",
        "guia": 50013850,
        "serie": "V245",
        "ose_id": 82742733,
        "precio": 8
    }
}
```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Registra → Vista "Crea tu clave de seguridad".**
    - **Evento:** Al presionar el boton "Crear orden de servicio".
    - **Uso:** Regsitra el orden de servicio.

---

### 🖼️ Pantallazos

- **Registra:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/xlximage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/xlximage.png)

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/envia_ya/code/validate (no se usa)

##### Servicio del modulo General.

### Detalles técnicos

- **Endpoint: /api/envia\_ya/code/validate**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/envia_ya/code/validate
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/code/validate</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/code/validate</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/code/validate</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
```

---

### 📤 Response

```json


```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Inicial → Vista Login**
    - **Evento:**
    - **Uso:**

---

### 🖼️ Pantallazos

- **Login:**

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/envia_ya/phone/message (no se usa)

#####   


### Detalles técnicos

- **Endpoint: /api/envia\_ya/phone/message**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/envia_ya/phone/message
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/phone/message</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/phone/message</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/phone/message</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
```

---

### 📤 Response

```json


```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Inicial → Vista Login**
    - **Evento:**
    - **Uso:**

---

### 🖼️ Pantallazos

- **Login:**

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/envia_ya/phone/validate (no se usa)

#####   


### Detalles técnicos

- **Endpoint: /api/envia\_ya/phone/validate**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/envia_ya/phone/validate
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/phone/validate</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/phone/validate</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/phone/validate</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
```

---

### 📤 Response

```json


```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Inicial → Vista Login**
    - **Evento:**
    - **Uso:**

---

### 🖼️ Pantallazos

- **Login:**

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/envia_ya/service_order/pdf

#####   


### Detalles técnicos

- **Endpoint: /api/envia\_ya/service\_order/pdf**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/envia_ya/service_order/pdf
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/service\_order/pdf</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/service\_order/pdf</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/envia\_ya/service\_order/pdf</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
```

---

### 📤 Response

```json


```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Registra → Vista Detalle Orden Servicio**
    - **Evento:** Al presionar el boton "descargar".
    - **Uso:**

---

### 🖼️ Pantallazos

- **Registra:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/kzIimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/kzIimage.png)

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# Módulo Pagalo

# /api/pagalo/wallet/qr

##### Ejecuta operaciones de pago y billetera.

### Detalles técnicos

- **Endpoint: /api/pagalo/wallet/qr**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/pagalo/wallet/qr
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 135.359px; width: 100%;"><thead class="text-left"><tr style="height: 29.7969px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%; height: 29.7969px;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%; height: 29.7969px;">URL</th></tr></thead><tbody><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/pagalo/wallet/qr</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/pagalo/wallet/qr</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/pagalo/wallet/qr</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
```

---

### 📤 Response

```json


```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Inicial → Vista Login**
    - **Evento:**
    - **Uso:**

---

### 🖼️ Pantallazos

- **Login:**

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/v1/web/pagalo/persona

##### Ejecuta operaciones de pago y billetera.

### Detalles técnicos

- **Endpoint: /api/v1/web/pagalo/persona**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qaservicespayment.shalomcontrol.com/api/v1/web/pagalo/persona
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicespayment.shalomcontrol.com/api/v1/web/pagalo/persona</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicespayment.shalomcontrol.com/api/v1/web/pagalo/persona</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicespayment.shalomcontrol.com/api/v1/web/pagalo/persona</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
document:72607245
type_document:DNI
```

---

### 📤 Response

```json
{
    "success":true,"data":
    {
      "type_document":"DNI",
      "document":"72607245",
      "name":"DAISY",
      "lastname":"CHIPANA",
      "surname":"LAPA",
      "full_name":"DAISY CHIPANA LAPA",
      "address":"Av. Prueba",
      "phone":"922749652",
      "phone_masked":"92*****52",
      "email":"dchipanalapa@gmail.com",
      "email_masked":"dc**********@gmail.com"
    }
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Inicial → Vista Login**
    - **Evento:** Al digitar el numero de DNI o CE.
    - **Uso:** Devuelve la informacion del dni, si existe en la BD.

---

### 🖼️ Pantallazos

- **Regsitro:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/image.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/image.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\pages\\agregarContacto\\Services\\agregar\_contacto\_service.dart
    - lib/src\\pages\\cambioDestino\\Services\\cambio\_detino\_service.dart
    - lib/src\\pages\\DevolucionMercaderia\\Services\\devolucion\_mercaderia\_service.dart
    - lib/src\\pages\\LiberacionCarga\\Services\\liberacion\_carga\_services.dart
    - lib/src\\pages\\Login\\Services\\login\_services.dart
    - lib/src\\pages\\RetencionCarga\\Services\\retencion\_carga\_services.dart

---

### 🗒️ Notas adicionales

- - Endpoint reutilizado en multiples pantallas/modulos.
    - La respuesta llega encriptada.

# /api/v1/web/pagalo/persona/registrar

##### Ejecuta operaciones de pago y billetera.

### Detalles técnicos

- **Endpoint: /api/v1/web/pagalo/persona/registrar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qaservicespayment.shalomcontrol.com/api/v1/web/pagalo/persona/registrar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicespayment.shalomcontrol.com/api/v1/web/pagalo/persona/registrar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicespayment.shalomcontrol.com/api/v1/web/pagalo/persona/registrar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicespayment.shalomcontrol.com/api/v1/web/pagalo/persona/registrar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
```

---

### 📤 Response

```json


```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Inicial → Vista Login**
    - **Evento:**
    - **Uso:**

---

### 🖼️ Pantallazos

- **Login:**

### 📂 Archivos Flutter relacionados

- - lib/src\\pages\\agregarContacto\\Services\\agregar\_contacto\_service.dart
    - lib/src\\pages\\cambioDestino\\Services\\cambio\_detino\_service.dart
    - lib/src\\pages\\DevolucionMercaderia\\Services\\devolucion\_mercaderia\_service.dart
    - lib/src\\pages\\LiberacionCarga\\Services\\liberacion\_carga\_services.dart
    - lib/src\\pages\\RetencionCarga\\Services\\retencion\_carga\_services.dart

---

### 🗒️ Notas adicionales

- - Endpoint reutilizado en multiples pantallas/modulos.

# /api/v1/web/rastrea/grts

##### Consulta estado y trazabilidad de guias/ordenes.

### Detalles técnicos

- **Endpoint: /api/v1/web/rastrea/grts**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qaservicesweb.shalomcontrol.com/api/v1/web/rastrea/grts
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicesweb.shalomcontrol.com/api/v1/web/rastrea/grts</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicesweb.shalomcontrol.com/api/v1/web/rastrea/grts</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://servicesweb.shalomcontrol.com/api/v1/web/rastrea/grts</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
{
  "ose_id": ""
}
```

---

### 📤 Response

```json


```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Inicial → Vista Login**
    - **Evento:**
    - **Uso:**

---

### 🖼️ Pantallazos

- **Login:**

### 📂 Archivos Flutter relacionados

- - lib/src\\Patronbloc\\streams\\bloc-search-guia.dart
    - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# Módulo Agregar contacto

# /api/cambio_consignado/orden/buscar

#####   


### Detalles técnicos

- **Endpoint: /api/cambio\_consignado/orden/buscar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/cambio_consignado/orden/buscar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 135.359px; width: 100%;"><thead class="text-left"><tr style="height: 29.7969px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%; height: 29.7969px;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%; height: 29.7969px;">URL</th></tr></thead><tbody><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/cambio\_consignado/orden/buscar</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/cambio\_consignado/orden/buscar</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/cambio\_consignado/orden/buscar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
{
    "codigo":"WJNN",
    "guia":"50013967",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Número de orden verificada"
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Agregar Contacto → Proceso**
    - **Evento:** Al presionar el boton "Siguiente".
    - **Uso:** Verifica si la guia es correcta.

---

### 🖼️ Pantallazos

- **Agregar Contacto:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/KsQimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/KsQimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/cambio_consignado/orden/validar

#####   


### Detalles técnicos

- **Endpoint: /api/cambio\_consignado/orden/validar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/cambio_consignado/orden/validar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_consignado/orden/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_consignado/orden/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_consignado/orden/validar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "codigo":"WJNN",
    "destinatario":
        {
            "documento":"72607245",
            "telefono":"922749652"
        },
    "destino":
        {
            "ter_id":"730"
        },
    "fecha":"2026-06-15",
    "guia":"50013967",
    "origen":
        {
            "ter_id":"45"
        },
    "remitente":
        {
            "documento":"72607245",
            "telefono":"922749652"
        },
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Remitente verificado",
    "data": 82742839
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Agregar Contacto → Vista Valida los datos del Ticket Shalom**
    - **Evento:** Al presionar el boton "continuar".
    - **Uso:** Verifica el remitente.

---

### 🖼️ Pantallazos

- **Agregar Contacto:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/eUOimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/eUOimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/cambio_consignado/sms

#####   


### Detalles técnicos

- **Endpoint: /api/cambio\_consignado/sms**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/cambio_consignado/sms
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_consignado/sms</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_consignado/sms</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_consignado/sms</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
{
    "ose_id":"82742839",
    "telefono":"922749652",
    "usuario":"72607245",
    "email":""
}
```

```
{
    "ose_id":"82742839",
    "telefono":"",
    "usuario":"72607245",
    "email":"dchipanalapa@gmail.com"
}
```

---

### 📤 Response

```json
{
  "success": true,
  "message": "Clave enviada revise su teléfono."
}

```

```json
{
  "success": true,
  "message": "Clave enviada revise su correo."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Agregar Contacto → Vista Agregar Contacto**
    - **Evento:** Al presionar el boton "solicitar codigo de verificación".
    - **Uso:** Solicita el envia de la clave al telefono.

---

### 🖼️ Pantallazos

- **Agregar Contacto:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/5Stimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/5Stimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/cambio_consignado/validar

##### Ejecuta el flujo de cambio de consignado.

### Detalles técnicos

- **Endpoint: /api/cambio\_consignado/validar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/cambio_consignado/validar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_consignado/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_consignado/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_consignado/validar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742839",
    "telefono":"922749652",
    "clave":"DM937N",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
  "success": true,
  "message":"Clave confirmada."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Agregar Contacto → Vista Agregar Contacto**
    - **Evento:** Al terminar de digitar el codigo de verificación
    - **Uso:** Valida si el codigo es correcto.

---

### 🖼️ Pantallazos

- **Agregar Contacto:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/VpYimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/VpYimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/cambio_consignado/guardar

##### Ejecuta el flujo de cambio de consignado.

### Detalles técnicos

- **Endpoint: /api/cambio\_consignado/guardar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/cambio_consignado/guardar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_consignado/guardar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_consignado/guardar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_consignado/guardar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742839",
    "telefono":"922749652",
    "clave":"DM937N",
    "destinatario":"75844645",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
  "success": true,
  "message":"El contacto se agregó de manera exitosa."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Agregar Contacto → Agregar Contacto**
    - **Evento:** Al presionar el boton "confirmar".
    - **Uso:** Actualiza el contacto de la guía.

---

### 🖼️ Pantallazos

- **Agregar Contacto:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/Z6Aimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/Z6Aimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# Módulo Cambio de destino

# /api/cambio_destino/orden/buscar

##### Ejecuta el flujo de cambio de destino.

### Detalles técnicos

- **Endpoint: /api/cambio\_destino/orden/buscar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/cambio_destino/orden/buscar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_destino/orden/buscar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_destino/orden/buscar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_destino/orden/buscar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
{
    "guia":"50013965",
    "codigo":"C3KM",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Número de orden verificada"
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Cambio de destino → Vista Proceso de Cambio de destino**
    - **Evento:** Al presionar el boton "continuar".
    - **Uso:** Valida el numero de orden de la guia.

---

### 🖼️ Pantallazos

- **Cambio de destino:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/QMIimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/QMIimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/cambio_destino/orden/validar

##### Ejecuta el flujo de cambio de destino.

### Detalles técnicos

- **Endpoint: /api/cambio\_destino/orden/validar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/cambio_destino/orden/validar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_destino/orden/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_destino/orden/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_destino/orden/validar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "codigo": "C3KM",
    "destinatario": 
        {
            "documento": "72607245", 
            "telefono": "922749652"
        },
    "destino": 
        {
            "ter_id": "7"
        },
    "fecha": "2026-06-15",
    "guia": "50013965",
    "origen": 
        {
            "ter_id": "45"
        },
    "remitente":
        {
            "documento": "72607245", 
            "telefono": "922749652"
        },
    "usuario": "72607245"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Remitente verificado",
    "data": 82742837
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Cambio de destino → Vista Login**
    - **Evento:** Al presionar el boton "Continuar".
    - **Uso:** Verifica si es valido el remitente.

---

### 🖼️ Pantallazos

- **Cambio de destino:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/aOWimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/aOWimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/cambio_destino/sms

##### Ejecuta el flujo de cambio de destino.

### Detalles técnicos

- **Endpoint: /api/cambio\_destino/sms**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/cambio_destino/sms
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_destino/sms</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_destino/sms</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_destino/sms</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742837",
    "telefono":"",
    "email":"dchipanalapa@gmail.com",
    "usuario":"72607245"
}
```

```json
{
    "ose_id":"82742837",
    "telefono":"922749652",
    "email":"",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
  "success":true,
  "message":"Clave enviada revise su correo."
}

```

```json
{
  "success":true,
  "message":"Clave enviada revise su teléfono."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Cambio de destino → Vista Cambio de destino**
    - **Evento:** Al presionar el boton "Solicitar codigo de verificacion".
    - **Uso:** Solicita clave de verificacion segun la opcion elegida( Correo / Telefono).

---

### 🖼️ Pantallazos

- **Cambio de destino:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/AXhimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/AXhimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/cambio_destino/validar

##### Ejecuta el flujo de cambio de destino.

### Detalles técnicos

- **Endpoint: /api/cambio\_destino/validar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/cambio_destino/validar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_destino/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_destino/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_destino/validar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742837",
    "telefono":"922749652",
    "clave":"HMDND7",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Clave confirmada."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Cambio de destino → Vista Cambio de destino**
    - **Evento:** Al terminar de digitar el codigo de verificacion.
    - **Uso:** Verifica si la clave es correcta.

---

### 🖼️ Pantallazos

- **Cambio de destino:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/EtJimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/EtJimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/cambio_destino/guardar

##### Ejecuta el flujo de cambio de destino.

### Detalles técnicos

- **Endpoint: /api/cambio\_destino/guardar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/cambio_destino/guardar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_destino/guardar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_destino/guardar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/cambio\_destino/guardar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
      "ose_id": "82742837",
      "telefono": "922749652",
      "clave": "HMDND7",
      "destino": "9",
      "destinatario": "72607245",
      "usuario": "72607245"
}
```

---

### 📤 Response

```json


```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Cambio de destino → Vista Cambio de destino**
    - **Evento:** Al presionar el boton "Confirmar".
    - **Uso:** Registra el cambio de destino.

---

### 🖼️ Pantallazos

- **Cambio de destino:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/9hbimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/9hbimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# Módulo Actualizacion clave

# /api/actualizaclave/orden/buscar

##### Ejecuta el flujo de actualizacion de clave.

### Detalles técnicos

- **Endpoint: /api/actualizaclave/orden/buscar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/actualizaclave/orden/buscar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/actualizaclave/orden/buscar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/actualizaclave/orden/buscar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/actualizaclave/orden/buscar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
{
    "codigo":"WJNN",
    "guia":"50013967",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Número de orden verificada"
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Actualizacion de Clave → Proceso de Actualizacion de Clave**
    - **Evento:** Al presionar el boton "Continuar".
    - **Uso:** Verifica el numero de orden.

---

### 🖼️ Pantallazos

- **Actualizacion de Clave:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/5otimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/5otimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /api/actualizaclave/orden/validar

##### Ejecuta el flujo de actualizacion de clave.

### Detalles técnicos

- **Endpoint: /api/actualizaclave/orden/validar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/actualizaclave/orden/validar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/actualizaclave/orden/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/actualizaclave/orden/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/actualizaclave/orden/validar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "codigo":"WJNN",
    "destinatario": {
        "documento":"72607245",
        "telefono":"922749652"
    },
    "destino": {
        "ter_id":"730"
    },
    "fecha": "2026-06-15",
    "guia": "50013967",
    "origen": {
    "ter_id":"45"
    },
    "remitente": {
        "documento":"72607245",
        "telefono":"922749652"
    }
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Remitente verificado",
    "data": 82742839
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Actualizacion de Clave→ Valida los datos del Ticket**
    - **Evento:** Al presionar el boton "Continuar".
    - **Uso:** Verifica el remitente.

---

### 🖼️ Pantallazos

- **Actualizacion de Clave:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/vY1image.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/vY1image.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# api/actualizaclave/pregunta/validar

##### Ejecuta el flujo de actualizacion de clave.

### Detalles técnicos

- **Endpoint: /api/actualizaclave/pregunta/validar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/actualizaclave/pregunta/validar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/actualizaclave/pregunta/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/actualizaclave/pregunta/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/actualizaclave/pregunta/validar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "answer":"NO",
    "question":"TERMINAL_ORIGEN",
    "terminal_aleatoria":"240",
    "remitente": {
        "documento":"72607245",
        "telefono":"922749652"
    }
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Respuesta correcta"
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Actualizacion de Clave → Vista Login**
    - **Evento:** Al presionar el boton "SI" o "NO"
    - **Uso:** Valida si se escogio la respuesta correcta.

---

### 🖼️ Pantallazos

- **Actualizacion de Clave:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/8wrimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/8wrimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /api/actualizaclave/mensaje/enviar

##### Ejecuta el flujo de actualizacion de clave.

### Detalles técnicos

- **Endpoint: /api/actualizaclave/mensaje/enviar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/actualizaclave/mensaje/enviar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/actualizaclave/mensaje/enviar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/actualizaclave/mensaje/enviar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/actualizaclave/mensaje/enviar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "asesor":"EPPCD",
    "idos":"82742839",
    "origen":"45",
    "cell":"922749652",
    "text":"SHALOM EMPRESARIAL: Su código para cambio de clave para la guía 50013967 es: EPPCD.",
    "email":"dchipanalapa@gmail.com",
    "tipoMensaje":"1"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Mensaje enviado ",
    "data": {
        "response": {
            "success": true,
            "message": "Email enviado"
        },
        "insert": 286624
    }
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Actualizacion de Clave → Actualiza tu clave**
    - **Evento:** Cuando presiona el boton "Solicitar codigo de verificacion".
    - **Uso:** Se envia el codigo a la opcion elegida(Celular/Correo).

---

### 🖼️ Pantallazos

- **Actualizacion de Clave:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/dudimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/dudimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /api/actualizaclave/clave/validar

##### Ejecuta el flujo de actualizacion de clave.

### Detalles técnicos

- **Endpoint: /api/actualizaclave/clave/validar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/actualizaclave/clave/validar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/actualizaclave/clave/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/actualizaclave/clave/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/actualizaclave/clave/validar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "idose":"82742839",
    "codigo":"EPPCD"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Codigo validado"
}
```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Actualizacion de Clave → Actualiza tu Clave**
    - **Evento:** Cuando termina de digitar el codigo de verificacion.
    - **Uso:** Valida el codigo.

---

### 🖼️ Pantallazos

- **Actualizacion de Clave:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/hd6image.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/hd6image.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /api/actualizaclave/clave/actualizar

##### Ejecuta el flujo de actualizacion de clave.

### Detalles técnicos

- **Endpoint: /api/actualizaclave/clave/actualizar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/actualizaclave/clave/actualizar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/actualizaclave/clave/actualizar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/actualizaclave/clave/actualizar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/actualizaclave/clave/actualizar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "idose":"82742839",
    "codigo":"WJNN",
    "destinatario": {
        "documento": "72607245",
        "telefono":"922749652"
    },
    "destino": {
        "ter_id":"730"
    },
    "fecha": "2026-06-15",
    "guia":"50013967",
    "monto":"",
    "origen": {
        "ter_id": "45"
    },
    "clave":"8889",
    "remitente": {
        "documento":"72607245",
        "telefono":"922749652"
    },
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Nueva clave generada con éxito su clave es: ",
    "data": "8889"
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Actualizacion de Clave → Actualiza tu clave** 
    - **Evento:** Cuando presiona el boton "Generar".
    - **Uso:** Generar la clave ingresada para la guia.

---

### 🖼️ Pantallazos

- **Actualizacion de Clave:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/IUTimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/IUTimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# Módulo Devolucion de mercaderia

# /api/devolucion_mercaderia/orden/buscar

##### Ejecuta el flujo de devolucion de mercaderia.

### Detalles técnicos

- **Endpoint: /api/devolucion\_mercaderia/orden/buscar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/devolucion_mercaderia/orden/buscar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/devolucion\_mercaderia/orden/buscar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/devolucion\_mercaderia/orden/buscar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/devolucion\_mercaderia/orden/buscar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "codigo":"C3KM",
    "guia":"50013965",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Número de orden verificada"
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Devolucion de Mercaderia → Proceso de Devolucion de Mercaderia**
    - **Evento:** Al presionar el boton "Siguiente".
    - **Uso:** Verifica el numero de orden.

---

### 🖼️ Pantallazos

- **Devolucion de Mercaderia:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/o6dimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/o6dimage.png)

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/devolucion_mercaderia/orden/validar

##### Ejecuta el flujo de devolucion de mercaderia.

### Detalles técnicos

- **Endpoint: /api/devolucion\_mercaderia/orden/validar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/devolucion_mercaderia/orden/validar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/devolucion\_mercaderia/orden/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/devolucion\_mercaderia/orden/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/devolucion\_mercaderia/orden/validar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "codigo":"C3KM",
    "destinatario": {
        "documento":"72607245",
        "telefono":"922749652"
    },
    "destino": {
        "ter_id":" 7"
    },
    "fecha": "2026-06-15",
    "guia":"50013965",
    "origen": {
        "ter_id":"45"
    },
    "remitente":{
        "documento":"72607245",
        "telefono":"922749652"
    },
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Remitente verificado",
    "data": {
        "ose_id": 82742837,
        "remitente": "72607245",
        "remitente_nombre": "DAISY",
        "remitente_appaterno": "CHIPANA",
        "remitente_apmaterno": "LAPA",
        "remitente_nombre_completo": "DAISY CHIPANA LAPA",
        "destinatario": "72607245",
        "origen": 45,
        "destino": 7,
        "telefono_remitente": 922749652,
        "fecha": "2026-06-15 09:56:02"
    }
}
```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Devolucion de Mercaderia → Devolucion de Mercaderia**
    - **Evento:** Al presionar el boton "Continuar".
    - **Uso:** Verifica el remitente.

---

### 🖼️ Pantallazos

- **Devolucion de Mercaderia:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/WfVimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/WfVimage.png)

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/devolucion_mercaderia/mail

##### Ejecuta el flujo de devolucion de mercaderia.

### Detalles técnicos

- **Endpoint: /api/devolucion\_mercaderia/mail**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/devolucion_mercaderia/mail
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 135.359px; width: 100%;"><thead class="text-left"><tr style="height: 29.7969px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%; height: 29.7969px;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%; height: 29.7969px;">URL</th></tr></thead><tbody><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/devolucion\_mercaderia/mail</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/devolucion\_mercaderia/mail</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/devolucion\_mercaderia/mail</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742837",
    "usuario":"72607245",
    "email":"dchipanalapa@gmail.com"
}
```

---

### 📤 Response

```json
{
  "success":true,
  "message": "Clave enviada revise su correo."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Devolucion de Mercaderia → Codigo de verificacion.**
    - **Evento:** Cuando presiona el boton "Solicitar codigo de verificacion".
    - **Uso:** Se envia el codigo al Correo.

---

### 🖼️ Pantallazos

- **Devolucion de Mercaderia:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/XQVimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/XQVimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/devolucion_mercaderia/sms

##### Ejecuta el flujo de devolucion de mercaderia.

### Detalles técnicos

- **Endpoint: /api/devolucion\_mercaderia/sms**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/devolucion_mercaderia/sms
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/devolucion\_mercaderia/sms</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/devolucion\_mercaderia/sms</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/devolucion\_mercaderia/sms</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742837",
    "telefono":"922749652",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
  "success":true,
  "message": "Clave enviada revise su teléfono."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Devolucion de Mercaderia → Codigo de Verificacion**
    - **Evento:** Cuando presiona el boton "Solicitar codigo de verificacion".
    - **Uso:** Se envia el codigo al Celular.

---

### 🖼️ Pantallazos

- **Devolucion de Mercaderia:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/Z8Kimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/Z8Kimage.png)

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/devolucion_mercaderia/validar

##### Ejecuta el flujo de devolucion de mercaderia.

### Detalles técnicos

- **Endpoint: /api/devolucion\_mercaderia/validar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/devolucion_mercaderia/validar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/devolucion\_mercaderia/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/devolucion\_mercaderia/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/devolucion\_mercaderia/validar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742837",
    "telefono":"922749652",
    "clave":"JM3PTW",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Clave confirmada."
}
```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Devolucion de Mercaderia → Codigo de verificacion**
    - **Evento:** Al terminar de digitar el codigo de verificacion.
    - **Uso:** Verifica si la clave ingresada en correcta.

---

### 🖼️ Pantallazos

- **Devolucion de Mercaderia:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/l1Bimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/l1Bimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/devolucion_mercaderia/guardar

##### Ejecuta el flujo de devolucion de mercaderia.

### Detalles técnicos

- **Endpoint: /api/devolucion\_mercaderia/guardar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/devolucion_mercaderia/guardar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/devolucion\_mercaderia/guardar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/devolucion\_mercaderia/guardar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/devolucion\_mercaderia/guardar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742837",
    "telefono":"922749652",
    "clave":"JM3PTW",
    "destino":"",
    "destinatario":"72607245",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
  "success":true,
  "os_id":82742934,
  "osidGuiaElect":"50014062",
  "codigo":"KT9T",
  "message": "La devolución de mercadería se generó de manera exitosa.\nLos nuevos datos de su envio son:\n N° de Orden: 50014062\n código: KT9T"
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Devolucion de Mercaderia → Devolucion de Mercaderia**
    - **Evento:** Cuando se presiona el boton de "Confirmar".
    - **Uso:** Guarda el registro.

---

### 🖼️ Pantallazos

- **Devolucion de Mercaderia:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/KNYimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/KNYimage.png)

### 📂 Archivos Flutter relacionados

- - lib/src\\utils\\overskull.dart

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# Módulo Retencion de carga

# /api/retencion_carga/orden/buscar

##### Ejecuta el flujo de retencion de carga.

### Detalles técnicos

- **Endpoint:**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/retencion_carga/orden/buscar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga/orden/buscar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga/orden/buscar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga/orden/buscar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "codigo":"WJNN",
    "guia":"50013967",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Número de orden verificada",
    "data": {
        "tipo": "retencion"
    }
}
```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Retencion de Entrega → Vista Login**
    - **Evento:** Al presionar el boton "Siguiente".
    - **Uso:** Verifica el numero de orden.

---

### 🖼️ Pantallazos

- **Retencion de Entrega:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/37rimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/37rimage.png)

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/retencion_carga/orden/validar

#####   


### Detalles técnicos

- **Endpoint: /api/retencion\_carga/orden/validar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/retencion_carga/orden/validar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga/orden/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga/orden/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga/orden/validar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "codigo":"WJNN",
    "destinatario":{
        "documento":"72607245",
        "telefono":"922749652"
    },
    "destino":{
        "ter_id":"730"
    },
    "fecha":"2026-06-15",
    "guia":"50013967",
    "origen":{
        "ter_id":"45"
    },
    "remitente":{
        "documento":"72607245",
        "telefono":"922749652"
    },
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Remitente verificado",
    "data": {
        "ose_id": 82742839,
        "remitente": "72607245",
        "remitente_nombre": "DAISY",
        "remitente_appaterno": "CHIPANA",
        "remitente_apmaterno": "LAPA",
        "remitente_nombre_completo": "DAISY CHIPANA LAPA",
        "destinatario": "72607245",
        "origen": 45,
        "destino": 730,
        "telefono_remitente": 922749652,
        "destino_direccion": "Dirección (Web) *",
        "fecha": "2026-06-15 09:58:53"
    }
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Retencion de Entrega → Valida los datos del ticket shalom**
    - **Evento:** Al presionar el boton "Continuar".
    - **Uso:** Verifica el remitente.

---

### 🖼️ Pantallazos

- **Retencion de Entrega:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/w6yimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/w6yimage.png)

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/retencion_carga/mail

##### Ejecuta el flujo de retencion de carga.

### Detalles técnicos

- **Endpoint: /api/retencion\_carga/mail**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/retencion_carga/mail
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga/mail</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga/mail</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga/mail</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742839",
    "usuario":"72607245",
    "email":"dchipanalapa@gmail.com"
}
```

---

### 📤 Response

```json
{
  "success":true,
  "message":"Clave enviada revise su correo."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Retencion de Entrega → Codigo de verificacion**
    - **Evento:** Cuando presiona el boton "Solicitar codigo de verificacion".
    - **Uso:** Se envia el codigo al Celular.

---

### 🖼️ Pantallazos

- **Retencion de Entrega:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/wzximage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/wzximage.png)

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/retencion_carga/sms

##### Ejecuta el flujo de retencion de carga.

### Detalles técnicos

- **Endpoint: /api/retencion\_carga/sms**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/retencion_carga/sms
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 135.359px; width: 100%;"><thead class="text-left"><tr style="height: 29.7969px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%; height: 29.7969px;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%; height: 29.7969px;">URL</th></tr></thead><tbody><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/retencion\_carga/sms</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/retencion\_carga/sms</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/retencion\_carga/sms</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742839",
    "telefono":"922749652",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
  "success":true,
  "message":"Clave enviada revise su teléfono."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Retencion de Entrega → Solicitar codigo de verificacion**
    - **Evento:** Cuando presiona el boton "Solicitar codigo de verificacion".
    - **Uso:** Se envia el codigo al Celular.

---

### 🖼️ Pantallazos

- **Retencion de Entrega:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/tDnimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/tDnimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/retencion_carga/validar

#####   


### Detalles técnicos

- **Endpoint: /api/retencion\_carga/validar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/retencion_carga/validar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga/validar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742839",
    "telefono":"922749652",
    "clave":"CNH7TD",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
  "success":true,
  "message":"Clave confirmada."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Retencion de Entrega → Codigo de verificacion**
    - **Evento:** Al presionar el boton "Confirmar".
    - **Uso:** Verifica la clave.

---

### 🖼️ Pantallazos

- **Retencion de Entrega:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/cfjimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/cfjimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# /api/retencion_carga/guardar

##### Ejecuta el flujo de retencion de carga.

### Detalles técnicos

- **Endpoint: /api/retencion\_carga/guardar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/retencion_carga/guardar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga/guardar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga/guardar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga/guardar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742839",
    "telefono":"922749652",
    "clave":"CNH7TD",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "La retención de entrega se generó de manera exitosa."
}
```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Retencion de Entrega → Retencion de entrega**
    - **Evento:** Al presionar el boton "Confirmar".
    - **Uso:** Registra la retencion.

---

### 🖼️ Pantallazos

- **Retencion de Entrega:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/SETimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/SETimage.png)

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- - Usa Authorization Bearer generado por Internet.httpPost/httpGet.

# Módulo Liberacion de carga

# /api/retencion_carga_liberar/orden/buscar

##### Ejecuta el flujo de liberacion de carga retenida.

### Detalles técnicos

- **Endpoint: /api/retencion\_carga\_liberar/orden/buscar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/retencion_carga_liberar/orden/buscar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga\_liberar/orden/buscar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga\_liberar/orden/buscar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga\_liberar/orden/buscar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "codigo":"WJNN",
    "guia":"50013967",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Número de orden verificada"
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Retencion de Entrega → Liberación de carga**
    - **Evento:** Al presionar el boton "Buscar".
    - **Uso:** Verifica el numero de orden.

---

### 🖼️ Pantallazos

- **Liberación de carga:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/zCLimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/zCLimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /api/retencion_carga_liberar/orden/validar

##### Ejecuta el flujo de liberacion de carga retenida.

### Detalles técnicos

- **Endpoint: /api/retencion\_carga\_liberar/orden/validar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/retencion_carga_liberar/orden/validar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 135.359px; width: 100%;"><thead class="text-left"><tr style="height: 29.7969px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%; height: 29.7969px;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%; height: 29.7969px;">URL</th></tr></thead><tbody><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/retencion\_carga\_liberar/orden/validar</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/retencion\_carga\_liberar/orden/validar</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/retencion\_carga\_liberar/orden/validar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "codigo":"WJNN",
    "destinatario":{
        "documento":"72607245",
        "telefono":"922749652"
    },
    "destino":{
        "ter_id":"730"
    },
    "fecha":"2026-06-15",
    "guia":"50013967",
    "origen":{
        "ter_id":"45"
    },
    "remitente":{
        "documento":"72607245",
        "telefono":"922749652"
    },
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Remitente verificado",
    "data": {
        "ose_id": 82742839,
        "remitente": "72607245",
        "remitente_nombre": "DAISY",
        "remitente_appaterno": "CHIPANA",
        "remitente_apmaterno": "LAPA",
        "remitente_nombre_completo": "DAISY CHIPANA LAPA",
        "destinatario": "72607245",
        "origen": 45,
        "destino": 730,
        "telefono_remitente": 922749652,
        "fecha": "2026-06-15 09:58:53"
    }
}
```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Retencion de Entrega → Valida los datos del ticket shalom**
    - **Evento:** Al presionar el boton "Confirmar".
    - **Uso:** Verifica el remitente.

---

### 🖼️ Pantallazos

- **Liberación de carga:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/VXgimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/VXgimage.png)

### 📂 Archivos Flutter relacionados

- -

---

### 🗒️ Notas adicionales

- -

# /api/retencion_carga_liberar/mail

##### Ejecuta el flujo de liberacion de carga retenida.

### Detalles técnicos

- **Endpoint: /api/retencion\_carga\_liberar/mail**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/retencion_carga_liberar/mail
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga\_liberar/mail</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga\_liberar/mail</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga\_liberar/mail</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742839",
    "usuario":"72607245",
    "email":"dchipanalapa@gmail.com"
}
```

---

### 📤 Response

```json
{
  "success":true,
  "message":"Clave enviada revise su correo."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Retencion de Entrega → Codigo de verificacion**
    - **Evento:** Cuando presiona el boton "Solicitar codigo de verificacion".
    - **Uso:** Se envia el codigo al Correo.

---

### 🖼️ Pantallazos

- **Liberación de carga:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/BZmimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/BZmimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /api/retencion_carga_liberar/sms

##### Ejecuta el flujo de liberacion de carga retenida.

### Detalles técnicos

- **Endpoint: /api/retencion\_carga\_liberar/sms**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/retencion_carga_liberar/sms
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga\_liberar/sms</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga\_liberar/sms</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga\_liberar/sms</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742839",
    "telefono":"922749652",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
  "success":true,
  "message":"Clave enviada revise su teléfono."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Retencion de Entrega → Codigo de verificacion**
    - **Evento:** Cuando presiona el boton "Solicitar codigo de verificacion".
    - **Uso:** Se envia el codigo al Celular.

---

### 🖼️ Pantallazos

- **Liberación de carga:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/7Pdimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/7Pdimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /api/retencion_carga_liberar/validar

##### Ejecuta el flujo de liberacion de carga retenida.

### Detalles técnicos

- **Endpoint: /api/retencion\_carga\_liberar/validar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/retencion_carga_liberar/validar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga\_liberar/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga\_liberar/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga\_liberar/validar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742839",
    "telefono":"922749652",
    "clave":"KNTCDM",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
  "success":true,
  "message":"Tu envío se liberó de manera exitosa."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Retencion de Entrega → Codigo de verificacion**
    - **Evento:** Al presionar el boton "Continuar".
    - **Uso:** Valida el codigo ingresado.

---

### 🖼️ Pantallazos

- **Liberación de carga:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/GTdimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/GTdimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /api/retencion_carga_liberar/guardar

##### Ejecuta el flujo de liberacion de carga retenida.

### Detalles técnicos

- **Endpoint: /api/retencion\_carga\_liberar/guardar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/retencion_carga_liberar/guardar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga\_liberar/guardar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga\_liberar/guardar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/retencion\_carga\_liberar/guardar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742839",
    "telefono":"922749652",
    "clave":"KNTCDM",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "La liberación de carga se generó de manera exitosa."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Retencion de Entrega → Codigo de verificacion**
    - **Evento:** Al presionar el boton "SI".
    - **Uso:** Registra la liberacion de carga.

---

### 🖼️ Pantallazos

- **Liberación de carga:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/vkvimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/vkvimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# Módulo Reparto a domicilio

# /api/self-management/reparto/orden/buscar

##### Ejecuta operaciones de reparto a domicilio.

### Detalles técnicos

- **Endpoint: /api/self-management/reparto/orden/buscar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/self-management/reparto/orden/buscar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/orden/buscar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/orden/buscar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/orden/buscar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "codigo":"CTC3",
    "guia":"50014095",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Número de orden verificada"
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Reparto a Domicilio → Proceso de Reparto a domicilio**
    - **Evento:** Al presionar el boton "buscar".
    - **Uso:** Verifica el numero de orden.

---

### 🖼️ Pantallazos

- **Reparto a Domicilio:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/sucimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/sucimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /api/self-management/reparto/orden/validar

#####   


### Detalles técnicos

- **Endpoint: /api/self-management/reparto/orden/validar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/self-management/reparto/orden/validar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/orden/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/orden/validar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/orden/validar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "codigo":"CTC3",
    "destinatario":{
        "documento":"72607245",
        "telefono":"922749652"
    },
    "destino":{
        "ter_id":"7"
    },
    "fecha":"2026-06-19",
    "guia":"50014095",
    "origen":{
        "ter_id":"45"
    },
    "remitente":{
        "documento":"72607245",
        "telefono":"922749652"
    },
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Remitente verificado",
    "data": {
        "ose_id": 82742967,
        "remitente": "72607245",
        "remitente_nombre": "DAISY",
        "remitente_appaterno": "CHIPANA",
        "remitente_apmaterno": "LAPA",
        "remitente_nombre_completo": "DAISY CHIPANA LAPA",
        "destinatario": "72607245",
        "origen": 45,
        "destino": 7,
        "telefono_remitente": 922749652,
        "fecha": "2026-06-19 09:31:12",
        "dep_id": 4,
        "prov_id": 1,
        "dist_id": 1,
        "departamento": "AREQUIPA",
        "provincia": "AREQUIPA",
        "distrito": "AREQUIPA"
    }
}
```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Reparto a Domicilio → Valida los datos del ticket Shalom**
    - **Evento:** Al presionar el boton "Continuar".
    - **Uso:** Verifica el remitente.

---

### 🖼️ Pantallazos

- **Reparto a Domicilio:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/gyJimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/gyJimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /api/self-management/reparto/validate-security-key

##### Ejecuta operaciones de reparto a domicilio.

### Detalles técnicos

- **Endpoint: /api/self-management/reparto/validate-security-key**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/self-management/reparto/validate-security-key
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/validate-security-key</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/validate-security-key</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/validate-security-key</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "guia_number": "50014095",
    "security_key": "7896"
}
```

---

### 📤 Response

```json
{
    "valor": true,
    "msn": "Clave de seguridad correcta"
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Reparto a Domicilio → Clave de seguridad**
    - **Evento:** Al presionar el boton "Confirmar Clave".
    - **Uso:** Valida la clave de seguridad.

---

### 🖼️ Pantallazos

- **Reparto a Domicilio:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/kwJimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/kwJimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /api/self-management/reparto/mail

##### Ejecuta operaciones de reparto a domicilio.

### Detalles técnicos

- **Endpoint: /api/self-management/reparto/mail**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/self-management/reparto/mail
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/mail</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/mail</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/mail</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742967",
    "usuario":"72607245",
    "email":"dchipanalapa@gmail.com"
}
```

---

### 📤 Response

```json
{
  "success":true,
  "message":"Clave enviada revise su correo."
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Reparto a Domicilio → Codigo de verificacion**
    - **Evento:** Cuando presiona el boton "Solicitar codigo de verificacion".
    - **Uso:** Se envia el codigo al Correo.

---

### 🖼️ Pantallazos

- **Reparto a Domicilio:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/AGHimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/AGHimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /api/self-management/reparto/sms

##### Ejecuta operaciones de reparto a domicilio.

### Detalles técnicos

- **Endpoint: /api/self-management/reparto/sms**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/self-management/reparto/sms
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/sms</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/sms</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/sms</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742967",
    "telefono":"922749652",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
  "success":true,
  "message":"Clave enviada revise su teléfono."
}
```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Reparto a Domicilio → Codigo de verificacion**
    - **Evento:** Cuando presiona el boton "Solicitar codigo de verificacion".
    - **Uso:** Se envia el codigo al Celular.

---

### 🖼️ Pantallazos

- **Reparto a Domicilio:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/6Bnimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/6Bnimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /api/self-management/reparto/validar

##### Ejecuta operaciones de reparto a domicilio.

### Detalles técnicos

- **Endpoint: /api/self-management/reparto/validar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/self-management/reparto/validar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 135.359px; width: 100%;"><thead class="text-left"><tr style="height: 29.7969px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%; height: 29.7969px;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%; height: 29.7969px;">URL</th></tr></thead><tbody><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/self-management/reparto/validar</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/self-management/reparto/validar</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/self-management/reparto/validar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "ose_id":"82742967",
    "clave":"J3K37J",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Clave confirmada."
}
```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Reparto a Domicilio → Codigo de verificacion** 
    - **Evento:** Al presionar el boton "Continuar".
    - **Uso:** Valida si la clave es correcta.

---

### 🖼️ Pantallazos

- **Reparto a Domicilio:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/P0Gimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/P0Gimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /api/self-management/reparto/ubigeo/departamentos

#####   


### Detalles técnicos

- **Endpoint: /api/self-management/reparto/ubigeo/departamentos**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/self-management/reparto/ubigeo/departamentos
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 135.359px; width: 100%;"><thead class="text-left"><tr style="height: 29.7969px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%; height: 29.7969px;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%; height: 29.7969px;">URL</th></tr></thead><tbody><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/self-management/reparto/ubigeo/departamentos</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/self-management/reparto/ubigeo/departamentos</td></tr><tr style="height: 35.1875px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.1875px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.1875px;">https://envia.shalom.pe/api/self-management/reparto/ubigeo/departamentos</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```
{}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Lista de departamentos",
    "data": [
        {
            "id": 1,
            "name": "AMAZONAS"
        },
        {
            "id": 2,
            "name": "ANCASH"
        },
        {
            "id": 3,
            "name": "APURIMAC"
        },
        {
            "id": 4,
            "name": "AREQUIPA"
        },
        {
            "id": 5,
            "name": "AYACUCHO"
        },
        {
            "id": 6,
            "name": "CAJAMARCA"
        },
        {
            "id": 7,
            "name": "CALLAO"
        },
        {
            "id": 8,
            "name": "CUSCO"
        },
        {
            "id": 9,
            "name": "HUANCAVELICA"
        },
        {
            "id": 10,
            "name": "HUANUCO"
        },
        {
            "id": 11,
            "name": "ICA"
        },
        {
            "id": 12,
            "name": "JUNIN"
        },
        {
            "id": 13,
            "name": "LA LIBERTAD"
        },
        {
            "id": 14,
            "name": "LAMBAYEQUE"
        },
        {
            "id": 15,
            "name": "LIMA"
        },
        {
            "id": 16,
            "name": "LORETO"
        },
        {
            "id": 17,
            "name": "MADRE DE DIOS"
        },
        {
            "id": 18,
            "name": "MOQUEGUA"
        },
        {
            "id": 19,
            "name": "PASCO"
        },
        {
            "id": 20,
            "name": "PIURA"
        },
        {
            "id": 21,
            "name": "PUNO"
        },
        {
            "id": 22,
            "name": "SAN MARTIN"
        },
        {
            "id": 23,
            "name": "TACNA"
        },
        {
            "id": 24,
            "name": "TUMBES"
        },
        {
            "id": 25,
            "name": "UCAYALI"
        }
    ]
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Reparto a Domicilio →** 
    - **Evento:**
    - **Uso:**

---

### 🖼️ Pantallazos

- **Reparto a Domicilio:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/wV1image.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/wV1image.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- - Se ha deshabilitado el combo de "departamentos".

# /api/self-management/reparto/ubigeo/provincias

##### Ejecuta operaciones de reparto a domicilio.

### Detalles técnicos

- **Endpoint: /api/self-management/reparto/ubigeo/provincias**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/self-management/reparto/ubigeo/provincias
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/ubigeo/provincias</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/ubigeo/provincias</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/ubigeo/provincias</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "dep_id":"4"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Lista de provincias",
    "data": [
        {
            "id": 1,
            "name": "AREQUIPA"
        },
        {
            "id": 2,
            "name": "CAMANA"
        },
        {
            "id": 3,
            "name": "CARAVELI"
        },
        {
            "id": 4,
            "name": "CASTILLA"
        },
        {
            "id": 5,
            "name": "CAYLLOMA"
        },
        {
            "id": 6,
            "name": "CONDESUYOS"
        },
        {
            "id": 7,
            "name": "ISLAY"
        },
        {
            "id": 8,
            "name": "LA UNION"
        }
    ]
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Reparto a Domicilio →** 
    - **Evento:**
    - **Uso:**

---

### 🖼️ Pantallazos

- **Reparto a Domicilio:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/bKVimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/bKVimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- - Se ha deshabilitado el combo "Provincias".

# /api/self-management/reparto/ubigeo/distritos

#####   


### Detalles técnicos

- **Endpoint: /api/self-management/reparto/ubigeo/distritos**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/self-management/reparto/ubigeo/distritos
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/ubigeo/distritos</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/ubigeo/distritos</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/ubigeo/distritos</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "dep_id":"4",
    "prov_id":"1"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Lista de distritos",
    "data": [
        {
            "id": 1,
            "name": "AREQUIPA",
            "ubi_id": 40101
        },
        {
            "id": 2,
            "name": "ALTO SELVA ALEGRE",
            "ubi_id": 40102
        },
        {
            "id": 3,
            "name": "CAYMA",
            "ubi_id": 40103
        },
        {
            "id": 4,
            "name": "CERRO COLORADO",
            "ubi_id": 40104
        },
        {
            "id": 5,
            "name": "CHARACATO",
            "ubi_id": 40105
        },
        {
            "id": 6,
            "name": "CHIGUATA",
            "ubi_id": 40106
        },
        {
            "id": 7,
            "name": "JACOBO HUNTER",
            "ubi_id": 40107
        },
        {
            "id": 8,
            "name": "LA JOYA",
            "ubi_id": 40108
        },
        {
            "id": 9,
            "name": "MARIANO MELGAR",
            "ubi_id": 40109
        },
        {
            "id": 10,
            "name": "MIRAFLORES",
            "ubi_id": 40110
        },
        {
            "id": 11,
            "name": "MOLLEBAYA",
            "ubi_id": 40111
        },
        {
            "id": 12,
            "name": "PAUCARPATA",
            "ubi_id": 40112
        },
        {
            "id": 13,
            "name": "POCSI",
            "ubi_id": 40113
        },
        {
            "id": 14,
            "name": "POLOBAYA",
            "ubi_id": 40114
        },
        {
            "id": 15,
            "name": "QUEQUENA",
            "ubi_id": 40115
        },
        {
            "id": 16,
            "name": "SABANDIA",
            "ubi_id": 40116
        },
        {
            "id": 17,
            "name": "SACHACA",
            "ubi_id": 40117
        },
        {
            "id": 18,
            "name": "SAN JUAN DE SIGUAS",
            "ubi_id": 40118
        },
        {
            "id": 19,
            "name": "SAN JUAN DE TARUCANI",
            "ubi_id": 40119
        },
        {
            "id": 20,
            "name": "SANTA ISABEL DE SIGU",
            "ubi_id": 40120
        },
        {
            "id": 21,
            "name": "SANTA RITA DE SIGUAS",
            "ubi_id": 40121
        },
        {
            "id": 22,
            "name": "SOCABAYA",
            "ubi_id": 40122
        },
        {
            "id": 23,
            "name": "TIABAYA",
            "ubi_id": 40123
        },
        {
            "id": 24,
            "name": "UCHUMAYO",
            "ubi_id": 40124
        },
        {
            "id": 25,
            "name": "VITOR",
            "ubi_id": 40125
        },
        {
            "id": 26,
            "name": "YANAHUARA",
            "ubi_id": 40126
        },
        {
            "id": 27,
            "name": "YARABAMBA",
            "ubi_id": 40127
        },
        {
            "id": 28,
            "name": "YURA",
            "ubi_id": 40128
        },
        {
            "id": 29,
            "name": "JOSE LUIS BUSTAMENTE",
            "ubi_id": 40129
        }
    ]
}

```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Reparto a Domicilio → A donde lo llevamos**
    - **Evento:** Al ingresar a la vista "A donde lo llevamos".
    - **Uso:** Lista los distritos segun e id de provincia y departamento.

---

### 🖼️ Pantallazos

- **Reparto a Domicilio:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/9XEimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/9XEimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /api/self-management/reparto/tarifa

##### Ejecuta operaciones de reparto a domicilio.

### Detalles técnicos

- **Endpoint: /api/self-management/reparto/tarifa**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/self-management/reparto/tarifa
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/tarifa</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/tarifa</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/tarifa</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "dep_id":"4",
    "prov_id":"1",
    "dist_id":"26",
    "ose_id":"82742967"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Tarifa encontrada",
    "data": {
        "rate": 8,
        "label": "PAQUETE XXS"
    }
}
```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Reparto a Domicilio → Confirmar tu dirección**
    - **Evento:** Al presionar el boton "Continuar".
    - **Uso:** Devuelve la tarifa.

---

### 🖼️ Pantallazos

- **Reparto a Domicilio:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/LFvimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/LFvimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -

# /self-management/reparto/guardar

#####   


### Detalles técnicos

- **Endpoint: /api/self-management/reparto/guardar**
- **Método:** `POST`

### 🌐 Dominios

#### QA

```
https://qapagalo.shalom.pe/api/self-management/reparto/guardar
```

#### Producción

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-etiqueta-url-princip"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 113px; width: 100%;"><thead class="text-left"><tr><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 23.5939%;">Etiqueta</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 76.3823%;">URL</th></tr></thead><tbody><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Principal</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/guardar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Región 2</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/guardar</td></tr><tr><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 23.5939%; height: 35.2px;">Failover</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 76.3823%; height: 35.2px;">https://envia.shalom.pe/api/self-management/reparto/guardar</td></tr></tbody></table>

</div>---

### 📋 Headers

<div class="overflow-x-auto w-full px-2 mb-6" id="bkmrk-clave-valor-requerid"><table class="min-w-full border-collapse text-sm leading-[1.7] whitespace-normal" style="height: 122.338px; width: 100%;"><thead class="text-left"><tr style="height: 29.6px;"><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Clave</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Valor</th><th class="text-text-100 border-b-0.5 border-[hsl(var(--border-300)/0.6)] py-2 pr-4 align-top font-bold" scope="col" style="width: 33.3651%; height: 29.6px;">Requerido</th></tr></thead><tbody><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Content-Type`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">application/x-www-form-urlencoded</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">`Authorization`</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Bearer &lt;token&gt;</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Sí</td></tr><tr style="height: 30.9125px;"><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">Api-Key-App-Rastrea</td><td style="width: 33.3651%; height: 30.9125px;">N/A</td><td class="border-b-0.5 border-[hsl(var(--border-300)/0.3)] py-2 pr-4 align-top" style="width: 33.3651%; height: 30.9125px;">No</td></tr><tr><td style="width: 33.3651%;">Accept</td><td style="width: 33.3651%;">*/*</td><td style="width: 33.3651%;">Sí</td></tr></tbody></table>

</div>### 📩 Request

```json
{
    "address":"Yanahuara Mz.G - Lt.2, Jacobo Hunter, Arequipa, Nro. 2, Dpto. 1, Ref. Estación Repsol ","dep_id":"4",
    "prov_id":"1",
    "dist_id":"26",
    "ose_id":"82742967",
    "rate":"8",
    "label_rate":"PAQUETE XXS",
    "clave":"J3K37J",
    "usuario":"72607245"
}
```

---

### 📤 Response

```json
{
    "success": false,
    "message": "Tu solicitud fue registrada con éxito. Tienes 24 horas para realizar el pago, de lo contrario la solicitud será anulada."
}
```

---

### 📍 Contexto funcional (Dónde se usa)

1. **Módulo Reparto a Domicilio → Terminos y condiciones**
    - **Evento:** Al presionar el boton "Continuar".
    - **Uso:** Registra el reparto a domicilio.

---

### 🖼️ Pantallazos

- **Reparto a Domicilio:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/scaled-1680-/xykimage.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-06/xykimage.png)

### 📂 Archivos Flutter relacionados

- - -

---

### 🗒️ Notas adicionales

- -