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.
Neste capítulo
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 importar | Onde 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ões | Aportes › Importar |
| Saldos mensais de posições de patrimônio | Posiçõ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.
- No portal ou app da B3, baixe o relatório Negociação de Ativos (
.xlsx). - No Fólio, toque em Selecionar extrato B3.
- Escolha o arquivo.
- Confira o resumo: compras novas, vendas, duplicadas e linhas ignoradas.
- Toque em Importar N.
- 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.
| Coluna | Obrigatória | O que colocar |
|---|---|---|
tipo | sim | ACOES / FII / ETF / BDR / USA / OPCOES / CRIPTO |
papel | sim | ex.: ITSA4 |
quantidade | sim | número |
dataCompra | sim | dd/mm/aaaa |
precoCompra | sim | preço unitário (vírgula ou ponto) |
custos | não | taxas |
setor | não | livre |
usdCompra / usdVenda | não | câmbio; em branco = o app busca a PTAX do BCB pela data |
dataVenda / precoVenda / qtdeVenda | não | preencha para trazer a venda na mesma linha |
dayTrade / isentaIr | não | SIM / NAO |
moeda | não | BRL/USD — só para cripto em US$ (exige usdCompra na linha) |
3. Proventos#
Caminho: aba Dividendos › Importar 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).
| Coluna | Obrigatória | O que colocar |
|---|---|---|
papel | sim | ex.: ITSA4, AAPL |
tipoAtivo | sim | ACOES, FII, ETF, BDR, USA, OPCOES |
tipoProvento | sim | DIVIDENDO, JCP, RENDIMENTO_FII, RENDIMENTO_RF… |
dataPagamento | sim | dd/mm/aaaa |
valor | sim | valor recebido |
observacao | não | livre |
valorUsd / ptax | não | exterior: US$ + câmbio (em branco = PTAX do BCB) |
impostoPagoExterior | não | IR pago no exterior |
classeExterior | não | ACAO / 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ônio › Gerenciar aportes › Importar.
Um arquivo só cobre aportes e resgates em R$, em US$ e conversões.
| Coluna | Obrigatória | O que colocar |
|---|---|---|
data | sim | dd/mm/aaaa |
valor_brl | sim | reais (negativo = resgate) |
valor_usd | não | dólar (vazio = só reais) |
taxas | não | IOF / taxas |
tipo | não | aporte / resgate / realocacao / conversao |
observacao | não | livre |
posicao | não | nome 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ônio › Gerenciar posições de patrimônio › Importar.
Cada linha é o saldo de fechamento de uma posição num mês.
| Coluna | Obrigatória | O que colocar |
|---|---|---|
classe | sim | FUNDO, CDB, TESOURO… |
instituicao | sim | ex.: NuInvest |
nomeAtivo | sim | ex.: Tesouro Selic 2029 |
competencia | sim | mm/aaaa (aceita dd/mm/aaaa do Excel) |
saldo | sim | fechamento do mês |
valorAplicado | não | só na 1ª linha de um ativo novo |
dataAplicacao | não | dd/mm/aaaa · 1ª linha de ativo novo |
moeda | não | BRL/USD · só para ativo em US$ (1ª linha) |
ptaxAplicacao | não | câ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.