Melhores práticas
Neste tópico será possível verificar as melhores práticas para que possa efetuar a requisição de forma adequada e como se comportar durante erros na API.
Monitore a sua aplicação
Você monitora os status HTTP 4XX que a sua aplicação está recebendo?
Caso receba um erro HTTP 4XX, você deve efetuar a requisição novamente e em paralelo analisar o erro, para identificar o motivo do erro, para que efetue a correção.
Uma vez que o efetuado a correção, mas o erro persiste, pedimos que entre em contato, para que possamos analisar.
Você monitora os status HTTP 5XX que a sua aplicação está recebendo?
Uma vez que o erro o retorno do erro é HTTP 5XX, pedimos que efetue uma nova tentativa, pois o mesmo pode se tratar de uma intermitência.
Caso o erro persista, pedimos que entre em contato para que possamos analisar a causa raiz do erro.
Cuidado com o limite de requisições
Tenha cuidado para não ultrapassar os "Limites de requisições" da nossa API. Caso a sua aplicação receba um HTTP 429, ela deve parar de fazer requisições por um tempo até que uma nova janela comece a contar.
Cuidado com datas onde ocorre um alto volume de vendas, como a Black Friday. Acontece de o desenvolvedor colocar mais máquinas para ter uma "integração mais rápida" e ser barrado no nosso limite de requisições.
Infraestrutura
Nossa infraestrutura está localizada nos servidores do Leste dos EUA, caso seus servidores estejam alocados em outra região podemos ter um tempo de resposta acrescido em 200ms.
Notificação da API
O Marketplace irá receber a notificação das atualizações que ocorrerem do lado do Seller ou seja:
Novo Produto
Alteração de produto
Atualização de status do pedido (Tracking)
Cadastro de Produtos
Informações que irão compor um cadastro de produtos na Seller:
ID do SKU (Alfanumérico)
Nome do SKU (Título utilizado para realizar o anuncio do Produto)
Descrição do SKU (texto sem limite de tamanho)
Marca do Produto
Dimensões tais como:
Largura
Altura
Peso em Quilograma (KG)
Comprimento
Mínimo de 2 imagens
Dimensões da imagem:
Tamanho atual: 500X500
Formato: JPEG
EAN: Código de barras do SKU
Categoria: Árvore da categorização do produto.
Atributos: Tais como cor, voltagem, litragem, polegadas, Sabor e entre outros atributos de definição.
Atualização de Preço e Estoque
Consulta apenas o necessário, evite consultar preço e estoque que não foram notificados alterações, isso contribui com as boas práticas de consumo de recurso de serviço, faça o uso consciente dos nossos API services.
Calculo de Frete
O tempo de resposta do serviço de cálculo de frete é uma das partes mais importantes para Marketplace, pois nele existem informações extremamente relevantes, se você observa na nossa documentação, o cálculo de frete retorna o preço e estoque atual, e retorna as condições de entrega disponíveis para aquele CEP.
Cancelamento de Pedido
No processo de cancelamento de pedido existe dois fluxos:
O cancelamento de um pedido pendente de confirmação de pagamento, onde o Seller irá apenas derrubar a reserva de estoque e cancelar o mesmo.
O cancelamento de pedido após a aprovação, que irá apenas notificar o Seller para que "barre" o faturamento, despacho ou entrega do produto. Poderá ocorrer de não ser possível o cancelamento efetivo, então é conveniente que este tipo de cancelamento seja feito pelo próprio Seller para que tome a ação imediata.
Consulta de Pedidos
Consulta apenas quando necessário, priorize a utilização das notificações para a atualização do status do pedido, isso contribui com as boas práticas de consumo de recurso de serviço, faça o uso consciente dos nossos API services.
Last updated
Was this helpful?