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

CampoTipoDescripción
guiasarray · obligatorioArreglo de guías (mismos campos que Crear una guía), de 1 a 100.
recogidaobjectRecogida 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.