Importação

A Importação traz vários lançamentos de uma vez para o Orbyra, vindos do extrato do banco ou da fatura do cartão. Tudo passa por uma tela de conferência antes de ser gravado.

Importar OFX e CSV

Quase todos os bancos oferecem download do extrato em OFX (formato padrão) ou CSV (planilha). No Orbyra, vá em Lançamentos > Importar, escolha a conta de destino, faça upload do arquivo e o sistema lê todas as movimentações.

  • OFX: formato preferido — descrição, valor, data e identificador único vêm prontos.
  • CSV: você pode mapear as colunas manualmente na primeira vez (descrição, valor, data) e o Orbyra salva o mapeamento para próximas importações do mesmo banco.

O importador CSV aceita dois formatos de valor: (a) uma coluna única Valor com sinal (positivo = receita, negativo = despesa); ou (b) duas colunas separadas Entrada(R$) e Saída(R$) — formato comum em extratos de Itaú, Bradesco, Santander e Sicoob web (também aceita Crédito/Débito). Cabeçalhos como Data Lançamento, Data Contábil, Título e Descrição são reconhecidos automaticamente. Linhas de saldo (com Entrada e Saída ambas zeradas) são ignoradas. Separador ; (ponto-e-vírgula), , (vírgula) ou tab — detecção automática a partir do cabeçalho.

Fatura em PDF

Para cartões, o ideal é importar a fatura em PDF: você baixa do app do banco e envia para o Orbyra. A IA lê o documento, extrai cada compra (incluindo estornos e reembolsos com o sinal correto) e devolve a lista para conferência.

Ao enviar um PDF, o Orbyra pergunta se o documento é Fatura de cartão de crédito ou Extrato de conta corrente. Escolha Fatura de cartão aqui — os dois fluxos usam prompts de IA diferentes.

  • Mês e ano da fatura obrigatórios: antes de processar, você escolhe o mês de competência em dois seletores independentes (mês e ano), podendo selecionar livremente qualquer combinação — útil para faturas atrasadas ou antecipadas. Todas as compras do PDF são alocadas a esse mês/ano, mesmo aquelas feitas no dia do fechamento — assim você nunca tem compra "vazando" para a fatura errada.
  • Cartão de destino: em vez de uma conta bancária, você seleciona o cartão de crédito ao qual a fatura pertence. As transações aparecem na preview com a badge Cartão.
  • Tamanho: máximo de 5 MB por arquivo. Quanto menor (recomendado: enviar apenas as páginas com gastos), menor o consumo de tokens de IA.

Você também pode enviar a fatura pelo WhatsApp e o resultado vai direto para a mesma tela de conferência.

Extrato de conta corrente em PDF

Quando seu banco só disponibiliza o extrato em PDF (sem OFX/CSV), você pode importá-lo diretamente. A IA reconhece tanto entradas (PIX recebido, depósitos, salário, transferências recebidas) quanto saídas (PIX enviado, tarifas, saques, débitos automáticos) e classifica cada uma como Receita ou Despesa automaticamente.

  • Escolha o tipo no upload: ao subir o arquivo PDF, o Orbyra pergunta se é Fatura de cartão ou Extrato de conta corrente — selecione Extrato de conta corrente.
  • Conta de destino: igual à importação de OFX/CSV, você seleciona a conta bancária que vai receber os lançamentos.
  • O que a IA ignora: saldo anterior, saldo atual, totalizadores e dados do titular (número da conta, agência, CPF) — apenas as movimentações de entrada e saída são importadas.
  • Tamanho: máximo de 5 MB por arquivo. Envie só as páginas com movimentações para economizar tokens de IA.
Detecção automática de parcelas

Tanto na importação de extratos quanto de faturas em PDF, o Orbyra reconhece automaticamente parcelamentos no padrão 3/12 (terceira de doze) na descrição da transação. Cada parcela é importada individualmente, com seu número de parcela preservado e uma badge na preview — a série completa não é gerada de novo, evitando duplicidade com parcelas que ainda nem caíram na fatura.

Tela de conferência

Antes de gravar, o Orbyra mostra uma tabela com todos os lançamentos extraídos. Para cada linha você pode:

  • Ajustar descrição, valor, data, categoria e pessoa
  • Marcar como duplicado (ignorar)
  • Aceitar a sugestão de categoria da IA ou escolher outra

Quando estiver tudo certo, clique em Gravar e os lançamentos selecionados são criados de uma vez.

Detecção de duplicados

O Orbyra tenta identificar lançamentos que já existem e sinaliza os candidatos a duplicados na tela de conferência (descrição em destaque). Você decide se importa ou ignora.

A checagem cruza data exata, valor exato, tipo (Receita/Despesa) e descrição com correspondência parcial: se a descrição importada estiver contida na existente — ou vice-versa — depois de uma normalização (caixa baixa, espaços extras removidos), o lançamento é marcado como possível duplicata. Isso captura variações comuns como "PIX MERCADO" vs "PIX MERCADO 12/03". Para evitar falsos positivos com descrições muito curtas, exigimos no mínimo 4 caracteres em cada lado para o match parcial.

Para compras parceladas, a checagem leva em conta o número da parcela: ter a parcela 2/10 já gravada não impede a importação da 4/10 que vem na fatura seguinte. Só desmarca quando a mesma parcela X/Y dessa série já existe.

Para arquivos OFX, a checagem é mais precisa porque cada movimentação tem um identificador único — o mesmo OFX importado duas vezes não cria nada novo.

Desfazer uma importação

Cada lançamento criado por importação registra o nome do arquivo de origem. Em Lançamentos > Importados você vê a lista de arquivos já processados e pode excluir um arquivo inteiro com um clique — todos os lançamentos vinculados, incluindo as parcelas futuras geradas automaticamente (ex: 2/12, 3/12…), são removidos juntos.