top of page

Início > Integração

Versão: 2.0

Grupo de produtos

Última Atualização: 24/09/2024

Esta integração tem o objetivo de gerenciar grupos de produtos.

Sintaxe da Resposta

Caso ocorra tudo certo com a requisição e retorne o status code 200, essa será a resposta que você receberá:

Elementos da Requisição

O corpo desta requisição consiste em um Array contendo os dados da relação entre produto e grupo de produtos em formato JSON.

detail

Detalhes da requisição.

Tipo: JSON.

success

Identificador booleano de sucesso da requisição.

Tipo: Boolean.

message

Mensagem de sucesso ou falha da requisição.

Tipo: String.

data

Dados de retorno da requisição.

Tipo: JSON.

produto

Id do produto (código yeh).

Tipo: String.

ean_dun

Código ean ou dun do produto.

Tipo: String.

id_grupo

Id do grupo.

Tipo: Integer.

GET Grupo de produtos

Última Atualização: 24/09/2024

Este endpoint permite a visualização dos grupos de produtos associados ao fornecedor.

Endpoint GET

POST Grupo de produtos

Última Atualização: 24/09/2024

Este endpoint permite o envio e atualização de grupos de produtos, incluindo a adição e remoção de produtos de grupos específicos.

Caso a relação não exista, uma nova relação será criada.

Caso o produto já esteja relacionado a algum grupo, a relação será substituída para o novo grupo especificado.

Endpoint POST

Sintaxe da Requisição

Para que a requisição do método Post seja bem-sucedida, é necessário que

seja passado os seguintes valores dentro de um JSON:

Elementos da Requisição

produtos

Produtos do grupo.

Tipo: Array de JSON.

ean_dun

​Código ean ou dun do produto.

Tipo: String.

id_grupo

Id do grupo.
Obs: 
Se o produto já estiver relacionado a algum grupo e o campo 'grupo_id' for 'null', o produto será removido desse grupo.

Tipo: Integer.

Sintaxe da Resposta

Caso ocorra tudo certo com a requisição e retorne o status code 200, essa será a resposta que você receberá:

Criação da relação entre produtos e grupos.

Remoção da relação entre produtos e grupos.

Elementos da Requisição

detail

Detalhes da requisição.

Tipo: JSON.

success

Identificador booleano de sucesso da requisição.

Tipo: Boolean.

message

Mensagem de sucesso ou falha da requisição.

Tipo: String.

data

Dados de retorno da requisição.

Tipo: JSON.

success

Booleano indicador de sucesso ou falha da requisição.

Tipo: Boolean.

message

Mensagem retornada pela API.

Tipo: String.

Respostas para erros

Caso ocorra algum erro durante a requisição, os possíveis erros são:

400 Bad Request

Embalagens ou Grupo de produtos não encontrados

bottom of page