Remitente 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 envío.
Para obtener más información sobre los roles de usuario, consulta nuestras Pautas de administración de organizaciones.
1. Inicia sesión en FedEx Developer Portal.
2. En el menú, selecciona Mis proyectos y luego selecciona Crear una organización.
3. Ingresa los siguientes datos:
- Para la opción Trabajo para una empresa que, selecciona Realiza envíos con FedEx y necesita integrar las API de FedEx en sus propias aplicaciones.
- 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.
4. Selecciona Crear.
Puedes actualizar o agregar detalles después en Administrar organización en el menú.
Cómo agregar una cuenta de envío
1. Selecciona Agregar cuentas de envío en el mosaico Agregar cuentas. Si no tienes una cuenta de FedEx, selecciona Crear una cuenta para abrir una nueva o comunícate con el soporte de FedEx.
2. Selecciona + Agregar cuenta.
3. Ingresa tu número de cuenta de FedEx, un alias de la cuenta y la dirección de facturación que utilizaste al configurar la cuenta.
4. Acepta el Acuerdo de licencia del usuario final o envíaselo a un representante autorizado de tu empresa.
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.
2. Selecciona Agregar cuenta de facturación. Las cuentas de facturación deben tener su sede en EE. UU.
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.
4. Lee y acepta el Acuerdo de licencia del usuario final.
Cómo invitar a los usuarios como administrador
1. En el menú, selecciona Administrar organización y, a continuación, selecciona la pestaña Usuarios.
2. Selecciona + Agregar usuarios.
3. Selecciona un país o territorio y un idioma preferido, luego elige un rol de usuario: espectador, colaborador o administrador.
4. (Opcional) Asigna el usuario a un proyecto. Puedes asignar usuarios en cualquier momento desde la página Descripción general del proyecto.
5. 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. Las invitaciones caducan después de 24 horas.
Cómo crear un proyecto de API
1. En el menú, selecciona Mis proyectos, luego selecciona la pestaña API y elige + Crear proyecto de API.
2. Confirma tus necesidades de API.
3. Selecciona las API que deseas incluir en tu proyecto.
4. Crea un nombre de proyecto y selecciona los países a los que planeas realizar envíos para recibir una cuenta de envío de prueba. Para envíos nacionales europeos, necesitas una cuenta de prueba separada para cada país. Siempre puedes agregar o eliminar países más adelante.
5. Selecciona Configuración en Notificaciones para configurar tus preferencias de notificaciones.
6. Lee y acepta los términos y condiciones.
Cómo crear un proyecto de visibilidad integrada avanzada
Requisitos previos
- Revisa los precios: a los suscriptores se les cobra una tarifa mensual basada en la cantidad de números de rastreo. Consulta la Guía de precios 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 más 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.
Recuperación de credenciales 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.
Nota: 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.
Cómo pasar tu proyecto a producción
Establece tu configuración de producción antes de activarla. Puedes cambiar el nombre de la clave, agregar cuentas adicionales una vez que el proyecto esté activo y revisar el número de cuenta seleccionado durante la creación del proyecto. Este número de cuenta pasa tu proyecto a la producción.
Nota: Los proyectos de la visibilidad integrada avanzada basados en números de cuenta no requieren la activación de producción.
1. En el menú, selecciona Mis proyectos y luego selecciona el Nombre del proyecto.
2. Selecciona la pestaña Clave de producción.
3. Recupera y guarda tus credenciales de producción de forma segura.
- Copia la clave de producción de la API y la clave secreta a una ubicación segura.
- Cuando solicites una clave de producción, guárdala en una ubicación segura ya que solo aparece una vez. Si la pierdes, puedes generar una nueva más tarde.
4. Selecciona Siguiente para ver los detalles de tu proyecto en la pestaña Clave de producción.
Para agregar más cuentas de envío, selecciona Editar en la parte superior de la tabla de cuentas de envío.
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.
Cómo validar tu API
Algunas API de FedEx requieren la validación de la etiqueta de envío antes de que puedas utilizarlas en producción. Revisa los requisitos de validación de 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. Una vez completadas las pruebas, pasa tu proyecto a producción en FedEx Developer Portal para comenzar la validación.
- Cuando solicites una clave de producción, guárdala en una ubicación segura ya que solo aparece una vez. Si la pierdes, puedes generar una nueva más tarde.
4. Proporciona la información requerida en la portada de la etiqueta, incluidos los detalles de contacto, los servicios que planeas implementar, el número de cuenta y la clave de producción de la API.
5. Crea etiquetas de prueba en el entorno de prueba de FedEx y luego envíalas al Grupo de análisis de códigos de barras de FedEx para su revisión. Espera tres días hábiles para la evaluación de la etiqueta.
Prácticas recomendadas para evitar retrasos:
- 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.
- Utiliza direcciones válidas de remitente y destinatario para las etiquetas de muestra. Crea etiquetas solo para los servicios que planeas usar.
- Para el cobro contra entrega (COD) de FedEx, incluye la etiqueta de devolución del COD.
- Para FedEx International Express®, incluye la guía aérea (AWB) auxiliar (secundaria).
- Para los envíos de piezas múltiples (MPS), envía una etiqueta por cada paquete.
Envía tus materiales empleando una de las siguientes opciones:
- Envía por correo electrónico el PDF y la portada de la etiqueta a label@fedex.com.
- Envía las etiquetas físicas a:
FedEx Services
WTC-Business Solutions Testing
10 FedEx Parkway
2nd Floor Horizontal
Collierville, TN 38017
Nota: Para las etiquetas físicas, asegúrate de que no haya defectos visibles, como líneas de tinta o daños. No amplíes ni reduzcas las etiquetas al imprimirlas.
6. El grupo de análisis de código de barras de FedEx revisa tu envío y aprueba o rechaza las etiquetas. Si se rechazan las etiquetas, ten en cuenta los comentarios y vuelve a enviarlas.
7. Después de aprobarlas, el grupo de análisis de código de barras de FedEx te envía un correo electrónico después de autorizar tus credenciales de producción para las transacciones de etiquetas de envío.
Nota: La aprobación es por proyecto. Cada nuevo proyecto requiere aprobación.
8. Reemplaza las URL y credenciales de prueba con tus URL y credenciales de producción.
9. Realiza una prueba final de producción con datos de muestra para confirmar que todo funciona como se espera.
