Menu Path: From Billing & Receipts, select Miscellaneous Billing, select Invoices, and then select Import Invoices.
You can use this option to accept a file containing invoices created by a third-party software package. The imported invoices display as batch invoices which can be posted to accounts in the Miscellaneous Billing system.
The Import Process
The import process does the following:
-
Loads the 3rd party system import file using the layout described in the Import Invoices File section below. The data does not load into a table.
-
Sets the Control Number of all invoices created to the value entered on the Import Invoice window.
-
Applies the value entered in the Comment Line to all invoices created.
-
Validates the service code for each line of the file against the Services table.
-
Validates the item codes for each line of the file against the Items table. If the item code is missing or is in, the batch invoice will be created with a blank item code, and the invoice status will be set to "Hold." A message will display on the import invoice report.
-
Checks invoice numbers established by the 3rd party system to ensure that they do not already exist within Miscellaneous Billing. If no invoice exists with the number provided, then that number will be used to generate the invoice. If the invoice number does exist, a new invoice will be generated using the standard auto numbering process for invoices. These cases will be reported on the import invoice report.
-
Sets the Invoice Date and Due Date to 01/01/1950 if either field or both fields are blank or in. This will be reported.
-
Defaults the payment terms code from the Customer Defaults table.
-
Fills the Item Description and Unit Name fields based on the default values of the item codes for that item.
-
Uses the default accounting for all items. The default accounting is based on the Services and Items tables.
Entity Record Creation Process
Valid Customer Number in Input File
-
The customer is used on the invoice.
-
If a customer name in the import file does not match the name on the existing customer record, a message prints on the invoice import report.
-
If Billing Address 1 and Billing city/state/zip in the import file and the address fields do not match the customer's billing address for the entity, a message prints on the invoice import report.
-
If the service does not exist for the customer, a service record is created using the penalty and interest codes from the Services reference table.
In Customer Number Or No Customer Number provided in Input File
-
If any Entity Information fields are blank on the Import Invoice window, the record will be rejected.
-
If Customer Name, Billing Address Line 1, or Billing city/state/zip fields are blank, the record will be rejected.
-
If the Billing city/state/zip fields cannot be split into distinct City, State, and Zip Code fields, the record will be rejected.
-
If the record has not been rejected, the process searches for an existing entity with the customer name and Billing Address Line 1, City, State, and Zip Code.
-
If an exact match cannot be made, a new entity is created with a mailing address using the address information provided in the import file, and a new customer is created.
-
If an entity is found, the first entity found is used. This entity is used to search for an existing Miscellaneous Billing customer using the entity and the entity address. The first customer match to be made is used. If no customer is found, a new customer is created using the entity and billing address found.
-
-
If the Autonumber Customers flag on the Miscellaneous Billing profile is set, then new customers created will use the Auto Numbering method within Miscellaneous Billing. If this flag is not set, the customer number provided in the import file is used as the customer number. If there is no customer number, the Auto Numbering method is used.
After the batch invoices have been created, you may review, update and post the invoices using the standard Batch Invoice options within Miscellaneous Billing.
You must correct any invoices in a Hold status and set them to Active status prior to posting the invoices. If these invoices are not corrected, they will not be posted as online invoices.
Import Invoices File
The import file is an ASCII pipe-delimited ( | ) file containing records in the following layout. One record per line.
The following fields are not required if you have a Customer Number:
-
Customer Name
-
Billing Address Line 1
-
Billing Address Line 2
-
Billing City/State/Zip
|
Field Name: |
Format / Max Length: |
Description: |
|---|---|---|
|
Sequence Number |
Integer |
Sequential increasing number starting at 1 |
|
Customer Number |
Character/10 |
Miscellaneous Billing Customer Number |
|
Purchase Order Number |
Character/10 |
Purchase Order Number from 3rd party system |
|
Invoice Number |
Character/10 |
As defined by the 3rd party system |
|
Service Code |
Character/4 |
Service Code for the Invoice Verified with the Service Code Reference Table |
|
Invoice Date |
MM/DD/YYYY |
Date invoice was created |
|
Due Date |
MM/DD/YYYY |
Date payment is due on the invoice |
|
Item Number |
Integer |
Number of items in order - each item will start with 1 and increase per line |
|
Items Code |
Characer/8 |
Billing Item code for the line items. Verified with Items Reference Table |
|
Sales Tax |
Character/1 |
Y if sales tax is charged, N if it is not |
|
Quantity |
Decimal 12,4 |
Quantity for Line Item |
|
Unit Price |
Decimal 12,4 |
Per item prices for the line item |
|
Total Prices |
Decimal 12,4 |
Total prices of line item (quantity x unit prices) tax not included |
|
Tax Amount |
Decimal 12,4 |
Tax for the line item |
|
Customer Name |
Character/35 |
Customer name |
|
Billing Address Line 1 |
Character/35 |
Billing address line 1 |
|
Billing Address Line 2 |
Character/35 |
Billing address line 2 |
|
Billing City/State/Zip |
Character/39 |
Billing city, state, and zip code |
Import invoices
-
Complete the fields in the Import File Information and Default Entity Information sections. For details, refer to the Fields section below.
-
Click OK to import the file. If you encounter any errors, a Rejection or Citation/Error message displays.
Fields
Import File Information Section
|
Field |
Description |
|---|---|
|
Control Number |
Number identifying the batch. |
|
Import File Name |
Location of the file from the third party billing system. The default directory is the value $RMSTAPDIR (usually /spi/spicps/media). The default file name is invoices.imp. |
|
Comment Line |
Comment to appear on the import. |
Default Entity Information Section
These fields will default as defined in the profile. If any of these fields are left blank, any records in the import file that need to have an entity created will be rejected.
|
Field |
Description |
|---|---|
|
Default Entity Type |
The default type for the entities created in the import. |
|
Default Address Type |
Default type for the address created in the import. |
|
Default Mail Code |
Default mail code for the import. |