La suscripción de número de seguimiento de Advanced Integrated Visibility se ha diseñado para que los suscriptores del servicio administren sus proyectos de webhook de Advanced Integrated Visibility y lleven a cabo todas las operaciones relacionadas con estos, como añadir nuevos números de seguimiento y editar o ver los detalles de una tarea mediante los puntos de conexión de la API.

Nota:

• Debe tener acceso como administrador o colaborador al proyecto de Advanced Integrated Visibility
• Para obtener más información sobre Advanced Integrated Visibility y todas sus funciones, visite la página de Documentación de Advanced Integrated Visibility.

Las ventajas de la Suscripción de número de seguimiento de Advanced Integrated Visibility son las siguientes:

• Puede actualizar y gestionar fácilmente los números de seguimiento de su proyecto de Advanced Integrated Visibility con los puntos de conexión de la API.
• Esta API le permite vincular varios números de seguimiento a su proyecto en una única transacción de API, en lugar de tener que seleccionarlos uno a uno.
• Puede enviar solicitudes a la API de forma consecutiva y consultar los datos de registro para comprobar que las solicitudes se han realizado correctamente.

Use los siguientes puntos de conexión para gestionar su proyecto de Advanced Integrated Visibility:

Solo podrá acceder a esta API a través del resumen de proyecto, como se muestra en la captura de pantalla anterior.

Utilice este punto de conexión para activar una tarea asíncrona que vincule uno o varios números de seguimiento a un proyecto concreto de Advanced Integrated Visibility.

Los datos necesarios para esta solicitud son:

• Acción: especifique la acción que se vaya a ejecutar cuando envíe la solicitud. Por ejemplo: AÑADIR.
• Detalles del número de seguimiento: indique el número de seguimiento.

Puede vincular hasta un máximo de 1000 números de seguimiento en una misma solicitud. La respuesta positiva a la solicitud le devolverá el ID de la tarea, su estado actual y la marca temporal de la creación y la finalización de dicha tarea. El ID de tarea se podrá usar más tarde para comprobar el estado de la tarea asíncrona.

Utilice este punto de conexión para averiguar el estado de una tarea asíncrona (con una o varias solicitudes consecutivas en cola) o el estado de todas las tareas enviadas.

Los datos necesarios para esta solicitud son:

• ID de tarea: indique el ID de la tarea cuyo estado quiera recuperar.

Nota: En este punto de conexión no es obligatorio introducir un ID de tarea. Si no indica ninguno, obtendrá el estado de todas las tareas enviadas.

La respuesta positiva a la solicitud le devolverá el ID de la tarea, su estado actual y la marca temporal de la creación y la finalización de dicha tarea. También le mostrará el estado actual de las tareas. Además, la respuesta también podrá incluir mensajes de confirmación, errores o advertencias para que los usuarios los vean y solucionen los problemas según corresponda.

• Si el estado de la tarea figura como COMPLETADO, significa que se han validado y procesado correctamente todos los números de seguimiento.
  • El estado de COMPLETADO significa que los números de seguimiento se han validado y procesado correctamente. Sin embargo, esto no significa que todos los números de seguimiento se han añadido correctamente al proyecto de Advanced Integrated Visibility.
  • Si intenta vincular varios números de seguimiento, aunque se vinculen solo algunos y no todos, el estado de la tarea se actualizará igualmente a COMPLETADO. Para comprobar el estado de cada número de seguimiento de la solicitud de vinculación, tendrá que descargar el informe de tareas por lote.

Nota:

• Si el estado de la tarea figura como ERROR, significa que, debido a varias razones o errores graves, no se ha podido procesar la solicitud y el usuario tiene que volver a intentarlo.

A continuación se detallan los diferentes estados y sus respectivas descripciones:

Utilice este punto de conexión para descargar un informe JSON de una tarea asíncrona que tenga un estado de COMPLETADO.

Los datos necesarios asociados a esta solicitud son:

• ID de tarea: indique el ID de la tarea cuyo estado quiera recuperar.

Nota:

• En este punto de conexión es obligatorio introducir un ID de tarea.
• Puede descargar el informe de una sola tarea asíncrona a la vez.
• Si la tarea no aparece con el estado de COMPLETADO e intenta descargar el informe, aparecerá un mensaje de error.

La respuesta positiva a esta solicitud le proporcionará el informe de la tarea en formato JSON.

• Con cada solicitud se pueden vincular hasta 1000 números de seguimiento de envíos a un proyecto de Advanced Integrated Visibility.
• No existe ningún límite en cuanto al máximo de números de seguimiento que se pueden vincular a un determinado proyecto de Advanced Integrated Visibility.
• Todo número de seguimiento se desvinculará de un proyecto de Advanced Integrated Visibility transcurridos 40 días.
• Los detalles y el estado del ID de tarea de los proyectos de Advanced Integrated Visibility dejarán de estar disponible pasados los 90 días de su creación.
• La información de seguimiento protegida, como la dirección o la firma del destinatario, no estará disponible a través de la Suscripción de número de seguimiento de Advanced Integrated Visibility.