marco/webmoney
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
a90ff9d013
webmoney/docs/MANUAL_USUARIO.md

21 KiB
Raw Blame History

📖 WebMoney - Manual do Usuário

Sistema de Gestão Financeira Pessoal e Empresarial

Versão: 1.0
Data: Dezembro 2025

📋 Índice

  1. Visão Geral
  2. Primeiros Passos
  3. Dashboard
  4. Contas Financeiras
  5. Transações
  6. Categorias
  7. Centros de Custo
  8. Importação de Extratos
  9. Passivos e Financiamentos
  10. Transações Recorrentes
  11. Detecção de Transferências
  12. Detecção de Reembolsos
  13. Configurações

1. Visão Geral

O que é o WebMoney?

O WebMoney é um sistema completo de gestão financeira que permite:

  • ✅ Controlar múltiplas contas bancárias e cartões
  • ✅ Categorizar receitas e despesas automaticamente
  • ✅ Importar extratos bancários (CSV, XLSX, OFX, PDF)
  • ✅ Gerenciar financiamentos e passivos
  • ✅ Acompanhar transações recorrentes
  • ✅ Detectar transferências e reembolsos automaticamente
  • ✅ Visualizar fluxo de caixa e análises financeiras
  • ✅ Multi-idioma (Português, Espanhol, Inglês)
  • ✅ Multi-moeda (BRL, EUR, USD, etc.)

Características Principais

Recurso Descrição
Multi-Conta Gerencie contas correntes, poupança, cartões de crédito, investimentos
Categorização Automática Sistema de palavras-chave para categorização inteligente
Importação Flexível Suporte a CSV, XLSX, XLS, OFX e até PDF
Passivos Controle financiamentos com parcelas e conciliação
Recorrências Automatize contas fixas mensais
Detecção Inteligente Identifica transferências entre contas automaticamente

2. Primeiros Passos

2.1 Cadastro e Login

  1. Acesse o sistema através do navegador
  2. Clique em "Criar Conta" se for seu primeiro acesso
  3. Preencha:
    • Nome completo
    • E-mail
    • Senha (mínimo 8 caracteres)
  4. Clique em "Registrar"
  5. Faça login com seu e-mail e senha

2.2 Configuração Inicial Recomendada

Após o primeiro login, recomendamos seguir esta ordem:

  1. Criar Contas - Cadastre suas contas bancárias
  2. Criar Categorias - Configure categorias de receitas e despesas
  3. Criar Centros de Custo - Organize por projetos ou departamentos (opcional)
  4. Importar Extratos - Importe seu histórico bancário
  5. Categorizar Transações - Use a categorização em lote

2.3 Navegação Principal

O menu lateral oferece acesso rápido a:

Ícone Seção Função
📊 Dashboard Visão geral financeira
💳 Contas Gerenciar contas bancárias
💰 Transações Lista de movimentações
🏷️ Categorias Organização por tipo
🏢 Centros de Custo Organização por projeto
📥 Importar Importar extratos
📋 Passivos Financiamentos e dívidas
🔄 Recorrentes Contas fixas
↔️ Transferências Detecção automática
🔁 Reembolsos Detecção de estornos

3. Dashboard

O Dashboard é a tela inicial que apresenta uma visão consolidada das suas finanças.

3.1 Cards de Resumo

No topo da tela você encontra:

  • Saldo Total - Soma dos saldos de todas as contas ativas
  • Receitas do Mês - Total de créditos no mês atual
  • Despesas do Mês - Total de débitos no mês atual
  • Balanço do Mês - Diferença entre receitas e despesas

3.2 Gráfico de Fluxo de Caixa

Mostra a evolução de receitas x despesas ao longo dos meses.

Configurações disponíveis:

  • Período: 3, 6, 12 ou 24 meses
  • Filtro por conta específica

3.3 Análise de Variações de Pagamento

Identifica contas que apresentaram variação significativa em relação ao valor esperado (recorrente).

Exemplo: Se sua conta de luz costuma ser R$ 200 e veio R$ 350, o sistema alerta a variação de +75%.

3.4 Calendário Financeiro

Visualize transações planejadas e realizadas em formato de calendário.

  • Azul: Transações pendentes
  • Verde: Transações concluídas
  • Vermelho: Transações vencidas

3.5 Transações Próximas e Vencidas

Widgets que mostram:

  • Próximas: Transações com vencimento nos próximos 7 dias
  • Vencidas: Transações pendentes com data passada

4. Contas Financeiras

4.1 Tipos de Conta Suportados

Tipo Ícone Descrição
Conta Corrente 🏦 Conta bancária principal
Conta Poupança 💰 Conta de economia
Cartão de Crédito 💳 Cartão com limite
Carteira Digital 📱 PayPal, PicPay, etc.
Investimentos 📈 Aplicações financeiras
Dinheiro 💵 Dinheiro em espécie
Outros 📋 Demais tipos

4.2 Criar Nova Conta

  1. Acesse Contas no menu lateral

  2. Clique em "+ Nova Conta"

  3. Preencha os campos:

    • Nome: Nome identificador (ex: "Nubank", "Itaú Corrente")
    • Tipo: Selecione o tipo de conta
    • Banco: Nome da instituição (opcional)
    • Número da Conta: Para referência (opcional)
    • Saldo Inicial: Saldo atual da conta
    • Limite de Crédito: Para cartões de crédito
    • Moeda: BRL, EUR, USD, etc.
    • Cor: Cor para identificação visual
    • Ícone: Ícone personalizado
    • Incluir no Total: Se deve somar no saldo geral
    • Ativo: Se a conta está ativa

  4. Clique em "Salvar"

4.3 Ajustar Saldo

Se o saldo calculado não corresponde ao saldo real:

  1. Clique no botão "⚙️" da conta
  2. Selecione "Ajustar Saldo"
  3. Informe o saldo real atual
  4. O sistema criará uma transação de ajuste

4.4 Recalcular Saldos

O sistema recalcula automaticamente os saldos, mas você pode forçar o recálculo:

  1. Clique em "Recalcular Todos os Saldos" no topo da página

5. Transações

5.1 Visualização por Semana

As transações são agrupadas por semana para facilitar a análise.

Cada semana mostra:

  • Data inicial e final
  • Total de receitas (créditos)
  • Total de despesas (débitos)
  • Saldo da semana

5.2 Filtros Disponíveis

Filtro Descrição
Conta Filtrar por conta específica
Categoria Filtrar por categoria
Centro de Custo Filtrar por centro de custo
Tipo Débito, Crédito ou Todos
Status Pendente, Concluído, Cancelado
Busca Pesquisar por descrição
Período Data inicial e final

5.3 Criar Nova Transação

  1. Clique no botão "+ Nova Transação"

  2. Preencha:

    • Conta: Selecione a conta
    • Tipo: Débito (saída) ou Crédito (entrada)
    • Descrição: Descrição da transação
    • Categoria: Categoria da transação
    • Centro de Custo: Centro de custo (opcional)
    • Valor Planejado: Valor esperado
    • Data Planejada: Data prevista
    • Status: Pendente ou Concluído

  3. Clique em "Salvar"

5.4 Editar Transação

  1. Clique no ícone "✏️" na linha da transação
  2. Modifique os campos desejados
  3. Clique em "Salvar"

5.5 Completar Transação (Marcar como Pago)

Para transações pendentes:

  1. Clique no ícone "✓" (check) na transação
  2. No modal de completar:
    • Valor Real: Confirme ou altere o valor pago
    • Data Efetiva: Data do pagamento
  3. Clique em "Completar"

5.6 Completar Rapidamente (Quick Complete)

Para completar com os valores planejados:

  • Clique no ícone de raio ⚡ na transação
  • A transação será marcada como concluída com a data e valor planejados

5.7 Cancelar Transação

  1. Clique no menu "⋮" da transação
  2. Selecione "Cancelar"
  3. Confirme a operação

5.8 Reverter Transação

Para voltar uma transação concluída ao status pendente:

  1. Clique no menu "⋮" da transação
  2. Selecione "Reverter"

5.9 Duplicar Transação

  1. Clique no menu "⋮" da transação
  2. Selecione "Duplicar"
  3. Uma cópia será criada para edição

5.10 Dividir Transação (Split)

Divida uma transação em múltiplas categorias:

  1. Clique no menu "⋮" da transação
  2. Selecione "Dividir"
  3. No modal:
    • Adicione as divisões com categoria e valor
    • O total das divisões deve ser igual ao valor original
  4. Clique em "Dividir"

5.11 Criar Transferência

Para registrar transferência entre contas:

  1. Clique em "+ Transferência"
  2. Preencha:
    • Conta de Origem: De onde sai o dinheiro
    • Conta de Destino: Para onde vai
    • Valor: Valor transferido
    • Data: Data da transferência
    • Descrição: Descrição (opcional)
  3. Clique em "Transferir"

Nota: O sistema cria duas transações vinculadas: um débito na origem e um crédito no destino.

5.12 Categorização em Lote

Para categorizar múltiplas transações de uma vez:

  1. Use o filtro de busca para encontrar transações similares
    • Exemplo: Busque "UBER" para ver todas as corridas
  2. Clique em "Categorizar em Lote"
  3. No modal:
    • Selecione a Categoria a aplicar
    • Selecione o Centro de Custo (opcional)
    • Marque "Adicionar como palavra-chave" para categorização automática futura
  4. Clique em "Aplicar"

5.13 Converter em Transferência

Se você tem duas transações que são uma transferência:

  1. Na transação de débito, clique no menu "⋮"
  2. Selecione "Converter em Transferência"
  3. O sistema buscará transações de crédito compatíveis
  4. Selecione o par correspondente
  5. Confirme a vinculação

5.14 Conciliar com Passivo

Para vincular uma transação a uma parcela de financiamento:

  1. Clique no menu "⋮" da transação
  2. Selecione "Conciliar com Passivo"
  3. Selecione a parcela correspondente
  4. Confirme

6. Categorias

6.1 Estrutura Hierárquica

As categorias suportam subcategorias para organização detalhada:

📁 Alimentação
   ├── 🍔 Restaurantes
   ├── 🛒 Supermercado
   └── ☕ Cafeterias

📁 Transporte
   ├── 🚗 Combustível
   ├── 🚌 Transporte Público
   └── 🚕 Táxi/Uber

6.2 Tipos de Categoria

Tipo Cor Uso
Despesa Vermelho Gastos e saídas
Receita Verde Entradas e ganhos
Ambos Azul Pode ser usado em ambos

6.3 Criar Categoria

  1. Acesse Categorias no menu

  2. Clique em "+ Nova Categoria"

  3. Preencha:

    • Nome: Nome da categoria
    • Tipo: Despesa, Receita ou Ambos
    • Categoria Pai: Para criar subcategoria (opcional)
    • Cor: Cor de identificação
    • Ícone: Ícone visual
    • Palavras-chave: Para categorização automática

  4. Clique em "Salvar"

6.4 Criar Subcategoria

  1. Na linha da categoria pai, clique em "+"
  2. Preencha os dados da subcategoria
  3. Salve

6.5 Sistema de Palavras-Chave

As palavras-chave permitem categorização automática de transações importadas.

Como funciona:

  • Ao importar um extrato com "UBER TRIP", se a categoria "Transporte" tem a palavra-chave "UBER", a transação será categorizada automaticamente.

Adicionar palavra-chave:

  1. Edite a categoria
  2. No campo "Nova palavra-chave", digite a palavra
  3. Pressione Enter ou clique em "+"
  4. Salve a categoria

6.6 Categorização Automática em Lote

Para aplicar palavras-chave existentes a transações não categorizadas:

  1. Na página de Categorias, clique em "Categorizar em Lote"
  2. Visualize o preview das transações que serão categorizadas
  3. Clique em "Executar"

6.7 Reordenar Categorias

As categorias podem ser reordenadas por drag-and-drop para personalizar a lista.

7. Centros de Custo

7.1 O que são Centros de Custo?

Centros de custo permitem organizar transações por projeto, departamento ou cliente, independente da categoria.

Exemplos de uso:

  • Projetos: "Website Cliente X", "Reforma Casa"
  • Departamentos: "Marketing", "TI", "RH"
  • Clientes: "Empresa ABC", "Cliente João"

7.2 Criar Centro de Custo

  1. Acesse Centros de Custo no menu

  2. Clique em "+ Novo Centro de Custo"

  3. Preencha:

    • Nome: Nome identificador
    • Código: Código interno (opcional)
    • Descrição: Detalhes adicionais
    • Cor: Cor de identificação
    • Ícone: Ícone visual
    • Palavras-chave: Para associação automática

  4. Salve

7.3 Palavras-Chave em Centros de Custo

Similar às categorias, você pode usar palavras-chave para associar transações automaticamente a centros de custo.

8. Importação de Extratos

8.1 Formatos Suportados

Formato Extensão Descrição
CSV .csv Arquivo separado por vírgula
Excel .xlsx, .xls Planilha Microsoft Excel
OFX .ofx Open Financial Exchange
PDF .pdf Extrato em PDF (com OCR)

8.2 Processo de Importação

O processo é dividido em 4 etapas:

Etapa 1: Upload do Arquivo

  1. Acesse Importar no menu
  2. Arraste o arquivo ou clique para selecionar
  3. Aguarde o processamento

Etapa 2: Configuração

Configure como o arquivo deve ser lido:

  • Linha do Cabeçalho: Qual linha contém os nomes das colunas
  • Linha de Início dos Dados: Onde começam os dados
  • Formato de Data: dd/mm/yyyy, mm/dd/yyyy, etc.
  • Separador Decimal: Vírgula (,) ou ponto (.)
  • Separador de Milhar: Ponto (.) ou vírgula (,)

Etapa 3: Mapeamento de Colunas

Associe as colunas do arquivo aos campos do sistema:

Campo Descrição Obrigatório
Data Data da transação ✅ Sim
Descrição Descrição/histórico ✅ Sim
Valor Valor (pode ser com sinal) ✅ Sim
Valor de Entrada Valor de crédito separado Não
Valor de Saída Valor de débito separado Não
Referência Número do documento Não

Etapa 4: Opções e Importação

  • Conta de Destino: Selecione a conta para importar
  • Categoria Padrão: Categoria para transações não categorizadas
  • Centro de Custo: Centro de custo padrão (opcional)
  • Salvar Mapeamento: Para reutilizar em importações futuras
  • Nome do Mapeamento: Nome para identificar o preset

Clique em "Importar".

8.3 Resultado da Importação

Após a importação, você verá:

  • ✅ Importadas: Transações novas criadas
  • ⚠️ Duplicadas: Transações ignoradas por já existirem
  • ❌ Erros: Linhas com problemas

8.4 Mapeamentos Salvos

Você pode salvar configurações de importação para reutilizar:

  1. Na lista de mapeamentos, selecione um existente
  2. O sistema preenche automaticamente as configurações
  3. Modifique se necessário e importe

8.5 Presets de Banco

O sistema inclui presets para bancos comuns:

  • Nubank
  • Itaú
  • Bradesco
  • Banco do Brasil
  • Santander
  • Caixa Econômica

9. Passivos e Financiamentos

9.1 O que são Passivos?

Passivos são compromissos financeiros com parcelas, como:

  • Financiamento de veículo
  • Financiamento imobiliário
  • Empréstimos pessoais
  • Consórcios

9.2 Importar Passivo de PDF

  1. Acesse Passivos no menu

  2. Clique em "+ Importar Contrato"

  3. Selecione o arquivo PDF do contrato/simulação

  4. Preencha:

    • Nome: Nome do financiamento
    • Credor: Nome da instituição
    • Número do Contrato: Para referência
    • Moeda: Moeda do contrato
    • Descrição: Notas adicionais

  5. Clique em "Importar"

O sistema usa OCR para extrair as parcelas automaticamente do PDF.

9.3 Visualizar Detalhes do Passivo

Ao clicar em um passivo, você vê:

  • Resumo: Valor total, pago, pendente
  • Progresso: Barra visual do pagamento
  • Lista de Parcelas: Todas as parcelas com status

9.4 Status das Parcelas

Status Cor Descrição
Pendente Amarelo Aguardando pagamento
Pago Verde Parcela quitada
Vencida Vermelho Parcela não paga e vencida
Parcial Laranja Parcialmente paga

9.5 Conciliar Parcela com Transação

Para vincular um pagamento a uma parcela:

  1. Na lista de parcelas, clique em "Conciliar"
  2. O sistema busca transações compatíveis (mesmo valor/período)
  3. Selecione a transação correspondente
  4. Confirme

9.6 Marcar Parcela como Paga

Se você pagou mas não tem a transação registrada:

  1. Na parcela, clique em "Marcar como Pago"
  2. Uma transação será criada automaticamente

9.7 Análise de Preços

O sistema analisa as parcelas e identifica:

  • Valor principal
  • Juros
  • Seguros
  • Taxas

10. Transações Recorrentes

10.1 O que são Recorrências?

Recorrências automatizam o lançamento de transações que se repetem, como:

  • Aluguel mensal
  • Salário
  • Netflix/Spotify
  • Conta de luz/água

10.2 Criar Recorrência

Método 1: Do Zero

  1. Acesse Recorrentes no menu

  2. Clique em "+ Nova Recorrência"

  3. Preencha:

    • Descrição: Nome da transação
    • Conta: Conta associada
    • Categoria: Categoria da transação
    • Tipo: Débito ou Crédito
    • Valor: Valor da transação
    • Frequência: Mensal, Semanal, etc.
    • Data de Início: Quando começa
    • Data de Término: Quando termina (opcional)

  4. Salve

Método 2: A partir de Transação

  1. Na página de Transações, clique no menu "⋮"
  2. Selecione "Criar Recorrência"
  3. Configure a frequência e datas
  4. Salve

10.3 Frequências Disponíveis

Frequência Descrição
Diária Todo dia
Semanal Toda semana
Quinzenal A cada 15 dias
Mensal Todo mês
Bimestral A cada 2 meses
Trimestral A cada 3 meses
Semestral A cada 6 meses
Anual Uma vez por ano

10.4 Gerenciar Instâncias

Cada recorrência gera instâncias - as transações individuais.

Ações em instâncias:

  • Pagar: Marcar como pago (cria transação)
  • Conciliar: Vincular a transação existente
  • Pular: Ignorar esta instância
  • Cancelar: Cancelar esta instância
  • Editar: Modificar valor ou data desta instância

10.5 Pausar/Retomar Recorrência

Para pausar temporariamente:

  1. No template, clique em "Pausar"
  2. Nenhuma nova instância será gerada
  3. Para retomar, clique em "Retomar"

10.6 Conciliar com Transação Existente

Se você já tem a transação registrada:

  1. Na instância pendente, clique em "Conciliar"
  2. O sistema sugere transações compatíveis
  3. Selecione a correspondente
  4. Confirme

11. Detecção de Transferências

11.1 Como Funciona

O sistema analisa suas transações e identifica automaticamente pares de transferência: um débito em uma conta e um crédito correspondente em outra.

Critérios de detecção:

  • Mesmo valor (ou similar)
  • Datas próximas (tolerância configurável)
  • Contas diferentes

11.2 Níveis de Confiança

Nível Cor Significado
Alta Verde Valores e datas muito próximos
Média Amarelo Valores iguais, datas diferentes
Baixa Cinza Valores similares

11.3 Ações Disponíveis

Para cada par detectado:

  • Confirmar: Vincula as transações como transferência
  • Ignorar: Marca para não sugerir novamente
  • Excluir Ambas: Remove as duas transações

11.4 Confirmação em Lote

  1. Marque os pares desejados com o checkbox
  2. Clique em "Confirmar Selecionados"
  3. Confirme a operação

11.5 Configurar Tolerância

Ajuste a tolerância de dias para detecção:

  • Use o seletor no topo da página
  • Valores maiores encontram mais pares
  • Valores menores são mais precisos

12. Detecção de Reembolsos

12.1 O que são Reembolsos?

Reembolsos são transações onde você foi estornado por uma compra:

  • Devolução de produto
  • Cancelamento de assinatura
  • Estorno de cobrança indevida

12.2 Como Funciona

O sistema detecta pares onde:

  • Existe um débito (compra)
  • Existe um crédito (reembolso) na mesma conta
  • Valores iguais ou similares
  • Datas próximas

12.3 Confirmar Reembolso

  1. Na lista de reembolsos detectados
  2. Clique em "Confirmar"
  3. As transações são vinculadas
  4. O sistema marca o status como reembolsado

12.4 Desfazer Reembolso

Se confirmou por engano:

  1. Na transação vinculada
  2. Use a opção "Desfazer Reembolso"

13. Configurações

13.1 Idioma

O sistema suporta três idiomas:

  • 🇧🇷 Português (Brasil)
  • 🇪🇸 Español
  • 🇺🇸 English

Para alterar:

  1. Clique no seletor de idioma no topo
  2. Selecione o idioma desejado

13.2 Moeda Padrão

Cada conta pode ter sua própria moeda:

  • BRL - Real Brasileiro
  • EUR - Euro
  • USD - Dólar Americano
  • GBP - Libra Esterlina

13.3 Formato de Data

O sistema ajusta automaticamente o formato de data conforme o idioma:

  • PT-BR: dd/mm/aaaa
  • ES: dd/mm/aaaa
  • EN: mm/dd/yyyy

13.4 Perfil do Usuário

Acesse seu perfil para:

  • Alterar nome
  • Alterar e-mail
  • Alterar senha
  • Ver tipo de conta (Admin/Usuário)

📞 Suporte

Para dúvidas ou problemas:

📝 Notas de Versão

Versão 1.0 (Dezembro 2025)

  • Lançamento inicial
  • Multi-conta e multi-moeda
  • Importação de extratos
  • Categorização automática
  • Passivos e recorrências
  • Detecção de transferências e reembolsos
  • Multi-idioma (PT-BR, ES, EN)

WebMoney - Sua gestão financeira simplificada