summaryrefslogtreecommitdiffstats
path: root/doc/en/details-payees.docbook
blob: 6e23438cb2d4a0a46ef4ee9366718264806f3440 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
<?xml version="1.0" encoding="UTF-8"?>
<chapter id="details.payees">
<chapterinfo>
  <authorgroup>
    <author>
      <firstname>Roger</firstname>
      <surname>Lum</surname>
      <affiliation>
       <address><email>rogerlum@gmail.com</email></address>
      </affiliation>
    </author>
    <author>
      <firstname>Ace</firstname>
      <surname>Jones</surname>
      <affiliation>
        <address><email>acejones@users.sf.net</email></address>
      </affiliation>
    </author>
  </authorgroup>
  <date>2009-06-04</date>
  <releaseinfo>1.0</releaseinfo>
</chapterinfo>

<title id="details.payees.title">Payees</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>Payees List</title>

<para>
  A list of payees and payers is on the left side of this screen. The payee list
  is sorted alphabetically. To sort in reverse alphabetical order, click on the
  Name title at the top of the list.
</para>

<sect2>
<title>Adding a Payee or Payer</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>Renaming a Payee or Payer</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>Deleting a Payee or Payer</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>Additional Payee Details</title>

<sect2>
<title>Personal Information</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>Personal information</phrase>
	</textobject>
	</mediaobject>
</screenshot>
</para>
</sect2>

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

<sect3>
<title>Overview</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>Setting up</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
  behaviour 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>