Explorar la guía›

VedronERP · Envíos y transportistas

Integración FedEx

FedEx ofrece envíos internacionales y exprés a todo el mundo. La integración utiliza la API FedEx Ship v1 (REST) con autenticación OAuth2 para crear envíos, generar etiquetas PDF y producir documentos de aduanas para destinos fuera de la UE.

Paso 1 — Crear una cuenta de desarrollador de FedEx

  1. Ve a developer.fedex.com y haz clic en 'Sign Up' (o inicia sesión si ya tienes una cuenta de FedEx.com).
  2. Crea o únete a la Organization de tu empresa en el portal.
  3. Haz clic en 'My Projects' → 'Create a Project'.
  4. Selecciona 'Ship API' (y, opcionalmente, 'Track API') del catálogo de API.
  5. Introduce tu Número de cuenta de FedEx cuando se te solicite — esto vincula la facturación a tu proyecto.
  6. Completa la configuración del proyecto para recibir tus credenciales de prueba (sandbox).

Paso 2 — Obtener tus credenciales de API

Después de crear el proyecto, ve a la página de resumen del proyecto y abre la pestaña 'API credentials'. Encontrarás:

  • [API Key] — también llamada Client ID. Identifica tu aplicación.
  • [Secret Key] — también llamada Client Secret. IMPORTANTE: se muestra solo una vez. Cópiala y guárdala de inmediato — si la pierdes, deberás regenerarla.
  • [Account Number] — tu número de cuenta de facturación de FedEx de 9 dígitos. Aparece por separado en el resumen del proyecto.

Warning: La Secret Key se muestra solo una vez al generarse por primera vez. Guárdala de inmediato en una ubicación segura. Si la pierdes, tendrás que regenerarla y actualizar todos los sistemas que la utilicen.

Paso 3 — Entorno de prueba (Sandbox)

FedEx ofrece un entorno sandbox para pruebas. El sandbox utiliza credenciales de prueba independientes (también mostradas en tu proyecto) y la URL base apis-sandbox.fedex.com. Usa el sandbox para verificar que tu integración produce etiquetas válidas antes de pasar a producción.

Paso 4 — Certificación de producción

FedEx exige un proceso de validación antes de poder imprimir etiquetas de producción reales. Esto incluye:

  1. Enviar a FedEx una hoja de información del producto (Product Information Worksheet) y una hoja de portada de validación (Validation Cover Sheet).
  2. Proporcionar etiquetas de muestra generadas durante las pruebas para la revisión de códigos de barras.
  3. El Bar Code Analysis Group de FedEx revisa las etiquetas en un plazo de 3 días laborables.
  4. Una vez aprobado, tu proyecto pasa al estado de Producción.
  5. Recupera tu API Key y Secret Key de producción desde la página de resumen del proyecto.

Paso 5 — Configurar credenciales en el ERP

Ve a la página de credenciales, selecciona FedEx e introduce los siguientes campos:

  • [API Key] — tu API Key de producción (Client ID) del FedEx Developer Portal.
  • [Secret Key] — tu Secret Key de producción (Client Secret).
  • [Account Number] — tu número de cuenta de facturación de FedEx de 9 dígitos.
  • [Sender Name] — el nombre impreso en la etiqueta como remitente.
  • [Sender Company] — el nombre de tu empresa.
  • [Sender Street] — tu dirección de expedición.
  • [Sender Postal Code] — el código postal de expedición.
  • [Sender City] — la ciudad de expedición.
  • [Sender Country] — el código de país de 2 letras (p. ej., DE, NL, PL).
  • [Sender Phone] — teléfono de contacto del remitente.
  • [Sender Email] — correo electrónico de contacto del remitente.

Crear un envío de FedEx

  1. Abre el pedido que deseas enviar.
  2. Haz clic en 'Crear envío' y selecciona FedEx como transportista.
  3. Verifica el nombre del destinatario, la dirección, la ciudad, el código postal y el país.
  4. Introduce el peso del paquete en KG.
  5. Opcionalmente, introduce las dimensiones (largo, ancho y alto en cm).
  6. Selecciona el tipo de servicio de FedEx (ver más abajo).
  7. Selecciona el tipo de recogida: 'Drop off at FedEx location' o 'Scheduled pickup'.
  8. Para envíos fuera de la UE, rellena los datos de la declaración de aduanas.
  9. Haz clic en 'Crear envío' para enviar la solicitud.
  10. Descarga la etiqueta PDF (formato de 4x6 pulgadas) e imprímela.

Tipos de servicio de FedEx disponibles

  • INTERNATIONAL_PRIORITY — Servicio internacional más rápido, entrega en plazo garantizado
  • INTERNATIONAL_ECONOMY — Servicio internacional económico, entrega en día determinado
  • EUROPE_FIRST_INTERNATIONAL_PRIORITY — Entrega prioritaria a destinos europeos antes de las 9:00 o 10:00 AM
  • FEDEX_EXPRESS_SAVER — Exprés económico dentro de Europa/internacional
  • PRIORITY_OVERNIGHT — Entrega al día hábil siguiente antes de las 10:30 AM (EE. UU. y mercados seleccionados)
  • FEDEX_GROUND — Entrega terrestre (EE. UU., Canadá)
  • FEDEX_2_DAY — Entrega en 2 días hábiles (EE. UU. y mercados seleccionados)

Documentación de aduanas (envíos fuera de la UE)

Para envíos a destinos fuera de la UE (p. ej., Reino Unido, EE. UU., Suiza, Noruega), se requieren una factura comercial y una declaración de aduanas. El ERP te solicitará los siguientes datos adicionales:

  • Descripción de la mercancía — qué contiene el paquete (p. ej., 'componentes electrónicos', 'accesorios')
  • Código HS/arancelario — el código del Sistema Armonizado para las mercancías (busca el código correcto para tu categoría de producto)
  • País de fabricación — dónde se produjeron las mercancías
  • Valor declarado — valor por unidad en la moneda del envío
  • Número de bultos — cantidad
  • Pago de aranceles — normalmente 'SENDER' (usted paga) o 'RECIPIENT' (el cliente paga)

Tip: Para los exportadores de la UE, es posible que también necesite su número EORI para el cumplimiento aduanero al exportar fuera de la UE. Contacte con FedEx o su agente de aduanas si tiene dudas.

Token OAuth y autenticación

El ERP gestiona automáticamente la autenticación OAuth2. Utiliza su API Key y Secret Key para solicitar un token de acceso a FedEx (válido durante 1 hora) y lo renueva antes de cada solicitud de envío. No se requiere ninguna gestión manual de tokens.

Warning: Si ve errores de autenticación (401 Unauthorized), es posible que sus credenciales se hayan regenerado en el FedEx Developer Portal. Actualice la API Key y la Secret Key en la página de credenciales del ERP.