Configuración de Advanced Integrated Visibility webhook
Resumen
El servicio de Advanced Integrated Visibility webhook permite a FedEx enviar información relacionada con eventos de seguimiento de forma segura y prácticamente en tiempo real a una URL de destino concreta para envíos vinculados a uno o varios números de cuenta FedEx. Puede crear un proyecto de webhook para acceder a esta función a través de FedEx Developer Portal.
Rutas de navegación
Puede acceder a la página para crear webhooks de cualquiera de estas formas:
- Desde Mis proyectos: panel de navegación de la izquierda → pestaña Webhooks → +CREAR UN PROYECTO DE WEBHOOK
Desde Catálogo de API:
- Panel de navegación de la izquierda → Catálogo de API
- Busque o filtre resultados por Advanced Integrated Visibility
- Resumen -> haga clic en Documentación -> en la consola del entorno de pruebas, haga clic en +CREAR UN PROYECTO
- Docs → Haga clic en +CREAR UN WEBHOOK
Pasos para crear webhooks
Paso 1: elija el tipo de empresa
Haga clic en +CREAR UN PROYECTO y seleccione el tipo de empresa correspondiente en el menú desplegable:
- Envía con FedEx y necesita integrar el webhook de FedEx en su sistema.
- Vende o proporciona una solución de software que utiliza datos de FedEx y no es un Proveedor certificado FedEx Compatible.
- Es un Proveedor certificado FedEx Compatible.
Nota: Actualmente, la solución Advanced Integrated Visibility de FedEx no está disponible para esta opción. Como miembro del programa FedEx Compatible, si quiere acceder a Basic Integrated Visibility u otras soluciones de integración de FedEx, póngase en contacto con su gestor de canales. Si no sabe quién es, póngase en contacto con el administrador de su empresa.
A continuación, seleccione Suscripción de número de cuenta de Advanced Integrated Visibility como tipo de suscripción.
Configurar una Suscripción de número de cuenta de Advanced Integrated Visibility
El proceso consta de cuatro pasos:
- Configurar proyecto
- Introducir los datos del proyecto
- Elegir cuentas de envíos
- Confirmar la información y aceptar las condiciones
Paso 1: configurar proyecto
En la página Configurar webhook:
- Número de cuenta de facturación:
- Revise la cuenta de facturación predeterminada.
- Para cambiarla:
- Haga clic en AÑADIR CUENTA DE FACTURACIÓN A SU ORGANIZACIÓN (si solo tiene una cuenta); o
- Haga clic en SELECCIONAR OTRA CUENTA DE FACTURACIÓN (si tiene varias cuentas).
Nota: Se requiere una cuenta de facturación de Estados Unidos. Para obtener más información sobre los precios, consulte la Guía resumen de precios de Advanced Integrated Visibility.
Selección de funciones:
- Seleccione las funciones que desea habilitar y, a continuación, haga clic en Siguiente.
Descripción de las funciones
| Nombre del campo | Descripción |
|---|---|
| Prueba de entrega | Confirma que el envío se ha entregado correctamente. Comprobante de entrega con imagen (PPODA): incluye una fotografía del lugar exacto de la entrega. Prueba de entrega con firma (SPOD): incluye una imagen de la firma del destinatario, así como su nombre, la fecha, la hora y el lugar de entrega. |
| Entrega estimada | Ayuda a los destinatarios a organizarse, ya que indica lo siguiente: Fecha de entrega estimada Plazo estimado de entrega |
| Eventos de seguimiento | Permite seleccionar una o varias categorías de eventos para recibir notificaciones: Enviar En tránsito Entrega Excepciones Opciones de entrega personalizadas |
| Filtrado basado en eventos | Filtra las respuestas del webhook para que muestren: Envíos de importación Envíos de exportación Envíos de terceros |
En la página Introducir detalles, introduzca la siguiente información:
| Nombre del campo | Descripción |
|---|---|
| Nombre del proyecto de webhook | Nombre del proyecto de webhook que es único y no está vacío. Se completa automáticamente con una sugerencia que puede editarse, si procede. Este nombre no debe repetirse en ningún otro webhook. |
| URL de destino | Punto de conexión HTTPS seguro al que FedEx enviará los datos de los eventos de seguimiento. Requisitos: Debe ser válida y estar operativa. Debe cumplir la sintaxis estándar. No debe incluir fedex.com ni sus subdominios. Puede utilizarse en varios webhooks. Consulte la sección de Normas y buenas prácticas comerciales para obtener más información. |
| Token de seguridad | Clave secreta compartida utilizada para autenticar y validar las respuestas de webhook mediante el HMAC. Requisitos: Entre 26 y 100 caracteres. Debe contener al menos una mayúscula, una minúscula y un número. Puede utilizarse en varios webhooks. |
| Idioma de la carga útil (país) | Seleccione el idioma que desee para las traducciones de los datos de seguimiento en la lista desplegable. |
| Tipo de seguimiento | Elija cómo desea recibir la información de seguimiento: Seguimiento detallado: incluye todo el historial. Seguimiento por evento: solo el evento más reciente. |
| Dirección de correo electrónico | Indique una dirección de e-mail válida para recibir notificaciones. |
| Idioma del e-mail (país) | Seleccione su idioma preferido para recibir notificaciones por e-mail. Nota: Solo están disponibles configuraciones regionales de EE. UU. (por ejemplo, en-US, es-US). |
Paso 3: seleccionar las cuentas de envío
En la página Elegir cuentas de envío:
- Seleccione uno o varios números de cuenta FedEx para vincularlos a su proyecto de webhook.
Notas importantes:
- Solo se mostrarán las cuentas que no estén ya asociadas a otros webhooks.
- Debe seleccionar al menos una cuenta para continuar.
- Puede añadir hasta 100 cuentas desde la interfaz de usuario del webhook.
- Si necesita añadir más de 100 cuentas, tendrá que usar la Webhooks API.
Para solicitar acceso a la API, póngase en contacto con el servicio FedEx de atención al cliente o con el servicio de asistencia técnica.
Paso 4: confirmar los datos y crear el webhook
En la página Confirmar detalles:
1. Revise la información que ha introducido para el proyecto de webhook.
2. Marque la casilla para aceptar los términos y condiciones.
3. Haga clic en Crear para finalizar la configuración del proyecto de webhook.
Una vez enviada la solicitud, el webhook se creará con un ID de suscripción generado por el sistema y su estado será Activo.
Normas de validación
Requisitos generales:
- El nombre del webhook debe ser único.
- La URL de destino debe ajustarse al formato sintáctico estándar (https segura, sin incluir fedex.com ni subdominios).
- Deben rellenarse todos los campos obligatorios; no puede quedar ninguno vacío.
- Debe asociarse al menos un número de cuenta de envío FedEx válido al webhook.
Validación satisfactoria:
Al crear un webhook correctamente, el cliente recibirá el siguiente mensaje de confirmación:
<<Nombre del webhook>> se ha creado correctamente. Los cambios podrían tardar hasta 10 minutos en aplicarse».
Validación insatisfactoria/fallida:
Si FedEx recibe una respuesta que no sea 200 (OK) o 202 (Aceptado), desde la URL de destino, la validación del webhook se considerará fallida.
