API do Demander - Preço do Produto

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

Documentação para consultar, inserir, atualizar e excluir preços do produto.

Consulta

Lista os preços do produto da empresa. Sem filtro, considera dataAlteracao dos últimos 6 meses.

Rota: {host}/public/v1/precos-do-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:

{
  "precosDoProduto": [
    {
      "codProduto": "1101",
      "codListaPreco": "1",
      "unidade": "UN",
      "qtdeEmbalagem": 1,
      "valor": 1.15,
      "percentualDescontoMaximo": 0,
      "permiteVendaFracionaria": 1,
      "promocaoValor": null,
      "promocaoDataInicio": null,
      "promocaoDataFim": null,
      "lancamentoAte": null,
      "multiplosPermitidosPorEmbalagem": null,
      "valorIpiPorUnidade": 0,
      "opcoesDePrecoPreFixado": null,
      "precoTravado": null,
      "codCliente": null,
      "pesoBruto": 0,
      "pesoLiquido": 0,
      "cubagem": 0,
      "percAcrescimoMaximo": 0,
      "custoReposicao": 0,
      "unidadeEmbalagem": null,
      "altura": 0,
      "largura": 0,
      "comprimento": 0,
      "jsonPrecoPorQuantidade": null,
      "valorUnitarioRedespacho": null,
      "dataAlteracao": "2026-07-27 10:00:00"
    }
  ]
}

Inserir ou atualizar

POST upsert pela chave composta codProduto + codListaPreco + codCliente (opcional).

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

Propriedade	Tipo	Tamanho	Obrigatório	Descrição
codProduto	string	30	✓	Código do produto. Parte da chave de upsert.
codListaPreco	string	20	✓	Código da lista de preço. Parte da chave de upsert.
codCliente	int			Código do cliente (preço específico).
valor	decimal		✓	Preço do produto. Aceita 0.
percentualDescontoMaximo	decimal		✓	Desconto máximo percentual. Não pode ser negativo. Aceita 0.
unidade	string	5		Unidade de medida. Padrão UN.
qtdeEmbalagem	decimal			Quantidade por embalagem. Padrão 1.
permiteVendaFracionaria	int			0 ou 1. Padrão 1.
promocaoValor	decimal			Valor promocional.
promocaoDataInicio	date			Início da promoção.
promocaoDataFim	date			Fim da promoção.
lancamentoAte	date			Data limite de lançamento.
multiplosPermitidosPorEmbalagem	string	100		Múltiplos permitidos (ex.: 2;4;8).
valorIpiPorUnidade	decimal			IPI por unidade. Padrão 0.
opcoesDePrecoPreFixado	string			Preços prefixados separados por ; (ex.: 10;20;30).
precoTravado	decimal			Preço travado.
pesoBruto	decimal			Peso bruto. Padrão 0.
pesoLiquido	decimal			Peso líquido. Padrão 0.
cubagem	decimal			Cubagem. Padrão 0.
percAcrescimoMaximo	decimal			Acréscimo máximo percentual. Padrão 0.
custoReposicao	decimal			Custo de reposição. Padrão 0.
unidadeEmbalagem	string	5		Unidade da embalagem.
altura	decimal			Altura. Padrão 0.
largura	decimal			Largura. Padrão 0.
comprimento	decimal			Comprimento. Padrão 0.
jsonPrecoPorQuantidade	string			JSON de preço por quantidade (string JSON válida).
valorUnitarioRedespacho	decimal			Valor unitário de redespacho.

Cuidado

Inclusão

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

Atualização

• Apenas codProduto e codListaPreco são obrigatórios (codCliente quando fizer parte da chave). Retorno 200.

Body:

{
  "codProduto": "1101",
  "codListaPreco": "1",
  "unidade": "UN",
  "qtdeEmbalagem": 1,
  "valor": 1.15,
  "percentualDescontoMaximo": 0,
  "permiteVendaFracionaria": 1
}

Retorno:

{
  "codProduto": "1101",
  "codListaPreco": "1",
  "unidade": "UN",
  "qtdeEmbalagem": 1,
  "valor": 1.15,
  "percentualDescontoMaximo": 0,
  "permiteVendaFracionaria": 1,
  "promocaoValor": null,
  "promocaoDataInicio": null,
  "promocaoDataFim": null,
  "lancamentoAte": null,
  "multiplosPermitidosPorEmbalagem": null,
  "valorIpiPorUnidade": 0,
  "opcoesDePrecoPreFixado": null,
  "precoTravado": null,
  "codCliente": null,
  "pesoBruto": 0,
  "pesoLiquido": 0,
  "cubagem": 0,
  "percAcrescimoMaximo": 0,
  "custoReposicao": 0,
  "unidadeEmbalagem": null,
  "altura": 0,
  "largura": 0,
  "comprimento": 0,
  "jsonPrecoPorQuantidade": null,
  "valorUnitarioRedespacho": null,
  "dataAlteracao": "2026-07-27 10:00:00"
}

Excluir

Remove o preço do produto.

Rota: {host}/public/v1/precos-do-produto?codProduto={codProduto}&codListaPreco={codListaPreco}&codCliente={codCliente}
Método: DELETE

Retorno:

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