LP1858448 Upgrade instructions WIP
[Evergreen.git] / docs / RELEASE_NOTES_NEXT / Administration / aged-money.adoc
1 Aged Money Changes
2 ^^^^^^^^^^^^^^^^^^
3
4 Two new global flag settings have been added to control if/when billings and
5 payments are aged.  Both settings are disabled by default.
6
7 * 'history.money.age_with_circs' 
8  ** Age billings and payments linked to circulations when the cirulcation 
9     is aged.
10 * 'history.money.retention_age'
11   ** Age billings and payments based on the age of the finish date for
12      the linked transaction.
13   ** To age money based on this setting, there is a new srfsh script
14      at (by default) /openils/bin/age_money.srfsh.
15
16 Aged Payment Additional Fields
17 ++++++++++++++++++++++++++++++
18
19 The aged payment table now has accepting_usr, cash_drawer, and billing
20 columns to improve reporting of aged money.
21
22 Manual Data Migration of Aged Money
23 +++++++++++++++++++++++++++++++++++
24
25 For users that wish to age money along with circulations (global flag 
26 'history.money.age_with_circs' is set to true), it's necessary to manaully
27 age money for circulations which have already been aged.  This can be
28 done directly in the database with SQL:
29
30 NOTE: This SQL can take a very long time to run on large databases, so
31 it may be necessary to process aged circulations in batches instead
32 of all at once.
33
34 [source,sql]
35 -------------------------------------------------------------------------
36 SELECT money.age_billings_and_payments_for_xact(circ.id)
37 FROM action.aged_circulation circ
38 -- limit to aged circs with billings
39 JOIN money.billing mb ON mb.xact = circ.id;
40 -------------------------------------------------------------------------
41
42