# 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

- -