Remitente de FedEx
Requisito previo
Debe tener un ID de usuario de FedEx para iniciar sesión en FedEx Developer Portal y crear una organización.
Únase a la organización de su empresa para colaborar con su equipo. Si su empresa no tiene una organización, puede crear una.
Unirse a una organización existente
1. Solicite una invitación
Pida al administrador de su organización que le mande una invitación. Tiene 24 horas para aceptarla. Si la invitación caduca, pida al administrador que la reenvíe.
2. Acepte la invitación
Inicie sesión con su ID de usuario y contraseña actuales. Si su ID de usuario está asociado a otra organización, cree un ID nuevo.
Crear una nueva organización
Si crea una organización, usted pasa a ser el administrador. Como administrador, puede invitar a usuarios a unirse a la organización, asignar proyectos y funciones de usuario, y gestionar cuentas de envío.
Para obtener más información sobre las funciones de usuario, consulte las Directrices de administración de la organización.
1. Inicie sesión en FedEx Developer Portal.
2. En el menú, seleccione Mis proyectos y, luego, Crear una organización.
3. Introduzca los siguientes datos:
- En Trabajo para una empresa que, seleccione Empresa que realiza envíos con FedEx y necesita integrar las API de FedEx en sus propias aplicaciones
- Introduzca el nombre de su empresa, el sitio web corporativo y un nombre de organización que su equipo reconozca, como el nombre de su empresa, departamento, división o región.
4. Seleccione Crear.
Puede actualizar o añadir detalles más tarde en Administrar organización en el menú.
Añadir una cuenta de envío
1. Seleccione Añadir cuentas de envío en la opción Añadir cuentas. Si no dispone de una cuenta FedEx, seleccione Crear una cuenta para abrir una nueva o póngase en contacto con el servicio FedEx de asistencia.
2. Seleccione + Añadir cuenta.
3. Introduzca su número de cuenta FedEx, un alias de cuenta y una dirección de facturación que haya utilizado durante la configuración de la cuenta.
4. Acepte el Acuerdo de licencia de usuario final, o reenvíelo a un representante autorizado en su empresa.
Añadir una cuenta de facturación
1. Seleccione la pestaña Cuentas de facturación. Si no dispone de una cuenta de facturación FedEx, seleccione Abrir cuenta de facturación para abrir una nueva o comuníquese con el servicio de asistencia FedEx.
2. Seleccione Añadir cuenta de facturación. Las cuentas de facturación deben estar domiciliadas en Estados Unidos.
3. Introduzca su número de cuenta FedEx, un alias de cuenta y una dirección de facturación en Estados Unidos que haya utilizado durante la configuración de la cuenta.
4. Lea y acepte el Acuerdo de licencia de usuario final.
Invitar a usuarios como administrador
1. En el menú, seleccione Administrar organización y, luego, abra la pestaña Usuarios.
2. Seleccione + Añadir usuarios.
3. Seleccione un país o territorio y un idioma preferido y, luego, elija una función de usuario: espectador, colaborador o administrador.
4. (Opcional) Asigne el usuario a un proyecto. Puede asignar los usuarios en cualquier momento desde la página de resumen del proyecto.
5. Introduzca las direcciones de e-mail de los usuarios y haga clic en Invitar. Puede invitar como máximo a 20 usuarios a la vez, con las direcciones de e-mail separadas por comas. Las invitaciones tienen una validez de 24 horas.
Crear un proyecto de API
1. En el menú, seleccione Mis proyectos, abra la pestaña API y elija la opción + Crear proyecto de API.
2. Confirme sus requisitos de API.
3. Seleccione las API que quiere incluir en su proyecto.
4. Cree un nombre para el proyecto y seleccione los países a los que pretende realizar envíos para recibir una cuenta de envío de prueba. Para los envíos nacionales dentro de Europa, se requiere una cuenta de prueba distinta para cada país. Puede añadir o eliminar países posteriormente.
5. Acceda a Configuración dentro de la sección Notificaciones para establecer sus preferencias de notificación.
6. Lea y acepte los términos y condiciones.
Crear un proyecto de Advanced Integrated Visibility
Requisitos previos
- Revisar los precios: a los suscriptores se les cobra una tarifa mensual en función de la cantidad de números de seguimiento. Consulte la Guía de precios para obtener más información sobre los precios.
- Configurar cuentas: el Shipment Visibility Webhook exige disponer de una cuenta de facturación y, como mínimo, una cuenta de envío de Estados Unidos; estos dos tipos de cuenta se excluyen mutuamente. Únicamente los administradores pueden añadir cuentas de facturación y envío en la página Administrar organización.
1. Cree una URL de destino en su aplicación o plataforma para recibir callbacks. La URL debe:
- Usar HTTPS
- No incluir la dirección IP RFC1918, fedex.com ni sus subdominios, ni direcciones IP, como localhost o 127.0.0.1
2. Genere un token de seguridad para la autenticación. El token debe:
- Contener entre 26 y 100 caracteres, como mínimo una letra mayúscula, una letra minúscula y un número
3. Abra el menú Mis proyectos y, luego, seleccione la pestaña Advanced Integrated Visibility.
4. Seleccione Crear un proyecto de Advanced Integrated Visibility.
5. Seleccione el tipo de usuario:
- Remitente FedEx: empresa que realiza envíos con FedEx y necesita integrar las API de FedEx en sus propias aplicaciones
- Proveedor certificado FedEx Compatible: es un proveedor de soluciones compatibles de FedEx
- Proveedor de operador logístico integral FedEx: comercializa o proporciona una solución de software que utiliza tecnología de FedEx y está validado como operador logístico integral de FedEx
6. Seleccione el tipo de suscripción. Puede suscribirse a los eventos por números de cuenta o números de seguimiento.
7. Confirme la cuenta de facturación y seleccione las funciones que desea, como prueba de entrega, entrega estimada, eventos de seguimiento o filtrado basado en eventos.
8. Introduzca los detalles del proyecto.
- Introduzca un nombre de proyecto único y reconocible.
- Introduzca la URL de destino y el token de seguridad que haya creado.
- Introduzca una dirección de e-mail y el idioma preferido para recibir notificaciones sobre actualizaciones e interrupciones de Advanced Integrated Visibility.
9. Acepte el acuerdo de licencia de FedEx Developer Portal y el formulario de pedido, y seleccione Crear.
Nota: Dependiendo del tipo de suscripción seleccionada, se podrían exigir más pasos. Consulte nuestra documentación sobre webhooks para obtener más información.
Siga estos pasos para verificar su integración de API y confirmar que su aplicación puede enviar y recibir datos de prueba.
Recuperar credenciales de prueba
1. En el menú, seleccione Mis proyectos y, luego, el nombre del proyecto.
2. Abra la pestaña Claves de API; en Clave de prueba encontrará sus credenciales de prueba.
3. Inicie sesión y descargue la colección de JSON API utilizando el botón Descargar esquema JSON situado en la parte superior de la página de documentación. Revise solicitudes de muestra para los puntos de conexión que utiliza su integración.
4. Solicite un token de acceso OAuth para utilizarlo con cada transacción de API.
Nota: El token tiene una validez de una hora y puede configurar su aplicación para actualizarlo antes de que caduque. Consulte la Documentación de API Authorization para obtener más información.
5. En el menú, seleccione Catálogo de API, elija la API con la que desea trabajar y seleccione Documentación.
6. En el menú, seleccione el punto de conexión.
7. Envíe solicitudes de muestra utilizando sus credenciales de prueba y la URL FedEx de prueba y, a continuación, confirme que las respuestas coinciden con los ejemplos de la documentación. Consulte la Guía de virtualización del entorno de pruebas para obtener más información.
8. Ejecute pruebas con Advanced Integrated Visibility para generar datos de muestra y confirmar si su aplicación procesa la información de seguimiento correctamente.
Nota: Las pruebas no autentican su URL de callback. Consulte la documentación de Advanced Integrated Visibility para obtener más información.
Trasladar su proyecto a producción
Configure los ajustes de producción antes de la puesta en marcha. Puede cambiar el nombre de la clave, agregar más cuentas cuando el proyecto entre en funcionamiento y revisar el número de cuenta seleccionado durante la creación del proyecto. Este número de cuenta es el que habilita el paso del proyecto a producción.
Nota: Los proyectos de Advanced Integrated Visibility basados en el número de cuenta no requieren activación de producción.
1. En el menú, seleccione Mis proyectos y, luego, el nombre del proyecto.
2. Seleccione la pestaña Clave de producción.
3. Recupere sus credenciales de producción y consérvelas en un lugar seguro.
- Copie la clave de API de producción y la clave secreta en un lugar seguro.
- Cuando solicite una clave de producción, guárdela en un lugar seguro, ya que solo aparece una vez. Si la pierde, puede generar una nueva.
4. Seleccione Siguiente para ver los detalles de su proyecto en la pestaña Clave de producción.
Para añadir más cuentas de envío, seleccione la opción Editar que aparece en la parte superior de la tabla de cuentas de envío.
Los pasos de validación varían en función de la región
Los pasos siguientes son únicamente para clientes de Estados Unidos y Canadá. Si vive en otro país, visite la página Validación de API para obtener ayuda.
Validar su API
Algunas API de FedEx requieren la validación de las etiquetas de envío antes de poder utilizarlas en producción. Revise los requisitos de validación de la API antes de comenzar.
1. En el menú, seleccione Mis proyectos y, luego, el nombre del proyecto.
2. Abra la pestaña Claves de API; en Clave de prueba encontrará sus credenciales de prueba.
3. Una vez finalizadas las pruebas, traslade su proyecto a producción en FedEx Developer Portal para comenzar la validación.
- Cuando solicite una clave de producción, guárdela en un lugar seguro, ya que solo aparece una vez. Si la pierde, puede generar una nueva.
4. Indique la información necesaria en la portada de la etiqueta, incluida la información de contacto, los servicios que pretende implementar, el número de cuenta y la clave de API de producción.
5. Cree etiquetas de prueba en el entorno de pruebas de FedEx y, luego, envíelas al grupo de análisis de códigos de barras de FedEx para su revisión. La evaluación de la etiqueta podría tardar alrededor de tres días laborables.
Recomendaciones para evitar retrasos:
- Imprima y escanee las etiquetas con un mínimo de 600 DPI. No envíe archivos generados directamente desde las API.
- Si utiliza una impresora térmica, solicite el tipo de imagen que coincida con su impresora (por ejemplo, ZPLII para impresoras Zebra).
- Utilice direcciones válidas de remitente y destinatario para las etiquetas de muestra. Cree etiquetas únicamente para los servicios que va a utilizar.
- Para el cobro en la entrega (COD) de FedEx, incluya la etiqueta de devolución COD.
- Para FedEx International Express®, incluya el albarán auxiliar (secundario).
- Para los envíos de múltiples piezas (MPS), envíe una etiqueta para cada paquete.
Envíe sus documentos utilizando una de las siguientes opciones:
- Envíe un e-mail con el PDF y la portada de la etiqueta a label@fedex.com.
- Envíe las etiquetas físicas a:
FedEx Services
WTC-Business Solutions Testing
10 FedEx Parkway
2nd Floor Horizontal
Collierville, TN 38017
Nota: En el caso de las etiquetas físicas, asegúrese de que no presenten defectos visibles, como líneas de tinta o daños. No amplíe ni reduzca las etiquetas al imprimirlas.
6. El equipo de análisis de códigos de barras de FedEx evalúa las etiquetas enviadas y determina su aprobación o rechazo. Si las etiquetas se rechazan, subsane los errores observados y vuelva a enviarlas.
7. Tras la aprobación, el equipo de análisis de códigos de barras de FedEx le enviará un e-mail una vez que se hayan autorizado sus credenciales de producción para las transacciones de etiquetas de envío.
Nota: La aprobación se aplica por proyecto. Cada nuevo proyecto requiere aprobación.
8. Sustituya las URL y las credenciales de prueba por las URL y las credenciales de producción.
9. Ejecute una prueba de producción final con datos de muestra para confirmar si todo funciona según lo previsto.
