Saltar al contenido principal

Feed

Si utiliza el flujo de Feed, ya sea como contingencia o de forma normal, es importante entender que las modificaciones en las entidades generan un registro en el Feed para que sea consumido, así como el funcionamiento del Callback.

Estos registros se pueden obtener a través del endpoint de su respectivo Feed.

Feed de pedido - /v2/orders/feeds

Feed de transmisión - /v2/transmissions/feeds

Feed de reserva de stock - en construcción

Flujo​

Para el correcto funcionamiento del Feed, ya sea de pedido, de transmisión o de reserva de stock, es necesario que después del procesamiento de la información, el integrador envíe una solicitud confirmando la lectura de ese registro, para que la notificación sea considerada como leída y no se muestre más en las consultas.

El proceso ideal es:

  1. Lectura de la lista de Feeds, obteniendo la lista de registros actualizados (método GET en los endpoints mencionados anteriormente);
  2. Obtención de los detalles del registro actualizado, por ejemplo, realizando un GET en el pedido con notificación en el Feed;
  3. Procesamiento del pedido, en este caso, en el sistema del socio integrador. En este punto, es importante que el integrador garantice la unicidad de la información, tratando los IDs como claves únicas;
  4. Envío de una notificación del tipo PUT para marcar el Feed como leído, impidiendo que aparezca nuevamente en la lista de notificaciones.

Feed de Pedido​

El Feed de pedido, por ser ampliamente utilizado, tiene algunas particularidades adicionales. A continuación se enumeran las principales. Tenga cuidado con estos puntos al desarrollar su integración.

  • Renotificación: ANYMARKET puede notificar el mismo pedido, para el mismo estado, más de una vez en escenarios específicos. Aplicamos reglas para intentar minimizar estas ocurrencias; sin embargo, el cliente integrador debe garantizar la unicidad de un pedido a través del ID del pedido. En general, pueden ocurrir los siguientes escenarios:
    • Situaciones de Inestabilidad: cuando se producen fallas en servicios externos o durante mantenimientos programados en ANYMARKET.
    • Actualización de Datos por el Marketplace: si el canal de venta nos envía una modificación en los datos del pedido (aunque el estado sea el mismo), le notificaremos.
    • Corrección de Errores en la Fuente: cuando el propio marketplace nos reenvía una notificación para corregir una información.
    • Acción manual del usuario en la pantalla de pedido: cuando el usuario selecciona el pedido en la pantalla de ANY y activa la funcionalidad "Sincronizar con: Erp/Plataforma".
peligro

Atención​

Las notificaciones en el Feed están disponibles para su lectura hasta 30 días a partir del momento de su creación. Después de este plazo, los registros no serán presentados nuevamente.