Demander API - Product Price
This article is part of the REST Integration API documentation.
Documentation to consult, insert, update and delete product prices.
Consultation
Section titled “Consultation”List the company’s product prices. Without filter, considers dataAlteracao from the last 6 months.
Rota: {host}/public/v1/precos-do-produto?pagina={pagina}&limite={limite}&filtroDataAlteracao={data}&operadorFiltro={operador}Método: GETReturn:
{ "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" } ]}Insert or update
Section titled “Insert or update”POST upsert by the compound key codProduto + codListaPreco + codCliente (optional).
Rota: {host}/public/v1/precos-do-produtoMétodo: POSTBody: json| Property | Type | Size | Mandatory | Description |
|---|---|---|---|---|
| codProduto | string | 30 | ✓ | Product code. Part of the upsert key. |
| codListaPreco | string | 20 | ✓ | Price list code. Part of the upsert key. |
| codCliente | int | Customer code (specific price). | ||
| value | decimal | ✓ | Product price. Accepts 0. |
|
| percentualDescontoMaximo | decimal | ✓ | Maximum percentage discount. It cannot be negative. Accepts 0. |
|
| unit | string | 5 | Unit of measurement. Default UN. |
|
| qtdeEmbalagem | decimal | Quantity per package. Default 1. |
||
| permiteVendaFracionaria | int | 0 or 1. Default 1. |
||
| promocaoValor | decimal | Promotional value. | ||
| promocaoDataInicio | date | Start of promotion. | ||
| promocaoDataFim | date | End of promotion. | ||
| lancamentoAte | date | Release deadline. | ||
| multiplosPermitidosPorEmbalagem | string | 100 | Allowed multiples (e.g. 2;4;8). |
|
| valorIpiPorUnidade | decimal | IPI per unit. Default 0. |
||
| opcoesDePrecoPreFixado | string | Prefixed prices separated by ; (e.g.: 10;20;30). |
||
| precoTravado | decimal | Price locked. | ||
| pesoBruto | decimal | Gross weight. Default 0. |
||
| pesoLiquido | decimal | Net weight. Default 0. |
||
| cubage | decimal | Cubage. Default 0. |
||
| percAcrescimoMaximo | decimal | Maximum percentage increase. Default 0. |
||
| custoReposicao | decimal | Replacement cost. Default 0. |
||
| unidadeEmbalagem | string | 5 | Packaging unit. | |
| height | decimal | Height. Default 0. |
||
| width | decimal | Width. Default 0. |
||
| length | decimal | Length. Default 0. |
||
| jsonPrecoPorQuantidade | string | Quantity price JSON (valid JSON string). | ||
| valorUnitarioRedespacho | decimal | Redespatch unit value. |
Body:
{ "codProduto": "1101", "codListaPreco": "1", "unidade": "UN", "qtdeEmbalagem": 1, "valor": 1.15, "percentualDescontoMaximo": 0, "permiteVendaFracionaria": 1}Return:
{ "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"}Delete
Section titled “Delete”Removes the product price.
Rota: {host}/public/v1/precos-do-produto?codProduto={codProduto}&codListaPreco={codListaPreco}&codCliente={codCliente}Método: DELETEReturn:
{ "mensagem": "Registro excluído com sucesso."}