How to use the XLS to AL3 Integration Utility
This article describes how to use the XLS to AL3 integration utility for AMS360. This custom utility converts a direct bill statement from an Excel file to an AL3 file.
This is an add-on product for AMS360which requires the Direct Bill Statement Download license. To purchase the license, contact your Vertafore Account Manager. |
Any user with Owner security permissions is able to access the Customer XLS to AL3 Utility.
- From the 360 Toolbox menu, select Launch Programs > Custom XLS to AL3 utility.
- At the Input File Name box, click Browse and select your .xls file. The Excel file must be closed before you can convert it with the utility.
- The Output File Name populates where the AL3 file will be saved. Record this path and file name.
- Select the appropriate company from the AMS360 Parent Company list.
- Select a Statement Date.
- Select Default Template from the Select Template drop-down list.
- Click Convert.
When the message "XLS to AL3 Export completed successfully appears," click OK and then close the Utility dialog box.
If you receive an error while converting the file, a message appears and reference a text file. See the Additional Information section below. |
- When you have the AL3 file you can process it using the download functions.
- From the 360 Toolbox menu, select Integration > Download > Move Download Files.
- Browse to the location and select the file provided in the Output File Name box in Step One above.
- Click Open. The file is processed.
You will want to check the Customer/Policy Assign area in AMS360 after downloading each file to see if any accounting transactions must be manually matched to a customer and/or policy in AMS360.
- From the 360 Toolbox menu, click Integration >Download >Assign Customers/Policies.
- Select Accounting Transactions.
- Assign any unmatched transactions to the appropriate customer and policy.
- Once all items are assigned, click Save and Close.
- In the Company center of AMS360, view the company for the statement and either create the statement or view the register to locate the In-Progress Direct Bill Entry statement, depending on which option you have sent for the company.
You now need to create and/or post the Direct Bill Statement. This process occurs in the Company Center for the company named in the statement.
- In AMS360, click the Company tab.
- Search for and open the company named in the statement.
- Depending on the option you have set for the company do one of the following:
If you have set Direct Bill Entry for this Company:
- In the Sidebar menu under Views, select Register and locate the In-Progress Direct Bill Entry statement and click the link to open it.
- Review the statement and when finished, change the Status to Ready to Pay.
- Click Post (green pushpin) on the toolbar.
- OR -
If you have set Direct Bill Statement for this Company:
- In the Sidebar menu under Actions, select Direct Bill Statement.
- Make the selections based on the statement you've imported using the XLS to AL3 Utility.
- Click Create Statement.
- The Statement opens where you can manually or auto-match transactions.
- When you have finished matching transactions, change the status of the statement to Ready to Pay.
- Click Post (green pushpin) on the toolbar.
If you receive an error during the XLS to AL3 conversion, use the tips that follow to validate the formatting in your Excel file is correct.
If you need an example blank template for Excel, you can click the Export Blank Template button on the Custom XLS to AL3 Utility dialog box. |
- Columns must be in the correct order and all fields filled in. There must be one header row, but no footer row.
- Line of Business code must match an active LOB Code in the management system.
- Transaction Type must be a legitimate AL3 code, e.g. NBS, REW or PCH.
- Commission percentages are always formatted as a decimal, i.e. 3.75% must be shown as .0375.
- Negative amounts are always displayed with a minus sign, not parentheses, i.e. -125.30 not (125.30).
- Transaction Effective Dates must fall within the policy term dates.
- The columns should have the following formatting set:
| Column | Formatting |
|---|---|
| A, B, D, and H | General |
| C, I, and J | Date |
| E | Number |
| F and G | Currency |
Use Find and Replace (ctrl+f) in Excel to locate and remove any commas or special characters from the data.
Sample:

We have seen cases where the session log shows an error or unable to load statement record for item number XXX, due to missing policy effective date. In this situation try saving the excel file as a CSV and closing it. Open the file again and save as XLS and close it. Then try the integration again. Also make sure the file is not open in Excel when trying to upload it.
Before using the utility, please verify the following company setups:
- The carrier that sent the XLS must be set up for download in AMS360 as an Insurance company. AMS360 can't download commissions to a broker.
- The company must have an NAIC code. It can be fictitious. It must be unique and no more than six characters and must be entered at the parent level (under the Company Name - not under the writing companies).
- The company must also have a download address. It can be fictitious and must be 12 characters. For example: IBMBLUECROSS.
More information can be found in the Help topic - Custom XLS to AL3 Utility.
- PAB - Premium audit
- PCH - Policy change
- POL - Policy (unspecified)
- REI - Reinstatement
- REW - Rewrite
- RWX - Non-renewal notified PolHolder
- XLC - Cancellation confirmation
- XLN - Cancellation request
- ARR - Anniversary re-rate
- NBQ - New business quote
- NRA - Non-renewal notified Agency
- PCQ - Policy change quote
- PNQ - Policy inquiry
- RIX - Reissue
- RNR - Reversal of non-renewal
- RRQ - Renewal requote
- RWQ - Renewal quote
- RWR - Renewal request
- SYN - Policy Synchronization
- SYR - Policy Synchronization Request
- BNB - Binder New Business
- BND - Binder Billable
- BPC - Binder Endorsement
- BRW - Binder Renewal
- NBS - New business
- RWL - Renew policy
- STL - Installment