Manual do usuário · Capítulo 11

Importações

Este capítulo descreve o Fólio Invest na versão 0.62.3. Se o seu app estiver em outra versão, um detalhe de tela ou de comportamento pode ser diferente.

No app: vários pontos
Neste capítulo
  1. 1. Operações — extrato da B3
  2. 2. Operações — CSV próprio
  3. 3. Proventos
  4. 4. Movimentos (aportes, resgates, realocações, conversões)
  5. 5. Saldos de posições de patrimônio
  6. O que é comum a todas
  7. O que estas telas NÃO fazem

Para que serve

trazer dados em lote, em vez de digitar um por um.

O Fólio tem cinco telas de importação, cada uma para um assunto e em um lugar diferente. Esta é a tabela que resolve a maior parte das dúvidas:

O que você quer importarOnde fica
Compras e vendas (extrato B3 .xlsx ou CSV) › Importar CSV / B3
Proventos (relatório B3 .xlsx ou CSV)Dividendos › Importar proventos via CSV
Aportes, resgates, realocações e conversõesAportes › Importar
Saldos mensais de posições de patrimônioPosições de patrimônio › Importar
Backup completo do app › Backup › Importar (ver capítulo 12)

O padrão de todas elas é o mesmo: você escolhe o arquivo, o app analisa e mostra um resumo, e só depois você confirma. Nada entra sem a sua confirmação.

1. Operações — extrato da B3#

Caminho: Importar CSV / B3.

  1. No portal ou app da B3, baixe o relatório Negociação de Ativos (.xlsx).
  2. No Fólio, toque em Selecionar extrato B3.
  3. Escolha o arquivo.
  4. Confira o resumo: compras novas, vendas, duplicadas e linhas ignoradas.
  5. Toque em Importar N.
  6. Ao final, o app mostra quantas compras e vendas entraram e oferece Ver carteira.

⚠️ A classe do ativo é inferida pelo ticker. O app avisa isso na tela de conferência. Confira as classes antes de confirmar — um ativo classificado errado muda a apuração de imposto.

2. Operações — CSV próprio#

Mesma tela, cartão CSV de operações. Use para trazer histórico de outras fontes.

Toque em Baixar modelo (.csv) — o app salva um arquivo com o cabeçalho pronto. Abra no Excel ou no Google Sheets e preencha.

ColunaObrigatóriaO que colocar
tiposimACOES / FII / ETF / BDR / USA / OPCOES / CRIPTO
papelsimex.: ITSA4
quantidadesimnúmero
dataComprasimdd/mm/aaaa
precoComprasimpreço unitário (vírgula ou ponto)
custosnãotaxas
setornãolivre
usdCompra / usdVendanãocâmbio; em branco = o app busca a PTAX do BCB pela data
dataVenda / precoVenda / qtdeVendanãopreencha para trazer a venda na mesma linha
dayTrade / isentaIrnãoSIM / NAO
moedanãoBRL/USD — só para cripto em US$ (exige usdCompra na linha)

3. Proventos#

Caminho: aba DividendosImportar proventos via CSV.

Dois caminhos na mesma tela:

Relatório de Proventos da B3 (.xlsx) — baixe na área do investidor da B3 e toque em Importar relatório B3 (.xlsx). Na conferência, o app marca:

  • linhas já existentes (desmarcadas automaticamente);
  • linhas ambíguas, em que o tipo de provento precisa da sua revisão;
  • linhas ignoradas e linhas com erro.

CSV de proventos — toque em Baixar modelo (.csv).

ColunaObrigatóriaO que colocar
papelsimex.: ITSA4, AAPL
tipoAtivosimACOES, FII, ETF, BDR, USA, OPCOES
tipoProventosimDIVIDENDO, JCP, RENDIMENTO_FII, RENDIMENTO_RF…
dataPagamentosimdd/mm/aaaa
valorsimvalor recebido
observacaonãolivre
valorUsd / ptaxnãoexterior: US$ + câmbio (em branco = PTAX do BCB)
impostoPagoExteriornãoIR pago no exterior
classeExteriornãoACAO / ETF / BOND / FUNDO

⚠️ A tela avisa: em JCP, informe o valor líquido (já com o imposto retido).

4. Movimentos (aportes, resgates, realocações, conversões)#

Caminho: PatrimônioGerenciar aportesImportar.

Um arquivo só cobre aportes e resgates em R$, em US$ e conversões.

ColunaObrigatóriaO que colocar
datasimdd/mm/aaaa
valor_brlsimreais (negativo = resgate)
valor_usdnãodólar (vazio = só reais)
taxasnãoIOF / taxas
tiponãoaporte / resgate / realocacao / conversao
observacaonãolivre
posicaonãonome do ativo, para ligar o movimento a uma posição

Se tipo ficar em branco: com valor_usd preenchido, o app assume conversão; sem valor_usd, o sinal de valor_brl decide (positivo = aporte, negativo = resgate).

Sobre a coluna posicao: escreva o nome do ativo como está em Posições de patrimônio (acento e maiúsculas não importam). Em branco, o movimento fica no caixa geral — entra no patrimônio, mas não nas fichas do IRPF que dependem de saber a que aplicação ele pertence.

Se o nome não existir, nada é perdido: o movimento entra no caixa geral, o app avisa qual nome não encontrou, e você vincula depois. Ao final, o atalho Ver os N movimentos → abre a lista já filtrada em "Sem vínculo".

5. Saldos de posições de patrimônio#

Caminho: PatrimônioGerenciar posições de patrimônioImportar.

Cada linha é o saldo de fechamento de uma posição num mês.

ColunaObrigatóriaO que colocar
classesimFUNDO, CDB, TESOURO…
instituicaosimex.: NuInvest
nomeAtivosimex.: Tesouro Selic 2029
competenciasimmm/aaaa (aceita dd/mm/aaaa do Excel)
saldosimfechamento do mês
valorAplicadonãosó na 1ª linha de um ativo novo
dataAplicacaonãodd/mm/aaaa · 1ª linha de ativo novo
moedanãoBRL/USD · só para ativo em US$ (1ª linha)
ptaxAplicacaonãocâmbio fiscal da aplicação · US$ (1ª linha)

A importação cria posições que ainda não existem. Na conferência, o app mostra quantos saldos e quantas posições novas vai criar, e oferece o interruptor Registrar aportes para as N posições novas — que cria um aporte por posição nova, na data de aplicação de cada uma.

O que é comum a todas#

O app avisou "N linhas ignoradas". Perdi dados?#

Não. Essas linhas simplesmente não entraram. Toque para abrir a caixa: ela mostra o número da linha, o motivo e o conteúdo original. Corrija no arquivo e importe de novo.

Se eu importar duas vezes, vai duplicar?#

As telas de importação detectam registros já existentes e desmarcam ou pulam as duplicatas — o resumo de conferência mostra quantas foram. Mesmo assim, confira o número na tela antes de confirmar.

Preciso importar as posições antes dos movimentos?#

Não. Se a coluna posicao citar um nome que ainda não existe, o movimento entra no caixa geral e você vincula depois.

O que estas telas NÃO fazem#

  • Não conectam com a corretora nem com a B3. Você baixa o arquivo e envia.
  • Não aceitam nota de corretagem em PDF.
  • Não corrigem o conteúdo do arquivo. Erro no arquivo vira linha ignorada.
  • Não apagam nada: importar acrescenta. Quem substitui tudo é o Backup.

Manual do usuário do Fólio Invest — descreve o comportamento do app na versão indicada no topo. Conteúdo informativo e educativo: não é consultoria tributária, contábil ou de investimentos, não é recomendação de compra, venda ou manutenção de qualquer ativo, e não substitui a orientação de um profissional para o seu caso concreto. Quando o capítulo traz regra tributária, ela foi verificada nas fontes oficiais na data indicada no próprio capítulo. A responsabilidade pela declaração é do contribuinte.