Start Compute Service Invoice


This function is used to generate, print and post invoices for work orders referencing 'Service Compute' Jobs.


As with other types of billing, all information is ultimately stored in Job History. However, the work order itself is  used to make adjustments to revenues billed. Therefore, all work orders that you intend to bill should be properly adjusted, and flagged as Invoice Ready.

Jobs with a Tax Status of ‘Unknown’
The Service Invoice Compute skips all jobs with the ‘Unknown’ tax status. The Job must be updated to reflect the correct status before the job can be invoiced.

PM Work Orders - Extras
Extras may be billed on PM WO’s even if the WO’s PM Invoice Id is set. If the invoice id on the imported line matches the PM Invoice Id on the Work Order, these lines can be marked as extra and billed.

Billing Items Missing or Not Flagged
Start Compute Service Billing rejects any work orders where any of the following is true:

Any unbilled job history with Revenue that references this work order with no Job Billing Item.
Any unbilled job history with Revenue whose Job Billing Item does not have the OK to Bill flag set.

In either case, the system displays a description of the problem, and the work order(s) that are causing the problem. If the billing item was not flagged as ‘Ok to Bill’, simply flag it and rerun the invoice. If the billing item is missing, contact your support representative. To prevent these problems in the future, contact your support representative for a registry entry to make the Billing Item a required field in New Call. You may also wish to make the Billing Item a required field in the Job Cost Code, and the Client Site Equipment record (default service job).

COD Work Orders and Template Clients

Click COD Work Order Validation for detailed information special validation for these work orders.

Service Billing Overview

Click Service Invoice Overview for suggestions on the use of this functionality.

Registry Entries:

Registry Entry Start Service Billing Compute

When using a registry entry with the Branch (sys-report-serviceinvoice-branchid) specified, Service Compute uses the Branch Id of the user running the function.  However, an override may be specified to use the Site's Branch to specify the invoices' bitmap.  See Specify Override Bitmap by Site's Account Manager, Service Manager, Dispatcher or Branch for details on implementing this functionality.

Important Fields: Range Screen

Bill Thru Date:
Line item charges with effective dates after the Bill Thru Date will not be included on the invoice. This field is required.

Invoice Date:
The date that you wish to appear on the invoice. This date defaults to today but may be changed by the user. This is a required field.

Effective Date:
The date that the system will use when posting the invoices to AR. This date defaults to today but may be changed by the user. This is a required field.

Period Id:
The active accounting period to which these invoices should be posted. The system will display the default accounting period (if one is defined) when this function is opened. This required field may be changed by the user. The ability to right-click to open the Accounting Period is not allowed due to Invoice Archiving validations.

Invoice Comments Id:
If you would like specific comments to be included on this invoice, enter a valid Invoice Comments Id or double-click to select one from a list. Typically, this feature is used to include payment instructions on invoices or to notify the customer of special deals (e.g., spring or fall maintenance) or services available. This field is optional.

Company Id:
If Intercompany Processing is enabled, this field is required to run Service Invoices. The Service Invoices generated will use the bitmaps specified by the sys-report-serviceinvoice-securityid registry unless overridden by a user-specific registry.

Job Id:
To process all eligible service invoices for Jobs, leave this field blank. If you only wish to compute the invoices for a specific Job, enter its Id. A range of Jobs can be specified by separating the first and last Id with an underscore: 1001_1025. A series of Jobs can be specified by listing Job Id's separated by commas: 1001,1005,1025.

Workorder Id:
To process all eligible work orders, leave this field blank. If you only wish to compute the invoices for a specific workorder, enter its Id. A series of WorkOrders can be specified by their Id's separated by commas.

Bill Cycle:
This field lets you specify the Billing Cycle (maintained in the Job record) of the Invoices to be computed. To compute eligible invoices for Jobs with a blank Billing Cycle, simply leave this field blank. To compute eligible invoices for jobs that do not contain a blank Billing Cycle field, simply enter the 1-character Billing Cycle designation that you wish to post.

Billing Agent User Id:
By default, the system will enter your user Id in this field: only those invoices for which you were the billing agent will be included on the checklist. (Note that in each work order, the Billing Agent is either set in New Call or when the work order is flagged as Invoice Ready.) To include work orders for all billing agents, blank this field. If Branches are implemented on your system, this field would rarely be cleared out (see the Registry Entries section of this help topic for details).

WO Type:
If you leave this range blank, work order invoices of all types will be computed. To compute and print a specific type of work order invoice, enter that type.


To compute only eligible PM Invoice Work Orders, enter PM Invoice in the WO Type field. See the Registry Entry for Creating a PM Billing Work Order Invoice for details on PM Invoices.

Escalation Status:
If you leave this range blank, all eligible work orders will be computed, regardless of their Escalation Status. Recalled that work orders flagged as Invoice Ready, and whose Jobs are NOT on hold are considered eligible.

To limit the compute to eligible work orders of a specific Escalation Status (e.g., Invoice Review), enter it in this range field. A series of statuses can be entered, separated by commas.

WorkOrder Status Category:
This field may be used improve performance of this function by skip archived work orders. To do so, it should be set to !=archived manually or via registry. Note that Work Orders may be set to Archived by manually adding a Technician line with status Archived, or by using the Start Archive Work Orders or Start Autoarchive Work Orders.

Equipment Detail – Off On:
If you select the ‘On’ option, the Equipment Name and Work Performed (from the Equipment Tab) will be included on the invoice.  Typically, this option would NOT be used in conjunction with the  "Equipment Work Performed Addendum - Show on Invoice" functionality enabled in the work order.

AR Summary – Off On:

If you select the On option, a job-specific AR Summary will be included after the invoice total.

image\go.gif When you have completed all fields properly, click the Go button to continue and display the Service Compute Checklist.

Important Fields: Service Compute Checklist

This field enables you to select the work orders to be invoiced. Double-click on the Ok field to select or deselect an item (alternately, press the spacebar when the caret appears on this field); a check appears in the Ok field when that work order is selected. Refer to the Important Buttons section of this Help topic for details on selecting or deselecting all items.

Job Id: LAB Revenue: OTH Revenue: TOT Revenue: Job Name: Sales Tax Base:
WO Id: MAT Revenue: SUB Revenue: Sales Tax: Workorder Name: Invoice Total:

These informational fields are displayed to enable you to verify which work orders should be invoiced.

Sales Tax: M Notation
If the Sales Tax Amount has been manually entered in the WO, it will be denoted by the presence of an 'M' to the right of the Tax Amount on each individual line.  If the 'M' is not present, then the tax was computed by the system and is not visible from within the WO viewer.

Amount Paid
This field displays the amount that is being applied to this invoice via COD or APT Credit Card Processing.

Invoice Email:
This display field will be completed if this invoice will be emailed.

Skip Print Invoice?
This display field will be flagged if this invoice will be emailed AND the functionality to skip print emailed invoices is enabled via registry.

Important Buttons:

Click the Check button to check (select) every item on the list.

Click to de-select every item on the list.

  Click to invoice and post the selected work orders.