How To Import Customers using Bulk Import ? (Doc ID 1908899.

1) To Bottom

In this Document

Goal
Solution
Identify and Get the Bulk Import Template:
Steps to generate Batch Identifier:
Steps to identify the Code of Source System:
Key Fields in the Bulk Import Template:
Insert Update Flag:
From Date and To Date fields:
Descriptive Flexfield Fields:
Steps to Import Customers into the Application:
1. Generate the csv and zip files
2. Upload File to UCM
3. Load data into Interface tables
4. Submit the Bulk Import process
References

APPLIES TO:

Oracle Fusion Receivables Cloud Service - Version 11.1.7.0.0 and later

Oracle Fusion Receivables - Version 11.1.5.0.0 and later
Information in this document applies to any platform.

GOAL

To understand How to import AR Customers using the Bulk Import template

SOLUTION

1. It is recommended to use the 'Upload Customers From Spreadsheet' (Simplified Import) with
minimal required information to upload Customers.
If the Simplified Import does not address any data that is intended for import, only then use this
Bulk Import method.
2. Customers created using Bulk Import can be updated using Simplified Import and vice-versa.
Identify and Get the Bulk Import Template:

Go to https://fusionappsoer.oracle.com
Click on Financials tab
Click on the corresponding Release hyperlink for Content: File-Based Data Import
In the new tab opened, select the hyperlink: File Based Data Import for Oracle Financials Cloud
- under Development
Click on Section: File Based Data Imports -> Customer Import
Click on CustomerImportTemplate.xlsm against XLSM Template File
The template file will be downloaded to the local system.

Go through the sample data provided in the different sheets of the template file to understand the
relation between different sheet and how they are linked
The template consists of 19 sheets for importing various customer related information.

NOTE: The sheet name is the corresponding Interface table name. For example, Interface table
name for HZ_IMP_PARTIES_T sheet data is HZ_IMP_PARTIES_T and so on.

1. It is NOT required to populate data in all the sheets for using this import. Data can be
populated in only the desired sheets and can be imported.
For example, if the user only wants to import parties - data can be populated only in
HZ_IMP_PARTIES_T sheet and leave the rest of the sheets blank and import.

2. However, for RA_% sheets, the corresponding information in HZ_% sheets needs to be
populated.
For example, if the user wants to import Account Profiles, data needs to be populated in
HZ_IMP_ACCOUNTS_T and RA_CUSTOMER_PROFILES_INT_ALL sheets so that the
parent entities are identified.

The import process is driven by

- Batch Identifier (available in all the sheets and should be maintained same across the
sheets for a single upload)
- Source System (available in all the sheets and should be maintained the same value across
the sheets for a single upload)
- Source System Reference (Unique reference that will be provided by the user for each
record)

Steps to generate Batch Identifier:

The Batch Identifier should be created in the system before populating any information in the
template using the below steps:
Go to Navigator -> Customer Data Management -> Data Import
Click on 'Create Data Import Batch' link at the top left corner of the screen
Provide the required fields - Batch Name, Source System, Object: Customer and Consumer

Click on Save and Close

This will create a new Data Import Batch showing the Batch Id

Populate that Batch Id in all the sheets for which the data needs to be imported.

Steps to identify the Code of Source System:

In the template file, for the Source System - the code needs to be populated. The code can be
identified using the below steps:
Task: Manage Source System Entities
Identify the Source System Name that is used while creating the Data Import batch above
Copy the Code for that entry

This code will be same for all the %Source System fields in the template across sheets in a given
import.

NOTE: If you need to update the information on any of the already imported customers, the
same Source System and Source System References used for creating that customer should be
used.
If a different Source System or Source System Reference is used, the system will create new
customers / entries using the information provided.

Key Fields in the Bulk Import Template:

Insert Update Flag:

In all the sheets, there is a field: Insert Update Indicator containing two values: I (Insert), U
(Update)
The value 'I' should be used if a new entry is to be created in the system
The value 'U' should be used if the existing entry is to be updated in the system
If the user is not sure if the record is new or existing, the field can be left blank so that the system
verifies and creates / updates accordingly.
From Date and To Date fields:

Make sure to check for From Date and To Date in all the sheets (wherever applicable)
If the From Date fields are not populated, the same will be defaulted with the System Date.
In the attached template (CustomerImportTemplate_R10_DEMO.xlsm) verify the start dates
populated to 2000/01/01 in different sheets.

Descriptive Flexfield Fields:

In most of the sheets, many fields are hidden. Unhide the fields to see the available Flexfield
fields available for import.

NOTE: For more information on Fields in Customer Bulk Import Template, please refer
to Note: 2126635.1

Steps to Import Customers into the Application:

1. Generate the csv and zip files

- Once the Template file is ready with the data to be imported, go to 'Instructions and CSV
Generation' sheet and click on 'Generate CSV' button
- This will generate the csv files for all the sheets with data and zip file with all the csv files
generated.

2. Upload File to UCM

- Go to Navigator -> File Import and Export

- Click on Add icon, select the zip file created above
- Select the Account as: fin/receivables/import from the drop-down
- This will upload the zip file to the UCM server

3. Load data into Interface tables

- Go to Scheduled Processes -> Click on Schedule New Process

- Process Name: Load Interface File for Import
Parameters:
Import Process: Import Trading Community Data in Bulk
Data File: Select the zip file uploaded in Step 2 above
- Submit the process
 The submitted process will submit as many child 'Load File to Interface' processes as many
number of csv files in the zip file uploaded.
Wait till all the processes are completed successfully.
Once this step is complete, the data would be available in the corresponding interface tables

4. Submit the Bulk Import process

- Go to Navigator -> Customer Data Management -> Data Import (where the Data Import
Batch was created)
- Select the Batch Identifier for the batch -> Actions -> Import
- Enable or disable the options in the subsequent pages as per the requirement
- In the Import to Registry page, there are 2 options available
- Run the batch in preview mode
This would validate the data as in the Import process to identify any errors. If there are
no errors identified, the same batch can be submitted for Import.
If there are errors, a new Batch is to be created and the errors should be corrected in
the template, generate the zip file and upload again.
- Skip the preview and directly load the data once preprocessing is complete
This would perform the actual import and would show any errors.
If there are errors, a new Batch is to be created and the errors should be corrected in
the template, generate the zip file and upload again.
Choose the desired option and click on Submit
Keep refreshing until the Batch Status shows either:
- Completed (all records are successfully imported)
- Completed with warnings (some records imported successfully, some records ended
in error)
- Error (Import process ended in error - no records are imported)

If there are any errors, the same can be viewed in the Report as shown in the screenshot below:
Click on the Batch ID link to open the details which shows the count of records, records
processed, records ended in error.
The table below shows the number of lines in each category that are loaded, imported, errors.

The uploaded customers can be queried from Billing Workarea -> Manage Customers as shown
below:

REFERENCES

NOTE:2076530.1 - FAQ: Create and Manage Customer UI

NOTE:1998507.1 - FAQ - Upload Customers from Spreadsheet
NOTE:1998501.1 - FAQ - Customer Import Interface
NOTE:2009717.1 - How To Upload Customers Using "Upload Customers From Spreadsheet"
functionality ?
NOTE:2126635.1 - Information on Fields in Customer Bulk Import Template