<?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
>Investimenti</title>

<sect1 id="details.investments.overview">
<title
>Investimenti in &kappname;</title>

<sect2>
<title
>Investimenti</title>

<para
>Gli investimenti sono strumenti finanziari quotati su un mercato che permettono di investire soldi. Le azioni, le obbligazioni e i fondi sono gli investimenti più comuni; quindi sono quelli supportati in modo più diretto. A volte vengono utilizzati anche i future, la borsa merci, le opzioni i loro derivati più complessi, ma &kappname; non ha funzionalità specifiche. Comunque, se si comportano come un'azione o un obbligazione è facile gestirli. </para>
</sect2>

<sect2>
<title
>Valuta di base</title>
<para
>Ogni investimento ha una valuta di base. Questa è la valuta utilizzata per commerciarlo. Quando viene inserita una quotazione del titolo, la valuta utilizzata è sempre quella di base. Un'azione del NYSE (New York Stock Exchange) sarà in dollari americani, mentre una del mercato australiano sarà in dollari australiani. </para>
</sect2>

<sect2>
<title
>Conti di tipo Investimento</title>
<para
>I conti di investimento contengono un insieme di investimenti. Un conto di tipo Investimento, in &kappname;, contiene transazioni, come acquisti o vendite, di questi investimenti. Tutte le transazioni contenute in un conto di tipo Investimento devono essere relative ad un certo investimento. Non c'è un <quote
>bilancio di liquidità</quote
> in un conto di tipo investimento. Se si vuole avere questa funzionalità, ci vuole un conto di brokeraggio. </para>
</sect2>

<sect2>
<title
>Conti di brokeraggio</title>
<para
>Un conto di investimento spesso ha un conto di brokeraggio associato. Questo viene chiamato spesso <quote
>Conto di liquidità</quote
>. I conti di investimento non possono contenere transazioni di liquidità, come un trasferimento dalla banca.Quando si vende un titolo, il ricavato viene solitamente messo in un conto di brokeraggio. </para>

<para
>Quando si crea un conto di Investimento, viene offerta la possibilità di creare un conto di brokeraggio associato. </para>

</sect2>

</sect1>

<sect1 id="details.investments.investment">
<title
>Creazione di un conto di investimento</title>

<para
>Il primo passo per gestire gli investimenti è creare un conto per contenerli. Scegliere <menuchoice
><guimenu
>Conto</guimenu
> <guimenuitem
>Nuovo conto...</guimenuitem
></menuchoice
> dal menu per iniziarela procedura di creazione di un nuovo conto. Creare un conto come al solito, assicurandosi di selezionare <quote
>Investimento</quote
> come tipo del conto. </para>

<para
>Per gestire il nuovo conto di investimento, andare nella vista <guibutton
>Investimenti</guibutton
> e selezionare il conto appena creato nel menu a discesa <guilabel
>Seleziona conto</guilabel
>. </para>
</sect1>
            
<sect1 id="details.investments.securities">
<title
>Aggiunta di investimenti al conto</title>

<para
>Per aggiungere degli investimenti al conto di investimento, andare nella vista <guibutton
>Investimenti</guibutton
> e scegliere il conto che contiene l'investimento dal menu a discesa <guilabel
>Seleziona conto</guilabel
>. </para>

<para
>Fare clic con il &RMB; nello spazio vuoto della vista. Si aprirà il menu contestuale <guimenu
>Opzioni degli investimenti</guimenu
>. Scegliere <guimenuitem
>Nuovo...</guimenuitem
>. Verrà aperta la <guilabel
>procedura guidata di creazione di un nuovo investimento</guilabel
>, che permetterà di creare l'investimento. </para>

<sect2 id="details.investments.newinvestmentwizard">
<title
>Procedura guidata di creazione di un nuovo investimento</title>

<para
>La prima cosa che è necessario inserire è il tipo di investimento: un'azione, un obbligazione, ecc. </para>

<para
>Poi viene visualizzata la pagina dei dettagli dell'investimento, con le seguenti informazioni: </para>

<itemizedlist>
  <listitem
><para
>Simbolo commerciale. Il simbolo usato per identificare l'investimento nel mercato in cui è quotato. &kappname; richiede il simbolo commerciale per tutti gli investimenti, anche se alcuni non hanno un simbolo associato; in questi casi, è necessario inventarne uno. </para
></listitem>

  <listitem
><para
>Nome completo. Il nome descrittivo, leggibile dell'investimento che si sta creando, per esempio <quote
>Advanced Micro Devices, Inc.</quote
>. Questo nome viene chiamato anche nome del titolo. </para
></listitem>

  <listitem
><para
>Frazione. Il grado di precisione usato nella misurazione delle tue quote. Per esempio, negli Stati Uniti la maggior parte dei fondi di investimento misurano le quote con tre cifre decimali, quindi si dovrebbe inserire 1000. Le obbligazioni sono spesso misurate come unità intere, quindi si dovrebbe inserite 1 in questo caso. </para
></listitem>
  
  <listitem
><para
>Mercato di scambio. Il mercato in cui il titolo è quotato. È un campo facoltativo, fornito per comodità. Questa informazione non viene usata in altre parti di &kappname;. </para
></listitem>

  <listitem
><para
>Identificativo. Un campo facoltativo per l'inserimento di informazioni aggiuntive che si vogliono memorizzare. Anche queste informazioni non vengono usate nel resto di &kappname;. </para
></listitem>

  <listitem
><para
>Valuta di scambio. La valuta usata per quotare questo investimento nel suo mercato di scambio. </para
></listitem>

  <listitem
><para
>Prezzo di entrata. Scegliere se il prezzo inserito è il prezzo di ogni quota o del totale delle quote. </para
></listitem>
</itemizedlist>

<para
>Se si usano le quotazioni in linea, assicurarsi che il simbolo corrisponda esattamente a quello usato nella tua sorgente delle quotazioni. Yahoo copre la maggior parte dei mercati mondiali, e richiede un suffisso alla fine del simbolo, se il mercato di scambio non è negli Stati Uniti. Ad esempio, il titolo Rubicon Limited del mercato della Nuova Zelanda deve essere inserito come <quote
>RBC.NZ</quote
>. </para>

<para
>Infine, viene visualizzata la schermata di aggiornamento in linea. Qui si indica a &kappname; come aggiornare le quotazioni dell'investimento. Vengono impostati i seguenti campi: </para>

<itemizedlist>
  <listitem>
    <para
>Usa Finance::Quote. Questa è un'opzione per gli utenti di GnuCash che sono abilitati a questo tipo di quotazioni. La maggior parte degli utenti possono lasciare questa casella deselezionata. </para>
  </listitem>

  <listitem>
    <para
>Fonte in linea. La fonte da utilizzare per questo investimento. La scelta più comune è <quote
>Yahoo</quote
>. Se l'investimento non viene trovato, provare un'altra fonte. </para>
  </listitem>

  <listitem>
    <para
>Fattore. Un fattore da applicare alle quotazioni di questo investimento. Questa impostazione viene usata spesso per i titoli inglesi, dove le quotazioni sono in pence (centesimi), mentre il titolo è in sterline. In questo caso, inserire il fattore 0,01. </para>
  </listitem>
</itemizedlist>
</sect2>
</sect1>

<sect1 id="details.investments.edit">
<title
>Modifica di un investimento</title>

<para
>La vista degli investimenti elenca i titoli attuali in questo conto, insieme al loro simbolo, al loro valore e al loro prezzo. Facendo clic con il &RMB; su un investimento si apre il menu contestuale <guimenu
>Opzioni dell'investimento</guimenu
>, che permette di aggiungere, modificare e eliminare gli investimenti di questo conto. Inoltre, qui è possibile aggiornare le quotazioni degli investimenti, manualmente o usando una fonte in linea. È anche possibile chiudere un conto vuoto o riaprire un conto chiuso. </para>
</sect1>

<sect1 id="details.investments.ledger">
<title
>Transazioni di tipo investimento</title>

<para>
	<screenshot>
	<screeninfo
>Modulo delle transazioni degli investimenti</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="investment-transactionform.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Modulo delle transazioni degli investimenti</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<para
>Le transazioni degli investimenti vengono inserite e modificate nella vista <link linkend="details.ledgers"
>Registro</link
>, come per gli altri tipi di conti. Comunque, i campi sono diversi e variano in base al tipo dell'investimento. Le transazioni degli investimenti hanno alcuni campi aggiuntivi: </para>

<itemizedlist>
	<listitem
><para
>Attività</para
></listitem>
	<listitem
><para
>Strumenti finanziari</para
></listitem>
	<listitem
><para
>Conto</para
></listitem>
	<listitem
><para
>Quote, prezzo e totale</para
></listitem>
	<listitem
><para
>Tasse</para
></listitem>
	<listitem
><para
>Interesse</para
></listitem>
</itemizedlist>

<sect2>
<title
>Attività</title>
<para
>L'Attività di una transazione di investimento descrive l'azione compiuta sulle quote. Sono supportate le seguenti attività: </para>

<variablelist>
  <varlistentry>
  <term
>Compra/Vendi</term>
  <listitem>
    <para
>Usate per registrare l'acquisto o la vendita di investimenti. Questa azione richiede un conto da cui o a cui trasferire i soldi. </para>
  </listitem>
  </varlistentry>

  <varlistentry>
  <term
>Dividendo/Prodotto</term>
  <listitem>
    <para
>Usate quando si riceve un'interesse o un dividendo per l'investimento. Questa azione richiede un conto da cui o a cui trasferire i soldi. </para>
  </listitem>
  </varlistentry>

  <varlistentry>
  <term
>Reinvesti dividendo</term>
  <listitem>
    <para
>Usato quando si riceve un dividendo in termini non di denaro, ma di quote dell'investimento. </para>
  </listitem>
  </varlistentry>

  <varlistentry>
  <term
>Aggiungi/Rimuovi quote</term>
  <listitem>
    <para
>Un semplice aumento o diminuzione del bilancio. Questa funzione viene usata raramente, perché di solito non vengono aggiunte o tolte quote dal conto, a meno che tu le compri o venda. </para>
  </listitem>
  </varlistentry>

  <varlistentry>
  <term
>Dividi quote</term>
  <listitem>
    <para
>Usato quando le quote vengono divise. Inserire il rapporto della divisione nel campo <quote
>Rapporto</quote
>. Ad esempio, per una divisione 3 a 2, inserire 1,5. </para>
  </listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2>
<title
>Strumenti finanziari</title>
<para
>Ogni transazione di investimento deve essere associata ad uno strumento finanziario, che qui è solo un altro nome dell'investimento. Scegliere il nome dell'investimento quando si inserisce o modifica una transazione. Quando la si visualizza, verrà visualizzato il simbolo dell'investimento. </para>
</sect2>

<sect2>
<title
>Conto</title>
<para
>È necessario inserire il conto da cui si prelevano o su cui si depositano i soldi, per le transazioni che lo richiedono. Se il conto dell'investimento ha un conto di brokeraggio associato, di solito è meglio trasferire lì i soldi. Questo si applica sia ai fondi, per gli acquisti e le vendite, sia alle tasse, agli interessi e ai dividendi. </para>
</sect2>

<sect2>
<title
>Quote, prezzo e totale</title>
<para
>Per le transazioni di acquisto, vendita e dividendo in liquidità, bisogna specificare il numero di quote, il prezzo per quota e il totale della transazione. Basta inserire due dei tre dati e &kappname; calcolerà automaticamente il terzo. Spesso è meglio inserire il totale e il numero di quote, perché questi dati vengono forniti al completamento della transazione, mentre il prezzo per quota sarebbe da calcolare. </para>
</sect2>

<sect2>
<title
>Commissioni</title>
<para
>Con diverse transazioni di investimento è possibile includere le commissioni pagate all'agente. Se si inserisce una categoria per la commissione, verrà visualizzato un campo sulla destra che permette di inserire l'importo. Se è necessario inserire più di una commissione per la stessa transazione è possibile usare la funzione <link linkend="details.ledgers.split"
>Dividi transazione</link
>. In questo caso, quando si completa l'inserimento delle suddivisioni, viene visualizzato sulla destra il totale delle commissioni. </para>
</sect2>

<sect2>
<title
>Interessi</title>
<para
>Permette di inserire un interesse o il pagamento di un dividendo di un investimento. Come per le commissioni, quando si inserisce una categoria viene visualizzato il campo corrispondente sulla destra, in cui si può inserire l'importo. È anche possibile usare la funzione di divisione delle transazioni, se necessario. </para>
</sect2>

</sect1>

<sect1 id="details.investments.foreign">
<title
>Gestione degli investimenti esteri</title>

<para
>&kappname; supporta più valute e investimenti, e si potrebbe voler combinare le due cose. Comunque, è necessaria più attenzione: come detto sopra, all'aggiunta di un investimento, si specifica la sua valuta base. Questa valuta potrebbe essere diversa dalla valuta base, e può anche essere diversa da quella del conto usato per l'investimento e del conto usato per trasferire i fondi necessari all'acquisto o provenienti dalla vendita. </para>

<para
>Facciamo un esempio, La valuta di base è il dollaro americano (USD) e il conto dell'investimento e quello di brokeraggio usano l'euro (EUR). In quel conto di investimento, tieni delle quote di TietoEnator, quotata in corone svedesi (SEK). </para>

<para
>Quando si inserisce una transazione di acquisto per questo investimento, si usa la valuta SEK. Quindi, se si comprano 100 quote a 248 SEK l'una, per un totale di 24.800 SEK, bisogna inserire questi valori nella transazione. </para>

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

<para
>Quando si sceglie il conto di brokeraggio da cui prendere i fondi per la transazione, si verrà avvertiti che usa una valuta diversa. </para>

<para>
	<screenshot>
	<screeninfo
>Editor dei tassi di cambio</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="investment-exchangerateeditor.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Editor dei tassi di cambio</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<para
>Quando si finisce di inserire la transazione, verrà richiesto l'aggiornamento del tasso di cambio tra le due valute (in questo caso, da SEK a EUR). Vedere la documentazione sull'<link linkend="details.currencies.prices"
>Inserimento manuale dei prezzi</link
> per maggiori informazioni sull'editor dei prezzi. </para>

<para
>Se si visualizza il conto di brokeraggio, si vedrà la transazione come 2.254,54 EUR, se il tasso di cambio è 11,0000 SEK / EUR. </para>
</sect1>

<sect1 id="details.investments.prices">
<title
>Aggiornamento dei prezzi</title>
<para
>Ci sono due modi di aggiornare i prezzi per i tuoi investimenti: è possibile inserire manualmente il nuovo prezzo o ottenerlo da Internet. </para>

<sect2>
<title
>Aggiornamenti manuali dei prezzi</title>
<para
>Per inserire i prezzi per gli investimenti si può usare lo stesso <link linkend="details.currencies.prices"
>Editor dei prezzi</link
> usato per le valute. </para>
</sect2>

<sect2 id="details.investments.onlinequotes">
<title
>Quotazioni in linea</title>
<para
>&kappname; può scaricare da Internet le ultime quotazioni relative agli investimenti e alle valute. </para>

<sect3>
<title
>Funzionamento delle quotazioni in linea</title>
<para
>Se lo si desidera, &kappname; scaricherà da Internet una pagina con le ultime quotazioni per ogni elemento. Come impostazione predefinita, vengono prese le quotazioni da <ulink url="http://finance.yahoo.com"
>finance.yahoo.com</ulink
>, e sono soggette ai termini d'uso del sito. </para>

<para
>La ricerca di quotazioni in linea usa il simbolo di scambio dell'investimento per trovare la quotazione. Quindi è importante che il simbolo sia corretto. Yahoo supporta i titoli quotati nella maggior parte dei mercati mondiali, quindi spesso basta cercare il simbolo giusto. Ad esempio, TietoEnator è quotato nel mercato di Stoccolma, e il suo simbolo di scambio per Yahoo è TIEN.ST. </para>

<para
>Per trovare il simbolo di scambio di Yahoo associato ad un titolo, usare la funzione <quote
>Symbol Lookup</quote
> disponibile sul sito <ulink url="http://finance.yahoo.com"
>finance.yahoo.com</ulink
>, (in inglese). </para>
</sect3>

<sect3>
<title
>Impostazione di una sorgente delle quotazioni</title>

<para
>Per ottenere le quotazioni in linea, bisogna prima abilitarle per ogni investimento e valuta che si vuole aggiornare, impostando una <quote
>Sorgente delle quotazioni in linea</quote
>. Questa sorgente è il nome del servizio da cui ricevere le quotazioni. &kappname; supporta diversi servizi, tra cui si può scegliere. Yahoo è quello predefinito e dovrebbe andar bene per la maggior parte degli investimenti e per tutte le valute. </para>

<para
>Per assegnare una sorgente delle quotazioni in linea ad un investimento, bisogna visualizzare il conto a cui appartiene nella vista Investimenti. Modificare il titolo, facendo clic con il &RMB; e selezionando <guimenuitem
>Modifica investimento...</guimenuitem
>. Nella procedura guidata, fare clic due volte su <guibutton
>Successivo</guibutton
>, arrivando nella sezione Aggiornamento in linea. Nel menu a discesa Fonte in linea, selezionare la fonte desiderata. </para>

<para
>&kappname;, dalla versione 0.9, supporta il pacchetto Finance::Quote per ottenere le quotazioni in linea. Questa funzione serve principalmente agli utenti che prima usavano GnuCash, perché in quel programma Finance::Quote è la sorgente nativa delle quotazioni, Se si seleziona questa opzione si vedranno sorgenti diverse, quelle supportate appunto da Finance::Quote. Se la lista è vuota, probabilmente il pacchetto non è installato correttamente. Vedere il sito web di Finance::Quote: <ulink url="http://finance-quote.sourceforge.net"
>http://finance-quote.sourceforge.net</ulink
> (in inglese) per maggiori informazioni. </para>
</sect3>

<sect3>
<title
>Correggere una quotazione</title>

<para
>Alcune sorgenti in linea non forniscono la quotazione in una valuta base (come EUR), ma in un sottomultiplo (come i centesimi). Se si usa come prezzo questa informazione si otterranno valori errati per i propri investimenti. </para>

<para
>Se si è in questa situazione, si può usare il campo <guilabel
>Fattore</guilabel
> per inserire un fattore di correzione. Nell'esempio sopra si dovrebbe inserire 0,01. </para>

<para
>Il campo <guilabel
>Fattore</guilabel
> viene abilitato solo dopo aver selezionato una <guibutton
>Fonte in linea</guibutton
>. </para>
</sect3>

<sect3>
<title
>Scaricamento delle quotazioni</title>

<para
>Tipicamente, si vogliono aggiornare i prezzi degli investimenti e delle valute, tutti in una volta. Scegliere <menuchoice
><guimenu
>Strumenti</guimenu
><guimenuitem
>Aggiorna prezzi di titoli e valute...</guimenuitem
></menuchoice
> per aprire la finestra di aggiornamento dei prezzi. Premi il pulsante <guibutton
>Aggiorna tutti</guibutton
> per aggiornare i prezzi di tutti gli investimenti e delle valute nel tuo file di &kappname;. </para>

<para>
	<screenshot>
	<screeninfo
>Aggiorna i prezzi di titoli e valute</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="investment-onlineupdate.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Aggiornamento in linea delle quotazioni dei titoli e delle valute</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>
</sect3>

<sect3>
<title
>Aggiunta e modifica delle sorgenti delle quotazioni</title>

<para
>Questa operazione non è raccomandata, tranne agli utenti più esperti. Per usarla, si dovrebbe essere a proprio agio nella lettura dell'HTML e nella scrittura di espressioni regolari. Altrimenti, è meglio scrivere alla mailing-list degli sviluppatori se non si trova una sorgente delle quotazioni per i propri titoli. È meglio indicare nel messaggio un sito da cui è possibile ottenere queste quotazioni. </para>

<para
>Se ci si sente pronti per la sfida, ecco come funziona. Le sorgenti delle quotazioni sono contenute nella finestra delle impostazioni, che si può aprire da <menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Configura &kappname;</guimenuitem
></menuchoice
>. Scegliere la sezione <guilabel
>Quotazioni in linea</guilabel
>. È possibile creare una nuova sorgente per le quotazioni o modificarne una esistente. Una volta completate le modifiche, premere il pulsante <guibutton
>Aggiorna</guibutton
> prima di chiudere la finestra, altrimenti le modifiche non verranno salvate. </para>

<para
>La prima cosa da guardare è l'indirizzo della pagina con le quotazioni, che viene scaricata dal web. In tutte le sorgenti si vede la sequenza «%1» e nelle sorgenti che offrono le quotazioni delle valute si vede «%2». «%1» viene sostituito con la valuta di origine e «%2» con quella di destinazione. Viene caricata la pagina, rimossi i tag HTML e inviato questo file al parser. </para>

<para
>Notare che l'indirizzo può anche iniziare con «file:» e in questo caso viene trattato come uno script eseguibile. Verranno passati i parametri specificati sulla riga di comando e inviato l'output del programma al parser. Ad esempio, si può avere uno script chiamato ottieni_quot.sh che contiene il codice necessario a prelevare la quotazione e prende come unico parametro il simbolo di scambio. In questo caso l'indirizzo sarebbe «file:/percorso/fino/a/ottieni_quot.sh %1». </para>

<para
>Il parser cerca un simbolo, una data e un prezzo. Queste informazioni vengono estratte usando delle espressioni regolari, Vedere la documentazione della classe <ulink url="http://qt.nokia.com/doc/4.5/qregexp.html#1"
>QRegExp class</ulink
> all'indirizzo http://qt.nokia.com/doc/4.5/qregexp.html#1 per conoscere la sintassi delle espressioni regolari. Ci deve essere solo una espressione di cattura, fra parentesi, in ogni espressione regolare. Il formato della data indica al parser l'ordine di anno, mese e giorno. Questo formato deve essere sempre della forma «%x %x %x», con x sostituito da «y», «m» o «d». Il parser è molto intelligente. <quote
>%m %d %y</quote
> corrisponderà sia a <quote
>December 31st, 2005</quote
> sia a <quote
>12/31/05</quote
>. Gli anni di due cifre sono interpretati nell'intervallo da 1950 a 2049. </para>
</sect3>
</sect2>
</sect1>

<sect1 id="details.investments.unimplemented">
<title
>Funzionalità non implementate</title>
<para
>Alcune funzioni comuni riguardo agli investimenti non sono ancora implementate in &kappname;; ad esempio i derivati (opzioni, future, ecc.), le plusvalenze e le tasse. </para>
</sect1>
</chapter>