Importação CSV Bancária

Visão Geral

A maioria dos bancos permite baixar um arquivo CSV de transações para qualquer período de extrato. Em vez de digitar cada linha no TimelyChurch manualmente, você pode fazer upload desse arquivo e deixar o sistema analisá-lo, corresponder às suas contas e categorias e lançar cada linha como transação. Cada linha importada passa por uma fila de revisão para que um humano sempre confirme o que entra nos livros antes de chegar ao razão.

O fluxo de Importação CSV Bancária é projetado para tesoureiros que conciliam mensalmente: baixe o CSV do banco, faça upload, revise, aceite. A maioria dos meses leva apenas alguns minutos.

Onde Encontrar

Vá para Finanças > Contabilidade > Transações (no modo Simples esta aba é rotulada Entradas / Saídas). Clique na seta pequena no botão dividido Nova Transação para abrir seu menu, depois escolha Importar de CSV. O mesmo menu é onde você cria Nova Despesa, Nova Receita, Nova Transferência ou Novo Lançamento Contábil, e onde Exporta a lista filtrada para CSV.

Se tem linhas já aguardando de um upload anterior, a aba Transações na navegação de contabilidade mostra um distintivo de contagem âmbar com o número de linhas ainda para revisar, e a fila de revisão aparece inline no topo da página de Transações.

Formatos Bancários Suportados

O TimelyChurch detecta automaticamente o formato do arquivo pela linha de cabeçalho e aplica um parser integrado. Formatos reconhecidos incluem:

• Bank of America — Exportação CSV padrão de conta corrente.
• CashApp — Exportação estilo extrato de contas comerciais CashApp.
• PayPal e Stripe — Exportações de atividade de processadores de pagamento.

Se o formato do seu banco não for detectado automaticamente, o arquivo ainda é importável como CSV genérico: você confirma ou ajusta o mapeamento de colunas na próxima etapa (veja "O Fluxo de Upload" abaixo). Linhas que não podem ser analisadas limpas são ignoradas, e quaisquer sinalizadas como possíveis duplicatas são exibidas na fila de revisão para que você possa confirmar ou excluir.

O Fluxo de Upload

Escolher Importar de CSV abre um modal de três etapas:

1. Etapa 1 — Upload de Arquivo. Selecione a conta bancária a que o arquivo pertence (apenas contas do tipo Ativo são listadas) e escolha o arquivo CSV para upload, depois clique em Próximo: Mapear Colunas.
2. Etapa 2 — Mapear Colunas. O TimelyChurch lê o arquivo, mostra a origem detectada e uma prévia das primeiras linhas, e propõe um mapeamento de colunas (data, descrição, valor, taxa, beneficiário/nome, referência). Para bancos reconhecidos isso geralmente está correto como está; para um CSV genérico, confirme ou ajuste qual coluna mapeia para cada campo.
3. Etapa 3 — Importar. O TimelyChurch executa detecção de duplicatas (veja abaixo) e prepara cada linha analisada com status para revisão. As linhas então aparecem na fila de revisão na página de Transações.

Se você faz upload de um arquivo que já foi importado para esta conta, a Etapa 2 mostra um aviso âmbar "Este arquivo já foi importado" com a data e contagem da importação original, e você pode escolher Importar Mesmo Assim ou cancelar.

A Fila de Revisão

A fila de revisão é o coração do fluxo de importação. Cada linha enviada permanece aqui até você explicitamente aceitá-la ou excluí-la — nada é lançado no seu razão automaticamente.

Cada linha na fila mostra:

• A data, descrição e valor da transação conforme analisados do CSV.
• Uma categoria sugerida (o sistema tenta corresponder com base em palavras-chave da descrição e suas categorizações anteriores).
• Um beneficiário/doador sugerido se a descrição corresponde a um beneficiário existente.
• Um método (método de pagamento) que você pode substituir antes de aceitar.
• Quaisquer avisos de duplicata (veja próxima seção).

Para cada linha você pode editar a categoria, o beneficiário, o método e outros detalhes sugeridos inline antes de decidir o que fazer com ela. O restante desta seção explica como classificar uma linha, tratar doações e taxas, e aceitar — uma linha por vez ou em massa.

Uma vez aceita ou excluída, uma linha sai da lista de revisão. Você pode voltar à fila em várias sessões — nada força você a limpá-la de uma vez.

Classificando cada linha: receita, despesa ou transferência

Cada linha tem um controle Tipo. Por padrão ele mostra Automático (Receita) ou Automático (Despesa) — o TimelyChurch decide receita ou despesa pelo sinal do valor no CSV (dinheiro que entra é receita, dinheiro que sai é despesa), então normalmente você pode deixá-lo em Automático. Mude para Transferência para uma linha que apenas move dinheiro entre duas de suas próprias contas (por exemplo, da conta corrente para a poupança) em vez de ser uma receita ou despesa real.

Registrando uma transferência

Definir o Tipo de uma linha como Transferência troca o campo de categoria por um seletor Outra conta. Escolha a conta para a qual ou da qual o dinheiro se moveu — o outro lado da transferência. Apenas suas contas bancárias/de ativo e de passivo são listadas, excluindo a conta na qual você importou. Uma transferência não tem categoria, doador ou taxa, então esses campos ficam ocultos para a linha. Você deve escolher a outra conta antes que a linha seja aceita; o TimelyChurch não lançará uma transferência sem contraparte ou que aponte para a mesma conta.

Doações: escolher um doador ou marcá-la como anônima

Quando a categoria de uma linha é uma categoria de doação que exige um doador (dízimos, ofertas e similares), você deve atribuir a doação antes que ela seja lançada. Há duas maneiras:

• Selecione o doador na busca Nome do doador..., ou adicione uma nova pessoa inline. A doação aceita é vinculada a essa pessoa, então aparece no registro de doações dela e no comprovante anual.
• Marque «Oferta anônima» para uma doação genuinamente sem doador — dinheiro na cesta de ofertas, ou uma doação online anônima. Isso registra a doação sem doador e satisfaz a exigência sem uma pessoa.

As duas opções são mutuamente exclusivas: ativar Oferta anônima limpa qualquer doador selecionado, e escolher um doador limpa a marca de anônimo. Se você tentar aceitar uma linha de doação sem nenhuma das duas, o TimelyChurch impede e pede que você escolha um doador ou a marque como anônima. Receita geral que não é uma categoria de doação (por exemplo, venda de livros ou café) não precisa de doador e é lançada por conta própria.

Taxas de processamento

Quando uma linha carrega uma taxa de processamento — Cash App, PayPal e processadores similares reportam a taxa separadamente — um selo roxo Taxa mostra o valor e um seletor Categoria de taxa aparece abaixo da descrição. Escolha a categoria de despesa para a qual a taxa deve ser lançada; apenas categorias de despesa são listadas, porque uma taxa é sempre uma despesa. O TimelyChurch registra a doação pelo valor bruto e lança a taxa como uma despesa separada, para que os relatórios mostrem tanto as doações completas quanto o depósito líquido. Uma linha com taxa não será aceita até você escolher a categoria de taxa dela.

Dica: Se você sempre envia as taxas de um processador para a mesma categoria, o TimelyChurch se oferece para lembrar disso («Sempre usar esta categoria para taxas de ...?») depois que você a escolher algumas vezes, para que futuras importações a preencham automaticamente.

Aceitando linhas

• Aceite uma linha com a marca de verificação verde na coluna Ações dela. Isso lança uma transação real — e, para uma doação, a doação vinculada — no seu razão e remove a linha da fila.
• Exclua uma linha (o ×) se ela não deve se tornar uma transação (por exemplo, uma taxa bancária já registrada em outro lugar).
• Aceitar em massa: na página Revisar tudo, Aceitar categorizadas lança de uma vez todas as linhas que já têm uma categoria. As linhas que ainda não têm doador, categoria de taxa ou a outra conta de uma transferência são deixadas intencionalmente na fila para que nada fique classificado pela metade. Você também pode selecionar várias linhas e usar Aplicar categoria para definir uma única categoria em todas elas antes de aceitar.

Detecção de Duplicatas (4 Camadas)

Arquivos CSV bancários frequentemente se sobrepõem. Se você faz upload dos extratos de junho e julho mas eles compartilham os últimos dias de junho, esperaria importar as mesmas transações duas vezes. O TimelyChurch usa quatro camadas de detecção de duplicatas para detectar esses casos automaticamente.

Camada 1: Hash do Arquivo CSV

Cada arquivo enviado recebe uma impressão digital e essa impressão é lembrada. Se você faz upload do mesmo arquivo uma segunda vez para a mesma conta, o TimelyChurch o reconhece e avisa antes de importar — economizando de criar dezenas de duplicatas fantasmas.

Camada 2: Número de Referência, ou Valor + Data + Descrição

Para cada linha analisada, o sistema verifica se uma transação correspondente já existe:

• Nível 1 (alta confiança): Corresponde exatamente ao número de referência de uma transação existente (verificado em toda a igreja). Isso detecta números de cheque e IDs de transação emitidos pelo banco.
• Nível 2 (confiança média): Corresponde ao mesmo valor, mesma data e mesma conta, com descrição correspondente — para linhas sem número de referência.

A verificação olha tanto transações já lançadas quanto outras linhas ainda aguardando na fila de revisão, para que você não possa acidentalmente aceitar a mesma linha duas vezes de dois uploads diferentes.

Camada 3: Confirmação ao Aceitar

Quando você aceita uma linha que o sistema sinalizou como provável duplicata, é mostrada a transação existente com a qual conflita. Você pode confirmar que realmente é uma transação separada e lançá-la mesmo assim, ou cancelar e excluir a linha.

Camada 4: Rede de Segurança Final

Como última linha de defesa, o TimelyChurch impõe uma garantia final de que o mesmo número de referência não pode ser lançado duas vezes para a mesma conta. Mesmo que algo escapasse das verificações anteriores, essa proteção final rejeita a duplicata antes que ela chegue ao seu razão.

Melhores Práticas

Concilie antes de importar. Conciliação bancária ainda é o registro oficial para detectar erros. Execute uma conciliação cada mês usando os dados importados, não como substituto.

Revise categorias cuidadosamente nas primeiras importações. O sugeridor de categorias aprende com suas categorizações anteriores. O primeiro ou segundo mês de importações pode precisar de mais correções manuais de categoria; meses posteriores ficam visivelmente mais rápidos conforme as sugestões melhoram.

Exclua, não ignore. Se uma linha não deve ser lançada, clique em Excluir em vez de ignorá-la. Linhas excluídas são lembradas, então reenviar um arquivo sobreposto não as exibirá novamente.

Mantenha importações vinculadas a uma conta. Cada upload é limitado a uma única conta bancária. Se tem várias contas correntes, faça um upload separado por conta. Isso mantém detecção de duplicatas e conciliação limpas.

Solução de Problemas

"Este arquivo já foi importado" — O hash do arquivo CSV corresponde a um upload anterior para esta conta. Ou você fez upload duas vezes, ou o banco exportou o mesmo intervalo de datas. Revise a importação existente, depois escolha Importar Mesmo Assim apenas se tiver certeza de que as linhas são novas.

Marca "Possível duplicata" em uma linha — O sistema encontrou uma transação com o mesmo número de referência, ou o mesmo valor, data e descrição. Compare com a transação existente; se realmente são a mesma, exclua a linha. Se por acaso são coincidentemente idênticas (raro), confirme e aceite.

Linhas falham ao analisar sem erro óbvio — Seu banco pode ter alterado o formato CSV, então a detecção automática recorreu a uma importação genérica. Abra o CSV em uma planilha, confirme a linha de cabeçalho e na Etapa 2 mapeie as colunas manualmente — ou reexporte do banco usando seu formato padrão.