<?xml version="1.0" encoding="UTF-8"?>
<chapter id="details.investments">
<chapterinfo>
  <authorgroup>
    <author
>&Ace.Jones; &Ace.Jones.mail; </author>
  </authorgroup>
  <date
>2010-07-25</date>
  <releaseinfo
>4.5</releaseinfo>
</chapterinfo>

<title
>Investissements</title>

<sect1 id="details.investments.overview">
<title
>Investissements dans &kappname;</title>

<sect2>
<title
>Investissements</title>

<para
>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. </para>
</sect2>

<sect2>
<title
>Devise de base</title>
<para
>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 (<foreignphrase
>New York Stock Exchange</foreignphrase
>) est valorisée en dollars US et une autre sur le marché Australien est valorisée en dollars Australiens. </para>
</sect2>

<sect2>
<title
>Compte d'investissement</title>
<para
>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 <quote
>solde des liquidités</quote
> dans un compte d'investissement. Pour cela, il vous faut un compte de courtage. </para>
</sect2>

<sect2>
<title
>Compte de courtage</title>
<para
>Un compte d'investissement est souvent associé à un compte de courtage. Il est aussi souvent appelé <quote
>compte de liquidités</quote
>. 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. </para>

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

</sect2>

</sect1>

<sect1 id="details.investments.investment">
<title
>Création d'un compte d'investissement</title>

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

<para
>Pour travailler avec ce nouveau compte, choisissez <guibutton
>Investissements</guibutton
> dans le sélecteur de vues, puis choisissez le compte que vous venez de créer dans la liste déroulante <guilabel
>Sélectionner le compte</guilabel
>. </para>
</sect1>
            
<sect1 id="details.investments.securities">
<title
>Ajout de titres à votre compte</title>

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

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

<sect2 id="details.investments.newinvestmentwizard">
<title
>Assistant - Nouvel investissement</title>

<para
>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;. </para>

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

<itemizedlist>
  <listitem
><para
>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. </para
></listitem>

  <listitem
><para
>Nom complet. Le nom facile à lire du titre que vous ajoutez, &pex; <quote
>Advanced Micro Devices, Inc.</quote
>.  </para
></listitem>

  <listitem
><para
>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. </para
></listitem>
  
  <listitem
><para
>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;. </para
></listitem>

  <listitem
><para
>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;. </para
></listitem>

  <listitem
><para
>Devise. Il s'agit de la devise dans laquelle le titre est négocié sur son marché. </para
></listitem>

  <listitem
><para
>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.  </para
></listitem>
</itemizedlist>

<para
>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, <quote
><foreignphrase
>Rubicon Limited</foreignphrase
></quote
> sur le marché néo-zélandais devrait être symbolisé par <quote
>RBC.NZ</quote
>. </para>

<para
>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 :  </para>

<itemizedlist>
  <listitem>
    <para
>Utilise <foreignphrase
>Finance::Quote</foreignphrase
>. 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. </para>
  </listitem>

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

  <listitem>
    <para
>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. </para>
  </listitem>
</itemizedlist>
</sect2>
</sect1>

<sect1 id="details.investments.edit">
<title
>Édition d'un titre</title>

<para
>La vue <emphasis
>Investissements</emphasis
> 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 <guimenu
>Options d'investissement</guimenu
>. 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é. </para>
</sect1>

<sect1 id="details.investments.ledger">
<title
>opération de titres</title>

<para>
	<screenshot>
	<screeninfo
>Formulaire d'opération de titres</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="investment-transactionform.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Formulaire d'opération de titres</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<para
>Les opérations concernant des titres sont saisies et éditées dans la vue <link linkend="details.ledgers"
>Registres</link
> 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 :  </para>

<itemizedlist>
	<listitem
><para
>Activité</para
></listitem>
	<listitem
><para
>Titre</para
></listitem>
	<listitem
><para
>Compte</para
></listitem>
	<listitem
><para
>Nombre de titres, cours et montant total</para
></listitem>
	<listitem
><para
>Frais</para
></listitem>
	<listitem
><para
>Catégorie des intérêts</para
></listitem>
</itemizedlist>

<sect2>
<title
>Activité</title>
<para
>L'activité pour un titre décrit le type d'action concernant le titre. Les activités suivantes sont prises en charge :  </para>

<variablelist>
  <varlistentry>
  <term
>Acheter des titres / vendre des titres</term>
  <listitem>
    <para
>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. </para>
  </listitem>
  </varlistentry>

  <varlistentry>
  <term
>Dividendes / intérêts</term>
  <listitem>
    <para
>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. </para>
  </listitem>
  </varlistentry>

  <varlistentry>
  <term
>Réinvestir le dividende</term>
  <listitem>
    <para
>Réinvestir le dividende. C'est le cas où le dividende est réinvesti en parts du titre. </para>
  </listitem>
  </varlistentry>

  <varlistentry>
  <term
>Ajouter des titres / supprimer des titres</term>
  <listitem>
    <para
>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. </para>
  </listitem>
  </varlistentry>

  <varlistentry>
  <term
>Fractionner les titres</term>
  <listitem>
    <para
>Utilisé quand le titre est divisé (décision de la société émettrice du titre). Saisissez le rapport de division dans le champ <quote
>Rapport</quote
> à droite du formulaire. Par exemple, dans une division 3 pour 2 (3:2), saisissez 1,5. </para>
  </listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2>
<title
>Titre</title>
<para
>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.  </para>
</sect2>

<sect2>
<title
>Compte</title>
<para
>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. </para>
</sect2>

<sect2>
<title
>Nombre de titres, cours et montant total</title>
<para
>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. </para>
</sect2>

<sect2>
<title
>Frais</title>
<para
>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 <link linkend="details.ledgers.split"
>Opération répartie</link
>. Dans ce cas, quand vous avez fini de saisir toutes les répartitions, le montant total des frais apparaît à droite.  </para>
</sect2>

<sect2>
<title
>Intérêts</title>
<para
>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. </para>
</sect2>

</sect1>

<sect1 id="details.investments.foreign">
<title
>Utiliser des titres étrangers</title>

<para
>&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é. </para>

<para
>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). </para>

<para
>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. </para>

<para>
	<screenshot>
	<screeninfo
>Alerte devise</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="investment-currencywarning.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Alerte devise</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<para
>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. </para>

<para>
	<screenshot>
	<screeninfo
>Éditeur de taux de change</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="investment-exchangerateeditor.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Éditeur de taux de change</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<para
>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 <link linkend="details.currencies.prices"
>Saisie des cours à la main</link
> pour plus d'information sur la boîte de dialogue des cours. </para>

<para
>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. </para>
</sect1>

<sect1 id="details.investments.prices">
<title
>Mise à jour des cours</title>
<para
>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.  </para>

<sect2>
<title
>Mise à jour des cours à la main</title>
<para
>Vous pouvez saisir les cours pour vos titres en utilisant le même <link linkend="details.currencies.prices"
>Éditeur de cours</link
> que celui utilisé pour les devises. </para>
</sect2>

<sect2 id="details.investments.onlinequotes">
<title
>Cotations en ligne</title>
<para
>&kappname; peut télécharger les derniers cours de vos titres et de vos devises depuis l'Internet.  </para>

<sect3>
<title
>Comment fonctionne la cotation en ligne</title>
<para
>À 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 <ulink url="http://finance.yahoo.com"
>finance.yahoo.com</ulink
> et sont assujettis aux termes et conditions d'utilisation de ce site.  </para>

<para
>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 <foreignphrase
>Stockholm Stock Exchange</foreignphrase
> et son symbole est TIEN.ST. </para>

<para
>Pour trouver le symbole d'un titre pris en charge par Yahoo, utilisez la fonctionnalité <quote
>Recherche de symbole</quote
> de <ulink url="http://finance.yahoo.com"
>finance.yahoo.com</ulink
>. </para>
</sect3>

<sect3>
<title
>Affectation d'une source de cotation</title>

<para
>Afin d'obtenir des cours en ligne, vous devez d'abord activer la fonction pour chaque titre ou devise en définissant une <quote
>Source de cotation en ligne</quote
>. 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. </para>

<para
>Pour affecter une source de cotation à un titre, cliquez sur <guibutton
>Investissements</guibutton
> 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 <guimenuitem
>Éditer l'investissement ...</guimenuitem
>. Dans l'<quote
>Assistant - Détails de l'investissement</quote
>, cliquez deux fois sur <guibutton
>Suivant</guibutton
> pour faire apparaître la page relative à la cotation en ligne, puis dans la liste déroulante <quote
>Cotation en ligne</quote
>, choisissez votre source de mise à jour. </para>

<para
>Les versions de &kappname; commençant par 0.9 prennent en charge le paquetage <foreignphrase
>Finance::Quote</foreignphrase
> 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 <foreignphrase
>Finance::Quote</foreignphrase
>. Si la liste est vide, on peut penser que le paquetage n'est pas correctement installé. Reportez-vous à leur site Web <ulink url="http://finance-quote.sourceforge.net"
> http://finance-quote.sourceforge.net</ulink
> pour plus d'informations. </para>
</sect3>

<sect3>
<title
>Ajustement d'un cours</title>

<para
>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. </para>

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

<para
>Le champ <guilabel
>Facteur</guilabel
> n'est accessible que si une <guibutton
>Source de cotation</guibutton
> a été choisie. </para>
</sect3>

<sect3>
<title
>Recherche de cotations</title>

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

<para>
	<screenshot>
	<screeninfo
>Mettre à jour le prix des titres et des devises.</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="investment-onlineupdate.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Mise à jour en ligne des prix des titres et des devises</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>
</sect3>

<sect3>
<title
>Ajouter ou éditer des sources de mise à jour</title>

<para
>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. </para>

<para
>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 <menuchoice
><guimenu
>Configuration</guimenu
><guimenuitem
>Configurer &kappname;</guimenuitem
></menuchoice
>. Puis, à partir de là, choisissez la section <guilabel
>Cotations en ligne</guilabel
>. 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 <guibutton
>Mettre à jour</guibutton
> avant de quitter la boîte de dialogue. Par défaut, vos modifications ne sont pas enregistrées. </para>

<para
>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. </para>

<para
>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é <foreignphrase
>getquote.sh</foreignphrase
> qui contiendrait une logique de cotation personnalisée, et qui prendrait le symbole comme unique paramètre. Votre URL serait alors <quote
>file:/path/to/getquote.sh %1</quote
>. </para>

<para
>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 <ulink url="http://qt.nokia.com/doc/4.5/qregexp.html#1"
>QRegExp class</ulink
> 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. <quote
>%m %d %y</quote
> sera lu aussi bien sous la forme <quote
>December 31st, 2005</quote
> que sous la forme <quote
>12/31/05</quote
>. Deux chiffres sont interprétés comme appartenant à l'intervalle 1950-2049. </para>
</sect3>
</sect2>
</sect1>

<sect1 id="details.investments.unimplemented">
<title
>Fonctionnalités non prises en charge</title>
<para
>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. </para>
</sect1>
</chapter>
