# Checklist Bancário Compatível com Beancount (2025)

Escolher uma conta bancária empresarial para um livro-razão em texto puro exige mais do que perseguir APYs altos ou benefícios chamativos de cartão. A prioridade é objetiva: fluxos de dados consistentes, controles previsíveis e políticas de segurança que se integrem sem atritos a um fluxo de trabalho contábil automatizado.

Este checklist direciona a conversa para recursos verificáveis — o que pode ser exportado, quão rápido os fundos se movem e quais controles reduzem revisões manuais. Utilize-o para reduzir a lista de provedores antes de investir tempo no onboarding ou na construção de importadores.

---

## 1. Exportação de dados: o inegociável

Um banco só se torna “compatível com Beancount” quando entrega extratos limpos e legíveis por máquina.

| Requisito                                            | Por que importa                                                            | O que confirmar                                                      |
| ---------------------------------------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| ID de transação estável (`FITID` ou equivalente)     | Permite deduplicação determinística nos scripts de importação do Beancount | Baixe dois arquivos CSV/OFX com um mês de intervalo e compare os IDs |
| Data contabilizada, beneficiário, memo, valor, moeda | Garante lançamentos precisos sem suposições                                | Analise exportações reais, não PDFs de marketing                     |
| Cabeçalhos e estrutura constantes                    | Evita regressões do importador após mudanças silenciosas de formato        | Armazene amostras versionadas no repositório                         |
| Acesso a PDFs de extratos e imagens de cheques       | Suporta anexos no fluxo documental                                         | Verifique prazos de retenção e tarifas por imagem                    |

Recursos: [Guia de importação do Beancount](https://beancount.github.io/docs/importing_external_data.html) e [Especificação bancária OFX](https://financialdataexchange.org/common/Uploaded%20files/OFX%20files/OFX%20Banking%20Specification%20v2.3.pdf).

---

## 2. Segurança e cobertura de depósitos

A cobertura regulatória determina quanto caixa manter sem redesenhar o mapa de contas.

- Bancos segurados pela **FDIC** protegem até **US$ 250.000 por depositante, por banco segurado e por categoria de titularidade**. Programas de sweep multi-banco podem ampliar a cobertura; solicite a lista atual de bancos participantes e como os extratos documentam o seguro repassado. Fonte: [FDIC](https://www.fdic.gov/resources/deposit-insurance/understanding-deposit-insurance).
- Cooperativas de crédito seguradas pela **NCUA** oferecem o mesmo limite de US$ 250.000 por meio do National Credit Union Share Insurance Fund. Fonte: [NCUA](https://ncua.gov/consumers/share-insurance-coverage).

Registre o caminho da cobertura nas notas da conta para que os controles internos expliquem quando os saldos excedem os limites básicos.

---

## 3. Trilhos de pagamento, velocidade e limites

As capacidades de pagamento determinam se é possível automatizar fornecedores, folha de pagamento ou reembolsos diretamente via scripts.

- **Same Day ACH** permite agora até **US$ 1 milhão por pagamento** em três janelas diárias de liquidação — ideal para desembolsos urgentes sem recorrer a wire. Fonte: [Nacha](https://www.nacha.org/same-day-ach).
- **RTP® (Real-Time Payments)** da The Clearing House liquida 24/7 com compensação final e **limite de US$ 10 milhões por transação** em 2025, sujeito à disponibilidade do banco. Fonte: [The Clearing House](https://www.theclearinghouse.org/payment-systems/rtp/institution).
- A adesão ao **FedNow® Service** cresce; confirme se a instituição habilita envios e recebimentos instantâneos. Fonte: [Federal Reserve Services](https://www.frbservices.org/financial-services/fednow).

Solicite limites de entrada e saída, fluxos de aprovação e se as APIs expõem esses trilhos antes de desenhar automações em torno deles.

---

## 4. Controles operacionais e automação

A profundidade operacional diferencia uma conta utilizável de uma conta escalável.

- **Papéis multiusuário e aprovações** reduzem o risco de transações acidentais ou não autorizadas.
- **Subcontas ou envelopes** (frequentemente até 20 por provedor) refletem categorias orçamentárias diretamente no plano de contas. Exemplos para avaliar: [subcontas da Bluevine](https://www.bluevine.com/business-checking/sub-accounts) e a [arquitetura de contas da Relay](https://relayfi.com/).
- **APIs ou webhooks** aceleram reconciliações e permitem dashboards quase em tempo real. A Mercury, por exemplo, publica uma [API de pagamentos e dados](https://mercury.com/api) que agiliza a ingestão mesmo com arquivos CSV arquivados.

Documente quais controles estão disponíveis desde o início e quais exigem níveis superiores para planejar a gestão de mudanças.

---

## 5. Scorecard bancário para Beancount

Aplique uma rubrica ponderada para comparar candidatos objetivamente. Dê peso extra à exportação de dados e aos recursos de pagamento, pois ditam o esforço de automação.

| Dimensão            | 0–2                           | 3–4                               | 5 (ideal)                                       |
| ------------------- | ----------------------------- | --------------------------------- | ----------------------------------------------- |
| Exportação de dados | Apenas PDF ou CSV improvisado | CSV com cabeçalhos inconsistentes | CSV/OFX estável com IDs duráveis                |
| Cobertura           | Sem extratos                  | Apenas PDFs mensais               | PDFs mais imagens de transações                 |
| Pagamentos          | Apenas ACH, liquidação lenta  | ACH mais wires                    | Same Day ACH + trilhos instantâneos             |
| Controles           | Login único                   | Multiusuário, papéis básicos      | Permissões e aprovações granulares              |
| Subcontas           | Nenhuma                       | 2–5                               | 10–20+ com dados próprios                       |
| API/integrações     | Nenhuma                       | Sincronização contábil básica     | API pública, webhooks, sandbox                  |
| Tarifas/limites     | Divulgação opaca              | Transparente porém restritiva     | Limites claros e generosos, câmbio justo        |
| Suporte             | Apenas e-mail                 | E-mail + chat/telefone            | Suporte empresarial dedicado, SLAs documentados |

Registre as notas nos dossiês de avaliação para que as decisões de onboarding permaneçam baseadas em evidências.

---

## 6. Etapas de diligência antes da adesão

1. **Solicite amostras reais de exportação** de clientes atuais ou da própria conta de teste.
2. **Teste os scripts de importação** com essas amostras, incluindo cenários de deduplicação.
3. **Confirme a retenção de extratos** e como recuperar dados históricos caso mude de provedor.
4. **Revise políticas de disponibilidade de fundos** para depósito de cheque móvel, depósito em espécie e wires recebidos.
5. **Registre divulgações de preços e limites** (tetos ACH, tarifas de wires internacionais) na wiki interna para auditorias futuras.

---

## 7. Configuração do Beancount no primeiro dia

- Armazene exportações brutas em uma pasta versionada `documents/bank/YYYY-MM/` junto com os lançamentos Beancount gerados.
- Inclua o identificador de transação do banco como metadado em cada lançamento; se não houver, gere um hash com data, valor e beneficiário.
- Utilize o Fava ou outra interface de revisão para validar regras de beneficiário antes de confirmar os lançamentos.
- Agende lembretes mensais para baixar extratos e conciliar saldos com diretivas `balance`.

Esse fluxo disciplinado mantém o livro-razão reproduzível e pronto para auditorias mesmo com o aumento do volume de pagamentos.

---

## Conclusão

Escolher uma conta bancária empresarial em 2025 é uma decisão sobre gestão de dados. Priorize provedores que tratem exportações, pagamentos instantâneos e controles baseados em papéis como funcionalidades essenciais. Com esses fundamentos estabelecidos, a automação no Beancount permanece confiável e a equipe financeira investe mais tempo analisando resultados do que higienizando dados.
