PhinAppbeta
Importações

Extratos bancários

Bancos e formatos suportados, como importar e o que o PhinApp faz com cada arquivo.

Bancos suportados

BancoOFXPDFCSVExcel (.xls / .xlsx)Observações
Itaú✓✓-✓Extrato e fatura do cartão, de conta empresa ou pessoa física (Itaú, Uniclass, Personnalité) - o PDF do app e o do internet banking são o mesmo formato. Exporte o extrato detalhado em Excel: ele traz o nome e o CPF/CNPJ de cada pagamento. Um extrato com os pagamentos a fornecedores agrupados (SISPAG FORNECEDORES) é recusado - veja Pagamentos agrupados.
Santander✓✓✓✓Dois PDFs - o extrato mensal (Extrato Consolidado) e o extrato de conta - e duas planilhas - a do Santander Empresas e a do extrato de conta. O PDF, o CSV e a planilha do extrato de conta valem como um formato só.
Bradesco-✓✓-Extrato e fatura do cartão - inclusive os cartões que o Bradesco emite com outras marcas, como o da Amazon. A fatura em aberto do aplicativo Bradesco Cartões também - veja A fatura em aberto do Bradesco.
Nubank✓✓✓-Conta e cartão de crédito - do cartão, também o CSV da fatura. Nenhum dos dois CSVs diz de qual conta é - veja Arquivos que não dizem a conta.
C6 Bank✓✓--O OFX do C6 não informa o saldo: na primeira importação, o PhinApp pede o saldo do dia anterior ao início do extrato. O PDF informa o saldo de cada dia.
Inter✓✓✓-
Mercado Pago-✓--Conta e cartão de crédito. A fatura é de uma conta só, mesmo quando lista mais de um cartão (o físico e os virtuais).
PicPay-✓✓-Conta e cartão de crédito. Pagamentos feitos com cartão não entram no extrato da conta - veja O que não é movimento.
XP e Rico✓✓--
RecargaPay-✓--Carteira e cartão de crédito. O Rendimento CDI não é importado - veja O que não é movimento.
Nomad-✓--Conta em dólar. O relatório em português e o em inglês valem como um formato só. Só entram os lançamentos concluídos - veja O que não é movimento -, e o saldo do relatório vale quando o período vai até o dia em que ele é gerado, que é o padrão do aplicativo.
Wise--✓✓Conta em várias moedas: envie o .zip do extrato como veio, e cada moeda vira uma conta. Também em QIF, exportado em inglês. Veja Wise: uma conta por moeda.

O seu banco não está na lista?

Outros bancos que exportam OFX no formato padrão costumam funcionar sem nada a fazer - vale tentar. Um PDF, CSV ou planilha de um banco que não está na tabela é recusado em vez de lido pela metade - a mensagem diz que o arquivo ainda não é suportado e traz o endereço para onde mandar um exemplo. Incluir um banco novo é rápido.

E-mail

Comunidade no Discord

discord.gg/XRFVcuM5JF

Como importar

Exporte o extrato no banco

No internet banking ou no aplicativo, abra o extrato da conta (ou a fatura do cartão), escolha o período e salve em OFX, PDF, CSV, QIF ou Excel - o que o seu banco oferecer da tabela acima. Períodos que se sobrepõem a importações anteriores não são problema. Use sempre o mesmo formato para cada conta (por quê).

Envie para o PhinApp

Em Gestão de contas → Transações bancárias, clique em Importar extrato e arraste o arquivo (.ofx, .pdf, .csv, .qif, .xls, .xlsx ou o .zip da Wise) - ou clique para escolher. Também dá para arrastar o arquivo direto para a lista de lançamentos: a importação abre já lendo o arquivo. Um mesmo arquivo pode trazer mais de uma conta - o .zip da Wise traz uma por moeda.

Confira o resultado

Para cada conta do arquivo, o PhinApp mostra quantos lançamentos foram importados, quantos já existiam, quantos parceiros novos foram cadastrados, quantos foram substituídos numa troca de formato e quantos ficaram de fora por serem de dias que a conta recebe em outro formato (se houver), o ajuste de saldo lançado a seu pedido (se houver) e o saldo atual da conta - o número para conferir com o aplicativo do banco. Abaixo das contas, diz quantos lançamentos foram conciliados automaticamente - do arquivo inteiro, porque a conciliação roda uma vez, depois de todas as contas - e as divergências de saldo das contas do arquivo, se houver.

No Windows, feche a planilha no Excel antes de importá-la: enquanto está aberta, o Excel bloqueia o arquivo e o navegador não consegue lê-lo.

Arquivos grandes

Um arquivo pode ter até 25 MB e 50.000 lançamentos. Acima disso, ele é recusado antes de qualquer lançamento ser gravado: divida o período em partes menores - cada parte é importada como o todo seria, e períodos que se sobrepõem não duplicam nada.

Uma importação grande - o histórico de anos de uma conta, dezenas de milhares de lançamentos - pode levar alguns minutos. A janela avisa que a importação continua e espera por ela; se você a fechar, a importação segue no servidor e os lançamentos aparecem na lista quando ela terminar.

O que acontece em cada importação

A conta certa, sem duplicados

A conta é reconhecida pelo código do banco, pela agência e pelo número - e pelo mesmo número escrito de outro jeito: o OFX, o PDF e o CSV de uma mesma conta caem na mesma conta, mesmo que um escreva 12345678-9 e o outro 123456789 - e a conta então aceita um só desses formatos (veja abaixo). Se ainda não existe, é criada - como conta conectada.

Importar de novo o mesmo arquivo, ou um período que se sobrepõe a outro, não duplica nada: o que já foi importado é reconhecido e aparece como "já existentes", e só o que é novo entra. Por isso não é preciso controlar quais dias já foram importados - na dúvida, importe de novo.

Um formato por conta

Um lançamento importado é reconhecido pelo identificador que o arquivo dá a ele, e cada formato identifica os lançamentos do seu jeito: o OFX traz o identificador do banco, e o PDF e a planilha muitas vezes não trazem nenhum. Comparar o que os lançamentos dizem não resolve com segurança: dois cafés de R$ 8,50 em dias seguidos são idênticos a um café só que cada formato datou num dia - e um saldo errado é pior que um aviso.

Por isso, cada dia de uma conta é de um formato só. A conta começa no formato do primeiro arquivo importado, que aparece ao lado dela na lista de contas (por exemplo, Extrato · OFX). Um arquivo de outro formato traz só os dias que nenhum formato tem - os anteriores ao primeiro dia da conta (extratos antigos) -, e para os dias que vêm depois o PhinApp oferece trocar o formato da conta. Os dias que a conta já recebe em outro formato ficam como estão, e o resultado diz quantos lançamentos do arquivo ficaram de fora por isso.

Alguns bancos dão a cada lançamento o mesmo identificador em mais de um formato, e esses formatos valem como um só - dá para alternar entre eles à vontade:

BancoFormatos que valem como um
InterOFX, PDF e CSV
Nubank (conta)OFX e CSV
BradescoPDF e CSV
PicPayPDF e CSV
SantanderPDF, CSV e Excel do extrato de conta
WiseQIF, CSV e Excel

No Santander, o extrato consolidado e o extrato de conta são dois formatos, mesmo sendo os dois em PDF - cada um identifica os lançamentos do seu jeito -, e o mesmo vale para a planilha do Santander Empresas e a do extrato de conta. Uma conta que vinha do extrato consolidado e passa a receber o extrato de conta faz uma troca de formato como qualquer outra.

Nos cartões de crédito, a fatura em PDF e o OFX são sempre formatos diferentes - e, no Bradesco, a fatura em aberto e a fatura mensal também.

A fatura em aberto do Bradesco

O aplicativo Bradesco Cartões exporta em PDF a fatura ainda em aberto (Situação do Extrato: EM ABERTO). Ela não diz quando o período começou nem quando fecha - só o dia em que foi exportada -, então o PhinApp a encaixa no calendário do cartão: o período começa no último fechamento antes da exportação, e um lançamento com data anterior a ele (lançado com atraso) entra no primeiro dia do período, como numa fatura fechada. Num cartão novo, o PhinApp pergunta antes o dia do fechamento e o do vencimento.

A fatura em aberto escreve cada compra de um jeito diferente da fatura mensal - o nome do lojista vem cortado -, por isso as duas são formatos diferentes. Ao importar a fatura fechada depois da aberta, o PhinApp pede para trocar o formato a partir do primeiro dia do período: os lançamentos da fatura em aberto saem e dão lugar aos da fechada, que é a definitiva. Uma fatura em aberto exportada no dia do fechamento que ainda mostre só o período anterior é recusada: importe a fatura fechada desse período.

Trocar de formato

Quando o banco deixa de oferecer o formato que você usa - ou você prefere outro -, importe o arquivo novo normalmente. Antes de importar qualquer coisa, o PhinApp pergunta a partir de que dia o arquivo novo vale: os lançamentos até a véspera continuam como estão, e daquele dia em diante só entram arquivos do formato novo. Nenhum dia fica com lançamentos dos dois. Os lançamentos do formato antigo a partir desse dia saem da conta e dão lugar aos do arquivo novo - o diálogo diz quantos antes de você confirmar, e o resultado mostra quantos foram substituídos. Os dias antes da troca continuam sendo do formato antigo, inclusive para os extratos antigos que você importar depois. Num cartão, as parcelas futuras das compras parceladas são geradas de novo a partir do formato novo.

Os dias oferecidos vão do primeiro dia do arquivo novo - que é o que vem escolhido, quando dá: o arquivo novo passa a valer para tudo o que ele cobre - até o dia seguinte ao último lançamento que a conta já tem. Ao lado de cada dia, o PhinApp diz se o saldo da conta e o saldo do arquivo novo batem no fim da véspera. Quando batem, a troca naquele dia é exata: nenhum lançamento entra duas vezes nem fica de fora, mesmo que cada formato date um lançamento num dia diferente.

Quando não batem, quase sempre é um lançamento que cada formato data num dia diferente, bem perto da troca - por exemplo, uma compra lançada com atraso, que a fatura em PDF põe no primeiro dia da fatura e o OFX no dia em que foi feita. O diálogo então mostra, lado a lado, os lançamentos da conta na semana antes da troca e os do arquivo novo na semana a partir dela, com os de mesmo valor destacados. Marque os da conta que o arquivo novo também traz: eles saem, ficam os do arquivo novo, e a diferença é recalculada na hora.

Se sobrar uma diferença que nenhum lançamento explica - alguns centavos de arredondamento entre um formato e outro, como pode acontecer entre o OFX e a fatura em PDF de um cartão -, escolha entre:

  • lançar um ajuste: um lançamento com o valor da diferença, na véspera da troca, para os saldos passarem a conferir. Ele entra sem classificação, para você classificar como quiser, e as próximas importações de qualquer dos dois formatos o levam em conta;
  • deixar a diferença: a conta passa a mostrar a divergência de saldo naquele dia.

Se o arquivo não informa o saldo e não há o que conferir, é preciso confirmar que quer seguir mesmo assim.

Não dá para escolher um dia em que sairia algum lançamento já conciliado - desfaça a conciliação ou escolha um dia depois dele. A troca só é oferecida por um arquivo que chega ao último dia que a conta já tem; um que termina antes traz só os dias do próprio formato. E quando o arquivo novo também tem dias que já são do formato dele - um extrato do formato que a conta usava antes, por exemplo -, dá para responder não trocar: entram só esses dias, e a conta continua como está.

Extratos antigos

Um extrato antigo pode ser importado a qualquer momento, em qualquer formato que a conta já recebeu: ele traz os dias desse formato e deixa os outros como estão. Depois de uma troca do OFX para o PDF, por exemplo, um OFX antigo completa os dias que ainda são do OFX, e um PDF antigo completa os que já são do PDF.

Os dias antes do primeiro dia da conta ainda não são de formato nenhum, e entram no formato do arquivo, seja qual for. Se for outro formato, o PhinApp confere o saldo do arquivo com o saldo de abertura da conta no fim da véspera do primeiro dia dela. Quando batem, os dias entram sem perguntar nada. Quando não batem, o diálogo mostra os lançamentos do arquivo na última semana antes da conta ao lado dos da conta na primeira semana: marque os do arquivo que a conta já tem - eles não entram, e fica o da conta -, e resolva o que sobrar com um ajuste ou deixando a diferença, como numa troca. Nada sai da conta.

A moeda da conta

A moeda vem do próprio arquivo: o OFX a informa, e PDF, CSV e Excel a imprimem - o R$ ao lado dos valores, ou como unidade de uma coluna (Valor (R$)) ou do extrato inteiro (Valores em R$). O PhinApp só pergunta quando o arquivo não mostra moeda em lugar nenhum - os CSV do Inter e do Nubank, e o CSV e a planilha do extrato de conta do Santander, trazem só os números - e a importação vai criar uma conta; a moeda principal da organização já vem escolhida, e a pergunta existe porque a moeda de uma conta não muda depois. Numa conta que já existe, vale a moeda dela. Um arquivo numa moeda diferente da conta é recusado para aquela conta, e o resultado diz quais são as duas: um valor em dólar não entra numa conta em reais. Uma fatura de cartão está na moeda do seu total: uma compra feita no exterior, impressa na moeda dela ao lado do que custou em reais, não muda isso. Na Wise, o CSV e a planilha dizem a moeda em cada lançamento, e o QIF, que não diz, vem dentro do .zip num arquivo com a moeda no nome (veja abaixo).

Arquivos protegidos por senha

Vários bancos protegem o PDF com uma senha - em geral, os primeiros dígitos do CPF ou do CNPJ do titular. O PhinApp tenta primeiro os dígitos do CNPJ da sua empresa; se nenhum abrir o arquivo, pede a senha. Ela é usada só para abrir o arquivo naquele momento e não fica guardada.

Arquivos que não dizem a conta

Alguns CSVs - o da conta Nubank e o da PicPay - trazem os lançamentos e nada mais: nem a conta, nem o saldo. O PhinApp reconhece a conta pelos lançamentos que ela já tem (o CSV do Nubank traz os mesmos identificadores do OFX); quando não dá, pergunta de qual conta é o arquivo. O mesmo acontece com a fatura em PDF de um cartão que você já tem cadastrado a partir do OFX: a escolha fica guardada, e as próximas faturas caem no mesmo cartão sem perguntar. Como o PDF e o OFX de um cartão identificam as compras de jeitos diferentes, o PhinApp então oferece trocar o formato do cartão.

O CSV da fatura do cartão Nubank não diz nem de qual cartão é. O PhinApp pergunta, a cada arquivo, qual dos seus cartões Nubank ele é - ou abre um novo, pedindo o nome, os dias de fechamento e de vencimento e o saldo do dia anterior à fatura. O CSV e o PDF de uma mesma fatura descrevem o pagamento de jeitos diferentes e podem divergir em um centavo num IOF, então são dois formatos do cartão: para passar de um para o outro, o PhinApp oferece trocar o formato.

Wise: uma conta por moeda

Na Wise, a conta tem um saldo em cada moeda, e o extrato é um .zip com um arquivo para cada uma, no formato escolhido na exportação: QIF, CSV ou Excel. Envie o .zip como veio. Cada moeda vira uma conta no PhinApp, na sua moeda e com o número que a Wise dá a esse saldo; as moedas que não tiveram lançamento no período ficam de fora.

O número, a moeda e o período vêm do nome que a Wise dá a cada arquivo dentro do .zip - por exemplo, statement_12345678_USD_2026-07-01_2026-09-30.qif -, porque o QIF não traz nenhum dos três. Um arquivo tirado do .zip e renomeado ainda é importado, mas o PhinApp pergunta de qual conta ele é e, se for uma conta nova, em que moeda.

  • O QIF só em inglês. A Wise escreve o arquivo no idioma escolhido na exportação, e a data de um QIF não diz se vem antes o dia ou o mês: 07/04/2026 é 4 de julho em inglês e 7 de abril em português. Por isso o PhinApp lê o QIF em inglês e recusa o de outro idioma, com o aviso para exportar de novo. O CSV traz os títulos das colunas em inglês em qualquer idioma; só as descrições seguem o idioma escolhido.
  • O saldo. O CSV e a planilha trazem o saldo depois de cada lançamento, e o PhinApp o usa como o de qualquer extrato. O QIF não traz saldo nenhum: na primeira importação de cada moeda, o PhinApp pede o saldo anterior.
  • Um formato só. O QIF, o CSV e o Excel identificam cada lançamento pelo mesmo número da Wise, e dá para alternar entre eles à vontade. Uma conversão entre duas moedas aparece nas duas contas: a saída numa, a entrada na outra.

O saldo de cada dia

O PhinApp usa o saldo que o próprio arquivo informa - no OFX, o saldo do extrato; na planilha do Itaú, o SALDO TOTAL DISPONÍVEL DIA; na do Santander, a coluna Saldo; no PDF, o saldo de cada dia, o saldo do período ou a coluna de saldo, conforme o banco - para fixar o saldo de cada dia que o arquivo cobre e que já terminou. O dia de hoje fica em aberto, porque ainda pode ter movimento.

No Itaú, o saldo do OFX inclui o rendimento da aplicação automática que ainda não foi creditado como lançamento - em geral, alguns centavos. Como o OFX não diz quanto é, os saldos dos dias que ele cobre ficam esses centavos acima dos que o banco mostra, até um extrato posterior cobrir esses dias de novo. O PDF e o Excel trazem o saldo de cada dia já fechado e batem com o banco centavo por centavo.

Quando o arquivo não traz um saldo utilizável e a conta ainda não conhece nenhum, a importação para e pede o saldo anterior: o saldo com que a conta fechou no dia anterior ao início do extrato. É pedido uma vez; depois disso, a conta segue sozinha. Nem um arquivo que começa depois de um intervalo sem extrato traz a pergunta de volta: os saldos seguem do último que a conta conhece, somando os lançamentos do arquivo, e os do intervalo entram nos dias deles quando esse período for importado.

Parceiros e classificação

A planilha do Itaú traz a razão social e o CPF/CNPJ de quem pagou ou recebeu. O PhinApp liga cada lançamento ao parceiro correspondente - e cadastra quem ainda não existe, como fornecedor, cliente ou ambos, conforme o sentido do dinheiro. Nos outros bancos, o nome é lido da própria descrição do lançamento sempre que ela o traz com segurança.

Primeiro as regras de classificação - as suas e as que o PhinApp aprendeu com o que você já classificou - classificam o que reconhecem; depois, se o parceiro tem uma classificação padrão, o lançamento já chega classificado. O resumo da importação diz quantos as regras classificaram. Ao final, a conciliação procura os títulos que esses lançamentos quitaram - e, com a conciliação automática ligada, concilia sozinha os de parceiros com classificação padrão e os que uma regra que pode conciliar sozinha classificou.

O número do documento

Quando o banco imprime um número ao lado do lançamento - o Docto. do Bradesco, o Nº documento do Santander, o CHECKNUM (ou, sem ele, o REFNUM) de um arquivo OFX -, o PhinApp guarda esse número no lançamento. Ele aparece na coluna Nº documento de Transações bancárias, no lançamento aberto e nos dois lados da conciliação, e a busca encontra o lançamento por ele.

Na conciliação, um lançamento cujo número do documento é um dos números do título - o número no banco de um boleto, o número do documento, o código do ERP - é o lançamento daquele título. É o que separa dois títulos do mesmo parceiro, do mesmo dia e do mesmo valor.

O que não é documento fica de fora: no OFX, o Itaú repete ali o próprio identificador do lançamento, e o Inter, o código do banco. Lançamentos importados antes de o número ser guardado ficam sem ele até o extrato ser importado de novo - os que já existem não são duplicados, só recebem o número.

O que não é movimento

  • As linhas de saldo (SALDO ANTERIOR, SALDO TOTAL DISPONÍVEL DIA e outras) nunca viram lançamentos - elas são usadas para os saldos.
  • No Itaú, os lançamentos futuros que o PDF do internet banking e o Excel listam depois dos lançamentos (Pix, TEDs e débitos agendados) não são importados: o dinheiro ainda não saiu. O que vem depois deles - a posição consolidada e os limites - também fica de fora.
  • No Itaú, a aplicação automática (APL APLIC AUT MAIS e RES APLIC AUT MAIS) é ignorada: é o banco guardando e devolvendo o saldo da própria conta, sem que o dinheiro saia da empresa. Os rendimentos dessa aplicação (RENDIMENTOS REND PAGO APLIC AUT MAIS) são importados normalmente, porque são receita.
  • Na PicPay, o que foi pago com cartão (um Pix ou um boleto pago no crédito) aparece no extrato da conta, mas o saldo da conta não muda: o valor está na fatura do cartão. Por isso essas linhas não são importadas no extrato - importá-las contaria a despesa duas vezes.
  • Na RecargaPay, o Rendimento CDI aparece no extrato da carteira, mas não entra no saldo dela: vai para o limite garantido do cartão, junto com o cashback. Por isso não é importado - o saldo da carteira no PhinApp é o mesmo do aplicativo.
  • Na Nomad, só entram os lançamentos concluídos (Concluído, ou Settled no relatório em inglês). Um lançamento ainda pendente fica de fora, com um aviso no resultado da importação, até um relatório mostrá-lo concluído.

Pagamentos agrupados

Alguns extratos juntam vários pagamentos em um único lançamento. No Itaú, é o SISPAG FORNECEDORES (e o SISPAG FORNECEDORES PIX QR-CODE): um lote inteiro de pagamentos a fornecedores aparece como um débito só, sem o nome de ninguém. Um lançamento assim não tem como ser classificado nem conciliado - ele é a soma de vários títulos, de vários fornecedores.

Por isso, um extrato com SISPAG FORNECEDORES é recusado inteiro, seja OFX, seja planilha, e nada dele é importado.

Exporte o extrato detalhado

No internet banking, exporte o extrato detalhado do mesmo período - nele, cada pagamento do lote aparece numa linha própria, com a razão social e o CPF/CNPJ de quem recebeu - e importe esse arquivo. No Itaú, use a planilha (.xls ou .xlsx) do extrato detalhado: o OFX traz os lotes agrupados.

Os outros lotes do SISPAG - SISPAG SALARIOS, SISPAG DIVERSOS, SISPAG TRIBUTOS - são importados normalmente: muitas empresas preferem ver a folha de pagamento, por exemplo, como um valor só no fluxo de caixa.

Divergência de saldo

Se dois saldos informados pelo banco não fecham com os lançamentos entre eles, o resultado da importação mostra uma divergência de saldo das contas do arquivo: a conta, o período e a diferença. Quase sempre é um extrato que falta - importe o período indicado e o aviso some. Uma diferença que você escolheu deixar numa troca de formato fica, e aparece toda vez que essa conta é importada.

Cartões de crédito

A fatura em PDF é o jeito mais simples: ela informa os dias de fechamento e de vencimento, e o cartão é configurado sozinho na primeira importação, com o nome que a fatura dá a ele (que pode ser alterado depois). As compras parceladas são reconhecidas pela parcela impressa na fatura - "Parcela 2/5", "Parcela 4 de 12", "(03/12)" ou, na do Itaú, o "04/05" ao lado do nome - e cada parcela entra no mês a que pertence; as parcelas que a fatura lista para as próximas faturas ficam para elas. A parcela não faz parte do nome do parceiro: todas as parcelas de "Loja X - Parcela 4/12" ficam com o parceiro Loja X. Se a conta da fatura não fecha - o total da fatura anterior, mais o que ela lança, não dá o total desta -, o resultado da importação avisa.

O OFX de um cartão é importado do mesmo jeito, mas não informa o fechamento nem o vencimento: na primeira vez, o PhinApp pede o nome do cartão e esses dois dias, e guarda o arquivo enquanto você responde - não é preciso escolhê-lo de novo. Daí em diante, em qualquer formato:

  • cada compra conta no dia em que foi lançada no cartão;
  • as parcelas futuras de uma compra parcelada viram contas a pagar em aberto, uma por mês;
  • o pagamento da fatura é uma transferência entre contas, não uma receita nem um parceiro - e é ligado sozinho ao débito do mesmo dia e valor na conta corrente (veja como).

Veja Cartões de crédito.

Depois de importar

Um lançamento importado é uma citação do banco: data, valor e descrição não podem ser alterados, porque os saldos de cada dia são calculados a partir deles. O que pode (e deve) ser preenchido é a classificação, o parceiro e a conciliação.

Nesta página