# Embarques

# Control/carguero/listar

### Detalles técnicos

- **Dominio: https://qaservicesapp.shalomcontrol.com**
- **Endpoint: /control/carguero/listar**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "placa": 234, 
    "terminal": 4, 
    "pagina": 1
}
```

---

### 📤 Response

```json

{
    "success": true,
    "message": "Lista de cargueros",
    "data": [
        {
            "fecha": "2025-10-30 05:24:00",
            "cap_id": 713745,
            "chofer1": "45804369",
            "chofer2": "47949345",
            "ruta": "NOR.IDA-HUACHIPA CO-BAGUA",
            "origen": "HPACO - CIX - BAG - PRU",
            "destino": "CIX - BAG - PRU - CHH",
            "placa1": "CAZ-797",
            "placa2": "CAR-1234",
            "cerrado": "0",
            "qr_generado": false,
            "estado": "pendiente"
        },
        {
            "fecha": "2025-10-29 18:56:00",
            "cap_id": 713433,
            "chofer1": "47949345",
            "chofer2": null,
            "ruta": "IDA-MEXICO-HUACHIPA CO 23:00 PM",
            "origen": "LIM.M",
            "destino": "HPACO",
            "placa1": "CAZ-797",
            "placa2": "CAR-1234",
            "cerrado": "0",
            "qr_generado": false,
            "estado": "pendiente"
        },
    ]
}
```

---

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

1. **Módulo Embarques → Vista Embarques principal**
    - **Evento:** al digitar un numero de carguero y presionar el boton "Buscar".
    - **Uso:** Lista los cargueros

---

### 🖼️ Pantallazos

- **Modulo Embarques:**
- [![image_3.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/image-3.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/login.png)

### 📂 Archivos Flutter relacionados

- lib/src/Pages/Embarque/Screens/carguero\_view.dart

---

### 🗒️ Notas adicionales

**DOCUMENTACION DEL SERVICIO:** [https://shalom-documentation.shalomcontrol.com/books/doc-servicios-app-shalom-control/page/controlcarguerolistar-indexcooler](https://shalom-documentation.shalomcontrol.com/books/doc-servicios-app-shalom-control/page/controlcarguerolistar-12-indexcooler)

# control/carguero/obtener

### Detalles técnicos

- **Dominio: https://qaservicesapp.shalomcontrol.com**
- **Endpoint: control/carguero/obtener**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "cap_id": 714854
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Lista de cargueros",
    "data": {
        "fecha": "2025-10-31 05:27:09",
        "cap_id": 714854,
        "chofer1": "09942740",
        "chofer2": "46979414",
        "ruta": "SUR.RET-CHINCHA-HUACHIPA CO",
        "placa1": "BSK-803",
        "placa2": "",
        "cerrado": "0",
        "cantidad": 0,
        "suma": 0,
        "escalas": [
            "23 PROLONG LUIS MASSARO CO",
            "45 LAS CONCHITAS",
            "365 HUACHIPA CO"
        ],
        "origenes": [
            "23 PROLONG LUIS MASSARO CO",
            "45 LAS CONCHITAS"
        ],
        "destinos": [
            "45 LAS CONCHITAS",
            "365 HUACHIPA CO"
        ]
    }
}
```

---

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

1. **Módulo Embarques → Vista Embarques**
    - **Evento:** Al presionar el boton "Entrar"
    - **Uso:** Muestra el detalle del carguero por su cap\_id.

---

### 🖼️ Pantallazos

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

### 📂 Archivos Flutter relacionados

- lib/src/Pages/Embarque/Screens/carguero\_view.dart

---

### 🗒️ Notas adicionales

- -

**DOCUMENTACION DEL SERVICIO:** [https://shalom-documentation.shalomcontrol.com/books/doc-servicios-app-shalom-control/page/controlcargueroobtener-show](https://shalom-documentation.shalomcontrol.com/books/doc-servicios-app-shalom-control/page/controlcargueroobtener-show)

# control/embarque/cooler/listar (2)

### Detalles técnicos

- **Dominio: https://qaservicesapp.shalomcontrol.com**
- **Endpoint: control/embarque/cooler/listar**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "cooler": "BIN165", 
    "usuario": 75844645, 
    "terminal": 4, 
    "cap_id": 714854, 
    "tipo_cierre": "APP"
}
```

---

### 📤 Response

```json
{
    "success": false,
    "message": "Cooler inválido. Debe contener la palabra BINS o COOLER"
}
```

---

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

1. **Módulo -Embarques → Vista Embarques**
    - **Evento: Al presionar el boton "Buscar" y escanear el QR**
    - **Uso:** Obtiene informacion del QR

---

### 🖼️ Pantallazos

- **Embarques:**
    
    [![image_4.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/image-4.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/login.png)

### 📂 Archivos Flutter relacionados

- lib/src/Pages/Embarque/Logic/embarque\_logic.dart

---

### 🗒️ Notas adicionales

**DOCUMENTACION DEL SERVICIO:** [https://shalom-documentation.shalomcontrol.com/books/doc-servicios-app-shalom-control/page/controlcarguerolistar-indexcooler](https://shalom-documentation.shalomcontrol.com/books/doc-servicios-app-shalom-control/page/controlcarguerolistar-12-indexcooler)

# control/embarque/listar

### Detalles técnicos

- **Dominio: https://qaservicesapp.shalomcontrol.com**
- **Endpoint: control/embarque/listar**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "cap_id": 614936, 
    "guia": "", 
    "pagina": 1
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Lista de ordenes",
    "data": [
        {
            "fecha": "2025-11-06 13:11:40",
            "monto": "8.00",
            "guia": "50006020",
            "remitente": "Daisy Chipana Lapa",
            "destinatario": "72607245",
            "tipo_pago": "EF",
            "origen": "HUACHIPA CO",
            "destino": "BAMBAMARCA",
            "usuario": "72607245",
            "ose_id": 60555747,
            "estado_pago": "CR",
            "tipo_entrega": "ENTREGAR EN AGENCIA",
            "contenido": "1 Sobre",
            "ruta": "HPACO - BAM",
            "embarque_guia": "SIN GUIA",
            "cant_paq": 1,
            "cant_total": 1,
            "embarcados": [
                "1"
            ]
        },
        {
            "fecha": "2025-11-06 13:11:40",
            "monto": "8.00",
            "guia": "50006019",
            "remitente": "Daisy Chipana Lapa",
            "destinatario": "72607245",
            "tipo_pago": "EF",
            "origen": "HUACHIPA CO",
            "destino": "BAMBAMARCA",
            "usuario": "72607245",
            "ose_id": 60555746,
            "estado_pago": "CR",
            "tipo_entrega": "ENTREGAR EN AGENCIA",
            "contenido": "1 Sobre",
            "ruta": "HPACO - BAM",
            "embarque_guia": "SIN GUIA",
            "cant_paq": 1,
            "cant_total": 1,
            "embarcados": [
                "1"
            ]
        },
        {
            "fecha": "2025-11-06 13:11:40",
            "monto": "8.00",
            "guia": "50006018",
            "remitente": "Daisy Chipana Lapa",
            "destinatario": "72607245",
            "tipo_pago": "EF",
            "origen": "HUACHIPA CO",
            "destino": "BAMBAMARCA",
            "usuario": "72607245",
            "ose_id": 60555745,
            "estado_pago": "CR",
            "tipo_entrega": "ENTREGAR EN AGENCIA",
            "contenido": "1 Sobre",
            "ruta": "HPACO - BAM",
            "embarque_guia": "SIN GUIA",
            "cant_paq": 1,
            "cant_total": 1,
            "embarcados": [
                "1"
            ]
        }
    ]
}
```

---

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

1. **Módulo Embarques → Vista Escanear**
    - **Evento:** Al presionar el boton "Buscar" y proceder a escanear el QR.
    - **Uso:** Devuelve informacion de la embaracion.

---

### 🖼️ Pantallazos

- **Embarques:**
    
    [![image_15.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-11/image-15.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/login.png)

### 📂 Archivos Flutter relacionados

- lib/src/Pages/Embarque/Screens/embarcados\_view.dart

---

### 🗒️ Notas adicionales

**DOCUMENTACION DEL SERVICIO:** [https://shalom-documentation.shalomcontrol.com/books/doc-servicios-app-shalom-control/page/controlembarquelistar-index](https://shalom-documentation.shalomcontrol.com/books/doc-servicios-app-shalom-control/page/controlembarquelistar-index)

# control/carguero/qr

### Detalles técnicos

- **Dominio: https://qaservicesapp.shalomcontrol.com**
- **Endpoint: control/carguero/qr**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "usuario": 75844645, 
    "terminal": 4, 
    "cap_id": 714854
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Qr Generado con éxito"
}

```

---

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

1. **Módulo Embarques → Vista Lista de Embarques**
    - **Evento:** Al presionar el boton "Generar QR"
    - **Uso:** Genera QR desde ela App.

---

### 🖼️ Pantallazos

- **Embarques:**
    
    [![image_6.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/image-6.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/login.png)

### 📂 Archivos Flutter relacionados

---

### 🗒️ Notas adicionales

- -

**DOCUMENTACION DEL SERVICIO:** [https://shalom-documentation.shalomcontrol.com/books/doc-servicios-app-shalom-control/page/controlcargueroqr-generateqrmassive](https://shalom-documentation.shalomcontrol.com/books/doc-servicios-app-shalom-control/page/controlcargueroqr-generateqrmassive)

# control/embarque/cerrar

### Detalles técnicos

- **Dominio: https://qaservicesapp.shalomcontrol.com**
- **Endpoint: control/embarque/cerrar**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "usuario": 75844645, 
    "terminal": 4, 
    "cap_id": 714854
}
```

---

### 📤 Response

```json
{
    "success": false,
    "message": "Carguero cerrado."
}
```

---

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

1. **Módulo Embarques → Vista Cerrar**
    - **Evento:** Al presionar el boton "Cerrar Carguero", luego de ingresar la contraseña.
    - **Uso:** Cierra el carguero.

---

### 🖼️ Pantallazos

- **Embarques:**
    
    [![image_7.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/image-7.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/login.png)

### 📂 Archivos Flutter relacionados

---

### 🗒️ Notas adicionales

- -

# control/embarque/validar

### Detalles técnicos

- **Dominio: https://qaservicesapp.shalomcontrol.com**
- **Endpoint: control/embarque/validar**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "ose_id": 60554855, 
    "usuario": 75844645, 
    "terminal": 4, 
    "cap_id": 719065, 
    "numero": 1, 
    "cantidad": 1, 
    "tipo_cierre": "APP"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Orden de servicio validada."
}

```

---

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

1. **Módulo Embarque → Vista Embarque**
    - **Evento:** Despues de escanear el QR
    - **Uso:** Valida si el QR escaneado es valido

---

### 🖼️ Pantallazos

- **Embarque:**
    
    [![image_4.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/image-4.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/login.png)

### 📂 Archivos Flutter relacionados

---

### 🗒️ Notas adicionales

- -

**DOCUMENTACION DEL SERVICIO:** [https://shalom-documentation.shalomcontrol.com/books/doc-servicios-app-shalom-control/page/controlembarquevalidar-validar](https://shalom-documentation.shalomcontrol.com/books/doc-servicios-app-shalom-control/page/controlembarquevalidar-validar)

# control/embarque/paquete

### Detalles técnicos

- **Dominio: https://qaservicesapp.shalomcontrol.com**
- **Endpoint: control/embarque/paquete**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "ose_id": 60555746, 
    "usuario": 75844645, 
    "terminal": 4, 
    "cap_id": 720171, 
    "numero": 1, 
    "cantidad": 1, 
    "tipo_cierre": "APP"
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Paquete 1/1 de la OS: 50006019 embarcado con éxito."
}

```

---

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

1. **Módulo Embarque → Vista Embarque**
    - **Evento:** Despues de escanear el QR
    - **Uso:** Devuelve informacion del ID si es valido.

---

### 🖼️ Pantallazos

- **Embarque:**
    
    [![image_4.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/image-4.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/login.png)

### 📂 Archivos Flutter relacionados

---

### 🗒️ Notas adicionales

- -

**DOCUMENTACION DEL SERVICIO:** [https://shalom-documentation.shalomcontrol.com/books/doc-servicios-app-shalom-control/page/controlembarquepaquete-storequantities](https://shalom-documentation.shalomcontrol.com/books/doc-servicios-app-shalom-control/page/controlembarquepaquete-storequantities)

# control/embarque/obtener

### Detalles técnicos

- **Dominio: https://qaservicesapp.shalomcontrol.com**
- **Endpoint: control/embarque/obtener**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "ose_id": 60555747, 
    "usuario": 75844645, 
    "terminal": 4, 
    "cap_id": 720171
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Orden encontrada",
    "data": {
        "fecha": "2025-11-06 13:11:40",
        "monto": "8.00",
        "guia": "50006020",
        "remitente": "Daisy Chipana Lapa",
        "destinatario": "72607245",
        "tipo_pago": "EF",
        "origen": "HUACHIPA CO",
        "destino": "BAMBAMARCA",
        "usuario": "daisy",
        "ose_id": 60555747,
        "estado_pago": "CR",
        "contenido": "1 Sobre",
        "ruta": "HPACO - BAM",
        "embarque_guia": "SIN GUIA",
        "cant_paq": 1,
        "cant_total": 1,
        "tipo_entrega": "ENTREGAR EN AGENCIA",
        "embarcados": [
            "1"
        ],
        "cap_id": 720171
    }
}

```

---

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

1. **Módulo Embarque → Vista Embarque**
    - **Evento:** Despues de escanear el QR, si es valido obtiene la informacion del ose\_id.
    - **Uso:** Obtiene informacion del ose\_id.

---

### 🖼️ Pantallazos

- **Embarque:**
    
    [![image_13.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-11/image-13.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/login.png)

### 📂 Archivos Flutter relacionados

---

### 🗒️ Notas adicionales

- -

**DOCUMENTACION DEL SERVICIO:** [https://shalom-documentation.shalomcontrol.com/books/doc-servicios-app-shalom-control/page/controlembarqueobtener-show](https://shalom-documentation.shalomcontrol.com/books/doc-servicios-app-shalom-control/page/controlembarqueobtener-show)

# control/embarque/eliminar

### Detalles técnicos

- **Dominio: https://qaservicesapp.shalomcontrol.com**
- **Endpoint: control/embarque/eliminar**
- **Método:** `POST`
- **Headers:**

### 📩 Request

```
{
    "ose_id": 60555745, 
    "usuario": 75844645, 
    "terminal": 4, 
    "cap_id": 614936
}
```

---

### 📤 Response

```json
{
    "success": true,
    "message": "Embarque eliminado"
}

```

---

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

1. **Módulo Embarque → Vista Embarque**
    - **Evento:** Al presionar el boton "eliminar"
    - **Uso:** Elimina el cap\_id

---

### 🖼️ Pantallazos

- **Embarque:**
    
    [![image_14.png](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-11/image-14.png)](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-10/login.png)

### 📂 Archivos Flutter relacionados

---

### 🗒️ Notas adicionales

- -