&Michael.T.Edwardes; &Michael.T.Edwardes.mail;
&Jack.H.Ostroff; &Jack.H.Ostroff.mail;
01/12/2024
5.2.0

# Usando o &kmymoney; pela primeira vez

## Executando o &kmymoney; pela primeira vez

As capturas de tela podem ser diferentes

Ao executar o &kmymoney;, ele pode não ser exatamente igual às capturas de tela neste manual. Muitos detalhes, como fontes, cores e ícones, podem ser personalizados usando o item de menu Configurações Configurar &kmymoney;... ou o aplicativo &systemsettings; do &kde;, dependendo do seu sistema operacional ou distribuição.

### A janela principal

A janela principal
A janela principal

A janela principal do &kmymoney; é composta de quatro partes importantes

- A. Barra de menus

- B. Barra de ferramentas

- C. Seletor de áreas

- D. Área selecionada

O menu e a barra de ferramentas fornecem acesso aos recursos do &kmymoney; e permitem que você Crie um novo arquivo de dados, abra um arquivo de dados existente ou configure o funcionamento do &kmymoney;. A barra de ferramentas pode ser configurada para exibir ícones das operações que você usa com mais frequência.

No lado esquerdo da janela principal, o seletor de visualização consiste em pelo menos onze ícones com rótulos opcionais, dependendo do software fornecido pelo seu sistema, já que alguns recursos podem ser incluídos ou excluídos quando o programa é compilado. Mais ícones podem ser adicionados por meio de vários plugins. Ao clicar em um dos ícones, a janela de visualização à direita é carregada com a visualização apropriada dos seus dados financeiros. Cada visualização fornece uma representação única da sua situação financeira e permite que você visualize ou edite as informações exibidas.

O seletor de visualização pode conter os seguintes ícones:

- Vista inicial
  Início: Uma visão geral configurável sobre a sua situação financeira atual (ou uma página introdutória, quando não existirem dados).

- Vista de Instituições
  Instituições: suas instituições e contas, apresentadas de forma hierárquica.

- Vista de Contas
  Contas: suas contas, apresentadas de forma hierárquica.

- Vista de agendamentos
  Transações agendadas: seus pagamentos recorrentes, rendimentos e transferências.

- Vista de Categorias
  Categorias: contas especiais que oferecem a possibilidade de agrupar as transações associadas.

- Vista de etiquetas
  Etiquetas: contas especiais que oferecem uma forma adicional de agrupar as transações associadas, similar às Categorias.

- Vista de Beneficiários
  Beneficiários: seus beneficiários - as pessoas e organizações para as quais você paga ou das quais recebe dinheiro.

- Vista do Livro de registro
  Livro de registros: suas transações em cada conta.

- Vista de Investimentos
  Investimentos: o resumo do seu portfólio.

- Vista de Relatórios
  Relatórios: uma coleção de várias visualizações personalizáveis ​​dos seus dados financeiros.

- Vista de Orçamentos
  Orçamentos: seus orçamentos

- Vista de Previsão
  Previsão: projeção dos saldos de suas contas e categorias.

- Vista da Saída
  Vista da Saída: uma tela fornecida pelo plugin KBanking para fornecer feedback sobre processos em execução.

Lembre-se de que algumas destas vistas podem não estar presentes no seu sistema; isso depende de como a sua cópia do &kmymoney; foi configurada e compilada.

## Criando um novo arquivo

O &kmymoney; armazena todos os dados sobre suas finanças em um arquivo. Como foi definido em Definir as contas (registros pessoais), você poderá manter mais de um conjunto de contas, mas os dados de cada uma serão armazenados em um arquivo separado, sendo que o &kmymoney; só pode ter um arquivo aberto de cada vez. Veja o capítulo sobre Formatos de Arquivos para obter mais detalhes sobre os arquivos de dados do &kmymoney;.

Além do arquivo de dados com todas as informações financeiras desse conjunto de contas, o &kmymoney; utiliza arquivos adicionais para armazenar dados referentes às configurações e preferências de exibição. A localização exata desses arquivos depende do seu sistema operacional ou distribuição.

Para criar um novo arquivo, você pode selecionar o item de menu Arquivo Novo ou escolher o ícone novo na barra de ferramentas. Além disso, se a página inicial de boas-vindas estiver sendo exibida, você também pode selecionar o primeiro link: Comece e configure sua conta.

O &kmymoney; irá então abrir o Assistente de Configuração dos Novos Arquivos, que o guiará pelo processo de criação do arquivo.

Página de Dados Pessoais
Página de Dados Pessoais

Qualquer informação inserida nesta página de Dados Pessoais é usada apenas para personalizar seu cadastro. Todos esses campos são opcionais, então você pode usar o &kmymoney; sem inserir nenhuma informação agora. No futuro, essas informações poderão ser usadas em alguns relatórios e para serviços bancários online. Se o &kmymoney; precisar de alguma informação pessoal em versões futuras e não encontrar nenhuma, você será solicitado a inserir os dados relevantes posteriormente.

No caso de ter um endereço próprio registrado no &kaddressbook;, o botão Carregar do livro de endereços ficará ativo e, caso clique nele, todas as informações serão importadas para o &kmymoney;.

Após concluir a inserção dos dados, pressione Próximo.

Se precisar alterar alguma dessas informações no futuro, você poderá acessar este formulário com o item de menu Arquivo Dados pessoais....

O &kmymoney; tem suporte a várias moedas. Para definir a sua moeda base (a que você usa no dia a dia e que será usada nos seus relatórios), selecione o item apropriado na lista oferecida e clique em Próximo. Uma moeda padrão será selecionada com base nas suas configurações de localidade, mas você pode facilmente escolher uma moeda diferente, se for apropriado para a sua situação.

Página de seleção da moeda base
Página de seleção da moeda base

Neste exemplo, o dólar americano foi selecionado como moeda base.

Após clicar em Próximo, a página seguinte permite que você crie uma conta inicial. Para o usuário típico do &kmymoney;, esta é uma conta corrente.

Página de criação de uma conta corrente
Página de criação de uma conta corrente

Insira o nome da conta e um possível número de conta ou de referência atribuído pela instituição que administra a conta. O nome é arbitrário e é simplesmente como a conta será referenciada e exibida pelo &kmymoney;. Insira a data de abertura e o saldo inicial da conta. Por exemplo, se você deseja usar o &kmymoney; para gerenciar todas as suas finanças a partir de 01/01/2008, insira o saldo da conta no início dessa data. O número pode ser obtido em um extrato impresso. Você também pode inserir o nome e o código bancário da instituição. Este último, conhecido como número de roteamento nos EUA ou código de classificação no Reino Unido, é opcional e apenas necessário para fins de internet banking, mas também pode ser útil ao importar extratos bancários em alguns dos formatos suportados (OFX, QFX).

Caso não queira criar uma conta inicial ou não tenha uma conta corrente, basta desmarcar a caixa de seleção.

Assim que terminar, clique em Próximo para prosseguir.

Página de seleção do modelo de contas
Página de seleção do modelo de contas

Escolha o país e o(s) modelo(s) de conta apropriados. Cada modelo fornece um conjunto diferente de categorias para organizar suas finanças. Vários modelos, mesmo de países diferentes, podem ser selecionados usando uma combinação de &Ctrl; e &Shift; com o &LMB;. A hierarquia de contas a ser configurada será exibida em uma pré-visualização do assistente. Caso você não encontre um modelo que atenda às suas necessidades, não selecione um modelo neste momento e você poderá configurar as categorias manualmente mais tarde.

Assim que terminar a seleção do modelo, clique em Próximo para prosseguir.

Esta é a página final do assistente. Se você selecionar a caixa de seleção Configurar preferências após concluir o assistente, a caixa de diálogo de configurações do aplicativo será exibida após você concluir o assistente de configuração da conta.

Página de seleção do nome do arquivo
Página de seleção do nome do arquivo

Neste ponto, clicar em Concluir iniciará a caixa de diálogo Salvar armazenamento como..., onde você escolherá o tipo de armazenamento (XML, possivelmente com criptografia ou SQL) e especificará os detalhes desse método de armazenamento, como nome e localização do arquivo ou detalhes do banco de dados SQL. Consulte os capítulos Formatos de arquivo e Formatos de arquivo para obter mais informações sobre cada tipo de armazenamento.

## Criando contas

Existem várias maneiras de criar uma conta:

Usando o menu

  Para criar uma conta com o menu, selecione o item de menu Contas Nova conta.

Usando a vista de Contas

  Para criar uma conta usando a vista de Contas, clique no ícone de contas no seletor de visualização para exibir a vista de Contas. Clique com o botão direito do mouse no ícone da árvore de ativos ou no ícone da árvore de passivos na tela e selecione Nova conta no menu de contexto. A árvore de ativos contém todas as suas contas que são ativos, como poupança e investimentos. A árvore de passivos contém todas as suas contas que representam dinheiro que você deve, como empréstimos e cartões de crédito. Esses e todos os outros tipos de conta são discutidos com mais detalhes no Capítulo Contas.

Usando a barra de ferramentas

  Se o botão Nova Conta... for exibido na barra de ferramentas, você poderá clicar nele para criar uma conta.

Repare que o &kmymoney; usa os menus de contexto de um modo geral em todo o aplicativo. Se não souber como fazer algo, tente clicar com o &RMB; onde você espera encontrar um determinada funcionalidade.

Criar uma nova conta por qualquer um dos métodos acima abre o Assistente de Nova Conta. Este assistente irá guiá-lo passo a passo pelo processo de criação de uma conta, coletando as informações necessárias em cada etapa. Para navegar pelas páginas, clique em Avançar e Voltar. Uma descrição completa da criação de contas pode ser encontrada na seção Contas.

Agora que uma ou mais contas já existem no &kmymoney;, o seu resumo de contas aparece na área inicial. Você poderá criar transações manualmente na vista do Livro de registro ou configurar as transações automáticas com a vista de Agendamento.

## Transações agendadas

Uma transação agendada, às vezes chamada de agendamento ou transação recorrente, é uma transação que ocorre uma ou mais vezes em um intervalo especificado durante um determinado período de tempo. Um exemplo típico é o seu salário que você recebe toda semana ou mês, ou uma conta de serviços públicos que você paga todo mês. Em vez de ter que inserir os detalhes da transação cada vez que você recebe o pagamento, você pode instruir o &kmymoney; a criar um agendamento que inserirá uma transação para você quando você receber o pagamento.

Para manter seus agendamentos, clique no ícone de transação agendada no seletor de visualização.

## Categorias

Para gerenciar suas categorias, clique no ícone Categorias no seletor de visualização.

Você pode encontrar uma descrição completa sobre este tópico na seção Categorias.

## Etiquetas

Para manter suas tags, clique no ícone Etiquetas no seletor de visualização.

Uma descrição mais detalhada deste tópico pode ser encontrada na seção Etiquetas.

## Beneficiários

Para gerenciar seus beneficiários, clique no ícone Beneficiários no seletor de visualização.

Você pode encontrar uma descrição mais detalhada sobre este tópico na seção Beneficiários.

## Importar dados financeiros de outros aplicativos

Se você usa atualmente outro aplicativo de gerenciamento financeiro, é muito provável que o &kmymoney; possa importar grande parte ou todos os dados desse programa, desde que eles possam ser exportados ou salvos em um formato que o &kmymoney; entenda. O mais comum desses formatos é o Quicken Interchange Format (QIF). A maioria dos programas financeiros pode exportar nesse formato, embora os diferentes métodos de exportação de QIF de cada aplicativo não sejam discutidos aqui por uma questão de brevidade.

Uma descrição completa da importação de dados neste formato pode ser encontrada na seção Importação QIF.

Além de importar arquivos no formato QIF, o &kmymoney; pode abrir diretamente arquivos de dados usados ​​pelo arquivo &gnucash;.

## Procurando por transações

O &kmymoney; oferece uma funcionalidade útil e poderosa para pesquisa de transações, sob a forma de uma janela de pesquisa.

A caixa de diálogo de pesquisa pode ser aberta na barra de ferramentas usando o ícone de pesquisa ou selecionando o item de menu Editar Localizar transação.

Você pode encontrar uma descrição completa sobre este tópico na seção Procurar.

## Reconciliação

Em algum momento, você desejará conciliar seus registros e detalhes de uma conta com a conta real para garantir que correspondam. Isso geralmente é feito comparando a conta no &kmymoney; com um extrato impresso ou eletrônico emitido pela instituição, como banco, cartão de crédito, empréstimo ou qualquer outro extrato. A reconciliação envolve comparar o que você inseriu, especificamente as transações desde a reconciliação anterior, com o que consta no extrato. Se forem encontradas discrepâncias, significa que você ou a pessoa que criou o extrato cometeu um erro.

Para reconciliar uma conta, primeiro selecione a conta, seja na visualização Contas ou na vista do Livro de registro. Em seguida, clique no ícone Reconciliar na barra de ferramentas, se estiver visível, ou selecione o item de menu Conta Reconciliar.

Você pode encontrar uma descrição mais detalhada sobre este tópico na seção Reconciliação.

## Fazendo cópias de segurança

Agora que você criou algumas contas e inseriu transações, é uma boa ideia fazer um backup. Como o arquivo usado pelo &kmymoney; é um arquivo padrão do &Linux; (ou &macOS; ou &Windows;, dependendo do seu sistema operacional), você pode simplesmente copiar o arquivo para outro local para fazer o backup ou usar a caixa de diálogo fornecida pelo &kmymoney;. Usar a caixa de diálogo é o método preferido, pois se o &kmymoney; começar a usar outros formatos de arquivo, como SQL, será muito mais difícil copiar o arquivo manualmente.

Para fazer backup do seu arquivo através do &kmymoney;, selecione Arquivo Backup e insira a pasta onde deseja salvar o arquivo. Se a pasta precisar ser montada e você tiver as permissões necessárias, marque a caixa de seleção com o rótulo Montar esta pasta antes de fazer o backup e clique em OK.

O arquivo será salvo na pasta indicada, com a data atual adicionada ao nome do arquivo, para que seja fácil de ver a data em que a cópia de segurança foi criada.

Para obter mais detalhes sobre o formato real do arquivo de dados e o processo de backup, consulte Formatos de arquivo.

## Iniciando o &kmymoney;

Normalmente, você lançará o &kmymoney; a partir de um ícone ou de menu do seu gerenciador de janelas ou ambiente de desktop. Nesse caso, o comportamento padrão é que o &kmymoney; usará o último arquivo que você abriu. No entanto, em algumas situações, você desejará ou precisará iniciar o &kmymoney; a partir da linha de comando.

Para uma descrição completa de todas as opções da linha de comando, veja a página do 'man' para o &kmymoney;. Contudo, existem dois casos especiais que serão aqui descritos.

`kmymoney -n`

A opção '-n' diz ao &kmymoney; para não abrir o último arquivo aberto anteriormente. Isto pode ser útil se, por algum problema, não conseguir iniciar o programa.

`kmymoney <caminho do arquivo>`

Fornecer ao &kmymoney; um nome de arquivo na linha de comando faz com que este arquivo seja aberto ao invés do anterior. Você pode usar o nome de qualquer arquivo válido do &kmymoney;, como descrito no capítulo sobre formatos de arquivo. Além disso, ele pode ser usado para importar um arquivo do &gnucash;.

## Como mover o &kmymoney; para um novo computador

### Movendo seus dados

É muito fácil mover seus dados para um novo computador. De fato, tudo o que você precisará fazer é copiar seu arquivo de dados do &kmymoney;. O nome do arquivo aparece na barra de título quando o &kmymoney; está em execução e termina normalmente com a extensão `.kmy`. Da primeira vez que executar o aplicativo no novo computador, você precisa indicar onde colocou o arquivo de dados, seja através da linha de comando ou a partir da opção do menu Arquivo Abrir.... Você deve conseguir mudar entre sistemas &Windows;, &MacOS; e &Linux;.

Se você criptografou seu arquivo de dados, verifique se o aplicativo e as chaves apropriados também foram configurados no novo computador.

Se os seus dados estiverem em um banco de dados SQL, consulte a documentação do software do seu banco de dados para saber como fazer a migração.

Lembre-se de que parte-se do pressuposto de que você instalou no novo computador a mesma versão do &kmymoney; usada no antigo. A instalação de uma versão mais recente também deverá ser segura, mas você precisa ficar atento a quaisquer questões relacionadas com essa atualização. Todas essas questões devem ser referenciadas nas notas de lançamento da nova versão.

### Movendo suas configurações

Se você mover apenas o arquivo de dados para a nova máquina, conforme descrito na seção anterior, o &kmymoney; funcionará corretamente, mas você perderá todas as configurações que alterou em relação ao padrão da sua máquina antiga. Para manter essas configurações, você também precisa copiar o arquivo de configuração. Este arquivo se chama `kmymoneyrc`. A localização deste arquivo depende do seu sistema operacional e distribuição. Em um sistema &Linux;, ele provavelmente estará em `.config` dentro da sua pasta pessoal. Se você estiver migrando de uma versão do &kmymoney; anterior à 5.0, a localização antiga era `.kde4`.

#### Movendo as configurações do plugin

Se você executou algum plugin do &kmymoney;, como a importação ou exportação de CSV, também poderá existir um arquivo de configuração na mesma pasta, como por exemplo, `csvimporterrc` ou `csvexporterrc`. Esses arquivos também deverão ser copiados para o novo computador.

Assim como no arquivo de dados principal, assume-se que a versão do plugin em ambos os computadores seja a mesma. As atualizações normalmente são seguras, mas se a funcionalidade do plugin foi consideravelmente alterada, aconselhamos testar com cuidado o arquivo de configuração antigo, para ter certeza de que o plugin se comporta como esperado. Claro, isso se aplica mesmo ao atualizar a versão do &kmymoney; em um único PC.

Observe que, ao atualizar de uma versão anterior para a versão 5.0 ou superior, o local dos arquivos de modelo usados ​​pelo plugin para impressão de cheques foi alterado. Consulte as notas de lançamento ou o site do projeto para obter mais detalhes.

Estas instruções servem apenas para mover seus dados e configurações do &kmymoney; Contudo, poderão existir itens importantes que são armazenados pelo &kde; e não pelo &kmymoney;, como as senhas guardadas no Keychain. A replicação de outras partes da sua configuração do &kde; está fora do escopo deste manual, ainda que boa parte dos arquivos de configuração relevantes também são armazenados na pasta `$KDEHOME`.

## Obtendo ajuda / Contactando os programadores / Comunicando bugs

Como os canais de suporte mudam com o tempo, você pode consultar a página de suporte no site do &kmymoney; para obter as informações mais atualizadas sobre onde obter ajuda com a &kmymoney;.

Se você simplesmente tiver dúvidas sobre como usar o &kmymoney;, quiser confirmar seu entendimento de como o aplicativo funciona ou precisar de ajuda para descobrir a melhor maneira de lidar com uma situação financeira específica, considere usar uma das fontes de informação, fóruns, listas de discussão ou canais de bate-papo listados no link acima.

### Contactando os programadores

Para perguntas ou comentários gerais sobre o &kmymoney;, existe uma lista de discussão de usuários, &userlist;, com mais detalhes aqui. Esta lista é adequada para perguntas e discussões gerais. Há também uma lista de discussão de desenvolvedores, &devlist;, com mais detalhes aqui. Esta lista destina-se a discussões mais técnicas. Como as respostas geralmente são enviadas apenas para a lista, você pode não receber nenhuma resposta a menos que se inscreva na lista para a qual está enviando a mensagem.

Note que os desenvolvedores geralmente monitoram os vários canais de contato mencionados acima, portanto, o contato direto por e-mail raramente é necessário. No entanto, ficaremos felizes em saber sobre suas experiências usando o &kmymoney;, seja qual for o canal que você preferir.

### Relatando bugs

Para relatar um erro, use a interface fornecida pelo &kmymoney;, selecionando a opção Ajuda Relatar erro e preencha as informações necessárias. No entanto, caso tenha dificuldades com esse método, você pode relatar um erro (ou solicitar uma nova funcionalidade ou melhoria) diretamente na página de comunicação de erros do &kde;. Os relatórios devem ser preenchidos para o produto kmymoney.

De qualquer modo, antes de relatar um bug, leia as recomendações abaixo. Se segui-las, será mais provável que os desenvolvedores sejam capazes de rapidamente identificar o problema sem ter que pedir mais informações. Certifique-se também de que o que você está relatando é realmente um bug (ou uma solicitação de melhoria/funcionalidade). Se as coisas não estiverem funcionando como esperado ou se você precisar de ajuda para usar algum recurso do &kmymoney;, use um dos canais de suporte alternativos listados acima.

#### Criando Relatórios de Erros de Qualidade

Encorajamos os usuários a gastarem algum tempo extra escrevendo relatórios de erros de qualidade, quando os enviarem. Isto reduz o esforço dispendido por ambas as partes, uma vez que o usuário que relata e o programador que irá corrigir irão trocar e-mails até toda esta informação estar realmente no lugar.

Eli Goldberg escreveu as Recomendações de Escrita de Erros, disponível em https://issues.apache.org/bugwritinghelp.html. Em geral, você se beneficiará muito se seguir as orientações e conselhos dessa página. Alguns desses pontos são repetidos abaixo:

Inclua a informação do seu sistema

O menu Ajuda Relatar bug irá preencher isso automaticamente, mas se preferir não usar essa interface, será preciso incluir algumas informações no relatório. Nós precisamos saber qual sistema operacional você está usando (&Linux;, &MacOS; ou &Windows;), a versão do &kde; e a versão do &kmymoney;. Adicionalmente, você deverá informar qual a versão do &MacOS; ou &Windows;, ou o nome e versão da sua distribuição &Linux;, assim como a versão do seu kernel. Esta informação é extremamente importante, pois muitos bugs (bem como comportamentos erroneamente identificados como bugs) dependem do sistema operacional.

Incluir um registro de chamadas nas falhas

O registro de chamadas é normalmente a única e mais útil peça de informação na resolução de falhas.

Tentar reproduzi-lo

Deixe-nos saber se é capaz de fazer isso. É útil saber se o erro só ocorreu uma vez, e se não o consegue reproduzir de novo, ou se acontece sempre ou muitas vezes, mas não em outras.

Incluir passos específicos

Este é um mau relatório de erros: Eu inseri uma transação, e o &kmymoney; falhou. Um relatório de erros muito melhor é: Ao usar o formulário da transação, inseri uma nova transação na minha conta de Cartão de Crédito. Selecionei a página de Transferências, inseri um montante, depois mudei para a página do Depósito e voltei à página de Transferência. Quando retornei à página de Transferência, o &kmymoney; falhou. Este erro pode ser completamente reproduzido por mim.

Diga-nos o que esperava que acontecesse

Nos falhas isso parece óbvio, mas em alguns erros mais sutis, você poderá ver um relatório de erros onde não seja óbvio o que a pessoa que relatou o erro esperava que acontecesse. Diga-nos sempre o que acha que deveria ter acontecido, bem como o que aconteceu.

Considere executá-lo com a depuração ativa

Ao compilar uma versão com a opção '--enable-debug=full', você poderá garantir que serão gerados os melhores registros de chamadas. Se encontrar uma falha, execute o &kmymoney; de novamente dentro do 'gdb' e reproduza a falha. Quando ocorrer, digite bt para gerar um registro de chamadas.

Executar o aplicativo dessa forma é um pouco mais complicado, por isso não esperamos que todos os usuários o faça. Contudo, se você estiver interessado em ajudar o &kmymoney; a ficar o mais estável possível, esta é a melhor forma de encontrar o erro no código e enviar uma correção.