Wiki source code of Managing Invoices

Version 24.2 by David Stadnyk on 2026/04/06 15:22

Hide last authors
Isaac Mejia 1.1 1 {{include reference="KBArticleHeader.WebHome"/}}
2
David Stadnyk 21.2 3 = Billing =
Isaac Mejia 1.1 4
David Stadnyk 23.2 5 [[image:1775488762250-822.png]]
6
David Stadnyk 21.2 7 The **Billing** section is a core module of the application, accessible from the left-hand navigation sidebar. It provides tools for managing financial transactions related to members, including invoice creation, tracking, and payment management.
Isaac Mejia 1.1 8
David Stadnyk 21.2 9 ----
Isaac Mejia 1.1 10
David Stadnyk 21.2 11 == Overview ==
David Stadnyk 19.2 12
David Stadnyk 21.2 13 The Billing module is divided into two main tabs:
David Stadnyk 19.2 14
David Stadnyk 21.2 15 * **Manage Invoices** – Search, view, and manage member invoices.
16 * **Manage Payments** – View and process scheduled payments for member contracts.
David Stadnyk 23.2 17 * [[image:1775488779193-956.png]]
David Stadnyk 19.2 18
David Stadnyk 21.2 19 ----
Isaac Mejia 1.1 20
David Stadnyk 21.2 21 == Manage Invoices ==
Isaac Mejia 1.1 22
David Stadnyk 21.2 23 The **Manage Invoices** tab allows staff to search for invoices using a variety of filters and perform bulk or individual actions on the results.
Isaac Mejia 1.1 24
David Stadnyk 21.2 25 === Search and Filter Panel ===
Isaac Mejia 1.1 26
David Stadnyk 21.2 27 Users can narrow invoice results using the following filter fields:
Isaac Mejia 1.1 28
David Stadnyk 21.2 29 * **Invoice ID** – Filter by a specific invoice number.
30 * **From / To** – Define a date range for the invoice search. Dates can be entered manually or selected using the calendar picker.
31 * **Member ID** – Filter by a specific member's ID.
32 * **Group** – Filter by member group. Defaults to //All//.
33 * **First Name / Last Name** – Filter by the member's name.
34 * **Approved** – Filter by approval status. Defaults to //Approved//.
35 * **Payment** – Filter by payment status. Defaults to //All//.
Isaac Mejia 1.1 36
David Stadnyk 21.2 37 Once filters are set, users can click the **Search** button to retrieve matching invoices.
Isaac Mejia 1.1 38
David Stadnyk 21.2 39 ==== Create Invoices Due ====
Isaac Mejia 1.1 40
David Stadnyk 21.2 41 The **Create Invoices Due** button, located next to the Search button, allows staff to automatically generate invoices for members with outstanding balances due. Clicking the button opens a confirmation dialog asking //"Are you sure you would like to create invoices due today?"// Staff must click **Yes** to proceed or **No** to cancel the action.
Isaac Mejia 1.1 42
David Stadnyk 21.2 43 ----
Isaac Mejia 1.1 44
David Stadnyk 21.2 45 === Invoices Table ===
Isaac Mejia 1.1 46
David Stadnyk 21.2 47 Search results are displayed in the **Invoices** table. The table supports row selection via checkboxes and includes the following columns:
Isaac Mejia 1.1 48
David Stadnyk 21.2 49 |=Column|=Description
50 |**Invoice ID**|A unique numeric identifier for each invoice.
51 |**Date of Invoice**|The date the invoice was generated.
52 |**First Name**|The first name of the member associated with the invoice.
53 |**Last Name**|The last name of the member associated with the invoice.
54 |**Amount**|The total amount of the invoice.
55 |**Paid**|The amount that has been paid toward the invoice.
56 |**Balance Due**|The remaining unpaid balance on the invoice.
57 |**Sales Person**|The staff member associated with the invoice, if applicable.
58 |**Invoice Status**|The current status of the invoice (e.g., //Approved//).
Isaac Mejia 1.1 59
David Stadnyk 24.2 60 ==== [[image:1775488857341-436.png]] ====
61
David Stadnyk 21.2 62 ==== Table Actions ====
Isaac Mejia 1.1 63
David Stadnyk 21.2 64 The toolbar at the top of the Invoices table provides the following actions (applied to selected rows):
Isaac Mejia 1.1 65
David Stadnyk 21.2 66 * **Approve** – Approve the selected invoice(s).
67 * **Edit** – Edit the selected invoice(s).
68 * **Delete** – Delete the selected invoice(s).
69 * **Cancel** – Cancel the selected invoice(s).
70 * **Email** – Email the selected invoice(s) to the member.
71 * **Print** – Print the selected invoice(s).
72 * **More options** – Additional actions via dropdown.
Isaac Mejia 1.1 73
David Stadnyk 21.2 74 ----
75
76 === Invoice Detail View ===
77
78 Clicking on an **Invoice ID** in the Invoices table opens the full detail view for that invoice. A selected invoice row is highlighted in blue.
79
80 ==== Header ====
81
82 The top of the detail view displays key reference information:
83
84 * **Invoice Number** – The unique invoice identifier.
85 * **Contract ID** – The contract associated with this invoice.
86 * **MSI #** – The MSI (Member Service Item) reference number.
87 * **Sold By** – The staff member who made the sale, if applicable.
88 * **Invoice For** – The full name of the member the invoice belongs to.
89 * **Date** – The date of the invoice.
90
91 ==== Line Items Table ====
92
93 A table lists the products or services included on the invoice, with the following columns:
94
95 |=Column|=Description
96 |**Product ID**|The unique identifier for the product or service.
97 |**Purchased For**|The member the item was purchased for.
98 |**Name**|The name of the product or service.
99 |**Quantity**|The number of units purchased.
100 |**Price/Item**|The per-unit price.
101 |**Discount**|Any discount applied to the item.
102 |**Tax**|The tax rate or amount applied.
103 |**Amount Due**|The total amount due for that line item.
104
105 ==== MSI Fees ====
106
107 The **MSI Fees** panel on the left side of the invoice displays any additional fees associated with the invoice:
108
109 * **Late Fee** – A fee applied for late payment.
110 * **Processing Fee** – A fee for payment processing.
111 * **Return Fee** – A fee applied for returned payments.
112 * **Total Fees Paid** – The sum of fees that have been paid.
113 * **Total Fees Due** – The sum of fees still outstanding.
114
115 ==== Invoice Totals ====
116
117 The totals panel on the right provides a full financial breakdown:
118
119 |=Field|=Description
120 |**Item(s) Total**|The sum of all line item amounts.
121 |**Discounts**|Total discounts applied.
122 |**Taxes**|Total tax applied.
123 |**Refunds**|Any refunds issued against the invoice.
124 |**Adjustments**|Any manual adjustments made to the invoice. For invoices linked to MSI, adjustments cannot be made directly and must be submitted via a formal Adjustment Request.
125 |**Total Fees**|Sum of all MSI fees.
126 |**Subtotal**|The invoice total after discounts, taxes, and fees.
127 |**Amount Paid**|The total amount already paid.
128 |**Payment Amount**|An editable field for entering a payment amount.
129 |**Balance Due**|The remaining unpaid balance.
130 |**Due Now**|The amount currently due for immediate payment.
131
132 ==== Notes ====
133
134 A free-text **Notes** field allows staff to add comments or internal notes to the invoice. A **Hide Note** toggle can be used to show or hide this section.
135
136 ==== Pay Contract ====
137
138 Clicking the **Pay Contract** button navigates to the full contract payment page within the member's account. This page is part of the broader member account view and is accessible via the **Account** tab, under the **Contracts** sub-tab.
139
140 ===== Page Navigation =====
141
142 The member account page contains the following top-level tabs:
143
144 * Profile, Interests, Activities, Contact Log, Questionnaires, Programs, **Account** //(active)//, Admin
145
146 Within the **Account** tab, the following sub-tabs are available:
147
148 * On Account, Remaining, Auto Renewals, **Contracts** //(active)//, Open Invoices, Invoice History, MSI History
149
150 ===== Contract Summary =====
151
152 The top of the page displays the contract's key details:
153
154 * **Contract Name** – The name of the contract (e.g., //Bob FSB//).
155 * **ID** – The unique contract ID.
156 * **MSI #** – The associated MSI reference number.
157
158 A table lists the scheduled payment installments for the contract, with the following columns:
159
160 |=Column|=Description
161 |**Invoice #**|The invoice number, linked to the invoice detail view. Only generated invoices display a number; future scheduled payments show the date only.
162 |**Payment Date**|The scheduled or actual payment date.
163 |**Invoice Amount**|The amount of each installment.
164 |**Total Fees**|Any fees associated with the installment.
165 |**Amount Paid**|The amount paid toward the installment.
166 |**Status**|The current status of the installment.
167 |**Balance Due**|The remaining balance for the installment.
168
169 Below the table, two summary fields are shown:
170
171 * **Outstanding Payments** – The total amount currently overdue (displayed in red if greater than $0.00).
172 * **Contract Payoff** – The total amount required to fully pay off the contract.
173
174 ===== Payment Method =====
175
176 Staff can select from the following payment methods using radio buttons:
177
178 |=Method|=Details
179 |**Credit Card on File**|Select from saved credit cards on the member's account. An **Add** link allows a new card to be added.
180 |**ACH Information on File**|Select from saved ACH (bank account) details. An **Add** link allows new ACH details to be added.
181 |**Member Solutions**|Select a payment method managed through Member Solutions.
182 |**Cash**|Record a cash payment.
183 |**Cheque**|Record a cheque payment, with a reference number field.
184 |**Gift Certificate #**|Apply a gift certificate by entering its number.
185 |**Offline Credit Card**|Record a credit card payment processed offline, with card type selector.
186 |**Credit Card**|Enter new credit card details manually, including card number, name on card, CVV, and expiry date.
187
188 ===== Actions =====
189
190 * **Payment** – A field for entering the payment amount.
191 * **Pay Now** – Submits the payment using the selected method and amount.
192 * **Back** – Returns to the previous invoice detail view without processing a payment.
193
194 ==== Sales Receipt ====
195
196 A **Sales Receipt** section at the bottom of the invoice detail displays a log of all payment transactions associated with the invoice. It includes the following columns:
197
198 |=Column|=Description
199 |**Date**|The date of the payment transaction.
200 |**Amount**|The payment amount.
201 |**Complete**|Indicates whether the transaction was completed.
202 |**Type**|The type of transaction.
203 |**Method**|The payment method used.
204 |**Code**|A transaction reference code.
205 |**Fields**|Additional transaction data fields.
206
207 Below the transaction log, summary lines show the **Total Paid To Date** and the current **Balance Due**.
208
209 A **Refund Item** button at the bottom right allows staff to initiate a refund for a specific item on the invoice. The Sales Receipt toolbar also includes icons for reversing a payment, emailing, and printing the receipt.
210
211 ----
212
213 == Manage Payments ==
214
215 The **Manage Payments** tab displays a list of **Scheduled Payments** — invoices that are queued for payment processing. This view is primarily used to review outstanding balances and trigger payment runs.
216
217 === Scheduled Payments Table ===
218
219 The table includes a **Select All** checkbox in the top-right corner of the header, allowing staff to select all records at once. It contains the following columns:
220
221 |=Column|=Description
222 |**Invoice ID**|A unique numeric identifier for the invoice.
223 |**Date of Invoice**|The date and time the invoice was created.
224 |**Name**|The full name of the member associated with the invoice.
225 |**Amount**|The total invoice amount.
226 |**Paid**|The amount paid toward the invoice.
227 |**Balance Due**|The remaining unpaid balance.
228 |**Last Payment**|The result of the most recent payment attempt (e.g., //Failed//). If blank, no payment attempt has been made.
229 |**Sales Person**|The staff member associated with the invoice, if applicable.
230
231 ==== Last Payment Status ====
232
233 The **Last Payment** column indicates the outcome of the most recent payment attempt. A status of **Failed** means the last automated payment attempt was unsuccessful, and the balance remains outstanding.
234
235 ==== Process Scheduled Payments ====
236
237 The **Process Scheduled Payments** button, located at the bottom right of the page, triggers the payment processing run for all scheduled invoices. This will attempt to collect payment for outstanding balances using the payment methods on file for each member.
238
239
Isaac Mejia 1.1 240 {{include reference="KBSupportCTA.WebHome"/}}