Fedex Logo

Tipos de Advanced Integrated Visibility webhooks

El Advanced Integrated Visibility webhook permite a FedEx enviar información relacionada con eventos de seguimiento en tiempo casi real a una URL de destino para aquellos envíos que estén vinculados a un número de cuenta FedEx específico.

Puede crear un proyecto de Advanced Integrated Visibility webhook en FedEx Developer Portal y, a continuación, asociarlo a uno o varios números de cuenta o números de seguimiento de FedEx, dependiendo del tipo de suscripción seleccionado.

Vaya a:

SUSCRIPCIÓN DE NÚMERO DE CUENTA DE ADVANCED INTEGRATED VISIBILITY  o  SUSCRIPCIÓN DE NÚMERO DE SEGUIMIENTO DE ADVANCED INTEGRATED VISIBILITY , para ver los pasos necesarios para crear el Advanced Integrated Visibility webhook respectivo.

 

 

Resumen de Advanced Integrated Visibility de FedEx


Los clientes de FedEx pueden suscribirse a un número de cuenta o un número de seguimiento para recibir información casi en tiempo real de cada paso del envío, desde la creación de la etiqueta hasta la prueba de entrega de los envíos, incluida la prueba fotográfica de la entrega.

Tipos de suscripción


Los clientes de FedEx pueden suscribirse a Advanced Integrated Visibility de las siguientes formas:

  • Con un número de cuenta: podrá suscribirse a un número de cuenta FedEx para recibir actualizaciones de aquellos envíos correspondientes a dicha cuenta.
  • Con número de seguimiento: podrá suscribirse a un número de seguimiento de FedEx para recibir actualizaciones de aquellos envíos correspondientes a los números de seguimiento especificados en los puntos de conexión de la API.

Nota: En estos momentos, las suscripciones requieren un número de cuenta FedEx estadounidense de 9 dígitos para la facturación. Además, a los clientes se les cobrará una tarifa mensual en función de la cantidad de números de seguimiento. Para obtener más información sobre el precio de Advanced Integrated Visibility, consulte la Guía resumen de precios de Advanced Integrated Visibility.

En el caso de las suscripciones a número de cuenta, actualmente se requieren cuentas FedEx de envío de 9 dígitos domiciliadas en EE. UU.

La tabla de abajo le ofrece información acerca de las funciones de la suscripción de número de cuenta y la suscripción de número de seguimiento de Advanced Integrated Visibility

Funciones Suscripción de número de cuenta Suscripción de número de seguimiento
Respuesta  Información protegida: datos de identificación personal del remitente y del destinatario, prueba firmada de entrega y opción de entrega personalizada o respuesta Datos anónimos (incluye información del envío, actualizaciones del estado, sin incluir los datos de identificación personal, o respuesta)
Vinculación Vincular un único número de cuenta: todos los números de seguimiento vinculados se enlazarán a la vez Vinculación de números de seguimiento 
Propiedad El usuario deberá poseer todos los números de cuenta No es necesario que el usuario posea los números de seguimiento
Filtrado Tiene la posibilidad de filtrar eventos por envíos de importación, de exportación y de terceros
No es posible filtrar eventos
Integración La vinculación de números de cuenta se realizará con la interfaz de usuario La vinculación de números de seguimiento se realizará con un punto de conexión de API
Limitación Se podrán añadir hasta 100 números de cuenta Se podrán añadir hasta 1.000 números de seguimiento
Ejemplos de uso adecuado Clientes directos: si el cliente es propietario de los números de cuenta Clientes terceros: si el cliente tiene números de seguimiento pertenecientes a los clientes directos

 

Integrated Visibility de FedEx: comparación de funciones según el tipo de suscripción

Función/elemento de datos Suscripción de número de seguimiento Suscripción de número de cuenta Notas
Prueba firmada de entrega (SPOD) No disponible Disponible (requiere configuración) Imagen de la firma en formato TIFF, proporcionada en la carga útil
Prueba fotográfica de la entrega (PPOD) Disponible (requiere configuración) Disponible (requiere configuración) Imagen JPEG del lugar de entrega codificada con base64
Prueba fotográfica del intento de entrega (PPODA) Disponible (requiere configuración) Disponible (requiere configuración) Se proporciona una imagen JPEG para los intentos de entrega
Coordenadas GPS (prueba de entrega por coordenadas GPS) No disponible Disponibles Contenido oculto en suscripciones de número de seguimiento
Información de contacto (nombre, teléfono, empresa) Oculto Disponibles Se aplica al remitente, destinatario, origen, destino, agente, etc.
Dirección y código postal Oculto Disponibles Los campos de calle y código postal se ocultan en la carga útil de seguimiento
Números de cuenta Oculto Disponibles Incluidos los campos de cuenta del receptor de la factura, remitente y destinatario
Información financiera del paquete (p. ej., el valor declarado o el importe COD) Oculto Disponibles Se ocultan los campos de aduanas, cobro en la entrega y valor declarado
Consultas y detalles de devolución (código de consulta, motivos de devolución) Oculto Disponibles Solo se muestra la información completa a los suscriptores de un número de cuenta
Información de la mercancía y el contenido Oculto Disponibles Incluidos los códigos, las descripciones y las cantidades
ID de empleado (p. ej., personal de los eventos) Oculto No disponible Se oculta en ambos casos por motivos de privacidad
Notificaciones de eventos y fecha/plazo de entrega estimado Disponibles Disponibles Ambos tipos pueden mostrar la fecha/hora de entrega estimada
Envío de múltiples paquetes (MPS) Disponibles Disponibles Con información de seguimiento adicional
Confianza en la entrega estimada e índices de riesgo Disponibles Disponibles Solo está disponible en el nivel Premium

 

Campos de datos ocultos para la Suscripción de número de seguimiento de Advanced Integrated Visibility

Resumen

Cuando un cliente se suscribe a las actualizaciones de seguimiento de envíos mediante la Suscripción de número de seguimiento de Advanced Integrated Visibility en lugar de la Suscripción de número de cuenta de Advanced Integrated Visibility, se ocultan ciertos campos de datos para asegurar la privacidad del cliente y cumplir con las políticas de protección de datos.

Este sistema garantiza que solo las personas autorizadas puedan acceder a la información confidencial, como los datos de contacto, direcciones y saldos personales. Los clientes con una Suscripción de número de seguimiento de Advanced Integrated Visibility verán «XXXXX» en los campos ocultos que se enumeran a continuación, incluso cuando esta información pueda estar disponible a través de dicha suscripción.

Algunas de las repercusiones de esto son:

  • Disponibilidad limitada de los detalles de origen/destino y las partes involucradas.
  • Ausencia de identificadores personales (p. ej., nombres, números de teléfono) y de información financiera o aduanera.
  • Protección de información del envío confidencial o privada para garantizar la seguridad y el cumplimiento normativo.

Se recomienda a los clientes suscribirse con su número de cuenta si desean solicitar el acceso a esta información oculta por motivos operativos o empresariales.

Los datos que aparecen OCULTOS en la Suscripción de número de seguimiento de Advanced Integrated Visibility son:

Eventos de escaneo

  • Eventos de escaneo / ubicación / ubicación, contacto y dirección / dirección / calle
  • Eventos de escaneo / ubicación / ubicación, contacto y dirección / contacto / número de teléfono
  • Eventos de escaneo / ubicación / ubicación, contacto y dirección / contacto / nombre de la empresa
  • Eventos de escaneo / ubicación / ubicación, contacto y dirección / contacto / nombre de la persona
  • Eventos de escaneo / eventos previos / (matriz) / ubicación / ubicación, contacto y dirección / dirección / calle
  • Eventos de escaneo / eventos previos / (matriz) / ubicación / ubicación, contacto y dirección / contacto / número de teléfono
  • Eventos de escaneo / eventos previos / (matriz) / ubicación / ubicación, contacto y dirección / contacto / nombre de la empresa
  • Eventos de escaneo / eventos previos / (matriz) / ubicación / ubicación, contacto y dirección / contacto/ nombre de la persona

Información del consignatario

  • Resultados de seguimiento / información del remitente / contacto y dirección / dirección / código postal
  • Resultados de seguimiento / información del remitente / contacto y dirección / dirección / calle
  • Resultados de seguimiento / información del remitente / contacto y dirección / contacto / número de teléfono
  • Resultados de seguimiento / información del remitente / contacto y dirección / contacto / nombre de la empresa
  • Resultados de seguimiento / información del remitente / contacto y dirección / contacto / nombre de la persona
  • Resultados de seguimiento / información del remitente / cuenta / valor

Información del destinatario

  • Resultados de seguimiento / información del destinatario / contacto y dirección / dirección / código postal
  • Resultados de seguimiento / información del destinatario / contacto y dirección / dirección / calle
  • Resultados de seguimiento / información del destinatario / cuenta / valor
  • Resultados de seguimiento / información del destinatario / contacto y dirección / contacto / número de teléfono
  • Resultados de seguimiento / información del destinatario / contacto y dirección / contacto / nombre de la empresa
  • Resultados de seguimiento / información del destinatario / contacto y dirección / contacto / nombre de la persona

Ubicación de origen y destino

  • Resultados de seguimiento / ubicación de origen / detalles de la ubicación / ubicación, contacto y dirección / contacto / nombre de la persona
  • Resultados de seguimiento / ubicación de origen / detalles de la ubicación / ubicación, contacto y dirección / contacto / número de teléfono
  • Resultados de seguimiento / ubicación de origen / detalles de la ubicación / ubicación, contacto y dirección / contacto / nombre de la empresa
  • Resultados de seguimiento / ubicación de origen / detalles de la ubicación / ubicación, contacto y dirección / dirección / calle
  • Resultados de seguimiento / ubicación de origen / detalles de la ubicación / ubicación, contacto y dirección / dirección / código postal
  • Resultados de seguimiento / ubicación de destino / detalles de la ubicación / ubicación, contacto y dirección / contacto / nombre de la persona
  • Resultados de seguimiento / ubicación de destino / detalles de la ubicación / ubicación, contacto y dirección / contacto / número de teléfono
  • Resultados de seguimiento / ubicación de destino / detalles de la ubicación / ubicación, contacto y dirección / contacto / nombre de la empresa
  • Resultados de seguimiento / ubicación de destino / detalles de la ubicación / ubicación, contacto y dirección / dirección / calle
  • Resultados de seguimiento / ubicación de destino / detalles de la ubicación / ubicación, contacto y dirección / dirección / código postal

Detalles del cambio de dirección y entrega

  • Resultados de seguimiento / dirección de entrega real / detalles de la ubicación / ubicación, contacto y dirección / dirección / calle
  • Resultados de seguimiento / dirección de entrega real / detalles de la ubicación / ubicación, contacto y dirección / dirección / código postal
  • Resultados de seguimiento / dirección de entrega real / detalles de la ubicación / ubicación, contacto y dirección / dirección / coordenadas GPS
  • Resultados de seguimiento / dirección de entrega real / detalles de la ubicación / ubicación, contacto y dirección / dirección / nombre de la persona
  • Resultados de seguimiento / dirección de entrega real / detalles de la ubicación / ubicación, contacto y dirección / contacto / número de teléfono
  • Resultados de seguimiento / dirección de entrega real / detalles de la ubicación / ubicación, contacto y dirección / contacto / nombre de la empresa
  • Resultados de seguimiento / solicitud de cambio de dirección / detalles de la ubicación / ubicación, contacto y dirección / dirección / calle
  • Resultados de seguimiento / solicitud de cambio de dirección / detalles de la ubicación / ubicación, contacto y dirección / dirección / código postal
  • Resultados de seguimiento / solicitud de cambio de dirección / detalles de la ubicación / ubicación, contacto y dirección / contacto / nombre de la persona
  • Resultados de seguimiento / solicitud de cambio de dirección / detalles de la ubicación / ubicación, contacto y dirección / contacto / número de teléfono
  • Resultados de seguimiento / solicitud de cambio de dirección / detalles de la ubicación / ubicación, contacto y dirección / contacto / nombre de la empresa

Información del agente de aduanas

  • Resultados de seguimiento / broker / detalles de la ubicación / ubicación, contacto y dirección / contacto / número de teléfono
  • Resultados de seguimiento / broker / detalles de la ubicación / ubicación, contacto y dirección / contacto / nombre de la empresa
  • Resultados de seguimiento / broker / detalles de la ubicación / ubicación, contacto y dirección / contacto / nombre de la persona
  • Resultados de seguimiento / broker / detalles de la ubicación / ubicación, contacto y dirección / dirección / calle
  • Resultados de seguimiento / broker / detalles de la ubicación / ubicación, contacto y dirección / dirección / código postal

Detalles financieros y del paquete

  • Resultados de seguimiento / detalles del paquete / valor en aduanas / valor
  • Resultados de seguimiento / detalles del paquete / valor declarado / valor
  • Resultados de seguimiento / detalles del paquete / cargos de transporte originales / valor
  • Resultados de seguimiento / detalles del paquete / valor del COD / valor

Información sobre la mercancía y consultas

  • Resultados de seguimiento / consultas / (matriz) / código de categoría
  • Resultados de seguimiento / consultas / (matriz) / código
  • Resultados de seguimiento / consultas / (matriz) / establecer hora
  • Resultados de seguimiento / consultas / (matriz) / código de estado
  • Resultados de seguimiento / información de la mercancía / (matriz) / descripción
  • Resultados de seguimiento / información de la mercancía / (matriz) / código

Contenido del paquete y motivo de la devolución

  • Resultados de seguimiento / contenido / (matriz) / número de piezas
  • Resultados de seguimiento / contenido / (matriz) / código de piezas
  • Resultados de seguimiento / contenido / (matriz) / descripción
  • Resultados de seguimiento / contenido / (matriz) / cantidad
  • Resultados de seguimiento / motivo de la devolución / (matriz) / código
  • Resultados de seguimiento / motivo de la devolución / (matriz) / descripción

Información de facturación

  • Resultados de seguimiento / receptores de factura / (matriz) / receptor de la factura / número de cuenta

Ventajas para los clientes:

  • Refuerce la confianza de los destinatarios gracias a las notificaciones proactivas de los cambios en tránsito de la fecha de entrega estimada y plazo de entrega.
  • Reduzca los costes del servicio de atención al cliente por llamadas de tipo WISMO (dónde está mi pedido), así como por disputas de entrega, al proporcionar una prueba fotográfica de entrega FedEx.
  • Mejore la experiencia del cliente gracias a las notificaciones casi en tiempo real del estado del envío.
  • Aumente el rendimiento operativo al recibir actualizaciones push en tiempo real sobre los envíos, sin necesidad de tener que comprobar continuamente si hay actualizaciones de seguimiento de cada envío.

Funciones y eventos de seguimiento


Eventos de seguimiento

Esta función permite realizar un seguimiento del estado de los envíos y notificar a los clientes de forma proactiva las distintas actualizaciones del proceso de envío. Ofrece a los clientes opciones para elegir la fase exacta del proceso o los eventos de envío cuya notificación/alerta desean recibir. Los eventos de envío disponibles son los siguientes:

  • Envío: esta opción genera una notificación cuando se produce el evento de envío seleccionado. Por ejemplo: etiqueta creada, recogida, etc.
  • En tránsito: esta opción genera una notificación para los eventos de tránsito del envío. Por ejemplo: en tránsito, artículo retenido en la oficina de entrega, etc.
  • Entrega: esta opción genera una notificación para los eventos de entrega del envío. Por ejemplo: en proceso de entrega, entregado, etc.
  • Excepciones: esta opción genera notificaciones para excepciones de entrega. Ejemplo: retrasos en el despacho de aduanas, etc.
  • Opciones de entrega adaptadas: seleccione esta opción para recibir notificaciones de eventos de seguimiento personalizados, por ejemplo, la aceptación de una solicitud de retener en centro.

Para obtener más información sobre las opciones de eventos de envío disponibles, consulte la tabla Códigos de estado y estados de los eventos de seguimiento de Advanced Integrated Visibility.


Prueba de entrega


Esta función se usa para confirmar que un pedido ha llegado correctamente al destino previsto. Esto incluye:

  • Prueba fotográfica de la entrega, que permite a los clientes recibir una foto que muestre la ubicación exacta de su paquete una vez que se entrega en su puerta.
    Advanced Integrated Visibility proporciona las imágenes de la prueba fotográfica de la entrega en la carga útil JSON en formato Base64. Las imágenes pueden luego convertirse al formato JPEG.

    Nota:

    • La prueba fotográfica de la entrega está disponible en EE. UU., Canadá, Puerto Rico, Hong Kong, Nueva Zelanda, Reino Unido e Irlanda.
    • La prueba fotográfica de la entrega solo está disponible para FedEx Ground, FedEx Express y para envíos o direcciones residenciales.
    • La prueba fotográfica de la entrega está disponible para entregas elegibles cuando no se requiere la prueba firmada de entrega. La prueba fotográfica de la entrega y la prueba firmada de entrega no están disponibles a la vez.
    • La prueba fotográfica de la entrega está disponible para entregas en las que no se precisa firma y que no se realizan directamente a un cliente (por ej., realizadas directamente a un cliente durante la entrega).
    • La prueba fotográfica de la entrega admite tamaños de imagen de 14.000 a 33.000 bytes (aplicable a imágenes de 320 × 240 de resolución).

     

  • Comprobante de entrega con imagen (Picture Proof of Delivery): el comprobante de entrega con imagen permite a los clientes recibir una foto que muestre la ubicación exacta del lugar en el que debe entregarse el paquete en caso de que dicha entrega no se pueda completar. Advanced Integrated Visibility proporciona las imágenes del comprobante de entrega con imagen en la carga útil JSON en formato Base64. Las imágenes pueden luego pasarse a formato JPEG.
    • La prueba fotográfica del intento de entrega está disponible en EE. UU. y Puerto Rico.
    • La prueba fotográfica del intento de entrega solo está disponible para FedEx Ground, FedEx Express y para envíos o direcciones residenciales y comerciales.
    • La imagen de la prueba fotográfica del intento de entrega puede ser:
      1. Una foto de la etiqueta de puerta.
      2. Una foto del impedimento para llegar al punto de entrega (p. ej., puerta cerrada).
      3. Imagen de paquetes entregados en la parada.
    • La prueba fotográfica del intento de entrega admite tamaños de imagen de 14.000 a 33.000 bytes (aplicable a imágenes de 320 × 240 de resolución).
  •  

  • La prueba firmada de entrega: permite a los clientes recibir una imagen de la firma del destinatario, así como su nombre y la fecha, la hora y la ubicación de la entrega. La información sobre la prueba firmada de entrega se presentará como una matriz de datos en lugar de como una imagen. La matriz de datos es una cadena codificada en Base64 que se debe descodificar para obtener la imagen final de la firma en formato PNG
    • La prueba firmada de entrega no está disponible para las suscripciones de número de seguimiento de Advanced Integrated Visibility.
    • El tamaño de imagen de la prueba firmada de entrega será de 4.000 a 6.000 bytes (aplicable a la resolución de imagen 400 × 95).
    • El tamaño de imagen de la prueba firmada de entrega será de 5.000 a 8.000 bytes (aplicable a la resolución de imagen 230 × 150).
  •  

  • Prueba de entrega por GPS:
    • La prueba de entrega por GPS permite a los clientes recibir las coordenadas geográficas de la ubicación de entrega.

      Nota: La prueba de entrega por GPS está disponible de forma predeterminada para suscripciones de número de cuenta de Advanced Integrated Visibility.

Eventos de fecha de entrega y plazo de entrega estimados


Esta función ayuda a los destinatarios de los envíos a planificar sus agendas indicando una fecha o un intervalo horario para las entregas de envíos. Esto incluye:

  • Fecha de entrega estimada: esta opción proporciona al destinatario una fecha de entrega estimada del envío. Por ejemplo: 20 de noviembre 20XX.
  • Plazo de entrega estimado: esta opción proporciona al destinatario un plazo de entrega estimado para el envío en el día de la entrega real. Por ejemplo: entre las 14:00 y las 18:00.


Filtrado basado en eventos


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

  • Envío de importación: seleccione esta opción para los envíos que se le entregarán a usted y que usted, como destinatario, pagará.
  • Envío de exportación: seleccione esta opción para los envíos que usted enviará y que usted, como remitente, pagará.
  • Terceros: seleccione esta opción para envíos de importación y de exportación facturados a usted como tercero pagador.

Nota: Su número de cuenta FedEx se usará para la facturación o el pago de los envíos. En caso de que sea tercero pagador, puede que no sea el remitente o el destinatario, pero los gastos se cargarán en su número de cuenta FedEx.


Política de reintentos

Esta función evita que FedEx envíe datos de eventos de seguimiento en caso de imprevistos por parte del cliente. FedEx conservará los datos y tratará de reenviarlos, con un máximo de 3 intentos en intervalos de 5 minutos.

Si FedEx no recibe una respuesta satisfactoria en dicho lapso de tiempo, detendrá el reenvío del evento en cuestión. Sin embargo, el cliente podrá solicitar el reintento de los eventos fallidos hasta 7 días después con el botón manual «REINTENTO» que aparece en la página Detalles del proyecto de Advanced Integrated Visibility webhook.

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

CLOSE

Response

Copy