MD.

070 - MODULE TECHNICAL

DESIGN

AR Open Invoice Conversion

Author:
Creation Date: August 11, 2000
Last Updated: August 11, 2000
Control Number: 1
Version: 1

Approvals:

<Approver 1> Alan Goodrich

<Approver 2>
 1

Document Control

Change Record

Date Author Version Change Reference

11-Aug-00 1 No previous document

Reviewers

Name Position

Distribution

Copy No Name Location

1
Library Master Project Library
2 Project Manager
3
4

AR Open Invoice Conversion Data Mapping - Mapping Table ii

370099514.doc (v. ) Company Confidential - For internal use only
 1

Contents

Document Control

Technical Overview
Approach
Module List

GST_INVOICE_CONV.CTL- Control File

SQL Error Report - Report Interface

Data Mapping - Mapping Table

AR Open Invoice Conversion Data Mapping - Mapping Table iii

370099514.doc (v. ) Company Confidential - For internal use only
Technical Overview
This document defines the technical components required to implement customization Open
Invoice Conversion Interface.

Approach
Since this will be a one time conversion, the standard Oracle AutoInvoice Interface will be used
to load open Accounts Receivable invoices from s curent system. The data will be cleaned and
sent via a flat file and loaded into RA_INTERFACE_LINES_ALL using SQLLOADER. Data
willalso be loaded into RA_INTERFACE_SALESCREDITS_ALL table using SQLLOADER
since s autoaccounting rules require to give sales credit based on the receivable and revenue
account of the salesperson. For this reason, conversion salesperson records will have to be
created as set up for this conversion. There will need to be one set up for every different accounts
receivable account (one for Trade receivables, and one for each affiliate receivables account).

Once the data is loaded the AutoInvoice Import will be executed using path RAX \ Interfaces \
AutoInvoice.

Open credit memos and debit memos will be loaded as open invoices. In other words, credit
memos with negative amounts will be loaded as negative invoices.

To simplify this conversion, and to increase the conversion success rate, each open invoice will be
converted as a lump sum record which includes any tax, freight, and other special charges in the
open gross amount. All open invoices will be converted as a LINE line type. This means that
once when the open invoice is imported into Oracle, the line amount will also include the tax and
/or freight. The credit manager accepted this procedure and will deal with the any taxes and
freight charges after the conversion. Also, all debit and credit memos will be imported as open
invoices with their reason code.

The unsuccessfully converted Open Invoices will be reviewed in the

RA_INTERFACE_ERRORS_ALL table and any errors will be corrected and the interface will be
run again.

NOTE: This conversion requires setups to be performed to define the conversion accounting
rules. A Batch Source Name and Customer Transaction Type Name must be set up for each AR
account that will be imported. Also, since another conversion is importing General Ledger
Balances, the setups for this conversion will be set not to post to the General Ledger. The
Miscellaneous form of setup/system options must be changed to not Require Salesperson. After
the conversion has been completed, this option must be reset to Require Salesperson.

NOTE 2: Initial build and testing is being conducted without multi-org set. Multi-org will be
turned on while production setups are being completed. Changes will then need to be made to
the control file to be able to work with multi-org in affect.
Module List

Concurrent Programs
AutoInvoice conversion includes the following concurrent programs:

gst_sql_load A generic unix script that calls sqlload for the given
parameters of control file and data file.

SQL*LOAD Control File

AutoInvoice conversion includes the following SQL*LOAD Control Files:

GST_INVOICE_RAIL.ctl A sqlloader control file is used to load data into the

RA_INTERFACE_LINES_ALL.

GST_INVOICE_RAIS.ctl A sqlloader control file is used to load data into the

RA_INTERFACE_SALESCREDITS_ALL.

Error Report SQL Script

AutoInvoice conversion includes the following SQL Report Script:

GST_INVOICE_IMPORT.sql A SQL script to report any errors encountered by the Standard

Oracle AutoInvoice Interface.

Delete Records from Interface SQL Scripts

AutoInvoice conversion includes the following SQL Script:

GST_RAIL_DELETE.del A sql script to report delete records from

RA_INTERFACE_LINES_ALL that have a description of
conversion.

GST_RAIS_DELETE.del A sql script to report delete records from

RA_INTERFACE_SALESCREDITS_ALL that have a
description of conversion.
GST.INVOICE_RAILctl - Control File
This is a basic control file to load open invoice data into the RA_INTERFACE_LINES_ALL for
the Open Invoice Conversion Interface.
load data
append
into table ra_interface_lines_all
(
AMOUNT position(33:47),
BATCH_SOURCE_NAME position(233:244),
CONVERSION_DATE sysdate,
CONVERSION_RATE constant '1',
CONVERSION_TYPE constant 'User',
CURRENCY_CODE constant 'USD',
CUST_TRX_TYPE_NAME position(233:244),
DESCRIPTION constant 'CONVERSION',
INTERFACE_LINE_ATTRIBUTE1 position(25:32),
INTERFACE_LINE_CONTEXT constant CONVERSION,
LINE_TYPE constant 'LINE',
ORG_ID constant '102', (This needs to be reset with new ID)
ORIG_SYSTEM_BATCH_NAME constant 'CONVERSION',
ORIG_SYSTEM_BILL_ADDRESS_REF position(254:283),
ORIG_SYSTEM_BILL_CUSTOMER_REF position(9:16),
ORIG_SYSTEM_SOLD_CUSTOMER_REF position(1:8),
PRIMARY_SALESREP_NUMBER position(254:259),
PURCHASE_ORDER position(100:124),
REASON_CODE position(70:99),
SALES_ORDER position(125:132),
SET_OF_BOOKS_ID constant '1', (This needs to be reset with new ID)
TERM_NAME position(55:69),
TRX_DATE position(245:253),
TRX_NUMBER position(25:32)
)
GST.INVOICE_RAIS.ctl - Control File
This is a basic control file to load open invoice data into the
RA_INTERFACE_SALESCREDITS_ALL for the Open Invoice Conversion Interface.
load data
append
into table ra_interface_salescredits_all
(
INTERFACE_LINE_ATTRIBUTE1 position(25:32),
INTERFACE_LINE_CONTEXT constant CONVERSION,
LINE_TYPE constant 'LINE',
ORG_ID constant '102', (This needs to be reset with new ID)
SALES_CREDIT_PERCENT_SPLIT constant100,
SET_CREDIT_TYPE_NAME constant 'QUOTA SALES CREDIT',
SALESREP_NUMBER position(254:259)
)
SQL Error Report - Report Interface
An SQL Report to list all errors encountered with each interface run.

GST_INVOICE_ERROR_Report.sql
select e.interface_line_id,
e.message_text,
e.invalid_value
from ra_interface_errors e, ra_interface_lines_all i
where e.interface_line_id = i.interface_line_id
and i.description like 'CONVERSION%'
SQL Delete - RA_Interface_Lines_All
An SQL script to delete AutoInvoice rows from the ra-interface_lines_all table pertaining to the
conversion.

GST_RAIL_DELETE.sql
Delete from ra_interface_lines_all where description like 'CONVERSION%'
SQL Delete - RA_Interface_SALESCREDITS_All
An SQL script to delete AutoInvoice rows from the ra_interface_salescredits_all table pertaining to the
conversion.

GST_RAIL_DELETE.sql
Delete from ra_interface_salescredits_all where salesrep_number between 911000
and 919999
Data Mapping - Mapping Table

RA_INTERFACE_LINES_ALL Data Type Req Source System Source System Field Data Type Comments Interface
Field File Name
AMOUNT NUMBER AROPENP OIAMO 143:157
BATCH_SOURCE_NAME VARCHAR2(50) Y 314:325 CONVERSION
+ AR Code
CONVERSION_DATE DATE sysdate
CONVERSION_RATE NUMBER 1
CONVERSION_TYPE VARCHAR2(30) Y User
CURRENCY_CODE VARCHAR2(15) Y USD
CUST_TRX_TYPE_NAME VARCHAR2(20) 314:325 CONVERSION
+ AR Code
DESCRIPTION VARCHAR2(240) Y CONVERSION
INTERFACE_LINE_ATTRIBUTE1 VARCHAR2(30) AROPENP OIDNO 25:32
INTERFACE_LINE_CONTEXT VARCHAR2(30) CONVERSION
LINE_TYPE VARCHAR2(20) Y LINE
ORG_ID 102 Set to new ID
ORIG_SYSTEM_BATCH_NAME CONVERSION
ORIG_SYSTEM_BILL_ADDRESS_REF VARCHAR(240) AROPENP OICITS 9:16
ORIG_SYSTEM_BILL_CUSTOMER_REF VARCHAR(240) AROPENP OICUST 1:8
ORIG_SYSTEM_SOLD_CUSTOMER_REF VARCHAR(240) AROPENP OICORP 1:8
PRIMARY_SALESREP_NUMBER 254:259
PURCHASE_ORDER VARCHAR(50) AROPENP OIPON 174:198
REASON_CODE VARCHAR(30) AROPENP OIRSCD 100:124
SALES_ORDER VARCHAR(50) AROPENP OISON 199:206
SET_OF_BOOKS_ID NUMBER(15) Y 1 Set to new ID
TERM_NAME VARCHAR(15) AROPENP OIPMCD 55:69 xref to Oracle
TRX_DATE DATE AROPENP OIDCDY+MO+YR 245:253
TRX_NUMBER VARCHAR(20) AROPENP OIDNO 25:32

Note:
1. The new ID value for ORG_ID must be set in this control file. Currently set as 102.

Select organization_id from hr_organization_units where name = US OPERATIONS;

2. The new ID value for SET_OF_BOOKS_ID must be set in this control file. Currently set as 1.

Select gl_sets_of_books_id from gl_sets_of_books;

Data Mapping - Mapping Table

RA_INTERFACE_SALESCREDITS_ALL Data Type Req Source System Source System Field Data Type Comments Interface
Field File Name
INTERFACE_LINE_ATTRIBUTE1 VARCHAR2(30) AROPENP OIDNO 25:32
INTERFACE_LINE_CONTEXT VARCHAR2(30) CONVERSION
ORG_ID NUMBER Y 102
SALES_CREDIT_PERCENT_SPLIT NUMBER 100
SALES_CREDIT_TYPE_NAME VARCHAR2 QUOTA SALES
CREDIT
SALESREP_NUMBER NUMBER 254:259

Note:
1. The new ID value for ORG_ID must be set in this control file. Currently set as 102.

Select organization_id from hr_organization_units where name = US OPERATIONS;

2. The new ID value for SET_OF_BOOKS_ID must be set in this control file. Currently set as 1.

Select gl_sets_of_books_id from gl_sets_of_books;