Produtos

Para que o teste de produtos ocorra de forma correta e os itens criados para a homologação não sejam recusados durante as validações de seu sistema/ERP/plataforma, é preciso seguir algumas orientações

Quais as melhores práticas?

• Sempre utilizar o x-accountmanager-key fornecido no início do processo de homologação;

• O método POST deve ser utilizado exclusivamente para a criação do produto e qualquer alteração deve ser realizada através do PUT;

• Para a homologação, nas tarefas que solicitam a atualização de campos específicos, não serão aceitos os PUTs contendo a estrutura completa do item;

• A atualização de um produto simples é feita no endpoint PUT /products/{sku};

• A atualização de uma variação deve ser feita em PUT /variations/{sku};

• Todos os produtos criados devem conter a estrutura básica requerida (para mais detalhes, é possível acessar a seção Validações: Produtos);

• Para todas as tarefas que exigem criação de produtos serão analisados SKUs o mais próximo da realidade, portanto não serão aceitas evidências com informações genéricas (Exemplo: "Name": "Produto Teste", "Description": "Descrição Teste");

• As URLs das imagens devem estar com a hospedagem "HTTPS" aberta e não corrompida. O servidor não pode ter redirecionamentos, ou seja, o arquivo enviado precisa ser a própria imagem e não uma página intermediária como espelho;

• O peso do produto deve ser enviado em quilogramas (Kg);

• Dimensões devem ser enviadas em centímetros (cm);

• Em produtos com variação, deve ser enviado o qty (estoque) por variação;

• A Key de um atributo da variação (atributo responsável por diferenciar uma variação da outra) deve ser informada em "variation_attributes". Neste caso, solicitamos que não sejam definidos os campos price e promotional_price para diferenciar as variações;

• Crossdocking deve ser enviado em forma de atributo em "specifications";

• Deve ser respeitado o limite de requisições, caso contrário retornará erro 429. Ao receber um retorno 429, será necessário aguardar até o próximo minuto para realizar uma nova requisição;

• Caso receba um erro da família 4XX, deve ser realizada uma nova tentativa e em paralelo é necessário tratar a mensagem de erro;

• Caso receba um erro da família 5XX, deve ser realizada uma nova tentativa. Caso o erro persista, pedimos que entre em contato para que possamos analisar mais detalhadamente o retorno.