API do Demander - Títulos Financeiro

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

Documentação para consultar, inserir, atualizar e excluir títulos financeiros.

Consulta

Lista os títulos financeiros da empresa. Sem filtro, considera dataAlteracao dos últimos 6 meses.

Rota: {host}/public/v1/titulos-financeiros?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:

{
  "titulosFinanceiros": [
    {
      "codigo": "5349",
      "numParcela": "1",
      "cpfCNPJCliente": "10.449.962/0001-86",
      "dataEmissao": "2020-01-02 00:00:00",
      "dataVencimento": "2020-02-01 00:00:00",
      "tipoTitulo": "Duplicata",
      "valor": 5792,
      "quitado": 0,
      "ativo": 1,
      "valorMultaJuros": 0,
      "codCliente": 4441,
      "dataUltimaAtualizacao": "2020-02-28 14:30:00",
      "numeroDocumento": "NF-e 1024 / Pedido 102345",
      "dataPagamento": null,
      "valorComissao": 0,
      "codFilial": null,
      "codVendedor": null,
      "dataAlteracao": "2026-07-27 10:00:00"
    }
  ]
}

Inserir ou atualizar

POST upsert pela chave composta codigo + numParcela.

Rota: {host}/public/v1/titulos-financeiros
Método: POST
Body: json

Propriedade	Tipo	Tamanho	Obrigatório	Descrição
codigo	string	30	✓	Código do título. Parte da chave de upsert.
numParcela	string	20		Número da parcela. Parte da chave de upsert. Pode ser omitido.
cpfCNPJCliente	string	20	✓	CPF/CNPJ do cliente. Aceita com ou sem máscara; a API grava formatado.
dataEmissao	date		✓	Data de emissão. Formato Y-m-d.
dataVencimento	date		✓	Data de vencimento. Formato Y-m-d.
tipoTitulo	string	50	✓	Tipo do título. Ex.: Boleto, Cheque, Duplicata.
valor	decimal		✓	Valor do título. Aceita 0.
quitado	int			Valores: 0 (em aberto) ou 1 (quitado). Padrão na inclusão: 0.
ativo	int			Valores: 0 ou 1. Padrão na inclusão: 1.
valorMultaJuros	decimal			Valor acumulado de multas e juros. Padrão na inclusão: 0.
codCliente	int			Código do cliente no Demander.
dataUltimaAtualizacao	datetime			Usado pelo módulo de Registro de Cobranças.
numeroDocumento	string	50		Número do documento que gerou o título. Ex.: NF-e 1024.
dataPagamento	date			Data de pagamento. Preencher somente se o título estiver quitado.
valorComissao	decimal			Valor da comissão do vendedor. Padrão na inclusão: 0.
codFilial	string	15		Código da filial vinculada ao título.
codVendedor	int			Se informado, restringe a visualização ao vendedor e seus gerentes.

Cuidado

Inclusão

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

Atualização

• Apenas codigo é obrigatório (numParcela quando fizer parte da chave). Retorno 200.

Body:

{
  "codigo": "5349",
  "numParcela": "1",
  "cpfCNPJCliente": "10.449.962/0001-86",
  "dataEmissao": "2020-01-02",
  "dataVencimento": "2020-02-01",
  "tipoTitulo": "Duplicata",
  "valor": 5792.0,
  "quitado": 0,
  "ativo": 1,
  "valorMultaJuros": 0,
  "codCliente": 4441,
  "dataUltimaAtualizacao": "2020-02-28 14:30:00",
  "numeroDocumento": "NF-e 1024 / Pedido 102345"
}

Retorno:

{
  "codigo": "5349",
  "numParcela": "1",
  "cpfCNPJCliente": "10.449.962/0001-86",
  "dataEmissao": "2020-01-02 00:00:00",
  "dataVencimento": "2020-02-01 00:00:00",
  "tipoTitulo": "Duplicata",
  "valor": 5792,
  "quitado": 0,
  "ativo": 1,
  "valorMultaJuros": 0,
  "codCliente": 4441,
  "dataUltimaAtualizacao": "2020-02-28 14:30:00",
  "numeroDocumento": "NF-e 1024 / Pedido 102345",
  "dataPagamento": null,
  "valorComissao": 0,
  "codFilial": null,
  "codVendedor": null,
  "dataAlteracao": "2026-07-27 10:00:00"
}

Excluir

Remove o título financeiro.

Rota: {host}/public/v1/titulos-financeiros?codigo={codigo}&numParcela={numParcela}
Método: DELETE

Retorno:

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