Conectar FedEx: tarifas en vivo, etiquetas y rastreo

Obtenga la API Key y la Secret Key de su proyecto en FedEx Developer Portal y su FedEx Account Number de 9 dígitos, péguelos en Integration, pruebe, mapee servicios y empiece a cotizar y enviar.

El conector de FedEx obtiene tarifas en vivo, compra etiquetas, rastrea envíos y anula etiquetas mediante la API de FedEx, todo contra su propia cuenta FedEx. Tarifas y cargos de etiquetas se facturan al FedEx Account Number que complete.

Requisitos previos#

• Una cuenta FedEx con un FedEx Account Number de 9 dígitos: tarifas y etiquetas se facturan a esta cuenta.
• Acceso a FedEx Developer Portal → My Projects, donde se muestran la API Key y la Secret Key de su proyecto.
• Decida primero el entorno: complete sandbox con true para probar en el sandbox, o déjelo en blanco para producción. Las credenciales de sandbox y producción no se mezclan: use las del entorno elegido.

Obtener credenciales#

1. Obtenga la API Key: vaya a FedEx Developer Portal → My Projects → su proyecto → API Key. Esta API Key es el OAuth Client ID de su proyecto: cópiela tal cual se muestra.
2. Obtenga la Secret Key: en el mismo proyecto, abra Secret Key: es el OAuth Client Secret. El valor completo solo se muestra completo al generarlo, así que guárdelo en un lugar seguro de inmediato. Si lo pierde, genere uno nuevo en el portal.
3. Obtenga el FedEx Account Number: vaya a fedex.com → My Profile → Account Management y copie su número de cuenta de envío de 9 dígitos. Tarifas y etiquetas se facturarán a esta cuenta.
4. Advertencia: mantenga los proyectos separados. Track y Rate / Ship pueden pertenecer a dos proyectos separados de Developer Portal, cada uno con su propia API Key y Secret Key. Para una conexión, use siempre la API Key y la Secret Key del mismo proyecto. Mezclar la Key de un proyecto con el Secret del otro fallará.

Completar en Integration#

1. Abra Integration → Marketplace → FedEx → Nueva conexión.
2. API Key: pegue la API Key de FedEx Developer Portal → My Projects → su proyecto. Es el OAuth Client ID de ese proyecto. Se guarda como secreto y nunca se muestra.
3. Secret Key: pegue la Secret Key del mismo proyecto. Asegúrese de que coincida con la API Key anterior: no use la Secret Key de otro proyecto, por ejemplo la del proyecto Track cuando esta conexión es para Rate / Ship. Se guarda como secreto y nunca se muestra.
4. FedEx Account Number: complete su número de cuenta de envío de 9 dígitos de fedex.com → My Profile → Account Management, por ejemplo 123456789. Revise cada dígito: la prueba no verifica este número, pero tarifas y etiquetas se facturan a él.
5. Use sandbox, opcional: complete true para usar el sandbox, o déjelo en blanco para producción. Complete true solo junto con credenciales del proyecto sandbox; déjelo en blanco solo junto con credenciales del proyecto de producción.

Probar la conexión#

Haga clic en Probar la conexión. La prueba solo intercambia su API Key y Secret Key por un token OAuth para comprobar que las credenciales funcionan en el entorno elegido. No verifica el FedEx Account Number ni cotiza una tarifa, así que una prueba aprobada solo confirma la Key y el Secret: si el número de cuenta es incorrecto, tarifas y etiquetas aún pueden fallar después. Si la prueba falla, anote el error y revise la FAQ.

Mapping / elegir plantilla#

FedEx no necesita mapping de pedidos: trabaja con paquetes, no con pedidos. Lo que mapea aquí son servicios: mapee cada servicio de FedEx a su servicio interno correspondiente (mapping de servicios) y habilite solo los servicios de FedEx que realmente usa para enviar. La comparación de tarifas y la compra de etiquetas siguen este mapping, así el pedido solo cotiza y compra el servicio previsto.

Activar#

Tras activar, la conexión sirve para comparar tarifas y comprar etiquetas al enviar, las actualizaciones de rastreo vuelven y se registran en el envío, y las etiquetas que ya no necesita pueden anularse por la misma conexión. Vigile los primeros envíos en Runs / Logs, sobre todo la primera cotización y la primera etiqueta, antes de dejarlo sin supervisión.

Preguntas frecuentes#

La prueba falla con 401

La API Key o la Secret Key es incorrecta, o ambas se mezclaron entre proyectos, por ejemplo la API Key del proyecto Rate / Ship con la Secret Key del proyecto Track. FedEx solo acepta una Key y un Secret del mismo proyecto, así que un par mezclado se rechaza.

Abra un solo proyecto en FedEx Developer Portal → My Projects, vuelva a copiar su API Key y su Secret Key de ese mismo proyecto sin espacios extra, reemplace ambos campos y pruebe de nuevo.

Credenciales de sandbox y producción mezcladas

El entorno y las credenciales no coinciden. El campo sandbox indica un entorno, true para sandbox y en blanco para producción, pero la API Key y la Secret Key vienen de un proyecto del otro entorno, así que FedEx rechaza el intercambio de token.

Elija un entorno y haga que todo coincida con él: para probar, ponga Use sandbox en true y complete las credenciales del proyecto sandbox; para envíos reales, deje Use sandbox en blanco y complete las credenciales del proyecto de producción. Luego pruebe de nuevo.

La prueba pasa pero tarifas o etiquetas fallan

El FedEx Account Number es incorrecto. La prueba solo intercambia un token OAuth y nunca verifica el número de cuenta, así que una cuenta mal escrita o equivocada aún pasa la prueba: el fallo solo aparece cuando una tarifa o una etiqueta intenta facturar a esa cuenta.

Verifique la cuenta en fedex.com → My Profile → Account Management, corrija el campo FedEx Account Number con el número exacto de 9 dígitos que se muestra allí y vuelva a intentar la cotización o la etiqueta.

Etiqueta creada pero el rastreo nunca se actualiza

Las actualizaciones de rastreo llegan al ritmo de FedEx, no al instante, así que una etiqueta nueva puede no mostrar movimiento por un tiempo. Si el paquete nunca se entregó a FedEx, tampoco hay aún ningún escaneo que reportar.

Confirme primero que el paquete se entregó a FedEx. Si el rastreo sigue sin mostrar nada después de que el paquete entró en la red de FedEx, revise Runs / Logs en busca de errores de rastreo y confirme que la conexión usada para rastreo tiene la API Key y la Secret Key del proyecto Track, no el par de Rate / Ship.