# Produtos

### Quais as melhores práticas?

* Sempre utilizar o ***x-accountmanager-key*** fornecido no início do processo de homologação;
* O método <mark style="color:red;">POST</mark> deve ser utilizado exclusivamente para a <mark style="color:red;">criação</mark> do produto e qualquer <mark style="color:green;">alteração</mark> deve ser realizada através do <mark style="color:green;">PUT</mark>;
* 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](/processo-de-homologacao/validacoes/produtos-validacao.md#o-que-sera-validado-durante-o-processo-de-homologacao));
* 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;
* Deve ser respeitado o limite de requisições, caso contrário retornará erro <mark style="color:red;">429</mark>. Ao receber um retorno <mark style="color:red;">429</mark>, será necessário aguardar até o próximo minuto para realizar uma nova requisição;
* Caso receba um erro da família <mark style="color:red;">4XX</mark>, deve ser realizada uma nova tentativa e em paralelo é necessário tratar a mensagem de erro;
* Caso receba um erro da família <mark style="color:red;">5XX</mark>, deve ser realizada uma nova tentativa. Caso o erro persista, pedimos que entre em contato para que possamos analisar mais detalhadamente o retorno.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://desenvolvedores.skyhub.com.br/processo-de-homologacao/melhores-praticas-valid/pratica_produto.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.