Proveedor integrador de FedEx
Requisitos previos
Debes tener una ID de usuario de FedEx para iniciar sesión en el FedEx Developer Portal y crear una organización.
Únete a la organización de tu empresa para colaborar con tu equipo. Si tu empresa no tiene una organización, puedes crear una.
Cómo unirse a una organización existente
1. Solicita una invitación
Pídele al administrador de tu organización que te envíe una invitación. Tienes 24 horas para aceptarla. Si la invitación vence, pídele al administrador que vuelva a enviártela.
2. Acepta la invitación
Inicia sesión con tu ID de usuario y contraseña actuales. Si tu ID de usuario ya está vinculado a otra organización, debes crear uno nuevo.
Cómo crear una organización nueva
Cuando creas una organización, te conviertes en el administrador. Como administrador, puedes invitar a usuarios a unirse a la organización, asignar proyectos y roles de usuario y gestionar cuentas de facturación.
Para obtener más información sobre los roles de usuario, consulta nuestras Pautas de administración de organizaciones.
1. Selecciona Crear o unirse a una organización en la barra de navegación.
2. Ingresa los siguientes datos:
- Para Trabajo para una empresa que, selecciona Vende o proporciona una solución de software que utiliza tecnología de FedEx y me gustaría registrarme como proveedor integrador de FedEx validado.
- Ingresa el nombre de tu empresa, el sitio web de tu empresa y un nombre de organización que tu equipo reconozca, como el nombre de tu empresa, departamento, división o región.
- Ingresa un correo electrónico oficial que incluya el dominio de tu empresa, el país o territorio donde está incorporada, y los países y territorios donde vendes o distribuyes tu solución de software.
3. Selecciona Siguiente.
Puedes actualizar o agregar detalles después en Administrar organización en el menú.
Cómo agregar una cuenta de facturación
1. Selecciona la pestaña Cuentas de facturación. Si no tienes una cuenta de facturación de FedEx, selecciona Abrir cuenta de facturación para abrir una nueva o comunícate con el soporte de FedEx.
Nota: Usa tu número de cuenta; no puede ser el número de cuenta FedEx de un cliente.
2. Selecciona Agregar cuenta de facturación.
3. Ingresa tu número de cuenta de FedEx, un alias de la cuenta y una dirección de facturación de EE. UU. que utilizaste durante la configuración de la cuenta.
Nota: La dirección de facturación debe coincidir con la dirección que utilizaste durante la configuración de la cuenta. Esta cuenta se convierte en la cuenta de facturación predeterminada de tu organización.
4. Elige una opción de autenticación.
- La llamada telefónica está disponible solo para integradores en EE. UU. y Canadá.
5. Ingresa el código de autenticación que recibiste y selecciona Enviar.
6. Lee y acepta el Acuerdo de integrador de FedEx.
Cómo invitar a los usuarios como administrador
1. Dirígete a Administrar organización y selecciona la pestaña de Usuarios.
2. Selecciona + Agregar usuarios.
3. Ingresa los siguientes datos:
- El país o territorio
- El idioma preferido
4. Selecciona un rol de usuario (espectador, colaborador o administrador).
5. (Opcional) Asigna el usuario a un proyecto.
- Puedes asignar usuarios en cualquier momento desde la página Descripción general del proyecto.
6. Ingresa las direcciones de correo electrónico de los usuarios y haz clic en Invitar.
- Puedes invitar hasta 20 usuarios a la vez, separando cada correo electrónico con una coma. La invitación es válida durante 24 horas.
Cómo crear un proyecto
1. Dirígete a Mis proyectos en el menú y selecciona + Crear un proyecto.
2. Ingresa un Nombre de proyecto.
- El formato de nombre recomendado es Nombredeproyecto_nombredeaplicación. Selecciona Siguiente cuando hayas terminado.
3. Selecciona las API y los productos de visibilidad integrada avanzada que deseas incluir en tu proyecto.
- Los productos de visibilidad integrada avanzada solo están disponibles para los proveedores integradores de FedEx en EE. UU.
- Si seleccionas algún producto de pago, se te pedirá que asignes una cuenta de facturación al proyecto y que aceptes los términos requeridos.
Cómo asignar una cuenta de facturación
Nota: Esto solo es necesario si eliges un producto de pago.
1. Asigna una cuenta de facturación de la lista de cuentas agregadas a la organización. Las cuentas de facturación deben tener su sede en EE. UU.
2. Acepta el Acuerdo de licencia y el Formulario de pedido de FedEx Developer Portal y selecciona Crear.
Cómo configurar la visibilidad integrada avanzada en un proyecto
Requisitos previos
- Revisa los precios: a los suscriptores se les cobra una tarifa mensual basada en la cantidad de números de rastreo. Consulta el Formulario de pedido para obtener más información sobre los precios.
- Configura las cuentas: el webhook de la visibilidad de envío requiere una cuenta de facturación con sede en EE. UU. y al menos una cuenta de envío; estos dos tipos de cuentas se excluyen mutuamente. Solo los administradores pueden agregar cuentas de facturación y envío en la página Administrar organización.
1. Crea una URL de destino en tu aplicación o plataforma para recibir devoluciones de llamadas. La URL debe:
- Usar HTTPS
- Excluir el espacio IP RFC1918, fedex.com y sus subdominios y direcciones IP como localhost o 127.0.0.1
2. Genera un token de seguridad para la autenticación. El token debe:
- Contener de 26 a 100 caracteres, al menos una letra mayúscula, al menos una letra minúscula y al menos un número
3. En el menú Mis proyectos, selecciona la pestaña visibilidad integrada avanzada.
4. Selecciona Crear un proyecto de visibilidad integrada avanzada.
5. Selecciona el tipo de usuario:
- Remitente de FedEx: realiza envíos con FedEx y necesita integrar las API de FedEx en sus propias aplicaciones.
- Proveedor de soluciones FedEx Compatible: es un proveedor de soluciones FedEx Compatible certificado.
- Proveedor integrador de FedEx: vende o proporciona una solución de software que utiliza la tecnología de FedEx y es un proveedor integrador de FedEx validado.
6. Selecciona el tipo de suscripción. Puedes suscribirte a los eventos por números de cuenta o números de rastreo.
7. Confirma la cuenta de facturación y selecciona las funciones que deseas, como prueba de entrega, entrega estimada, eventos de rastreo o filtrado basado en eventos.
8. Ingresa los detalles del proyecto.
- Ingresa un nombre de proyecto único y reconocible.
- Ingresa la URL de destino y el token de seguridad que creaste.
- Ingresa una dirección de correo electrónico y el idioma preferido para recibir notificaciones sobre actualizaciones e interrupciones de la visibilidad integrada avanzada.
9. Acepta el Acuerdo de licencia y el Formulario de pedido de FedEx Developer Portal y selecciona Crear.
Nota: Dependiendo del tipo de suscripción que elijas, es posible que tengas pasos adicionales. Para obtener información, consulta nuestra documentación de webhook.
Sigue estos pasos para verificar la integración de la API y confirmar que tu aplicación puede enviar y recibir datos de prueba.
1. En el menú, selecciona Mis proyectos y luego selecciona el Nombre del proyecto.
2. En la pestaña Claves API, en Clave de prueba, busca tus credenciales de prueba.
3. Inicia sesión y descarga la colección JSON de la API usando el botón Descargar esquema JSON en la parte superior de la página de documentación. Revisa solicitudes de ejemplo para los extremos que emplea tu integración.
4. Solicita un token de acceso OAuth para usarlo con cada transacción de API. El token es válido por una hora, y puedes configurar tu aplicación para que la actualice antes de que caduque. Para obtener más información, consulta la documentación sobre la API Authorization.
5. Desde el menú, selecciona Catálogo de API, elige la API con la que quieres trabajar y selecciona Documentación.
6. En el menú, selecciona el extremo.
7. Envía solicitudes de muestra utilizando tus credenciales de prueba y la URL de prueba de FedEx, luego confirma que las respuestas coincidan con los ejemplos de la documentación. Para obtener más información, consulta la Guía de virtualización de Sandbox.
8. Ejecuta pruebas con la visibilidad integrada avanzada para generar datos de muestra y confirmar que tu aplicación procese la información de rastreo correctamente.
Nota: Las pruebas no autentican tu URL de devolución de llamada. Para obtener más información, consulta la documentación de la visibilidad integrada avanzada.
Los pasos de validación varían según la región
Los siguientes pasos se aplican solo para clientes en EE. UU. y Canadá. Si vives fuera de estos países, visita la página Validación de API para obtener ayuda.
Para pasar tus API a producción, deben estar validadas. El nivel de validación varía según la API. Revisa los requisitos de validación de la API antes de empezar.
1. En el menú, selecciona Mis proyectos y luego selecciona el Nombre del proyecto.
2. En la pestaña Claves API, en Clave de prueba, busca tus credenciales de prueba.
3. Identifica los casos de prueba para las regiones o territorios donde planeas implementar tu solución. Para obtener más información, consulta Base de referencia del caso de prueba del integrador.
4. Completa las transacciones de registro usando los números de cuenta de prueba proporcionados antes de ejecutar los casos de prueba.
5. Completa todos los casos de prueba requeridos.
6. Completa la Hoja de trabajo de información del producto (PIW) con tu información de contacto y tu elección de servicios de FedEx.
7. Completa la portada de validación del integrador.
Envía los entregables
Envía todos los materiales necesarios a validationmtp@fedex.com.
1. Prepara los siguientes entregables:
- PIW completa (PDF)
- Portada de validación completa (PDF)
- Transacciones de registro de clientes finales con autenticación de múltiples factores (JSON)
- Etiquetas de envío escaneadas 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 las API de envío y de tarifas aplicables
- Capturas de pantalla (PDF) que muestran:
- Solución orientada al cliente que muestra los servicios de FedEx y el manejo especial
- Declaración de descargo de responsabilidad
- Acuerdo de licencia del usuario final (EULA)
- Flujo de registro del cliente final
2. Comprime todos los archivos en un solo archivo .zip para evitar las restricciones del proveedor de correo electrónico.
3. Envía el archivo .zip por correo electrónico al equipo de validación.
Prácticas recomendadas para evitar retrasos
Sigue estas pautas para reducir el tiempo de revisión:
- Imprime y escanea las etiquetas con un mínimo de 600 DPI. No envíes archivos generados directamente desde las API.
- Para impresoras térmicas, solicita el tipo de imagen que sea compatible con tu impresora, por ejemplo, ZPLII para impresoras Zebra.
- Para FedEx International Express®, incluye la guía aérea (AWB) auxiliar (secundaria).
- Incluye una etiqueta para cada paquete en envíos de piezas múltiples (MPS).
Evaluación de la etiqueta
El equipo de Validación revisa lo que envías.
- Si se rechaza, aborda los comentarios y vuelve a enviar los entregables.
- Si se aprueba, recibirás un correo electrónico de confirmación. Después de la aprobación, tus credenciales de producción están autorizadas para las transacciones de etiquetas de envío.
1. En el menú, selecciona Mis proyectos y luego selecciona el Nombre del proyecto.
2. En la sección API, copia y almacena de forma segura tu clave de API de producción y tu clave secreta.
Nota: Guarda tu clave secreta en una ubicación segura ya que solo aparece una vez. Si la pierdes, puedes generar una nueva más tarde.
