sendDesarrolladores
API de envíos sencilla y en español
Integra Sendgo con tu ERP, tu tienda a medida o tu almacén: crea envíos, descarga etiquetas y recibe cada cambio de estado.
Endpoints principales
| Método | Ruta | Para qué |
|---|---|---|
| GET | /api/v1/shipments | Lista de envíos (paginada) |
| POST | /api/v1/shipments | Crear un envío |
| POST | /api/v1/shipments/{id}/label | Generar la etiqueta con la agencia |
| GET | /api/v1/shipments/{id}/label.pdf · label.zpl | Descargar la etiqueta |
| POST | /api/v1/shipments/{id}/cancel | Anular |
| POST | /api/v1/shipments/{id}/events | Estados de reparto propio (en reparto, entregado con prueba de entrega) |
| POST | /api/v1/rates | Tarifas y plazos para un carrito (checkout) |
| GET | /api/v1/service-points | Puntos de recogida y taquillas cercanos |
| GET | /api/v1/carriers | Tus agencias conectadas |
Ejemplo
curl -X POST https://app.sendgo.es/api/v1/shipments \
-H "Authorization: Bearer etq_…" -H "Content-Type: application/json" \
-d '{"external_id":"10482","recipient_name":"Lucía Ortega","recipient_postal_code":"28013",
"recipient_city":"Madrid","carrier":"gls","parcels":[{"weight_kg":2.5}]}'
Seguridad
- Token Bearer por empresa, guardado con hash: solo se muestra una vez.
- Límite de 600 peticiones por minuto por token.
- Webhooks firmados con HMAC-SHA256.
La API está incluida en el plan Business. El token se crea en Configuración → API.
Preguntas
Preguntas frecuentes
¿Qué plan incluye la API?
El plan Business incluye la API REST y los webhooks.
¿En qué formato salen las etiquetas?
PDF (10×15 o A4) y ZPL para impresoras térmicas Zebra y compatibles.
Prueba Sendgo con tus envíos
Plan gratis con tu propio contrato. Sin tarjeta y sin permanencia.