Comenzar
FedEx Developer Portal le brinda una amplia gama de interfaces de programación de aplicaciones (API), lo que le permite integrar los servicios FedEx en sus aplicaciones. Estas instrucciones le ayudarán a configurar una organización, crear un proyecto, poner a prueba su integración, trasladar un proyecto a producción y, en algunos casos, validar su API.
Tipos de usuarios:
FedEx presta sus servicios de integración a tres tipos de usuario: remitentes de FedEx, proveedores certificados FedEx Compatible y operadores logísticos integrales FedEx.
Remitente de FedEx:
Empresa que realiza envíos con FedEx y necesita integrar las API de FedEx en sus propias aplicaciones.
Proveedor de servicios o soluciones:
Empresa que necesita integrar las API de FedEx para desarrollar una solución, una aplicación o un plugin que pueda venderse o distribuirse a organizaciones externas que envíen con FedEx.
- Proveedor certificado FedEx Compatible: empresa verificada con un acuerdo contractual dentro del programa FedEx Compatible.
- Proveedor de operador logístico integral FedEx: empresa validada con un acuerdo contractual a través del programa de operadores logísticos integrales FedEx.
Seleccione la opción que mejor describa a su empresa. Todos los tipos de usuario disponen de una guía de inicio para los primeros pasos.
Seleccione una de las siguientes opciones para comenzar.
Which of the following best describes your business?
Select user
- FedEx Shipper: Company who integrates FedEx APIs into their own applications.
- FedEx Compatible Provider: Company validated by the FedEx Compatible program who integrates with FedEx APIs to build a solution, application or plugin that can be sold and/or distributed to an external organization.
- FedEx Integrator Provider: Validated company with a contractual agreement through the FedEx Integrator Program.
Requisito previo
Debe tener un ID de usuario de FedEx para iniciar sesión en FedEx Developer Portal y crear una organización.
Si su empresa no tiene una organización, créela; en caso contrario, únase a una que ya exista.
Crear una nueva organización
En la barra de navegación, haga clic en Crear o únase a una organización.
Nota: Como creador, se le designa automáticamente como administrador de la organización.
Los administradores pueden:
Invitar a que los usuarios se unan
Asignar roles de usuario (por ejemplo, colaborador, espectador, etc.) y proyectos.
Gestionar cuentas de envío.
Para obtener más información acerca de estos roles, consulte nuestra Guía de administración de la organización.
Para el tipo de empresa, seleccione «Comercializa o proporciona una solución de software que utiliza la tecnología de FedEx y es un proveedor de operadores logísticos integrales FedEx validado».
Introduzca el nombre de su empresa, la URL del sitio web y un nombre único para la organización. El nombre de la organización puede coincidir con el nombre de su empresa o representar un grupo específico (departamento, división, región, ubicación, etc.). Esta información es necesaria para validar su solicitud.
Nota: Ponga un nombre a su organización reconocible para otros usuarios (por ejemplo, nombre de la empresa, departamento, región, ubicación, etc.).
Especifique la ubicación de su empresa y dónde se venderá o distribuirá su solución de software.
Añadir cuenta de facturación y autenticar cuenta
Nota: Como proveedor de envíos y logística del programa de operadores logísticos integrales FedEx, debe utilizar su propio número de cuenta. No puede usar un número de cuenta FedEx.
Introduzca su número de cuenta FedEx. Si aún no tiene una cuenta FedEx, cree una en fedex.com o póngase en contacto con un representante del servicio FedEx de asistencia.
Especifique un sobrenombre de la cuenta y la dirección de facturación asociada a ella. Seleccione Siguiente.
Nota: La dirección de facturación debe coincidir con la que figura en nuestros registros para esta cuenta. Esta será la cuenta de facturación predeterminada de su organización.
Para terminar de crear su organización, debe autenticar su cuenta. Elija una opción de autenticación (teléfono disponible para operador logístico integral solo en EE. UU. y Canadá, e-mail, mensaje de texto, etc.) y seleccione Siguiente.
Cuando lo haya recibido, introduzca el código de autenticación y seleccione Enviar.
Aceptar las condiciones
Lea el acuerdo de operador logístico integral global y el manual del programa. Marque las casillas para confirmar que acepta las condiciones y, a continuación, haga clic en Aceptar.
Aparecerá una pantalla de confirmación. Haga clic en Gestionar organización para editar los detalles si fuera necesario.
Invitar a usuarios
Nota: Solo los administradores pueden invitar a usuarios.
Seleccione Gestionar organización en el menú de navegación de la izquierda.
Vaya a la pestaña Usuarios y seleccione Añadir usuarios.
Rellene el formulario y asigne el rol pertinente a los nuevos usuarios: espectador, colaborador o administrador.
Para obtener más información sobre los roles de usuarios, consulte la Guía de administración de la organización.
Asigne usuarios a los proyectos, si corresponde, utilizando el menú desplegable Proyectos.
Introduzca las direcciones de e-mail de cada usuario y, a continuación, haga clic en Invitar.
Unirse a una organización existente
Solicite una invitación: pida al administrador de su organización que le mande una invitación. Tiene 24 horas para aceptarla antes de que caduque. Si fuera necesario, pida al administrador que la reenvíe.
Acepte la invitación: inicie sesión con el ID de usuario y la contraseña que ya tiene. Si su ID ya está vinculado a otra organización, debe crear uno nuevo.
Unirse a una organización existente
Paso 1: pedir al administrador de su organización que le mande una invitación
Si su empresa ya ha creado una organización, pida al administrador que le invite a unirse. Tendrá 24 horas para aceptar la invitación. Si se le pasa el plazo, puede pedirle que se la vuelva a enviar.
Paso 2: aceptar la invitación
Para aceptar la invitación, tendrá que iniciar sesión con su ID de usuario y contraseña existentes, o bien crear una nueva en caso de que su ID de usuario actual ya esté asociada a una organización.
Crear un proyecto de API
Vaya a la página Mis proyectos y abra la pestaña API. Haga clic en el botón Crear un proyecto de API.
Paso 1: seleccionar las API que quiera incluir en su proyecto
Revisar cuotas de API, límites de transacciones y detalles de validación de API.
Paso 2: configurar los detalles del proyecto
- Póngale a su proyecto un nombre identificable que sea exclusivo en su organización.
- Seleccione todos los países en los que desea realizar envíos para poder asignarle una cuenta de envío de prueba. Para probar paquetes de envío nacionales en un país europeo, tiene que disponer de una cuenta de prueba independiente para cada país. Podrá añadir/eliminar países posteriormente.
- Para recibir notificaciones sobre las últimas actualizaciones de las API y cualquier información relacionada con las interrupciones, ajuste sus preferencias de notificación.
Paso 3: leer y aceptar los términos, incluido el acuerdo de licencia de FedEx Developer Portal
Tras haber aceptado las condiciones, haga clic en el botón Crear y aparecerá una pantalla de confirmación. Luego podrá ver las credenciales de prueba en su nuevo proyecto.
Crear un proyecto de webhook
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 webhook Advanced Integrated Visibility 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.
Cree una URL (callback) válida en su plataforma o aplicación de destino
En la URL de destino es donde recibirá mensajes y códigos de autenticación, así como las notificaciones de carga útil del webhook de FedEx. La URL deberá utilizar HTTPS para garantizar la seguridad. Su URL se bloqueará si incluye:
- Cualquier dirección IP RFC1918
- fedex.com o alguno de sus subdominios
- URL que contenga direcciones IP (incluyendo localhost, 127.0.0.1)
Generar un token de seguridad
Este token de seguridad puede usarse como clave secreta para autenticar y validar información transmitida entre su organización y FedEx. El token de seguridad deberá tener:
- Una longitud mínima de 26 caracteres y máxima de 100 caracteres
- 1 mayúscula
- 1 minúscula
- 1 número
Ejemplo: Y1F6OiVUQW2JPSElmRE9U0IY5
Una vez definidos la URL y el token de seguridad, ya está todo listo para crear un proyecto de webhook. Vaya a la página Mis proyectos y abra la pestaña Webhooks. Haga clic en el botón Crear un proyecto de webhook.
Seleccionar tipo de suscripción
Los remitentes de FedEx pueden suscribir sus eventos a números de cuenta o de seguimiento.
Paso 1: confirmar la cuenta de facturación y seleccionar las funciones
- Revise el número de cuenta de facturación que aparece por defecto en su organización para confirmarla o seleccione una distinta.
- Configure el proyecto con funciones como las opciones de prueba de entrega, entrega estimada, seguimiento de eventos y filtrado basado en eventos.
Paso 2: introducir la información del proyecto
- Póngale a su proyecto un nombre identificable que sea exclusivo en su organización.
- Indique la URL de destino y los detalles del token de seguridad que ha creado durante la autenticación previa a la configuración (consulte los pasos anteriores).
- Para recibir notificaciones sobre las últimas actualizaciones de los webhooks y cualquier información relacionada con interrupciones, especifique una dirección de e-mail y seleccione una preferencia de idioma.
Paso 3: leer y aceptar las condiciones
Tras haber aceptado las condiciones, incluidos el acuerdo de licencia de FedEx Developer Portal y el formulario de pedido, haga clic en el botón Crear y aparecerá una pantalla de confirmación.
Puede que tenga que completar más pasos en función del tipo de suscripción que haya seleccionado. Consulte la documentación para obtener más información.
En la página Resumen del proyecto de API, recupere las credenciales de prueba (clave API, clave secreta y cuentas de envío) en la pestaña Clave de prueba.
Paso 1: solicitar un token de acceso OAuth
Se deberá utilizar un token de acceso OAuth con cada transacción de API. El token solo es válido durante una hora, por lo que tendrá que codificar mediante programación la aplicación para actualizar el token antes de que finalice la sesión. Consulte la documentación de API Authorization para obtener más información.
Paso 2: revisar la documentación de API
Haga clic en la documentación de cada una de las API y lea el contexto empresarial para comprender mejor cómo usarla. Inicie sesión y vaya haciendo clic en el botón de arriba de la página de documentación para descargar la colección de API de JSON. También puede revisar solicitudes de muestra para el punto de conexión que se corresponda con la integración deseada.
Paso 3: utilizar el entorno de pruebas para experimentar con las transacciones de muestra
Haga clic en un punto de conexión de la parte izquierda para ir al entorno de pruebas en cuestión. Identifique las solicitudes de muestra que se ajusten mejor a su caso y utilice las credenciales y las URL de prueba de FedEx para implementar las llamadas a este punto de conexión como se indica en las solicitudes de ejemplo. Compruebe que las respuestas de llamada de API que recibe se corresponden con las mostradas en la documentación. Para más información sobre nuestro servicio de prueba, consulte la Guía de virtualización del entorno de pruebas.
Probar webhooks
Hacer pruebas puede ayudarle a tener una mejor idea sobre si la URL que ha creado es válida. Esto permite a FedEx identificar su URL y crear una conexión con su URL para enviar datos. La prueba puede también proporcionarle datos de muestra que pueden ayudarle a comprobar si es posible procesar los datos de seguimiento proporcionados en su aplicación. No obstante, la prueba no autentica su URL. Visite nuestra documentación sobre webhook para conocer cómo poner a prueba la URL de su webhook.
Visite la página Resumen de proyecto y abra la pestaña Clave de producción. Los proyectos con un número de cuenta con suscripción a Advanced Integrated Visibility no necesitan trasladarse a producción.
Paso 1: configurar el proyecto
- Cambie el nombre de la clave cuando lo necesite.
- Revise el número de cuenta que seleccionó en el paso 1 del proceso de creación del proyecto. Este se usa para trasladar el proyecto a producción. Una vez que su proyecto esté en producción, podrá añadir más cuentas si es necesario.
Paso 2: obtener las claves de proyecto
Copie su clave API y su clave secreta de producción en un lugar seguro. Para garantizar la protección de su clave secreta de producción, solo la mostraremos una vez. Si la pierde, puede generar una nueva.
Tras obtener sus claves del proyecto, haga clic en Siguiente; verá los detalles del proyecto en la pestaña Clave de producción.
- Para añadir más de una cuenta de envío al proyecto, haga clic en el botó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.
Algunas API requieren validaciones de etiquetas de envío para su uso en nuestro entorno de producción. Consulte si su API requiere validación.
Paso 1: desarrollar y probar las API de FedEx API con la aplicación web
Cuando termine de desarrollar su aplicación web, habrá llegado el momento de completar las pruebas utilizando las credenciales de prueba (cuentas de envío de prueba, clave de API y clave secreta). Sus claves de API y secreta de prueba aparecerán en la página Resumen de proyecto, donde las podrá consultar en todo momento.
Paso 2: trasladar el proyecto al entorno de producción
Cuando haya realizado las pruebas con las API de FedEx, tendrá que iniciar el proceso de validación trasladando su proyecto a producción en FedEx Developer Portal. Si lo ha hecho correctamente, verá la clave de API y la clave secreta para producción. Solo verá la clave secreta de producción una vez, pero podrá regenerarla más adelante.
Paso 3: cumplimentar la portada de la etiqueta
Rellene la portada de la etiqueta con toda la información de contacto pertinente, así como los servicios que pretende implementar. Incluya su número de cuenta y la clave de producción.
Paso 4: generar y enviar etiquetas de prueba al grupo de análisis de códigos de barras
Genere etiquetas de prueba en el entorno de pruebas de FedEx asociado a la aplicación y, a continuación, envíe las etiquetas de prueba a los equipos de evaluación de etiquetas de FedEx para su aprobación. El grupo de análisis de códigos de barras necesita un plazo de tres días laborables para la evaluación de las etiquetas.
Siga estas recomendaciones para evitar demoras en el procesamiento:
- Las etiquetas se han de imprimir y escanear con un mínimo de 600 DPI. NO ENVÍE ARCHIVOS GENERADOS POR LA API.
- En el caso de impresoras térmicas, el tipo de imagen de la etiqueta se debe solicitar de conformidad con el modelo de impresora. Ejemplo: ZPLII para impresoras Zebra
- Utilice la información de dirección de remitente/destinatario al crear etiquetas de muestra para la evaluación. Cree únicamente etiquetas de muestra para los servicios concretos que se vayan a solicitar.
- Las etiquetas de cobro en la entrega (C.O.D.) de FedEx® también deben incluir el C.O.D. correspondiente. Etiqueta de devolución.
- Los envíos de FedEx International Express® deben incluir también la etiqueta de albarán (AWB) auxiliar/secundario.
- Los envíos de múltiples piezas (MPS) deben incluir una etiqueta para cada paquete del envío.
- Envíe un e-mail con el PDF y la portada de la etiqueta a label@fedex.com.
- Las etiquetas físicas se pueden enviar a la dirección que figura a continuación:
FedEx Services
WTC-Business Solutions Testing
10 FedEx Parkway
2nd Floor Horizontal
Collierville, TN 38017
Si las etiquetas escaneadas carecen de defectos visibles (como líneas que cruzan el código de barras, manchas de tinta o daños físicos), pasarán la inspección y recibirán la aprobación.
Si envía etiquetas físicas, preste atención a la calidad de impresión y la ampliación/reducción accidental de las etiquetas (por ejemplo, agrandamiento). Estos son los dos principales motivos por los que las etiquetas no suelen pasar el proceso de evaluación de etiquetas.
Paso 5: revisar la evaluación de las etiquetas
El grupo de análisis de códigos de barras evaluará las etiquetas de prueba enviadas y las aprobará o rechazará. El grupo de análisis de códigos de barras se pondrá en contacto con usted para comunicarle la aprobación o el rechazo de las etiquetas enviadas. Si las etiquetas reciben la aprobación, continúe con el paso siguiente. Si las etiquetas se rechazan, corríjalas según le indiquen y vuelva a enviarlas para su aprobación.
Paso 6: habilitar la aplicación
Una vez que las etiquetas de prueba han recibido la aprobación del equipo de análisis de códigos de barras para el estado de producción, se autorizarán sus credenciales de producción para transmitir la transacción de etiquetas de envío identificada y se le avisará por e-mail de que ha conseguido la validación. La aprobación se hace proyecto a proyecto.
Paso 7: sustituir la URL y las credenciales
Sustituya la URL y las credenciales de prueba por las de producción. Vuelva a probar su implementación en el entorno de producción empleando los datos de muestra.
Requisito previo
Su empresa deberá ser proveedor certificado FedEx Compatible. Si su empresa no se encuentra en el programa Compatible, cambie la opción anterior a «Proveedor no compatible».
Paso 1: recibir una invitación para unirse a una organización
FedEx creará una organización. A continuación, invitará a un miembro del equipo para que se una a esta. A este usuario se le asignará el rol de administrador en su organización.
Paso 2: aceptar la invitación
Para aceptar la invitación, tendrá que iniciar sesión con su ID de usuario y contraseña existentes, o bien crear una nueva en caso de que su ID de usuario actual ya esté asociada a una organización.
Paso 3: invitar a usuarios
El administrador puede invitar a usuarios a su organización y, a continuación, asignarles funciones y proyectos. Abra la pestaña Usuarios. Haga click en el botón Añadir usuarios.
- Seleccione una función de usuario: Espectador, Colaborador o Administrador. Obtenga más información acerca de estas funciones en la Guía de administración de la organización.
- Si ya tiene un proyecto existente, puede asignar el proyecto a un usuario. También puede asignar usuarios a proyectos desde la página Resumen de proyecto.
- Especifique las direcciones de e-mail de los usuarios que quiera que se unan a la organización con la función que ha designado.
Visite el Catálogo de API para determinar cuáles son las API o los webhooks adecuados para su solución. Su consultor de tecnología para el cliente (CTC) de FedEx y el gestor del Compatible Channel le pueden ayudar a la hora de elegir las API adecuadas para su solución, según las necesidades de su negocio.
Paso 1: cumplimentar el PIW
Vuelva a la página de la Comunidad de proveedores Compatible (CPC) para cumplimentar el documento de información sobre el producto (PIW).
Paso 2: revisar el proyecto creado por FedEx
Cuando se haya aprobado el PIW, FedEx creará sus proyectos. Cada versión de sus soluciones aparecerá como proyecto individual en FedEx Developer Portal.
Paso 3: asistir con su equipo a la demostración de la API
El equipo de FedEx Compatible, junto con los equipos de FedEx CTC y de verificación, organizarán con su equipo una demostración técnica de las API. El equipo de FedEx abordará la verificación del programa Compatible, presentará las nuevas funcionalidades de la API y sus funcionalidades, y responderá todas sus preguntas.
En la página Resumen del proyecto de API, recupere las credenciales de prueba (clave API y clave secreta) en la pestaña Clave de prueba.
Paso 1: crear las claves del cliente
Emplee la API de registro de credenciales para crear las claves del cliente. Se trata de una API privada que solo podrá encontrar en la parte inferior de la sección de la API de la página Resumen de proyecto de API.
Paso 2: solicitar un token de acceso OAuth
Se deberá utilizar un token de acceso OAuth con cada transacción de API. El token solo es válido durante una hora, por lo que tendrá que codificar mediante programación la aplicación para actualizar el token antes de que finalice la sesión. Consulte la documentación de API Authorization para obtener más información. Cuando visualice el código de muestra, asegúrese de que se ha elegido «Revendedor» en los ejemplos del desplegable.
Paso 3: revisar documentación de API
Haga clic en la documentación de cada una de las API y lea el contexto empresarial para comprender mejor cómo usarla. Inicie sesión y vaya haciendo clic en el botón de arriba de la página de documentación para descargar la colección de API de JSON. También puede revisar solicitudes de muestra para el punto de conexión que se corresponda con la integración deseada.
Paso 4: utilizar el entorno de pruebas para experimentar con las transacciones de muestra
Haga clic en un punto de conexión de la parte izquierda para ir al entorno de pruebas en cuestión. Identifique las solicitudes de muestra que se ajusten mejor a su caso y utilice las credenciales y las URL de prueba de FedEx para implementar las llamadas a este punto de conexión como se indica en las solicitudes de ejemplo. Compruebe que las respuestas de llamada de API que recibe se corresponden con las mostradas en la documentación. Para más información sobre nuestro servicio de prueba, consulte la Guía de virtualización del entorno de pruebas.
Paso 5: verificar cada solución
Tras probar por completo sus soluciones, envíe los casos de prueba al equipo de Verificación para que comprueben cada solución. FedEx revisará íntegramente todo lo que envíe y le informará cuando se haya aprobado la verificación.
Probar webhooks
Si su organización tiene acceso a webhooks, realizar pruebas le ayudará a averiguar si la URL que ha creado es válida. Esto permite a FedEx identificar su URL y crear una conexión con su URL para enviar datos. La prueba puede también proporcionarle datos de muestra que pueden ayudarle a comprobar si es posible procesar los datos de seguimiento proporcionados en su aplicación. No obstante, la prueba no autentica su URL. Visite nuestra documentación sobre webhook para conocer cómo poner a prueba la URL de su webhook.
En ese momento, FedEx trasladará sus proyectos a producción. Visite la página Resumen de proyecto de API y abra la pestaña Clave de producción. Haga clic en el enlace de Generar clave secreta que aparece en la columna Clave secreta.
Ahora puede volver a probar su implementación en el entorno de producción empleando los datos de muestra.
Requisito previo
Debe tener un ID de usuario y una cuenta FedEx para iniciar sesión en FedEx Developer Portal y crear una organización.
Cree una organización en caso de que no haya ninguna aún para su empresa o, si ya existe, únase a la organización de su empresa.
Crear una nueva organización
En la barra de navegación, haga clic en Crear o únase a una organización.
Nota: Como creador, se le designa automáticamente como administrador de la organización.
Los administradores pueden:
Invitar a que los usuarios se unan.
Asignar roles de usuario (por ejemplo, colaborador, espectador, etc.) y proyectos.
Gestionar cuentas de envío.
Para obtener más información acerca de estos roles, consulte nuestra Guía de administración de la organización.
Para el tipo de empresa, seleccione «Comercializa o proporciona una solución de software que utiliza la tecnología de FedEx y es un proveedor de operadores logísticos integrales FedEx validado».
Introduzca el nombre de su empresa, la URL del sitio web y un nombre único para la organización. El nombre de la organización puede coincidir con el nombre de su empresa o representar un grupo específico (departamento, división, región, ubicación, etc.). Esta información es necesaria para validar su solicitud.
Nota: Ponga un nombre a su organización reconocible para otros usuarios (por ejemplo, nombre de la empresa, departamento, región, ubicación, etc.).
Especifique la ubicación de su empresa y dónde se venderá o distribuirá su solución de software.
Añadir cuenta de facturación y autenticar cuenta
Nota: Como proveedor de envíos y logística del programa de operadores logísticos integrales FedEx, debe utilizar su propio número de cuenta. No puede usar un número de cuenta FedEx.
Introduzca su número de cuenta FedEx. Si aún no tiene una cuenta FedEx, cree una en fedex.com o póngase en contacto con un representante del servicio FedEx de asistencia.
Especifique un sobrenombre de la cuenta y la dirección de facturación asociada a ella. Seleccione Siguiente.
Nota: La dirección de facturación debe coincidir con la que figura en nuestros registros para esta cuenta. Esta será la cuenta de facturación predeterminada de su organización.
Para terminar de crear su organización, debe autenticar su cuenta. Elija una opción de autenticación (teléfono disponible para operador logístico integral solo en EE. UU. y Canadá, e-mail, mensaje de texto, etc.) y seleccione Siguiente.
Cuando lo haya recibido, introduzca el código de autenticación y seleccione Enviar.
Aceptar las condiciones
Lea el acuerdo de operador logístico integral FedEx y el manual del programa. Marque las casillas para confirmar que acepta las condiciones y, a continuación, haga clic en Aceptar.
Aparecerá una pantalla de confirmación. Haga clic en Gestionar organización para editar los detalles si fuera necesario.
Invitar a usuarios
Nota: Solo los administradores pueden invitar a usuarios.
Seleccione Gestionar organización en el menú de navegación de la izquierda.
Vaya a la pestaña Usuarios y seleccione Añadir usuarios.
Rellene el formulario y asigne el rol pertinente a los nuevos usuarios: espectador, colaborador o administrador.
Para obtener más información sobre los roles de usuarios, consulte la Guía de administración de la organización.
Asigne usuarios a los proyectos, si corresponde, utilizando el menú desplegable Proyectos.
Introduzca las direcciones de e-mail de cada usuario y, a continuación, haga clic en Invitar.
Unirse a una organización existente
Solicite una invitación: pida al administrador de su organización que le mande una invitación. Tiene 24 horas para aceptarla antes de que caduque. Si fuera necesario, pida al administrador que la reenvíe.
Acepte la invitación: inicie sesión con el ID de usuario y la contraseña que ya tiene. Si su ID ya está vinculado a otra organización, debe crear uno nuevo.
Crear un proyecto de API
Vaya a su página Mis proyectos y seleccione Crear proyecto.
Rellene el campo Nombre del proyecto. Se recomienda seguir el formato «Nombredelproyecto_nombredelaaplicación». Después, haga clic en Siguiente.
Seleccione la API y los productos de Advanced Integrated Visibility para su proyecto.
Nota: Los productos de Advanced Integrated Visibility solo están disponibles para proveedores de operadores logísticos integrales FedEx de EE. UU.
Nota: 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 facturación y aceptar términos
Asigne una cuenta de facturación de la lista de cuentas añadidas a la organización. Este paso solo es necesario si ha seleccionado un producto de pago anteriormente.
Acepte los términos y condiciones asociados al producto.
Confirmar detalles
Revise los productos seleccionados. Verifique la cuenta de facturación proporcionada.
Revise y acepte el acuerdo de licencia de FedEx Developer Portal.
Haga clic en Crear para generar un proyecto y ver las credenciales de prueba.
Configurar Advanced Integrated Visibility en un proyecto
Requisitos previos
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 del pedido para obtener más información sobre los precios.
- Configurar cuentas: Advanced Integrated Visibility 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.
Crear una URL de callback válida en su aplicación o plataforma de destino; la URL de su aplicación/plataforma:
Debe usar HTTPS por seguridad.
No puede incluir la dirección IP RFC1918, subdominios de fedex.com ni direcciones IP directas (p. ej., 127.0.0.1).
Generar un token de seguridad
Debe tener entre 26 y 100 caracteres e incluir:
- Una letra mayúscula
- Una letra minúscula
- Un número
Ejemplo: Y1F6OiVUQW2JPSElmRE9U0IY5
Configurar Advanced Integrated Visibility
Elija Advanced Integrated Visibility. Seleccione funciones como prueba de entrega, entrega estimada, eventos de seguimiento y filtrado basado en eventos.
Introduzca su URL de destino y un token de seguridad.
Indique un e-mail para recibir actualizaciones de Advanced Integrated Visibility y notificaciones sobre interrupciones.
Confirmar detalles
Revise y acepte el acuerdo de licencia de FedEx Developer Portal y el formulario de pedido.
Seleccione Crear para completar la configuración.
Nota: Puede que tenga que completar más pasos en función de su tipo de suscripción. Consulte la documentación para obtener más detalles.
Recuperar credenciales de prueba e iniciar prueba
Revisar documentación de la API
- Lea la documentación de la API para familiarizarse con nuestros distintos servicios, su contexto empresarial y los procesos de integración asociados.
- Descargue el esquema JSON de la página de documentación de la API correspondiente.
- Revise solicitudes de muestra para los puntos de conexión deseados.
Obtener credenciales de prueba
En la página Resumen de proyecto, vaya a la pestaña Claves de API. Su clave de API y la clave secreta aparecen debajo del encabezado Clave de prueba.
Revisar documentación de la API
- Todas las transacciones de API requieren un token OAuth, que caduca en una hora.
- Su aplicación tiene que actualizar el token antes de que caduque.
- Consulte la documentación de API Authorization para obtener más información.
Ejecutar transacciones de API en el entorno de pruebas
- Vaya a la API correspondiente en el catálogo de API y seleccione Documentación.
- Seleccione el punto de conexión de la API que desee en el menú de la izquierda.
- Utilice solicitudes de muestra que se ajusten a su caso de uso.
- Implemente llamadas de API utilizando sus credenciales de prueba y las URL de prueba de FedEx.
- Verifique las respuestas con la documentación.
- Consulte la guía de virtualización del entorno de pruebas para obtener más información.
Probar Advanced Integrated Visibility
Las pruebas de Advanced Integrated Visibility validan el formato de URL y ayudan a establecer una conexión entre FedEx y su aplicación.
La prueba proporciona datos de muestra para procesar la información de seguimiento.
Nota: Las pruebas no autentican su URL.
Consulte la documentación de Advanced Integrated Visibility para obtener más información.
Se requiere la validación para trasladar las API a producción. El nivel de validación varía en función de cada API.
Desarrollar y probar las API de FedEx
- Utilice sus credenciales de prueba (clave de API y clave secreta) de la página Resumen de proyecto.
- Identifique casos de prueba para regiones o territorios donde pretende implementar su solución (consulte la referencia de casos de prueba del operador logístico integral).
- Antes de iniciar los casos de prueba, complete las transacciones de registro con los números de cuenta de prueba proporcionados.
- Ejecute todos los casos de prueba necesarios.
Vaya a la página Resumen de proyecto.
Seleccione Solicitar claves de producción. FedEx recibirá su solicitud de claves de producción y le avisará cuando se haya aprobado.
Cumplimentar la PIW y la portada de validación del operador logístico integral
Complete los documentos de información sobre el producto (PIW) y la portada de validación del operador logístico integral con sus datos de contacto y los servicios FedEx previstos.
Enviar documentación necesaria
Recopile y comprima la siguiente información en un archivo .zip para evitar restricciones del proveedor de e-mail. Envíe la documentación a validationmtp@fedex.com.
Documentación necesaria
- Formulario PIW completado (PDF).
- Portada de validación de operadores logísticos integrales completada (PDF).
Capturas de pantalla (PDF):
La vista del cliente de la solución que muestre los servicios FedEx estándar o de manipulación especial.
El aviso legal.
El acuerdo de licencia de usuario final (EULA)
El proceso de registro del usuario final
- 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/PNG).
- Transacciones de envío para tres formatos de etiqueta: PDF, PNG y ZPL (JSON) (para las Shipping API y Rating API aplicables).
Recomendaciones para evitar retrasos
- Las etiquetas se han de imprimir y escanear con un mínimo de 600 DPI.
- Las etiquetas de la impresora térmica deben coincidir con el modelo de impresora (p. ej., ZPLII para impresoras Zebra).
- Los envíos de FedEx International Express® requieren una etiqueta adicional de albarán (AWB).
- Los envíos de múltiples piezas (MPS) deben incluir una etiqueta para cada paquete.
Evaluación de etiquetas
El equipo de validación aprobará o rechazará su envío.
- Si se rechaza, haga las correcciones y envíelo nuevamente.
- Si se aprueba, recibirá un e-mail confirmando que se ha validado correctamente. Una vez que haya recibido el e-mail, se autorizarán sus credenciales de producción para las transacciones de etiqueta de envío.
Seguir las instrucciones posteriores a la validación
Revise e implemente cualquier requisito posterior a la validación según sea necesario.
Una vez que reciba la notificación de aprobación de sus claves de producción, recupérelas desde la pestaña Resumen de proyecto.
- Copie y almacene de forma segura su clave de API de producción y su clave secreta.
- La clave secreta solo se muestra una vez; si se pierde, debe volver a generar una nueva.
