<?xml version="1.0" encoding="UTF-8"?>
<chapter id="details.impexp">
<chapterinfo>
  <authorgroup>
    <author
>&Ace.Jones; &Ace.Jones.mail; </author>
  </authorgroup>
  <date
>25 липня 2017 року</date>
  <releaseinfo
>4.8.1</releaseinfo>
</chapterinfo>

<title
>Імпортування та експортування</title>

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

<title
>Інструмент імпортування GnuCash</title>

<sect2>
<title
>Файли GnuCash</title>

<para
>Інструмент імпортування &kappname; з GnuCash виконує безпосереднє читання стандартних файлів (&XML;), створених за допомогою GnuCash версій 1.8 і 2.0. Не підтримуються такі можливості: </para>

<itemizedlist>
  <listitem
><para
>імпортування бази даних (Postgres)</para
></listitem>
  <listitem
><para
>імпортування файлів «багатотомної» книги</para
></listitem>
  <listitem
><para
>імпортування до існуючого файла &kappname;</para
></listitem>
  <listitem
><para
>імпортування даних малого бізнесу (працівники, інвойси тощо)</para
></listitem>
  <listitem
><para
>експортування до файлів GnuCash.</para
></listitem>
</itemizedlist>

<para
>Ймовірно, імпортування відбудеться належним чином, лише якщо надано коректний файл. Рекомендуємо вам виконати операцію <guimenuitem
>Перевірити і виправити все</guimenuitem
> у GnuCash (з меню <guimenu
>Дії</guimenu
>), перш ніж виконувати імпортування. </para>

<para
>Файли можна відкривати за допомогою визначення файла у командному рядку (<command
>kmymoney &lt;шлях_до_файла&gt;</command
>) або за допомогою пунктів меню &kappname; <menuchoice
> <shortcut
> <keycombo
>&Ctrl;<keycap
>O</keycap
></keycombo
></shortcut
> <guimenu
>Файл</guimenu
> <guimenuitem
>Відкрити</guimenuitem
> </menuchoice
> та <menuchoice
> <guimenu
>Файл</guimenu
> <guimenuitem
>Імпортувати</guimenuitem
> </menuchoice
>. </para>

<para
>Подібність між двома програмними продуктами означає можливість імпортування більшості даних, з якими має справу типовий користувач, у простий і прозорий спосіб. Але існують певні області застосування програм, у яких виникають відмінності. Існує декілька способів обійти такі відмінності. У наступних розділах ми опишемо деякі з цих відмінностей та спробуємо зрозуміти, як можна імпортувати дані якнайточніше. </para>
</sect2>

<sect2>
<title
>Подібності, відмінності і термінологія</title>

<sect3>
<title
>Використання у малому бізнесі</title>

<para
>Слід зауважити, що &kappname; є інструментом керування <emphasis
>особистими</emphasis
> фінансами, а отже, не підтримує напряму будь-яких з бізнес-можливостей GnuCash, зокрема податкових таблиць, створення платіжних відомостей та стеження за лотами. Всі рахунки відрахування або отримання платежів буде імпортовано як рахунки пасивів та активів, відповідно. </para>
</sect3>

<sect3>
<title
>Рахунки</title>

<sect4>
<title
>Типи рахунків</title>

<para
>У обох програмних продуктах найвищим рівнем структури у файлах є рахунок. У &kappname; передбачено підтримку 5 основних типів рахунків: актив, пасив, прибутки, витрати і маржа, кожен з яких має різноманітні підтипи, наприклад чековий, кредитний тощо. У &kappname; для кожного з цих п’яти типів існує «стандартний» рахунок: всі інші рахунки є похідними одного з цих типів. У &kappname; підтримується послідовніший (або менш гнучкий, залежно від точки зору) підхід до розрізнення типів рахунків, ніж у GnuCash. Інструмент імпортування виправляє всі помічені непослідовності. Подібне виправлення може призвести до відхилень у структурі рахунку, але все це можна виправити після завершення імпортування. </para>
</sect4>

<sect4>
<title
>Категорії</title>

<para
>У &kappname; термін «категорія» використовується для позначення належності рахунку до типу прибутків чи витрат. На відміну від GnuCash, категорії не вважаються рахунками «облікових книг», отже запис операцій безпосередньо до тек не підтримується: під час запису операції виконується призначення до рахунків інших типів. </para>
</sect4>

<sect4>
<title
>Структура і заповнювачі</title>

<para
>У GnuCash передбачено підтримку використання рахунків-заповнювачів. За суттю це просто призначені лише для читання рахунки, до яких не можна записувати операції, але які виконують роль, подібну до тек у структурі тек, тобто містять інші рахунки. Хоча у &kappname; і не передбачено безпосередньої підтримки подібної можливості, можливе створення відношення підлеглості, отже інструмент імпортування імітуватиме заповнювачі створенням порожніх рахунків. </para>
</sect4>

<sect4>
<title
>Карта типів ресурсів</title>

<informaltable frame='all'>
<tgroup cols='2' align='left' colsep='1' rowsep='1'>
<thead>
  <row>
    <entry
>Тип GnuCash</entry
><entry
>Тип &kappname;</entry>
  </row>
</thead>
<tbody>
  <row>
    <entry
>BANK</entry
><entry
>Чековий</entry>
  </row>
  <row>
    <entry
>CHECKING</entry
><entry
>Чековий</entry>
  </row>
  <row>
    <entry
>SAVINGS</entry
><entry
>Ощадний</entry>
  </row>
  <row>
    <entry
>ASSET</entry
><entry
>Активи</entry>
  </row>
  <row>
    <entry
>CASH</entry
><entry
>Готівка</entry>
  </row>
  <row>
    <entry
>CURRENCY</entry
><entry
>Готівка</entry>
  </row>
  <row>
    <entry
>MONEYMRKT</entry
><entry
>MoneyMarket</entry>
  </row>
  <row>
    <entry
>STOCK</entry
><entry
>Капітал</entry>
  </row>
  <row>
    <entry
>MUTUAL</entry
><entry
>Капітал</entry>
  </row>
  <row>
    <entry
>Маржа</entry
><entry
>Маржа</entry>
  </row>
  <row>
    <entry
>LIABILITY</entry
><entry
>Пасиви</entry>
  </row>
  <row>
    <entry
>CREDIT</entry
><entry
>Кредитна картка</entry>
  </row>
  <row>
    <entry
>INCOME</entry
><entry
>Прибуток</entry>
  </row>
  <row>
    <entry
>EXPENSE</entry
><entry
>Витрата</entry>
  </row>
  <row>
    <entry
>RECEIVABLE</entry
><entry
>Активи</entry>
  </row>
  <row>
    <entry
>PAYABLE</entry
><entry
>Пасиви</entry>
  </row>
</tbody>
</tgroup>
</informaltable>
</sect4>
</sect3>

<sect3>
<title
>Операції і дроблення</title>

<sect4>
<title
>Збалансовані операції</title>

<para
>Як і у GnuCash, дані вводяться у формі операцій, кожна з яких, загалом кажучи, складається з 2 або більшої кількості записів дроблення. Фактично, коректні операції GnuCash завжди складаються з принаймні 2 дроблень. Щоб підтримувати стандарт облікових книг з подвійним записом GnuCash, ці дроблення мають бути збалансованими (тобто у сумі давати нуль). У &kappname; також підтримується цей стандарт, який, втім, не є обов’язковим, але всі імпортовані записи операцій, які не буде збалансовано, програма позначить у обліковій книзі як такі, що мають проблеми. </para>
</sect4>

<sect4>
<title
>Отримувачі</title>

<para
>У &kappname; бажано, щоб у всіх операцій був отримувач (загальний термін, який визначає як платників, так і отримувачів платежів). На відміну від GnuCash, програма спостерігає за списком цих отримувачів. Назви або імена отримувачів створюються інструментом імпортування на основі даних поля опису операції GnuCash. </para>
</sect4>

<sect4>
<title
>Трансферти</title>

<para
>У &kappname; терміном «трансферт» позначається операція, за якої гроші не переходять з одної категорії до іншої, а лише пересуваються між рахунками активів і/або пасивів. </para>
</sect4>

<sect4>
<title
>Узгодити</title>

<para
>У &kappname; передбачено функціональну можливість узгодження рахунку, подібну до можливості у GnuCash, отже буде імпортовано відповідні позначки стану операцій. </para>
</sect4>
</sect3>

<sect3>
<title
>Доходи</title>

<para
>У GnuCash термін «власність» використовується для позначення грошових та негрошових активів. У &kappname; для кожного з цих активів використовується власний термін. </para>

<sect4>
<title
>Валюти</title>

<para
>У &kappname; передбачено підтримку всіх типів іноземних <link linkend="details.currencies"
>валют</link
>. Крім того, &kappname; вимагає від користувача визначення основної (базової) валюти, яка буде типовою валютою нових облікових записів. Інструмент імпортування спробує визначити найімовірнішу базову валюту, хоча цей вибір і може бути відхилено на користь альтернативної валюти. </para>

<para
>(ЗАУВАЖЕННЯ: у поточній версії &kappname; не передбачено підтримки рахунків у вилучених з обігу валютах (окрім валют, замінених на євро). Для роботи у поточній версії програми вам потрібно вилучити всі такі рахунки з файла GnuCash до імпортування. Розробники сподіваються усунути цю незручність у майбутніх випусках програми.) </para>
</sect4>

<sect4 id="gncsecurities">
<title
>Цінні папери та інвестиції</title>

<para
>Негрошові активи (зазвичай, акції та облігації) у &kappname; називаються цінними паперами. У обробці цих активів полягає основна відмінність між двома програмними продуктами. У &kappname; всі рахунки у цінних паперах мають бути підлеглими рахунками інвестиційного рахунку. Докладніше про це можна дізнатися з глави, присвяченої <link linkend="details.investments"
>інвестиціям</link
>. Хоча користувач і може встановити подібне відношення між рахунками, сама програма GnuCash не визначає подібної структури, отже інструменту імпортування не вдасться виявити подібні рахунки і виконати автоматичне перетворення. Ви можете скористатися одним з трьох варіантів: </para>

<itemizedlist>
  <listitem>
    <para
>Створити окремий інвестиційний рахунок для кожного цінного паперу з назвою цінного паперу.</para>
  </listitem>

  <listitem>
    <para
>Створити єдиний інвестиційний рахунок, який буде «батьківським» для всіх рахунків цінних паперів.</para>
  </listitem>

  <listitem>
    <para
>Створити декілька інвестиційних рахунків і призначати до них цінні папери за вказівками користувача.</para>
  </listitem>
</itemizedlist>

<para
>Вибір найкращого варіанта у конкретній ситуації залежить лише від потреб користувача. У деяких випадках після імпортування може знадобитися зміна структури рахунків вручну. </para>
</sect4>

<sect4>
<title
>Ціни та курси валют</title>

<para
>Програма імпортує дані про вартість цінних паперів та обмінні курси, які показує редактор цін GnuCash. Крім того, на основі даних операцій з цінними паперами та валютами буде створено записи ціни та курсів. </para>
</sect4>

<sect4 id="details.impexp.gncquotes">
<title
>Інтерактивні курси</title>

<para
>Для отримання даних про ціни і курси з мережі GnuCash використовує пакунок з назвою Finance::Quote. У останніх версіях &kappname; передбачено підтримку цього пакунка для отримання курсів акцій. Цією підтримкою можна скористатися як типовою під час імпортування даних. Але ви можете скористатися і власним методом отримання даних, що підтримується &kappname;. Цей метод докладніше описано у розділі, присвяченому <link linkend="details.investments.onlinequotes"
>інтерактивним курсам</link
>. </para>

<para
>Якщо ви звернетеся саме до останнього способу, програма відкриє наведене нижче діалогове вікно, за допомогою якого ви зможете обрати «рідне» для &kappname; джерело курсів або вказане вами джерело курсів для кожного з рахунків, з якими слід пов’язати курси з мережі. Але позначку біржі (тікер) під час імпортування змінено не буде. Оскільки ця позначка майже напевно буде різною у різних пакунках, вам доведеться змінити її вручну після завершення процесу імпортування. Під час наступних оновлень курсів валют програма вже не використовуватимеFinance::Quote, замість нього завжди використовуватиметься «рідний» спосіб отримання даних. </para>

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

<sect3 id="gncschedules">
<title
>Заплановані операції</title>

<para
>У &kappname; не підтримується розділення GnuCash між операціями шаблонів і частотою їх виконання. Дані операцій буде здубльовано, якщо однаковий шаблон використовується у різних розкладах, але подібне дублювання навряд чи зашкодить імпортуванню. </para>

<sect4>
<title
>Типи розкладу</title>

<para
>У &kappname; всі розклади розподіляються за трьома типами: накладні, депозити і трансферти. Оскільки у GnuCash подібного поділу не передбачено, інструмент імпортування спробує визначити тип за рахунком і напрямком руху грошей. Іноді подібне визначення призводитиме до помилкових припущень, які доведеться виправляти вручну. </para>
</sect4>

<sect4>
<title
>Підозріливі розклади</title>

<para
>Деякі з можливостей операцій, що виконуються за розкладом у GnuCash, не передбачено у &kappname;, отже інструмент імпортування намагатиметься досягти розумного компромісу під час перетворення даних. Подібні операції буде позначено як підозріливі, ви зможете змінити їх вручну під час процедури імпортування. Прикладами ситуацій, які можуть спричинити подібні помилки є: </para>

<itemizedlist>
  <listitem>
    <para
>деякі з проміжків розкладу, які підтримуються у GnuCash ще не реалізовано у &kappname;</para>
  </listitem>

  <listitem>
    <para
>&kappname; не підтримує використання формул і змінних у полях рахунків</para>
  </listitem>

  <listitem>
    <para
>складні випадки, які ще не було визначено для імпортування.</para>
  </listitem>
</itemizedlist>

<para
>Незважаючи на зусилля авторів програми, через величезну кількість задіяних факторів заплановані операції можуть спричинити критичну помилку у роботі &kappname;. Якщо ви зіткнетеся з такою проблемою, інструмент імпортування запропонує вам відкинути всі підозріливі розклади. </para>
</sect4>
</sect3>

<sect3>
<title
>Звіти</title>

<para
>У &kappname; передбачено широкий вибір звітів, параметри яких ви можете налаштувати власноруч. Докладніше про них можна дізнатися з розділу <link linkend="details.reports"
>Звіти</link
>. Але перелік цих типів звітів не обов’язково збігається з переліком звітів, які можна створювати за допомогою GnuCash. </para>
</sect3>
</sect2>

<sect2>
<title
>Вибір параметрів імпортування</title>

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

<sect3>
<title
>Обробка інвестицій</title>

<para
>Див. розділ <link linkend="gncsecurities"
>«Цінні папери та інвестиції»</link
>, наведений вище. </para>
</sect3>

<sect3>
<title
>Інтерактивні курси</title>

<para
>Зніміть позначку з цього пункту, якщо ви бажаєте використовувати природний для програми спосіб для обробки інтерактивних курсів. </para>

<para
>Див. розділ <link linkend="details.impexp.gncquotes"
>«Інтерактивні курси»</link
>, наведений вище. </para>
</sect3>

<sect3>
<title
>Заплановані операції</title>

<para
>Див. розділ <link linkend="gncschedules"
>«Заплановані операції»</link
>, наведений вище. </para>
</sect3>

<sect3>
<title
>Параметри декодування</title>

<para
>Якщо запис вашої мови виконується літерами або символами, відмінними від тих, які використовуються у «латинських» (тобто, загалом кажучи, західноєвропейських) мовах, це буде відображено у особливий спосіб («закодовано») у вашому файлі GnuCash. Якщо програма не може належним чином показати ці літери на екрані, їх слід декодувати. У поточній версії часто неможливо точно визначити спосіб декодування, отже, можливо, вам доведеться власноруч встановити цей параметр і обрати відповідний пункт зі списку. Загалом кажучи, першим пунктом у списку буде пункт, що відповідає вашій локалі (тобто країні і коду мови, які було обрано як базові під час встановлення операційної системи), отже його слід спробувати першим. Оскільки у процесі імпортування програма не перезаписуватиме ваш файл GnuCash, ви можете спробувати будь-який з запропонованих варіантів. </para>
</sect3>

<sect3>
<title
>Параметр нотаток до операцій</title>

<para
>За певних умов нерозділені операції GnuCash можуть містити залишкові, часто некоректні записи приміток, які за звичайних умов невидимі для користувача. Після імпортування до &kappname; через відмінності у параметрах показу ці дані стають видимими. Часто записи таких операцій містять поле «Нотатки», де описано справжнє призначення операції. Якщо цей пункт буде позначено, подібні нотатки, якщо їх буде виявлено, буде використано для заміни надлишкових даних приміток. </para>
</sect3>

<sect3>
<title
>Параметри налагоджування</title>

<para
>Потреба у цих параметрах виникне, лише якщо ви зіткнетеся з помилками під час імпортування, про які за будь-яких умов слід доповісти до списку листування &kappname; за адресою &devlist;. Зауважте, що дані, зібрані за допомогою цих параметрів можуть бути конфіденційними за своєю природою. Якщо ви маєте намір оприлюднити такі дані, скористайтеся можливостями анонімізації даних, що пропонуються програмою. </para>
</sect3>
</sect2>

<sect2>
<title
>Імпортування звіту</title>

<para
>Наприкінці обробки інструмент імпортування створює звіт, у якому міститимуться дані щодо кількості оброблених записів та всіх помилок та двозначностей, які виникли під час імпортування. Цей звіт буде показано на екрані, його можна буде зберегти до файла для подальшого перегляду. У повному звіті можуть міститися такі розділи: </para>

<itemizedlist>
  <listitem>
    <para
>Кількість записів</para>
  </listitem>

  <listitem>
    <para
>Непослідовності у типах рахунків і діях</para>
  </listitem>

  <listitem>
    <para
>Подробиці щодо підозріливих розкладів</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>
  <author
>&Jack.H.Ostroff; &Jack.H.Ostroff.mail;</author>
</sect1info>

<title
>Інструмент імпортування QIF</title>

<sect2>
<title
>Формат QIF вважається шкідливим</title>

<para
>Загалом кажучи, якщо можете, уникайте роботи з форматом QIF. Цей формат не пристосовано для передавання фінансових даних. Серед іншого, у QIF є такі проблеми: </para>

<itemizedlist>
  <listitem>
    <para
>Відсутність стандартизованого формату. У різних версіях однієї програми одному елементу може бути надано різних значень.</para>
  </listitem>

  <listitem>
    <para
>Відсутність ідентифікаторів операцій. Оскільки з операціями не пов’язано жодних ідентифікаційних номерів, пошук дублікатів є принаймні непростим завданням.</para>
  </listitem>

  <listitem>
    <para
>Недостатня виразність. Словник формату дуже простий і не може відтворити всю глибину сучасних фінансових даних.</para>
  </listitem>
</itemizedlist>

<para
>Загалом кажучи, це і є причини, з яких Intuit припинила підтримку роботи з вхідними даними у форматі QIF у Quicken 2005. Якщо ви можете вибирати формат отримання даних, наприклад можете вибрати OFX, не використовуйте формат QIF. </para>
</sect2>

<sect2>
<title
>Як імпортувати файл QIF?</title>

<para
>Щоб імпортувати файл QIF, спочатку переконайтеся, що відкрито коректний файл &kappname;. Потім скористайтеся пунктом меню <menuchoice
><guimenuitem
>Імпортувати</guimenuitem
> <guimenuitem
>QIF...</guimenuitem
></menuchoice
> з меню <guimenu
>Файл</guimenu
>. </para>
	
<para>
	<screenshot>
	<mediaobject>
	<imageobject>
	<imagedata fileref="qifopen.png" format="PNG"/>
	</imageobject>
	</mediaobject>
	</screenshot>
</para>

<para
>У діалоговому вікні, яке буде відкрито, програма запитає вас про назву файла QIF і надасть вам змогу вказати файл у графічному режимі за допомогою натискання кнопки <guibutton
>Навігація</guibutton
>. </para>

<para
>Крім того, у &kappname; існують відмінності між імпортом файла виписки банку і даних журналу, експортованих іншою програмою. Типовим є імпортування файла банківської виписки. Якщо ви імпортуєте дані з вашої попередньої програми для ведення фінансового обліку, позначте відповідний пункт. </para>

<para
>Загалом кажучи, типовий профіль QIF має виконати своє завдання під час імпортування ваших даних QIF. Але іноді може виникнути потреба у використанні зміненого профілю QIF. Докладніше про це можна дізнатися з <link linkend="details.impexp.qifimp.profile"
>наступного розділу</link
>. </para>

<para
>Натисніть кнопку <guibutton
>Імпортувати</guibutton
>, щоб наказати програмі імпортувати файл QIF. </para>

<para
>У відповідь &kappname; розпочне сканування файла для визначення форматів, використаних для представлення дат і чисел. Якщо програмі не вдасться однозначно визначити формат дати, &kappname; попросить користувача обрати один з форматів зі списку можливих форматів дати. </para>

<para
>Далі, &kappname; імпортує дані і створює всі потрібні об’єкти, зокрема записи даних отримувачів, рахунки і записи категорій, записи даних щодо курсів. Якщо це можливо, буде зроблено спробу встановити відповідність існуючих записів до імпортованих відомостей. Під час процедури імпортування буде показано панель поступу. </para>

<para
>Якщо &kappname; не вдасться визначити назву рахунку, до якого слід виконати імпорт, програма попросить користувача обрати запис рахунку, куди буде імпортовано дані. Якщо у вашому файлі ще немає запису цього рахунку, ви можете створити рахунок натисканням кнопки <guibutton
>Створити</guibutton
>. </para>

<para
>Наприкінці процедури імпортування &kappname; покаже вікно статистичних даних щодо імпортування виписки. </para>

<para>
<screenshot>
	<screeninfo
>Статистичні дані виписки</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="qif_report.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Статистичні дані виписки</phrase>
	</textobject>
	</mediaobject>
</screenshot>
</para>

<para
>Після імпортування всі імпортовані записи у перегляді облікової книги буде позначено жовтим тлом. Якщо &kappname; вдасться встановити відповідність імпортованого запису операції з вже існуючим записом операції, колір тла буде змінено на світло-зелений. </para>

<para
>На наступному кроці вам слід перевірити імпортовані дані і підтвердити їх. Цей крок є спільним для всіх операцій з імпортування з будь-яких джерел. Його докладно розглянуто у окремому розділі цього підручника. </para>

<note>
<para
>Кольори, які програма використовуватиме для позначення імпортованих та відповідних записів операцій можна змінювати. У вашому середовищі вони можуть бути відмінними від вказаних у цьому підручнику. </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
>Налаштування профілю QIF</title>

<para
>Оскільки не існує загальновизнаного стандарту щодо запису файлів QIF, виробники програмного забезпечення припускаються певних довільних тлумачень у цьому форматі та додають власні нюанси. За допомогою профілю QIF ви можете повідомити &kappname; про особливості  вашого файла. Щоб розпочати редагування існуючого профілю QIF чи створити профіль, натисніть кнопку <guibutton
>Створити</guibutton
> у діалоговому вікні імпортування QIF, розташовану поруч з інструментом вибору профілів. </para>

<para>
	<screenshot>
	<mediaobject>
	<imageobject>
	<imagedata fileref="qifimport-qifprofileeditor.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Редактор профілів QIF</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<note>
<para
>У попередніх версіях &kappname; для визначення специфікації дат і сум було передбачено окрему вкладку. Поточна версія &kappname; визначає ці параметри шляхом аналізу самого файла. Якщо програмі не вдасться визначити всі параметри, вона попросить користувача уточнити їх під час імпортування. </para>
</note>

<para
>Іншим можливим випадком використанням профілю є випадок, коли у вашому файлі QIF використано нестандартне кодування символів, наприклад ISO-8859-1. Щоб програма &kappname; могла перетворити дані файла на дані у кодуванні UTF-8 під час імпортування, ви можете скористатися виразом </para>
<programlisting
>iconv -f iso-8859-1 -t utf-8
</programlisting>
<para
>як значенням фільтра. </para>
<!--
<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
>Пошук відповідних операцій</title>

<para
>Як ми вже раніше вказували, одним з основних недоліків формату QIF є відсутність унікального ідентифікатора для кожної операції. Отже, якщо під час імпортування файла QIF деякі з записів операцій збігатимуться з записами операцій, які вже є у вашій обліковій книзі, ви можете отримати дублікати. &kappname; намагається запобігти утворенню таких дублікатів шляхом виявлення записів операцій, які є подібними до записів, вже присутніх у списку операцій. Програма знайде дублікати за вказаними вами параметрами і відкине зайві записи. </para>

<para
>Під час подібного відкидання можуть виникнути проблеми через автоматичне відкидання операцій, параметри яких схожі, але які є насправді різними операціями. У такому разі ви зможете пізніше скасувати встановлення відповідності між такими записами операцій за допомогою перегляду облікових книг. </para>
</sect2>

<sect2>
<title
>Створення фільтра імпортування</title>

<para
>Іноді ви можете зіткнутися з даними у нетиповому форматі, наприклад у форматі значень, відокремлених комами, (CSV) або якомусь іншому форматі. З версії 4.6 до складу &kappname; включено додаток імпортування CSV, але ви можете імпортувати до &kappname; дані у інших форматах за допомогою фільтра імпортування QIF. Фільтром буде написана вами програма, яка отримає дані з імпортованого файла і створить на виході файл QIF. Цією програмою може бути скрипт оболонки, скрипт мовою Perl, зібрана програма, написана мовою C/C++, або будь-який інший інструмент обробки. Достатньо лише, щоб система могла його запустити. </para>

<para
>Щоб скористатися цим фільтром, відкрийте вікно редагування профілю QIF і перейдіть на вкладку «Фільтр». Введіть у відповідне поле адресу вашої програми для фільтрування. Згодом, під час імпортування QIF за допомогою створеного вами профілю файл перед імпортуванням буде оброблено вашою програмою-фільтром. </para>

<para
>Часто виникає проблема з перетворенням списку відокремлених комою значень на файл QIF. Приклад подібного перетворення можна знайти у підручнику з програми awk. Створіть скрипт з назвою csv2qif.awk, який складатиметься з таких двох рядків: </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
>Після цього змініть ключі QIF (D,T,N,P,M) так, щоб їх порядок відповідав порядку полів у ваших даних csv. Встановіть фільтр вхідних даних <userinput
>awk -f csv2qif.awk</userinput
>. </para>

<para
>Іншою проблемою, з якою ви можете зіткнутися, є кодування файлів QIF. Програма &kappname; вважатиме, що типовим кодуванням файлів є UTF8. Якщо ваш файл закодовано у якийсь інший спосіб, варто спочатку перетворити його на файл у кодуванні UTF8. Наприклад, щоб перетворити файл з кодування iso-8859-1, вам слід вказати фільтр-команду <userinput
>recode iso-8859-1..utf-8</userinput
>. </para>

</sect2>
<sect2>
<title
>Особливі додатки QIF &kappname;</title>

<para
>Як ми вже згадували раніше, одним з основних недоліків формату QIF є відсутність унікальних ідентифікаторів для кожної з операцій. Якщо ви пишете власний інструмент створення QIF (або фільтр, про який ми говорили вище), ви можете подолати цю проблему. У &kappname; передбачено підтримку поля «#». Інструмент імпортування вважатиме вміст цього поля унікальним ідентифікатором операції і відкидатиме запис, якщо запис з таким ідентифікатором вже є у системі. </para>
</sect2>
</sect1>

<sect1 id="details.impexp.qifexp">
<title
>Інструмент експортування QIF</title>
<para
>Щоб експортувати один з ваших рахунків до файла QIF, скористайтеся пунктом <menuchoice
><guimenuitem
>Експортувати</guimenuitem
><guimenuitem
>QIF</guimenuitem
></menuchoice
> з меню <guimenu
>Файл</guimenu
>. Програма запитає вас про те, який з окремих рахунків слід експортувати, файл, до якого слід виконати експорт, та профіль QIF, яким слід скористатися для експортування. </para>

<note
><para
>У поточній версії інструменту експортування QIF не передбачено можливості експортування даних інвестицій. </para
></note>

<para>
	<screenshot>
	<mediaobject>
	<imageobject>
	<imagedata fileref="qifimport-export.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Експорт до 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
>Додаток імпортування OFX</title>

<sect2>
<title
>Отримання додатка</title>

<para
>У &kappname; передбачено простий і точний імпорт файлів OFX. Але цю функціональну можливість не вбудовано до основної програми. Вам доведеться отримати і встановити додаток імпортування OFX. Після встановлення цього додатка, у меню <menuchoice
><guimenu
>Файл</guimenu
> <guimenuitem
>Імпортувати</guimenuitem
></menuchoice
> автоматично з’явиться пункт, призначений для імпортування файлів OFX. </para>

<para
>Зауважте, що значна частина версій &kappname; у пакунках зібрана з вбудованим інструментом імпортування OFX. Цей інструмент може зберігатися у окремому пакунку. Якщо ви виявили, що у вашій версії не встановлено інструменту імпортування OFX, спочатку пошукайте відповідний пакунок у тому ж сховищі, звідки ви встановлювали основний пакунок &kappname;. </para>

<para
>Якщо ви виконували встановлення з пакунків RPM, додаток імпортування OFX міститься у kmymoney-ofx. Цей пакунок можна знайти поряд з основним пакунком RPM &kappname;. Якщо ви збирали програму з вихідних кодів, вам слід попередньо встановити заголовки бібліотеки та саму бібліотеку libOFX 0.9 у вашій системі. Скрипт збирання &kappname; виявить відповідні файли і збере потрібний вам додаток. Передбачено і підтримку libOFX 0.8.2, але у цій версії бібліотеки немає підтримки декількох цікавих можливостей. На час випуску версії &kappname; 4.6 найсвіжішою версією libofx була 0.9.4. </para>

<para
>Якщо під час спроби збирання &kappname; у вас виникнуть проблеми і ви впевнені, що встановили належну версію libOFX, будь ласка, зверніться до списку листування розробників за адресою &devlist; по допомогу. До вашого повідомлення долучіть файл config.log, стиснутий за допомогою gzip. </para>
</sect2>

<sect2>
<title
>Для чого призначено OFX</title>

<para
>OFX є абревіатурою від «Open Financial Exchange» (відкритий обмін фінансовими даними). Відповідно до <ulink url="http://www.ofx.net/"
>сайта OFX</ulink
>: «Open Financial Exchange (OFX) — уніфікована специфікація для обміну фінансовими даними між фінансовими установами, працедавцями та споживачами фінансових послуг за допомогою інтернету. OFX не є якоюсь окремою фінансовою установою.» Специфікація визначає формати передавання фінансових даних за допомогою файлів та безпосереднього обміну даними. </para>

<para
>Хоча цей стандарт є набагато повнішим та стійкішим за QIF, у ньому усе ще є певна невизначеність. Отже його робота залежить від окремої реалізації фінансовою установою. Назви файлів OFX можуть мати суфікс «OFX» або «QFX» (великими або малими літерами). Використання певного суфікса не накладає ніяких окремих обмежень на вміст файла. Специфікацію засновано на XML, отже такі файли можна читати у будь-якому текстовому редакторі. Втім, оскільки використання пробілів не впливає на дані, у деяких реалізаціях пробіли не використовуються взагалі, що робить читання таких файлів людиною доволі важкою справою. </para>

<para
>Ще одним сайтом із відомостями щодо формату є <ulink url="http:/ofxhome.com/"
>домашня сторінка OFX</ulink
>. На сайті можна знайти каталог фінансових установ, які проголошують підтримку OFX. Цей список може знадобитися, якщо у вас виникнуть проблеми із налаштовуванням <link linkend="details.impexp.ofxdirectconnect"
>безпосереднього обміну даними OFX</link
>. На сайті є форум для обговорення проблем із OFX. </para>
</sect2>

<sect2>
<title
>Імпортування файла OFX</title>

<para
>Основним способом імпортування файла OFX є вибір інструменту імпортування за допомогою панелі меню. У меню <guimenu
>Файл</guimenu
> оберіть пункт <guimenuitem
>Імпортувати</guimenuitem
>, а потім пункт <guimenuitem
>OFX...</guimenuitem
>. Якщо у підменю «Імпортувати» немає пункту OFX, додаток імпортування OFX не було встановлено належним чином. Будь ласка, зверніться до попереднього розділу цього підручника. </para>

<para
>Спочатку інструмент імпортування запитає вас про назву рахунку, до якого слід імпортувати дані операцій. Якщо у файлі зберігаються дані щодо операцій для декількох рахунків, програма ставитиме це питання декілька разів. </para>

<para
>Після імпортування деякі з записів операцій у вашій обліковій книзі буде позначено знаком оклику у жовтому трикутничку. Причиною підсвічування є невизначеність категорії відповідних записів. Інструмент імпортування не може автоматично призначити цю категорію на основі вашого журналу операцій. Ви можете змінити параметри будь-якого запису у обліковій книзі і призначити його до певної категорії. Після цього позначку буде вилучено. </para>

<para
>Будь ласка, зауважте, що у цьому розділі описано «рідний» для програми інструмент імпортування OFX. Крім нього, файли OFX може бути імпортовано за допомогою додатка імпортування AqBanking, якщо вами було встановлено цей додаток. Зауважте, що поведінка цих двох інструментів імпортування буде дещо різною, їх написанням та супроводом переймаються зовсім різні люди. </para>
</sect2>

<sect2>
<title
>Імпортування даних щодо інвестування</title>

<para
>Будь ласка, зауважте, що якщо ви імпортуєте файл з записами щодо операцій з інвестування, ці записи від початку мають міститися у вашому файлі &kappname;. Для встановлення відповідності використовується стандартний символ акції, отже переконайтеся, що цей символ у &kappname; точно збігається з символом у файлі, який ви імпортуєте. </para>
</sect2>

<sect2 id="details.impexp.webconnect">
<title
>З’єднання з мережею</title>

<para
>Найпростішим способом імпортування файла OFX є встановлення вебз’єднання. Відвідайте сайт вашої банківської установи і натисніть посилання для отримання файла OFX. Ваш переглядач інтернету запитає вас про назву програм, за допомогою якої ви бажаєте відкрити відповідний файл. Вкажіть на файл програми &kappname;. Після цього отриманий файл OFX буде імпортовано до файла &kappname;, який було відкрито у програмі останнім. Крім того, ви можете змінити прив’язку файлів у вашому стільничному середовищі, отже зробити так, що файли OFX завжди відкриватимуться у &kappname;. </para>

<para
>Якщо вам потрібно імпортувати файл OFX у якийсь інший файл &kappname;, спочатку завантажте цей файл до &kappname;, а потім відвідайте сторінку вашого банку. </para>
</sect2>

<sect2 id="details.impexp.ofxdirectconnect">
<title
>Безпосереднє з’єднання</title>

<para
>У поточній версії &kappname; підтримується також безпосереднього з’єднання OFX (Direct Connect). Це надає вам змогу встановити безпосередній зв’язок з вашою банківською установою для отримання виписок. У майбутньому, коли буде створено докладнішу довідку, ці відомості буде пересунуто до окремого розділу. </para>

<para
>Щоб увімкнути цю можливість, вам слід зібрати &kappname; з параметром налаштування --enable-ofxbanking (тепер цей параметр є типовим). </para>

<para
>Будь ласка, зауважте: багато банків вимагають окремої підписки, надають окремі паролі або коди PIN, а також можуть стягувати окрему плату за відповідну послугу. Жоден з банків не надасть вам безпосередньої підтримки &kappname;. Вам слід повідомити працівникам банку, що ви маєте намір встановити безпосередній зв’язок за допомогою MS Money або Quicken. </para>

<para
>На першому кроці вам слід налаштувати всі рахунки, для яких ви маєте намір отримувати виписки. Переведіть програму у режим перегляду рахунків, наведіть вказівник миші на позначку рахунку, який ви бажаєте налаштувати, клацніть правою кнопкою миші і оберіть пункт <guimenuitem
>Пов’язати з мережевим рахунком</guimenuitem
>. Якщо у вашій системі встановлено декілька додатків для роботи з банківськими установами за допомогою мережі, програма запитає вас про те, який з них слід використовувати. Якщо ви маєте намір використовувати вбудовану обробку OFX, оберіть пункт <guimenuitem
>KMyMoney OFX</guimenuitem
>. Програма отримать список банків з інтернету. За допомогою майстра ви зможете обрати назву банківської установи, ввести ім’я користувача і пароль та обрати рахунок. Якщо ви не знайдете потрібного вам банку у списку, ви зможете ввести його параметри вручну. Ваш банк має надавати потрібні програмі дані. Крім того, можливо, вам вдасться віднайти спосіб отримання цих даних власноруч. </para>

<note>
  <para
>Налаштовування безпосереднього обміну даними OFX іноді може бути непростою справою, особливо через те, що реалізація протоколу у більшості установ не передбачає надання достатніх подробиць у повідомленнях про помилки. Ще однією з проблем є те, що у багатьох установах вимагають змінювати пароль під час першого ж сеансу доступу за допомогою інтернету, якщо використовується цей метод. На жаль, у поточній версії бібліотеки, яка використовується у &kappname;, (libofx) не передбачено можливості інтерактивної зміни пароля. Інколи вдається змінити пароль за допомогою працівників служби підтримки. Доки нам не вдасться розширити відомості цього розділу докладнішим описом способів усування вад, якщо у вас виникатимуть проблеми із безпосередніми обміном даними, ви можете попросити про допомогу у списку листування розробників &kappname;, &devlist;. </para>
</note>

<para
>Після того, як ваш рахунок буде налаштовано для мережевої роботи з банком, перейдіть до облікової книги цього рахунку. Потім оберіть у меню <guimenu
>Рахунок</guimenu
> оберіть пункт <guimenuitem
>Оновити рахунок…</guimenuitem
>. Програма з’єднається з вашим банком і отримає виписку за попередні 60 днів. </para>

<note>
  <para
>У версіях &kappname; до 4.6 назва отримувача завжди визначалося за полем PAYEEID. З версії 4.6 назва отримувача під час операції з OFX визначається на основі одного з полів PAYEEID, NAME або MEMO. Налаштувати цю можливість та деякі інші параметри безпосереднього з’єднання OFX можна за допомогою відповідної вкладки діалогового вікна <link linkend="details.accounts.edit"
>редагування рахунку</link
>. </para>
</note>
</sect2>

<sect2>
<title
>Експортування файла OFX</title>

<para
>У поточній версії ще не передбачено можливості експортування ваших даних до файла OFX. Якщо ви можете допомогти у створенні такого інструменту експорту, будь ласка, зв’яжіться з командою розробки libofx, щоб дізнатися більше. </para>
</sect2>
</sect1>
&details-impexp-csv; &details-impexp-csvexp; <sect1 id="details.impexp.plugins">
<title
>Написання додатка з імпортування</title>

<para
>У &kappname; передбачено повноцінну підтримку додатків імпортування. Якщо ви працюєте з файлами у якомусь нетиповому форматі і бажаєте написати додаток з імпортування, ми будемо раді вашому внеску у розробку. Щоб приєднатися до процесу розробки вам слід зібрати програму з початкових кодів. Після цього скористайтеся як прикладом додатком імпортування OFX. </para>
</sect1>
</chapter>
