LP#1673857: stamp schema update
[working/Evergreen.git] / docs / acquisitions / blanket.adoc
1 "Blanket" Orders
2 ----------------
3
4 "Blanket" orders allow staff to invoice an encumbered amount multiple times, paying off the charge over a period of time. The work flow supported by this development assumes staff does not need to track the individual contents of the order, only the amounts encumbered and invoiced in bulk.
5
6 Example
7 ~~~~~~~
8
9 . Staff creates PO with a Direct Charge of "Popular Fiction 2015" and a charge type of "Blanket Order".
10
11 . The amount entered for the charge equals the total amount expected to be charged over the duration of the order.
12
13 . When a shipment of "Popular Fiction" items arrive, staff creates an invoice from the "Popular Fiction 2015" PO page and enters the amount billed/paid for the received shipment under the "Popular Fiction 2015" charge in the invoice.
14
15 . When the final shipment arrives, staff select the _Final invoice for Blanket Order_ option on the invoice screen to mark the PO as _received_ and drop any remaining encumbrances to $0.
16
17   .. Alternatively, if the PO needs to be finalized without creating a final invoice, staff can use the new _Finalize Blanket Order_ option on the PO page.
18
19 More details about blanket orders
20 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
21  
22 * Any direct charge using a _blanket_ item type will create a long-lived charge that can be invoiced multiple times.
23
24 * Such a charge is considered open until its purchase order is "finalized" (received).
25
26 * "Finalizing" a PO changes the PO's state to _received_ (assuming there are no pending lineitems on the PO) and fully dis-encumbers all _blanket_ charges on the PO by setting the fund_debit amount to $0 on the original fund_debit for the charge.
27
28 * Invoicing a _blanket_ charge does the following under the covers:
29
30   .. Create an invoice_item to track the payment
31   
32   .. Create a new fund_debit to implement the payment whose amount matches the invoiced amount.
33
34 * Subtract the invoiced amount from the fund_debit linked to the original _blanket_ po_item, thus reducing the amount encumbered on the charge as a whole by the invoiced amount.
35
36 * A PO can have multiple blanket charges. E.g. you could have a blanket order for "Popular Fiction 2015" and a second charge for "Pop Fiction 2015 Taxes" to track / pay taxes over time on a blanket charge.
37
38 * A PO can have a mix of lineitems, non-blanket charges, and blanket charges.
39
40 * A _blanket_ Invoice Item Type cannot also be a _prorate_ type, since it's nonsensical. Blanket items are encumbered, whereas prorated items are only paid at invoice time and never encumbered.
41