Cómo integrar la API de Estafeta con tu TMS
Guía paso a paso para integrar la API de Estafeta con tu TMS: cotización, guías, rastreo y recolección automatizados, compatibles con Carta Porte.
Si gestionas transporte para una operación con volumen real en México, ya conoces el problema: Estafeta mueve miles de guías al mes para tu empresa, pero cada una se captura a mano en un portal separado del ERP y del TMS. Este artículo explica paso a paso cómo integrar la API Estafeta con tu TMS para automatizar cotización, generación de guías, rastreo y recolección, sin perder de vista el Complemento Carta Porte del CFDI 4.0.
Por qué integrar Estafeta directamente a tu TMS (y no solo al portal web)
Porque el portal web de Estafeta está pensado para capturar guía por guía, no para operaciones de alto volumen con múltiples transportistas en paralelo. Si tu empresa trabaja con Estafeta junto a DHL, FedEx o Paquetexpress, cada portal exige su propia sesión, su propio formato de captura y su propio reporte de estatus.
Estafeta ya ofrece una alternativa pensada para clientes de volumen: si eres cliente de volumen, puedes utilizar su software Comando Web para administrar el flujo de tus envíos. El problema es que ese "control total" sigue viviendo dentro del ecosistema de Estafeta, separado de tu TMS y de tu ERP. El resultado típico: doble captura entre sistemas, errores de código postal que rebotan guías, y cero visibilidad centralizada cuando necesitas comparar el desempeño de Estafeta contra el resto de tus transportistas.
Por eso cada vez más equipos de compras de transporte en México buscan un software multitransportista que ya resuelva la conectividad en lugar de construirla desde cero. Plataformas como Guías Digitales MX ya conectan Estafeta junto con DHL, FedEx, UPS y otras paqueterías mexicanas bajo una sola cuenta. A nivel empresarial, con integración de rutas, reglas de negocio y reporting por KPI, aparecen opciones como ShippyPro, Sendcloud, nShift, Shipmondo o Cargoson, cada una con un enfoque distinto sobre cuántos transportistas cubren y qué tan a fondo integran.
Qué necesitas antes de empezar
Antes de tocar una sola línea de código necesitas cinco cosas sobre la mesa. Sin ellas, el proyecto se atrasa semanas por idas y vueltas con el ejecutivo de cuenta.
- Contrato comercial vigente con Estafeta y un ejecutivo de cuenta asignado, que es quien autoriza el alta de Web Services.
- Credenciales de Web Services: usuario y contraseña del ambiente, o una API-Key si trabajas a través de un agregador autorizado.
- Acceso a la especificación técnica (WSDL/XSD) de los cuatro servicios: cotización, generación de guía, rastreo y recolección.
- Catálogo actualizado de códigos postales y tipos de servicio (Día Siguiente, Dos Días, Terrestre, Express, Internacional).
- Un TMS con capacidad de conectores personalizados o un middleware (iPaaS) que sepa hablar SOAP/XML además de REST.
Un dato que suele sorprender a los equipos de TI: los Web Services Estafeta se instalan sin costo y de forma extraordinariamente sencilla, basta con una solicitud al ejecutivo de cuenta para que Estafeta se integre a la operación del cliente, sin cambiar de ambiente, desde su propio sitio. No hay licencia que negociar aparte, pero sí hay un proceso de alta técnica que toma tiempo si no llegas con la documentación lista.
Los 6 pasos para integrar Estafeta con tu TMS
Esta secuencia asume que ya tienes contrato comercial y que tu TMS admite conectores a medida. Si tu TMS no lo admite, salta directo a la sección de construir vs. comprar más abajo.
- Solicita el alta como cliente de Web Services Estafeta. Contacta a tu ejecutivo de cuenta, firma el anexo técnico correspondiente y pide credenciales separadas para ambiente de pruebas (sandbox) y producción. No empieces a desarrollar sin tener ambos entornos activos.
- Mapea los cuatro servicios disponibles. La cotización de servicios, generación de guías, el rastreo, y hasta la programación de la recolección está en manos de los clientes de forma total una vez que la integración está activa. Cada uno es un servicio independiente con su propio WSDL: cotización (tarifas por código postal origen/destino, peso y volumen), generación de guía (número de guía más PDF de etiqueta), rastreo (consulta de estatus) y recolección (programación de pickup). Documenta cada endpoint por separado, no asumas que comparten estructura de respuesta.
- Configura el conector en el TMS. Crea el adaptador SOAP/XML (o REST si trabajas vía un agregador como Envíosperros, que ofrece acceso a la API sin contrato mínimo para volúmenes menores) y mapea los campos maestros: código postal, tipo de servicio, dimensiones y peso volumétrico. Define también reglas de negocio, por ejemplo elegir Estafeta solo cuando su tarifa esté dentro de un porcentaje definido respecto a DHL o FedEx para ese trayecto.
- Prueba en el entorno sandbox antes de tocar producción. Genera guías de prueba con distintas combinaciones de código postal y servicio, valida el código de respuesta SOAP/HTTP y confirma que el PDF de etiqueta se renderiza correctamente. Para el servicio de rastreo, ten en cuenta que Estafeta maneja dos identificadores distintos: número de guía de 22 dígitos y código de rastreo de 10 dígitos, y tu conector debe aceptar ambos formatos sin confundirlos.
- Vincula la generación de guía con el Complemento Carta Porte del CFDI 4.0. Automatiza que los datos de ubicación, mercancía y transportista que ya generaste en el TMS alimenten directamente el XML del complemento, en lugar de capturarlos otra vez en tu sistema de facturación.
- Activa el rastreo automático y las alertas. Configura un polling periódico contra el WSDL de rastreo (o un webhook si tu agregador lo soporta) para que el estatus de entrega se actualice solo en el TMS, sin que nadie tenga que entrar al portal de Estafeta a revisar guía por guía.
Cómo saber que la integración funcionó
Lo sabes cuando dejas de depender del portal para operar el día a día. Antes de declarar la integración lista para producción, corre una prueba de aceptación formal: genera 50 guías de prueba en sandbox y confirma que el 100% recibe un número de guía válido, y que el estatus de rastreo se refleja en el TMS en menos de 15 minutos después del escaneo físico en el centro de distribución de Estafeta.
Para el seguimiento continuo, mide estos indicadores mes a mes:
- Porcentaje de guías generadas sin intervención manual.
- Tiempo medio de generación de guía (segundos vía API frente a minutos en el portal).
- Tasa de error por código postal rechazado.
- Reducción de llamadas al servicio al cliente de Estafeta por discrepancias de estatus o guía.
Fallo común: rechazo de guías por catálogo de código postal desactualizado
Esto pasa más de lo que cualquier equipo de TI quisiera admitir. Estafeta valida cada guía contra su propio catálogo interno de códigos postales y colonias. Si tu ERP usa un catálogo distinto, por ejemplo el del SAT o uno genérico de terceros, la guía se rechaza en el momento de generación con un error de validación que no siempre es descriptivo.
La solución tiene dos partes. Primero, sincroniza periódicamente el catálogo de códigos postales de Estafeta con el maestro de direcciones de tu TMS/ERP, no asumas que un catálogo sirve para todos los transportistas. Segundo, define una regla de reintento automático con transportista alterno: si el rechazo persiste después de dos intentos con el catálogo corregido, el sistema debe enrutar esa guía a un transportista de respaldo sin detener el flujo del pedido.
Carta Porte y Estafeta: lo que no puedes pasar por alto
El Complemento Carta Porte no es opcional ni negociable: se incorpora a un CFDI 4.0 de tipo ingreso (I) o de traslado (T) para acreditar el traslado de bienes o mercancías por territorio nacional. Si tu guía de Estafeta se genera sin que esos datos alimenten correctamente el complemento, el riesgo no es solo operativo, es fiscal.
Las multas vigentes para 2026 no son simbólicas: van de $450 a $670 pesos por cada comprobante emitido sin el complemento, y de $1,000 a $19,280 pesos por no acompañar la documentación que ampara las mercancías en traslado. Multiplicado por cientos de guías mensuales, el riesgo acumulado supera rápido cualquier ahorro que hayas logrado negociando tarifa con Estafeta.
La recomendación práctica es que el conector de Estafeta comparta los mismos campos de ubicación y mercancía con el módulo de Carta Porte de tu sistema de facturación. Si hoy capturas esos datos dos veces, uno para la guía y otro para el CFDI, ahí está tu próximo proyecto de automatización, y probablemente el de mayor retorno inmediato en términos de riesgo evitado.
Cuándo construir el conector tú mismo y cuándo usar un TMS multitransportista ya conectado
Construir el conector tiene sentido si Estafeta representa una porción grande y estable de tu volumen y tienes equipo de TI dedicado a mantenimiento continuo: actualizaciones de WSDL, certificados, cambios en el catálogo de código postal. Si no tienes ese equipo, o si gestionas seis o siete transportistas distintos, el cálculo cambia.
| Plataforma | Foco geográfico | Estafeta incluido | Perfil de cliente típico |
|---|---|---|---|
| Guías Digitales MX | México | Sí, junto a DHL, FedEx, UPS y más | Pymes y e-commerce con volumen medio |
| Cargoson | Europa con expansión global | Vía solicitud de integración bajo demanda | Fabricantes y mayoristas medianos-grandes |
| ShippyPro | E-commerce global | No especificado públicamente | Retail online |
| Sendcloud | E-commerce, Europa | No especificado públicamente | Retail online |
| nShift / Shipmondo | Enterprise, Europa | No especificado públicamente | Grandes cargadores europeos |
| Transporeon / MercuryGate / Descartes | Enterprise global, carga FTL/LTL | No especificado públicamente | Cargadores globales multimodales |
Nota algo importante en esa tabla: ninguna de las plataformas de alcance global tiene a Estafeta confirmado públicamente como integración nativa. Eso significa que, si operas en México con volumen alto en Estafeta, probablemente termines pidiendo una integración específica, sea construyéndola tú mismo con el WSDL oficial, sea solicitándola a un proveedor de TMS multitransportista que construya conectores bajo demanda, sea apoyándote en un agregador local como Guías Digitales MX para el tramo de menor volumen.
El siguiente paso concreto: pide hoy mismo a tu ejecutivo de cuenta de Estafeta el anexo técnico de Web Services y el acceso al ambiente sandbox. Mientras llega, documenta cuántos campos capturas hoy por duplicado entre tu ERP, tu TMS y el Complemento Carta Porte. Esa lista será tu especificación funcional del conector.