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
- Ve a developer.fedex.com y haz clic en 'Sign Up' (o inicia sesión si ya tienes una cuenta de FedEx.com).
- Crea o únete a la Organization de tu empresa en el portal.
- Haz clic en 'My Projects' → 'Create a Project'.
- Selecciona 'Ship API' (y, opcionalmente, 'Track API') del catálogo de API.
- Introduce tu Número de cuenta de FedEx cuando se te solicite — esto vincula la facturación a tu proyecto.
- 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:
- Enviar a FedEx una hoja de información del producto (Product Information Worksheet) y una hoja de portada de validación (Validation Cover Sheet).
- Proporcionar etiquetas de muestra generadas durante las pruebas para la revisión de códigos de barras.
- El Bar Code Analysis Group de FedEx revisa las etiquetas en un plazo de 3 días laborables.
- Una vez aprobado, tu proyecto pasa al estado de Producción.
- 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
- Abre el pedido que deseas enviar.
- Haz clic en 'Crear envío' y selecciona FedEx como transportista.
- Verifica el nombre del destinatario, la dirección, la ciudad, el código postal y el país.
- Introduce el peso del paquete en KG.
- Opcionalmente, introduce las dimensiones (largo, ancho y alto en cm).
- Selecciona el tipo de servicio de FedEx (ver más abajo).
- Selecciona el tipo de recogida: 'Drop off at FedEx location' o 'Scheduled pickup'.
- Para envíos fuera de la UE, rellena los datos de la declaración de aduanas.
- Haz clic en 'Crear envío' para enviar la solicitud.
- 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.