API do Demander - Grupos de Produtos

Este artigo faz parte da documentação da API de Integração REST.

Documentação para consultar, inserir, atualizar e excluir grupos de produto.

Consulta

Lista os grupos de produto da empresa. Sem filtro, considera dataAlteracao dos últimos 6 meses.

Rota: {host}/public/v1/grupos-de-produto?pagina={pagina}&limite={limite}&filtroDataAlteracao={data}&operadorFiltro={operador}
Método: GET

Cuidado

Paginação

• pagina — base 1 (padrão 1)
• limite — padrão 100, máximo 500

Filtros

• filtroDataAlteracao — formato Y-m-d
• operadorFiltro (opcional) — <, >, =, <=, >= (padrão >=)

Retorno:

{
  "gruposDeProduto": [
    {
      "codigo": "1",
      "descricao": "ENLATADOS",
      "ativo": 1,
      "codGrupoPai": null,
      "ocultarNaLojaVirtual": 0,
      "dataAlteracao": "2026-07-15 10:00:00"
    }
  ]
}

Inserir ou atualizar

POST upsert pela chave codigo.

Rota: {host}/public/v1/grupos-de-produto
Método: POST
Body: json

Propriedade	Tipo	Tamanho	Obrigatório	Descrição
codigo	string	30	✓	Código do grupo. Identificador único usado para inserir ou atualizar (upsert).
descricao	string	255	✓	Nome do grupo de produto.
ativo	int			Valores: 0 ou 1. Padrão na inclusão: 1.
codGrupoPai	string	30		Código do grupo pai (hierarquia).
ocultarNaLojaVirtual	int			Valores: 0 ou 1. Padrão na inclusão: 0. Se omitido na atualização, mantém o valor atual.

Cuidado

Inclusão

• É necessário enviar todos os atributos que são obrigatórios. Retorno 201.

Atualização

• Apenas o atributo codigo é obrigatório.Retorno 200.

Body:

{
  "codigo": "1",
  "descricao": "ENLATADOS",
  "ativo": 1,
  "codGrupoPai": null,
  "ocultarNaLojaVirtual": 0
}

Retorno:

{
  "codigo": "1",
  "descricao": "ENLATADOS",
  "ativo": 1,
  "codGrupoPai": null,
  "ocultarNaLojaVirtual": 0,
  "dataAlteracao": "2026-07-15 10:00:00"
}

Excluir

Remove o grupo de produto.

Rota: {host}/public/v1/grupos-de-produto?codigo={codigo}
Método: DELETE

Retorno:

{
  "mensagem": "Registro excluído com sucesso."
}