> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gestio.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Referência

> Contas a Pagar, Contas a Receber, Caixa/Bancos e cadastros financeiros

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.

<Card title="Campos obrigatórios" horizontal>
  `codigoDaFilial`, `codigoDoCliente`, `codigoDoItemDeLancamento`, `codigoDoCentroDeCusto`, `codigoDaContaCorrente` e `historico`.
</Card>

**Exemplo:**

```json theme={null}
POST /v2/financeiro/contasreceber
{
  "codigoDaFilial": 1,                 // obrigatório
  "codigoDoCliente": 4821,             // obrigatório - cliente ativo
  "codigoDoItemDeLancamento": "1.1.01",// obrigatório - categoria de receita
  "codigoDoCentroDeCusto": "001",      // obrigatório
  "codigoDaContaCorrente": 3,          // obrigatório
  "historico": "Venda referente ao pedido 9012", // obrigatório
  "numeroDoDocumento": "9012",         // opcional
  "dataDeEmissao": "2026-07-29",       // opcional
  "dataDeVencimento": "2026-08-28",    // opcional
  "valorDoLancamento": 350.00,         // opcional
  "codigoDaFormaDePagamento": 2,       // opcional
  "codigoDaCarteira": 5                // opcional - usada para emissão de boleto
}
```

**Resposta:**

```json theme={null}
{
  "success": true,
  "data": {
    "codigoDoExercicio": 2026,
    "numeroDaTransacao": 55210,
    "sequenciaDaTransacao": 1,
    "codigoDoCliente": 4821,
    "historico": "Venda referente ao pedido 9012",
    "valorDoLancamento": 350.00,
    "dataDeVencimento": "2026-08-28T00:00:00"
  }
}
```

<Tip>
  Campos obrigatórios ausentes ou inválidos retornam `400` com o detalhe em `notifications`/`errors`.
</Tip>

<Card title="Carteira de cobrança" horizontal>
  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.
</Card>

## 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.