Sie sind auf Seite 1von 30

Technical Design Document

TECHNICAL DESIGN DOCUMENT


Vendor Conversion
Author: Creation Date: Last Updated: Document Ref: Version: 03/01/2011 04/07/2011 1.0 Draft

Approvals:
Client Tech Lead/Manager

1. Document Control
Change Record

C04.TD.AP.VendorConversion Page 1

Technical Design Document

Date 3/01/2011

Author

Version 1.0

Change Reference Created

Reviewers
Date Reviewed Name Position

Distribution
Copy No. Name Location

Note to Holders: If you receive an electronic copy of this document and print it out, please write your name on the equivalent of the cover page, for document control purposes. If you receive a hard copy of this document, please write your name on the front cover, for document control purposes.

Table of Contents
1 SUMMARY......................................................................................................................................4 2 DATABASE OBJECTS....................................................................................................................9
C04.TD.AP.VendorConversion Page 2

Technical Design Document

3 PROCESSES AND INTERFACES IMPACTED............................................................................22 4 MODULE SPECIFICATIONS........................................................................................................23 5 DATA CONVERSION....................................................................................................................26 6 TEST PLAN...................................................................................................................................27 7 OPEN / CLOSED ISSUES............................................................................................................28 8 IMPLEMENTATION NOTES.........................................................................................................29 9 APPENDIX....................................................................................................................................30

C04.TD.AP.VendorConversion Page 3

Technical Design Document

1 SUMMARY
This design document talks about the Vendor Conversion to Oracle AP Suppliers module of E Business Financials from Legacy systems. The design document for the conversion program defines the logic and the key assumption rules as required in order to carry out the Vendor conversion process. This document details various sections in order to provide all the information as required by the Vendor conversion process.

1.1 Requirements Overview


Conversion of vendors from SOAR system to Oracle E Business Suite AP Suppliers. This document describes the technical specifications for data conversion of Legacy Vendors to the Oracle EBS application Payables. Reference Document Functional Design Document Document Name C04.FD.PO.Vendors.docx

1.2 Technical Overview


The purpose of this document is to detail the steps for conversion of Vendor data from the SOAR system to Oracle EBusiness Suite AP Suppliers. SOAR system will deliver the Vendor data file in Comma Separated file format as per the layout specifications defined in this document. The conversion program will read the file and perform the necessary validations and import the data into Oracle AP Suppliers. Conversion Program Details: The custom request set XXDCG : Load Vendors is compromised of two request stages (1) XXDCG: Read Vendor data File This program reads the Vendor data file specified by the user (user entered parameter input file name) from $XXDCG_TOP/inbound directory and archives the file. The program then uploads the data into the custom table xxdcg_vendor. (2) XXDCG: Load Vendor Data This program validates the vendor data from the custom staging table xxdcg_vendor and derives the necessary default values for the vendors to be imported into Oracle EBS. The vendors are loaded with a status of POST. The successfully processed rows are marked with status of S in the custom table xxdcg_vendor. Any validation errors encountered are logged in the log file. The approach for this conversion is to use SQL*Loader to load the flat file data into the custom staging table. Using the PL/SQL package, validate the vendor data and transfer the validated data to Supplier Interface tables.

C04.TD.AP.VendorConversion Page 4

Technical Design Document

1.3 Logic Flow


The following process will be run to load the supplier conversion.

Vendor Load Conversion Process


Start

1 SOAR Extract Data XXDCG_VENDORS_LOAD data files

2 FTP File to Oracle Server

DCG Responsibilities
4 Validate Data 3 Load into Oracle Database
Oracle Application Server

XXDCG_VENDOR Staging Table


ERP Oracle Database

5 Populate the supplier interface tables ap_suppliers_int, ap_supplier_sites_int, and ap_sup_site_contact_int.


ERP Oracle Database

Yes
Success ?

Oracle Suppliers Tables


ERP Oracle Database

End

No
Report & correct the errors and rerun.

C04.TD.AP.VendorConversion Page 5

Technical Design Document

1.4 Dependencies and Assumptions

Foreign Key Dependencies None

Parent/Child Dependencies None

Quick Code Dependencies None

Data Element Domains None

Use of Sequence Generators None

The following are the Vendor load assumptions: The data from the SOAR system will be loaded into the staging tables. Any subsequent corrected data from Only those codes in the flat file will be loaded into the Oracle AP table. All extract development work will be performed by the District. The ASCII extracts will be formatted correctly to allow for direct loading of the files. 5. All validating and reviewing of the AP/PO data on the source systems will ensure that there are no duplicates and all necessary fields in the data are filled in. District will be responsible for the testing and validation of converted data.

1.4.1

Pre-requisites The following are the pre-requisites for loading Vendors into Oracle Application. The Oracle AP and PO setups must be complete which are as follows:

C04.TD.AP.VendorConversion Page 6

Technical Design Document

Vendor Type Lookup Code Organization Type Lookup Code Pay Group Freight Terms FOB Payment Method Payment Terms Ship Via The District requires Vendors to be identified. NOTE: The following steps shown are for verification only. These steps ensure the completion of application setup and configuration. AP/PO SUPPLIER SETUP: To see the current setup of Payables Options as it relates to the supplier first go ahead and login as DCG Public Sector Payables Manager and go to Setup->Options->Payables Options .

In order to look at the payables system setup go to Setup->Options->Payables System Setup. To setup different parts of a vendor start by going to Setup->Lookups->Purchasing and push F11 and put VENDOR TYPE. Click F11 and put ORGANIZATION TYPE for the Type and then click Ctrl-F11 and you will see the organization types. Click F11 and put PAY GROUP and then click Ctrl-F11 and you will see the Pay Group. Click F11 and put FREIGHT TERMS for Type and then click Ctrl-F11 and you will see all of the valid freight terms. Click F11 and put FOB for Type and then click Ctrl-F11 and you will see all of the valid fob types. Close out and go to Setup->Lookups->Payables and click F11 and put PAYMENT METHOD for the TYPE and then click Ctrl-F11 so you can see and add values for payment method.
C04.TD.AP.VendorConversion Page 7

Technical Design Document

Close out and then go to Setup->Invoice->Payment Terms and then do a F11 and then a Ctrl-F11 to see the first payment term.

1.5 FTP Information


The agencies generate the csv file in the format specified in this document and place it on a specific directory <TBD>. This file is transferred to the Oracle EBS Financials Production server <TBD>, which is identified below.

Linux BOX: IP ADDRESS: UNIX DIRECTORY:

<TBD>
<TBD>

$XXDCG_TOP/inbound

C04.TD.AP.VendorConversion Page 8

Technical Design Document

2
2.1 Data Model
None

Database Objects

2.2 Summary
Seq # 1 2 Object Name XXDCG_VENDOR_STG.sql XXDCG_VENDOR_SITES_STG.sq l XXDCG_VENDOR_SITE_CONTA CT_STG.sql XXDCG_AP_VENDOR_CONVER SION_PKG.pks XXDCG_AP_VENDOR_CONVER SION_PKG.pkb Type Table Table Standard / Custom Custom Custom Description This table stores the Vendor data to be uploaded to oracle EBS This table stores the Vendor Sites data to be uploaded to oracle EBS This table stores the Vendor Site Contact data to be uploaded to oracle EBS Program to upload the Vendor data file to oracle EBS Program to upload the Vendor Data file to oracle EBS

Table

Custom

4 5

Package Specification Package Body

Custom Custom

C04.TD.AP.VendorConversion Page 9

Technical Design Document

2.3 Details
2.3.1 Conversion Vendor Csv File

Vendor_files_031111.zip

2.3.2

Custom tables (Staging tables for Vendor data load)

This table is the staging area for storing the vendor data from the input csv file.

XXDCG_VENDOR_ST G.sql

XXDCG_VENDOR_SIT ES_STG.sql

XXDCG_VENDOR_SIT E_CONTACT_STG.sql

2.4

File Layout Vendor Record

The following information provides an overview of the file layout. The file contains layouts for all different record types and separated by Field Separator and enclosed by Encapsulator (). The fields for each record type are explained below. Column Name Data Type Size Not Null Sample Data
V

Primary Key
No

Index column
No Page 10

Record Id
C04.TD.AP.VendorConversion

Character

Technical Design Document

System Date VENDOR_NO VENDOR_NAME ALT_VENDOR_NAME_1 ALT_VENDOR_NAME_2 VENTYP PMT_DISTN_TYPE OWNERSHIP_CODE TAX_OFFSET_EXEMPT W9_REQUEST_DATE UPDATE_DATE EFF_START_DATE EFF_END_DATE UPDATE_NO NAME_CONTROL BATCH_DEPT RESTRICT_MC MED_PAY_IND LSDBE_IND

Character Character Character Character Character Character Character Character Character Character Character Character Number Character Character Character Character Character

9 240 50 25 25 2 1 1 8 8 8 8 2 320 3 1 1 1

Y Y

No No No No No No No No No No No No No No No No No No No

No No No No No No No No No No No No No No No No No No No

File Layout- Vendor Sites Record plus Vendor Site Contacts Record
The following information provides an overview of the file layout. The file contains layouts for all different record types and separated by Field Separator and enclosed by Encapsulator (). The fields for each record type are explained below. Column Name Data Type Size Not Null Sample Data
V

Primary Key
No No No No

Index column
No No No No Page 11

Record Id System Date VENDOR_NO ADDRESS_CODE


C04.TD.AP.VendorConversion

Character Character Number Character

1 9 10 15

Y Y

Technical Design Document

ADDRESS_LINE_1 ADDRESS_LINE_2 CITY STATE ZIP_CODE_5 ZIP_CODE_4 PHONE_AREA_CODE PHONE_EXC PHONE_SEQ PHONE_EXT PMT_DISTN_TYPE TRANSIT_CODE ACC_NO ACCT_TYPE DIR_DEP_DATE OWNERSHIP_CODE HOLD_REASON_CDE COUNTRY FAX_AREA_CODE FAX_EXC FAX_SEQ UPDATE_REASON_CODE OFFSET_TAX_FLAG UPDATE_DATE CONTACT_NAME CONTACT_PHONE DUNS_NUMBER LSDBE_NO

Character Character Character Character Character Character Character Character Character Character Character Character Character Character Character Character Character Character Character Character Character Character Character Date Character Character Character Character

240 240 25 150 20 20 10 15 15 15 2 9 17 2 8 1 3 20 10 15 10 4 1 25 14 30 16

No No No No No No No No No No No No No No No No No No No No No No No No No No No No

No No No No No No No No No No No No No No No No No No No No No No No No No No No No

C04.TD.AP.VendorConversion

Page 12

Technical Design Document

2.4.1

Mapping Source Vendor Data to Target Interface Tables in Oracle EBS

Target Column Name (Oracle Column for AP_SUPPLIERS_INT Interface Table)


VENDOR_INTERFACE_ID LAST_UPDATE_DATE LAST_UPDATED_BY VENDOR_NAME VENDOR_NAME_ALT SEGMENT1 SUMMARY_FLAG ENABLED_FLAG LAST_UPDATE_LOGIN

Re qui red
Y

Data Type

Source Column

Validati on
No

Transformation Rules

(derived) (Username/derived) System Generated Automatic numbering NULL Y (Username/derived)

DATE NUMBER VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 NUMBER

UPDATE_DATE VENDOR_NAME VENDOR_ NAME_ALT

No No No Yes No No No

No CREATION_DATE CREATED_BY EMPLOYEE_ID VENDOR_TYPE_LOOKUP_CODE CUSTOMER_NUM DATE NUMBER NUMBER VARCHAR2 VARCHAR2 VENTYP Yes No No sysdate (Username/derived) If vendor is employee. From HR table(derived) If employee number is present set as 'EMPLOYEE'; IF VENDOR_TYPE_LOOKUP_CODE is null, set = 'VENDOR NULL

C04.TD.AP.VendorConversion

Page 13

Technical Design Document

ONE_TIME_FLAG

VARCHAR2

No

NULL

MIN_ORDER_AMOUNT SHIP_TO_LOCATION_ID SHIP_TO_LOCATION_CODE BILL_TO_LOCATION_ID BILL_TO_LOCATION_CODE SHIP_VIA_LOOKUP_CODE FREIGHT_TERMS_LOOKUP_CODE FOB_LOOKUP_CODE TERMS_ID TERMS_NAME

NUMBER NUMBER VARCHAR2 NUMBER VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 NUMBER VARCHAR2

No No No No No No No No No Yes

NULL

SET_OF_BOOKS_ID ALWAYS_TAKE_DISC_FLAG PAY_DATE_BASIS_LOOKUP_COD E PAY_GROUP_LOOKUP_CODE PAYMENT_PRIORITY INVOICE_CURRENCY_CODE PAYMENT_CURRENCY_CODE INVOICE_AMOUNT_LIMIT HOLD_ALL_PAYMENTS_FLAG HOLD_FUTURE_PAYMENTS_FLA G HOLD_REASON DISTRIBUTION_SET_ID DISTRIBUTION_SET_NAME ACCTS_PAY_CODE_COMBINATIO N_ID PREPAY_CODE_COMBINATION_I D NUM_1099 TYPE_1099 ORGANIZATION_TYPE_LOOKUP_ CODE VAT_CODE START_DATE_ACTIVE END_DATE_ACTIVE MINORITY_GROUP_LOOKUP_CO DE PAYMENT_METHOD_LOOKUP_C ODE WOMEN_OWNED_FLAG SMALL_BUSINESS_FLAG STANDARD_INDUSTRY_CLASS C04.TD.AP.VendorConversion

NUMBER VARCHAR2 VARCHAR2 VARCHAR2 NUMBER VARCHAR2 VARCHAR2 NUMBER VARCHAR2 VARCHAR2 VARCHAR2 NUMBER VARCHAR2 NUMBER NUMBER VARCHAR2 VARCHAR2 VARCHAR2 VENDOR_NO T99IND OWNERSHIP_CODE

No No No No No No No No No No No No No No No No No No

Net 30. If it is null and vendor type = EMPLOYEE set terms to IMMEADIATE; else set to 'Net 30'. Terms name. Default from the Terms table. Needed as a set up. 81

VENDOR. Pay group lookup code. (Derive value based on some logic/value) 1 USD USD NULL NULL If NULL then N NULL NULL NULL NULL LTrim first character. (Derived) If employee number is present then set = 'INDIVIDUAL', else if null set = 'CORPORATION'. Organization type lookup code. Need to be derived. Take from source; else set = '01-JAN-1900'. Start date active (Input from PASS) NULL Payment method lookup code

VARCHAR2 EFF_START_DATE DATE VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 EFF_END_DATE PMT_DISTN_TYPE

No No No No No No No No

LSDBE_IND

NULL Page 14

Technical Design Document

HOLD_FLAG PURCHASING_HOLD_REASON HOLD_BY HOLD_DATE TERMS_DATE_BASIS INSPECTION_REQUIRED_FLAG RECEIPT_REQUIRED_FLAG QTY_RCV_TOLERANCE QTY_RCV_EXCEPTION_CODE ENFORCE_SHIP_TO_LOCATION_C ODE DAYS_EARLY_RECEIPT_ALLOWE D DAYS_LATE_RECEIPT_ALLOWED RECEIPT_DAYS_EXCEPTION_COD E RECEIVING_ROUTING_ID ALLOW_SUBSTITUTE_RECEIPTS_ FLAG ALLOW_UNORDERED_RECEIPTS_ FLAG HOLD_UNMATCHED_INVOICES_F LAG EXCLUSIVE_PAYMENT_FLAG AP_TAX_ROUNDING_RULE AUTO_TAX_CALC_FLAG AUTO_TAX_CALC_OVERRIDE AMOUNT_INCLUDES_TAX_FLAG TAX_VERIFICATION_DATE NAME_CONTROL STATE_REPORTABLE_FLAG FEDERAL_REPORTABLE_FLAG ATTRIBUTE_CATEGORY ATTRIBUTE1 ATTRIBUTE2 ATTRIBUTE3 ATTRIBUTE4 ATTRIBUTE5 ATTRIBUTE6 ATTRIBUTE7 ATTRIBUTE8 ATTRIBUTE9 ATTRIBUTE10 ATTRIBUTE11 ATTRIBUTE12 ATTRIBUTE13 ATTRIBUTE14 ATTRIBUTE15 REQUEST_ID PROGRAM_APPLICATION_ID PROGRAM_ID PROGRAM_UPDATE_DATE VAT_REGISTRATION_NUM AUTO_CALCULATE_INTEREST_FL C04.TD.AP.VendorConversion

VARCHAR2 VARCHAR2 NUMBER DATE VARCHAR2 VARCHAR2 VARCHAR2 NUMBER VARCHAR2 VARCHAR2 NUMBER NUMBER VARCHAR2 NUMBER VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 DATE VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 NUMBER NUMBER DATE VARCHAR2 VARCHAR2

No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No

NULL NULL NULL NULL Invoice Received Date or SYSDATE Null

NULL

NULL NULL NULL NULL NULL NULL N NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL Derived NULL NULL NULL NULL NULL Page 15

W9_REQUEST_DATE NAME_CONTROL T99IND

Technical Design Document

AG EXCLUDE_FREIGHT_FROM_DISC OUNT TAX_REPORTING_NAME ALLOW_AWT_FLAG AWT_GROUP_ID AWT_GROUP_NAME EDI_TRANSACTION_HANDLING EDI_PAYMENT_METHOD EDI_PAYMENT_FORMAT EDI_REMITTANCE_METHOD EDI_REMITTANCE_INSTRUCTION BANK_CHARGE_BEARER MATCH_OPTION FUTURE_DATED_PAYMENT_CCID CREATE_DEBIT_MEMO_FLAG OFFSET_TAX_FLAG IMPORT_REQUEST_ID STATUS REJECT_CODE ECE_TP_LOCATION_CODE IBY_BANK_CHARGE_BEARER BANK_INSTRUCTION1_CODE BANK_INSTRUCTION2_CODE BANK_INSTRUCTION_DETAILS PAYMENT_REASON_CODE PAYMENT_REASON_COMMENTS PAYMENT_TEXT_MESSAGE1 PAYMENT_TEXT_MESSAGE2 PAYMENT_TEXT_MESSAGE3 DELIVERY_CHANNEL_CODE PAYMENT_FORMAT_CODE SETTLEMENT_PRIORITY PAYMENT_METHOD_CODE PAY_AWT_GROUP_ID PAY_AWT_GROUP_NAME PROCESS_STATUS ERROR_FLAG ERROR_CODE ERROR_DESCRIPTION

VARCHAR2 VARCHAR2 VARCHAR2 NUMBER VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 NUMBER VARCHAR2 VARCHAR2 NUMBER VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2

No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No

NULL If NULL then N NULL NULL NULL NULL NULL NULL NULL NULL INVOICE NULL NULL NEW NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL

TAX_OFFSET_EXEMPT

C04.TD.AP.VendorConversion

Page 16

Technical Design Document

Target Column Name (Oracle Column for AP_SUPPLIER_SITES_IN T Interface Table)


VENDOR_INTERFACE_ID VENDOR_SITE_INTERFACE_ID LAST_UPDATE_DATE LAST_UPDATED_BY VENDOR_ID VENDOR_SITE_CODE

Re qui red
Y

Data Type

Source Column

Validati on
No No No No No No

Transformation Rules

NUMBER NUMBER DATE NUMBER NUMBER VARCHAR2 UPDATE_DATE ADDRESS _CODE

Derived from Sequence Derived from Sequence Username(derived) NULL If the Address_code (Mail_code) is 000 then on the legacy side the address at the header level and the detail level is same. If the Vendor has different addresses then it will be stored under different Mail_Code. NULL NULL Sysdate Username(derived) Y Y Y NULL NULL

VENDOR_SITE_CODE_ALT LAST_UPDATE_LOGIN CREATION_DATE CREATED_BY PURCHASING_SITE_FLAG RFQ_ONLY_SITE_FLAG PAY_SITE_FLAG ATTENTION_AR_FLAG ADDRESS_LINE1 ADDRESS_LINE_ALT ADDRESS_LINE2 ADDRESS_LINE3 CITY STATE ZIP PROVINCE COUNTRY AREA_CODE PHONE CUSTOMER_NUM SHIP_TO_LOCATION_ID SHIP_TO_LOCATION_CODE BILL_TO_LOCATION_ID BILL_TO_LOCATION_CODE SHIP_VIA_LOOKUP_CODE FREIGHT_TERMS_LOOKUP_CODE FOB_LOOKUP_CODE INACTIVE_DATE FAX FAX_AREA_CODE TELEX PAYMENT_METHOD_LOOKUP_C ODE C04.TD.AP.VendorConversion

NUMBER DATE NUMBER VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 NUMBER VARCHAR2 NUMBER VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 DATE VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2

ADDRESS_LINE1 ADDRESS_LINE2 CITY STATE ZIP COUNTRY PHONE_AREA_CODE PHONE_EXC || PHONE_SEQ || PHONE_EXT

Yes No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No

US

NULL NULL NULL NULL

NULL NULL

FAX_SEQ FAX_AREA_CODE PMT_DISTN_TYPE

Page 17

Technical Design Document

TERMS_DATE_BASIS VAT_CODE DISTRIBUTION_SET_ID DISTRIBUTION_SET_NAME ACCTS_PAY_CODE_COMBINATIO N_ID PREPAY_CODE_COMBINATION_I D PAY_GROUP_LOOKUP_CODE PAYMENT_PRIORITY TERMS_ID TERM_NAME INVOICE_AMOUNT_LIMIT PAY_DATE_BASIS_LOOKUP_COD E ALWAYS_TAKE_DISC_FLAG INVOICE_CURRENCY_CODE PAYMENT_CURRENCY_CODE HOLD_ALL_PAYMENTS_FLAG HOLD_FUTURE_PAYMENTS_FLA G HOLD_REASON HOLD_UNMATCHED_INVOICES_F LAG AP_TAX_ROUNDING_RULE AUTO_TAX_CALC_FLAG AUTO_TAX_CALC_OVERRIDE AMOUNT_INCLUDES_TAX_FLAG EXCLUSIVE_PAYMENT_FLAG TAX_REPORTING_SITE_FLAG ATTRIBUTE_CATEGORY ATTRIBUTE1 ATTRIBUTE2 ATTRIBUTE3 ATTRIBUTE4 ATTRIBUTE5 ATTRIBUTE6 ATTRIBUTE7 ATTRIBUTE8 ATTRIBUTE9 ATTRIBUTE10 ATTRIBUTE11 ATTRIBUTE12 ATTRIBUTE13 ATTRIBUTE14 ATTRIBUTE15 REQUEST_ID PROGRAM_APPLICATION_ID PROGRAM_ID PROGRAM_UPDATE_DATE VALIDATION_NUMBER EXCLUDE_FREIGHT_FROM_DISC OUNT C04.TD.AP.VendorConversion

VARCHAR2 VARCHAR2 NUMBER NUMBER NUMBER VARCHAR2 NUMBER NUMBER VARCHAR2 NUMBER VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 NUMBER NUMBER NUMBER DATE NUMBER VARCHAR2 HOLD_REASON_CDE

No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No

NULL NULL NULL NULL NULL VENDOR 1 or 99 (Derived) Net 30 Take from source or else set to NET 30. NULL SYSDATE NULL USD USD Y Y NULL NULL NULL NULL NULL NULL Y NULL Original Vendor Number NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL

Page 18

Technical Design Document

VAT_REGISTRATION_NUM ORG_ID CHECK_DIGITS ADDRESS_LINE4 COUNTY ADDRESS_STYLE LANGUAGE ALLOW_AWT_FLAG AWT_GROUP_ID AWT_GROUP_NAME EDI_TRANSACTION_HANDLING EDI_ID_NUMBER EDI_PAYMENT_METHOD EDI_PAYMENT_FORMAT EDI_REMITTANCE_METHOD BANK_CHARGE_BEARER EDI_REMITTANCE_INSTRUCTION BANK_BRANCH_TYPE PAY_ON_CODE DEFAULT_PAY_SITE_ID PAY_ON_RECEIPT_SUMMARY_C ODE TP_HEADER_ID ECE_TP_LOCATION_CODE PCARD_SITE_FLAG MATCH_OPTION COUNTRY_OF_ORIGIN_CODE FUTURE_DATED_PAYMENT_CCID CREATE_DEBIT_MEMO_FLAG OFFSET_TAX_FLAG SUPPLIER_NOTIF_METHOD EMAIL_ADDRESS REMITTANCE_EMAIL PRIMARY_PAY_SITE_FLAG IMPORT_REQUEST_ID STATUS REJECT_CODE SHIPPING_CONTROL SELLING_COMPANY_IDENTIFIER GAPLESS_INV_NUM_FLAG DUNS_NUMBER TOLERANCE_ID TOLERANCE_NAME LOCATION_ID PARTY_SITE_ID SERVICES_TOLERANCE_ID RETAINAGE_RATE PAY_AWT_GROUP_ID PAY_AWT_GROUP_NAME PARTY_SITE_NAME REMIT_ADVICE_DELIVERY_MET HOD C04.TD.AP.VendorConversion

VARCHAR2 NUMBER VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 NUMBER VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 NUMBER VARCHAR2 NUMBER VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 NUMBER VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 NUMBER VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 NUMBER VARCHAR2 NUMBER NUMBER NUMBER VARCHAR2 VARCHAR2 VARCHAR2

No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No

NULL 81 DCG Operating Unit NULL NULL ENGLISH NULL NULL NULL NULL NULL NULL NULL NULL NULL

NULL NULL NULL INVOICE USA NULL Y NULL Y NEW NULL NULL NULL

OFFSET_TAX_FLAG

DUNS_NO

Auto Auto. Party site id (Auto generated from sequence by concurrant program) NULL

Page 19

Technical Design Document

Target Column Name (Oracle Column for AP_SUP_SITE_CONTACT _INT Interface Table)
LAST_UPDATE_DATE LAST_UPDATED_BY VENDOR_SITE_ID VENDOR_SITE_CODE ORG_ID OPERATING_UNIT_NAME LAST_UPDATE_LOGIN CREATION_DATE CREATED_BY INACTIVE_DATE FIRST_NAME MIDDLE_NAME LAST_NAME PREFIX TITLE MAIL_STOP AREA_CODE PHONE PROGRAM_APPLICATION_ID PROGRAM_ID PROGRAM_UPDATE_DATE REQUEST_ID CONTACT_NAME_ALT FIRST_NAME_ALT LAST_NAME_ALT DEPARTMENT IMPORT_REQUEST_ID STATUS REJECT_CODE EMAIL_ADDRESS URL ALT_AREA_CODE ALT_PHONE FAX_AREA_CODE C04.TD.AP.VendorConversion

Re qui red

Data Type

Source Column

Validati on
No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No

Transformation Rules

DATE NUMBER NUMBER VARCHAR2 NUMBER VARCHAR2 NUMBER DATE NUMBER DATE VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 NUMBER NUMBER DATE VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 NUMBER VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2 VARCHAR2

UPDATE_DATE

Username(derived/constant) (derived) (derived) (derived) NULL NULL Sysdate Username(derived/constant) NULL. Coming in the previous file First name (split the vendor_contact into these three fields)

CONTACT_NAME CONTACT_NAME CONTACT_NAME

NULL NULL NULL

PHONE_AREA_CODE PHONE_EXC||PHONE_SEQ

NULL NULL NULL NULL Legacy_vendor_site_id NULL NULL NULL NEW NULL X NULL NULL NULL

FAX_AREA_CODE

No No

Page 20

Technical Design Document

FAX VENDOR_INTERFACE_ID VENDOR_ID VENDOR_CONTACT_INTERFACE_ ID PARTY_SITE_ID PARTY_SITE_NAME

VARCHAR2 NUMBER NUMBER NUMBER NUMBER VARCHAR2

FAX_EXC || FAX_SEQ

No No No No No No Vendor interface id (DERIVED) (derived) (derived). Derived from Sequence: ap_sup_site_contact_int_s.NEXTVAL NULL NULL

C04.TD.AP.VendorConversion

Page 21

3 Processes and Interfaces Impacted


3.1 Summary
Seq # Processes Description of Impact

4 Module Specifications
Seq # Module Name New / Modifie d New Type

4.1

XXDCG_DCG_VENDOR_CONVERSION

Package

4.1 XXDCG_AP_VENDOR_CONV_PKG
4.1.1 Module Details

Program Name Executable Name Executable Type Parameters Incompatibilities Input Parameters: None Output Parameters: errbuf retcode Program Logic: ---

XXDCG Upload Vendor Conversion

XXDCG_AP_VENDOR_CONV_PKG PL/SQL Stored Procedure


None

None

Standard Oracle Apps out parameter for retuning error messages. Standard Oracle Apps out parameter. 0 - success, 1 - warning 2 error

1. Build cursor to select data from Vendor data custom table. 2. Derive the corporate Org id code 3. Loop through all the Vendor records in the custom table For each record (a) Validate Employee id (b) Validate Vendor Type, with the Vendor type lookup code (c) Validate payment terms. (d) Insert the data into AP Vendor Interface tables. Populate feeder_system_name as CONVERSION (e) Update status on Vendor data to S for successfully loaded rows. For any error skip that record and log the error in the log file. Pseudo code:
--Vendors Staging Table cursor c1 is select * from xxdcg.xxdcg_vendor_stg s where 1=1 and s.process_flag = 'N'; --Vendor Sites Staging Table cursor c2(p_vendor_id number) is select * from xxdcg.xxdcg_vendor_sites_stg s where 1=1

and and

s.LEGACY_VENDOR_ID = p_vendor_id s.process_flag = 'N';

--Vendor Person Id Lookup through Full Name cursor c3(p_fullname VARCHAR2) is select f.PERSON_ID from per_all_people_f f where UPPER(TRIM(f.FIRST_NAME || ' ' || f.MIDDLE_NAMES || ' ' || f.LAST_NAME)) = TRIM(p_fullname); --Vendor Payment Term Id Lookup cursor c5(p_term_name VARCHAR2) is select a.term_id from ap.ap_terms_tl a where a.NAME = p_term_name; --to check later after functional setup select a.ORG_ID into v_organization_id from apps.po_system_parameters a; SELECT ap_suppliers_int_s.NEXTVAL INTO v_vendor_interface_id FROM dual; --Insert into the ap_suppliers_int table as follows: INSERT INTO ap_suppliers_int ( . ... ); --Initialize and get the next vendor_site_interface_id. v_vendor_site_interface_id := 0; SELECT ap_supplier_sites_int_s.NEXTVAL INTO v_vendor_site_interface_id FROM dual; INSERT INTO ap_supplier_sites_int ( . . . ); -- Insert contact information into ap.ap_sup_site_contact_int. INSERT INTO ap_sup_site_contact_int (. . . ); END XXDCG_AP_VENDOR_CONV_PKG;

5 Data Conversion
The following steps have to be performed: 1. Get the ASCII comma-delimited format data file from the legacy system. 2. Create the staging tables in to the custom schema XXDCG using the SQL scripts. 3. Upload the data files into main staging table using SQL*Loader and the SQL scripts. 4. Run the concurrent programs to insert the data into the Oracle Applications AP Supplier Interface tables from the staging tables. The step to successfully load the vendors is detailed below. It is important to follow the order as the next steps are dependent on the successful outcome of the previous step. On error re-run the same step until the errors are resolved and data is loaded error free. ? 5.1.1.1 Step 2 Run the Concurrent Program Set. Login with the System Administrator responsibility and to the test system and decide which section responsibility you would like to put the request set DCG AP VENDOR CONVERSION by , and then run the request set called DCG AP VENDOR CONVERSION.

6 Test Plan
Test Areas The following entities / functionalities to be tested for:

1. 2. 3.

Conversion of Vendors. Validation of vendors that have gone through successfully from the API. Review any errors that come out.

Please refer Technical Design sections for more details. Pre-requisite


Have all AP/PO modules in place. Create all prerequisites described in this document.

Initial Setup Complete the initial setup as defined in the Functional design document.

S.N o

Test Condition
Run Staging Table Creation Script.

Expected Results
Creating 3 staging tables which are XXDCG.XXDCG_VENDOR_STG, XXDCG.XXDCG VENDOR_SITES_STG, and XXDCG.XXDCG_SUPPLIER_SITE_CONT_STG. Successfully putting the Vendor records into the XXDCG.XXDCG_VENDOR_STG, XXDCG.XXDCG VENDOR_SITES_STG, and XXDCG.XXDCG_SUPPLIER_SITE_CONT_STG tables Successfully put all vendors, vendor sites, and contacts into the system.

1 1

2 Run SQL*Loader script for loading XXDCG staging table.

Run the open interface for vendors and for sites and for contacts.

Open / Closed Issues


Need to finalize screen 34 data and the fields

8 Implementation Notes
#

Execution Steps
Run script for grants and synonyms from apps to xxdcg user. Run script for grants, synonyms and custom table creation in xxdcg custom schema. Control script xxdcg_ap_vendor_load.ctl to be copied to the $XXDCG_TOP/loader directory Create package xxdcg_ap_vendor_conv_pkg in the XXDCG schema. Setup concurrent program, executable 1. XXDCG: Read Vendor Data File 2. XXDCG : XXDCG Upload Vendor Data to the AP Supplier Interface tables Setup request set XXDCG : AP Vendor Data Conversion Attach request set to appropriate responsibility by adding it to the report group associated with the responsibility.

1 2 3 4 5 6 7

9 Appendix
1. Grants using apps user GRANT EXECUTE ON fnd_file TO xxdcg; 2. Grants using xxdcg user GRANT ALL ON XXDCG_AP_VENDOR_CONV_PKG TO apps; 3. Synonyms created using xxdcg user CREATE OR REPLACE SYNONYM fnd_file FOR apps.fnd_file; 4. Synonyms created using apps user CREATE OR REPLACE SYNONYM XXDCG_AP_VENDOR_CONV_PKG FOR XXDCG. XXDCG_AP_VENDOR_CONV_PKG;