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

<title id="details.payees.title"
>Begunstigden</title>

<para
>The Payees screen provides detailed information about all the payees and payers involved in transactions. The Payees screen is split into two main areas: a payees and payers list and a detail area. </para>

<para
>The Payees screen allows for viewing the transactions for the selected payee, updating personal information associated with a particular payee or payer, and specifying transaction matching criteria. </para>

<para>
	<screenshot>
	<mediaobject>
	<imageobject>
	<imagedata fileref="payeeview.png" format="PNG"/>
	</imageobject>
	</mediaobject>
	</screenshot>
</para>

<sect1 id="details.payees.list">
<title
>Debiteurenlijst</title>

<para
>A list of payees and payers is on the left side of this screen. The payee list is sorted alphabetically. </para>

<sect2>
<title
>Een debiteur of betaler toevoegen</title>

<para
>To add a payee or payer, right-click on any payee name and choose <guimenuitem
>New payee</guimenuitem
>. This creates a new payee called <quote
>New Payee</quote
>. Right-click on this payee and select <guimenuitem
>Rename payee</guimenuitem
> to enter the name of the new payee or payer. </para>
</sect2>

<sect2>
<title
>Een debiteur of betaler hernoemen</title>

<para
>To rename a payee or payer, simply right-click on the name, select <guimenuitem
>Rename payee</guimenuitem
> and the name becomes editable. Changing the name will affect the name in all the transactions in which it appears. </para>
</sect2>

<sect2>
<title
>Een debiteur of betaler verwijderen</title>

<para
>To remove a payee or payer, right-click the name and select <guimenuitem
>Delete payee</guimenuitem
>. If the payee has any transactions, you will be presented with a dialog that allows you to reassign them to a different payee, and also a check box to enable a deleted name to be added to the new payee's matching list. </para>
</sect2>

</sect1>

<sect1 id="details.payees.personalinformation">
<title
>Extra debiteurendetails</title>

<sect2>
<title
>Persoonlijke informatie</title>

<para
>To view and edit the personal information associated with a particular payee, select the payee from the list and select the Address tab. To modify this information, edit the detail area directly and press the Update button when finished. </para>

<para>
<screenshot>
	<screeninfo
>The personal information tab</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="payee_info.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Persoonlijke informatie</phrase>
	</textobject>
	</mediaobject>
</screenshot>
</para>
</sect2>

<sect2>
<title
>Transaction Matching Settings</title>

<sect3>
<title
>Overzicht</title>

<para
>&kappname; has the ability to automatically assign the proper payee to imported transactions. This can be handy when importing transactions from your bank, when the payee name has extra unnecessary characters, or worse, if the payee names change. </para>

<para
>For example, let's say your monthly mortgage payment comes in from your bank like this <quote
>SUNTRUST BANK MAPLE VALLEY, GA 111506</quote
> one month and then <quote
>SUNTRUST BANK MAPLE VALLEY, GA 121606</quote
> the next month. You would really like both of those transactions to be assigned simply to your payee <quote
>SunTrust</quote
>. The transaction matching feature is for you! </para>

<para>
<screenshot>
	<screeninfo
>The payee matching tab</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="payee_match.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Payee matching details</phrase>
	</textobject>
	</mediaobject>
</screenshot>
</para>
</sect3>

<sect3>
<title
>Aan het instellen</title>

<para
>From the Matching tab, you can set the Transaction Matching Settings. You have 3 major options: </para>

<itemizedlist>
  <listitem>
    <para
>No Matching. Disables the feature for this payee. This is the default setting for all payees. </para>
  </listitem>

  <listitem>
    <para
>Match on Payee Name. Enables the feature, and uses the payee name itself as the Match Key </para>
  </listitem>

  <listitem>
    <para
>Match on Key. Enables the feature, and allows you to enter one or more Match Keys of your choosing. In general, entering a plain string will work perfectly. However, the match keys are actually regular expressions, so it is possible to match on more complicated patterns. </para>
  </listitem>
</itemizedlist>

<para
>You can also choose whether you want to ignore the case of the Match Key. If you choose this option, the Match Key <quote
>SunTrust</quote
> would match <quote
>SUNTRUST BANK</quote
> or <quote
>SunTrust Bank</quote
>. </para>
</sect3>

<sect3>
<title
>Importing Transactions</title>

<para
>When you import transactions using the QIF import, or using a plugin such as OFX or AqBanking, the Match Keys you have set will be considered. If the Match Key for one of your payees is found anywhere in the payee of the imported transaction, the corresponding payee from your list will be assigned to that transaction. Thus, a Match Key of <quote
>SunTrust</quote
> will match <quote
>SUNTRUST BANK MAPLE VALLEY,GA</quote
> or even <quote
>MORGENSUNTRUST&amp;LOAN</quote
>. So choose your Match Keys carefully. <note
><para
>If a transaction payee matches more than one Match Key, the behavior is undefined. &kappname; will arbitrarily pick one of the matching payees. </para
></note>
</para>
</sect3>
</sect2>
</sect1>

<sect1 id="details.payees.transactionhistory">
<title
>Viewing Transaction History</title>

<para
>To view all transactions associated with a particular payee, select the payee from the list and the Transaction tab in the detail area. Double-clicking a particular transaction will bring you directly to that transaction in the Ledgers screen. </para>

<para>
<screenshot>
	<screeninfo
>The transaction tab</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="payee_history.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Transaction history</phrase>
	</textobject>
	</mediaobject>
</screenshot>
</para>
</sect1>
</chapter>
