CREAR UN
WEBHOOK GESTIONAR WEBHOOKS

Tipos de webhooks de visibilidad integrada avanzada

El webhook de visibilidad integrada avanzada permite a FedEx enviar datos de eventos de rastreo seguros casi en tiempo real a una URL de destino para envíos asociados con un número de cuenta FedEx específico.

Puedes crear un proyecto de webhook de visibilidad integrada avanzada en FedEx Developer Portal y después asociarlo a uno o más números de cuenta FedEx o números de rastreo de FedEx, según el tipo de suscripción que seleccionaste.

Dirígete a:

SUSCRIPCIÓN DE NÚMERO DE CUENTA DE VISIBILIDAD INTEGRADA AVANZADA o SUSCRIPCIÓN DE NÚMERO DE RASTREO DE VISIBILIDAD INTEGRADA AVANZADA, para ver los pasos para crear el webhook de visibilidad integrada avanzada respectivo.

Descripción general de la visibilidad integrada avanzada de FedEx

Los clientes de FedEx pueden suscribirse a un número de cuenta o de rastreo para recibir eventos de envío en tránsito casi en tiempo real, desde la creación de etiquetas hasta la prueba de la entrega de paquetes, incluida la prueba de la entrega con fotografía.

Tipos de suscripciones

Los clientes de FedEx pueden suscribirse a la visibilidad integrada avanzada mediante las siguientes opciones:

Por número de cuenta: suscribirse al número de cuenta FedEx para recibir novedades sobre los envíos vinculados a la cuenta.
Por número de seguimiento: suscríbete al número de rastreo de FedEx para recibir actualizaciones de los envíos que coincidan con los números de rastreo especificados a través de los puntos finales de la API.

Nota: actualmente, las suscripciones requieren una cuenta FedEx de nueve dígitos de los EE. UU. para facturar, y a los clientes se les cobra una tarifa mensual según el total de números de rastreo. Para obtener más información sobre el precio de la visibilidad integrada avanzada, consulta la Guía de precios de la descripción general de la visibilidad integrada avanzada.

Si te suscribes por número de cuenta, las suscripciones actualmente requieren cuentas de envío FedEx de 9 dígitos con base en EE. UU.

La siguiente tabla te brinda información sobre las funciones de la suscripción de número de cuenta y la suscripción de número de rastreo de la visibilidad integrada avanzada.

Funciones	Suscripción del número de cuenta	Suscripción del número de rastreo
Respuesta	Datos seguros: datos de información de identificación personal (PII) de remitente y datos del destinatario de respuesta/opción de entrega conveniente (CDO) con prueba de entrega firmada	Datos anónimos (incluye envíos, actualizaciones en tránsito, que excluye la PII: Información/respuesta de identificación personal)
Asociación	Asociación de un número de cuenta: asociar todos los números de rastreo de una vez	Asociación de números de rastreo
Propiedad	Los números de cuenta deben ser propiedad de los propios usuarios	No es necesario que los números de rastreo sean propiedad del usuario
Filtro	Capacidad de filtrar eventos según envíos de llegada, de salida o de terceros	No se pueden filtrar los eventos
Integración	La asociación de números de cuenta se realiza mediante la interfaz de usuario (UI)	La asociación de números de rastreo se realiza mediante los puntos finales de la API
Limitaciones	Puedes agregar hasta 100 números de cuenta	Puedes agregar hasta 1000 números de rastreo por solicitud
Caso de uso adecuado	Clientes de primera parte: si el cliente es propietario de los números de cuenta	Terceros: si el cliente tiene números de rastreo que le pertenecen a clientes de primera parte

Visibilidad integrada de FedEx: comparación de funciones por tipo de suscripción

Función/elemento de datos	Suscripción del número de rastreo	Suscripción del número de cuenta	Notas
SPOD (prueba de entrega firmada)	No disponible	Disponible (se requiere configuración)	Imagen de firma en formato TIFF, entregada en carga
PPOD (prueba de la entrega con imagen)	Disponible (se requiere configuración)	Disponible (se requiere configuración)	Imagen JPEG del lugar de entrega, codificada en base64
PPODA (prueba con imagen del intento de entrega)	Disponible (se requiere configuración)	Disponible (se requiere configuración)	Para intentos de entrega, se proporciona una imagen JPEG.
Coordenadas GPS (gpsPodCoordinates)	No disponible	Disponible	Oculto en suscripciones basadas en el rastreo
Información de contacto (nombre, teléfono, empresa)	Oculto	Disponible	Entre remitente, destinatario, origen, destino, corredor, etc.
Dirección y código postal	Oculto	Disponible	streetLines y postalCode están ocultos en cargas basadas en el rastreo
Números de cuenta	Oculto	Disponible	Incluye valores de cuentas de billTo, remitente y destinatario
Información financiera del paquete (por ejemplo, declaredValue, codAmount)	Oculto	Disponible	Aduana, cobro contra entrega (COD) y valores declarados están ocultos
Detalles de consulta y devolución (códigos de consulta, motivos de devolución)	Oculto	Disponible	Los detalles completos solo se muestran para suscriptores basados en cuentas
Datos sobre mercancía y contenido	Oculto	Disponible	Incluye códigos de piezas, descripciones, cantidades.
ID de empleado (por ejemplo, personal del evento)	Oculto	No disponible	Oculto en ambos casos por motivos de privacidad
Notificaciones de eventos y fecha de la entrega estimada (EDD)/horario de entrega estimado (EDTW)	Disponible	Disponible	Funciones de fecha u hora de la entrega estimada compatible en ambos
Envío de varios paquetes (MPS)	Disponible	Disponible	Con información de rastreo adicional
Puntajes de riesgo y confianza de entrega estimada	Disponible	Disponible	Solo parte del nivel Premium

Campos de datos ocultos para la suscripción del número de rastreo de visibilidad integrada avanzada

Resumen

Cuando los clientes se suscriben a las actualizaciones de rastreo de envíos mediante la Suscripción del número de rastreo de visibilidad integrada avanzada en lugar de la Suscripción del número de cuenta de visibilidad integrada avanzada, los campos de datos específicos se ocultan para mantener la privacidad del cliente y cumplir con las políticas de seguridad de datos.

Ocultarlos garantiza que la información confidencial, como datos de contacto personales, direcciones y valores financieros, solo sea accesible para partes autorizadas. Los clientes que utilicen la suscripción del número de rastreo de visibilidad integrada avanzada verán «XXXXX» en los campos ocultos que se enumeran a continuación, aunque estos datos puedan estar disponibles a través de la suscripción del número de rastreo de visibilidad integrada avanzada.

Las implicaciones de ocultar esta información incluyen:

Una visibilidad limitada de los detalles de origen o destino y las partes involucradas.
Una ausencia de identificadores personales (por ejemplo, nombres, números de teléfono) y datos financieros o relacionados con la aduana.
Una protección diseñada para información de envío confidencial o de propiedad exclusiva para seguridad y cumplimiento normativo.

Se recomienda a los clientes que requieran acceso a estos campos ocultos para casos de uso operativo o empresarial que se suscriban utilizando su Número de cuenta.

Los puntos de datos están OCULTOS en la suscripción del número de rastreo de visibilidad integrada avanzada:

Eventos de escaneo

scanEvent/location/locationContactAndAddress/address/streetLines
scanEvent/location/locationContactAndAddress/contact/phoneNumber
scanEvent/location/locationContactAndAddress/contact/companyName
scanEvent/location/locationContactAndAddress/contact/personName
scanEvent/previousEvents/[Array]/location/locationContactAndAddress/address/streetLines
scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/phoneNumber
scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/companyName
scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/personName

Información del remitente

trackResult/shipperInfo/contactAndAddress/address/postalCode
trackResult/shipperInfo/contactAndAddress/address/streetLines
trackResult/shipperInfo/contactAndAddress/contact/phoneNumber
trackResult/shipperInfo/contactAndAddress/contact/companyName
trackResult/shipperInfo/contactAndAddress/contact/personName
trackResult/shipperInfo/account/value

Información del destinatario

trackResult/recipientInfo/contactAndAddress/address/postalCode
trackResult/recipientInfo/contactAndAddress/address/streetLines
trackResult/recipientInfo/account/value
trackResult/recipientInfo/contactAndAddress/contact/phoneNumber
trackResult/recipientInfo/contactAndAddress/contact/companyName
trackResultecipientInfo/contactAndAddress/contact/personName

Ubicación de origen y destino

trackResult/originLocation/locationDetail/locationContactAndAddress/contact/personName
trackResult/originLocation/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/originLocation/locationDetail/locationContactAndAddress/contact/companyName
trackResult/originLocation/locationDetail/locationContactAndAddress/address/streetLines
trackResult/originLocation/locationDetail/locationContactAndAddress/address/postalCode
trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/personName
trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/companyName
trackResult/destinationLocation/locationDetail/locationContactAndAddress/address/streetLines
trackResult/destinationLocation/locationDetail/locationContactAndAddress/address/postalCode

Detalles de entrega y cambio de dirección

trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/streetLines
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/postalCode
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/gpsPodCoordinates
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/personName
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/companyName
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/address/streetLines
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/address/postalCode
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/personName
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/companyName

Información del agente aduanal

trackResult/broker/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/broker/locationDetail/locationContactAndAddress/contact/companyName
trackResult/broker/locationDetail/locationContactAndAddress/contact/personName
trackResult/broker/locationDetail/locationContactAndAddress/address/streetLines
trackResult/broker/locationDetail/locationContactAndAddress/address/postalCode

Detalles financieros y de paquetes

trackResult/packageDetail/customsValue/value
trackResult/packageDetail/declaredValue/value
trackResult/packageDetail/originalTransportationCharge/value
trackResult/codDetail/codAmount/value

Información sobre consultas y mercancías

trackResult/inquiries/[Array]/categoryCode
trackResult/inquiries/[Array]/code
trackResult/inquiries/[Array]/createTime
trackResult/inquiries/[Array]/statusCode
trackResult/commodityInfo/[Array]/description
trackResult/commodityInfo/[Array]/code

Contenido del paquete y motivo de devolución

trackResult/contents/[Array]/partNumber
trackResult/contents/[Array]/partCode
trackResult/contents/[Array]/description
trackResult/contents/[Array]/quantity
trackResult/returnReason/[Array]/code
trackResult/returnReason/[Array]/description

Información de facturación

trackResult/billToParties/[Array]/billToParty/accountNumber

Beneficios del cliente:

Mejora la confianza del destinatario con notificaciones proactivas sobre cambios en tránsito de la fecha de la entrega estimada y el día del plazo de entrega.
Reduce los costos de servicio de atención al cliente para las llamadas que soliciten información sobre dónde está el pedido (WISMO), así como las disputas de entrega, proporcionando una prueba de la entrega con fotografía de FedEx.
Mejora la experiencia del cliente proporcionando notificaciones casi en tiempo real sobre el estado del envío.
Aumenta la eficacia operativa con las actualizaciones automáticas en tiempo real sobre los envíos, en lugar de tener que consultar continuamente las actualizaciones de rastreo de cada envío.

Funciones y eventos de rastreo

Eventos de rastreo

Esta función permite realizar un rastreo del estado de los envíos y notificar de manera proactiva a los clientes sobre las actualizaciones del ciclo de vida del envío. Proporciona a los clientes opciones para elegir la etapa exacta del proceso/evento de envío para los que desean recibir una notificación/alerta. Los eventos de envío disponibles son los siguientes:

Enviar: esta opción proporciona una notificación cuando ocurre el evento de envío seleccionado. Ejemplo: Etiqueta creada, Recolección, etc.
En tránsito: esta opción proporciona una notificación de los eventos de tránsito del envío. Ejemplo: en tránsito, artículo retenido en el momento de la entrega, etc.
Entrega: esta opción proporciona una notificación de los eventos de entrega del envío. Ejemplo: listo para entrega, entregado, etc.
Excepciones: esta opción proporciona una notificación para las excepciones de entrega. Ejemplo: retraso por liberación aduanal, etc.
Opciones de entrega prácticas: selecciona esta opción para recibir notificaciones de algunos eventos de rastreo personalizados. Ejemplo: solicitud de retención en oficina aceptada.

Para obtener más información sobre las opciones de eventos de envío disponibles, consulta la tabla de Códigos de estado y estados de eventos de rastreo de la visibilidad integrada avanzada.

Prueba de la entrega

Esta función se utiliza para reconocer que un pedido llegó correctamente a su destino previsto. Esto incluye lo siguiente:

Prueba de la entrega con fotografía (PPOD): la PPOD permite a los clientes recibir una fotografía de la ubicación exacta de su paquete una vez que se entrega en la puerta de su casa.
La visibilidad integrada avanzada arroja las imágenes de la PPOD en la carga JSON en formato base64. Luego, las imágenes pueden convertirse a formato JPEG.
Nota:
Prueba del intento de entrega con foto (PPODA): la PPODA permite a los clientes recibir una fotografía de la ubicación exacta donde se entregará el paquete, en caso de que no pueda completarse la entrega. La visibilidad integrada avanzada arroja las imágenes de la PPODA en la carga JSON en formato base64. Luego, las imágenes se pueden convertir a formato JPEG.

Prueba de entrega firmada (SPOD): la SPOD permite a los clientes recibir una imagen de la firma del destinatario, así como su nombre, fecha de entrega, hora y ubicación. La información de prueba de entrega firmada se presentará como una matriz de bytes, en lugar de una imagen. La matriz de bytes es una cadena codificada en base64 que debe decodificarse para obtener la imagen final de la firma en formato PNG.

Prueba de la entrega con GPS (GPSPOD):
- La prueba de la entrega con GPS les permite a los clientes recibir coordinadas geográficas de la ubicación de la entrega.
  
  Nota: la GPSPOD está disponible de forma predeterminada para la suscripción de un número de cuenta de visibilidad integrada avanzada.

Eventos de la fecha de la entrega estimada y plazo de entrega

Esta función ayuda a los destinatarios de los envíos a planificar sus horarios proporcionando una fecha o un rango de horas para las entregas de los envíos. Esto incluye lo siguiente:

Fecha de la entrega estimada (EDD): esta opción proporciona una fecha estimada de entrega del envío al destinatario. Ejemplo: 20 de noviembre de 20XX.
Horario de entrega estimado (EDTW): esta opción proporciona al destinatario un plazo estimado para la entrega del envío el día de la entrega real. Por ejemplo: de 14:00 a 18:00 horas.

Filtro basado en eventos

Esta función permite a los clientes organizar sus proyectos del webhook según los métodos de facturación de los envíos. Las opciones son las siguientes:

Entrante: Selecciona esta opción para los envíos que se te entregarán y que tú como destinatario pagarás.
Saliente: Selecciona esta opción para los envíos que enviarás y pagarás como remitente.
Tercero: Selecciona esta opción para envíos entrantes y salientes que se te facturan como pagador tercero.

Nota: Tu número de cuenta FedEx se utilizará para facturar o pagar los envíos. En el caso de un pagador tercero, es posible que tú no seas el remitente ni el destinatario, pero los cargos se facturarán a tu número de cuenta FedEx.

Política de reintentos

Esta función evita que FedEx envíe datos de eventos de rastreo en caso de un problema del lado del cliente. FedEx conservará los datos e intentará reenviarlos en un lapso de tres reintentos en intervalos de cinco minutos.

Si FedEx no recibe una respuesta exitosa en el periodo definido, FedEx detendrá el reenvío de ese evento específico. Sin embargo, el cliente puede solicitar los eventos perdidos durante un periodo de los últimos siete días a través del botón manual «REINTENTAR» en la página de Detalles del proyecto del webhook de visibilidad integrada avanzada.

Para obtener más información sobre las políticas de reintento, consulta la sección Mecanismo de reintento.

Request
Response

Response

Copy

CREAR UN WEBHOOK GESTIONAR WEBHOOKS