# Reparto

# api/get_route_by_terminal

### Detalles técnicos

- **Dominio: https://qarakiy.shalom.pe**
- **Endpoint: api/get\_route\_by\_terminal**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "terminal": 7, 
    "ose_id": "", 
    "name": ""
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Lista de rutas",
    "data": [
        {
            "id": 59049,
            "name": "PruebasMar2",
            "ter_id": 7,
            "distance": null,
            "duration": null,
            "confirmation": 1,
            "created_at": "2025-12-30 10:36:40",
            "quantity_services": 1,
            "in_programming": 0,
            "districts": "",
            "direction": "AV. PARRA 379",
            "terminal": "AREQUIPA AV PARRA 379 CO"
        },
        {
            "id": 59048,
            "name": "PruebasMar",
            "ter_id": 7,
            "distance": null,
            "duration": null,
            "confirmation": 1,
            "created_at": "2025-12-29 17:45:09",
            "quantity_services": 1,
            "in_programming": 0,
            "districts": "",
            "direction": "AV. PARRA 379",
            "terminal": "AREQUIPA AV PARRA 379 CO"
        },
        {
            "id": 59009,
            "name": "prueba2",
            "ter_id": 7,
            "distance": null,
            "duration": null,
            "confirmation": 0,
            "created_at": "2025-11-11 15:56:13",
            "quantity_services": 0,
            "in_programming": 0,
            "districts": "",
            "direction": "AV. PARRA 379",
            "terminal": "AREQUIPA AV PARRA 379 CO"
        },
        {
            "id": 59008,
            "name": "rutaPrueba",
            "ter_id": 7,
            "distance": null,
            "duration": null,
            "confirmation": 1,
            "created_at": "2025-11-11 15:11:51",
            "quantity_services": 1,
            "in_programming": 0,
            "districts": "",
            "direction": "AV. PARRA 379",
            "terminal": "AREQUIPA AV PARRA 379 CO"
        },
        {
            "id": 59007,
            "name": "nueva",
            "ter_id": 7,
            "distance": null,
            "duration": null,
            "confirmation": 1,
            "created_at": "2025-11-11 13:31:05",
            "quantity_services": 1,
            "in_programming": 0,
            "districts": "",
            "direction": "AV. PARRA 379",
            "terminal": "AREQUIPA AV PARRA 379 CO"
        },
    ]
}

```

---

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

1. **Módulo Crear-Rutas→ Crear-Rutas**
    - **Evento:** Al ingresar a la vista "Crear-Rutas" y por el boton buscar segun lo digitado.
    - **Uso:** Lista las rutas segun la terminal donde se encuentre el usuario.

---

### 🖼️ Pantallazos

- **Crear-Rutas:**
    
    [![image.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-01/scaled-1680-/Hu7image.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2026-01/Hu7image.png)

### 📂 Archivos Flutter relacionados

---

### 🗒️ Notas adicionales

- -

# api/get_service_order_by_route

### Detalles técnicos

- **Dominio: https://qarakiy.shalom.pe**
- **Endpoint: api/get\_service\_order\_by\_route**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "route_id": "59049"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "data": [
        {
            "ose_id": 60557725,
            "route": null,
            "service_type": "Reparto",
            "client_id": "48599026",
            "name": "DIANA PAOLA",
            "last_name": "QUISPE",
            "surname": "SOTO",
            "number": "50008001",
            "contact_name": "DIANA PAOLA QUISPE SOTO",
            "contact_phone": 946278725,
            "contact_email": "dianaqs026@gmail.com",
            "direction": "Boqueron, Boqueron, Padre Abad, Nro. 1, Dpto. 2, Ref. pruebasssss",
            "department": "LORETO",
            "province": "ALTO AMAZONAS",
            "district": "YURIMAGUAS",
            "distance": 0,
            "duration": 0,
            "is_scanned": 0,
            "is_assigned": 0,
            "packages": [
                1
            ],
            "quantity_scanned": 1,
            "quantity_detail": 1,
            "entregado": "1",
            "ose_guia_remitente": "null",
            "referral_guide": ""
        }
    ],
    "message": "Lista de servicios de reparto"
}

```

---

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

1. **Módulo Reparto → Vista Crear-Rutas**
    - **Evento:** al presionar a la opcion "Ingresar"
    - **Uso:** Lista las guias de la ruta seleccionada.

---

### 🖼️ Pantallazos

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

### 📂 Archivos Flutter relacionados

---

### 🗒️ Notas adicionales

- -

# api/route

### Detalles técnicos

- **Dominio: https://qarakiy.shalom.pe**
- **Endpoint: api/route**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "name": "NuevaRuta", 
    "ter_id": "7", 
    "user_created_id": "75844645"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Ruta creada con éxito.",
    "data": {
        "id": 59054
    }
}

```

---

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

1. **Módulo Reparto → Vista Crear-Rutas**
    - **Evento:** Al presionar el boton "Crear".
    - **Uso:** Crea una nueva ruta de la terminal seleccionada.

---

### 🖼️ Pantallazos

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

### 📂 Archivos Flutter relacionados

---

### 🗒️ Notas adicionales

- -

# api/delete_route

### Detalles técnicos

- **Dominio: https://qarakiy.shalom.pe**
- **Endpoint: api/delete\_route**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "id": "59055"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Ruta eliminada con éxito."
}

```

---

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

1. **Módulo Reparto→ Vista Crear-Rutas**
    - **Evento:** Al presionar el boton "Eliminar"
    - **Uso:** Elimina el item

---

### 🖼️ Pantallazos

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

### 📂 Archivos Flutter relacionados

---

### 🗒️ Notas adicionales

- -

# api/add_service_to_route

### Detalles técnicos

- **Dominio: https://qarakiy.shalom.pe**
- **Endpoint: api/add\_service\_to\_route**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "ose_id": 70922889, 
    "quantity": 1, 
    "number": 1, 
    "route_id": 59054
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Orden de servicio escaneada con éxito."
}
```

---

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

1. **Módulo Reparto → Vista Detalle-Ruta**
    - **Evento:** al presionar el boton "Buscar" se escanea el QR y trae los datos de la guia.
    - **Uso:** Agrega la guia en la ruta seleccionada.

---

### 🖼️ Pantallazos

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

### 📂 Archivos Flutter relacionados

---

### 🗒️ Notas adicionales

- -

# api/add_referral_guide_to_route

### Detalles técnicos

- **Dominio: https://qarakiy.shalom.pe**
- **Endpoint: api/add\_referral\_guide\_to\_route**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "ose_id": "70922890", 
    "number": 1, 
    "user": "75844645", 
    "route_id": 59009, 
    "referral_guide": "012-0012121"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Guia de remision remitente escaneada con éxito"
}

```

---

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

1. **Módulo Reparto → Vista Detalle-Reparto**
    - **Evento:** al escanear una guia (documento)
    - **Uso:** Devuleve la informacion de la orden de serviico

---

### 🖼️ Pantallazos

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

### 📂 Archivos Flutter relacionados

---

### 🗒️ Notas adicionales

- -

# api/delete_service_to_route

### Detalles técnicos

- **Dominio: https://qarakiy.shalom.pe**
- **Endpoint: api/delete\_service\_to\_route**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "ose_id": "70922889", 
    "route_id": "59054"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Orden de servicio eliminada con éxito."
}

```

---

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

1. **Módulo Reparto → Vista Detalle-Ruta**
    - **Evento:** Al presionar el boton "Eliminar"
    - **Uso:** quita de la lista de la ruta seleccionada.

---

### 🖼️ Pantallazos

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

### 📂 Archivos Flutter relacionados

---

### 🗒️ Notas adicionales

- -

# api/confirm_route

### Detalles técnicos

- **Dominio: https://qarakiy.shalom.pe**
- **Endpoint: api/confirm\_route**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "route_id": "59053"
}
```

---

### 📤 Response

```json
{
    "success": false,
    "message": "Ruta confirmada"
}

```

---

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

1. **Módulo Inicial → Vista Reparto**
    - **Evento:** Al presionar el boton "Cerrar"
    - **Uso:** Cierra la ruta

---

### 🖼️ Pantallazos

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

### 📂 Archivos Flutter relacionados

---

### 🗒️ Notas adicionales

- -

# api/open_route

### Detalles técnicos

- **Dominio: https://qarakiy.shalom.pe**
- **Endpoint: api/open\_route**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "route_id": "59053"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Ruta abierta"
}

```

---

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

1. **Módulo Reparto → Vista Detalle-Ruta**
    - **Evento:** Al presionar el boton "Abrir"
    - **Uso:** Abre la ruta.

---

### 🖼️ Pantallazos

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

### 📂 Archivos Flutter relacionados

---

### 🗒️ Notas adicionales

- -

# api/get_pending_to_return_by_route

### Detalles técnicos

- **Dominio: https://qarakiy.shalom.pe**
- **Endpoint: api/get\_pending\_to\_return\_by\_route**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "route_id": "59049"
}
```

---

### 📤 Response

```json
{
    "success": false,
    "message": "No tiene devoluciones pendientes"
}

```

---

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

1. **Módulo Reparto→ Vista Detalle de Ruta**
    - **Evento:** Al presionar el boton "Devoluciones"
    - **Uso:** Lista las devoluciones pendientes.

---

### 🖼️ Pantallazos

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

### 📂 Archivos Flutter relacionados

---

### 🗒️ Notas adicionales

- -

# api/store_return

### Detalles técnicos

- **Dominio: https://qarakiy.shalom.pe**
- **Endpoint: api/store\_return**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "ose_id": "70922889", 
    "quantity": 1, 
    "number": 1, 
    "user": "75844645"
}
```

---

### 📤 Response

```json
{
    "success": false,
    "message": "No se encontró la orden de servicio."
}

```

---

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

1. **Módulo Reparto → Vista Devolución**
    - **Evento:** al escanear un codigo QR
    - **Uso:** Obtiene la guia

---

### 🖼️ Pantallazos

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

### 📂 Archivos Flutter relacionados

---

### 🗒️ Notas adicionales

- -