Demander API - Payment Terms

This article is part of the REST Integration API documentation.

Documentation to consult, insert, update and delete payment conditions.

Consultation

List the company’s payment terms. Without filter, considers dataAlteracao from the last 6 months.

Rota: {host}/public/v1/condicoes-de-pagamento?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:

{
  "condicoesDePagamento": [
    {
      "codigo": "30/60/90",
      "descricao": "30/60/90 DIAS",
      "percentualAcrescimo": 1.5,
      "percentualDesconto": 2.0,
      "ativo": 1,
      "valorMinimoPedido": 2000,
      "percJurosDesconto": 5.5,
      "bloqueiaUsoDemander": 0,
      "bloqueiaUsoPedidoLa": 0,
      "bloqueiaUsoPedidoWeb": 0,
      "prazoMedioPagamento": 60,
      "consideraLimiteCredito": 1,
      "prazos": "30,60,90",
      "dataAlteracao": "2026-07-15 10:00:00"
    }
  ]
}

Insert or update

POST upsert by key codigo.

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

Property	Type	Size	Mandatory	Description
code	string	20	✓	Condition code. Unique identifier used to insert or update (upsert).
description	string	255	✓	Name of the payment term.
percentualAcrescimo	numeric			Increase percentage.
percentualDesconto	numeric			Discount percentage.
active	int			Values: 0 or 1. Default on inclusion: 1.
valorMinimoPedido	numeric			Minimum order value to use this condition.
percJurosDesconto	numeric			Interest percentage or discount.
bloqueiaUsoDemander	int			Values: 0 or 1. Default on inclusion: 0.
bloqueiaUsoPedidoLa	int			Values: 0 or 1. Default on inclusion: 0.
bloqueiaUsoPedidoWeb	int			Values: 0 or 1. Default on inclusion: 0.
prazoMedioPagamento	numeric			Average payment term.
consideraLimiteCredito	int			Values: 0 or 1. Default on inclusion: 0.
deadlines	string	255		Deadlines in days, separated by commas (e.g.: 30,60,90).

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": "30/60/90",
  "descricao": "30/60/90 DIAS",
  "percentualAcrescimo": 1.5,
  "percentualDesconto": 2.0,
  "ativo": 1,
  "valorMinimoPedido": 2000,
  "percJurosDesconto": 5.5,
  "bloqueiaUsoDemander": 0,
  "bloqueiaUsoPedidoLa": 0,
  "bloqueiaUsoPedidoWeb": 0,
  "prazoMedioPagamento": 60,
  "consideraLimiteCredito": 1,
  "prazos": "30,60,90"
}

Return:

{
  "codigo": "30/60/90",
  "descricao": "30/60/90 DIAS",
  "percentualAcrescimo": 1.5,
  "percentualDesconto": 2.0,
  "ativo": 1,
  "valorMinimoPedido": 2000,
  "percJurosDesconto": 5.5,
  "bloqueiaUsoDemander": 0,
  "bloqueiaUsoPedidoLa": 0,
  "bloqueiaUsoPedidoWeb": 0,
  "prazoMedioPagamento": 60,
  "consideraLimiteCredito": 1,
  "prazos": "30,60,90",
  "dataAlteracao": "2026-07-15 10:00:00"
}

Delete

Removes the payment condition.

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

Return:

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