Skip to main content
O módulo Financeiro cobre os lançamentos de Contas a Receber e Contas a Pagar, o extrato consolidado de Caixa/Bancos e os cadastros que sustentam esses lançamentos (Categoria, Centro de Custo, Conta Corrente, Carteira de cobrança).

​
Criar um lançamento de Contas a Receber

Use POST /v2/financeiro/contasreceber. A chave do título (codigoDoExercicio, numeroDaTransacao, sequenciaDaTransacao) é gerada automaticamente.

Campos obrigatórios

codigoDaFilial, codigoDoCliente, codigoDoItemDeLancamento, codigoDoCentroDeCusto, codigoDaContaCorrente e historico.
Exemplo:
Resposta:
Campos obrigatórios ausentes ou inválidos retornam 400 com o detalhe em notifications/errors.

Carteira de cobrança

Quando codigoDaCarteira é informado, ele precisa ser uma Carteira válida vinculada à Conta Corrente informada — é essa combinação que viabiliza a emissão de boleto para o título.

​
Contas a Pagar

POST /v2/financeiro/contaspagar segue a mesma estrutura de campos obrigatórios (filial, categoria, centro de custo, conta corrente e histórico), trocando codigoDoCliente por codigoDoFornecedor.

​
Rateio

Tanto Contas a Pagar quanto Contas a Receber podem ser rateados por Filial, Categoria, Centro de Custo, Projeto e Custo ABC — útil quando um único título deve ser distribuído entre múltiplas áreas ou centros de custo.

​
Baixa e localização de títulos

  • GET /v2/financeiro/contasreceber retorna os lançamentos em aberto; use GET /v2/financeiro/contasreceber/baixados para os já liquidados.
  • GET /v2/financeiro/contasreceber/localizar busca um título pelo identificador externo do seu sistema, sem precisar guardar a chave composta (exercício/filial/transação/sequência) gerada pelo Gestio.

​
Caixa/Bancos

GET /v2/financeiro/caixabancos retorna o extrato financeiro consolidado — incluindo desdobramentos de título — por Conta Corrente e período, útil para conciliação bancária.