O bloco 1 muda as suas posições. Os blocos 2 e 3 alimentam análises e gráficos, e você pode reimportar quantas vezes quiser, sem risco. O bloco 4 troca tabelas de apoio, e o 5 é a licença.
1 · Importe o extrato da B3
O único bloco que altera a sua carteira.
| Controle | O que é | Como usar |
|---|---|---|
| Importar novos lançamentos | Lê os extratos da B3 (a bolsa brasileira) que estão em dados/entrada/. |
É o botão do dia a dia. Pode deixar vários extratos na pasta: o que já entrou não entra de novo. |
| janela (dias) | Quantos dias antes do fim da sua base o programa relê. | Vem em 5, e é para ficar em 5. A folga existe porque a corretora publica operações com atraso. Aumentar joga mais coisa antiga na lista de retidos. |
| reimportar do zero | Apaga o que veio da B3 e lê o extrato inteiro de novo, sem reter nada. | Só se você desconfiar que a base bagunçou, e depois de um backup. O que você digitou à mão continua lá. |
Lançamentos retidos
Comece por marcar só as duplicatas e depois dispensar marcados. A lista aparece quando o extrato traz algo mais antigo que a janela, e o programa deixa você decidir. O que você dispensar não volta.
| Botão | O que faz | Quando |
|---|---|---|
| marcar só as duplicatas | Marca as linhas que parecem já existir na sua base. | É o primeiro clique. Depois use dispensar marcados. |
| marcar todos | Marca tudo, menos as prováveis repetições. | Quando você conferiu a lista inteira e é tudo operação de verdade. |
| desmarcar | Limpa a seleção. | Para recomeçar. |
| importar marcados | Põe as linhas marcadas na carteira. | Depois de conferir uma a uma. |
| dispensar marcados | Descarta as marcadas, para sempre. | É a escolha segura na dúvida. |
Essa lista assusta na primeira importação, e com razão. Quando uma empresa troca o código do papel, a mesma compra antiga volta a parecer nova. Por isso a lista também compara data, quantidade e valor.
Aceitar uma dessas duplica anos de histórico de uma vez. Num teste com extrato de verdade, 48 das 62 pendências eram repetições disfarçadas. Na dúvida, dispense: se fizer falta, você lança à mão e sabe o que entrou.
2 · Traga os dados do Status Invest
Alimenta as telas Análise e Seleção. Não toca na sua carteira.
| Botão | O que faz |
|---|---|
| Importar da pasta | Lê os CSVs (planilhas em texto) do Status Invest em dados/entrada/. Não precisa renomear: o programa reconhece cada arquivo. |
| Abrir a tela Seleção | Atalho para onde você filtra esse universo. |
Baixe três arquivos sem preencher filtro nenhum: a busca avançada de ações, a de fundos imobiliários e a de ações negociadas fora. O filtro você faz no programa, onde dá para salvá-lo.
3 · Atualize cotações e índices
| Botão | O que traz | Com que frequência |
|---|---|---|
| Atualizar cotações de hoje | O preço atual de cada papel que você tem. | Sempre que quiser ver o saldo atualizado. |
| Buscar histórico de cotações | O fechamento de cada mês desde o começo da sua carteira. | Uma vez, no início. Demora alguns minutos. Sem isso, os gráficos de patrimônio e rentabilidade não existem. |
| Atualizar CDI, IPCA e IBOV | As séries oficiais: CDI (o rendimento de referência da renda fixa), IPCA (a inflação oficial) e IBOV (o índice da bolsa). | Uma vez por mês, que é quando elas saem. |
| Atualizar câmbio (dólar) | A série do dólar do Banco Central. | Antes de lançar qualquer coisa em dólar. |
| Recalcular tudo | Refaz as contas com o que já está gravado. Não busca nada. | Quando um número parecer preso numa versão antiga. |
| Exportar dashboard HTML | Gera um arquivo com o resumo da carteira, para abrir fora do programa. | Quando quiser guardar uma foto do momento. |
Desdobramento é quando a empresa divide cada ação em várias. O preço da fonte vem reescalado pelo desdobramento, e não pelo dividendo, que o programa soma por fora. É a mesma escala da quantidade calculada pelo sistema, então o padrão é gravar o preço como vem.
A única exceção é o desdobramento que o sistema conhece, porque está cadastrado como evento societário. Aí a quantidade antiga está na escala antiga, e o programa desfaz o ajuste do preço para as duas baterem.
Se a fonte informa um desdobramento que não está cadastrado, o programa não mexe em nada e avisa logo abaixo dos botões, com papel, data e razão. Cadastre o evento em Lançamentos, botão Lançar evento societário, e rode a busca de novo.
Preço de um mês dez vezes maior que o do seguinte? Falta o evento. Depois de atualizar o programa, rode Buscar histórico de cotações uma vez para regravar tudo na escala certa.
Preço manual
Use para o papel que a busca automática não acha, ou quando a avaliação passou dos 30 dias e a busca parou.
| Campo | O que preencher |
|---|---|
| Ativo | O código do papel, exatamente como ele aparece na sua carteira. |
| Preço | O preço de uma cota, na moeda do ativo. |
O preço digitado vale em todas as contas, como qualquer outro.
4 · Instale tabelas de referência
O setor de cada empresa, a tradução dos nomes que vêm das fontes, as faixas de cada critério. Muda com o tempo, então viaja separado do programa.
| Botão | O que faz |
|---|---|
| Aplicar pacote recebido | Lê um arquivo de referência que você recebeu e soma ao que já existe. |
| Gerar pacote deste sistema | Exporta as tabelas em vigor aqui. |
Ele entra somado, item por item. Um pacote que corrige três empresas não apaga as outras duzentas e setenta. Pacote mais antigo que o vigente é recusado, para você não voltar atrás sem querer. E sem pacote nenhum o programa funciona igual.
5 · Confira a licença
Aqui você vê a sua situação e instala o arquivo licenca.json.
Na avaliação gratuita todas as telas funcionam para sempre; só a busca
automática de preços tem prazo de 30 dias.
A licença não liga nem desliga o programa. Ela só decide até que data você pode instalar um pacote de referência novo (capítulo 4). Por isso nada trava quando a assinatura vence.
| Situação | O que os cartões mostram |
|---|---|
| Avaliação (nenhum arquivo instalado) |
Situação: Avaliação, com todas as telas e cálculos liberados, e Atualizações: as da instalação. Pacotes de tabela novos pedem assinatura. |
| Licença instalada | Licenciado para (nome e e-mail), Plano e o id da licença, e Atualizações até a data de validade. Se já passou, aparece Venceu em, em vermelho. |
Clique em Tenho uma licença, instalar na primeira vez; depois o mesmo
botão vira Instalar licença nova, para trocar de plano ou renovar. Escolha
o .json que chegou por e-mail.
O servidor confere o arquivo antes de gravar. Arquivo errado não derruba a licença que já estava instalada.
6 · Cole a chave de IA
Escolha o provedor (Anthropic, OpenAI ou Google), confira o Modelo e cole a Chave de API, que é a senha de acesso à sua conta de IA. Ela fica aqui, e não no Assistente, porque se ajusta uma vez e pronto.
A confusão mais comum é entre os dois campos. O modelo é o nome técnico no
provedor, algo como claude-sonnet-4-5, e não o apelido que você
deu à chave. Se errar, o link
voltar ao padrão devolve o nome certo.
Ao clicar em Salvar e testar, o sistema faz uma pergunta mínima ao
provedor. Chave recusada não é salva, e a anterior fica como estava. Depois de gravada, a chave não volta mais para a
tela: fica em dados/config/ia.json, só nesta máquina, fora do
banco, do backup e do pacote de auditoria.
O que o Assistente faz com
ela ›
Módulos desta carteira
Para o menu mostrar só o que você usa.
Resumo, Posições, Patrimônio, Rentabilidade, Proventos, Lançamentos, Revisão e Dados estão sempre ligados. O resto vem em módulos, cada um com uma linha dizendo para que serve: renda fixa e fundos, exterior e moedas, dia a dia (cartões e conta corrente), impostos, planejamento e outros.
Desmarque o que você não usa e clique em Salvar módulos. As telas saem do menu, junto com os atalhos que levavam a elas.
Os lançamentos ficam guardados e voltam quando você religar. Renda fixa e exterior continuam somando no patrimônio mesmo com o módulo desligado: o patrimônio é o que você tem, não o que aparece na tela. O cartão do módulo avisa quando ele tem lançamentos.
A escolha vale só para a carteira aberta: cada carteira tem a sua. Ao criar uma carteira nova, todos os módulos vêm marcados e você desmarca ali mesmo o que não quer.
O Assistente de IA só pode ser ligado com a licença do pacote NextInv + sua IA em dia. Sem ela, a caixa fica travada e diz o motivo. Instalou a licença certa, ele aparece sozinho.
7 · Versão do sistema
Aqui você vê se saiu versão nova. Uma vez por dia, ao abrir, o
sistema lê um arquivo público do site, nextinv.com.br/versao.json,
e compara com a versão instalada no seu computador. O pedido vai sem nada
seu: nem a versão, nem a licença, nem a carteira.
Saindo versão nova, aparece um aviso no topo de qualquer tela, com o que mudou (a página de Novidades) e baixar (a página de instalar). O sistema não baixa nem instala nada sozinho. Lembrar depois fecha o aviso daquela versão; saindo outra, ele volta.
| Controle | O que faz |
|---|---|
| procurar versão nova uma vez por dia | Liga e desliga a consulta. Desligada, o sistema nunca fala com o site. |
| Procurar agora | Consulta na hora, mesmo que já tenha consultado hoje. |
Erros comuns nesta tela
Importei e não entrou nada
O arquivo precisa estar dentro de dados/entrada/, na pasta do
programa. E o relatório certo é o Movimentação da B3, não o de
negociação.
Apareceu um monte de lançamento antigo
Eles ficaram retidos e não entraram na carteira. Comece por marcar só as duplicatas.
As cotações não atualizam mais
Se a sua avaliação passou dos 30 dias, a busca automática parou. Use o Preço manual, que funciona para sempre.
Lancei em dólar e o valor entrou errado
Rode Atualizar câmbio (dólar) e lance de novo. Deixe o campo de câmbio em branco, para o programa buscar a cotação do dia da operação.