Produtos

A entidade Produtos permite gerenciar os produtos no Mercos. Com ela você também pode controlar informações como grades (variações) e categorias.

Para gerenciar as variações dos Produtos, utilize o campo produtos_grade, como no exemplo em parâmetros do JSON de envio dos Produtos Grade.

Para gerenciar as imagens dos Produtos, deverá ser utilizada a entidade Imagens do Produto 🔗 informando o ID do produto.

Para gerenciar diferentes preços dos mesmos produtos, deverá ser utilizada a entidade Tabelas de Preço 🔗 informando o ID do produto.

Já para Categorias de Produtos 🔗 basta informar o ID da categoria no campo categoria_id do JSON de envio do produto.

Filtro disponível

Você pode aplicar o seguinte filtro na consulta GET:

• excluido:
  • 0 ou false = Não excluído
  • 1 ou true = Excluído

Exemplo: ?excluido=false

Estrutura da Resposta (GET)

Parâmetros de Envio - Produto simples (POST / PUT)

Parâmetros do JSON de envio dos Produtos Grade: objeto produtos_grade (POST / PUT)

Quando realizar uma requisição do tipo PUT, só envie os campos que deseja alterar. Não é possível alterar os itens de variação de um produto por este endpoint.

Para maiores detalhes de implementação e de como estes produtos funcionam, baixe: Guia Produtos Grade

⚠️

Importante:

Não deve ser enviado itens_variacoes_ids e itens_variacoes_nomes no mesmo produto grade. Escolha uma das duas

Estrutura da resposta (POST / PUT)

Sucesso

Caso a requisição seja um sucesso a resposta retornará o id do produto e o id e código de seus produtos grade, na mesma ordem que foram enviados, no Body da requisição.

Esses ids devem ser armazenados caso seja necessário fazer alterações posteriormente.

Exemplo:

{
    "id": 190,
    "produtos_grade": [
        {
            "id": 191,
            "codigo": "123"
        }
    ]
}

Erro

Caso a requisição encontre um ou mais erros, eles serão retornados informado campo e o tipo de erro, no Body da requisição.

Exemplo:

 {
  "mensagem": "Dados inválidos",
  "erros": [
        {
            "campo": "produtos_grade",
            "mensagem": "Não é possível criar um produto grade excluído."
        }
  ]
}