API do Demander - Condições de Pagamento

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

Documentação para consultar, inserir, atualizar e excluir condições de pagamento.

Consulta

Lista as condições de pagamento da empresa. Sem filtro, considera dataAlteracao dos últimos 6 meses.

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

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

Inserir ou atualizar

POST upsert pela chave codigo.

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

Propriedade	Tipo	Tamanho	Obrigatório	Descrição
codigo	string	20	✓	Código da condição. Identificador único usado para inserir ou atualizar (upsert).
descricao	string	255	✓	Nome da condição de pagamento.
percentualAcrescimo	numeric			Percentual de acréscimo.
percentualDesconto	numeric			Percentual de desconto.
ativo	int			Valores: 0 ou 1. Padrão na inclusão: 1.
valorMinimoPedido	numeric			Valor mínimo do pedido para usar esta condição.
percJurosDesconto	numeric			Percentual de juros ou desconto.
bloqueiaUsoDemander	int			Valores: 0 ou 1. Padrão na inclusão: 0.
bloqueiaUsoPedidoLa	int			Valores: 0 ou 1. Padrão na inclusão: 0.
bloqueiaUsoPedidoWeb	int			Valores: 0 ou 1. Padrão na inclusão: 0.
prazoMedioPagamento	numeric			Prazo médio de pagamento.
consideraLimiteCredito	int			Valores: 0 ou 1. Padrão na inclusão: 0.
prazos	string	255		Prazos em dias, separados por vírgula (ex.: 30,60,90).

Cuidado

Inclusão

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

Atualização

• Apenas o atributo codigo é obrigatório.
• Retorno 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"
}

Retorno:

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

Excluir

Remove a condição de pagamento.

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

Retorno:

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