Entiende cómo funciona el PUSH – Anytools Latam

Este artículo explica cómo funciona el PUSH en ANYMARKET, uno de los formatos utilizados para la comunicación entre ANYMARKET y los sistemas integrados de los clientes. A través del PUSH, ANYMARKET envía notificaciones activas sobre cambios en módulos como pedidos, productos, transmisiones, preguntas y NF-e de remesa.

Requisitos previos para usar el PUSH

Tener una integración entre ANYMARKET y un sistema externo, como un ERP o una plataforma.
Tener una URL configurada para recibir las notificaciones.
Definir qué tipos de PUSH se enviarán a la URL registrada.
Asegurarse de que el sistema integrado esté preparado para recibir y procesar las notificaciones.

Cómo funciona el PUSH en ANYMARKET

El PUSH es uno de los formatos disponibles para establecer la comunicación entre ANYMARKET y los sistemas de los clientes.

El PUSH puede informar cambios en los principales módulos del sistema:

Pedidos;
Productos;
Transmisiones;
Preguntas;
NF-e de remesa.

A diferencia del FEED, que es un método pasivo de comunicación, el PUSH envía notificaciones de forma activa a los sistemas registrados. De esta manera, la información se mantiene actualizada entre ANYMARKET y el ERP o sistema integrado.

Cuando ocurren cambios en ANYMARKET en los tipos configurados para una URL, ANYMARKET envía una notificación para informar al otro sistema que hubo cambios.

Al recibir la notificación, el sistema integrado puede sincronizar la información y mantener sus datos actualizados.

Reintentos automáticos de envío del PUSH

Como el PUSH es una solución genérica que puede integrarse con diferentes sistemas, ANYMARKET cuenta con un control de reintentos automáticos para aumentar la garantía de entrega de las notificaciones.

El control de reintentos vuelve a enviar una notificación que presentó error algunas veces en un intervalo corto, con el objetivo de entregar al sistema socio los cambios ocurridos en ANYMARKET.

El reintento automático se realiza hasta 6 veces para una misma notificación, con nuevos intentos dentro de un plazo de hasta 5 minutos.

Si la notificación no se entrega después de los reintentos, el envío por PUSH se interrumpe. Según la configuración de la URL, la notificación puede quedar disponible en el FEED.

Bloqueos de URL por fallas recurrentes

Si se identifican varias fallas consecutivas en las URL configuradas, ANYMARKET puede aplicar bloqueos temporales o permanentes a la URL, según la gravedad.

Los bloqueos evitan la acumulación de información innecesaria en las colas de procesamiento y garantizan más agilidad para todos los clientes de ANYMARKET.

Campos de la callback y tipos de PUSH

Campos de la callback

Una callback está compuesta por la información necesaria para que funcione según la necesidad del cliente. Además de los tipos de PUSH, los principales campos de la callback son:

Clasificación: determina si la callback es automática o personalizada. La callback automática la crea ANYMARKET y solo permite configurar la Identificación. Las callbacks personalizadas las crea el seller en el panel.
Identificación: facilita reconocer las callbacks registradas en ANYMARKET.
URL: es la dirección a la que ANYMARKET enviará la notificación del sistema interesado.
Contingencia por FEED: permite que las notificaciones del PUSH que no fueron recibidas por la URL configurada puedan obtenerse mediante consulta en el FEED.

Importante: la Contingencia por FEED funciona solo para pedidos y transmisiones, que son los tipos que tienen FEED.

Para entender cómo funciona el FEED, accede al artículo sobre FEED.

A continuación, un ejemplo de callback personalizada configurada:

Tipo de PUSH Pedido

El PUSH de Pedido es el tipo más completo y también el más utilizado.

En el tipo Pedido es posible elegir qué estados del pedido generarán una notificación para la URL configurada.

Si no quieres enviar notificaciones de un estado específico, o si el sistema centralizador no utiliza alguno de los estados, basta con no seleccionar ese estado.

Tipos de PUSH Producto y Transmisión

Después de Pedido, los tipos Producto y Transmisión son los más utilizados en ANYMARKET. Los tipos Producto y Transmisión están disponibles para todos los tipos de productos y todas las transmisiones.

En los tipos Producto y Transmisión es posible elegir si se notifica ante:

Creación de registros;
Edición de registros;
Eliminación de registros.

Importante: los cambios de precio y inventario se notifican por el tipo Transmisión, y no por el tipo Producto. El tipo Producto es exclusivo para cambios de registro en los productos.

Tipos de PUSH Pregunta y NF-e de Remesa

Los tipos Pregunta y NF-e de Remesa existen solo para Mercado Libre. Por eso, son tipos menos utilizados y más específicos.

Los tipos Pregunta y NF-e de Remesa tienen un comportamiento similar al de los tipos Producto y Transmisión.

Buenas prácticas

Configura una URL estable y preparada para recibir notificaciones.
Selecciona solo los tipos y estados que el sistema integrado realmente utiliza.
Usa la Identificación de la callback para facilitar la gestión de varias URL.
Activa la Contingencia por FEED para pedidos y transmisiones cuando tenga sentido para la operación.
Asegúrate de que el sistema integrado procese correctamente las notificaciones recibidas.
Monitorea las fallas recurrentes para evitar bloqueos temporales o permanentes de la URL.
Recuerda que los cambios de precio y inventario se notifican por el tipo Transmisión.

Preguntas frecuentes

¿Qué es el PUSH en ANYMARKET?
El PUSH es un formato de comunicación activa en el que ANYMARKET envía notificaciones a los sistemas registrados cuando ocurren cambios en los tipos configurados.

¿Cuál es la diferencia entre PUSH y FEED?
En el PUSH, ANYMARKET envía notificaciones de forma activa a la URL configurada. En el FEED, el sistema integrador consulta ANYMARKET para verificar si hay notificaciones disponibles.

¿Qué pasa si mi URL no recibe la notificación del PUSH?
ANYMARKET realiza reintentos automáticos y vuelve a enviar la notificación hasta 6 veces en un plazo de hasta 5 minutos.

¿Pierdo la notificación si fallan todos los reintentos?
El envío por PUSH se interrumpe. Si la URL tiene la Contingencia por FEED activada, la notificación puede consultarse en el FEED, cuando el tipo lo permita.

¿La Contingencia por FEED funciona para todos los tipos de PUSH?
No. La Contingencia por FEED funciona solo para pedidos y transmisiones.

¿Por qué mi URL puede ser bloqueada?
Varias fallas consecutivas en la URL configurada pueden generar bloqueos temporales o permanentes, según la gravedad.

¿Qué tipos de PUSH existen en ANYMARKET?
Pedido, Producto, Transmisión, Pregunta y NF-e de Remesa.

¿Los cambios de precio y inventario se notifican por el tipo Producto?
No. Los cambios de precio y inventario se notifican por el tipo Transmisión.

¿Cuál es el tipo de PUSH más completo?
El tipo Pedido es el más completo, porque permite seleccionar los estados que generarán una notificación para la URL configurada.