Referencia
Errores
Códigos de error y formato de respuesta.
Los errores usan códigos HTTP estándar y traen un mensaje legible en el cuerpo:
{
"error": "El teléfono del destinatario es requerido."
}
Códigos
| Código | Significado |
|---|---|
400 | Solicitud inválida (campos faltantes o mal formados). |
401 | Clave de API faltante, inválida, revocada o expirada. |
404 | Guía no encontrada. |
409 | Conflicto (por ejemplo, pedir la prueba de entrega antes de entregar). |
500 | Error interno. |
Mensajes comunes
| Mensaje | Causa |
|---|---|
El teléfono del destinatario es requerido. | Falta telefono. |
El departamento es requerido. | Falta departamento. |
El municipio es requerido. | Falta municipio. |
Las coordenadas de recogida son requeridas… | Falta recogida.lat/lng o recogida.maps_url. |
Coordenadas inválidas: se requieren lat y lng numéricos válidos. | lat/lng fuera de rango o no numéricos. |
No se pudieron obtener coordenadas del enlace de Google Maps. | maps_url no se pudo resolver. |
external_ref no puede superar 100 caracteres. | external_ref demasiado largo. |
Máximo 100 guías por solicitud… | El lote supera las 100 guías. |