APIs de transportistas de envíos explicadas: UPS, FedEx, USPS, DHL y más
Las API de transportistas son conexiones de software que permiten a una tienda, un sistema de almacén, una plataforma de gestión de pedidos o una herramienta de atención al cliente intercambiar datos de envíos con transportistas como UPS, FedEx, USPS y DHL. Pueden admitir tareas como solicitar tarifas, crear etiquetas, reservar envíos, actualizar el seguimiento, verificar direcciones y enviar notificaciones de eventos de entrega. El enfoque de API adecuado depende menos del nombre del transportista que del flujo de trabajo que necesita automatizar, los países a los que presta servicio y los sistemas que ya utiliza.
Una integración con un solo transportista puede funcionar bien cuando el volumen de envíos y el área de servicio son predecibles. Una API para múltiples transportistas suele ser más práctica cuando una operación compara servicios, realiza envíos internacionales o necesita un formato de seguimiento único para varios transportistas. Esta guía explica los principales tipos de API, cómo se diferencian los principales transportistas a grandes rasgos y qué se debe verificar antes de crear o comprar una integración.
Qué hace una API de transportista de envíos
Una API, o interfaz de programación de aplicaciones, define cómo dos sistemas de software intercambian solicitudes y respuestas. En los envíos, su aplicación puede enviar los detalles del paquete, las direcciones de origen y destino, las preferencias de servicio y la información aduanera. A continuación, el transportista o la plataforma de envíos devuelve una respuesta, como una tarifa de envío, los datos de una etiqueta, un número de seguimiento o un mensaje de error.
Las API de transportistas normalmente cumplen varias funciones independientes:
- Cálculo de tarifas: Solicita un costo de envío estimado o basado en contrato para un paquete y servicio.
- Creación de envíos: Envía los detalles del envío y recibe un número de seguimiento o una confirmación del envío.
- Generación de etiquetas: Produce una etiqueta imprimible, normalmente como PDF, imagen o carga útil de documento.
- Seguimiento: Recupera eventos de envío, estados, ubicaciones e información de entrega cuando está disponible.
- Servicios de dirección: Valida, estandariza o complementa la información de la dirección, según el transportista y el destino.
- Recogida y manifiestos: Admite solicitudes de recogida o documentación de envíos al final del día cuando la cuenta y el servicio lo permiten.
- Notificaciones: Envía información de estado mediante consultas periódicas, webhooks, funciones de correo electrónico u otro mecanismo de eventos.
Estas capacidades no se incluyen automáticamente en todas las cuentas de API de transportistas. Un transportista puede separar los servicios en diferentes productos, exigir la aprobación de la cuenta o limitar el acceso por país, tipo de servicio, acuerdo con el cliente o entorno técnico. Considere cada capacidad como algo que debe confirmarse en la documentación vigente del transportista, en lugar de inferirla simplemente de la existencia de una API.
API directas de transportistas frente a API para múltiples transportistas
Existen dos modelos prácticos de integración. Una integración directa con un transportista conecta su software con la plataforma para desarrolladores de un solo transportista. Una integración para múltiples transportistas conecta su software con un intermediario que normaliza varios transportistas mediante una única interfaz.
| Modelo | Ventajas | Compromisos | Más adecuado para |
|---|---|---|---|
| API directa del transportista | Acceso directo a los propios servicios, reglas de cuenta y datos de envío del transportista | Credenciales, formatos, pruebas, gestión de errores y mantenimiento independientes para cada transportista | Una empresa con un transportista principal o un flujo de trabajo especializado de un transportista |
| API para múltiples transportistas | Una sola integración puede simplificar el seguimiento, la selección del transportista y la gestión normalizada de estados | La cobertura, la profundidad de las funciones, los requisitos de cuenta y las condiciones comerciales varían según el proveedor | Comercio electrónico con múltiples transportistas, marketplaces, 3PL y operaciones transfronterizas |
Una API para múltiples transportistas no necesariamente sustituye la relación directa con un transportista. Algunas funciones de envío aún pueden requerir una cuenta del transportista, tarifas negociadas, aprobación o configuración directa. También conviene comprobar si el intermediario crea etiquetas, solo realiza el seguimiento de envíos existentes o admite ambas funciones.
Comparación de las API de los principales transportistas
API de UPS
UPS proporciona recursos para desarrolladores destinados a conectar aplicaciones empresariales con los servicios de UPS. Según la cuenta, la región y el producto, los desarrolladores pueden investigar capacidades como el cálculo de tarifas, los envíos, el seguimiento, los servicios relacionados con direcciones y los flujos de trabajo de recogida mediante el entorno oficial para desarrolladores de UPS.
UPS suele ser considerado por empresas que tienen una operación importante de paquetes, necesitan acceso a servicios específicos de UPS o ya gestionan una cuenta y un contrato con UPS. La pregunta práctica no es simplemente si UPS tiene una API. Es si el servicio específico de UPS, el acuerdo de facturación, el destino y el perfil del paquete pueden utilizarse mediante el producto de API disponible para su cuenta.
Antes de la implementación, confirme el proceso de autenticación actual, la disponibilidad del entorno sandbox, los formatos de solicitud compatibles, el resultado de las etiquetas, la elegibilidad de las tarifas, el comportamiento de los eventos de seguimiento y los requisitos de migración. La documentación y los nombres de los productos de UPS pueden cambiar, por lo que debe utilizar el portal oficial para desarrolladores de UPS como punto de partida.
API de FedEx
FedEx ofrece una plataforma para desarrolladores destinada a aplicaciones que necesitan trabajar con servicios de envío y entrega de FedEx. Su documentación es la fuente adecuada para comprobar las API disponibles, las credenciales, los entornos de prueba, los flujos de trabajo de envío, el seguimiento y los requisitos específicos de cada servicio.
FedEx puede ser una buena opción cuando una operación depende de los servicios de FedEx o necesita un control específico del transportista sobre los flujos de trabajo de envío y seguimiento. El esfuerzo de integración puede implicar más que enviar una dirección y recibir una etiqueta. Las dimensiones del paquete, la selección del servicio, los detalles de la cuenta, la información aduanera, las normas sobre mercancías peligrosas y la documentación internacional pueden afectar a la solicitud y la respuesta.
Los equipos deben probar tanto las solicitudes correctas como las fallidas. Por ejemplo, una aplicación debe saber cómo gestionar una dirección no válida, un servicio no compatible, una solicitud de envío duplicada, un campo aduanero faltante y una interrupción temporal del transportista. Consulte el Portal para desarrolladores de FedEx para obtener la documentación y los requisitos de acceso actuales.
API de USPS
USPS proporciona recursos empresariales y para desarrolladores en línea para aplicaciones que utilizan los servicios de USPS. USPS es especialmente relevante para los flujos de trabajo nacionales de paquetes y correo en EE. UU., mientras que los productos de API exactos y las condiciones de acceso deben comprobarse en la documentación oficial vigente.
Las integraciones con USPS merecen pruebas cuidadosas porque una empresa puede necesitar distinguir entre productos postales, servicios de paquetes, eventos de seguimiento, datos de direcciones y flujos de trabajo de etiquetas o franqueo. Un requisito de solo seguimiento es materialmente distinto de una aplicación que debe comprar franqueo o generar etiquetas de envío.
No dé por sentado que una API de USPS tiene la misma estructura de solicitudes, vocabulario de eventos, disponibilidad de servicios o modelo de cuenta que UPS o FedEx. Revise los recursos para desarrolladores de USPS y confirme qué productos están disponibles para su caso de uso, alcance geográfico y configuración de cuenta. Si su empresa solo necesita una vista de seguimiento uniforme entre transportistas, una API para múltiples transportistas centrada en el seguimiento puede requerir menos lógica personalizada de transportistas que varias integraciones directas.
API de DHL
DHL es un grupo de empresas con diferentes servicios de logística y paquetería, por lo que “la API de DHL” no es un producto universal para todos los envíos. Los recursos para desarrolladores de DHL abarcan API y herramientas asociadas a sus servicios, pero el producto relevante depende de la unidad de negocio de DHL, el destino, el tipo de envío y la relación de cuenta.
DHL es un candidato natural para los envíos internacionales, los servicios exprés y las operaciones transfronterizas, pero la integración correcta aún debe corresponder al servicio que se está comprando. Verifique si la documentación se aplica a DHL Express, los servicios de paquetería de comercio electrónico, el transporte de carga u otra oferta de DHL antes de diseñar el flujo de trabajo.
Compruebe los países compatibles, los campos aduaneros y de factura comercial, los códigos de servicio, el comportamiento del seguimiento, los formatos de las etiquetas y los requisitos de incorporación de cuentas en el Portal para desarrolladores de DHL. Para las implementaciones internacionales, incluya un proceso para gestionar excepciones aduaneras y documentación incompleta, en lugar de tratar el seguimiento como todo el ciclo de vida del envío.
Otros transportistas
Las empresas también pueden necesitar transportistas regionales o nacionales como Canada Post, Royal Mail, Australia Post, DPD, GLS o Japan Post. Sus API difieren en cobertura, incorporación, nombres de servicios, nivel de detalle de los eventos de seguimiento, formatos de etiquetas y compatibilidad con envíos internacionales. Por lo tanto, “más transportistas” no es automáticamente mejor. La cobertura debe medirse en función de las rutas, los servicios y los tipos de envío que realmente utiliza.
Para un transportista importante para su operación, revise primero su propia documentación para desarrolladores. Si el transportista es compatible a través de una plataforma externa, confirme si la integración es directa, si usted proporciona sus propias credenciales del transportista y qué funciones están disponibles. La compatibilidad con el seguimiento no demuestra que también sean compatibles el cálculo de tarifas, la creación de etiquetas o la cancelación de envíos.
¿API de seguimiento o API de envíos completa?
Muchos proyectos utilizan la expresión “API de envíos” cuando en realidad necesitan seguimiento de envíos. Son alcances diferentes. Una API de seguimiento generalmente acepta un número de seguimiento y un transportista, y luego devuelve eventos normalizados o un estado actual. Una API de envíos completa puede abarcar tarifas, etiquetas, creación de envíos, documentos aduaneros y seguimiento.
Si su objetivo principal es mostrar el progreso de la entrega en un sitio de comercio electrónico, un portal de clientes o una herramienta de soporte, una integración centrada en el seguimiento puede ser suficiente. La API de seguimiento de 17TRACK es un ejemplo de producto de seguimiento para múltiples transportistas; debe utilizar su documentación para verificar la cobertura actual de transportistas, los formatos de solicitud, la autenticación y el comportamiento de los eventos antes de adoptarlo.
Si necesita comprar franqueo o crear etiquetas, el seguimiento por sí solo no completará el flujo de trabajo. Puede necesitar cuentas directas de transportistas, una plataforma de envíos o una API de envíos para múltiples transportistas con capacidades de etiquetado documentadas. Separar estos requisitos desde el principio evita un error común de implementación: seleccionar un producto de seguimiento y descubrir después que no puede crear el envío que necesita su almacén.
Qué comprobar antes de elegir una API
1. Defina el flujo de trabajo empresarial
Escriba la acción exacta que debe realizar el sistema. Algunos ejemplos son “mostrar los eventos de seguimiento después de enviar un pedido”, “seleccionar el servicio elegible de menor costo”, “crear una etiqueta en el almacén” o “notificar a un cliente cuando la entrega se retrase”. Cada acción tiene diferentes datos, gestión de errores y requisitos operativos.
2. Asigne transportistas a rutas y servicios
Enumere los países de origen, los países de destino, los tipos de paquetes, los niveles de servicio, los flujos de devoluciones y cualquier mercancía restringida. Un transportista puede ser técnicamente compatible y aun así no ser adecuado para una ruta o servicio concretos. Para los envíos internacionales, incluya en los requisitos los datos aduaneros, los aranceles, los impuestos y la documentación comercial.
3. Confirme los requisitos previos de acceso y comerciales
Compruebe si la API requiere una cuenta del transportista, configuración de facturación, aprobación, tarifas negociadas, un token de aplicación o una revisión para producción. Las credenciales de prueba y las de producción pueden ser diferentes. Nunca coloque secretos de producción en código del navegador ni en repositorios públicos; utilice una integración segura del lado del servidor y rote las credenciales de acuerdo con su política de seguridad.
4. Compare la calidad de los datos, no solo el número de endpoints
Pregunte cómo representa la API el estado del envío, la entrega estimada, las excepciones de entrega, la prueba de entrega, los escaneos, las devoluciones y los envíos de varios paquetes. Una lista extensa de endpoints no garantiza un nivel de detalle útil en los eventos. Decida cómo normalizará su aplicación estados como etiqueta creada, en tránsito, en reparto, entregado, excepción y devuelto.
5. Pruebe los escenarios de fallo y cambio
Una integración lista para producción debe gestionar tiempos de espera, límites de frecuencia, solicitudes duplicadas, direcciones no válidas, escaneos faltantes, interrupciones del transportista, cambios en los números de seguimiento y eventos tardíos o fuera de orden. Utilice la idempotencia cuando la API la admita, registre los identificadores de solicitud y haga que los reintentos sean seguros. Los sistemas de seguimiento también deben tolerar periodos sin nuevos escaneos en lugar de tratar cada periodo sin actividad como un fallo.
6. Evalúe el costo de mantenimiento
Las API de los transportistas cambian. Las actualizaciones de versiones, los cambios de certificados, los cambios de códigos de servicio, los nuevos campos aduaneros y los endpoints retirados pueden afectar a las operaciones. Pregunte quién supervisa los cambios en la documentación, quién se encarga de responder a los incidentes y con qué rapidez puede actualizarse la integración. Un proveedor para múltiples transportistas puede reducir el número de integraciones que mantiene su equipo, pero introduce una dependencia que debe evaluarse en cuanto a la continuidad del servicio y la calidad del soporte.
Un marco práctico para tomar decisiones
Elija una API directa del transportista cuando un transportista domine sus envíos, necesite funciones específicas del transportista y su equipo pueda mantener la integración. Elija una API de envíos para múltiples transportistas cuando necesite tarifas, etiquetas y creación de envíos con varios transportistas mediante un solo flujo de trabajo, siempre que los servicios requeridos sean realmente compatibles.
Elija una API de seguimiento para múltiples transportistas cuando el requisito principal sea una experiencia de seguimiento uniforme entre transportistas, canales o países. Esto puede ser útil para equipos de comercio electrónico que desean un modelo de estado posventa compartido sin crear analizadores de seguimiento independientes para cada transportista. Si necesita tanto crear etiquetas como realizar el seguimiento, verifique si un proveedor admite ambas funciones o planifique una arquitectura de dos partes.
Para un proyecto nuevo, comience con una prueba de concepto pequeña. Pruebe un envío nacional, un envío internacional si corresponde, una solicitud fallida, un evento de excepción y un escenario de devolución o cancelación. Compare los datos devueltos con la página de seguimiento orientada al cliente del transportista y con sus expectativas operativas. Solo entonces debería comprometerse con una implementación más amplia.
Preguntas frecuentes
¿Puede una API de un solo transportista proporcionar tarifas, etiquetas y seguimiento?
A veces, pero no debe darse por sentado. Estas funciones pueden ser productos separados o requerir permisos de cuenta diferentes. Confirme cada capacidad, servicio, país y requisito de credenciales en la documentación vigente del transportista.
¿Una API para múltiples transportistas es siempre mejor que una integración directa?
No. Una API para múltiples transportistas puede reducir el trabajo de ingeniería cuando necesita flujos de trabajo comunes para varios transportistas, pero una integración directa puede ofrecer un mejor acceso a funciones específicas del transportista o a controles de la cuenta. La mejor opción depende de las funciones que necesita y del costo de mantenimiento que puede asumir.
¿Necesito una cuenta de transportista para utilizar una API de envíos?
A menudo sí, especialmente para la creación de etiquetas, el franqueo, la facturación o las tarifas negociadas. Los requisitos varían según el transportista, el producto, el país y el proveedor. Confirme las reglas comerciales y técnicas de incorporación antes de crear la integración.
¿Cuál es la diferencia entre los números de seguimiento y los ID de envío?
Un número de seguimiento es el identificador utilizado para seguir un paquete a través de la red de un transportista. Un ID de envío puede identificar una transacción, un grupo de paquetes, una solicitud de etiqueta o un registro interno. Un envío puede contener varios paquetes, por lo que su modelo de datos no debe asumir que un pedido siempre equivale a un solo número de seguimiento.
¿Cómo debe elegir un equipo entre UPS, FedEx, USPS y DHL?
Comience por las rutas, los servicios, los perfiles de paquetes, las condiciones de la cuenta y las funciones de API necesarias, en lugar de elegir únicamente por la marca. Después, pruebe la documentación y las respuestas reales del transportista para los escenarios nacionales e internacionales más comunes.
