nightly Typical Batch Processes
The following is a brief description of the typical Batch Process executed during the processing of the nightly Batch Process Group.
- dbck
- Check the BillMax database for data issues. Some data issues are severe and should be fixed immediately. Others are warnings that something needs to be looked at.
- managefiles
- Uses a file of XML directives for file retention purposes. The XML file will specify if files should be compressed and how long they should be retained. As delivered BillMax uses the file /usr/local/billmax/local/manageFiles.
- closeofday
- The main processing program for BillMax. Uses the systemstate List
item closeofday date to keep track of the last time it ran. This date
is very important for catching up billing if the process was disabled for any reason. The
following functions are performed by closeofday:
- UpdateTaxRates
- Puts into effect scheduled tax rate changes on Tax Items.
- OpenFutureStartdateServices
- Open Services that were created with the Prospective Status with a Reason of Future Startdate where the Start Date is today or in the past.
- OpenDateToReOpenEntities
- Open Accounts, Users and Services that are in Suspended Status where Date to Reopen/Date to Resume Billing is today or in the past.
- SuspendExpiredAccounts
- CloseSuspendedAccounts
- SuspendExpiredUsers
- CloseSuspendedUsers
- SuspendExpiredServices
- CloseSuspendedServices
- SuspendExpiredServdefs
- Change the Status of Open
Accounts/Users/Packages/Services and underlying entities to
Suspended where the End Date is today or
in the past.
Change the Status of Open Service Definitions to No New Users where the End Date is today or in the past.
- ClearDiscounts
- Remove the relevant Discount information from Accounts/Users/Packages/Services when Date Discounts Expire and/or Date Usage Discounts Exipre is today or in the past.
- ChangeToBilling
- Bill the billing changes needed for Service Changes. The actual change may be in the future, but due to pre-billing, the new rate may need to be assessed earlier. Billing results in Pending Transactions.
- ChangeToProvisioning
- Execute the provisioning changes needed for a Service Change.
- ChargeForUsage
- Bill for Usage. Billing results in Pending Transactions.
- ResetUsageCounters
- Clear usage counters for Services that have usage collected but not billed.
- ReopenOverUsageServices
- Open Services that were Suspended for over usage if a new term is in effect.
- BillServics
- Bill Services and Packages where the combination of Next Bill Date and Account Profile Bill Timing setting indicate that the Service should be billed. Billing results in Pending Transactions.
- SetNextUsageDates
- Set the Services Next Usage Date where ChargeForUsage was not used.
- UpdateStaticBalances
- UpdateStaticPastDueBalances
- Update the financial fields stored in the Account table that summarize the Account's financial status.
- ResetGraceDates
- Clears Accounts' Grace Dates that are in the past.
- SendUsageReports
- Send Usage reports to customers as indicated in Usage Tier Plans.
- PurgeSamples
- Delete billed Usage data based on Usage Tier Plan Purge Sample Frequency.
- IssueReferralCredits
- Issue referral credits. This results in Pending Transactions.
- AssessLateFeesByMonth
- When applicable, assess Late Fees base on the monthly balance.
- AssessLateFeesByInvoice
- When applicable, assess Late Fees based on each overdue Invoice.
- ResetOverDueCounters
- Clear data tracking late notices if the Account is no longer overdue.
- ReopenOverDueAccounts
- Reopen any Accounts that were Suspended for being overdue but are no longer overdue.
- ReopenOverDueServices
- Reopen any Service that were Suspended for being overdue but are no longer overdue.
- SuspendOverDueAccounts
- Suspend overdue Accounts and Services.
- SetFinactivity
- Flag Accounts that have Pending Transactions.
- DoInvoicing
- If applicable, created Invoices from Pending Transactions.
- OpenWaitForPaymentServices
- Open Services that have Status Wait For Payment of which the billings have been paid.
- WarnCCexpiration
- Send an e-mail to customers who have a credit card on file with an upcoming expiration date.
- WarnServiceExpiration
- Send an e-mail to customers who have a Service with an upcoming End Date.
- WarnGraceDate
- Send an e-mail to customers who have a Service with an upcoming Grace Date.
- CloseNotes
- Close expired Notes.
- CloseExpiredServiceAgents
- Close Service Agent Commission entries that have an End Date today or in the past.
- NoticeLongSuspendAccounts
- NoticeLongSuspendUsers
- NoticeLongSuspendServices
- NoticeAccountLocks
- NoticeRefundsDue
- NoticeLicenseExpiration
- NoticeUnFundedRefunds
- Generate various system notices that will be output to the log file.
- ProcessNightlyTemplates
- Process any Customer Notices.
- CollectStats
- Collect statistics.
- CleanTrackProcess
- Delete old entries tracking Authorized Users use of BillMax.
- RemovePaymentInfo
- Remove credit card and bank information from Accounts that have been closed the requisite number of days.
- efpbatch
- There are two process, one for collecting via credit card and debit card, the other for collecting via electronic check.
- finalize_billing
- Assesses any Document Fees and creates a Billing Statement record if appropriate. Uses the systemstate List item finalize_billing date to keep track of the last time it ran. This date is very important for catching up billing if the process was disabled for any reason.
- queue_billingdocs
- Creates database records for Invoices and Billing Statements that will be rendered and sent to the customer via e-mail or print. Uses the systemstate List item queue_billingdocs date to keep track of the last time it ran for performance reasons.
- send_documents
- Creates the document XML data, renders the documents and sends them.
- managedocuments
- Uses a file of XML directives for database entry and file retention purposes for Documents. The XML file will specify how long various Document types should be retained. As delivered BillMax uses the file /usr/local/billmax/local/manageDocuments.