# Investissements

## Investissements dans &kappname;

### Investissements

Les investissements sont des instruments pour placer de l'argent qui sont négociés sur un marché. Les actions, les bons et les fonds de placement sont les investissements les plus courants ; aussi sont-ils ceux qui sont pris en charge directement. Les futures, les matières premières, les options et des produits dérivés plus complexes sont aussi utilisés, mais &kappname; ne dispose pas de fonctionnalité qui leur soit adaptée. Tant que ces produits se comportent comme une action ou un bon, ils peuvent être suivi facilement.

### Devise de base

Chaque investissement est valorisé dans une devise de base. C'est la devise dans laquelle il est négocié. Quand une cotation est saisie pour un investissement, la devise correspondante est toujours la devise de base. Une action sur le NYSE (New York Stock Exchange) est valorisée en dollars US et une autre sur le marché Australien est valorisée en dollars Australiens.

### Compte d'investissement

Un compte d'investissement gère un certain nombre de titres. Il contient des opérations, telles que des achats et des ventes de ces titres. Toutes les opérations dans un compte d'investissement se rapportent à un titre en particulier. Il n'y a pas de solde des liquidités dans un compte d'investissement. Pour cela, il vous faut un compte de courtage.

### Compte de courtage

Un compte d'investissement est souvent associé à un compte de courtage. Il est aussi souvent appelé compte de liquidités. Les comptes d'investissement ne peuvent pas contenir d'opérations en liquidités, telles que des virements de votre banque. Quand une action est vendue, les mouvements de liquidités ont en général lieu dans le compte de courtage.

Quand vous créez un compte d'investissement, vous avez la possibilité de créer un compte de courtage associé.

## Création d'un compte d'investissement

Le premier pas pour gérer des titres est de créer un compte d'investissement pour en assurer la gestion. Choisissez Compte Nouveau compte... pour lancer l'assistant de création de compte. Créez un compte comme d'habitude, en faisant attention de choisir Investissement comme type de compte.

Pour travailler avec ce nouveau compte, choisissez Investissements dans le sélecteur de vues, puis choisissez le compte que vous venez de créer dans la liste déroulante Sélectionner le compte.

## Ajout de titres à votre compte

Pour ajouter un titre à votre compte, rendez-vous dans la vue Investissements à partir du sélecteur de vues et choisissez le compte où ce titre sera placé dans la liste déroulante Sélectionner le compte.

Cliquez du bouton de droite sur un espace vide de la vue. Dans le menu contextuel Options d'investissement qui s'affiche, choisissez Nouvel investissement.... Ceci lance l'assistant Assistant - Nouvel investissement pour l'ajout d'un nouveau titre.

### Assistant - Nouvel investissement

La première chose qui vous est demandée, c'est de saisir le type de titre (investissement) : action, fond commun de placement, obligation, &etc;.

Ensuite, une page de saisie des détails de l'investissement vous est soumise. Les informations suivantes sont saisies dans cette page :

- Symbole (Code de bourse). Ce symbole est utilisé pour identifier le titre sur n'importe quel marché où il est négocié. &kappname; exige un symbole pour tous les titres ; cependant certains titres n'ont pas de symbole. Dans ce cas, vous devez en fournir un de votre cru.

- Nom complet. Le nom facile à lire du titre que vous ajoutez, &pex; Advanced Micro Devices, Inc..

- Fraction. Le degré de précision avec lequel les quantités du titre sont exprimées. Par exemple, les quantités de la majorité des fonds mutuels américains sont exprimés avec trois décimales, aussi devriez-vous saisir 1000 dans ce champ pour de tels titres. Les actions sont souvent non divisibles et il faut, dans ce cas, saisir 1.

- Marché. Le lieu où le titre se négocie. Il s'agit d'un champ facultatif à votre disposition. Cette information n'est utilisée nulle part ailleurs par &kappname;.

- Identification. Il s'agit d'un champ facultatif pour ajouter toute information qui vous aide à suivre le titre. Cette information n'est utilisée nulle part ailleurs par &kappname;.

- Devise. Il s'agit de la devise dans laquelle le titre est négocié sur son marché.

- Cours d'entrée (cotation). Déterminez, à l'aide de la liste déroulante, si les cours saisis concerneront une unité de titre ou l'ensemble des titres.

Si vous utilisez la cotation en ligne, assurez-vous que le symbole du titre est identique à celui utilisé par votre source de cotation. Yahoo couvre la plupart des marchés du monde et demande un suffixe en fin de symbole à l'extérieur des USA. Par exemple, Rubicon Limited sur le marché néo-zélandais devrait être symbolisé par RBC.NZ.

Pour finir, l'écran de sélection d'une source de cotation en ligne vous est présenté. C'est ici que vous précisez à &kappname; comment vous voulez mettre les cours de votre titre à jour. Les éléments suivants sont à définir :

- Utilise Finance::Quote. Cette option est à la disposition des anciens utilisateurs de GnuCash qui sont familiers de ce type de cotation. La plupart des utilisateurs peuvent laisser cette option non cochée.

- Source en ligne. La source en ligne que vous aimeriez utiliser pour ce titre en particulier. Le choix le plus courant est Yahoo. Essayez d'abord ça, et si le titre n'est pas trouvé, essayez autre chose.

- Fraction. Un multiplicateur qui devrait être appliqué aux cotations obtenues pour ce titre. Ceci est surtout utile pour les titres britanniques souvent cotés en pence (1/100), alors que le titre est libellé en pounds. Dans ce cas, saisissez 0.01 comme multiplicateur.

## Édition d'un titre

La vue Investissements présente les titres que vous détenez dans ce compte, avec leur symbole, valorisation et cours. Cliquez avec le bouton de droite sur l'un quelconque des titres pour ouvrir le menu contextuel Options d'investissement. Vous pouvez alors ajouter, éditer, ou supprimer un titre dans ce compte. Vous pouvez aussi mettre le cours à jour, soit à la main, soit en ligne via la source en ligne associée au titre. De plus, il est possible de clôturer un compte vide, ou de rouvrir un compte fermé.

## opération de titres

Formulaire d'opération de titres Formulaire d'opération de titres

Les opérations concernant des titres sont saisies et éditées dans la vue Registres comme pour les autres types de comptes. Cependant, les champs sont différents, et varient selon le type de titre ou la nature de l'activité. Les opérations de titres ont quelques éléments additionnels :

- Activité

- Titre

- Compte

- Nombre de titres, cours et montant total

- Frais

- Catégorie des intérêts

### Activité

L'activité pour un titre décrit le type d'action concernant le titre. Les activités suivantes sont prises en charge :

Acheter des titres / vendre des titres

- Utilisé pour enregistrer les achats et ventes d'un titre en particulier. Cette action nécessite qu'un compte enregistrant les mouvements d'argent soit défini.

Dividendes / intérêts

- Cette action est relative au cas où vous touchez un dividende ou des intérêts pour vos titres. Ceci nécessite qu'un compte enregistrant les mouvements d'argent soit défini.

Réinvestir le dividende

- Réinvestir le dividende. C'est le cas où le dividende est réinvesti en parts du titre.

Ajouter des titres / supprimer des titres

- Une simple variation du nombre de vos titres. Ceci devrait être utilisé très rarement car il n'est pas courant de voir des titres apparaître (ou disparaître) de votre compte sans qu'une vente ou un achat n'ait lieu.

Fractionner les titres

- Utilisé quand le titre est divisé (décision de la société émettrice du titre). Saisissez le rapport de division dans le champ Rapport à droite du formulaire. Par exemple, dans une division 3 pour 2 (3:2), saisissez 1,5.

### Titre

Chaque opération de titre est associée à un titre bien précis. Choisissez le nom du titre lors de l'ajout ou de l'édition d'une opération. Le symbole est alors affiché quand vous affichez le titre.

### Compte

Pour toute opération qui génère ou nécessite des liquidités, vous devez saisir le compte qui enregistre les flux de liquidités. Si votre compte d'investissement est associé à un compte de courtage, il est conseillé de l'utiliser. Ceci concerne aussi bien les liquidités impliquées dans une opération de vente ou d'achat, que les frais payés, ou les dividendes ou les intérêts reçus.

### Nombre de titres, cours et montant total

Pour des opérations d'achat, de vente ou de réception d'un dividende, le nombre de titres, le cours par titre, et le montant total de l'opération doivent être déclarés. Vous pouvez saisir deux de ces données et &kappname; détermine la troisième pour vous. Il est en général conseillé de saisir le montant total et le nombre de titres car ce sont les données réellement connues d'une opération. Le prix par titre peut alors être calculé à partir de ces données.

### Frais

Pour beaucoup d'opération de titres, vous pouvez déclarer les frais de courtage. Si vous saisissez une catégorie pour les frais, un champ vous est présenté sur la droite pour en saisir le montant. Si vous devez saisir divers frais pour l'opération, vous pouvez utiliser la fonction Opération répartie. Dans ce cas, quand vous avez fini de saisir toutes les répartitions, le montant total des frais apparaît à droite.

### Intérêts

Ceci est la façon de saisir un paiement d'intérêts ou de dividendes pour un titre. Comme pour les frais, si vous saisissez une catégorie, un champ vous est présenté sur la droite pour en saisir le montant. Vous pouvez également répartir l'opération si nécessaire.

## Utiliser des titres étrangers

&kappname; prend en charge de multiples devises et titres, et vous pouvez désirer combiner les deux. Cependant, ceci nécessite une attention particulière. Comme nous l'avons dit plus haut, lorsque vous avez ajouté un titre, vous avez dû déclarer sa devise de négociation. Cette dernière peut être différente de votre devise de base et elle peut aussi être différente de celle utilisée par votre compte d'investissement ou de celle utilisée par votre compte de liquidités associé.

Prenons un exemple. Votre devise de base est le dollar US (USD). Vous avez un titre en euros (EUR), et votre compte de courtage est en euros (EUR). Dans votre compte d'investissement vous avez des titres TietoEnator négociés en couronnes suédoises (SEK).

Lorsque vous saisissez une opération d'achat de ce titre, utilisez SEK comme devise. Ainsi, si vous achetez 100 titres au prix de 248,00 SEK, pour un total de 24 800,00 SEK, saisissez ces valeurs dans l'opération.

Alerte devise Alerte devise

Lorsque vous choisissez le compte de courtage pour enregistrer le mouvement de liquidités, vous serez averti qu'il est dans une devise différente.

Éditeur de taux de change Éditeur de taux de change

Lorsque vous finissez l'opération, il vous est demandé une mise à jour de la devise de votre compte d'investissement, dans ce cas la couronne suédoise (SEK) vs. l'euro (EUR). Reportez-vous à la documentation sur Saisie des cours à la main pour plus d'information sur la boîte de dialogue des cours.

Si vous passez alors sur le compte de courtage, vous verrez l'opération sous la forme 2 254,54 EUR, en supposant un taux de change de 11 000 SEK /EUR.

## Mise à jour des cours

Il y a deux manières de mettre les cours à jour pour vos titres. Vous pouvez soit saisir le cours à la main, soit demander à &kappname; de le rechercher sur l'Internet.

### Mise à jour des cours à la main

Vous pouvez saisir les cours pour vos titres en utilisant le même Éditeur de cours que celui utilisé pour les devises.

### Cotations en ligne

&kappname; peut télécharger les derniers cours de vos titres et de vos devises depuis l'Internet.

#### Comment fonctionne la cotation en ligne

À votre demande, &kappname; recherche une page Web qui contient le dernier cours de chacun de vos éléments. Par défaut, les cours sont recherchés sur finance.yahoo.com et sont assujettis aux termes et conditions d'utilisation de ce site.

La cotation en ligne utilise le symbole pour trouver le cours. En conséquence, il est important que ce symbole soit défini correctement. Yahoo prend en charge les titres de la plupart des marchés majeurs du monde, aussi ne s'agit-il que de trouver le bon symbole. Par exemple, TietoEnator s'échange sur le Stockholm Stock Exchange et son symbole est TIEN.ST.

Pour trouver le symbole d'un titre pris en charge par Yahoo, utilisez la fonctionnalité Recherche de symbole de finance.yahoo.com.

#### Affectation d'une source de cotation

Afin d'obtenir des cours en ligne, vous devez d'abord activer la fonction pour chaque titre ou devise en définissant une Source de cotation en ligne. Ceci est le nom du service auprès duquel les cotations seront recherchées. &kappname; est fourni avec plusieurs propositions de source parmi lesquelles vous devez choisir. Yahoo est la source recommandée par défaut et devrait fonctionner pour la plupart des titres et devises.

Pour affecter une source de cotation à un titre, cliquez sur Investissements dans le sélecteur de vues. Ensuite, cliquez avec le bouton de droite sur le titre et dans le menu contextuel qui apparaît, choisissez Éditer l'investissement .... Dans l'Assistant - Détails de l'investissement, cliquez deux fois sur Suivant pour faire apparaître la page relative à la cotation en ligne, puis dans la liste déroulante Cotation en ligne, choisissez votre source de mise à jour.

Les versions de &kappname; commençant par 0.9 prennent en charge le paquetage Finance::Quote pour obtenir les cotations en ligne. Ceci a été prévu à l'attention des anciens utilisateurs de GnuCash qui l'utilisent comme méthode native. Si vous choisissez cette option, il vous est proposé une liste de sources différente : celles prises en charge par Finance::Quote. Si la liste est vide, on peut penser que le paquetage n'est pas correctement installé. Reportez-vous à leur site Web http://finance-quote.sourceforge.net pour plus d'informations.

#### Ajustement d'un cours

Quelques sources en ligne ne fournissent pas le cours en unités monétaires de base (&pex; EUR) mais en fractions (&pex; Cent). Utiliser cette valeur comme cours conduit à des valorisations erronées de vos investissements.

Si tel est le cas pour votre source en ligne, vous pouvez utiliser le champ Facteur pour saisir le facteur d'ajustement. Pour l'exemple mentionné ci-dessus, le facteur serait : 0,01.

Le champ Facteur n'est accessible que si une Source de cotation a été choisie.

#### Recherche de cotations

Typiquement, vous faites la mise à jour des cours de tous vos titres en une seule opération. Choisissez le menu Outils Mettre à jour le prix des actions et des devises... pour afficher la boîte de dialogue des cotations en ligne. Cliquez sur Tout mettre à jour pour obtenir les cotations de tous vos titres et de toutes vos devises dans &kappname;.

Mettre à jour le prix des titres et des devises. Mise à jour en ligne des prix des titres et des devises

#### Ajouter ou éditer des sources de mise à jour

Ajouter ou éditer des sources de mise à jour n'est pas recommandé pour l'utilisateur courant mais devrait être laissé à l'utilisateur techniquement compétent. Il faut en effet être à l'aise avec le langage HTML et avec la manipulation des expressions rationnelles. Si ceci vous paraît un peu au-dessus de vos forces, nous vous invitons à écrire à la liste des développeurs si aucune des sources ne convient pour vous. Dans l'idéal, il faudrait les diriger vers une page où ces cotations sont disponibles.

Si vous vous sentez à la hauteur du challenge, voici comment les choses fonctionnent. Les sources de cotation sont contenues dans la boîte de dialogue de configuration. Choisissez Configuration Configurer &kappname;. Puis, à partir de là, choisissez la section Cotations en ligne. Vous pouvez choisir une source existante pour l'éditer, ou en créer une nouvelle. Quand vous en avez terminé avec les modifications, cliquez sur le bouton Mettre à jour avant de quitter la boîte de dialogue. Par défaut, vos modifications ne sont pas enregistrées.

La première chose à déterminer à propos d'une source de cotation en ligne, c'est son URL. C'est l'adresse de la page qui est recherchée sur l'Internet. Vous verrez un signe %1 dans toutes les sources, et une signe %2 dans les sources pour devises. Pour les investissements, %1 est remplacé par le symbole du titre. Pour les devises %1 est remplacé par la devise d'origine et %2 est remplacé par la devise d'arrivée. Cette page est recherchée, puis toutes les balises HTML sont retirées et le résultat est transmis à l'analyseur de page.

Notez que l'URL peut pointer sur un fichier : URL que le chercheur de cotations interprète comme un script exécutable. Il lui transmet alors tous les arguments de la ligne de commande que vous lui avez spécifiés, et redirige la sortie standard sur l'analyseur de page. Par exemple, vous pourriez avoir un script appelé getquote.sh qui contiendrait une logique de cotation personnalisée, et qui prendrait le symbole comme unique paramètre. Votre URL serait alors file:/path/to/getquote.sh %1.

L'analyseur de page recherche un symbole, une date et un prix. Des expressions rationnelles lui indiquent comment extraire ces éléments de la page. Reportez-vous, s'il vous plaît, à la documentation sur QRegExp class pour la construction des expressions rationnelles. Il devrait y avoir une expression capturée, entourée de parenthèses, dans chacune des expressions rationnelles. Le format de date plus loin indique à l'analyseur de page, l'ordre de présentation de l'année, du mois et du jour. Ce format de date devrait toujours être de la forme « %x %x %x » où x est l'année, le mois ou le jour. L'analyseur de date est très performant. %m %d %y sera lu aussi bien sous la forme December 31st, 2005 que sous la forme 12/31/05. Deux chiffres sont interprétés comme appartenant à l'intervalle 1950-2049.

## Fonctionnalités non prises en charge

Certaines fonctionnalités courantes qui sont normalement associées aux investissements ne sont pas encore prises en charge dans &kappname; Celles-ci comprennent : les produits dérivés (options, futures &etc;), plus-values et rapports fiscaux d'investissement.