quedanGuías
Detalle de una guía
Una guía con su historial de eventos.
Devuelve una guía con su historial de eventos y los tiempos de recogida y entrega.
GET /api/v1/guias/:guia
Ejemplo
curl "https://cozter.com/api/v1/guias/WA-000100" \
-H "Authorization: Bearer czk_tu_clave"
Respuesta
{
"ok": true,
"guia": "WA-000100",
"id": "…",
"estado": "entregado",
"destinatario": "Juan Pérez",
"telefono": "+50370000000",
"direccion": "…",
"departamento": "San Salvador",
"municipio": "Soyapango",
"cod_amount": 25,
"direccion_confirmada": true,
"creada_en": "2026-07-20T15:00:00Z",
"actualizada_en": "2026-07-21T18:30:00Z",
"recogida": {
"conductor_asignado": true,
"recogida_en": "2026-07-21T09:00:00Z"
},
"en_ruta_en": "2026-07-21T14:00:00Z",
"entregada_en": "2026-07-21T18:30:00Z",
"eventos": [
{ "evento": "guia_creada", "fecha": "2026-07-20T15:00:00Z" },
{ "evento": "ubicacion_confirmada", "fecha": "2026-07-20T15:10:00Z" },
{ "evento": "entregada", "fecha": "2026-07-21T18:30:00Z" }
]
}
Eventos
Cada elemento de eventos tiene un evento y una fecha. Los eventos de entrega fallida (entrega_fallida) incluyen además un motivo.
evento | Significado |
|---|---|
guia_creada | Se creó la guía. |
ubicacion_confirmada | El destinatario confirmó su ubicación. |
reprogramada | Se reprogramó la entrega. |
reprogramada_por_cliente | El cliente reprogramó la entrega. |
entrega_fallida | La entrega falló (incluye motivo). |
cancelada | La guía fue cancelada. |
entregada | La guía fue entregada. |
Si no se encuentra la guía, la respuesta es 404.