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

# Versão 3.1.10

*Atualização de Setembro de 2026*

A versão 3.1.10 traz a conciliação bancária pela API pública: importação de extratos, consulta das movimentações e conciliação com contas a pagar e a receber, sem precisar abrir a tela de conciliação.

## **Novas Funcionalidades**

### **Extrato Bancário**

Foram adicionados novos endpoints para gerenciar os extratos bancários importados. Com esses endpoints, é possível:

* **GET /extratos-bancarios** - Listar extratos importados com paginação e filtros
  * Filtros disponíveis: nome do arquivo, data inicial, data final, conta financeira
* **GET /extratos-bancarios/\{idExtratoBancario}** - Obter os detalhes de um extrato e suas movimentações
  * Cada movimentação informa a situação (pendente, ignorado, adicionado ao caixa ou vinculado a duplicata) e o lançamento de caixa conciliado, quando existir
* **POST /extratos-bancarios** - Importar um arquivo de extrato bancário (OFX ou XML) em uma conta financeira
  * Arquivo enviado como multipart/form-data
  * Retorna o ID do extrato criado
* **DELETE /extratos-bancarios/\{idExtratoBancario}** - Excluir um extrato importado e todas as suas movimentações
  * A exclusão não estorna conciliações já realizadas

### **Conciliação das Movimentações**

* **POST /extratos-bancarios/\{idExtratoBancario}/movimentacoes/\{idMovimentacao}/vinculo-conta** - Conciliar uma movimentação com uma ou mais contas a pagar ou a receber, baixando as contas
  * Suporta baixa parcial e os campos valor, juros, desconto, acréscimo e taxa
* **POST /extratos-bancarios/\{idExtratoBancario}/movimentacoes/\{idMovimentacao}/lancamento** - Transformar uma movimentação em lançamento no caixa
  * Suporta categoria, contato e histórico
* **POST /extratos-bancarios/\{idExtratoBancario}/movimentacoes/\{idMovimentacao}/ignorar** - Ignorar uma movimentação que não precisa de conciliação
* **POST /extratos-bancarios/\{idExtratoBancario}/movimentacoes/\{idMovimentacao}/desfazer-ignorar** - Desfazer a ignoração de uma movimentação
* **POST /extratos-bancarios/\{idExtratoBancario}/movimentacoes/\{idMovimentacao}/estornar** - Estornar o tratamento de uma movimentação, voltando ela a ficar pendente

## **Permissões**

Os endpoints de extrato bancário exigem as novas permissões de extrato bancário (leitura, escrita e exclusão) liberadas no gerenciamento de acessos do usuário da API.