API do Demander - Listas de Preço

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

Documentação para consultar, inserir, atualizar e excluir listas de preço.

Consulta

Lista as listas de preço da empresa. Sem filtro, considera dataAlteracao dos últimos 6 meses.

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

Retorno:

{
  "listasDePreco": [
    {
      "codigo": "1",
      "descricao": "ATACADO/RS",
      "ativo": 1,
      "codFilialUnidade": "55",
      "temFreteEmbutidoNoValor": 0,
      "condicoesAdicionais": "10,20,30",
      "valorMinimoPedido": "100.50",
      "precoComImpostos": 0,
      "codMoeda": "BRL",
      "utilizaRedespacho": 0,
      "dataAlteracao": "2026-07-24 10:00:00"
    }
  ]
}

Inserir ou atualizar

POST upsert pela chave codigo.

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

Propriedade	Tipo	Tamanho	Obrigatório	Descrição
codigo	string	20	✓	Código da lista de preço. Identificador único usado para inserir ou atualizar (upsert).
descricao	string	50	✓	Nome/descrição da lista de preço.
ativo	int			Valores: `0` ou `1`. Padrão na inclusão: `1`. Inativos não aparecem para o vendedor.
codFilialUnidade	string	15		Filial/unidade. Se preenchido, a lista só aparece em pedidos dessa filial.
temFreteEmbutidoNoValor	int			Valores: `0` ou `1`. Indica se o frete já está incluso no valor dos produtos.
condicoesAdicionais	string	500		Códigos das condições de pagamento liberadas (separados por vírgula). Em branco libera todas.
valorMinimoPedido	decimal	15,2		Valor mínimo permitido para pedidos desta lista.
precoComImpostos	int			Valores: `0` ou `1`. Padrão na inclusão: `0`. Indica se o preço já inclui impostos.
codMoeda	string	3		Código ISO da moeda (ex.: `BRL`, `USD`).
utilizaRedespacho	int			Valores: `0` ou `1`. Padrão na inclusão: `0`. Exibe o campo de redespacho no pedido.

Body:

{
  "codigo": "1",
  "descricao": "ATACADO/RS",
  "ativo": 1,
  "codFilialUnidade": "55",
  "temFreteEmbutidoNoValor": 0,
  "condicoesAdicionais": "10,20,30",
  "valorMinimoPedido": 100.5,
  "precoComImpostos": 0,
  "codMoeda": "BRL",
  "utilizaRedespacho": 0
}

Retorno:

{
  "codigo": "1",
  "descricao": "ATACADO/RS",
  "ativo": 1,
  "codFilialUnidade": "55",
  "temFreteEmbutidoNoValor": 0,
  "condicoesAdicionais": "10,20,30",
  "valorMinimoPedido": "100.50",
  "precoComImpostos": 0,
  "codMoeda": "BRL",
  "utilizaRedespacho": 0,
  "dataAlteracao": "2026-07-24 10:00:00"
}

Excluir

Remove a lista de preço.

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

Retorno:

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