Agencias y 3PL Tu propio software de etiquetado e integración, con tu marca. Descúbrelo →
Integraciones

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.

API de envíos: cómo integrar agencias de transporte con tu tienda o ERP

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ónCuándo encajaEsfuerzo
Módulo o pluginTienes PrestaShop o WooCommerce estándarBajo
Importación por CSVPocos pedidos o sistema sin conexión directaBajo, pero manual
API RESTERP propio, flujos a medida, volumen altoMedio, 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:

  1. Tu sistema recibe un pedido pagado.
  2. Envía a la API los datos del destinatario, el peso y las medidas.
  3. La API aplica tus reglas (agencia por peso, destino o importe) y devuelve la expedición creada.
  4. Descargas la etiqueta y la imprimes, en PDF 10×15 o en ZPL.
  5. Guardas el número de seguimiento en el pedido.
  6. Recibes los cambios de estado y los muestras al cliente.
Consejo: guarda siempre el identificador de expedición que devuelve la API en tu pedido. Sin él no podrás cancelar, reimprimir ni consultar el estado más adelante.

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

  1. Has creado, etiquetado y cancelado una expedición de prueba.
  2. El peso y las medidas llegan siempre rellenos.
  3. Gestionas los errores de la API y guardas el mensaje.
  4. Tu endpoint de webhooks verifica el origen y tolera duplicados.
  5. Hay un registro para reprocesar expediciones fallidas.
  6. 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.

¿Envías desde una tienda online? Sendgo imprime las etiquetas de tus agencias con tu propio contrato, avisa a tus clientes con tu marca y gestiona las devoluciones. Pruébalo gratis o mira los precios.

Prueba Sendgo con tus envíos

Plan gratis con tu propio contrato. Sin tarjeta y sin permanencia.