Entenda como funciona o FEED

Este artigo explica como funciona o FEED no ANYMARKET, um dos formatos utilizados para comunicação entre o ANYMARKET e os sistemas integrados dos clientes.

Por meio do FEED, é possível consultar notificações relacionadas a alterações em módulos como pedidos, produtos, transmissões, perguntas e NF-e do Mercado Livre.

Neste artigo:

• Pré-requisitos
• Como funciona
• Tipos de FEED e endpoints
• Boas práticas
• Dúvidas comuns

Pré-requisitos

• Possuir integração com o ANYMARKET via API.
• Ter um sistema integrador preparado para consultar periodicamente o FEED.
• Processar as notificações retornadas pelo ANYMARKET.
• Confirmar a leitura das notificações após o processamento.

Como funciona

O FEED é um dos formatos disponíveis para estabelecer comunicação entre o ANYMARKET e os sistemas dos clientes.

Ele pode disponibilizar alterações nos principais módulos do sistema, como:

• Pedidos;
• Produtos;
• Transmissões;
• Perguntas;
• NF-e do Mercado Livre.

Ao contrário do PUSH, em que o ANYMARKET envia uma notificação para o sistema cadastrado, o FEED é considerado um método passivo.

Isso significa que o sistema integrador precisa consultar o ANYMARKET para verificar se existem notificações a serem lidas.

Essas notificações representam criações ou alterações, por exemplo, em pedidos e transmissões.

Etapas de funcionamento

A lógica do FEED é executada em três etapas principais:

1. Listagem das notificações
O primeiro passo é consultar quais notificações ocorreram recentemente, ou seja, quais atualizações ainda não foram processadas.

Essa etapa retorna o identificador do item alterado, que será utilizado nas próximas etapas.

2. Detalhamento da notificação
Em seguida, o sistema integrador deve utilizar o identificador obtido na etapa anterior para consultar o detalhamento da notificação.

Essa é a etapa mais importante para atualizar as informações no sistema integrado, pois é nela que as informações alteradas são disponibilizadas.

3. Confirmação de leitura
Por fim, o sistema integrador deve confirmar a leitura da notificação.

Essa confirmação remove a notificação do FEED, evitando leituras duplicadas e garantindo melhor desempenho na operação.

A confirmação é feita utilizando o mesmo identificador obtido na etapa de listagem.

Consultas periódicas

Por ser um método passivo, o FEED exige que o sistema integrador consulte regularmente o ANYMARKET para verificar se existem notificações a serem processadas.

O número de requisições por dia e o intervalo entre elas podem variar conforme o volume de atualizações esperado pelo sistema.

Rotinas de limpeza do FEED

Além das etapas executadas pelo sistema integrador, o ANYMARKET realiza rotinas para manter o ambiente performático.

Atualmente, existem duas rotinas principais:

• Limpeza de itens não lidos: remove regularmente notificações não lidas armazenadas há mais de 30 dias. Essa limpeza considera a data de criação da notificação.
• Limpeza de itens lidos: remove registros já lidos, também respeitando o prazo de 30 dias. Nesse caso, a limpeza considera a data de leitura, não a data de criação da notificação.

Importante: apenas as notificações são removidas nessas rotinas. Os pedidos ou transmissões vinculados a elas não são impactados.

Tipos de FEED e endpoints

FEED de pedidos

O FEED de pedidos é o mais completo. Nele, uma notificação é criada sempre que há alteração no status de uma venda, conforme as opções parametrizadas no ANYMARKET.

Importante: as notificações serão criadas somente para os status selecionados em tela. Atualizações de status não configurados não serão notificadas.

Além disso, as notificações são criadas apenas uma vez por status.

Endpoints relacionados ao FEED de pedidos:

• Listagem de notificações: /orders/feed
• Confirmação de leitura: /orders/feeds/{id}
• Detalhamento do pedido: /orders/{id}

Para o FEED de pedidos, também é possível incluir um pedido novamente no FEED, independentemente do status, utilizando o botão Sincronizar novamente com o ERP/Plataforma.

FEED de transmissões

O FEED de transmissões é mais simples. Ele notifica o sistema integrador quando ocorre criação, alteração ou exclusão de uma transmissão.

Endpoints relacionados ao FEED de transmissões:

• Listagem de notificações: /transmissions/feeds
• Confirmação de leitura: /transmissions/feeds/{id}
• Detalhamento da transmissão: /transmissions/{id}

Boas práticas

• Configure corretamente os status de pedido que devem gerar notificações.
• Lembre-se de que o ANYMARKET só criará notificações para os status selecionados na conta.
• Tenha atenção especial com pedidos fulfillment, pois a gestão dos status depende do marketplace.
• Desabilite status que não sejam necessários para o sistema integrado, reduzindo o volume de notificações no FEED.
• Ao consultar notificações durante o dia, busque equilíbrio entre número de requisições e limite de registros retornados.
• Prefira realizar mais requisições com menor volume de dados por chamada, garantindo mais agilidade na operação.
• Garanta que a notificação foi lida e processada antes de confirmar a leitura.
• Sempre confirme a leitura após o processamento da notificação.
• A confirmação de leitura evita acúmulo de informações no FEED, melhora a performance e reduz risco de processamento duplicado.

Dúvidas comuns

O que é o FEED?
É um formato de comunicação passivo em que o sistema integrador consulta o ANYMARKET para verificar se existem notificações de alterações a serem processadas.

Qual é a diferença entre FEED e PUSH?
No PUSH, o ANYMARKET envia uma notificação ao sistema cadastrado. No FEED, o sistema integrador precisa consultar o ANYMARKET para buscar notificações.

Quais são as etapas para usar o FEED?
Listar notificações, consultar o detalhamento e confirmar a leitura após o processamento.

Por que preciso confirmar a leitura?
Para remover a notificação do FEED, evitar leituras duplicadas e manter melhor desempenho na operação.

As notificações ficam disponíveis para sempre?
Não. Notificações lidas ou não lidas são removidas por rotinas de limpeza após 30 dias, conforme a regra aplicável.

A limpeza remove pedidos ou transmissões?
Não. Apenas as notificações são removidas. Os pedidos e transmissões vinculados não são impactados.

O FEED de pedidos notifica todos os status?
Não. Ele notifica apenas os status selecionados na parametrização da conta.

Pedidos fulfillment exigem algum cuidado?
Sim. Como a gestão de status depende do marketplace, o pedido pode não passar por todos os status esperados, impactando notificações conforme a configuração da conta.

É possível reenviar um pedido ao FEED?
Sim. No FEED de pedidos, é possível incluir um pedido novamente pelo botão Sincronizar novamente com o ERP/Plataforma.