Entenda como funciona o PUSH

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

Por meio do PUSH, é possível enviar notificações ativas sobre alterações em módulos como pedidos, produtos, transmissões, perguntas e NF-e de remessa.

Neste artigo:

• Pré-requisitos
• Como funciona
• Campos e tipos de PUSH
• Boas práticas
• Dúvidas comuns

Pré-requisitos

• Possuir integração entre o ANYMARKET e um sistema externo, como ERP ou plataforma.
• Ter uma URL configurada para recebimento das notificações.
• Definir quais tipos de PUSH devem ser enviados para a URL cadastrada.
• Garantir que o sistema integrado esteja preparado para receber e processar as notificações.

Como funciona

O PUSH é 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 de remessa.

Ao contrário do FEED, que é um método passivo de comunicação, o PUSH envia notificações ativamente para os sistemas cadastrados.

Com isso, as informações podem se manter atualizadas entre o ANYMARKET e o ERP ou sistema integrado.

Quando ocorrem alterações no ANYMARKET nos tipos configurados para determinada URL, o ANYMARKET envia uma notificação informando ao outro sistema que houve mudanças.

Com o recebimento dessa notificação, o sistema integrado consegue sincronizar as informações e manter seus dados atualizados.

Retentativas

Como o PUSH é uma solução genérica que pode ser integrada a diferentes sistemas, existe um controle de retentativas automáticas para aumentar a garantia de entrega das notificações.

Esse controle tenta reenviar uma notificação que apresentou erro algumas vezes em um curto intervalo, buscando entregar ao sistema parceiro as mudanças ocorridas no ANYMARKET.

A retentativa automática é realizada até 6 vezes para uma mesma notificação, com novas tentativas dentro de até 5 minutos.

Caso a notificação não seja entregue após essas tentativas, o envio por PUSH é interrompido. Dependendo da configuração da URL, a notificação pode ficar disponível no FEED.

Bloqueios

Caso sejam identificadas diversas falhas subsequentes nas URLs configuradas, o ANYMARKET pode aplicar bloqueios temporários ou permanentes na URL, conforme a severidade.

Essa prática evita o acúmulo de informações desnecessárias nas filas de processamento, garantindo mais agilidade para todos os clientes do ANYMARKET.

Campos e tipos de PUSH

Campos da callback

Uma callback é composta por informações necessárias para que funcione conforme a necessidade do cliente.

Além dos tipos de PUSH, os principais campos são:

• Classificação: determina se a callback é automática ou personalizada. A automática é criada pelo próprio ANYMARKET e permite configurar apenas a identificação. Já as personalizadas são criadas pelo seller no painel;
• Identificação: utilizada para facilitar a identificação das callbacks cadastradas no ANYMARKET;
• URL: é o caminho para onde o ANYMARKET enviará a notificação ao sistema interessado;
• Contingência por FEED: permite que notificações do PUSH que não foram recebidas pela URL configurada possam ser obtidas por consulta no FEED.

Importante: a contingência por FEED funciona apenas para pedidos e transmissões, que são os tipos que possuem FEED.

Para entender como funciona o FEED, acesse: artigo sobre FEED.

Abaixo, um exemplo de callback personalizada configurada:

Tipos de PUSH

Pedido

O PUSH de pedido é o tipo mais completo e também o mais utilizado.

Nesse tipo, é possível escolher os status de pedido que irão gerar notificação para a URL configurada.

Caso você não queira enviar notificação de um status específico, ou se o sistema centralizador não utiliza algum desses status, basta não selecioná-lo.

Produto e transmissão

Depois dos pedidos, os tipos Produto e Transmissão estão entre os mais utilizados no ANYMARKET.

Eles estão disponíveis para todos os tipos de produtos e todas as transmissões.

Nesses casos, é possível escolher se deseja notificar mediante:

• Criação de registros;
• Edição de registros;
• Exclusão de registros.

Importante: alterações de preço e estoque são feitas pelo tipo Transmissões, e não pelo tipo Produtos. O tipo Produtos é exclusivo para alterações cadastrais nos produtos.

Pergunta e NF-e de remessa

Os tipos Pergunta e NF-e de Remessa existem apenas para o Mercado Livre.

Por isso, são menos utilizados e mais específicos.

Esses tipos possuem comportamento semelhante ao de Produto e Transmissão.

Boas práticas

• Configure uma URL estável e preparada para receber notificações.
• Selecione apenas os tipos e status realmente utilizados pelo sistema integrado.
• Use a identificação da callback para facilitar a gestão de múltiplas URLs.
• Ative a contingência por FEED para pedidos e transmissões quando fizer sentido para a operação.
• Garanta que o sistema integrado processe as notificações recebidas de forma adequada.
• Monitore falhas recorrentes para evitar bloqueios temporários ou permanentes da URL.
• Lembre-se de que alterações de preço e estoque são notificadas por Transmissões.

Dúvidas comuns

O que é o PUSH?
É um formato de comunicação ativa em que o ANYMARKET envia notificações para sistemas cadastrados quando ocorrem alterações nos tipos configurados.

Qual é a diferença entre PUSH e FEED?
No PUSH, o ANYMARKET envia notificações ativamente para a URL configurada. No FEED, o sistema integrador consulta o ANYMARKET para verificar se existem notificações disponíveis.

O que acontece se a URL não receber a notificação?
O ANYMARKET realiza retentativas automáticas, tentando reenviar a notificação até 6 vezes em até 5 minutos.

Depois das retentativas, a notificação é perdida?
O envio por PUSH é interrompido. Caso a URL esteja configurada com contingência por FEED, a notificação poderá ser consultada pelo FEED, quando aplicável.

A contingência por FEED funciona para todos os tipos?
Não. Ela funciona apenas para pedidos e transmissões.

O que pode causar bloqueio da URL?
Diversas falhas subsequentes na URL configurada podem gerar bloqueios temporários ou permanentes, conforme a severidade.

Quais tipos de PUSH existem?
Pedido, Produto, Transmissão, Pergunta e NF-e de Remessa.

Alterações de preço e estoque são notificadas por Produto?
Não. Alterações de preço e estoque são notificadas pelo tipo Transmissões.

Pedido é o tipo de PUSH mais completo?
Sim. O tipo Pedido permite selecionar os status que irão gerar notificação para a URL configurada.