Wiki source code of Managing Invoices

Version 23.2 by David Stadnyk on 2026/04/06 15:20

version	line-number	content
1.1	1	{{include reference="KBArticleHeader.WebHome"/}}
	2
21.2	3	= Billing =
1.1	4
23.2	5	[[image:1775488762250-822.png]]
	6
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.
1.1	8
21.2	9	----
1.1	10
21.2	11	== Overview ==
19.2	12
21.2	13	The Billing module is divided into two main tabs:
19.2	14
21.2	15	* Manage Invoices – Search, view, and manage member invoices.
	16	* Manage Payments – View and process scheduled payments for member contracts.
23.2	17	* [[image:1775488779193-956.png]]
19.2	18
21.2	19	----
1.1	20
21.2	21	== Manage Invoices ==
1.1	22
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.
1.1	24
21.2	25	=== Search and Filter Panel ===
1.1	26
21.2	27	Users can narrow invoice results using the following filter fields:
1.1	28
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//.
1.1	36
21.2	37	Once filters are set, users can click the Search button to retrieve matching invoices.
1.1	38
21.2	39	==== Create Invoices Due ====
1.1	40
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.
1.1	42
21.2	43	----
1.1	44
21.2	45	=== Invoices Table ===
1.1	46
21.2	47	Search results are displayed in the Invoices table. The table supports row selection via checkboxes and includes the following columns:
1.1	48
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//).
1.1	59
21.2	60	==== Table Actions ====
1.1	61
21.2	62	The toolbar at the top of the Invoices table provides the following actions (applied to selected rows):
1.1	63
21.2	64	* Approve – Approve the selected invoice(s).
	65	* Edit – Edit the selected invoice(s).
	66	* Delete – Delete the selected invoice(s).
	67	* Cancel – Cancel the selected invoice(s).
	68	* Email – Email the selected invoice(s) to the member.
	69	* Print – Print the selected invoice(s).
	70	* More options – Additional actions via dropdown.
1.1	71
21.2	72	----
	73
	74	=== Invoice Detail View ===
	75
	76	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.
	77
	78	==== Header ====
	79
	80	The top of the detail view displays key reference information:
	81
	82	* Invoice Number – The unique invoice identifier.
	83	* Contract ID – The contract associated with this invoice.
	84	* MSI # – The MSI (Member Service Item) reference number.
	85	* Sold By – The staff member who made the sale, if applicable.
	86	* Invoice For – The full name of the member the invoice belongs to.
	87	* Date – The date of the invoice.
	88
	89	==== Line Items Table ====
	90
	91	A table lists the products or services included on the invoice, with the following columns:
	92
	93	\|=Column\|=Description
	94	\|Product ID\|The unique identifier for the product or service.
	95	\|Purchased For\|The member the item was purchased for.
	96	\|Name\|The name of the product or service.
	97	\|Quantity\|The number of units purchased.
	98	\|Price/Item\|The per-unit price.
	99	\|Discount\|Any discount applied to the item.
	100	\|Tax\|The tax rate or amount applied.
	101	\|Amount Due\|The total amount due for that line item.
	102
	103	==== MSI Fees ====
	104
	105	The MSI Fees panel on the left side of the invoice displays any additional fees associated with the invoice:
	106
	107	* Late Fee – A fee applied for late payment.
	108	* Processing Fee – A fee for payment processing.
	109	* Return Fee – A fee applied for returned payments.
	110	* Total Fees Paid – The sum of fees that have been paid.
	111	* Total Fees Due – The sum of fees still outstanding.
	112
	113	==== Invoice Totals ====
	114
	115	The totals panel on the right provides a full financial breakdown:
	116
	117	\|=Field\|=Description
	118	\|Item(s) Total\|The sum of all line item amounts.
	119	\|Discounts\|Total discounts applied.
	120	\|Taxes\|Total tax applied.
	121	\|Refunds\|Any refunds issued against the invoice.
	122	\|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.
	123	\|Total Fees\|Sum of all MSI fees.
	124	\|Subtotal\|The invoice total after discounts, taxes, and fees.
	125	\|Amount Paid\|The total amount already paid.
	126	\|Payment Amount\|An editable field for entering a payment amount.
	127	\|Balance Due\|The remaining unpaid balance.
	128	\|Due Now\|The amount currently due for immediate payment.
	129
	130	==== Notes ====
	131
	132	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.
	133
	134	==== Pay Contract ====
	135
	136	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.
	137
	138	===== Page Navigation =====
	139
	140	The member account page contains the following top-level tabs:
	141
	142	* Profile, Interests, Activities, Contact Log, Questionnaires, Programs, Account //(active)//, Admin
	143
	144	Within the Account tab, the following sub-tabs are available:
	145
	146	* On Account, Remaining, Auto Renewals, Contracts //(active)//, Open Invoices, Invoice History, MSI History
	147
	148	===== Contract Summary =====
	149
	150	The top of the page displays the contract's key details:
	151
	152	* Contract Name – The name of the contract (e.g., //Bob FSB//).
	153	* ID – The unique contract ID.
	154	* MSI # – The associated MSI reference number.
	155
	156	A table lists the scheduled payment installments for the contract, with the following columns:
	157
	158	\|=Column\|=Description
	159	\|Invoice #\|The invoice number, linked to the invoice detail view. Only generated invoices display a number; future scheduled payments show the date only.
	160	\|Payment Date\|The scheduled or actual payment date.
	161	\|Invoice Amount\|The amount of each installment.
	162	\|Total Fees\|Any fees associated with the installment.
	163	\|Amount Paid\|The amount paid toward the installment.
	164	\|Status\|The current status of the installment.
	165	\|Balance Due\|The remaining balance for the installment.
	166
	167	Below the table, two summary fields are shown:
	168
	169	* Outstanding Payments – The total amount currently overdue (displayed in red if greater than $0.00).
	170	* Contract Payoff – The total amount required to fully pay off the contract.
	171
	172	===== Payment Method =====
	173
	174	Staff can select from the following payment methods using radio buttons:
	175
	176	\|=Method\|=Details
	177	\|Credit Card on File\|Select from saved credit cards on the member's account. An Add link allows a new card to be added.
	178	\|ACH Information on File\|Select from saved ACH (bank account) details. An Add link allows new ACH details to be added.
	179	\|Member Solutions\|Select a payment method managed through Member Solutions.
	180	\|Cash\|Record a cash payment.
	181	\|Cheque\|Record a cheque payment, with a reference number field.
	182	\|Gift Certificate #\|Apply a gift certificate by entering its number.
	183	\|Offline Credit Card\|Record a credit card payment processed offline, with card type selector.
	184	\|Credit Card\|Enter new credit card details manually, including card number, name on card, CVV, and expiry date.
	185
	186	===== Actions =====
	187
	188	* Payment – A field for entering the payment amount.
	189	* Pay Now – Submits the payment using the selected method and amount.
	190	* Back – Returns to the previous invoice detail view without processing a payment.
	191
	192	==== Sales Receipt ====
	193
	194	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:
	195
	196	\|=Column\|=Description
	197	\|Date\|The date of the payment transaction.
	198	\|Amount\|The payment amount.
	199	\|Complete\|Indicates whether the transaction was completed.
	200	\|Type\|The type of transaction.
	201	\|Method\|The payment method used.
	202	\|Code\|A transaction reference code.
	203	\|Fields\|Additional transaction data fields.
	204
	205	Below the transaction log, summary lines show the Total Paid To Date and the current Balance Due.
	206
	207	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.
	208
	209	----
	210
	211	== Manage Payments ==
	212
	213	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.
	214
	215	=== Scheduled Payments Table ===
	216
	217	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:
	218
	219	\|=Column\|=Description
	220	\|Invoice ID\|A unique numeric identifier for the invoice.
	221	\|Date of Invoice\|The date and time the invoice was created.
	222	\|Name\|The full name of the member associated with the invoice.
	223	\|Amount\|The total invoice amount.
	224	\|Paid\|The amount paid toward the invoice.
	225	\|Balance Due\|The remaining unpaid balance.
	226	\|Last Payment\|The result of the most recent payment attempt (e.g., //Failed//). If blank, no payment attempt has been made.
	227	\|Sales Person\|The staff member associated with the invoice, if applicable.
	228
	229	==== Last Payment Status ====
	230
	231	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.
	232
	233	==== Process Scheduled Payments ====
	234
	235	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.
	236
	237
1.1	238	{{include reference="KBSupportCTA.WebHome"/}}