Pular para o conteúdo principal

Feed

Caso utilize o fluxo de Feed seja como contigência ou normal, é importante entender alterações nas entidades gera um registro no Feed para se seja consumido, assim como o funcionamento da Callback.

Estes Registro pode ser obtido através do endpoint do seu respectivo Feed.

Feed de pedido - /v2/orders/feeds

Feed de transmissão - /v2/transmissions/feeds

Feed de reserva de estoque - em construção

Fluxo​

Para o bom funcionamento do Feed, seja ele de pedido, de transmissão ou de reserva de estoque, é necessário que após o processamento da informação, o integrador envie uma requisição confirmando a leitura deste registro, para que a notificação seja considerada como lida e não mais apresentada nas consultas.

O processo ideal é:

  1. Leitura da lista de Feeds, obtendo a lista de registros atualizados (método GET nos endpoins citados acima);
  2. Obtenção dos detalhes do registro atualizado, como por exemplo, dando um GET no pedido com notificação no Feed;
  3. Processamento do pedido, no caso, no sistema do parceiro integrador. Neste ponto, é importante que o integrador garanta a unicidade das informações, tratando os IDs como chaves únicas;
  4. Envio de uma notificação do tipo PUT para marcar o Feed como lido, não sendo apresentado novamente na listagem de notificações.

Feed de Pedido​

O Feed de pedido, por ser amplamente utilizado, possui algumas particularidades adicionais. Abaixo estão listadas as principais delas. Tome cuidado com estes pontos ao desenvolver a sua integração.

  • Renotificação: o ANYMARKET pode notificar o mesmo pedido, para o mesmo status, mais de um vez em cenários específicos. Aplicamos regras para tentar minimizar estas ocorrências, porém, o cliente integrador precisa garantir a unicidade de um pedido através do ID do pedido. Geralmente, os seguintes cenários podem ocorrer:
    • Situações de Instabilidade: caso ocorram falhas em serviços externos ou durante manutenções programadas no ANYMARKET.
    • Atualização de Dados pelo Marketplace: se o canal de venda nos enviar uma alteração nos dados do pedido (mesmo que o status seja o mesmo), nós avisaremos você.
    • Correção de Erros na Fonte: Quando o próprio marketplace nos reenvia uma notificação para corrigir uma informação.
    • Ação manual do usuario na tela de pedido: Quando o usuário seleciona o pedido na tela do ANY e aciona a funcionalidade "Sincronizar com: Erp/Plataforma".
perigo

Atenção​

Notificações no Feed ficam disponíveis para leitura por até 30 dias a partir do momento da sua criação. Após este prazo, os registros não serão mais apresentados.