<?xml version="1.0" encoding="UTF-8"?>
<chapter id="details.impexp">
<chapterinfo>
  <authorgroup>
    <author
>&Ace.Jones; &Ace.Jones.mail; </author>
  </authorgroup>
  <date
>03/07/2011</date>
  <releaseinfo
>4.6</releaseinfo>
</chapterinfo>

<title
>Importazione ed esportazione</title>

<sect1 id="details.impexp.gnucash">
<sect1info>
  <author
>&Tony.Bloomfield; &Tony.Bloomfield.mail;</author>
</sect1info>

<title
>Importazione da GnuCash</title>

<sect2>
<title
>File GnuCash</title>

<para
>L'importatore di file GnuCash di &kappname; gestisce la lettura diretta dei file standard (&XML;) prodotti da GnuCash, nelle versioni 1.8 e 2.0. I seguenti non sono supportati: </para>

<itemizedlist>
  <listitem
><para
>importazione di dati da database (Postgres)</para
></listitem>
  <listitem
><para
>importazione di file «multi-book»</para
></listitem>
  <listitem
><para
>importazione in un file di &kappname; esistente</para
></listitem>
  <listitem
><para
>importazione di funzionalità specifiche delle piccole aziende (impiegati, fatture, ecc.)</para
></listitem>
  <listitem
><para
>esportazione in file GnuCash.</para
></listitem>
</itemizedlist>

<para
>L'importazione probabilmente funzionerà correttamente solo se si usa un file valido. Si raccomanda di eseguire la funzione <guimenuitem
>Controlla e ripara tutto</guimenuitem
> di GnuCash (nel menu <guimenu
>Azioni</guimenu
>) prima di provare a importare il file. </para>

<para
>I file possono essere aperti specificando il nome sulla riga di comando (<command
>kmymoney &lt;nomefile&gt;</command
>), o dal menu di &kappname;, usando la funzione <menuchoice
> <shortcut
> <keycombo
>&Ctrl;<keycap
>O</keycap
></keycombo
></shortcut
> <guimenu
>File</guimenu
><guimenuitem
>Apri</guimenuitem
> </menuchoice
> o <menuchoice
> <guimenu
>File</guimenu
> <guimenuitem
>Importa</guimenuitem
> </menuchoice
>. </para>

<para
>I due programmi sono abbastanza simili da permettere di importare la maggior parte dei dati giornalieri in modo semplice. Comunque ci sono delle parti diverse, e vengono fornite varie opzioni per gestire queste differenze. Le sezioni seguenti spiegano alcune delle differenze; capendole si possono importare meglio i dati. </para>
</sect2>

<sect2>
<title
>Cose simili, differenze e terminologia</title>

<sect3>
<title
>Utilizzo in una piccola azienda</title>

<para
>Notare che &kappname; è un programma per la gestione delle finanze <emphasis
>personali</emphasis
> e, come tale, non supporta direttamente le funzioni di GnuCash relative alle aziende, come le tabelle delle imposte, il libro paga e il tracciamento dei lotti. I conti debitore e creditore presenti nel file verranno importati rispettivamente come conti di passività e attività. </para>
</sect3>

<sect3>
<title
>Conti</title>

<sect4>
<title
>Tipi di conto</title>

<para
>In entrambi i programmi, la struttura di più alto livello nei file sono i conti. &kappname; supporta 5 tipi principali di conti: Attività, Passività, Entrate, Uscite e Patrimonio; ognuno dei quali può avere diversi sottotipi, &eg; Conto corrente, Carta di credito, &etc;. &kappname; include un conto «standard» per ognuno di questi cinque tipi, e tutti gli altri conti vengono subordinati a questi. &kappname; garantisce una maggiore coerenza (o meno flessibilità, in base al punto di vista) tra tipi di conto rispetto a GnuCash; le incoerenze rilevate durante l'importazione verranno corrette. Ciò può causare una struttura leggermente diversa dei conti, che può essere modificata, ragionevolmente, alla fine dell'importazione. </para>
</sect4>

<sect4>
<title
>Categorie</title>

<para
>&kappname; usa il termine Categoria per riferirsi a un conto di tipo Entrata o Uscita. A differenza di GnuCash, questi conti non sono considerati «libri mastri» e l'inserimento di cartelle di transazioni nelle categorie non è supportato; durante l'inserimento delle transazioni, vengono mappate in altri tipi di conto. </para>
</sect4>

<sect4>
<title
>Struttura e segnaposto</title>

<para
>GnuCash supporta l'utilizzo di conti Segnaposto. Di fatto, sono conti a sola lettura in cui non si possono inserire transazioni, ma funzionano in modo simile alle cartelle di una struttura, come contenitori di alti conti &kappname; non supporta questa funzione in modo nativo, ma fornisce le relazioni padre/figlio, quindi i segnaposto vengono simulati creando conti vuoti. </para>
</sect4>

<sect4>
<title
>Mappatura dei tipi di conto</title>

<informaltable frame='all'>
<tgroup cols='2' align='left' colsep='1' rowsep='1'>
<thead>
  <row>
    <entry
>Tipo di GnuCash</entry
><entry
>Tipo di &kappname;</entry>
  </row>
</thead>
<tbody>
  <row>
    <entry
>BANK</entry
><entry
>Checking</entry>
  </row>
  <row>
    <entry
>CHECKING</entry
><entry
>Checking</entry>
  </row>
  <row>
    <entry
>SAVINGS</entry
><entry
>Savings</entry>
  </row>
  <row>
    <entry
>ASSET</entry
><entry
>Asset</entry>
  </row>
  <row>
    <entry
>CASH</entry
><entry
>Cash</entry>
  </row>
  <row>
    <entry
>CURRENCY</entry
><entry
>Cash</entry>
  </row>
  <row>
    <entry
>MONEYMRKT</entry
><entry
>MoneyMarket</entry>
  </row>
  <row>
    <entry
>STOCK</entry
><entry
>Stock</entry>
  </row>
  <row>
    <entry
>MUTUAL</entry
><entry
>Stock</entry>
  </row>
  <row>
    <entry
>EQUITY</entry
><entry
>Equity</entry>
  </row>
  <row>
    <entry
>LIABILITY</entry
><entry
>Liability</entry>
  </row>
  <row>
    <entry
>CREDIT</entry
><entry
>CreditCard</entry>
  </row>
  <row>
    <entry
>INCOME</entry
><entry
>Income</entry>
  </row>
  <row>
    <entry
>EXPENSE</entry
><entry
>Expense</entry>
  </row>
  <row>
    <entry
>RECEIVABLE</entry
><entry
>Asset</entry>
  </row>
  <row>
    <entry
>PAYABLE</entry
><entry
>Liability</entry>
  </row>
</tbody>
</tgroup>
</informaltable>
</sect4>
</sect3>

<sect3>
<title
>Transazioni e suddivisioni</title>

<sect4>
<title
>Transazioni bilanciate</title>

<para
>Come in GnuCash, i dati sono inseriti sotto forma di transazioni, ognuna generalmente costituita da due o più parti. Di fatto, le transazioni valide di GnuCash contengono sempre almeno due parti, e per essere considerate valide devono essere bilanciate (cioè devono avere somma zero). &kappname; incoraggia a seguire questo schema, ma non obbliga a farlo; comunque, ogni transazione importata che non è bilanciata verrà segnalata nel registro come un problema. </para>
</sect4>

<sect4>
<title
>Beneficiari</title>

<para
>&kappname; preferisce che ogni transazione abbia un beneficiario (un termine generico usato per riferirsi sia ai beneficiari sia a chi paga), e, a differenza di GnuCash, ne viene mantenuto un elenco. I nomi dei Beneficiari sono generati durante l'importazione, utilizzando il campo Descrizione della transazione di GnuCash. </para>
</sect4>

<sect4>
<title
>Trasferimenti</title>

<para
>&kappname; usa il termine Trasferimenti per indicare una transazione che non riguarda una Categoria, ma trasferisce solo soldi tra conti di Entrate/Uscite. </para>
</sect4>

<sect4>
<title
>Riconciliazioni</title>

<para
>&kappname; fornisce una funzione per la riconciliazione dei conti, simile a quella di GnuCash; verrà importato lo stato corrispondente della transazione. </para>
</sect4>
</sect3>

<sect3>
<title
>Beni</title>

<para
>GnuCash usa il termine Bene per indicare sia i soldi sia i beni non monetari. Queste due cose sono separate in &kappname;. </para>

<sect4>
<title
>Valute</title>

<para
>&kappname; supporta nativamente tutte le <link linkend="details.currencies"
>valute</link
> straniere. &kappname; richiede anche di specificare una valuta di base, che verrà utilizzata in modo predefinito per i nuovi conti. Durante l'importazione verrà selezionata la valuta di base più probabile, comunque è possibile modificare questa scelta. </para>

<para
>(NOTA: &kappname; correntemente non supporta i conti in valute obsolete (a parte quelle sostituite dall'Euro). È necessario eliminare questi conti dal file GnuCash prima dell'importazione. Speriamo di migliorare questa situazione in una versione futura.) </para>
</sect4>

<sect4 id="gncsecurities">
<title
>Titoli e investimenti</title>

<para
>Le attività non monetarie (normalmente azioni e obbligazioni) vengono chiamate Titoli in &kappname; e rappresentano la differenza principale tra i due programmi, perché &kappname; richiede che i conti che contengono titoli facciano parte di conti di investimento. Questo aspetto è descritto in dettaglio nel capitolo sugli <link linkend="details.investments"
>Investimenti</link
>. Nonostante gli utenti possano usare questo tipo di relazione, GnuCash non la impone, quindi il processo di importazione non è in grado di rilevarla e convertirla in automatico. Per questa situazione vengono fornite tre possibilità: </para>

<itemizedlist>
  <listitem>
    <para
>creare un conto di investimento separato per ogni titolo, con lo stesso nome del titolo;</para>
  </listitem>

  <listitem>
    <para
>creare un unico conto di investimento che conterrà tutti i conti di titoli;</para>
  </listitem>

  <listitem>
    <para
>creare diversi conti di investimento e assegnare manualmente i titoli ai vari conti.</para>
  </listitem>
</itemizedlist>

<para
>Si può scegliere l'opzione desiderata in base a ciò che si vuole ottenere. In alcuni casi potrebbe essere necessaria una riorganizzazione manuale dei conti dopo l'importazione. </para>
</sect4>

<sect4>
<title
>Tassi di cambio e prezzi</title>

<para
>I prezzi dei titoli e i tassi di cambio delle valute verranno importati come vengono visualizzati nell'editor dei prezzi di GnuCash. Inoltre, verranno aggiunti i tassi di cambio relativi alle transazioni che riguardano titoli o che usano più valute diverse. </para>
</sect4>

<sect4 id="details.impexp.gncquotes">
<title
>Quotazioni in linea</title>

<para
>GnuCash usa un pacchetto chiamato Finance::Quote per ottenere le quotazioni dei prezzi e i tassi da Internet. Le versioni recenti di &kappname; supportano questo pacchetto per l'importazione delle quotazioni, e verrà usato in modo predefinito per i dati importati. Si può comunque decidere di passare al metodo nativo di &kappname;, che è spiegato in dettaglio nella sezione<link linkend="details.investments.onlinequotes"
>Quotazioni in linea</link
>. </para>

<para
>Se si fa questa scelta, la finestra seguente permetterà la selezione di una sorgente dei prezzi «nativa» per &kappname;, o una sorgente definita dall'utente, per ogni conto che ha bisogno di quotazioni in linea. Comunque, il simbolo di scambio verrà importato senza modificarlo, ma probabilmente sarà diverso nei due sistemi, quindi sarà da cambiare manualmente alla fine del processo di importazione. Gli aggiornamenti futuri delle quotazioni delle valute non useranno Finance::Quote, ma solo il metodo nativo. </para>

<para>
	<screenshot>
	<mediaobject>
	<imageobject>
	<imagedata fileref="gnucash-select_price_source.png" format="PNG"/>
	</imageobject>
	</mediaobject>
	</screenshot>
</para>
</sect4>
</sect3>

<sect3 id="gncschedules">
<title
>Transazioni pianificate</title>

<para
>&kappname; non mantiene la separazione fatta da GnuCash tra i modelli di transazione e la loro frequenza. I dati delle transazioni verranno duplicati se lo stesso modello viene usato in pianificazioni diverse, ma questo non è molto significativo. </para>

<sect4>
<title
>Tipi di pianificazione</title>

<para
>&kappname; classifica le pianificazioni in tre tipi: Bollette, Depositi e Trasferimenti. GnuCash non fa questa distinzione, quindi durante l'importazione &kappname; cerca di risalire al tipo corretto dai conti e dalla direzione dei movimenti. In alcuni casi potrebbe essere selezionato un tipo errato, ed è necessaria una correzione manuale. </para>
</sect4>

<sect4>
<title
>Pianificazioni sospette</title>

<para
>Alcune funzionalità delle transazioni pianificate di GnuCash non sono disponibili in &kappname;, quindi durante l'importazione vengono fatte dei piccoli compromessi per convertire i dati. Queste transazioni verranno segnalate come sospette, e l'utente potrà modificarle direttamente durante il processo di importazione. Alcuni esempi di situazioni che potrebbero causare questo: </para>

<itemizedlist>
  <listitem>
    <para
>alcuni intervalli di frequenza supportati in GnuCash non sono correntemente disponibili in &kappname;</para>
  </listitem>

  <listitem>
    <para
>&kappname; non supporta l'utilizzo delle formule e delle variabili nei campi importo</para>
  </listitem>

  <listitem>
    <para
>casi complessi di importazione che non sono ancora stati identificati.</para>
  </listitem>
</itemizedlist>

<para
>Nonostante gli sforzi è possibile che, dato il grande numero di opzioni in gioco, una transazione pianificata potrebbe causare un errore fatale in &kappname;. Se questo avviene, si può decidere di eliminare tutte le pianificazioni sospette durante l'importazione. </para>
</sect4>
</sect3>

<sect3>
<title
>Report</title>

<para
>&kappname; fornisce molti possibili report configurabili, descritti in dettaglio in <link linkend="details.reports"
>Report</link
>. Nonostante questo, potrebbero non corrispondere in modo preciso ai report disponibili in GnuCash. </para>
</sect3>
</sect2>

<sect2>
<title
>Selezione delle impostazioni di importazione</title>

<para id="details.impexp.gncoptions">
	<screenshot>
	<mediaobject>
	<imageobject>
	<imagedata fileref="gnucash-import_options.png" format="PNG"/>
	</imageobject>
	</mediaobject>
	</screenshot>
</para>

<sect3>
<title
>Gestione degli investimenti</title>

<para
>Vedere «<link linkend="gncsecurities"
>Titoli e investimenti</link
>» sopra. </para>
</sect3>

<sect3>
<title
>Quotazioni in linea</title>

<para
>Disabilitare questa caratteristica se si vuole usare il modo nativo per ottenere le quotazioni in linea future. </para>

<para
>Vedere <link linkend="details.impexp.gncquotes"
>«Quotazioni in linea»</link
> sopra. </para>
</sect3>

<sect3>
<title
>Transazioni pianificate</title>

<para
>Vedere <link linkend="gncschedules"
>«Transazioni pianificate»</link
> sopra. </para>
</sect3>

<sect3>
<title
>Opzioni di decodifica</title>

<para
>Se la tua lingua nativa viene scritta usando lettere o simboli diversi da quelli delle lingue «latine» (cioè, generalmente, quelle dell'Europa occidentale), queste verranno rappresentate in modo speciale («codificate») nel file GnuCash. Se queste lettere non sono visualizzate correttamente, devono essere decodificate. Attualmente, spesso non è possibile rilevare accuratamente il tipo di decodifica da usare, quindi a volte si deve abilitare questa opzione e selezionare un elemento di una lista. In generale, il primo elemento della lista sarà quello considerato più appropriato (in base al Paese e alla lingua selezionata come nativa durante l'installazione del sistema operativo), quindi per prima cosa è bene provare questa opzione. Dato che il processo di importazione non modifica il file GnuCash, si possono sperimentare liberamente diverse opzioni. </para>
</sect3>

<sect3>
<title
>Opzioni sulle note delle transazioni</title>

<para
>In certe situazioni, delle transazioni non divise di GnuCash possono contenere promemoria residui, spesso errati, che normalmente non sono visibili all'utente. Quando queste transazioni vengono importate in &kappname;, invece, questi messaggi possono diventare visibili a causa di differenze nella visualizzazione. Spesso queste transazioni hanno un campo Note che descrive il vero scopo della transazione. Se si seleziona questa opzione verranno usate queste note, se presenti, al posto dei dati errati nel campo Promemoria. </para>
</sect3>

<sect3>
<title
>Opzioni di debug</title>

<para
>Queste opzioni devono essere usate solo in caso di problemi di importazione. Se si hanno questi problemi, comunque, bisognerebbe anche segnalarli alla mailing-list degli sviluppatori di &kappname;: &devlist;. Notare che le tracce generate da queste opzioni potrebbero contenere dati confidenziali, e si dovrebbe usare l'opzione per renderli anonimi prima di rendere pubblici questi dati. </para>
</sect3>
</sect2>

<sect2>
<title
>Riepilogo dell'importazione</title>

<para
>Alla fine del processo di importazione viene visualizzato un riepilogo con il numero di transazioni processate e il numero di errori o anomalie riscontrate. Questo riepilogo può essere visualizzato, ma anche salvato su un file per rivederlo in seguito. Un riepilogo completo può contenere le seguenti sezioni: </para>

<itemizedlist>
  <listitem>
    <para
>Numero dei record</para>
  </listitem>

  <listitem>
    <para
>Inconsistenze nei tipi dei conti e relative correzioni</para>
  </listitem>

  <listitem>
    <para
>Dettagli sulle pianificazioni sospette</para>
  </listitem>
</itemizedlist>

<para>
	<screenshot>
	<mediaobject>
	<imageobject>
	<imagedata fileref="gnucash-report.png" format="PNG"/>
	</imageobject>
	</mediaobject>
	</screenshot>
</para>
</sect2>
</sect1>

<sect1 id="details.impexp.qifimp">
<sect1info>
  <author
>&Thomas.Baumgart; &Thomas.Baumgart.mail;</author>
</sect1info>

<title
>Importazione QIF</title>

<sect2>
<title
>Il formato QIF è pericoloso</title>

<para
>In condizioni normali, si dovrebbe evitare il più possibile di usare il formato QIF. Non è un buon formato per la memorizzazione di dati finanziari. Questi sono solo alcuni dei problemi di questo formato: </para>

<itemizedlist>
  <listitem>
    <para
>Mancanza di formato standard: versioni diverse dello stesso programma interpretano in modo diverso lo stesso elemento.</para>
  </listitem>

  <listitem>
    <para
>Mancanza di un identificatore delle transazioni: non essendoci un codice univoco (ID) associato ad ogni transazione, le transazioni duplicate vengono associate a caso, nella migliore delle ipotesi.</para>
  </listitem>

  <listitem>
    <para
>Mancanza di espressività: la sintassi è molto semplice e non supporta tutte le informazioni offerte dai programmi odierni di gestione delle finanze.</para>
  </listitem>
</itemizedlist>

<para
>Questi sono i motivi principali per cui Intuit ha smesso di supportare il formato QIF a partire dalla versione di Quicken del 2005. Se si ha la possibilità di ottenere i dati in un altro formato, come OFX, evitare sempre di usare QIF. </para>
</sect2>

<sect2>
<title
>Come importare un file QIF</title>

<para
>Per importare un file QIF, per prima cosa assicurarsi di avere aperto un file valido di &kappname;. Poi selezionare <menuchoice
><guimenuitem
>Importa</guimenuitem
> <guimenuitem
>QIF...</guimenuitem
></menuchoice
> dal menu <guimenu
>File</guimenu
>. </para>
	
<para>
	<screenshot>
	<mediaobject>
	<imageobject>
	<imagedata fileref="qifopen.png" format="PNG"/>
	</imageobject>
	</mediaobject>
	</screenshot>
</para>

<para
>Si aprirà una finestra che chiede il nome del file QIF e permette di specificare il percorso del file facendo clic sul pulsante <guibutton
>Sfoglia</guibutton
>. </para>

<para
>Inoltre, &kappname; distingue l'importazione di un estratto conto dai dati storici esportati da un'altra applicazione. L'impostazione predefinita prevede l'importazione di un estratto conto. Se si stanno importando dati da un altro programma di gestione delle finanze, selezionare l'opzione relativa. </para>

<para
>In generale, il profilo QIF predefinito dovrebbe andare bene con i tuoi dati QIF. In certi casi è necessario usare un profilo QIF modificato. Vedere la <link linkend="details.impexp.qifimp.profile"
>prossima sezione</link
> per maggiori informazioni. </para>

<para
>Fare clic su <guibutton
>Importa</guibutton
> per importare il file QIF. </para>

<para
>&kappname; inizierà la scansione del file per determinare il formato utilizzato per la rappresentazione di date e numeri. Se non riesce a determinarlo con sicurezza, verrà chiesto all'utente di selezionarlo tra una lista di possibili candidati. </para>

<para
>Poi, &kappname; importa i dati e crea gli oggetti necessari, come le informazioni sui beneficiari, i conti, le categorie e le quotazioni. Quando possibile, verranno fatte corrispondere le transazioni esistenti con quelle importate. Viene visualizzata una barra di avanzamento per visualizzare il progresso dell'importazione. </para>

<para
>Se &kappname; non riesce a rilevare il nome del conto da importare, verrà chiesto all'utente di selezionare il conto in cui importare i dati. Se il conto non esiste, può essere creato facendo clic su <guibutton
>Crea</guibutton
>. </para>

<para
>Alla fine del processo di importazione, &kappname; visualizzerà una finestra di riepilogo dell'estratto conto. </para>

<para>
<screenshot>
	<screeninfo
>Riepilogo dell'estratto</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="qif_report.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Riepilogo dell'estratto</phrase>
	</textobject>
	</mediaobject>
</screenshot>
</para>

<para
>Dopo l'importazione, le transazioni importate verranno visualizzate con uno sfondo giallo nella vista Registri. Se &kappname; è riuscito ad abbinare una transazione importata con una esistente, lo sfondo della transazione sarà verde. </para>

<para
>Il prossimo passo consiste nella verifica dei dati importati e nella loro conferma. Questa parte è comune anche agli altri tipi di importazione e viene spiegata in dettaglio in un'altra sezione. </para>

<note>
<para
>I colori usati per segnalare le transazioni importate e abbinate possono essere personalizzati, e potrebbero essere diversi nel sistema in uso. </para>
</note>
</sect2>

<!--
<sect2>
<title
>Accepting the imported transactions</title>
<para>
  
	When &kappname; has finished importing the QIF transactions the account will be shown with the imported transactions listed in Yellow.
</para>

<para>
<screenshot>
	<screeninfo
>Imported transactions</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="qifimportverify.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Imported transactions</phrase>
	</textobject>
	</mediaobject>
</screenshot>
</para>

<para>
	Some of your transactions may be flashing red in the ledger.  
	This is because they need to be assigned a category.  
	The importer was not able to automatically assign a category based on your past transaction history.
</para>

<para
>	
	Transaction data can be edited or even deleted if needed.  To edit a transaction simply double click on the entry or hit enter when the entry is highlighted.  Once finished click on <guibutton
>OK</guibutton
> to accept the imported transactions or <guibutton
>Cancel</guibutton
> to remove the imported transactions.
</para>

</sect2>

<sect2
><title
>Importing Investments</title>

<para>
	Please note that if you are importing a file with investment transactions, those investments must first exist in your &kappname; file.
	The trading symbol is used to match, so please ensure that the symbol in &kappname; is exactly the same as the one in the file you're importing.
</para>
</sect2>
-->

<sect2 id="details.impexp.qifimp.profile">
<title
>Impostazione di un profilo QIF</title>

<para
>Non essendoci uno standard universalmente riconosciuto per i file QIF, i vari produttori si sono presi la libertà di introdurre leggere modifiche. Il profilo QIF permette di indicare a &kappname; le particolarità del tuo file. Per modificare un profilo QIF esistente, o per crearne uno nuovo, premere il pulsante <guibutton
>Nuovo</guibutton
> nella finestra di importazione QIF, vicino al selettore dei profili. </para>

<para>
	<screenshot>
	<mediaobject>
	<imageobject>
	<imagedata fileref="qifimport-qifprofileeditor.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Editor del profilo QIF</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<note>
<para
>Le versioni precedenti di &kappname; avevano una scheda per la specifica della data e dell'importo. Adesso queste impostazioni vengono determinate automaticamente da &kappname;, scansionando il file. Se il programma non riesce a determinarle, le chiederà all'utente durante l'importazione. </para>
</note>
<!--
<para>
	The most commonly changed thing between QIF implementations is the date format.  
	So if this is the first time you're importing a QIF file, spend a few moments to figure out what format the dates are in, and set the QIF Profile accordingly.  
	See the discussion below on apostrophe format for more details.
</para>

<para>
	<screenshot>
	<mediaobject>
	<imageobject>
	<imagedata fileref="qifimport-qifprofiledate.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>QIF Profile Date</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

</sect2>

<sect2
><title
>Apostrophe format</title>

<para>
	Many common QIF writers use a 2-digit representation for the year. 
	This is ambiguous, because the importer cannot know which century the date belongs in.
	To make things even more complicated, QIF files will often used an apostrophe as a year separator to indicate that the date belongs in the OTHER century from the default.
</para>
<para>
	For example, if the default century is 1900-1999, the date 12/31/95 would mean 1995.  The date 12/31'05 would mean 2005.
</para>
<para>
	Because the QIF format is not standardized, it's impossible to know which century is desired.
	This is why you have to explicitly state it in the QIF profile.
	You do this by specifying which century is intended when an apostrophe is found.
	In the example above, you would set the Apostrophe Format to &quot;2000-2099&quot;, so dates with an apostrophe will be interpreted as being &gt; year 2000.
	In this case, dates without an apostrophe will be treated as being in the 1900's.
</para>
-->
</sect2>

<sect2
><title
>Abbinamento delle transazioni</title>

<para
>Come si faceva notare prima, uno dei punti deboli del formato QIF è la mancanza di un'identificatore univoco per le transazioni. Quindi se si importa un file QIF e alcune delle transazioni sono già nel registro, si otterranno dei duplicati. &kappname; cerca di evitare questa situazione cercando transazioni simili a quelle che si hanno già. Se trova una possibile corrispondenza, abbina le transazioni simili. </para>

<para
>Questo può dare problemi se si hanno transazioni simili ma diverse. In questo caso, è possibile rimuovere l'abbinamento tra le transazioni nella vista del Registro. </para>
</sect2>

<sect2>
<title
>Scrittura di un filtro di importazione</title>

<para
>A volte si hanno dati in un formato personalizzato, come valori separati da virgola (CSV) o altri formati non standard. A partire dalla versione 4.6, &kappname; include un'estensione di importazione di CSV, ma è comunque possibile importare altri tipi di file in &kappname; utilizzando un filtro di importazione QIF. Un filtro è un programma scritto a questo scopo, che prende in ingresso il file che si ha e restituisce come risultato un file QIF. Questo filtro può essere uno script della shell, uno script perl, un programma compilato scritto in C/C++ o qualsiasi altro programma immaginabile che possa essere eseguito sul tuo sistema. </para>

<para
>Per usare i filtro, modificare il profilo QIF preferito e selezionare la scheda Filtro. Inserire il percorso al programma filtro quando richiesto. Poi, ad ogni importazione che usa questo profilo, il file importato verrà prima processato con il filtro fornito. </para>

<para
>Un problema comune è la conversione di una lista di valori separati da virgola in un file QIF. Questo è un tipico caso d'uso del programma awk. Creare uno script chiamato da_csv_a_qif.awk, contenente le seguenti due righe: </para>

<programlisting
>BEGIN { FS=&quot;,&quot;; print &quot;!Type:Bank&quot; }

        { print &quot;D&quot;$1; print &quot;T&quot;$2; print &quot;N&quot;$3; print &quot;P&quot;$4; print &quot;M&quot;$5; print &quot;^&quot; }
</programlisting>

<para
>Poi, cambiare le chiavi QIF (D, T, N, P e M) per farle corrispondere all'ordine dei dati nel file CSV. Impostare il filtro di ingresso a <userinput
>awk -f da_csv_a_qif.awk</userinput
>. </para>

<para
>Un altro problema comune è la codifica dei file QIF. &kappname; si aspetta che siano codificati in UTF-8. Se il tuo file usa una codifica differente, può essere utile convertirlo prima in UTF-8. Ad esempio, per convertire un file con la codifica iso-8859-1, il filtro di ingresso deve essere impostato a <userinput
>recode iso-8859-1..utf-8</userinput
>. </para>

</sect2>
<sect2>
<title
>Estensioni speciali di &kappname; per QIF</title>

<para
>Come già detto sopra, uno dei problemi principali di QIF è la mancanza di un identificatore univoco per le transazioni. Se si sta scrivendo un programma per la creazione di file QIF (o un filtro, come descritto sopra), è possibile rimediare a questo problema. &kappname; supporta il campo «#». Il processo di importazione interpreterà il contenuto di questo campo come un identificatore univoco della transazione e la scarterà se è già presente. </para>
</sect2>
</sect1>

<sect1 id="details.impexp.qifexp">
<title
>Modulo di esportazione QIF</title>
<para
>Per esportare uno dei conti in un file QIF, scegliere la funzione <menuchoice
><guimenuitem
>Esporta</guimenuitem
> <guimenuitem
>QIF</guimenuitem
></menuchoice
> dal menu <guimenu
>File</guimenu
>. Verrà chiesto il conto da esportare, il file in cui esportare e il profilo QIF da utilizzare. </para>

<note
><para
>Al momento, non è possibile esportare gli investimenti in QIF. </para
></note>

<para>
	<screenshot>
	<mediaobject>
	<imageobject>
	<imagedata fileref="qifimport-export.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Esportazione QIF</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>
</sect1>

<sect1 id="details.impexp.ofx">
<sect1info>
  <author
>&Ace.Jones; &Ace.Jones.mail;</author>
  <author
>&Thomas.Baumgart; &Thomas.Baumgart.mail;</author>
</sect1info>
<title
>Estensione per l'importazione da OFX</title>

<sect2>
<title
>Come ottenere l'estensione</title>

<para
>&kappname; è in grado di importare i file OFX senza problemi. Comunque, questa funzionalità non fa parte del programma principale. È necessario ottenere e installare l'estensione per l'importazione da OFX. Una volta che la si è installata, verrà visualizzato automaticamente il comando per l'importazione dei file OFX, nel menu <menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Importa</guimenuitem
></menuchoice
>. </para>

<para
>Notare che in molte versioni pacchettizzate di &kappname; l'estensione per l'importazione OFX è già presente, nello stesso pacchetto o in un pacchetto separato. Se l'estensione per l'importazione OFX non risulta installata, il primo posto in cui guardare è la fonte da cui si è ottenuto il pacchetto base di &kappname;. </para>

<para
>Se si è installato il programma da un pacchetto RPM, l'estensione per l'importazione da OFX è contenuta nel pacchetto kmymoney-ofx. Dovrebbe essere disponibile dalla stessa fonte dalla quale si è ottenuto il pacchetto base di &kappname;. Se si è compilato &kappname; dai sorgenti, basta avere installati sul sistema gli header e le librerie di libOFX, preferibilmente la versione 0.9. Il processo di compilazione di &kappname; li rileverà e compilerà anche l'estensione. Al momento del rilascio di &kappname; 4.6, l'ultima versione di libofx era la 0.9.4, che è anche la versione minima richiesta. </para>

<para
>Se si hanno dei problemi nella compilazione di &kappname; e si vuole essere certi di avere installato la versione corretta di libOFX, contattare gli sviluppatori alla mailing-list &devlist; per ricevere assistenza. Includere una copia del file config.log, compressa con gzip. </para>
</sect2>

<sect2>
<title
>Cos'è OFX</title>

<para
>OFX sta per <quote
>Open Financial Exchange</quote
>. In base al <ulink url="http://www.ofx.net/"
>sito web di OFX</ulink
>, <quote
>Open Financial Exchange (OFX) è una specifica unificata per lo scambio elettronico di dati finanziari tra istituti finanziari, aziende e consumatori tramite Internet. OFX non è un'istituzione finanziaria.</quote
> La specifica definisce i formati per trasferire dati finanziari tramite file e scambio diretto. </para>

<para
>Nonostante lo standard sia molto più completo e affidabile di QIF, ci sono ancora variazioni, in base alla specifica implementazione utilizzata da ciascun istituto. I file di OFX potrebbero avere un'estensione <quote
>OFX</quote
> o <quote
>QFX</quote
> (maiuscolo o minuscolo); ciò non implica particolari differenze nel contenuto. La specifica è basata su XML,  perciò i file possono essere letti in un editor di testo, ma poiché gli spazi bianchi non sono rilevanti per il contenuto stesso, alcune implementazioni non ne utilizzano alcuno, rendendo molto difficile la loro lettura. </para>

<para
>Un altro sito con buone informazioni è <ulink url="http:/ofxhome.com/"
>OFX Home</ulink
>. Gestisce un elenco di istituti finanziari che supportano OFX. Ciò può essere utile se si hanno problemi a configurare la<link linkend="details.impexp.ofxdirectconnect"
>connessione diretta a OFX</link
>. Ha inoltre un forum per le discussioni relative a problemi con OFX. </para>
</sect2>

<sect2>
<title
>Importazione di un file OFX</title>

<para
>Il modo più semplice di importare un file OFX è selezionare il modulo di importazione dalla barra dei menu. Dal menu <guimenu
>File</guimenu
>, scegliere <guimenuitem
>Importa</guimenuitem
> e poi <guimenuitem
>OFX...</guimenuitem
>. Se non è presente la voce OFX nel sottomenu Importa, l'estensione di importazione da OFX non è installata correttamente. Vedere la sezione precedente. </para>

<para
>La prima cosa che verrà richiesta dal processo di importazione è il conto in cui importare le transazioni. Se il tuo file contiene transazioni di più conti, questa richiesta verrà fatta più volte. </para>

<para
>Dopo l'importazione, alcune delle transazioni potrebbero essere marcate nel registro con un simbolo «!» o un triangolo giallo. Questo perché hanno bisogno di una categoria assegnata. Il processo di importazione non è stato in grado di associare automaticamente una categoria utilizzando lo storico delle transazioni. Si può modificare ogni singola transazione nel registro, assegnando una categoria, e la transazione non sarà più marcata in questo modo. </para>

<para
>Notare che questa sezione descrive l'importazione <quote
>nativa</quote
> da OFX. È possibile anche importare i file OFX usando l'estensione di importazione AqBanking se è installata. I due processi di importazione si comportano in modo leggermente diverso, e sono scritti e supportati da sviluppatori differenti. </para>
</sect2>

<sect2>
<title
>Importazione degli investimenti</title>

<para
>Notare che se si importa un file che contiene transazioni di investimento, questi investimenti devono già esistere nel tuo file di &kappname;. Per abbinare gli investimenti viene usato il simbolo di scambio, quindi assicurarsi che il simbolo di scambio usato in &kappname; sia esattamente uguale a quello usato nel file che si sta importando. </para>
</sect2>

<sect2 id="details.impexp.webconnect">
<title
>Connessione al Web</title>

<para
>Il modo più semplice di importare un file OFX è di configurare Web Connect. Visitare il sito della propria banca, e fare clic sul collegamento che permette di scaricare il file OFX. Il browser dovrebbe chiedere il programma con cui aprire il file: scegliere &kappname;. Il file OFX scaricato verrà importato nell'ultimo file aperto in &kappname;. È possibile inoltre cambiare le associazioni dei file per l'ambiente desktop in uso, in modo da impostare &kappname; per l'apertura automatica dei file OFX. </para>

<para
>Se si ha bisogno di importare il file OFX in qualche altro file di &kappname;, caricare quel file in &kappname; prima di visitare il sito della banca. </para>
</sect2>

<sect2 id="details.impexp.ofxdirectconnect">
<title
>Connessione diretta</title>

<para
>Adesso &kappname; supporta anche la connessione diretta per ottenere i file OFX. Questo permette di ottenere gli estratti conto direttamente dalla banca. In futuro questa funzione sarà spiegata più in dettaglio e spostata in una sezione a parte. </para>

<para
>Per abilitare questa funzione, è necessario compilare &kappname; con l'opzione --enable-ofxbanking (adesso è diventata un'opzione predefinita). </para>

<para
>Attenzione: molte banche hanno bisogno di un accesso separato, danno una password o un PIN diverso, e potrebbero anche far pagare una commissione per questo servizio. Nessuna banca supporta direttamente &kappname;. Bisogna dire loro che si vuole importare direttamente da MS Money o Quicken. </para>

<para
>Il primo passo consiste nella configurazione di ogni conto per cui si vuole scaricare l'estratto. Andare nella vista Conti, fare clic con il &RMB; sul conto che si vuole configurare e scegliere <guimenuitem
>Mappa ad un conto in linea...</guimenuitem
>. Se è installata più di una estensione per l'online banking, verrà chiesto quale utilizzare. Per il modulo OFX interno, scegliere <guimenuitem
>KMyMoney OFX</guimenuitem
>. Verrà scaricata da Internet una lista di banche, e una procedura guidata permetterà di scegliere una banca, inserire nome utente e password e selezionare un conto. Se la propria banca non è nell'elenco, si può provare ad usare l'opzione manuale. La banca potrebbe essere in grado di fornire i parametri richiesti, o potrebbe essere necessaria qualche ricerca per reperirli. </para>

<note>
  <para
>La configurazione di OFX Direct Connect può, in alcuni casi, non essere banale, specialmente quando l'implementazione da parte degli istituti non fornisce dettagli sufficienti nei messaggi di errore. Un problema particolare da tener presente è costituito dal fatto che molti istituti richiedono un cambio della password al primo accesso in linea utilizzando questo metodo. Sfortunatamente, al momento, la libreria che &kappname; utilizza (libofx) non può cambiare la password in modo interattivo. In alcuni casi, è possibile ottenere supporto tecnico dall'istituto per cambiare la propria password. Fino a quando potremo espandere questa sezione con altre informazioni dettagliate per l'individuazione dei problemi, se si riscontrano problemi nella configurazione, sarà possibile chiedere aiuto sulla lista di distribuzione &devlist; degli sviluppatori di &kappname;. </para>
</note>

<para
>Una volta impostato un conto per l'online banking, visualizzare registro di quel conto. Dal menu <guimenu
>Conto</guimenu
> selezionare <guimenuitem
>Aggiorna conto...</guimenuitem
>. Il programma si connetterà alla tua banca e scaricherà l'estratto conto relativo agli ultimi 60 giorni. </para>

<note>
  <para
>Nelle versioni di &kappname; precedenti la 4.6, il nome del beneficiario veniva preso sempre dal campo PAYEEID. A partire dalla versione 4.6, il nome del beneficiario può essere basato sul campo PAYEEID, NAME o MEMO nella transazione OFX. Puoi configurare questa funzionalità e altre impostazioni di OFX Direct Connect selezionando la scheda appropriata nella finestra <link linkend="details.accounts.edit"
>Modifica conto</link
>. </para>
</note>
</sect2>

<sect2>
<title
>Esportazione in un file OFX</title>

<para
>Attualmente, non è possibile esportare nel formato OFX. Se si è interessati a contribuire in questo aspetto, contattare la squadra di sviluppo di libOFX per maggiori informazioni. </para>
</sect2>
</sect1>
&details-impexp-csv; <sect1 id="details.impexp.plugins">
<title
>Scrittura di estensioni di importazione</title>

<para
>&kappname; contiene un supporto esplicito alle estensioni di importazione. Se si usa un formato personalizzato e si vuole scrivere un'estensione di importazione, il tuo contributo sarà apprezzato. Per fare questo, è necessario compilare il programma dai sorgenti. Poi usare come esempio l'estensione di importazione da OFX. </para>
</sect1>
</chapter>
