Demander API - Price Lists

This article is part of the REST Integration API documentation.

Documentation for querying, inserting, updating and deleting price lists.

Consultation

Lists the company’s price lists. Without filter, considers dataAlteracao from the last 6 months.

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

Caution

Pagination

• pagina — base 1 (default 1)
• limite — default 100, maximum 500

Filters

• filtroDataAlteracao — Y-m-d format
• operadorFiltro (optional) — <, >, =, <=, >= (default >=)

Return:

{
  "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"
    }
  ]
}

Insert or update

POST upsert by key codigo.

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

Property	Type	Size	Mandatory	Description
code	string	20	✓	Price list code. Unique identifier used to insert or update (upsert).
description	string	50	✓	Price list name/description.
active	int			Values: 0 or 1. Default on inclusion: 1. Inactives do not appear to the seller.
codFilialUnidade	string	15		Branch/unit. If completed, the list only appears on orders from that branch.
temFreteEmbutidoNoValor	int			Values: 0 or 1. Indicates whether shipping is already included in the value of the products.
condicoesAdicionais	string	500		Codes of released payment terms (separated by commas). Blank releases all.
valorMinimoPedido	decimal	15.2		Minimum value allowed for orders from this list.
precoComImpostos	int			Values: 0 or 1. Default on inclusion: 0. Indicates whether the price already includes taxes.
codMoeda	string	3		ISO currency code (e.g.: BRL, USD).
utilizaRedespacho	int			Values: 0 or 1. Default on inclusion: 0. Displays the redispatch field in the order.

Caution

Inclusion

• It is necessary to send all attributes that are mandatory. Return 201.

Update

• Only the codigo attribute is mandatory. Return 200.

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
}

Return:

{
  "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"
}

Delete

Removes the price list.

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

Return:

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