AP356 Supplier Conversion Design Spec
AP356 Supplier Conversion Design Spec
Page 1 of 16
Accenture Advanced Enterprise Solutions
AP356 Functional Design Specification Document
AAES-FD-Supplier Conversion
Table of Contents
Page 2 of 16
Accenture Advanced Enterprise Solutions
AP356 Functional Design Specification Document
AAES-FD-Supplier Conversion
Approval
Complete this table with your information.
Name Phone # Dates
Created By: Creation Date:
Specification
Complete the table with your information. Items indicated as Required must be completed; these items include
a brief description of the required information.
Process Area: (Required) Supplier Conversion
Team: (Required) PTP
Application: (Required) AP
Conversion Name: (Required) Supplier Conversion
Priority: (Required) High
Development Complexity: (Required) High
Conversion of supplier headers, sites, contacts, bank
Conversion Short Description: (Required)
accounts
From System: (Required) XYZ 7.5 and Concur
From System Contact: (Required)
To System: (Required) Oracle R12 Payables
To System Contact: (Required)
Estimated Production Date:
Oracle e-business R12 configuration
Associated Business Event/Activity:
Comments:
Page 3 of 16
Accenture Advanced Enterprise Solutions
AP356 Functional Design Specification Document
AAES-FD-Supplier Conversion
General Requirements
Assumptions:
List all Conversion scope & data organization
1. Xxxxis responsible for the data cleansing, data standardization, data mapping, data extraction,
validation and reconciliation of the converted data.
2. This conversion will load suppliers which are active
Value used to identify the hierarchy between supplier and supplier sites is LGCY_VENDOR_REF
Value used to identify hierarchy between supplier sites and supplier sites contacts is
LGCY_VENDOR_REF and VENDOR_SITE_CODE
3. Only the latest supplier configuration is converted, i.e. no Supplier change history is converted.
Legacy system
4. For Europe:
All Non-SSC employee suppliers who claim expenses will be converted from XYZ Financials.
SSC employee suppliers that do not reside in XYZ Financials will be identified and entered
manually in Oracle (due to the low volume).
5. For North America:
All employee suppliers who claim expenses will be converted from Concur (except for bank
account details).
The related bank account data for employee suppliers will be converted from payroll system.
This will be extracted together with the employee conversion extract (C-PTP-007) and cross-
referenced with Concur employee suppliers extract using the employee number as an unique
identifier.
All trade suppliers will be converted from XYZ.
6. Supplier auto-numbering has been chosen. Vendors will be given an Oracle vendor number, using a
sequence starting at 10001. As such converted suppliers will be assigned a different supplier number
than in XYZ.
7. Legacy Group name (SID) will be stored in a flexfield (ATTRIBUTE1 of Vendor DFF) available in
supplier header level to aid transaction mapping and necessary references e.g. SSCEU, SSCNA
8. Legacy supplier numbers will be stored in a flexfield (ATTRIBUTE2 of Vendor DFF) available in
supplier header level to aid transaction mapping and necessary references. It is possible to query on
this field to identify a supplier with its previous number e.g. A0052.
Conversion order
9. Supplier conversion has to be performed prior Open Purchase Orders, Receipts and AP Transactions
conversion
10. Employee conversion (C-PTP-007) has to be performed prior to Supplier Conversion
11. Bank and Bank Branches conversion (C-PTP-003) has to be performed prior to Supplier Conversion
Files
Page 4 of 16
Accenture Advanced Enterprise Solutions
AP356 Functional Design Specification Document
AAES-FD-Supplier Conversion
A separate file containing bank and branches information (part of C-PTP-003) will be loaded prior
to supplier conversion
Others
14. All Vendor cleanup activities must be done before the conversion load program.
15. As new legacy systems are introduced into the F1 solution, data cleansing activities against the
master vendor listing need to be completed.
16. All Vendors converted will be considered new and active with an effective date .
17. Intercompany vendors will be set up manually
18. All suppliers in scope for conversion are available in XYZ and Concur.
19. Only Vendors doing business with the Avery sites in-scope for the F1 Go-Live live per wave should be
converted e.g. for wave 1 only North American vendors will be extracted and converted, for wave 2
only European etc.
20. Mapping of segment1 on the liability account will come from the supplier location business unit. The
business unit can be mapped via FAH to the Legal Entity.
21. Employee conversion must be completed first to facilitate the conversion of employee suppliers
22. Defining third party relationships for Supply Chain Financing suppliers and Ghosted PCard suppliers
will be done manually after conversion.
23. In XYZ multiple Avery supplier locations can share the same supplier details (e.g. address, phone,
bank account). The following applies once suppliers are converted:
Avery supplier locations that are part of the current Go-Live wave will have to be in-activated
in XYZ after conversion. After Go-Live the maintenance of the converted supplier will happen
in Oracle.
Avery supplier locations that are not part of the current Go-Live wave, but share the same
supplier details as the converted supplier location will have to continue maintaining the
supplier details in XYZ (e.g. suppliers that will be converted during Pilot phase but still have
active locations which will be converted during wave 1.
Data Conversion Expectations:
List the expected results of the data conversion.
An automated conversion process will be used to load supplier data extracted from the legacy systems. A
consolidated “supplier master” will be provided to the Oracle R12 environment, where it will be loaded in an
automated manner. Only suppliers that have outstanding transactions and / or are used in the last 18 months
will be in scope for conversion. One time suppliers will also be excluded from the conversion. In addition, no
historical supplier data will be converted.
It is expected that supplier names, addresses, contacts, bank accounts, tax references are loaded into Oracle
Accounts Payables.
The supplier conversion program(s) will be required to transfer all relevant data from the supplier master
management tool into to the Oracle R12 supplier tables.
Selection Criteria:
List the criteria for selecting the data from each source system.
Selection from the legacy system is the responsibility of Xxxxand is not in the scope of the current document.
Page 5 of 16
Accenture Advanced Enterprise Solutions
AP356 Functional Design Specification Document
AAES-FD-Supplier Conversion
- All primary contacts per supplier site will be selected for the conversion (one per supplier site).
- One primary bank account data per supplier site will be selected for the conversion.
* Supplier locations in XYZ are not the same as supplier sites in Oracle. A translation from XYZ location into
Oracle sites will be necessary. Please refer to ‘Business Rules’ paragraph on p.20 in this document for more
details.
Bank Information:
Bank / branch / bank accounts information is selected for bank accounts used by selected supplier sites.
Note that Banks and branches will be converted separately first via component C-PTP-003.
Disposition of non-converted data in the legacy system is responsibility of Xxxxand is not in the scope of the
current document.
The business unit will be disabled and transaction posting will be turned off in XYZ
Transaction Volume:
Describe the volume of transactions by type.
Page 6 of 16
Accenture Advanced Enterprise Solutions
AP356 Functional Design Specification Document
AAES-FD-Supplier Conversion
Design
Flow Diagram:
1/2/3 XxxxLegacy team will do the extraction of the active suppliers out of XYZ and Concur (for North
America). Bank account details for employee suppliers in North America will have to be extracted from
the payroll system and cross-referenced with the data from Concur based on employee number. The
assumption is that this will be extracted together with the employee conversion extract (C-PTP-003).
XxxxLegacy team will deliver this information according to the format specified in the data mapping
section of this document. The data is saved into the following 4 files:
4/5 After that, the flat file is transferred manually into a specified folder. The flat files will then be loaded
into the following staging tables:
XXAD_SUP_MAST_STG_TBL
XXAD_SUP_MAST_SITE_STG_TBL
XXAD_SUP_MAST_CONT_STG_TBL
XXAD_SUP_BANK_ACCTS_STG_TBL
Page 7 of 16
Accenture Advanced Enterprise Solutions
AP356 Functional Design Specification Document
AAES-FD-Supplier Conversion
This will be done by using the SQL*Loader utility by executing the control files at the UNIX prompt.
XXAD_SUP_MAST_HDR.ctl
XXAD_SUP_MAST_SITE.ctl
XXAD_SUP_MAST_CONT.ctl
XXAD_SUP_BANK_ACCTS.ctl
The first task of the control file is to delete any old records from the staging table. Then it proceeds
with loading the data from the flat file into the staging tables.
6/7/9. Upon successful completion of the SQL*Loader program, the custom PL/SQL package is initiated. If
any records do not fit the specified format built into the control file, they will be written to the bad files
XXAD_SUP_MAST_HDR.bad
XXAD_SUP_MAST_SITE.bad
XXAD_SUP_MAST_CONT.bad
XXAD_SUP_BANK_ACCTS.bad
If any logic is built in, to skip certain records they will be written to the discard files
XXAD_SUP_MAST_HDR.dsc
XXAD_SUP_MAST_SITE.dsc
XXAD_SUP_MAST_CONT.dsc
XXAD_SUP_BANK_ACCTS.dsc
And, information such as how many records were processed successfully, how many and which
failed, and error messages will be written to the log file
XXAD_SUP_MAST_HDR.log
XXAD_SUP_MAST_SITE.log
XXAD_SUP_MAST_CONT.log
XXAD_SUP_BANK_ACCTS.log
with meaningful messages to facilitate correcting the errors.
6. The custom PL/SQL package will load the data from staging table directly into Oracle base banking
tables using HZ_BANK_PUB. This API contains all validations, lookups, default values, and data
translations necessary in order to copy data from the custom staging tables to the standard Oracle
tables as per Oracle specifications (also defined in the data mapping spreadsheet).
Note: Please refer to C-PTP-003 for further details about banks and branches conversion.
7. The custom PL/SQL package will load the data from staging table into standard open interface tables
called:
a. AP_SUPPLIERS_INT
b. AP_SUPPLIER_SITES_INT
c. AP_SUP_SITE_CONTACT_INT
The custom PL/SQL package will contain all validations, lookups, default values, and data translations
necessary in order to copy data from the custom staging tables to the standard Oracle OIT table as
per Oracle specifications (also defined in the data mapping spreadsheet). The program will copy the
legacy supplier code in the DFF of the existing XYZ supplier header.
8. Once open interface tables have been loaded, the standard suppliers open interface import program
is initiated manually to import the data from Oracle Interface Tables to Oracle tables (HZ / AP / IBY
tables). There is one import program for each entry type.
The program names are:
Page 8 of 16
Accenture Advanced Enterprise Solutions
AP356 Functional Design Specification Document
AAES-FD-Supplier Conversion
Note: Fiscal Classification details at the supplier header will be loaded via the following API:
hz_code_assignments_pkg.insert_row
9. The custom PL/SQL package will load the bank account data from staging table into standard open
interface tables called:
IBY_TEMP_EXT_BANK_ACCTS
10. During supplier (site) import, this table will be checked for corresponding records (A row in
IBY_TEMP_EXT_BANK_ACCTS is said to be associated with the Supplier or Supplier Site if the
column IBY_TEMP_EXT_BANK_ACCTS.calling_app_unique_ref1 is equal to either
AP_SUPPLIERS_INT.vendor_interface_id for Suppliers or
IBY_TEMP_EXT_BANK_ACCTS.Calling_ app_unique_ref2 is equal to
AP_SUPPLIER_SITES_INT.vendor_site_interface_id for Supplier Sites) and if records are found a
supplier bank account will be created.
The figure below shows the supplier Open interface import program’s screens (options for supplier,
supplier sites and supplier Site contacts are the same).
Parameters for the supplier Open Interface Import are as shown below
Page 9 of 16
Accenture Advanced Enterprise Solutions
AP356 Functional Design Specification Document
AAES-FD-Supplier Conversion
Design Dependencies:
Describe any dependencies, requirements, and concerns affecting the data conversion.
Page 10 of 16
Accenture Advanced Enterprise Solutions
AP356 Functional Design Specification Document
AAES-FD-Supplier Conversion
Data Cleansing:
In the table, describe the data cleansing effort, including the person(s) responsible and the date the cleansing
effort is scheduled for completion.
Data Mapping:
Describe how the data mapping is to complete. Include the person(s) responsible for the data mapping.
The data mapping identifies the order of the data which will be provided by Xxxxin the ASCII pipe ‘|’ delimited
flat file.
The data file extracted by Xxxxwill have three record types: supplier Header, supplier Site and supplier Site
contact. The following tables describe the structure for header and line type records.
Page 11 of 16
Accenture Advanced Enterprise Solutions
AP356 Functional Design Specification Document
AAES-FD-Supplier Conversion
Error Handling
Complete the table with information on instances in which errors may occur. Include the extent to which the
organization is responsible for error monitoring during correction versus the users’ responsibility. You do not
have to include full details on how operations are to be notified; however, state the business expectations for
the level of service provided. Include details of validation routines.
Page 12 of 16
Accenture Advanced Enterprise Solutions
AP356 Functional Design Specification Document
AAES-FD-Supplier Conversion
Testing Requirements
Describe how the executed data conversion is tested to make sure it accomplishes its intended task. Include
error handling and timeout features in the testing.
Page 13 of 16
Accenture Advanced Enterprise Solutions
AP356 Functional Design Specification Document
AAES-FD-Supplier Conversion
Page 14 of 16
Accenture Advanced Enterprise Solutions
AP356 Functional Design Specification Document
AAES-FD-Supplier Conversion
Issues Documentation
Complete the table with issue information. Indicate at which time you identified the issues, as exampled
below.
Reviewers
Complete the table when the document is reviewed.
Name Date
N/A
Appendix
Include additional information, such as conversion enhancements, design updates, etc. Make detailed
reference and explanation to changes from the original design, and document the author and date of those
changes in the Appendix and in the Document Change Control section of this document.
Page 15 of 16
Accenture Advanced Enterprise Solutions
AP356 Functional Design Specification Document
AAES-FD-Supplier Conversion
Revision History
Page 16 of 16