Migración de API de transportistas: USPS, FedEx y UPS

Entre 2023 y 2026, los tres principales transportistas de paquetería de EE. UU. cambiaron la forma en que el software se conecta con ellos. UPS reemplazó sus claves de acceso por OAuth 2.0, USPS retiró sus API Web Tools de larga trayectoria y FedEx fijó una fecha límite para pasar de sus Web Services heredados a las API REST. Cada cambio es razonable por sí solo; juntos significan que un plugin de envíos instalado hace unos años puede haber dejado de devolver tarifas o de imprimir etiquetas con muy poco aviso. Esta guía resume qué cambió y recorre una lista de verificación de migración de API de transportistas para tiendas en línea.

Qué cambió en cada transportista

Las fuentes oficiales son la guía de migración a OAuth de UPS, el portal para desarrolladores de las API de USPS y el anuncio de migración de FedEx. El retiro de USPS Web Tools afecta a más que las tarifas y las etiquetas: la validación de direcciones, el seguimiento y los plazos de entrega también pasaron a la nueva plataforma.

Señales de que su plugin de envíos dejó de funcionar

Las fallas no siempre son ruidosas. Esté atento a lo siguiente:

• El proceso de pago ofrece solo una tarifa fija de respaldo, o muestra "no hay métodos de envío disponibles" para direcciones que antes funcionaban.
• La creación de etiquetas falla en el panel de administración, o las etiquetas se imprimen para un transportista y no para otro.
• Los números de seguimiento dejan de actualizarse, o los correos de envío salen sin un enlace de seguimiento.
• Los registros de errores muestran errores de autenticación (respuestas 401 o 403) o conexiones fallidas a las direcciones de los transportistas.

La versión silenciosa es la más costosa: una tarifa de respaldo que parece normal pero está muy por debajo de lo que factura el transportista. Cuando el plugin de envío dejó de funcionar de esta manera, la pérdida aparece semanas después en la factura del transportista y no en el proceso de pago.

Una lista de verificación para la migración de API de transportistas

1. Haga una lista de cada sistema que se comunica con un transportista: la extensión de envíos de la tienda, el software de etiquetas, el ERP o el sistema del almacén, las herramientas de marketplaces y cualquier script personalizado. Las integraciones antiguas tienden a esconderse en los dos últimos.
2. Cree cuentas de desarrollador y aplicaciones con las cuentas de transportista de la propia empresa, no con el acceso personal de un desarrollador, y anote quién es el propietario.
3. Guarde las credenciales en el servidor, fuera del repositorio de código, y asegúrese de que la integración solicite y renueve sus propios tokens de acceso en lugar de depender de una clave pegada una sola vez.
4. Actualice o reemplace el conector. Un conector de envíos actual para FedEx y UPS puede ser una versión nueva de su plugin, otra extensión o una plataforma de envíos multitransportista. Confirme que llame a las API nuevas y no a una capa de compatibilidad sobre las antiguas.
5. Pruebe en los entornos de pruebas (sandbox) de los transportistas, y luego compare las cotizaciones en vivo con las tarifas negociadas de su cuenta y con algunas facturas recientes.
6. Revise las etiquetas y la documentación: formato térmico (ZPL) o PDF, datos aduaneros para paquetes internacionales, etiquetas de devolución.
7. Vuelva a probar la validación de direcciones, incluida la clasificación comercial frente a residencial, que cambia el precio.

Nuestro trabajo de integración de API de envíos y automatización logística cubre estos pasos, desde proteger las credenciales de los transportistas hasta los envíos de prueba en un entorno de staging antes de que salgan paquetes reales.

Cómo mantenerlo funcionando: un monitor de API de envíos sencillo

Las interfaces de los transportistas seguirán cambiando, así que incorpore una alerta temprana. Un monitor de API de envíos básico solicita una tarifa para una dirección y un paquete conocidos cada hora más o menos y avisa a alguien cuando la solicitud falla o el precio cambia bruscamente. Agregue alertas sobre la tasa de solicitudes de etiquetas fallidas, un recordatorio en el calendario para toda credencial que venza y una suscripción a los anuncios para desarrolladores de cada transportista. Nada de esto es complicado, y convierte el próximo aviso de retiro en una tarea planificada y no en una sorpresa de lunes por la mañana.

¿Integración directa o plataforma de envíos?

Conectar la tienda directamente con cada transportista da el máximo control y no tiene cargos de plataforma por etiqueta, pero cada cambio de un transportista recae en usted. Las plataformas multitransportista como ShipStation, Shippo o EasyPost absorben esos cambios y agregan etiquetas por lotes y reglas de automatización, a cambio de una suscripción o una tarifa por etiqueta y un sistema más en la cadena. Las tiendas con un solo transportista y reglas sencillas suelen funcionar bien con una conexión directa; las que envían con varios transportistas o desde varias ubicaciones normalmente se benefician de una plataforma. De cualquier modo, unos buenos servicios de integración de API de envíos deben dejarle credenciales documentadas, registros y un monitor, no solo un proceso de pago que funcione.

Preguntas frecuentes: migración de API de transportistas

¿Necesitamos una cuenta nueva de transportista para usar las API nuevas?

No. Usted conserva su cuenta de envíos y crea una aplicación en el portal para desarrolladores del transportista que se vincula con ella. Las credenciales de la aplicación son las que usa la integración.

¿Seguirán apareciendo nuestras tarifas negociadas en el proceso de pago?

Solo si las solicitudes de tarifas se hacen con su propia cuenta. Un conector que use credenciales genéricas o tarifas de lista mostrará los precios publicados.

Se nos pasó una fecha límite. ¿Y ahora qué?

Averigüe qué sistemas siguen llamando a las interfaces antiguas, cambie el proceso de pago a una tarifa fija segura si las tarifas en vivo están fallando y arregle primero la conexión que imprime las etiquetas, porque es lo que impide que los pedidos se envíen. Después migre el resto.

¿Faltan tarifas en el proceso de pago o fallan las etiquetas después de un cambio de un transportista? Nuestro servicio de integración de API de envíos conecta las tiendas con FedEx, UPS, USPS y plataformas de envío, con tarifas en tiempo real, etiquetas por lotes y seguimiento que se escribe de vuelta en la tienda. Si además las existencias y los pedidos deben llegar a un ERP, consulte la integración de ERP y PIM. Contáctenos con su plataforma, sus transportistas y el plugin que usa hoy, y revisaremos qué debe cambiar.