quedanGuías
Crear una guía
Crea una sola guía de envío.
Crea una guía. Las coordenadas de recogida son obligatorias. Si envías las coordenadas de destino (lat/lng o maps_url), la dirección queda confirmada al instante; si no, el destinatario recibe un mensaje de WhatsApp para confirmar su ubicación.
POST /api/v1/guias
Cuerpo
| Campo | Tipo | Descripción |
|---|---|---|
telefono | string · obligatorio | Teléfono del destinatario (E.164 o local). |
departamento | string · obligatorio | Departamento de destino. |
municipio | string · obligatorio | Municipio de destino. |
recogida | object · obligatorio | Punto de recogida. { lat, lng } o { maps_url }. Opcional: nombre, direccion. |
nombre | string | Nombre del destinatario. |
direccion | string | Dirección de destino en texto. |
referencia | string | Punto de referencia. |
contenido | string | Descripción del contenido. |
notas | string | Notas para el conductor. |
cod_amount | number | Monto a cobrar contra entrega. Por defecto 0. |
external_ref | string | Tu referencia (idempotencia, máx. 100 caracteres). |
lat / lng | number | Coordenadas de destino — confirman la dirección al instante. |
maps_url | string | Enlace de Google Maps de destino (alternativa a lat/lng). |
Ejemplo
curl -X POST https://cozter.com/api/v1/guias \
-H "Authorization: Bearer czk_tu_clave" \
-H "Content-Type: application/json" \
-d '{
"telefono": "+50370000000",
"nombre": "María López",
"departamento": "San Salvador",
"municipio": "Soyapango",
"direccion": "Col. Las Flores, casa 12",
"contenido": "1 caja",
"cod_amount": 25.00,
"external_ref": "PED-1024",
"recogida": { "maps_url": "https://maps.app.goo.gl/xxxx" }
}'
Respuesta 201
{
"ok": true,
"guia": "WA-000101",
"id": "9f2c…",
"estado": "aceptado",
"external_ref": "PED-1024"
}
Idempotencia
Envía external_ref para evitar duplicados. Repetir el mismo valor no crea una guía nueva: devuelve 200 con la guía existente y duplicada: true.
{
"ok": true,
"duplicada": true,
"guia": "WA-000101",
"id": "9f2c…",
"estado": "aceptado",
"external_ref": "PED-1024"
}
Podés dar el punto de recogida y el destino como coordenadas (
lat/lng) o como un enlace de Google Maps (maps_url), incluyendo enlaces cortos maps.app.goo.gl.