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
{
"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)
- 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:

📂 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
{
"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)
- Módulo Reparto → Vista Crear-Rutas
- Evento: al presionar a la opcion "Ingresar"
- Uso: Lista las guias de la ruta seleccionada.
🖼️ Pantallazos
-
Reparto:

📂 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
{
"success": true,
"message": "Ruta creada con éxito.",
"data": {
"id": 59054
}
}
📍 Contexto funcional (Dónde se usa)
- Módulo Reparto → Vista Crear-Rutas
- Evento: Al presionar el boton "Crear".
- Uso: Crea una nueva ruta de la terminal seleccionada.
🖼️ Pantallazos
-
Reparto:

📂 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
{
"success": true,
"message": "Ruta eliminada con éxito."
}
📍 Contexto funcional (Dónde se usa)
- Módulo Reparto→ Vista Crear-Rutas
- Evento: Al presionar el boton "Eliminar"
- Uso: Elimina el item
🖼️ Pantallazos
-
Reparto:

📂 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
{
"success": true,
"message": "Orden de servicio escaneada con éxito."
}
📍 Contexto funcional (Dónde se usa)
- 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:

📂 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
{
"success": true,
"message": "Guia de remision remitente escaneada con éxito"
}
📍 Contexto funcional (Dónde se usa)
- Módulo Reparto → Vista Detalle-Reparto
- Evento: al escanear una guia (documento)
- Uso: Devuleve la informacion de la orden de serviico
🖼️ Pantallazos
-
Reparto:

📂 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
{
"success": true,
"message": "Orden de servicio eliminada con éxito."
}
📍 Contexto funcional (Dónde se usa)
- Módulo Reparto → Vista Detalle-Ruta
- Evento: Al presionar el boton "Eliminar"
- Uso: quita de la lista de la ruta seleccionada.
🖼️ Pantallazos
-
Reparto:

📂 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
{
"success": false,
"message": "Ruta confirmada"
}
📍 Contexto funcional (Dónde se usa)
- Módulo Inicial → Vista Reparto
- Evento: Al presionar el boton "Cerrar"
- Uso: Cierra la ruta
🖼️ Pantallazos
-
Reparto:

📂 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
{
"success": true,
"message": "Ruta abierta"
}
📍 Contexto funcional (Dónde se usa)
- Módulo Reparto → Vista Detalle-Ruta
- Evento: Al presionar el boton "Abrir"
- Uso: Abre la ruta.
🖼️ Pantallazos
-
Reparto:

📂 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
{
"success": false,
"message": "No tiene devoluciones pendientes"
}
📍 Contexto funcional (Dónde se usa)
- Módulo Reparto→ Vista Detalle de Ruta
- Evento: Al presionar el boton "Devoluciones"
- Uso: Lista las devoluciones pendientes.
🖼️ Pantallazos
-
Reparto:

📂 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
{
"success": false,
"message": "No se encontró la orden de servicio."
}
📍 Contexto funcional (Dónde se usa)
- Módulo Reparto → Vista Devolución
- Evento: al escanear un codigo QR
- Uso: Obtiene la guia
🖼️ Pantallazos
-
Reparto:

📂 Archivos Flutter relacionados
🗒️ Notas adicionales