AR Customer Upload

Description:

AR Customer Upload This upload can be used to create and/or update Customer Accounts, Customer Sites and/or Customer Site Uses. Additionally, the upload supports:

• the creation/update of the Customer Profiles and Customer Profile Amounts at Customer and Customer Site Level
• the creation/update of bank Accounts at the Customer and Customer Site Level
• the creation/update of Contact information at the Customer and Customer Site level

The following parameters determine the behaviour of the upload.

Upload Mode

Create – In this mode the user starts with a blank Excel. Use this mode to create new customers. Create, Update – In this mode the existing customer information is first downloaded into the excel based on the other parameters specified. Use this mode to update existing customer information, or to add/update additional supplementary information to the Customers and or Customer Sites (like customer profile information, customer profile amounts, bank accounts, contacts). This mode can also be used to create new Customers.

Update Level

This parameter determines if you want to download the Customer Profiles, Bank Accounts, and Contacts at the Customer Level, Customer Site Level or Both
Customer – only Customer Level information is downloaded to excel. Site – only Customer Site level information is downloaded to the excel Blank – Customer and Customer Site level information is downloaded to the Excel. In the excel you can create/update the customer profiles, bank accounts, and/or contacts at the customer level by leaving the Site Level columns null.

Update Profile Amounts

Set to Yes to download the Customer Profile Amounts assigned to the Customer and/or Customer Site profiles.

Update Bank Accounts

Set to Yes to download the Bank Accounts assigned to the Customers and/or Customer Sites

Update Contacts

Set to Yes to download the Contacts assigned to the Customers and/or Customer Sites

Contact Status

Determines the status of the contacts to be downloaded. By default, only active contacts will be downloaded. But his can be changed to download all contacts, or inactive contacts only.

Default Operating Unit and Default Profile Class

For creation of new Customers/Customer Sites, the Operating Unit and Profile Class to be used can be defaulted automatically if specified by these parameters

Default Assign. Level

For the creation of new Customers/Customer Sites, these parameters can be used to explicitly specify the level (Account or Site) to which the Profile Class, Tax Registration, Bank Accounts, Contacts, and Attachments should be assigned to respectively. Normally the upload will determine the level based on the existence of site level identifying data in the excel row being uploaded. If no site level identifying data is present, then it will be associated the entity with the Account, otherwise the entity will be associated with the site. This would require a separate excel row to be specified for the customer account and a separate row for the customer site if some entities are to be associated with the customer account and some with the customer site. These parameters allow you to create the customer account and customer site in a single excel row and explicitly specify for each entity at what level the entity should be associated with.

Parameters

Upload Mode, Party Type, Operating Unit, Customer Name, Customer Name From, Customer Name To, Registry ID, Registry ID From, Registry ID To, Account Number, Account Number From, Account Number To, Customer Type, Customer Classification, Customer Sales Channel, Primary Salesperson, Country, Site Use Purpose, Site Use Location, Account/Site Status, Profile Class, Update Level, Update Site Uses, Update Profile Amounts, Update Tax Registrations, Tax Registration Status, Update Bank Accounts, Bank Account Status, Update Contacts, Contact Status, Update Attachments, Default Profile Assign. Level, Default Tax Reg. Assign. Level, Default Bank Acct Assign. Level, Default Contact Assign. Level, Default Attachment Assign. Level

Used tables

fnd_territories_vl, hz_cust_account_roles, hz_relationships, hz_parties, hz_org_contacts, hz_cust_accounts, hz_party_sites, hz_locations, hz_contact_points, iby_external_payers_all, iby_pmt_instr_uses_all, iby_ext_bank_accounts, ce_bank_branches_v, fnd_documents_short_text, fnd_lobs, fnd_attached_documents, fnd_documents, fnd_documents_tl, fnd_document_datatypes, fnd_document_categories_tl, hz_organization_profiles, qp_secu_list_headers_v, oe_ship_methods_v, hr_all_organization_units_vl

Categories

Enginatics, Upload

Dependencies

If you would like to try one of these Oracle EBS SQLs without having Blitz Report installed, note that some of the reports require functions from utility package xxen_util.

Example Report

None

Report SQL

www.enginatics.com/reports/ar-customer-upload/

Blitz Report™ import options

AR_Customer_Upload.xml

AR Customer Upload - Case Study & Technical Analysis

Executive Summary

The AR Customer Upload is a comprehensive data management tool designed to streamline the creation and maintenance of customer master data within Oracle Receivables. By leveraging an Excel-based interface, it allows users to perform bulk uploads for Customer Accounts, Sites, Site Uses, Profiles, Bank Accounts, and Contacts. This tool significantly reduces the time and effort required for data entry, ensures data consistency, and simplifies the complex process of managing customer hierarchies.

Business Challenge

Managing customer master data in Oracle E-Business Suite is often a multi-step, labor-intensive process. Challenges include:

• Complex Navigation: Creating a single customer requires navigating through multiple forms and tabs to set up accounts, sites, contacts, and payment details.
• Data Volume: During implementations or acquisitions, organizations need to migrate thousands of customer records, which is impractical to do manually.
• Data Integrity: Manual entry increases the risk of errors, such as inconsistent address formats or missing profile classes.
• Maintenance Overhead: Updating existing customers (e.g., changing collectors, updating credit limits) one by one is inefficient.

Solution

The AR Customer Upload tool addresses these challenges by providing a unified, user-friendly interface for mass data processing. Key capabilities include:

• Bulk Creation & Updates: Supports both the creation of new customers and the update of existing records in a single operation.
• Comprehensive Scope: Handles not just basic customer details but also related entities like Customer Profiles, Bank Accounts, Contacts, and Attachments.
• Flexible Modes: Offers distinct modes for “Create” (starting with a blank template) and “Create, Update” (downloading existing data for modification).
• Granular Control: Parameters allow users to specify whether to update data at the Customer level, Site level, or both.

Technical Architecture

The tool is built upon the Oracle Trading Community Architecture (TCA) and Receivables APIs to ensure strict data validation and integrity.

Key Tables Involved

• HZ_PARTIES: Stores the master party records.
• HZ_CUST_ACCOUNTS: Manages the customer account relationship.
• HZ_PARTY_SITES & HZ_LOCATIONS: Handles address and site information.
• HZ_CUST_ACCT_SITES_ALL & HZ_CUST_SITE_USES_ALL: Defines the specific business purposes (Bill-To, Ship-To) for sites.
• HZ_CUSTOMER_PROFILES & HZ_CUST_PROFILE_AMTS: Stores credit and collection profile settings.
• IBY_EXTERNAL_PAYERS_ALL & IBY_EXT_BANK_ACCOUNTS: Manages banking and payment details.
• HZ_ORG_CONTACTS & HZ_CONTACT_POINTS: Stores contact person details and communication methods.

Data Logic

The upload process follows a structured logic:

1. Data Preparation: The user selects the “Upload Mode” and other parameters to generate the Excel template.
2. Data Entry/Modification: Users enter or modify data in the Excel sheet.
3. Validation: Upon upload, the tool validates the data against Oracle’s business rules (e.g., checking for duplicate sites, validating value sets).
4. API Execution: Validated data is processed using standard Oracle APIs to insert or update records in the database.

Parameters

The tool offers extensive parameters to control the upload behavior:

• Upload Mode:
  • Create: Generates a blank template for new records.
  • Create, Update: Downloads existing data based on filters for editing.
• Update Level: Determines if the download/update applies to the Customer level, Site level, or both.
• Update Profile Amounts / Bank Accounts / Contacts: Flags to include or exclude these child entities in the process.
• Default Operating Unit / Profile Class: Sets default values for new records to minimize data entry.
• Default Assign. Level: Specifies whether new child entities (like contacts) should be assigned at the Account or Site level if not explicitly defined.

Performance

The tool is optimized for bulk processing. However, for very large datasets (e.g., > 10,000 records), it is recommended to:

• Split the upload into smaller batches to avoid timeouts.
• Ensure that the underlying APIs are performant by gathering statistics on TCA tables.

FAQ

Q: Can I use this tool to update just the credit limits for existing customers? A: Yes. Select “Create, Update” mode, set “Update Profile Amounts” to Yes, and filter for the specific customers. You can then modify the credit limit columns and upload.

Q: What happens if I leave the Site columns blank? A: If the “Update Level” allows it, leaving Site columns blank typically implies that the changes apply to the Customer Account level (e.g., updating the account-level profile).

Q: Does it support multiple contacts per customer? A: Yes, the tool supports creating and updating multiple contacts. In the Excel template, this is usually handled by having multiple rows for the same customer, each with different contact details.

Oracle E-Business Suite Reporting Library

We provide an open source Oracle EBS SQLs as a part of operational and project implementation support toolkits for rapid Excel reports generation.

Blitz Report™ is based on Oracle EBS forms technology, and hence requires minimal training. There are no data or performance limitations since the output files are created directly from the database without going through intermediate file formats such as XML.

Blitz Report can be used as BI Publisher and Oracle Discoverer replacement tool. Standard Oracle BI Publisher and Discoverer reports can also be imported into Blitz Report for immediate output to Excel. Typically, reports can be created and version tracked within hours instead of days. The concurrent request output automatically opens upon completion without the need for re-formatting.

The Filters, Columns, Rows and Values fields are used to create and deliver the data in pivot table format with full drill down to details.

The Excel template upload functionality in Blitz Report allows users to create their own layouts by uploading an Excel template with additional sheets and charts, automatically refreshed when the report runs again. This allows to create custom dashboards and more advanced visualizations of report data.

You can download and use Blitz Report free of charge for your first 30 reports.

The installation and implementation process usually takes less than 1 hour; you can refer to our installation and user guides for specific details.

If you would like to optimize your Oracle EBS implementation and or operational reporting you can visit www.enginatics.com to review great ideas and example usage in blog. Or why not try for yourself in our demo environment.

Alert	CRM Foundation
ALR Alerts	JTF Grid Datasources
Contracts Core	Lease and Finance Management
OKC Contract Lines Summary	OKL Termination Quotes
Payments	Process Manufacturing Inventory
IBY Payment Process Request Details	GMI Cycle Count Forms
Public Sector Financials	Shipping Execution
PSA Budgetary Control Transactions	WSH Shipping/Delivery Transactions
Warehouse Management	XML Publisher
WMS Control Board Tasks	XDO Publisher Data Definitions
Capacity	Legal Entity Configurator
CRP Available Resources CRP Resource Plan	XLE Establishment and Legal Entity Associations XLE Legal Entities
Service Contracts	Applications DBA
OKS Service Contracts Billing History OKS Service Contracts Billing Schedule	AD Applied Patches AD Applied Patches 11i AD Applied Patches R12.2
Enterprise Asset Management	Installed Base
EAM Assets EAM Weekly Schedule EAM Work Orders	CSI Customer Products Summary CSI Installed Base Extended Attributes Summary CSI Installed Base Summary by Organization
Payroll	Process Manufacturing
PAY Costing Detail PAY Employee Payroll History PAY Payroll Element Details	OPM Batch Lot Cost Details OPM Batch Lot Cost Trends OPM Reconcilation
Subledger Accounting	Workflow
XLA Distribution Links Summary XLA Entity ID Mappings XLA Subledger Period Close Exceptions	WF Activity Status Summary WF Business Events and Subscriptions WF Notifications
Asia/Pacific Localizations	Enterprise Command Center
JA India - TDS Certificates JA India GSTR-1 Return JA India GSTR-2 Return JA India GSTR-3B Return	ECC Admin - Concurrent Programs ECC Admin - Data Load Tracking ECC Admin - Data Sets ECC Admin - Metadata Attributes
Advanced Pricing	Bills of Material
QP Customer Pricing Engine Request QP Modifier Details QP Price Lists QP Pricing Agreements QP Pricing Attribute Definitions	BOM Bill of Material Structure BOM Calendar Exceptions BOM Calendars BOM Item Where Used GUI BOM Routings
Property Manager	Advanced Supply Chain Planning
PN GL Reconciliation PN Generate Lease Analysis PN Generate Lease Details PN Generate Portfolio Detail PN Generate Portfolio Summary	MSC Exceptions MSC Horizontal Plan MSC Pegging Hierarchy MSC Pegging Hierarchy 11i MSC Plan Orders MSC Vertical Plan
E-Business Tax	Projects
ZX Financial Tax Register ZX Lines Summary ZX Party Tax Profiles ZX Tax Accounts ZX Tax Regimes ZX US Sales Tax	PA Capital Project Summary with Asset Detail PA Project Budget PA Revenue, Cost, Budgets by Resources PA Revenue, Cost, Budgets by Work Breakdown Structure PA Task Schedule PA Transaction Sources
Human Resources	Master Scheduling/MRP
PER Employee Assignments PER Employee Grade Changes PER Employee Salary Change PER Information Type Security PER Organization Hierarchy PER Organizations PER Security Profiles	MRP End Assembly Pegging MRP Exceptions MRP Financial Analysis MRP Horizontal Plan MRP Item Forecast MRP Pegging MRP Plan Orders MRP Sourcing Rules and Bills of Distribution
Order Management	Work in Process
ONT Cancelled Orders ONT Order Holds ONT Orders ONT Orders and Lines ONT Recurring Billing Plan ONT System Parameters ONT Transaction Types Listing ONT Transaction Types and Line WF Processes	WIP Account Distribution WIP Discrete Job Shortage WIP Entities WIP Entities Summary WIP Outside Processing WIP Required Components WIP Value WIP Value Summary
Cash Management	Cost Management
CE Bank Account Balances CE Bank Branches CE Bank Statement Import Execution CE Bank Statement and Reconciliation CE Bank Transaction Codes Listing CE Cash in Transit CE Cleared Transactions CE General Ledger Cash Account Usage CE General Ledger Reconciliation CE Transactions Available for Reconciliation	CST AP and PO Accrual Reconciliation CST COGS Revenue Matching CST Cost Groups CST Detailed Item Cost CST Inventory Value - Multi-Organization (Element Costs) 11i CST Inventory Value - Multi-Organization (Item Costs) CST Inventory Value Report - by Subinventory (Item Cost) CST Item Cost Reports CST Miscellaneous Accrual Reconciliation CST Period Close Subinventory Value CST Period Close Subinventory Value Summary CST Periodic Inventory Value CST Supply Chain Indented Bills of Material Cost CST Uninvoiced Receipts
Purchasing	Discoverer
PO Approval Assignments PO Approval Groups PO Approved Supplier List PO Cancelled Purchase Orders PO Cancelled Requisitions PO Document Types PO Headers PO Headers 11i PO Headers and Lines PO Headers and Lines 11i PO Internal Requisitions and Sales Orders PO Internal Requisitions/Deliveries Discrepancy PO Invoice Price Variance PO Purchase Price Variance PO Purchase Requisitions with PO Details	DIS Access Privileges DIS Business Areas DIS Discoverer and Blitz Report Users DIS End User Layers DIS Folders, Business Areas, Items and LOVs DIS Import Performance DIS Items, Folders and Formulas DIS Migration identify missing EulConditions DIS Users DIS Workbook Export Script DIS Workbook Import Validation DIS Workbook Owner Export Script DIS Workbooks, Folders, Items and LOVs DIS Worksheet Execution History DIS Worksheet Execution Summary DIS Worksheet SQLs
Assets	Payables
FA Additions By Source FA Asset Additions FA Asset Book Details FA Asset Book Details 11i FA Asset Cost FA Asset Impairments FA Asset Inventory FA Asset Inventory Report FA Asset Reclassification FA Asset Register FA Asset Retirements FA Asset Summary (Germany) FA CIP Cost FA Cost Adjustments FA Depreciation Projection FA Depreciation Reserve FA Journal Entry Reserve Ledger FA Revaluation Reserve FA Tax Reserve Ledger	AP 1099 Payments AP Accounted Invoice Aging AP Cash Requirement AP DPIVA Export LSNA AP Expenses AP Final Payment Register 11i AP Intercompany Invoice Details AP Invoice Approval Status AP Invoice Audit Listing AP Invoice Payments AP Invoice Payments 11i AP Invoice on Hold AP Invoice on Hold 11i AP Invoices and Lines AP Invoices and Lines 11i AP Invoices with PO, Intercompany and SLA Details AP Matched and Modified Receipts AP Negative Supplier Balance AP Open Balances Revaluation AP Open Items Revaluation AP Posted Invoice Register AP Posted Payment Register AP Preliminary Payment Register 11i AP Supplier Statement AP Suppliers AP Suppliers 11i AP Suppliers Revenue Summary AP Suppliers Revenue Summary 11i AP Trial Balance AP Trial Balance Report Definitions
Receivables	General Ledger
AR Adjustment Register AR Aging AR Aging Buckets and Interest Tiers Setup AR Applied Receipts AR Autoinvoice Interface Summary AR Customer Credit Limits AR Customer Credit Snapshot AR Customer Open Balances Period Lookback AR Customer Statement AR Customers and Sites AR Disputed Invoice AR European Sales Listing AR Incomplete Transactions AR Miscellaneous Receipts AR Miscellaneous Receipts 11i AR Open Balances Revaluation AR Open Items Revaluation AR Past Due Invoice AR Payment Terms AR Receipt Register AR Sales Journal By Customer AR Transaction Register AR Transaction Types AR Transactions and Lines AR Transactions and Lines 11i AR Transactions and Payments AR Transactions and Payments 11i AR Unaccounted Transaction Sweep AR Unapplied Receipts Register AR to GL Reconciliation	GL Account Analysis GL Account Analysis (Distributions) GL Account Analysis (Distributions) 11g GL Account Analysis (Drilldown) GL Account Analysis (Drilldown) (with inventory and WIP) GL Account Analysis 11g GL Account Analysis 11i GL Balance GL Balance (pivot) GL Balance by Account Hierarchy GL Code Combinations GL Daily Rates GL Data Access Sets GL FSG Reports GL FSG Row Orders GL Financial Statement and Drilldown (FSG) GL Header Categories Summary GL Journals GL Journals (Drilldown) GL Journals (Drilldown) 11g GL Journals 11i GL Ledger Sets GL Ledgers and Legal Entities GL Ledgers and Organizations GL Oracle FSG Converter GL Oracle FSG Converter 11g GL Period Status GL Periods GL Summary Templates GL Trial Balance - Detail GL effective vs accounting vs period start and end date comparison
Blitz Report	Inventory
Blitz Report Application Categories Blitz Report Assignments Blitz Report Assignments and Responsibilities Blitz Report Category Assignments Blitz Report Column Number Fomat Comparison between environments Blitz Report Column Translation Comparison between environments Blitz Report Column Translations Blitz Report Comparison between environments Blitz Report Default Templates Blitz Report Deletion History Blitz Report Execution Summary Blitz Report History Blitz Report LOV Comparison between environments Blitz Report LOV SQL Validation Blitz Report LOVs Blitz Report License User History Blitz Report License Users Blitz Report Parameter Anchor Validation Blitz Report Parameter Bind Variable Validation Blitz Report Parameter Comparison between environments Blitz Report Parameter Comparison between reports Blitz Report Parameter Custom LOV Duplication Validation Blitz Report Parameter DFF Table Validation Blitz Report Parameter Default Values Blitz Report Parameter Dependencies Blitz Report Parameter Table Alias Validation Blitz Report Parameter Uniqueness Validation Blitz Report Pivot Colums Validation Blitz Report RDF Import Validation Blitz Report Record History SQL Text Creation Blitz Report SQL Validation Blitz Report Security Blitz Report Templates Blitz Report Text Search Blitz Report Translations Blitz Report User History Blitz Report VPD Policy Setup Blitz Reports Blitz Upload Data Blitz Upload Dependencies Blitz Upload History	INV ABC assignments INV Aging INV Cycle count entries and adjustments INV Cycle count hit/miss analysis INV Cycle count listing INV Cycle count open requests listing INV Cycle count schedule requests INV Cycle count unscheduled items INV Cycle counts pending approval INV Default Category Sets INV Intercompany Invoice Reconciliation INV Intercompany Invoice Reconciliation 11i INV Item Category Assignment INV Item Category Sets INV Item Default Transaction Locators INV Item Default Transaction Subinventories INV Item Demand History INV Item Import Performance INV Item Relationships INV Item Reservations INV Item Statuses INV Item Supply/Demand INV Item Templates INV Items INV Lot Transaction Register INV Material Account Distribution Detail INV Material Movements INV Material Status Change History INV Material Transactions INV Material Transactions Summary INV Onhand Quantities INV Organization Access INV Organization Parameters INV Period Close Pending Transactions INV Physical Inventory Adjustments INV Physical Inventory Tags INV Physical inventory accuracy analysis INV Print Cycle Count Entries Open Interface data INV Safety Stocks INV Stock Locators INV Subinventories INV Transaction Historical Summary INV Transaction Register INV Transaction Source Types INV Transaction Types
Application Object Library	Database Administration
FND Application Context File FND Applications FND Attached Documents FND Attachment Functions FND Audit Setup FND Audit Table Changes by Column FND Audit Table Changes by Record FND Concurrent Managers FND Concurrent Program Incompatibilities FND Concurrent Programs and Executables FND Concurrent Programs and Executables 11i FND Concurrent Request Conflicts FND Concurrent Requests FND Concurrent Requests 11i FND Concurrent Requests Summary FND Data Groups FND Descriptive Flexfield Table Columns FND Descriptive Flexfields FND Document Categories FND Document Sequence Assignments FND Document Sequences FND FNDLOAD Object Transfer FND Flex Hierarchies (Rollup Groups) FND Flex Value Hierarchy FND Flex Value Security Rules FND Flex Value Sets, Usages and Values FND Flex Values FND Form Functions FND Forms Personalizations FND Help Documents and Targets FND Histogram Columns FND Key Flexfields FND Languages FND Lobs FND Log Messages FND Lookup Search FND Lookup Values FND Lookup Values Comparison between environments FND Menu Entries FND Messages FND Nodes FND Profile Option Values FND Profile Options FND Request Groups FND Responsibilities FND Responsibility Access FND Responsibility Access 11i FND Responsibility Menu Exclusions FND Role Hierarchy FND Roles FND Rollup Groups FND SOA Runtime Error FND Tables and Columns FND User Login History FND User Login Page Favorites FND User Login Summary FND User Responsibilities FND User Roles FND User Roles 11i FND Users	DBA AWR Active Session History DBA AWR Blocking Session Summary DBA AWR CPU Load (active session history) DBA AWR CPU vs Wait Time Summary DBA AWR Interconnect Traffic DBA AWR Latch Summary DBA AWR Latch by Time DBA AWR PGA History DBA AWR SQL Execution Plan History DBA AWR SQL Performance Summary DBA AWR Settings DBA AWR System Metrics Summary DBA AWR System Time Percentages DBA AWR System Time Summary DBA AWR Tablespace Usage DBA AWR Wait Class by Time DBA AWR Wait Event Summary DBA AWR Wait Event Summary (active session history) DBA Alert Log DBA Archive / Redo Log Rate DBA Automated Maintenance Tasks DBA Blocking Sessions DBA CPU Benchmark1 DBA CPU Benchmark2 DBA CPU Benchmark3 DBA Dependencies (used by) DBA Dependencies (uses) DBA Editioned Object Summary DBA Editions DBA External Table Creation DBA Feature Usage Statistics DBA Hierarchical Profiler Data DBA Index Columns DBA Jobs DBA Log Switches DBA Objects DBA Parameters DBA Profiler Data DBA Redo Log Files DBA Registry SQL Patch DBA Result Cache Objects and Dependencies DBA Result Cache Statistics DBA SGA Active Session History DBA SGA Blocking Session Summary DBA SGA Buffer Cache Object Usage DBA SGA CPU Load (active session history) DBA SGA Memory Allocation DBA SGA SQL Execution Plan History DBA SGA SQL Performance Summary DBA SGA Target Advice DBA SGA Wait Event Summary (active session history) DBA SGA+PGA Memory Configuration DBA Scheduler Jobs DBA Segments DBA Session Longops DBA Table Columns DBA Table Modifications DBA Tablespace Usage DBA Text Search DBA Trace File Contents

Useful Links

Blitz Report™ – World’s fastest data upload and reporting for Oracle EBS

Oracle Discoverer replacement – importing worksheets into Blitz Report™

Blitz Report™ Toolkits

Blitz Report™ Questions & Answers

Supply Chain Hub by Blitz Report™

Blitz Report™ customers

Oracle EBS Reporting Blog

Oracle EBS Reporting

© 2025 Enginatics