Professional Documents
Culture Documents
RFP #1163-17-GMK
Comprehensive Facilities Asset
Management System
Exhibit 6
Description
The purpose of this interface is to create new customers, new invoices and add new
contacts.
Customers: A customer must exist in the system before billing can occur. Data from
side systems will be loaded into a staging table, allowing the standard Oracle
Receivables Open Interface to transfer this data to Oracle Receivables.
Business Rules (EBS)
1. This interface will create new customers in Oracle by importing data from side
systems.
New Customers will be assigned a sequential Registry-ID number and a
sequential Account number.
New Accounts for existing customers will be assigned a sequential Account
number.
An additional address validation process will occur to promote postal
standards.
New customers will merge with existing Customers if the name, address, and
profile are the same.
A new account will be created if the name, and address are the same but the
profile is different.
2. Import Validations must occur. Before import from the interface tables into
Oracle EBS, a record must pass import validation. All elements of an interface
table record must succeed, or the entire record is considered in error. Records
that fail validation are marked, and all errors for one record are captured after
the entire record is validated. After validation, only successful records are
imported into the Customer tables.
3. Any record that fails in the customer interface process must be corrected in
order for the record to be accepted.
Any error related to the record itself, such as missing information or
incorrect data (alpha instead of numeric) must be corrected before the
record is validated and entered into Oracle. The majority of errors can
usually be corrected online through the interface lines form within
Receivables or by adding a new setup value (i.e. new payment terms).
If the information cannot be corrected and validated, it will be necessary
to correct the data at the source system and brought over again. The
original customer data must be deleted from the interface tables, the
RFP #1163-17-GMK
Comprehensive Facilities Asset
Management System
Exhibit 6
Invoices: The purpose of the invoice interface is to provide the necessary data for
generating transactions (invoices) from King County side systems into Oracle
Receivables. The invoice billing data is imported to Receivables via an interface using
the AutoInvoice process. The AutoInvoice interface processes data and populates the
appropriate fields in the Receivables transaction (invoice) table. The data is utilized in
the generation of the Customer Invoice. King County side systems will provide the data
which is loaded into the AutoInvoice interface tables. The running of the AutoInvoice
Import or Master program transfers the transactions from side systems into
Receivables. Oracle Receivables ensures that the data imported is accurate and valid
prior to creating the transaction. If the record cannot be validated, it stays in the
interface tables and is marked as an error and information is provided to identify the
invalid data.
To modularize the Invoice Creation Script, the basic structure is divided into four parts:
Get all the default values from profiles and AR SYSTEM PARAMETERS table.
Populate the staging tables from side systems file and update Default values
Validate all the parameters entered by the user.
Run the AutoInvoice process.(Open)
This results in easy to understand and easy to maintain code. Any new functionality can
be added by a simple code plug-in at each of the four parts.
King County does not have sales representatives, so we will use the default No Sales Credit sales
representative in the interface table so that the transactions do not error out.
The Receivables interface uses the AutoInvoice Master Program to import the
transactions to Oracle Receivables.
Business Rules (Side System)
Side systems will use their system generated reference number to submit transactions.
Side Systems are required to use US Postal standards for addresses.
Values must be in all upper case.
Customers which have been previously sent through this interface should be
reused, if possible.
Each side system development team is responsible for setting up a process to
extract data in the format specified in ‘Required & Optional Fields’ section of this
document and send it to a staging area set up by the ABT development team.
Required & Optional Fields
The table below lists the required and optional fields from the file. Required fields are
RFP #1163-17-GMK
Comprehensive Facilities Asset
Management System
Exhibit 6
the fields that must be provided by the side systems. All records including those with
different record types will be in one file.
Field Field Name Data Type Length Required? Description
Order
1. RECORD TYPE TEXT 2 Required Fixed value “B1” for all customer
related data.
2. ORIG SYSTEM CUSTOMER REF TEXT 240 Required This is the side system issued
customer number. It must be a
unique identifier.
RFP #1163-17-GMK
Comprehensive Facilities Asset
Management System
Exhibit 6
http://kcweb.metrokc.gov/des/
abt/Financelive/Side/values.asp
x
24. RAT_TERM_NAME_MIR TEXT 15 Optional Value Set:
2 MONTH BILLING
3 MONTH BILLING
6 MONTH BILLING
9 MONTH BILLING
12 MO BILLING
NET 5
NET 6
NET 7
NET 8
RFP #1163-17-GMK
Comprehensive Facilities Asset
Management System
Exhibit 6
59. ACCOUNT CLASS TEXT (20) Required Set this value to ‘REV’.
60. ATTRIBUTE CATEGORY TEXT 30 Not used Set this value NULL.
61. ATTRIBUTE1 VARCHAR2 150 Optional This attribute is in the Invoice
Line Information Flexfield. It will
only be used by those who want
to enter more line detail to the
memo line. On the printed
invoice the Memo Line and
Attribute1 will be concatenated
and displayed in the Description
field.
62. ATTRIBUTE2 TEXT 150 Not used Set this value NULL.
63. ATTRIBUTE3 TEXT 150 Not used Set this value NULL.
RFP #1163-17-GMK
Comprehensive Facilities Asset
Management System
Exhibit 6
HZ_RELATIONSHIPS
Address sharing: Multiple parties cannot share a single address. If the same
address applies to two parties, you must enter the address for each party.
Person records:
Organization records will be validated against company name, Bill To and/or
Ship To address, contact name, party relationship.
Contacts will be used whenever possible to direct the information to the
correct person if we are billing an organization.
Methods used for contact may be via phone, email, or letter.
Records that error in the interface process in Receivables must be corrected in
order for the record to be accepted.
Any error related to the record itself, such as missing information or
incorrect data (alpha instead of numeric) must be corrected before the
record will be validated and entered into Oracle. The majority of errors
can usually be corrected online through the interface lines form within
Receivables or by adding a new setup value (i.e. a new payment term).
If the information cannot be corrected and validated, it will be necessary
to correct the data offline. The original invoice data must be deleted from
the interface tables, the information corrected in the source system, and
then resent via the interface.
Other ,Other
Other, Other
The correct format should be: Other,Other
The data fields must be ordered based on the above table.
Required fields must have values. Optional fields can be blank, but keep the field
positions by using comma. Conditionally required fields need data based on
values present in other fields. (Details are explained in the description)
Comma is used as data field separator, so if the data field contains a comma, the
data needs to be optionally enclosed by the “ character. Example:
“Other,Other” would be treated as one field.
Sample Data
The following is sample data contained in the .csv and .xls file.
"To view the file in Excel format, save the attachment to your local drive and open it in Excel
using delimiter as comma."
AR_ARCUSTINV_201
10726095725.csv
HDR,AR,AR_INTF_001,IN,SWD,PARADIGM,ARCUSTINV,2011-07-26
09:57:25,devin.barnes@kingcounty.gov
B1,993549,1549962,BILL_TO,DOWN TIME INC,SWD NET 25 BFB,A,Y,18575 137TH DR
NW,,FLOOR 7,,OLYMPIA,WA,,THURSTON,98504,US,,,,,,
B1,993549,49962,SHIP_TO,DOWN TIME INC,SWD NET 25 BFB,A,Y,28575 137TH DR
NW,,FLOOR 7,,OLYMPIA,WA,,THURSTON,98504,US,,,,,,
B2,993549,1549962,1,1,EMILY,JACKSON,,,,,,,,,,,
B3,SWD PARADIGM,96576,Skykomish TS,2011,5,122893,2489,,,,,,,,,,SWD
PARADIGM,LINE,,10.00,2011-06-30,SWD INV,NET 25 BFB,2011-06-
03,,,993549,1549962,,,,,1,,10.00,,N,,,SWD COMMERCIAL,,SWD
PARADIGM,96576,,,,,,,,,,,,,, ,REV,,,,,,,,,,,,,,,,
B3,SWD PARADIGM,96576,Skykomish TS,2011,6,122893,2489,,,,,,,,,,SWD
PARADIGM,LINE,,1.00,2011-06-30,SWD INV,NET 25 BFB,2011-06-
03,,,993549,1549962,,,,,1,,1.00,,N,,,SWD TAX,,SWD
PARADIGM,96576,,,,,,,,,,,,,,,REV,,,,,,,,,,,,,,,,
B1,999534,443456,BILL_TO,PLAYGROUNDS INC,SWD NET 25 BFB,A,Y,38575 137TH
DR NW,,FLOOR 7,,OLYMPIA,WA,,THURSTON,98504,US,,,,,,
FTR,6,11.00,0,0,0,0
RFP #1163-17-GMK
Comprehensive Facilities Asset
Management System