Proveedor de operador logístico integral 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 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 facturación.
Para obtener más información sobre las funciones de usuario, consulte las Directrices de administración de la organización.
1. Seleccione Crear una organización o unirse a una existente en la barra de navegación.
2. Introduzca los siguientes datos:
- En Trabajo para una empresa que, seleccione Comercializa o proporciona una solución de software que utiliza tecnología de FedEx y me gustaría registrarla como proveedor de operadores logísticos integrales de FedEx validado
- 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.
- Introduzca un e-mail oficial que incluya el dominio de su empresa, el país o territorio donde se ha constituido, y los países y territorios donde vende o distribuye su solución de software.
3. Seleccione Siguiente.
Puede actualizar o añadir detalles más tarde en Administrar organización en el menú.
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 de FedEx, seleccione Abrir cuenta de facturación para abrir una nueva o comuníquese con el servicio de asistencia FedEx.
Nota: Debe utilizar su número de cuenta, no el número de cuenta FedEx de un cliente.
2. Seleccione Añadir cuenta de facturación.
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.
Nota: La dirección de facturación debe coincidir con la dirección que utilizó durante la configuración de la cuenta. Esta cuenta pasará a ser la cuenta de facturación predeterminada de su organización.
4. Elija una opción de autenticación.
- La llamada telefónica está disponible solo para operadores logísticos integrales en Estados Unidos y Canadá.
5. Introduzca el código de autenticación que reciba y seleccione Enviar.
6. Lea y acepte el Acuerdo de operadores logísticos integrales de FedEx.
Invitar a usuarios como administrador
1. Vaya a Administrar organización y seleccione la pestaña Usuarios.
2. Seleccione + Añadir usuarios.
3. Introduzca los siguientes detalles:
- País o territorio
- Idioma preferido
4. Seleccione una función de usuario: Espectador, Colaborador o Administrador.
5. (Opcional) Asigne el usuario a un proyecto.
- Puede asignar un usuario en cualquier momento desde la página de resumen del proyecto.
6. 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. La invitación tiene una validez de 24 horas.
Crear un proyecto
1. Vaya a la página Mis proyectos del menú y seleccione + Crear un proyecto.
2. Introduzca un nombre de proyecto.
- Se recomienda seguir el formato Nombreproyecto_nombreaplicación. Haga clic en Siguiente.
3. Seleccione las API y los productos de Advanced Integrated Visibility que se van a incluir en su proyecto.
- Los productos de Advanced Integrated Visibility solo están disponibles para proveedores de operadores logísticos integrales FedEx de EE. UU.
- Si selecciona algún producto de pago, se le pedirá que asigne una cuenta de facturación al proyecto y que acepte los términos pertinentes.
Asignar una cuenta de facturación
Nota: Esto solo es obligatorio si selecciona un producto de pago.
1. Asigne una cuenta de facturación de la lista de cuentas añadidas a la organización. Las cuentas de facturación deben estar domiciliadas en Estados Unidos.
2. Acepte el acuerdo de licencia de FedEx Developer Portal y el formulario de pedido, y seleccione Crear.
Configurar Advanced Integrated Visibility en un proyecto
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 el formulario de pedido 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.
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. 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.
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.
Para trasladar sus API a producción, tienen que estar validadas. El nivel de validación varía en función de la API. Consulte 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. Identifique casos de prueba para las regiones o los territorios donde pretende implementar su solución. Para obtener más información, consulte la Referencia de casos de prueba del operador logístico integral.
4. Complete las transacciones de registro usando los números de cuenta de prueba proporcionados antes de ejecutar los casos de prueba.
5. Complete todos los casos de prueba obligatorios.
6. Complete el documento de información sobre el producto (PIW) con sus datos de contacto y los servicios de FedEx.
7. Complete la Portada de validación de operadores logísticos integrales.
Enviar documentación necesaria
Envíe todos los documentos requeridos a validationmtp@fedex.com.
1. Prepare la siguiente documentación necesaria:
- Documento PIW completado (PDF)
- Portada de validación de operadores logísticos integrales completada (PDF)
- Transacciones de registro de clientes finales con autenticación multifactor (JSON)
- Copia escaneada de las etiquetas de envío para todos los casos de prueba aplicables (PDF o PNG)
- Transacciones de envío para tres formatos de etiqueta: PDF, PNG y ZPL (JSON) (para Shipping API y Rating API pertinentes)
- Capturas de pantalla (PDF) en las que figuren:
- Interfaz para el cliente en la que se vean los servicios FedEx y los servicios de manipulación especial
- Aviso legal
- Acuerdo de licencia de usuario final (EULA)
- El proceso de registro del cliente final
2. Comprima todos los archivos en un solo archivo .zip para evitar restricciones del proveedor de e-mail.
3. Envíe un e-mail con el archivo .zip al equipo de validación.
Prácticas recomendadas para evitar retrasos
Siga estas directrices para reducir el tiempo de revisión:
- Imprima y escanee las etiquetas con un mínimo de 600 DPI. No envíe archivos generados directamente desde las API.
- Si usa una impresora térmica, solicite el tipo de imagen que coincida con su impresora (por ejemplo, ZPLII para impresoras Zebra).
- Para FedEx International Express®, incluya el albarán auxiliar (secundario).
- Incluya una etiqueta para cada paquete en los envíos de múltiples piezas (MPS).
Evaluación de etiquetas
El equipo de validación revisa su envío.
- Si se rechaza, subsane los errores observados y vuelva a enviar la documentación necesaria.
- Si se aprueba, recibirá un e-mail de confirmación. Tras la aprobación, se autorizan sus credenciales de producción para las transacciones de etiqueta de envío.
1. En el menú, seleccione Mis proyectos y, luego, el nombre del proyecto.
2. En la sección API, copie y guarde de forma segura su clave de API de producción y su clave secreta.
Nota: Guarde su clave secreta en un lugar seguro, ya que solo aparece una vez. Si la pierde, puede generar una nueva más tarde.
