Este artículo explica cómo funciona el FEED en ANYMARKET, uno de los formatos utilizados para la comunicación entre ANYMARKET y los sistemas integrados de los clientes.
Mediante el FEED, el sistema integrador puede consultar notificaciones sobre cambios en módulos como pedidos, productos, transmisiones, preguntas y NF-e de Mercado Libre.
En este artículo:
- Requisitos previos para usar el FEED
- Cómo funciona el FEED en ANYMARKET
- Tipos de FEED y endpoints
- Buenas prácticas
- Preguntas frecuentes
Requisitos previos para usar el FEED
- Tener una integración con ANYMARKET mediante API.
- Tener un sistema integrador preparado para consultar el FEED periódicamente.
- Procesar las notificaciones devueltas por ANYMARKET.
- Confirmar la lectura de las notificaciones después de procesarlas.
Cómo funciona el FEED en ANYMARKET
El FEED es uno de los formatos disponibles para establecer la comunicación entre ANYMARKET y los sistemas de los clientes.
El FEED puede poner a disposición los cambios en los principales módulos de ANYMARKET:
- Pedidos
- Productos
- Transmisiones
- Preguntas
- NF-e de Mercado Libre
Diferencia entre FEED y PUSH
En el PUSH, ANYMARKET envía una notificación al sistema registrado.
El FEED, en cambio, es un método pasivo: el sistema integrador debe consultar ANYMARKET para verificar si hay notificaciones pendientes de lectura.
Las notificaciones del FEED representan creaciones o cambios, por ejemplo, en pedidos y transmisiones.
Etapas de funcionamiento del FEED
La lógica del FEED se ejecuta en tres etapas principales:
- Listado de notificaciones: el sistema integrador consulta qué notificaciones ocurrieron recientemente, es decir, qué actualizaciones todavía no se procesaron. Esta etapa devuelve el identificador del ítem modificado, que se utiliza en las etapas siguientes.
- Detalle de la notificación: el sistema integrador utiliza el identificador obtenido en el listado para consultar el detalle de la notificación. Esta es la etapa más importante para actualizar el sistema integrado, porque en ella ANYMARKET pone a disposición la información modificada.
- Confirmación de lectura: el sistema integrador confirma la lectura de la notificación utilizando el mismo identificador obtenido en el listado. La confirmación elimina la notificación del FEED, evita lecturas duplicadas y garantiza un mejor rendimiento de la operación.
Consultas periódicas al FEED
Como el FEED es un método pasivo, el sistema integrador debe consultar ANYMARKET regularmente para verificar si hay notificaciones por procesar.
La cantidad de solicitudes por día y el intervalo entre ellas pueden variar según el volumen de actualizaciones esperado por el sistema integrador.
Rutinas de limpieza del FEED
Además de las etapas que ejecuta el sistema integrador, ANYMARKET realiza rutinas para mantener el rendimiento del entorno. Actualmente, existen dos rutinas principales:
- Limpieza de ítems no leídos: elimina regularmente las notificaciones no leídas almacenadas hace más de 30 días. Esta limpieza considera la fecha de creación de la notificación.
- Limpieza de ítems leídos: elimina las notificaciones ya leídas, también con un plazo de 30 días. En este caso, la limpieza considera la fecha de lectura, no la fecha de creación de la notificación.
Importante: las rutinas de limpieza eliminan solo las notificaciones. Los pedidos y las transmisiones vinculados a las notificaciones no se ven afectados.
Tipos de FEED y endpoints
FEED de pedidos
El FEED de pedidos es el más completo. ANYMARKET crea una notificación cada vez que cambia el estado de una venta, según las opciones configuradas en ANYMARKET.
Importante: ANYMARKET crea notificaciones solo para los estados seleccionados en la pantalla de configuración. Los cambios a estados no configurados no generan notificaciones.
Además, ANYMARKET crea una sola notificación por estado.
Endpoints del FEED de pedidos:
- Listado de notificaciones:
/orders/feed - Confirmación de lectura:
/orders/feeds/{id} - Detalle del pedido:
/orders/{id}
En el FEED de pedidos, también es posible incluir nuevamente un pedido en el FEED, sin importar su estado, con el botón Sincronizar nuevamente con el ERP/Plataforma.
FEED de transmisiones
El FEED de transmisiones es más simple. ANYMARKET notifica al sistema integrador cuando se crea, modifica o elimina una transmisión.
Endpoints del FEED de transmisiones:
- Listado de notificaciones:
/transmissions/feeds - Confirmación de lectura:
/transmissions/feeds/{id} - Detalle de la transmisión:
/transmissions/{id}
Buenas prácticas
Configuración de los estados del FEED de pedidos
- Configura correctamente los estados de pedido que deben generar notificaciones. ANYMARKET solo crea notificaciones para los estados seleccionados en la cuenta.
- Presta especial atención a los pedidos fulfillment, porque la gestión de sus estados depende del marketplace.
- Deshabilita los estados que el sistema integrado no necesita, para reducir el volumen de notificaciones en el FEED.
Consultas al FEED
- Al consultar notificaciones durante el día, busca un equilibrio entre la cantidad de solicitudes y el límite de registros devueltos.
- Prefiere hacer más solicitudes con menos datos por llamada, para garantizar mayor agilidad en la operación.
Confirmación de lectura
- Asegúrate de que la notificación fue leída y procesada antes de confirmar la lectura.
- Confirma siempre la lectura después de procesar la notificación. La confirmación de lectura evita la acumulación de información en el FEED, mejora el rendimiento y reduce el riesgo de procesamiento duplicado.
Preguntas frecuentes
¿Qué es el FEED de ANYMARKET?
El FEED es un formato de comunicación pasivo en el que el sistema integrador consulta ANYMARKET para verificar si hay notificaciones de cambios por procesar.
¿Cuál es la diferencia entre FEED y PUSH?
En el PUSH, ANYMARKET envía una notificación al sistema registrado. En el FEED, el sistema integrador debe consultar ANYMARKET para buscar las notificaciones.
¿Cuáles son las etapas para usar el FEED?
Listar las notificaciones, consultar el detalle de cada notificación y confirmar la lectura después de procesarla.
¿Por qué necesito confirmar la lectura de las notificaciones del FEED?
La confirmación de lectura elimina la notificación del FEED, evita lecturas duplicadas y mantiene un mejor rendimiento de la operación.
¿Las notificaciones del FEED quedan disponibles para siempre?
No. ANYMARKET elimina las notificaciones después de 30 días. Para las notificaciones no leídas, el plazo cuenta desde la fecha de creación. Para las notificaciones leídas, el plazo cuenta desde la fecha de lectura.
¿La limpieza del FEED elimina pedidos o transmisiones?
No. Las rutinas de limpieza eliminan solo las notificaciones. Los pedidos y las transmisiones vinculados no se ven afectados.
¿El FEED de pedidos notifica todos los estados?
No. El FEED de pedidos notifica solo los estados seleccionados en la configuración de la cuenta.
¿Los pedidos fulfillment requieren algún cuidado en el FEED?
Sí. Como la gestión de estados de los pedidos fulfillment depende del marketplace, el pedido puede no pasar por todos los estados esperados, lo que afecta las notificaciones según la configuración de la cuenta.
¿Puedo volver a enviar un pedido al FEED?
Sí. En el FEED de pedidos, puedes incluir nuevamente un pedido con el botón Sincronizar nuevamente con el ERP/Plataforma.
Comentarios
0 comentarios
El artículo está cerrado para comentarios.