quedanGuías
Listar guías
Lista las guías de tu comercio con paginación por cursor.
Lista las guías de tu comercio, más recientes primero.
GET /api/v1/guias
Parámetros de consulta
| Parámetro | Descripción |
|---|---|
estado | Filtra por estado. |
desde / hasta | Fechas ISO sobre la fecha de creación. |
limit | Cantidad por página. Por defecto 50, máximo 100. |
cursor | Cursor de la página anterior (siguiente_cursor). |
Ejemplo
curl "https://cozter.com/api/v1/guias?estado=entregado&limit=50" \
-H "Authorization: Bearer czk_tu_clave"
Respuesta
{
"ok": true,
"guias": [
{
"guia": "WA-000100",
"id": "…",
"external_ref": "PED-1023",
"estado": "entregado",
"destinatario": "Juan Pérez",
"telefono": "+50370000000",
"direccion": "…",
"departamento": "San Salvador",
"municipio": "Soyapango",
"referencia": null,
"contenido": "1 caja",
"notas": null,
"cod_amount": 25,
"direccion_confirmada": true,
"creada_en": "2026-07-20T15:00:00Z",
"actualizada_en": "2026-07-21T18:30:00Z"
}
],
"siguiente_cursor": "MjAyNi0wNy0yMHwx…"
}
Paginación
Para la siguiente página, pasa siguiente_cursor como cursor. Cuando es null, llegaste al final.
curl "https://cozter.com/api/v1/guias?cursor=MjAyNi0wNy0yMHwx…" \
-H "Authorization: Bearer czk_tu_clave"
Al filtrar por estados intermedios (
aceptado, en_camino_a_recoger, recogido), una página puede volver con menos elementos que el limit. Sigue paginando por cursor hasta que sea null.