API de envíos: cómo integrar agencias de transporte con tu tienda o ERP
Una API de envíos crea expediciones, etiquetas y seguimiento sin copiar datos a mano. Te contamos cuándo compensa, cómo usar webhooks y qué revisar.
Una API de envíos permite que tu tienda, tu ERP o tu propio software hablen con la capa de transporte sin que nadie copie datos a mano. Creas la expedición, pides la etiqueta y recibes el estado del paquete de forma automática. Si tu volumen crece o tienes un sistema a medida, es la vía que menos errores da.
Esta guía explica qué hace una API de envíos, cuándo compensa frente a un módulo o a un CSV y qué comprobar antes de integrarla. Si aún no necesitas programar, mira cómo importar pedidos por CSV. Sin código inventado: los detalles técnicos concretos están en la documentación de cada proveedor.
Qué es una API de envíos y qué puedes automatizar
Es una interfaz (normalmente REST) a la que tu sistema envía peticiones y de la que recibe respuestas en JSON. En envíos, cubre cuatro operaciones básicas:
- Crear la expedición: destinatario, bultos, peso, servicio y agencia.
- Obtener la etiqueta: en PDF o en ZPL para impresoras térmicas.
- Consultar el seguimiento: estado actual e historial de eventos.
- Cancelar o modificar una expedición mientras la agencia lo permita.
Con eso se automatiza todo el recorrido del pedido, desde el pago hasta la entrega.
API, módulo o CSV: cuál te conviene
No siempre hace falta programar. Elige según tu plataforma y tu volumen:
| Opción | Cuándo encaja | Esfuerzo |
|---|---|---|
| Módulo o plugin | Tienes PrestaShop o WooCommerce estándar | Bajo |
| Importación por CSV | Pocos pedidos o sistema sin conexión directa | Bajo, pero manual |
| API REST | ERP propio, flujos a medida, volumen alto | Medio, requiere desarrollo |
Si usas PrestaShop o WooCommerce, mira primero el módulo de envíos para PrestaShop y el plugin de envíos para WooCommerce. Si lo tuyo es un ERP o una plataforma sin conector, la API suele ser el camino.
Cómo es el flujo de envío con una API
El orden habitual es este:
- Tu sistema recibe un pedido pagado.
- Envía a la API los datos del destinatario, el peso y las medidas.
- La API aplica tus reglas (agencia por peso, destino o importe) y devuelve la expedición creada.
- Descargas la etiqueta y la imprimes, en PDF 10×15 o en ZPL.
- Guardas el número de seguimiento en el pedido.
- Recibes los cambios de estado y los muestras al cliente.
Webhooks: recibir el estado sin preguntar cada minuto
Consultar el seguimiento paquete a paquete (polling) gasta peticiones y llega tarde. Con webhooks, el proveedor llama a una URL tuya cuando cambia el estado: recogido, en reparto, entregado, incidencia.
Lo que debes preparar en tu lado:
- Una URL pública con HTTPS que responda rápido con un código 200.
- Verificación del origen del aviso (firma o token) antes de procesarlo.
- Tolerancia a duplicados: el mismo evento puede llegar dos veces.
- Una cola o registro para reintentar si tu sistema está caído.
Con esos eventos puedes alimentar la página de seguimiento de pedidos y los avisos de envío por WhatsApp y SMS, sin intervención manual.
Integrar tu ERP con las agencias de transporte
Conectar un ERP no es solo «mandar el pedido». Define antes qué sistema manda en cada dato:
- Catálogo: pesos y medidas de producto salen del ERP, no se teclean en el envío.
- Estado del pedido: el ERP lo actualiza al recibir el evento de entrega.
- Costes: guarda el coste real del envío por pedido para calcular márgenes.
Si hoy usas Odoo, tienes una conexión directa en integración con Odoo; el flujo completo está en la guía de envíos con Odoo y agencias de transporte. Para el resto de casos, consulta el catálogo de integraciones.
Errores típicos al integrar una API de envíos
Casi todos los problemas se repiten:
- Datos sin validar: teléfono vacío, código postal que no cuadra con la población o dirección sin número. Valida antes de crear la expedición.
- Peso a cero: productos sin peso en el catálogo generan expediciones rechazadas o mal facturadas. Sobre el cálculo, mira peso volumétrico.
- Sin manejo de errores: si la agencia rechaza la expedición, tu sistema debe marcarla y avisarte, no ignorarla.
- Sin entorno de pruebas: prueba con un entorno de sandbox o con expediciones de prueba antes de pasar a producción.
- Claves expuestas: guarda la clave de API en variables de entorno, nunca en el código ni en el navegador.
Cuánto trabajo supone y quién lo hace
Una integración básica (crear expedición, bajar etiqueta, guardar seguimiento) es un trabajo acotado para un desarrollador que conozca tu sistema. Lo que más tiempo consume no es la llamada a la API, sino las reglas de negocio de alrededor: qué agencia se elige, qué pasa con los pedidos de varios bultos, cómo se gestionan las devoluciones y qué hacer cuando falla un envío.
Un reparto razonable del trabajo:
- Negocio: define reglas de agencia, umbrales y servicios por destino antes de programar.
- Desarrollo: conecta pedido, expedición, etiqueta y seguimiento, y gestiona errores.
- Almacén: prueba la impresión de etiquetas con el flujo real, en PDF o ZPL.
- Atención al cliente: revisa los textos de los avisos que se enviarán con los eventos.
Empieza por un flujo mínimo en producción con pocos pedidos y amplíalo después. Es mejor tener una integración sencilla que funciona que una completa que nadie se atreve a activar.
Y no olvides el mantenimiento: las agencias cambian servicios y los proveedores publican versiones nuevas de su API. Anota quién revisa los avisos de cambios y cada cuánto se repasa el registro de errores. Un listado semanal de expediciones fallidas suele bastar para detectar problemas antes de que los vea un cliente.
Lista de comprobación antes de salir a producción
- Has creado, etiquetado y cancelado una expedición de prueba.
- El peso y las medidas llegan siempre rellenos.
- Gestionas los errores de la API y guardas el mensaje.
- Tu endpoint de webhooks verifica el origen y tolera duplicados.
- Hay un registro para reprocesar expediciones fallidas.
- La clave de API está fuera del código.
Cómo hacerlo con Sendgo
Sendgo ofrece una API REST con webhooks para crear expediciones, obtener etiquetas y recibir el seguimiento sobre tu propio contrato con las agencias. La documentación está en desarrolladores. Si aún no necesitas programar, puedes empezar con la importación por CSV y pasar a la API cuando el volumen lo pida. Consulta los planes y precios: desde 0 €/mes, sin permanencia, portes no incluidos.
Preguntas frecuentes
¿Qué es una API de envíos?
Es una interfaz que permite a tu tienda o ERP crear expediciones, descargar etiquetas y consultar el seguimiento de forma automática, sin entrar en el panel de cada agencia.
¿Cuándo me compensa usar una API en lugar de un módulo?
Cuando tienes un ERP propio, una plataforma sin conector o flujos a medida. Si usas PrestaShop o WooCommerce estándar, un módulo o plugin suele ser más rápido.
¿Para qué sirven los webhooks en envíos?
Para recibir en tu sistema los cambios de estado de cada paquete (recogido, en reparto, entregado, incidencia) sin tener que consultarlos continuamente.
¿Necesito saber programar para usar una API de envíos?
Sí, o contar con un desarrollador. Si no, puedes empezar con la importación por CSV o con un módulo y pasar a la API más adelante.
Sigue leyendo
Envíos con Wix: cómo gestionar etiquetas y agencias de transporte
Wix vende bien, pero enviar con tus agencias exige una herramienta de etiquetas. Opciones, comprobaciones y un flujo paso a paso para no copiar pedidos a mano.
21 de noviembre de 2026 · 5 min de lectura
Envíos con Squarespace en España: cómo gestionar etiquetas y agencias
Squarespace vende muy bien, pero el transporte con agencias españolas se queda a medias. Así montas un flujo con tu propio contrato, etiquetas en bloque y seguimiento.
20 de noviembre de 2026 · 6 min de lectura
Envíos con Odoo: cómo conectar tus agencias y generar etiquetas sin copiar datos
Odoo gestiona el albarán, pero no habla con tus agencias. Te contamos las opciones para generar etiquetas, aplicar reglas y devolver el seguimiento al ERP.
17 de noviembre de 2026 · 6 min de lectura