Conectar FedEx Freight: obtener tarifas LTL y rastrear envíos de carga
Obtenga un Client ID y un Client Secret en el FedEx Developer Portal, complételos con su número de cuenta Freight en Integration, pruebe primero con credenciales sandbox y luego cambie test_mode a producción para tarifas LTL y rastreo reales.
El conector de FedEx Freight es para carga de menos de un camión completo (LTL). Obtiene cotizaciones de tarifa LTL y rastrea envíos de carga por número de rastreo o número PRO, devolviendo los eventos de escaneo. No crea etiquetas de envío y no es la conexión de paquetería de FedEx: usa sus propios campos y su cuenta de FedEx Freight. La conexión usa el entorno sandbox por defecto, así que lea con atención el paso de prueba antes de pasar a producción.
Requisitos previos#
- Una app en el FedEx Developer Portal, para poder leer su Client ID y su Client Secret.
- Su número de cuenta de FedEx Freight: la cuenta Freight usada para cotización y facturación LTL. Una cuenta de paquetería de FedEx es otra cuenta para esta conexión.
- Una elección clara de entorno para la primera prueba: credenciales sandbox con el entorno sandbox, o credenciales de producción con producción. La conexión usa sandbox por defecto, y las credenciales sandbox y de producción no se mezclan.
- Al menos una ruta real que pueda cotizar, y un número de rastreo o número PRO de un envío de carga anterior, para verificar tarifas y rastreo tras la prueba.
Obtener credenciales#
- Inicie sesión en el FedEx Developer Portal y abra su app.
- En su app, lea el Client ID y el Client Secret. Los dos valores forman un par OAuth2 y van juntos: tome ambos de la misma app.
- Anote su número de cuenta de FedEx Freight, la cuenta Freight usada para cotización y facturación LTL.
- Decida con qué conjunto de credenciales probará primero. Las credenciales sandbox se prueban contra la dirección sandbox https://apis-sandbox.fedex.com; las de producción contra https://apis.fedex.com. Anote qué conjunto eligió: el campo test_mode debe coincidir con él.
Completar en Integration#
- Abra Integration, elija FedEx Freight e inicie una conexión nueva.
- client_id, obligatorio, Client ID: el Client ID de FedEx Developer Portal → su app, con la forma l7xxxxxx y los caracteres siguientes. Cópielo de la misma app que el secreto de abajo.
- client_secret, obligatorio, Client Secret: el Client Secret de la misma app en el FedEx Developer Portal. Se guarda como secreto.
- account_number, obligatorio, Freight Account Number: su número de cuenta de FedEx Freight, por ejemplo con la forma 123456789. Es la cuenta Freight usada para cotización y facturación LTL, no una cuenta de paquetería.
- test_mode, opcional, Test Mode: complete true para usar el entorno sandbox https://apis-sandbox.fedex.com, que también es el valor por defecto cuando el campo queda vacío. Complete false para usar producción https://apis.fedex.com. El valor debe coincidir con las credenciales completadas: credenciales sandbox con true, credenciales de producción con false.
Probar la conexión#
Haga clic en Probar la conexión. Lo que ocurre depende de lo que haya completado. Si falta client_id, client_secret o account_number, la prueba no envía ninguna solicitud a FedEx: ejecuta una comprobación de ensayo local con datos de ejemplo e informa éxito solo para ese ensayo. Lea el detalle del resultado: un éxito de ensayo no prueba sus credenciales. Cuando los tres valores están presentes, la prueba corre de verdad en dos pasos: primero canjea su client_id y client_secret por un token OAuth2, y después envía una llamada pequeña de cotización LTL con su cuenta Freight. Una respuesta 401 o 403 cuenta como fallo de autenticación; otras respuestas del endpoint de cotización cuentan como alcanzable. Un éxito real se lee así: autenticación OAuth2 aprobada para la dirección del entorno, y endpoint de cotización Freight alcanzable. La prueba espera hasta 12 segundos.
Mapping / elegir plantilla#
Elija la plantilla estándar de FedEx Freight para cotización y rastreo LTL. Las cotizaciones salen con su número de cuenta Freight, y las consultas de rastreo aceptan un número de rastreo o un número PRO y devuelven los eventos de escaneo. Tras aprobar la prueba de verdad, haga una cotización en una ruta que conozca y compare la tarifa y el servicio devueltos con lo que espera para esa ruta; después busque un envío anterior por su número PRO y compare los eventos de escaneo. Active solo cuando ambas comprobaciones se vean bien.
Activar#
Tras activar, la conexión obtiene cotizaciones LTL reales con su cuenta Freight y rastrea envíos de carga por número de rastreo o número PRO. Para pasar de la prueba al trabajo real, ponga test_mode en false y asegúrese de que el client_id y el client_secret de la conexión son los valores de su app de producción: una conexión que queda en sandbox sigue devolviendo resultados sandbox. Vigile las primeras cotizaciones y consultas de rastreo en Runs / Logs antes de dejar la conexión sin supervisión.
Lo que esta conexión no hace: no crea ni compra etiquetas de envío, y no gestiona el envío de paquetería de FedEx. Para tarifas y etiquetas de paquetería, use la conexión separada de paquetería de FedEx, con sus propias credenciales y cuenta.
Preguntas frecuentes#
La prueba falla con 401 o 403
FedEx rechazó la autenticación: la solicitud de token OAuth2 o la llamada de cotización fue rechazada con 401 o 403. La conexión trata 401 y 403 como fallo de autenticación, así que el client_id, el client_secret o el entorno al que pertenecen no coincide.
Vuelva a copiar client_id y client_secret desde la misma app en FedEx Developer Portal → su app, revise que test_mode coincide con ese conjunto de credenciales (sandbox con true, producción con false) y pruebe de nuevo.
Las credenciales de producción fallan la prueba enseguida
La conexión sigue apuntando al sandbox. test_mode usa por defecto el entorno sandbox https://apis-sandbox.fedex.com cuando está vacío o en true, y las credenciales de producción no valen en el sandbox: así que un Client ID y un Secret de producción correctos fallan igual.
Ponga test_mode en false para que la prueba corra contra producción https://apis.fedex.com, mantenga el client_id y el client_secret de producción, guarde y pruebe de nuevo. Para probar en el sandbox, mantenga test_mode en true y use credenciales sandbox.
La prueba dice éxito, pero no se hizo ninguna cotización real
Uno de los tres valores obligatorios estaba vacío al probar. Si falta client_id, client_secret o account_number, la prueba no envía ninguna solicitud a FedEx y solo ejecuta una comprobación de ensayo local con datos de ejemplo: su mensaje de éxito dice que la comprobación corrió sin credenciales reales y sin una solicitud real.
Complete los tres valores (client_id y client_secret de FedEx Developer Portal → su app, y su número de cuenta Freight en account_number), guarde y pruebe de nuevo. Solo un éxito que nombra la dirección del entorno y el endpoint de cotización Freight cuenta como prueba real de credenciales.
Las cotizaciones funcionan, pero el rastreo no devuelve nada para un envío
El número usado no es un número de rastreo o número PRO de FedEx Freight para esta cuenta, o el envío aún no tiene eventos de escaneo. El rastreo en esta conexión lee envíos de carga por número de rastreo o número PRO: un número de rastreo de paquetería no devolverá eventos de carga.
Copie el número PRO o el número de rastreo de la documentación de carga de un envío ya recogido, revíselo dígito por dígito y búsquelo de nuevo. Si un envío recogido conocido sigue sin devolver nada, confirme que el envío se movió bajo la misma cuenta Freight que la conexión.
¿Puede esta conexión crear etiquetas de FedEx Freight?
No. Esta conexión cubre solo cotizaciones LTL y rastreo de carga: no hay creación de etiquetas en ella. Buscar un paso de etiquetas en esta conexión no encontrará ninguno, porque el trabajo Freight aquí es cotizar y rastrear.
Use esta conexión para la cotización y el rastreo del envío de carga, y mantenga el trabajo de etiquetas y de reserva en el canal donde contrata la carga. Para etiquetas de paquetería de FedEx, use en su lugar la conexión separada de paquetería de FedEx.