Guías
Crear en lote
Crea hasta 100 guías en una sola llamada.
Crea hasta 100 guías en una sola solicitud.
POST /api/v1/guias/bulk
Cuerpo
| Campo | Tipo | Descripción |
|---|---|---|
guias | array · obligatorio | Arreglo de guías (mismos campos que Crear una guía), de 1 a 100. |
recogida | object | Recogida por defecto para todas las guías. Cada guía puede sobreescribirla con su propio recogida. |
Cada guía debe resolver un punto de recogida, ya sea por el recogida de nivel superior o el suyo propio.
Ejemplo
curl -X POST https://cozter.com/api/v1/guias/bulk \
-H "Authorization: Bearer czk_tu_clave" \
-H "Content-Type: application/json" \
-d '{
"recogida": { "lat": 13.7, "lng": -89.2, "nombre": "Bodega central" },
"guias": [
{ "telefono": "+50370000001", "departamento": "San Salvador", "municipio": "Mejicanos" },
{ "telefono": "+50370000002", "departamento": "La Libertad", "municipio": "Santa Tecla",
"lat": 13.67, "lng": -89.28 }
]
}'
Respuesta 200
La llamada responde 200 siempre. Revisa cada resultado por su indice: los que fallaron traen error en vez de guia.
{
"ok": true,
"creadas": 2,
"fallidas": 0,
"resultados": [
{ "indice": 0, "ok": true, "guia": "WA-000102", "estado": "aceptado" },
{ "indice": 1, "ok": true, "guia": "WA-000103", "estado": "aceptado" }
]
}
Las guías sin coordenadas de destino disparan cada una el mensaje de WhatsApp de confirmación de ubicación. Incluye
lat/lng (o maps_url) para omitirlo.