# Investimentos

## Investimentos no &kappname;

### Investimentos

Investimentos são instrumentos para aplicar dinheiro e são comercializados em um mercado. As ações, fundos de investimento e fundos mútuos são os investimentos mais comuns; como tal, são os que possuem suporte mais direto. As prospecções, mercadorias, opções de compra e derivações mais complexas são algumas vezes usadas, mas o &kappname; não tem nenhuma funcionalidade especial para elas. Desde que se comportem como uma ação ou fundo, poderão ser acompanhadas facilmente.

### Moeda Base

Cada investimento possui uma Moeda Base. Esta é a moeda em que ele é comercializado. Quando o preço de uma ação é inserido para um determinado investimento, a moeda do valor é sempre a sua moeda base. Uma ação na NYSE seria em dólares dos EUA, enquanto um investimento nos mercados australianos seria em dólares australianos.

### Contas de Investimento

As Contas de Investimento mantêm uma coleção dos investimentos. As transações, como as compras e vendas, destes investimentos estão contidas numa Conta de Investimento. Todas as transações numa conta de Investimento deverão estar relacionadas a um determinado investimento. Não existe nenhum saldo monetário separado numa conta de investimento. Para isso, você precisa de uma Conta de Corretagem.

### Contas de Corretagem

Normalmente, uma conta de investimento possui uma conta de corretagem associada. Esta é também normalmente referida como uma Conta em Dinheiro. As contas de investimento não poderão conter transações de dinheiro, como uma transferência do seu banco. Quando uma ação é vendida, os resultados são normalmente colocados na Conta de Corretagem.

Quando criar uma Conta de Investimento, você terá a opção de criar uma Conta de Corretagem associada a ela.

## Criar uma Conta de Investimento

O primeiro passo no caminho da utilização dos investimentos é criar uma conta para guardar os seus investimentos. Escolha a opção Conta Nova conta... para iniciar o processo de adição de uma nova conta. Crie uma conta como de costume, certificando-se de escolher o Investimento como tipo de conta.

Para trabalhar com a nova conta de investimento, vá para a área de Investimentos e escolha a conta que acabou de criar na lista Selecionar a Conta.

## Adicionar Investimentos à sua Conta

Para adicionar investimentos adicionais à sua conta de investimento, vá para a área Investimentos, selecione Ações Ordinárias e escolha a conta onde o investimento é mantido, na lista Selecionar conta. Área de Investimentos, aba Ações Ordinárias Área de Investimentos, aba Ações Ordinárias

Clique com o botão direito do mouse no espaço em branco da área. Isto irá invocar o menu de contexto das Opções do Investimento. Escolha a opção Novo investimento... neste menu. Isto invoca o Assistente de Novos Investimentos, que você poderá usar para criar o seu novo investimento.

### Assistente de Novos Investimentos

A primeira coisa que lhe será questionada é o tipo de investimento, se é um grupo de ações, títulos, ou fundos, etc.

Em seguida, é apresentada a página de detalhes do investimento. É inserida a seguinte informação nesta página:

- Símbolo Comercial. O símbolo usado no expositor que identifica o investimento no mercado em que é comercializado. O &kappname; necessita de um símbolo comercial para todos os investimentos; contudo, alguns investimentos não possuem símbolos. Nesse caso, você terá que criar um símbolo para eles.

- Nome completo. O nome amigável e legível do investimento que está criando, ⪚, Companhia de Seguros Ltda. Este nome também é referido como título.

- Fração. O grau de precisão com que são medidas as suas posses em carteira. Por exemplo, nos fundos mútuos dos EUA, as posses são medidas com três casas decimais, assim você iria indicar 1000 neste campo. As ações normalmente são medidas como ações inteiras; por isso, você poderia indicar 1 como uma ação para este efeito.

- Mercado de câmbio. Onde as ações são negociadas. Este é um campo opcional que é oferecido para sua conveniência. Esta informação não é usada em nenhum outro local do &kappname;.

- Identificação. Um campo opcional para inserir a informação de identificação adicional que você gostaria de manter. Mais uma vez, esta informação não é usada em nenhum outro lugar.

- Moeda de câmbio. A moeda subjacente em que este investimento é comercializado no seu mercado.

- Entrada do preço. Escolha se o preço será inserido como um preço individual ou como o total para todas as ações.

Se estiver usando cotações online, certifique-se de que o símbolo corresponde exatamente àquele usado pela sua fonte de cotações. O Yahoo cobre a maior parte dos mercados mundiais, e necessita de um sufixo no fim dos símbolos fora dos EUA. Por exemplo, a Rubicon Limited, no mercado da Nova Zelândia, deveria ser inserido como RBC.NZ.

Finalmente, será apresentada a página para atualização online. Este é o local onde é informado ao &kappname; como os preços do seu investimento devem ser atualizados. Estão definidos os seguintes itens aqui:

- Usar o Finance::Quote. Esta é uma opção para os usuários do GnuCash que estão habituados a este estilo de ações. A maioria dos usuários poderão desligar esta opção.

- Fonte online. A fonte online a ser usada para este investimento em particular. A escolha mais comum é a Yahoo. Tente essa primeiro e, se o investimento não for encontrado com essa fonte, experimente então com as outras.

- Fator. Um coeficiente multiplicativo que deverá ser aplicado às cotações obtidas para este investimento. Normalmente é usado para as ações da GB, onde o preço cotado vem em pence (1/100), e ação é apresentada em libras. Nesse caso, indique 0,01 como Fator.

## Editar um Investimento

A aba Ações Ordinárias da área de Investimentos apresenta as posses atuais nessa conta, em conjunto com o seu símbolo, valor, quantidade e preço. Clique com o botão direito do mouse em qualquer dos investimentos, de modo a apresentar o menu de contexto Opções do Investimento, onde você terá a opção de adicionar, editar ou excluir investimentos individuais dessa conta. Do mesmo modo, você poderá atualizar aqui o valor dos seus investimentos, de forma manual ou através da sua fonte online. Além disso, é possível fechar uma conta vazia ou reabrir uma conta fechada.

## Transações de Investimento

Formulário da Transação de Investimento Formulário da Transação de Investimento

O registro de investimentos é quase igual ao livro de registros dos outros tipos de contas. Contudo, os campos são diferentes, e irão variar de acordo com o tipo ou atividade da transação. As transações de investimento possuem alguns elementos adicionais:

- Atividade

- Título

- Conta

- Ações, Preço e Montante

- Encargos

- Categoria de juros

### Atividade

A Atividade de uma transação de investimento descreve a ação que está acontecendo com a carteira de ações. Há suporte para as seguintes atividades:

Comprar/Vender

- Usado para registrar compras ou vendas de investimentos individuais. Esta ação precisa de uma conta de/para onde transferir os fundos.

Dividendos/Receita

- Também conhecido como um Dividendo Monetário, esta ação é usada quando você recebe os juros ou deduções dos dividendos do seu investimento. Esta ação necessita de uma conta de/para onde transferir os fundos.

Reinvestir o Dividendo

- Reinvestir o Dividendo. Este é um dividendo onde os resultados são investidos de volta no investimento.

Adicionar/Remover Ações

- Um simples aumento ou diminuição no seu saldo. Isto deverá ser usado muito raramente, porque é muito raro as ações simplesmente aparecerem ou desaparecerem na sua conta, a menos que seja uma compra ou uma venda.

Dividir as Ações

- Usado quando o grupo de ações é dividido. Indique a relação da divisão no campo Proporção da Divisão. Por exemplo, numa divisão 3:2, indique 1,5

### Segurança

Cada transação do investimento deverá estar associada a um título individual, que é apenas outro nome para um investimento. Escolha o nome do investimento ao adicionar ou editar uma transação. O símbolo será apresentado ao visualizá-la.

### Conta

Para as transações que geram ou necessitam de dinheiro, você deve indicar a conta de/para onde o dinheiro é transferido. Se a sua conta de investimento tiver uma conta de corretagem associada, normalmente é melhor transferir para aí os fundos. Isto aplica-se aos fundos para a compra ou venda do investimento, assim como para os encargos pagos ou juros/dividendos auferidos.

### Ações, Preço e Montante

Para as transações de compra, venda e recolhimento de dividendos, o número de ações, o preço e o montante da transação deverão estar estabelecidos. Você poderá indicar dois destes valores, para que o &kappname; calcule o terceiro. Normalmente é melhor indicar apenas o montante e as ações, porque são os dados conhecidos na transação. O preço poderá ser calculado a partir destes.

### Encargos

Com muitas transações de investimentos, você poderá incluir os encargos (ou comissões) que pagou ao corretor. Se você indicar uma categoria para o encargo, então irá aparecer um campo à direita para introduzir o montante do encargo. Se você precisar inserir mais de um encargo para a transação, poderá usar a funcionalidade de Transações Divididas. Nesse caso, quando acabar de inserir todas as parcelas, o montante dos encargos será apresentado à direita.

### Juros

Essa é a forma como o pagamento de juros ou dividendos deve ser inserido a partir de um investimento. Como acontece nos encargos, se indicar uma categoria, então aparecerá um campo à direita para inserir o montante. Você poderá também usar a funcionalidade de transações divididas, caso seja necessário.

## Trabalhar com investimentos estrangeiros

Agora que o &kappname; tem suporte a várias moedas e investimentos, provavelmente você gostaria de combinar os dois. Fazer isso exige bastante cuidado. Como foi indicado acima, quando você adicionou um investimento, você teve de indicar a sua moeda de câmbio. Esta moeda poderá não ser a mesma que a sua moeda base, e poderá também não ser a mesma da conta em que guarda a carteira de ações ou a conta de/para onde transfere os fundos das compras/vendas.

Considere um caso hipotético. Sua moeda base é USD. Você possui uma conta de investimento em EUR e uma conta de corretagem também em EUR. Nessa conta, você possui ações da TietoEnator, que é vendida em SEK.

Quando inserir uma transação de compra nesse investimento, use o SEK como moeda. Por isso, se comprar 100 ações a um preço de SEK 248,00, totalizando SEK 24.800,00, indique esses valores na transação.

Aviso da moeda Aviso da moeda

Quando escolher a conta de corretagem onde colocar a transferência como fundo, você será avisado que esta é uma moeda diferente.

Editor da taxa de câmbio Editor da taxa de câmbio

Quando terminar a transação, você será avisado de uma atualização do preço da moeda da conta de investimento, neste caso SEK -> EUR. Reveja a documentação sobre como Inserir os preços manualmente para obter mais informações sobre a janela de preços.

Se retornar para a conta de corretagem verá a transação com EUR 2.254,54, assumindo uma taxa de câmbio de 11,0000 SEK / EUR.

## Atualizar os preços

Existem duas formas de atualizar os preços dos seus investimentos. Você poderá inserir manualmente o preço novo ou poderá fazer com que o &kappname; busque-o na Web.

### Atualização de preços manual

Você poderá inserir os preços dos seus investimentos, usando o mesmo Editor de Preços que é usado para as moedas.

### Cotações de preços online

O &kappname; pode obter os últimos preços dos seus investimentos e taxas de câmbio a partir da Web.

#### Como funcionam as cotações online

Por sua solicitação, o &kappname; irá obter uma página da Web que contém o último preço para cada item. Por padrão, os preços são obtidos de finance.yahoo.com, estando sujeitos aos termos e condições desse serviço.

A pesquisa de cotações online usa o símbolo comercial do investimento para descobrir o preço. Como tal, é importante definir o símbolo corretamente. O Yahoo suporta as cotações da maioria dos mercados mundiais, como tal é apenas uma questão de encontrar o símbolo correto. Por exemplo, a TietoEnator comercializa no mercado da Bolsa de Valores de Estocolmo, sendo que o seu símbolo na Yahoo é TIEN.ST.

Para descobrir o símbolo comercial de um título suportado pela Yahoo, use a funcionalidade de Pesquisa do Símbolo em finance.yahoo.com.

#### Atribuir uma fonte de cotações

Para obter as cotações de preços online, você primeiro precisa ativá-las para cada investimento ou moeda que deseje atualizar, definindo para tal, uma Fonte de cotações online. Esse é o nome do serviço de onde a cotação deverá ser obtida. O &kappname; vem com várias fontes para escolher. O Yahoo é a fonte recomendada e deverá funcionar para a maioria dos investimentos, em todas as moedas.

Para atribuir uma fonte a um investimento, vá para a área de resumo dos investimentos para a conta em que está guardado o título. Edite o título, clicando com o botão direito nele e selecionando a opção Editar investimento.... No Assistente de Detalhes do Investimento, clique em Próximo duas vezes, para obter a seção de atualização online. Nessa lista, escolha a fonte de atualização.

As versões posteriores do &kappname; contêm suporte para o pacote Finance::Quote para obter as cotações online. Isso é principalmente uma conveniência para os usuários que fizeram conversões do pacote de finanças GnuCash, que o usa como método nativo. Se selecionar de fato esta opção, deverá ver uma lista de fontes diferente, as que são suportadas pelo Finance::Quote. Se a lista estiver vazia, poderá ser pelo fato do pacote não estar devidamente instalado. Veja a sua página Web em http://finance-quote.sourceforge.net para mais informações.

#### Ajustar uma cotação

Algumas fontes online não comunicam o preço em uma quantidade de base (⪚, EUR), mas sim, em uma fração (⪚, Cêntimos). Se usar essa informação como preço, irá produzir valores errados para seus investimentos.

Se for esse o caso da sua fonte online, poderá usar o campo Fator para inserir um fator de ajuste. Para o exemplo mencionado acima, o fator seria de 0,01.

O campo Fator só ficará disponível se uma Fonte de cotações estiver selecionada.

#### Obter as cotações

Tipicamente, você irá atualizar os preços de todos os seus investimentos e moedas de uma vez. Escolha a opção do menu Ferramentas Atualizar o preço das moedas e ações... para invocar a janela de cotações de preços online. Clique em Atualizar tudo para obter as cotações de todos os investimentos e moedas no seu arquivo do &kappname;.

Atualizar o preço das moedas e ações Atualização online das cotações e preços das moedas

#### Editar ou adicionar fontes de cotações

A edição ou adição de fontes de cotações não é recomendada a ninguém, a não ser para o usuário mais técnico. Sinta-se à vontade para ler o HTML e escrever expressões regulares complexas. Se isso não lhe soa muito agradável, recomendamos que contate a lista de programadores, no caso de nenhuma das fontes de cotações funcionar para você. De preferência, indique-nos uma página Web onde essas cotações poderão ser obtidas.

Se estiver à vontade com esse desafio, aqui está como elas funcionam. As fontes de cotações estão contidas na caixa de diálogo de configuração. Escolha a opção Configurações Configurar o &kappname;. Na caixa de diálogo que abrir, escolha a seção Cotações online. Você poderá escolher uma fonte existente para editar ou criar uma nova. Quando terminar as alterações, pressione o botão Atualizar antes de sair da caixa de diálogo. Suas alterações não serão salvas por padrão.

A primeira informação com que deverá se preocupar sobre uma fonte de cotações online é a URL, que é a página Web onde será obtida. Você verá um %1 em todas as fontes, bem como um %2 nas fontes de moedas. Para investimentos, o %1 é substituído pelo símbolo comercial. Para moedas, o %1 é substituído pela moeda de Origem, enquanto o %2 é substituído pela de Destino. Esta URL é então obtida, todas as marcas de HTML serão removidas e o texto reduzido é então enviado para o processador de páginas.

Lembre-se de que a URL também poderá ser uma URL do tipo 'file:', onde o módulo de extração de cotações irá assumir como um programa executável. O módulo irá passar todos os argumentos da linha de comando indicados por você, alimentando o 'stdout' ao processador da página. Por exemplo, você poderá ter um programa chamado 'cotacoes.sh' que contém a lógica de cotações personalizada, usando o símbolo como um único parâmetro. Sua URL seria algo do gênero file:/local/das/cotacoes.sh %1.

O processador de páginas procura por um símbolo, uma data e um preço. As expressões regulares indicam como extrair esses itens da página. Reveja a documentação da classe QRegExp, para saber a formatação correta das expressões regulares. Deverá existir apenas uma expressão de captura entre parênteses, em cada expressão regular. O formato da data indica posteriormente ao processador a ordem do ano, mês e dia. Este formato de datas deverá ser sempre no formato "%x %x %x". em que o 'x' pode ser 'y', 'm' ou 'd'. O processador de datas é bastante inteligente. O %m %d %y irá processar o Dezembro 31, 2005 da mesma forma que 12/31/05. Os anos com dois algarismos são considerados como sendo entre 1950 e 2049.

## Funcionalidades não implementadas

Algumas funcionalidades comuns que normalmente são encontradas em investimentos, não estão implementadas no &kappname;. Entre elas incluem-se: Derivações (opções, futuros, etc.), ganhos de capital e declaração para impostos de investimentos.