You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

Status

  Approved

OwnerRUAN-ext, Eric 
Stakeholders

Purpose

The purpose of this document is to define the conversion approach to create Customer Hierarchy in S/4 HANA.


There will be different scenarios for the customer hierarchy information in various legacy systems. 

First scenario is in SAP ECC, customer hierarchy is used to save the information. The customer hierarchy is a tree-like hierarchy where each node is a customer (including parent and child customers). The primarily purpose is used for pricing, rebates, and reporting across related customers. It is maintained via transaction code VDH1N.

Second scenario is in Customer General data, the field Group Key is used to assign the Parent company to each customer.  The Group key is defined in PRS system, and synced to SAP ECC (WP2/PF2) in a custom table (ZZRGROUP in PF2. ZWPUT068  in WP2).

Third scenario is in Salesforce, Corporate group is defined as a type of Account in Salesforce, then it is used to link related accounts (such as Prospect) accordingly. The Corporate Group definition is the same as Group Key mentioned in the second scenario. 

 

In SAP S/4HANA, customers or prospect are managed as Business Partners (BP), enabling a more flexible and integrated data model. In the meantime, Global Hierarchies are used in the the new S4 Hana design. Global hierarchies are any characteristic hierarchies that are maintained centrally in the Fiori app Manage Global Hierarchies. This conversion spec will capture on the migration approach on how to convert the ECC customer hierarchy and Salesforce Corporate group to S4 Hana Global Hierarchies. In the S4 Hana global hierarchy design, the sales area assignment between Business Partners are not required.


The table below summarizes the three scenarios and the S4 solution to be used to manage the customer hierarchy information.


ScenarioLegacy SystemLegacy System Data SourcePartner TypeSales Area RelatedS4
1ECC (WP2 only)The customer hierarchy is used, maintained via t-code VDH1NCustomerRelevantGlobal Hierarchies will be used and maintained via Fiori App Manage Global Hierarchies. Sales Area data will not be applicable for the data maintenance.
2ECC (WP2/PF2)Group Key (KNA1-KONZS) field is used in customer general dataCustomerNot Relevant
3Salesforce (iCare and Core CRM)Related Accounts is used to link the Corporate group (Parent Company) with the Accounts (Prospect)ProspectNot Relevant


Conversion Scope

The scope of this document covers the approach for converting active Customer Hierarchy from Legacy Source Systems into S/4HANA following the document "DD-FUN-050 Master Data Standard_3005-Customer Hierarchy". 


The Customer hierarchy data from legacy systems includes:

 

ScenarioLegacy SystemLegacy System Data SourceRelevancy Rule
1ECC (WP2 only)The customer hierarchy is used, maintained via t-code VDH1N
  1. For Parent, the sales area data has the sales organization in scope and the BP general data/sales view data is migrated.
  2. For Child, the sales area data has the sales organization in scope and the sales view is still active.
  3. Valid-to is after go live date
  4. There is pricing or rebate indicator in the source system
2ECC (WP2/PF2)Group Key (KNA1-KONZS) field is used in customer general data
  1. Customer general data is in migration scope, and defined as Business Partner in S4 Hana system, which will have dependency on CNV-3007 Business Partners - General (Role 000000).
  2. Group Key is not blank
  3. Group Key is defined as Business Partner in S4 Hana System.
3Salesforce (iCare and Core CRM)Related Accounts is used to link the Corporate group (Parent Company) with the Accounts (Prospect)
  1. Prospect is in migration scope and defined as Business Partner in S4 Hana system, which will have dependency on CNV3009-Business Partners - Prospect (BUP002)
  2. There is related Account information maintained for the prospect 
  3. The Corporate Group is defined as Business Partner in S4 Hana System, which will have dependency on CNV3009-Business Partners - Prospect (BUP002)


The customer hierarchy data from legacy system excludes:

  1. The Corporate Group / Group key is not in migration scope of S4 Hana system
  2. The Business Partner General data is not in migration scope for the Customer or Prospect



List of source systems and approximate number of records
ScenarioSourceScope

Source Approx No. of Records

Target SystemTarget Approx

No. of Records

1WP2Customer Hierarchy1856S4 Hana ROW/China/CUI1856
2WP2Group Key in customer general data31835S4 Hana ROW/China/CUI31835
2PF2Group Key in customer general data26150S4 Hana ROW/China/CUI26150
3iCareCorporate Group and related accounts
S4 Hana ROW/China/CUI
3Core CRMCorporate Group and related accounts
S4 Hana ROW/China/CUI

Additional Information

Multi-language Requirement

N/A

Document Management

N/A

Legal Requirement

N/A

Special Requirements

There will be 3 SAP instances, ROW (Rest of the World), China, CUI. This data object will be replicated to all 3 SAP instances.



Target Design

The technical design of the target for this conversion approach.

TableFieldData ElementField DescriptionData TypeLengthRequirement
HRRP_DIR_NHRYTYP
Hierarchy TypeCHAR4Mandatory
HRRP_DIR_NHRYVALTO
Valid ToDATS8Mandatory
HRRP_DIR_NHRYVALFROM
Valid FromDATS8Mandatory
HRRP_DIR_NHRYSID
Hierarchy IDCHAR20Mandatory
HRRP_DIRT_NHRYTXT
Hierarchy DescriptionCHAR50Mandatory
HRRP_ATTR_NODE_NHRYNODE
Hierarchy NodeCHAR50Mandatory
HRRP_ATTR_NODE_NPARNODE
Hierarchy Parent NodeCHAR50Mandatory

Type
Type for Upload template only

Mandatory








Data Cleansing

IDCriticalityError Message/Report DescriptionRuleOutputSource System
3005-1C1Remove obsolete child customer Child Customer has general data marked as for deletionHigher Customer Number/Name/Child Customer/Name/Sales Organization/Distribution Channel/Division/Deletion Indicator WP2
3005-2C1
Remove child customer with obsolete sales data
Child Customer has the sales area data marked for deletionHigher Customer Number/Name/Child Customer/Name/Sales Organization/Distribution Channel/Division /Deletion IndicatorWP2
3005-3C1Parent Customer with central deletion indicatorHigher Customer has general data marked as for deletionHigher Customer Number/Name/Child Customer/Name/Sales Organization/Distribution Channel/Division /Deletion IndicatorWP2
3005-4C1Parent Customer with sales area deletion indicatorHigher Customer has sales area data marked as for deletionHigher Customer Number/Name/Child Customer/Name/Sales Organization/Distribution Channel/Division /Deletion IndicatorWP2



Conversion Process

The high-level process is represented by the diagram below:

The ETL (Extract, Transform, Load) process is a structured approach to data migration and management, ensuring high-quality data is seamlessly transferred across systems. Here’s a breakdown of its key components:

1. Extraction
For SAP ECC, the process begins with extracting raw data (KNVH) from source systems, such as Syensqo ECC system (i.e., WP2/PF2) . The extracted data is then staged for transformation. For Salesforce, a flat file will be shared, then staged for transformation.


2. Transformation
Once extracted, the data undergoes cleansing, consolidation, and governance. This step ensures data integrity, consistency, and compliance with business rules. The transformation process includes:
- Data validation to remove inconsistencies.
- Standardization to align formats across datasets.
- Business rule application to refine data for operational use.


3. Loading
The transformed data is then loaded into the target S4 Hana system. 




Data Privacy and Sensitivity

N/A


Extraction

Extract data from a source into Syniti Migrate for SAP S4 Hana Syniti Migrate connects to the source and loads the data into Syniti Migrate. There are 2 methods:

a. Perform full data extraction from relevant tables (KNVH) in the SAP ECC (WP2/PF2).

b. Data is loaded to the repository from the Salesforce system extract/report.

The agreed Relevancy criteria is applied to the extracted records to identify the records that are applicable for the Target loads.

Extraction Run Sheet

Req #Requirement DescriptionTeam Responsible
3005-001- Identify the source systems and databases involved.
- Define the data objects (tables, fields, records) to be extracted.
- Establish business rules for data selection.

Syniti 

Syniti / LTC Data team

3005-002- Specify the extraction approach (full, incremental, or delta extraction).
- Determine the tools and technologies used.
- Define data filtering criteria to exclude irrelevant records.
Syniti 
3005-003- Establish execution timelines and batch processing schedules.
- Assign responsibilities for extraction monitoring.
- Document dependencies on other migration tasks.
Syniti 
3005-004- Define error handling mechanisms for extraction failures.Syniti 


Selection Screen

Selection Ref ScreenParameter NameSelection TypeRequirementValue to be entered/set
N/A



















Data Collection Template (DCT)

Target Ready Data Collection Template will be created for data with exception of some fields which require transformation as mentioned in the transformation rule.

DCT Rules

Field NameField DescriptionRule
N/A










Extraction Dependencies

Item #Step DescriptionTeam Responsible
1

Source System Availability

  • Ensure that the source database or application is accessible.
  • Confirm that necessary credentials and permissions are granted
Syensqo IT
2

Data Structure

  • Identify relationships between tables, views, and stored procedures.
Syniti 
3

Referential Integrity

  • Ensure dependent records are extracted together.
Syniti 
4

Extraction Methodology

  • Define whether extraction is full, incremental, or delta-based.
  • Establish batch processing schedules for large datasets.
Syniti 
5

Performance and Scalability Considerations

  • Optimize extraction queries to prevent system overload.
  • Ensure network bandwidth supports data transfer volumes.
Syniti 
6

Security and Compliance

  • Adhere to regulatory standards for sensitive information if applicable
Syniti 


Transformation

The Target fields are mapped to the applicable Legacy field that will be its source, this is a 3-way activity involving the Business, Functional team and Data team. This identifies the transformation activity required to allow Syniti Migrate to make the data Target ready:

  1. Perform value mapping and data transformation rules.
    1. Legacy values are mapped to the to-be values (this could include a default value)
    2. Values are transformed according to the rules defined in Syniti Migrate
  2. Prepare target-ready data in the structure and format that is required for loading via prescribed Load Tool. This step also produces the load data ready for business to perform Pre-load Data Validation

Transformation Run Sheet

Item #Step DescriptionTeam Responsible
1Identify target S/4HANA fields and determine applicable legacy source fields from ECC system WP2 + Salesforce system (iCare and Core CRM)Functional Team (L2C)+ Data Team (L2C)
2Map legacy field values to S/4HANA target values (including field-level mapping and technical names)Data Team (L2C), Data Team (Syniti)
3Define value mapping rules for fields requiring standardization or harmonization across the source systems,  ECC system WP2 + Salesforce system (iCare and Core CRM)Functional Team (L2C)+ Data Team (L2C)
4Identify and agree on default values where legacy data is incomplete or inconsistentBusiness Team + Functional Team (L2C)
5Configure transformation rules in Syniti Migrate Data Team (Syniti), Data Team (L2C)
6Review transformation logic and mappings with Business for confirmationBusiness Team + Functional Team (L2C)
7Perform initial transformation run and generate draft target-ready datasetData Team (Syniti),
8Review draft target-ready data for structure and completenessData Team (L2C), Functional Team (L2C)
9Share transformed data with Business for Pre-load ValidationBusiness Team
10Incorporate feedback from Business and refine mappings or transformation logic as neededData Team (L2C)
11Finalize and approve transformed data as Target Ready Load FileBusiness + Functional (L2C) + Data Team (L2C)
12Handover final file to Load Team or trigger the load via Syniti Load WorkbenchData Team (Syniti), Data Load Team


Transformation Rules

Rule #Source systemSource TableSource FieldSource DescriptionTarget SystemTarget TableTarget FieldTarget DescriptionTransformation Logic
1



S4HRRP_DIR_NHRYTYPHierarchy TypeDefault - CH02 (this refers to Customer Hierarchy Analytics)
2



S4HRRP_DIR_NHRYVALTOValid ToDefault - 31/12/9999
3



S4HRRP_DIR_NHRYVALFROMValid FromDefault - 1/1/2027
4



S4HRRP_DIR_NHRYSIDHierarchy IDDefault - CUST_HIER 
5



S4HRRP_DIRT_NHRYTXTHierarchy DescriptionDefault - Customer Hierarchy
6

Scenario 1: SAP ECC: WP2


Scenario 2: SAP ECC: Group Key


Scenario 3: Salesforce field:

KNVH



KNA1

KUNNR



KUNNR



SLV_Related_Account__c

Customer



Customer



Related Account

S4HRRP_ATTR_NODE_NHRYNODEHierarchy Node

Rule - There are 3 scenario based on the "Type" in the upload template.

When it is "Root" - The value is CUST_HIER . Repeat once only


When it is "Node: Business Partner" - Map the ECC Parent customer to S4 BP Number. The parent customer can be identified using the logic select KNVH-KUNNR where KNVH-HKUNNR is initial.


When it is "Business Partner" - Map the ECC child customer to S4 BP Number. The child customer can be identified using the logic KNVH-KUNNR where KNVH-HKUNNR = the value in the "Node: Business Partner".


After getting all the BP number, remove the duplicate Child BP based on parent BP. Mapping table is MAP_KUNNR

7

Scenario 1: SAP ECC: WP2


Scenario 2: SAP ECC: Group Key


Scenario 3: Salesforce field:

KNVH



KNA1

HKUNNR



KONZS




SLV_Account__c

Customer



Group Key




Account

S4HRRP_ATTR_NODE_NPARNODEHierarchy Parent Node

Rule - There are 3 scenario based on the Type in the upload template.

When it is "Root" - Leave it blank


When it is "Node: Business Partner" - Default value "CUST_HIER "


When it is "Business Partner" - Map KNVH-HKUNNR /SLV_Account__c  and convert based on S4 BP number.  Mapping table is MAP_KUNNR


Map KNA1-KONZS or Corporate group based on MAP_KONZS

8



S4
TypeType from Upload template

- There are 3 drop-downs based on the Type in the upload template.

"Root" - Repeat once only in the first line
"Node: Business Partner" - Use it for Parent customer, 
"Business Partner" - Use it for Child customer 












Transformation Mapping

Mapping Table NameMapping Table Description
MAP_KUNNRECC vs BP number mapping
MAP_KONZSGroup Key (Corporate Group) mapping




Transformation Dependencies

List the steps that need to occur before transformation can commence
Item #Step DescriptionTeam Responsible
1Source Data Integrity
- Ensure extracted data is complete, accurate, and consistent.
- Validate that data types and formats align with transformation requirements.
Syniti 
2Referential Integrity
- Ensure dependent records are transformed together or in advance
Syniti 
3Transformation Logic and Mapping
- Define data mapping rules between source and target schemas.
Data Team
4Performance and Scalability Considerations
- Optimize transformation processes for large datasets.
- Ensure system resources can handle transformation workloads
Syniti 
5Logging and Error Handling
- Maintain detailed logs of transformation activities.
- Define error-handling procedures for failed transformations
Syniti 


Pre-Load Validation

Project Team

Completeness

TaskAction
Compare Data Counts
  1. Verify row counts between source and target databases.
  2. Identify missing or duplicated records.


Validate the mandatory fieldsValidate there is value for all the mandatory fields
Validate Primary Keys and Unique Constraints
  1. Check for duplicate or missing primary key values, i.e., if there is same BP number.
  2. Ensure unique constraints are maintained.


Test Referential IntegrityConfirm dependent records exist in related tables

Accuracy

TaskAction
Validate the transformationValidate the fields which require transformation have the value after transformation instead of the original field value
Check Data Consistency
  1. Compare field values across systems
  2. Validate data formats and structures



Business

 The following pre-load validations will be performed by the business. 

Completeness

TaskAction
Compare Data Counts
  1. Verify row counts between source and target databases.
  2. Identify missing or duplicated records.


Review populated templates for missing or incorrect valuesUse checklists to verify completeness and correctness before submission



Accuracy

TaskAction





Load

The load process includes:

  1. Execute the automated data load into target system using load tool or product the load file if the load must be done manually
  2. Once the data is loaded to the target system, it will be extracted and prepared for Post Load Data Validation

Load Run Sheet

Item #Step DescriptionTeam Responsible
1Load Scope Definition
- Identify the target system and database structure.
- Define data objects (tables, fields, records) to be loaded.
- Establish business rules for data validation.
Data team
2Load Methodology
- Specify the loading tools and technologies (LSMW).
Syniti 
3Data Quality and Validation
- Ensure data integrity checks (null values, duplicates, format validation).
- Perform pre-load validations to verify completeness.
- Define error handling mechanisms for load failures
Syniti 
4Load Execution Plan
- Establish execution timelines and batch processing schedules.
- Assign responsibilities for monitoring execution.
- Document dependencies on other migration tasks
Syniti 
5Logging and Reporting
- Maintain detailed logs of loading activities.
- Generate summary reports on loaded data volume and quality.
- Define escalation procedures for errors
Syniti 



The Import template from Fiori app 'Manage Global Hierarchies' will be used.



Load Phase and Dependencies

The Customer Hierarchy will be loaded in the pre-cutover period.

Before loading, it will have dependency on the configuration. The configuration needs to be transported into the respective system first.

Configuration

Item #Configuration Item
1Define the Hierarchy ID in Fiori App 'Manage Global Hierarchies'




Conversion Objects

Object #Preceding Object Conversion Approach
3007Business Partners - General (Role 000000)
3009Business Partners - Prospect (BUP002)


Error Handling

Error TypeError DescriptionAction Taken
Data ErrorThe Business partner is not definedValidate the BP relevancy rule and maintain the BP if it is in migration scope







Post-Load Validation

Project Team

The following post-load validations will be performed by the Project Team.

Completeness

TaskAction
Perform Source-to-Target Comparisons
  1. Validate that migrated data matches source records.
  2. Check for discrepancies in numerical values, text fields, and timestamps





Accuracy

TaskAction
Execute Sample Queries and Reports
  1. Run queries to validate business logic.
  2. Generate reports to compare expected vs. actual results
Conduct Post-Migration ReconciliationGenerate reports comparing pre- and post-migration data.



Business

Post-load validation is a critical step in data migration, ensuring that transferred data is accurate, complete, and functional within the target system.

1. Ensuring Data Integrity
After migration, data must be consistent with its original structure. Post-load validation checks for missing records, incorrect mappings, and formatting errors to prevent discrepancies.
2. Business Continuity
Faulty data can disrupt operations, leading to financial losses and inefficiencies. Validating post-load data ensures that applications function as expected, preventing downtime.
3. Error Detection and Resolution
By validating data post-migration, businesses can detect anomalies early, reducing the cost and effort required for corrections


Completeness

TaskAction
Perform Source-to-Target Comparisons
  1. Validate that migrated data matches source records.
  2. Check for discrepancies in numerical values, text fields, and timestamps
Conduct Post-Migration ReconciliationGo through reports comparing pre- and post-migration data.



Accuracy

TaskAction
Perform Manual TestingConduct manual spot-checks for additional assurance.





Key Assumptions

  • Master Data Standard is up to date as on the date of documenting this conversion approach and data load.
  • Customer hierarchy is in scope based on data design and any exception requested by business.
  • There will be 3 SAP instances, one for ROW, one for China and one for CUI only.
  • For SAP CUI instance, the migration activity will be handled by US based data consultant. 


See also

Change log

Version Published Changed By Comment
CURRENT (v. 8) Mar 12, 2026 14:42 RUAN-ext, Eric * 20260312 update. include Region/Leading GBU and the blank group key field
v. 30 Feb 22, 2026 13:42 RUAN-ext, Eric *20260222 remove CUI
v. 29 Nov 24, 2025 14:52 RUAN-ext, Eric
v. 28 Nov 03, 2025 07:56 RUAN-ext, Eric
v. 27 Oct 08, 2025 11:44 RUAN-ext, Eric
v. 26 Oct 06, 2025 14:29 RUAN-ext, Eric
v. 25 Oct 06, 2025 11:50 RUAN-ext, Eric
v. 24 Oct 06, 2025 09:28 RUAN-ext, Eric
v. 23 Oct 06, 2025 09:07 RUAN-ext, Eric
v. 22 Oct 06, 2025 08:36 RUAN-ext, Eric

Go to Page History

Workflow history

Title Last Updated By Updated Status  
There are no pages at the moment.

  • No labels