Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Status

Page Status

Owner
StakeholdersCIRULE, Anita

Purpose

The purpose of this document is to define the data conversion approach to create Customer Material Information Records (CMIR) in S/4 HANA.

Customer material info records (CMIRs) are used to store specific information about a material from a customer's perspective. This information helps in streamlining sales order processing and ensuring accurate order fulfilment. CMIRs link a customer's material number and description to the corresponding SAP material number, allowing for efficient order creation and data consistency. 

This conversion aims to migrate active and relevant customer material information records from existing ECC systems into S/4HANA by applying required transformation logic using Syniti as the data migration and transformation platform. The converted records will be loaded into the target S/4HANA system using standard SAP mechanisms such as IDOCs, BAPIs, or direct table loads where applicable.


Conversion Scope

The scope of this document covers the approach for converting active Customer Material Information Records (CMIR) from Legacy Source Systems into S/4HANA following the Customer Material Information Records (CMIR) Master Data Design Standard: DD-FUN-050 Master Data Standard_1036-Customer Material Information Records(CMIR).

From the current system landscape, Customer Material Information Records (CMIR) exist in the both legacy systems - PF2 and WP2. Harmonization and validation are required to ensure the accurate and consolidated data in S/4HANA. While PF2 and WP2 serve as source systems, a mapping and transformation logic will be necessary to produce properly formatted load templates in line with the target design.


 20260114-Eka: MDS updated - Text Language updated from project Syway approved language to all existing CMIR language.

The data from legacy system includes: 

  1. All active Customer Material Information Records (CMIR), where: 

    1. Customer sales view migrated as per CNV-3003 Business Partners - Customer (Sales and Service) - FLCU01
    2. AND Material sales view migrated as per CNV-2003 Materials - Sales view with sales long text.
    3. AND Sales organization is in scope of S/4HANA
    4. AND Distribution channel is in scope of S/4HANA
    5. AND Plant is in scope of S/4HANA OR the Plant is BLANK. 
  2. For records selected in point #1 above; TEXT will be migrated for Text Object = KNMT and if the Text ID and the Text Language are included in the mapping table.


20260227-Eka: Refer to CR0279 - Update Conversion Specs to remove mention of CUI System

20260420-Eka: Refer to CR0455 - L2C CNV-3003 Distribution channel logic enhancement: Update this Conversion Specs Distribution Channel logic to follow CNV-3003


List of source systems and approximate number of records: 
SourceScope

Source Approx No. of Records

Target SystemTarget Approx

No. of Records

WP2

Customer Material Info Records, table: KNMT

26,000

S/4HANA ROW

26,000

PF2

Customer Material Info Records, table: KNMT

10,000

S/4HANA ROW

10,000

WP2Customer Material Info Records, table: KNMT5,000S/4HANA China5,000
PF2Customer Material Info Records, table: KNMT500S/4HANA China500
WP2Customer Material Info Records, table: KNMT

51,000

S/4HANA CUI

51,000

PF2Customer Material Info Records, table: KNMTN/AS/4HANA CUIN/A

WP2

Customer Material Info Records, Text, table: STXH40,000S/4HANA ROW40,000

PF2

Customer Material Info Records, Text, table: STXH300S/4HANA ROW300
WP2Customer Material Info Records, Text, table: STXH10,000S/4HANA China10,000
PF2Customer Material Info Records, Text, table: STXHN/AS/4HANA ChinaN/A
WP2Customer Material Info Records, Text, table: STXH15,000S/4HANA CUI15,000
PF2Customer Material Info Records, Text, table: STXHN/AS/4HANA CUIN/A

Additional Information

Multi-language Requirement

As per MDS, Text are only migrated for the valid/ approved language. Refer to MAP_LANGU - ECC (PF2/ WP2) to S/4AHANA Language Mapping Table. 

N/A

Document Management

N/A

Legal Requirement

N/A

Special Requirements

Due to compliance requirement, there will be one SAP instance for Rest of the World (ROW) , and one for China and one for CUI. Based on the sales organization the Customer Material Info Records (CMIR) records will be migrated to respective SAP instances.

  


Target Design

Customer Material Information Records (CMIR) Data strictly adheres to the Master Data Standard. The complete information of the tables and key fields that hold the Customer Material Information Records (CMIR) information follows the Master Data Standard document.

The technical design of the target for this conversion approach.

20251205-Eka: MDS updated - KNMT-RDPRF (Rounding Profile) and KNMT-MEGRU (Unit of Measure Grp) set to NOT USED.

TableField
TableField
Data ElementField DescriptionData TypeLengthRequirement
KNMTVKORGVKORGSales OrganizationCHAR4Mandatory
KNMTVTWEGVTWEGDistribution ChannelCHAR2Mandatory
KNMTKUNNRKUNNR_VCustomerCHAR10Mandatory
KNMTMATNRMATNRMaterialCHAR40Mandatory
KNMTSORTLSORTLSearch termCHAR10Optional
KNMTKDMATMATNR_KUCustomer MaterialCHAR35Optional
KNMTPOSTXKDPTXCustomer DescriptionCHAR40Optional
KNMTLPRIOLPRIODelivery PriorityNUMC2Optional
KNMTMINLFMINLFMinimum Delivery QtyQUAN13Optional
KNMTKZTLFKZTLFPart.dlv./itemCHAR1Optional
KNMTANTLFANTLFMax.Part.DeliveriesDEC1Optional
KNMTUNTTOUNTTOUnderdel. ToleranceDEC3Optional
KNMTUEBTOUEBTOOverdeliv. ToleranceDEC3Optional
KNMTUEBTKUEBTK_VUnlimited ToleranceCHAR1Optional
KNMTWERKSWERKS_EXTPlantCHAR4Optional
KNMTRDPRFRDPRFRounding ProfileCHAR4

Optional

Not Used

KNMTMEGRUMEGRUUnit of Measure GrpCHAR4

Optional

Not Used

KNMTVWPOSVWPOSItem UsageCHAR4Optional

CMIR Long Text 

*This CMIR Long Text is Optional.

STXH
KNMT
TDOBJECT
VKORG
TDOBJECTTexts: application object
VKORGSales OrganizationCHAR
10
4
Optional
Mandatory
STXH
KNMT
TDNAME
VTWEG
TDOBNAME
VTWEG
Name
Distribution ChannelCHAR
70
2
Optional
Mandatory
STXH
KNMT
TDID
KUNNR
TDID
KUNNR_VCustomerCHAR10Mandatory
KNMTMATNRMATNRMaterialCHAR40Mandatory
STXHTDNAMETDOBNAMENameCHAR70Mandatory
STXHTDIDTDIDText IDCHAR4
Optional
Mandatory
STXHTDSPRASSPRASLanguage KeyLANG1
Optional
Mandatory
Function Module
read_text
Long Text
Text Details/ Long TextCHAR
Optional

Mandatory


Data Cleansing

All data cleansing should take place in the data source system as defined in this document, unless system limitations prevent it. Consider relevancy rule in the cleansing report except the Plant relevancy in 1036-001 to 1036-006.

IDCriticalityError Message/Report DescriptionRuleOutputSource System

1036-001

C1

Customer with flag for deletion

Flag for deletion for all area (KNA1-LOEVM) OR flag for deletion at company code level (KNB1-LOEVM) OR flag for deletion at sales area level (KNVV-LOEVM) is 'X' - Yes 

*Company code: get TVKO-BUKRS, where TVKO-VKORG = KNMT-VKORG

Source System/ Customer No./ Customer Name/ Country/ Sales Organization/ Sales Organization Name/ Distribution Channel/ Distribution Channel Name/ Division/ Division Name/ Company Code/ Company Code Name/ Flag for deletion for all area level/ Flag for deletion at company code level/ Flag for deletion at sales area level

PF2/ WP2

1036-002

C1

Customer with posting block

Posting block for all company code (KNA1-SPERR) OR posting block at company code level (KNB1-SPERR) is "X" - Yes

*Company code: get TVKO-BUKRS, where TVKO-VKORG = KNMT-VKORG

Source System/ Customer No./ Customer Name/ Country/ Sales Organization/ Sales Organization Name/ Distribution Channel/ Distribution Channel Name/ Division/ Division Name/ Company Code/ Company Code Name/ Posting block for all company code/ Posting block at company code level

PF2/ WP2

1036-003

C1Customer with sales blockSales block for all sales area (KNA1-CASSD) OR sales block at sales area level (KNVV-CASSD) is "X" - YesSource System/ Customer No./ Customer Name/ Country/ Sales Organization/ Sales Organization Name/ Distribution Channel/ Distribution Channel Name/ Division/ Division Name/ Sales block for all sales area/ Sales block at sales area levelPF2/ WP2
1036-004C1Customer with order block, delivery block or billing block

Order block for all sales area (KNA1-AUFSD) OR order block at sales area level (KNVV-AUFSD) OR delivery block for all sales area (KNA1-LIFSD) OR delivery block at sales area level (KNVV-LIFSD) OR billing block for all sales area (KNA1-FAKSD) OR billing block at sales area level (KNVV-FAKSD) is NOT BLANK.

Source System/ Customer No./ Customer Name/ Country/ Sales Organization/ Sales Organization Name/ Distribution Channel/ Distribution Channel Name/ Division/ Division Name/ Order block for all sales area (code + description)/ Order block at sales area level (code + description)/ Delivery block for all sales area (code + description)/ Delivery block at sales area level (code + description)/ Billing block for all sales area (code + description)/ Billing block at sales area level (code + description)PF2/ WP2
1036-005C1Material with flag for deletion

Flag for deletion at client level (MARA-LVORM) OR flag for deletion at distribution chain level (MVKE-LVORM) is 'X' - Yes 

Source System/ Customer No./ Customer Name/ Country/ Sales Organization/ Sales Organization Name/ Distribution Channel/ Distribution Channel Name/ Material No./ Material Description/ Flag for deletion at client level/ Flag for deletion at distribution chain level/ Plant (KNMT)/ Plant in-scope flagPF2/ WP2
1036-006C1Material with distribution-chain material status

Cross-distribution-chain material status (MARA-MSTAV) OR Distribution-chain-specific material status (MVKE-VMSTA) is NOT BLANK 

Source System/ Customer No./ Customer Name/ Country/ Sales Organization/ Sales Organization Name/ Distribution Channel/ Distribution Channel Name/ Material No./ Material Description/ Cross-distribution-chain material status code and the description/ Distribution-chain-specific material status code and the description/ Plant (KNMT)/ Plant in-scope flagPF2/ PF2/ WP2
1036-007C1Duplicate records due to S/4HANA distribution channel determination

REMOVE FROM REPORT AND KEEP DCT

  • Get ALL sales documents for the last 4 years for sales organization in scope and document category/ VBAK-VBTYP = C - Order.
  • Get valid sales documents for customer material info records; VBPA-VBELN = VBAK-VBELN, where VBPA-KUNNR = KNMT-KUNNR (ignore the partner function)
  • From the valid sales document (point #2), get the Ship-to Party country; VBPA-LAND1, where VBPA-PARVW = SH/ Ship-to party
  • From the valid sales document (point #2), get the Plant; VBAP-WERKS, where VBAP-VBELN = VBPA-VBELN and VBAP-MATNR = KNMT-MATNR.
  • Get the Plant country; T001W-LAND1, where T001W-WERKS = VBAP-WERKS
  • IF Plant Country = Ship-to Party Country: map to S/4HANA distribution channel = 20 Domestic
    IF Plant Country <> Ship-to Party Country: map to S/4HANA distribution channel = 10 Export
    IF the sales order created for both 10 Export and 20 Domestic; then create 2 Customer Master Info Records as per distribution channel. Source System/ Customer No./ Customer Name/ Country/ Sales Organization/ Sales Organization Name/ Sales Organization Country/ Distribution Channel/ Distribution Channel Name/ Material No./ Material Description/ Sales Document Plant/ Plant Name/ Plant Country/ S/4HANA Sales Organization/ S/4HANA Sales Organization Name/ S/4HANA Sales Organization Country/ S/4HANA Distribution Channel/ S/4HANA Distribution Channel Name/ ALL KNMT required field as per Target Design above.
    Example:
    Cust.   Mat.   Sls.Orgn.   Dist.Ch.   Sls.Ord.Plant   S/4 Sls.Orgn.        S/4 Distr.Ch.
    1          M1     1111           11            1001             4444                   10 Export
    1          M1     1111           11            1002             4444                   20 Domestic
    1          M1     1111           11            1003             4444                   20 Domestic
    1          M1     1111           12            1004             4444                   10 Export
    1          M1     1111           12            1005             4444                   20 Domestic
    For the same Customer, Material and Sales Organization; there are 5 records but we only need 2 records to be migrated to S/4HANA
    PF2/ WP2CMIR - General records for the same Sales Organization, Customer and Material

    Source System/ All KNMT fields with duplicate records. 

    Exclude: KNMT-RDPRF (Rounding Profile) and KNMT-MEGRU (Unit of Measure Grp)

    PF2/ WP2
    1036-008C1Duplicate CMIR - Long Text records for the same Sales Organization, Customer, Material, Text ID and Language
    Source System/ All Long Text along with key fields with duplicate records. PF2/ WP2
    1036-009C1Invalid records without Customer Material Details
    1. Sales Organization/ KNMT-VKORG = sales organization in-scope
    2. Distribution Channel/ KNMT-VTWEG = not blank
    3. Customer/ KNMT-KUNNR = not blank
    4. Material/ KNMT-MATNR = not blank
    5. Search Term/ KNMT-SORTL = blank
    6. Customer Material/ KNMT-KDMAT = blank
    7. Customer Description/ KNMT-POSTX = blank
    8. Delivery Priority/ KNMT-LPRIO = blank/ 0
    9. Minimum Delivery Quantity/ KNMT-MINLF = blank/ 0
    10. Maximum Number of Partial Deliveries Allowed per Item/ KNMT-ANTLF = blank/ 0
    11. Under Delivery Tolerance/ KNMT-UNTTO = blank/ 0
    12. Over Delivery Tolerance/ KNMT-UEBTO = blank/ 0
    13. Unlimited Tolerance/ KNMT-UEBTK = unchecked
    14. Plant/ KNMT-WERKS = blank
    15. Rounding Profile/ KNMT-RDPRF = blank
    16. Unit of Measure Group/ KNMT-MEGRU = blank
    17. Item Usage/ KNMT-VWPOS = blank
    18. Text Object/ STXH-TDOBJECT = KNMT and Text Name/ STXH-TDNAME = as per point 1-4 above and no values found
    Source System/ Customer No./ Customer Name/ Country/ Sales Organization/ Sales Organization Name/ Sales Organization Country/ Distribution Channel/ Distribution Channel Name/ Material No./ Material Description/ Search Term/ Customer Material/ Customer Description/ Delivery Priority/ Minimum Delivery 1036-008C1Invalid records without Customer Material Details
    1. Sales Organization/ KNMT-VKORG = sales organization in-scope
    2. Distribution Channel/ KNMT-VTWEG = not blank
    3. Customer/ KNMT-KUNNR = not blank
    4. Material/ KNMT-MATNR = not blank
    5. Search Term/ KNMT-SORTL = blank
    6. Customer Material/ KNMT-KDMAT = blank
    7. Customer Description/ KNMT-POSTX = blank
    8. Delivery Priority/ KNMT-LPRIO = blank/ 0
    9. Minimum Delivery Quantity/ KNMT-MINLF = blank/ 0
    10. Maximum Number of Partial Deliveries Allowed per Item/ KNMT-ANTLF = blank/ 0
    11. Under Delivery Tolerance/ KNMT-UNTTO = blank/ 0
    12. Over Delivery Tolerance/ KNMT-UEBTO = blank/ 0
    13. Unlimited Tolerance/ KNMT-UEBTK = unchecked
    14. Plant/ KNMT-WERKS = blank
    15. Rounding Profile/ KNMT-RDPRF = blank
    16. Unit of Measure Group/ KNMT-MEGRU = blank
    17. Item Usage/ KNMT-VWPOS = blank
    18. Text Object/ STXH-TDOBJECT = KNMT and Text Name/ STXH-TDNAME = as per point 1-4 above and no values found
    Source System/ Customer No./ Customer Name/ Country/ Sales Organization/ Sales Organization Name/ Sales Organization Country/ Distribution Channel/ Distribution Channel Name/ Material No./ Material Description/ Search Term/ Customer Material/ Customer Description/ Delivery Priority/ Minimum Delivery Quantity/ Partial Delivery at Item Level/ Maximum Number of Partial Deliveries Allowed per Item/ Under Delivery Tolerance/ Over Delivery Tolerance/ Unlimited Tolerance/ Plant/ Plant Name/ Rounding Profile/ Unit of Measure Group/ Item Usage/ Text IDPF2/ WP2

    How to clean: Customer invalid - Data cleanser to delete all materials in the CMIR, material invalid - Data cleanser to delete the invalid material only.


    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
    The process begins with extracting metadata and raw data from source systems, i.e. Syensqo ECC system WP2 and PF2. The extracted data is 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 S/4HANA system.

    Data Privacy and Sensitivity

    N/A


    Extraction

    Extract data from a SAP ECC WP2 and PF2 into Syniti Migrate for S/4HANA. Syniti Migrate connects to the source and loads the data into Syniti Migrate. There are 2 possibilities:

    1. The data exists. Syniti Migrate connects to the source and loads the data into Syniti Migrate. There are 3 methods:
      1. Perform full data extraction from relevant tables in the source system(s).
      2. Perform extraction through the application layer.
      3. Only if; Syniti Migrate cannot connect to the source, data is loaded to the repository from the provided source system extract/ report.
    2. The data does not exist (or cannot be converted from its current state). The data is manually collected by the business directly in Syniti Migrate. This is to be conducted using DCT (Data Collection Template) in Syniti Migrate. 

    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
    1036-001- Identify the source systems (WP2 and PF2) and databases involved.
    - Define the data objects (tables such as KNMT, STXH, function module: read_text for respective data from STXH, fields, records) to be extracted.
    - Establish business rules for data selection.
    Syniti / LTC Data team
    1036-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
    1036-003- Establish execution timelines and batch processing schedules.
    - Assign responsibilities for extraction monitoring.
    - Document dependencies on other migration tasks.
    Syniti
    1036-004- Define error handling mechanisms for extraction failures.Syniti


    Selection Screen

    Selection Ref

    Screen

    Selection Ref ScreenParameter NameSelection TypeRequirementValue to be entered/set

    Sales OrganizationMultipleValid Sales organization for extractionIn-Scope Sales Organizations
















    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

    DCTField NameField DescriptionRule
     


     
    Parameter NameSelection TypeRequirementValue to be entered/setSales OrganizationMultipleValid Sales organization for extractionIn-Scope Sales Organizations

    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.

    Explain why we need these 2 DCT

    DCT Rules

    DCTField NameField DescriptionRule1

    4 legacy key fields: Sales Organization, Distribution Channel, Customer, Material

    And all fields from KNMT target design

    And 2 check box: To be migrated and Update flag

    4 legacy key fields and 4 target key fields should not be changeable. Other field should be changeable for data cleanser to update the value2

    4 legacy key fields: Sales Organization, Distribution Channel, Customer, Material

    And all fields from TEXT target design

    And 2 check box: To be migrated and Update flag

    4 legacy key fields and 4 target key fields should not be changeable. Other field should be changeable for data cleanser to update the value



    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 isfull, 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 (PF2/ WP2).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 systemsFunctional 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)
    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 DescriptionMapping TableTransformation Logic
    Customer Material Information Records

    Data Extraction Logic for Customer Material Information Records

    1. Process by Source System
    Perform the extraction steps from source system, i.e. WP2 and PF2.

    2. Extract Customer Material Information Records - Data
    Extract customer material information records from condition - KNMT Customer-Material Info Record Data Table) with the following filters:
    Sales Organization (VKORG): include only records for in-scope Sales Organizations provided in the parameter list.
    For fields related to Customer Master and Material Master, include records only if the corresponding migrated target value exists in the target system.

    3. Extract Customer Material Information Records - Text Selection
    For each item level from table KNMT above concatenate the sales organization (4 digit), distribution channel (2 digit), customer number (10 digit) and material number (18 digit) and default text object = KNMT; get the Text Name, Text ID and Language from table - STXH (STXD SAPscript text file header).

    Note: Text ID maybe maintained in multiple languages, please check language mapping table for list of languages to extract. 

    4.Extract Customer Material Information Records - Text Details
    For each Text Object, Text Name, Text ID and Language from table - STXH above, get the Text Details via function module: read_text.


    CR0348: Distribution Channel logic - updated as per common logic #3

    20260420-Eka: Refer to CR0455 - L2C CNV-3003 Distribution channel logic enhancement: Update this Conversion Specs Distribution Channel logic to follow CNV-3003

    1036-001WP2/ PF2KNMTVKORGSales OrganizationS/4HANAKNMTVKORGSales OrganizationMAP_VKORGMap sales organization from Source to Target using Mapping table defined here. 
    1036-002WP2/ PF2KNMTVTWEGDistribution ChannelS/4HANAKNMTVTWEGDistribution Channel

    RULE:

  • Get ALL sales documents for the last 4 years for sales organization in scope and document category/ VBAK-VBTYP = C - Order.
  • Get valid sales documents for customer material info records; VBPA-VBELN = VBAK-VBELN, where VBPA-KUNNR = KNMT-KUNNR (ignore the partner function)
  • From the valid sales document (point #2), get the Ship-to Party country; VBPA-LAND1, where VBPA-PARVW = SH/ Ship-to party
  • From the valid sales document (point #2), get the Plant; VBAP-WERKS, where VBAP-VBELN = VBPA-VBELN and VBAP-MATNR = KNMT-MATNR.
  • Get the Plant country; T001W-LAND1, where T001W-WERKS = VBAP-WERKS
    1. Refer to CNV-3003 → Special Requirements → C. Distribution Channel Transformation
    2. Fetch S4 distribution channel for corresponding customer and material combination.
    1036-003WP2/ PF2KNMTKUNNRCustomerS/4HANAKNMTKUNNRCustomerMAP_KUNNRMap customer no. from Source to Target using Mapping table defined here. 
    1036-004WP2/ PF2KNMTMATNRMaterialS/4HANAKNMTMATNRMaterialMAP_MATNRMap material no. from Source to Target using Mapping table defined here. 
    1036-005WP2/ PF2KNMTSORTLSearch termS/4HANAKNMTSORTLSearch term
    Copy Search Term
    1036-006WP2/ PF2KNMTKDMATCustomer MaterialS/4HANAKNMTKDMATCustomer Material
    Copy Customer Material
    1036-007
    IF Plant Country = Ship-to Party Country: map to S/4HANA distribution channel = 20 Domestic
    IF Plant Country <> Ship-to Party Country: map to S/4HANA distribution channel = 10 Export
    IF the sales order created for both 10 Export and 20 Domestic; then create 2 Customer Master Info Records as per distribution channel. 1036-003
    WP2/ PF2KNMT
    KUNNR
    POSTXCustomer DescriptionS/4HANAKNMT
    KUNNR
    POSTXCustomer
    MAP_KUNNRMap customer no. from Source to Target using Mapping table defined here. 
    Description
    Copy Customer Description
    1036-008
    1036-004
    WP2/ PF2KNMT
    MATNR
    LPRIO
    Material
    Delivery PriorityS/4HANAKNMT
    MATNR
    LPRIO
    Material
    Delivery PriorityMAP_
    MATNR
    LPRIOMap
    material no.
    delivery priority from Source to Target using Mapping table defined here. 
    1036-
    005
    009WP2/ PF2KNMT
    SORTL
    MINLFMinimum Delivery Qty
    Search term
    S/4HANAKNMT
    SORTLSearch term
    MINLFMinimum Delivery Qty
    Copy Minimum Delivery Qty
    Copy Search Term
    1036-
    006
    010WP2/ PF2KNMT
    KDMAT
    KZTLFPart.dlv./item
    Customer Material
    S/4HANAKNMT
    KDMATCustomer MaterialCopy Customer Material
    KZTLFPart.dlv./item
    Copy Part Dlv Item
    1036-011
    1036-007WP2/ PF2KNMTPOSTXCustomer DescriptionS/4HANAKNMTPOSTXCustomer DescriptionCopy Customer Description1036-008
    WP2/ PF2KNMT
    LPRIO
    ANTLFMax.Part.Deliveries
    Delivery Priority
    S/4HANAKNMT
    LPRIODelivery PriorityMAP_LPRIOMap delivery priority from Source to Target using Mapping table defined here. 
    ANTLFMax.Part.Deliveries
    Copy Max Part Deliveries
    1036-012
    1036-009
    WP2/ PF2KNMT
    MINLF
    UNTTOUnderdel. Tolerance
    Minimum Delivery Qty
    S/4HANAKNMT
    MINLFMinimum Delivery Qty
    UNTTOUnderdel. Tolerance
    Copy Underdel Tolerance
    Copy Minimum Delivery Qty
    1036-
    010
    013WP2/ PF2KNMT
    KZTLF
    UEBTO
    Part.dlv./item
    Overdeliv. ToleranceS/4HANAKNMT
    KZTLF
    UEBTO
    Part.dlv./item
    Overdeliv. Tolerance
    Copy Overdeliv Tolerance
    Copy Part Dlv Item
    1036-
    011
    014WP2/ PF2KNMT
    ANTLF
    UEBTKUnlimited Tolerance
    Max.Part.Deliveries
    S/4HANAKNMT
    ANTLFMax.Part.Deliveries
    UEBTKUnlimited Tolerance
    Copy Unlimited Tolerance
    Copy Max Part Deliveries
    1036-
    012
    015WP2/ PF2KNMT
    UNTTO
    WERKS
    Underdel. Tolerance
    PlantS/4HANAKNMT
    UNTTOUnderdel. Tolerance
    WERKSPlantMAP-WERKSMap delivery priority from Source to Target using Mapping table defined here. 
    Copy Underdel Tolerance
    1036-
    013
    016WP2/ PF2KNMT
    UEBTO
    RDPRFRounding Profile
    Overdeliv. Tolerance
    S/4HANAKNMT
    UEBTOOverdeliv. ToleranceCopy Overdeliv Tolerance
    RDPRFRounding ProfileMAP_RDPRFMap rounding profile from Source to Target using Mapping table defined here. 
    1036-017
    1036-014
    WP2/ PF2KNMT
    UEBTK
    MEGRUUnit of Measure Grp
    Unlimited Tolerance
    S/4HANAKNMT
    UEBTKUnlimited Tolerance
    MEGRUUnit of Measure GrpMAP_MEGRUMap unit of measure group from Source to Target using Mapping table defined here. 
    Copy Unlimited Tolerance
    1036-
    015
    018WP2/ PF2KNMT
    WERKS
    VWPOS
    Plant
    Item UsageS/4HANAKNMT
    WERKS
    VWPOS
    Plant
    Item UsageMAP
    -WERKS
    _VWPOSMap
    delivery priority
    item usage from Source to Target using Mapping table defined
    here. 
    here. 

    CMIR Long Text 

    *This CMIR Long Text is Optional.

    1036-
    016
    019WP2/ PF2KNMT
    RDPRF
    VKORG
    Rounding Profile
    Sales OrganizationS/4HANAKNMT
    RDPRF
    VKORG
    Rounding Profile
    Sales OrganizationMAP_
    RDPRFMap rounding profile from Source to Target using Mapping table defined here. 
    VKORG

    Rule same as 1036-001

    1036-
    017
    020WP2/ PF2KNMT
    MEGRU
    VTWEGDistribution Channel
    Unit of Measure Grp
    S/4HANAKNMT
    MEGRUUnit of Measure GrpMAP_MEGRUMap unit of measure group from Source to Target using Mapping table defined here. 
    VTWEGDistribution Channel

    Rule same as 1036-002

    1036-021
    1036-018
    WP2/ PF2KNMT
    VWPOS
    KUNNR
    Item Usage
    CustomerS/4HANAKNMT
    VWPOS
    KUNNR
    Item Usage
    CustomerMAP_
    VWPOSMap item usage from Source to Target using Mapping table defined here. 
    KUNNR

    Rule same as 1036-003

    1036-
    019
    022WP2/ PF2
    STXH
    KNMT
    TDOBJECT
    MATNRMaterial
    Texts: application object
    S/4HANAKNMT
    STXH
    MATNR
    TDOBJECTTexts: application object
    MaterialMAP_MATNR

    Rule same as 1036-004

    Default KNMT

    1036-
    020
    023WP2/ PF2STXHTDNAMENameS/4HANASTXHTDNAMEName

    Concatenate: 

    1st 4 digit = Sales Organization

    Next 2 digit = Distribution Channel

    Next 10 digit = Customer No.

    Last 18 digit = Material No.

    1036-
    021
    024WP2/ PF2STXHTDIDText IDS/4HANASTXHTDIDText IDMAP_TDID-KNMTMap Text ID from Source to Target using Mapping table defined here. 
    1036-
    022
    025WP2/ PF2STXHTDSPRASLanguage KeyS/4HANASTXHTDSPRASLanguage KeyMAP_LANGU

    Map language from Source to Target using Mapping table defined here. 

    Copy Language Key

    1036-
    023
    026WP2/ PF2Function Module
    read_text
    Long TextText Details/ Long TextS/4HANA

    Text Details
    Copy Text Details

    List of Custom Target Reports for this object is maintained here: Conversion Specification - Custom Reports Register.

    Transformation Mapping

    Mapping Table NameMapping Table Description
    MAP_VKORGECC (PF2/ WP2) to S/4AHANA Sales Organization Mapping Table
    MAP_KUNNRECC (PF2/ WP2) to S/4AHANA Customer No. Mapping Table
    MAP_MATNRECC (PF2/ WP2) to S/4AHANA Material No. Mapping Table
    MAP_LPRIOECC (PF2/ WP2) to S/4AHANA Delivery Priority Mapping Table
    MAP_WERKSECC (PF2/ WP2) to S/4AHANA Plant Mapping Table
    MAP_RDPRFECC (PF2/ WP2) to S/4AHANA Rounding Profile Mapping Table
    MAP_MEGRUECC (PF2/ WP2) to S/4AHANA Unit of Measure Group Mapping Table
    MAP_VWPOSECC (PF2/ WP2) to S/4AHANA Item Usage Mapping Table
    MAP_TDID-KNMTECC (PF2/ WP2) to S/4AHANA Text ID KNMT Mapping Table
    MAP_LANGU

    ECC (PF2/ WP2) to S/4AHANA Language Mapping Table

    As per MDS: Languages to be migrated must be limited to those explicitly approved for the project. It will take the local language if no change.

    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

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

    Completeness

    TaskAction
    Compare Data Counts1. Verify row counts in the source databases.
    2. Identify missing or duplicated records.
    Validate the mandatory fieldsValidate there is value for all the mandatory fields
    Validate Primary Keys and Unique Constraints1. Check for duplicate or missing primary key values, i.e. if there is same sales organization, distribution channel, customer number and material number.
    2. Ensure unique constraints are maintained.
    Test Referential IntegrityConfirm dependent records exist in related tables, such as customer master, material master, plant, etc. S/4HANA.

    Accuracy

    TaskAction

    Validate the transformation

    Validate 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 Counts1. Verify row counts in the source 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
    Conversion AccuracyBusiness Data Owner/s to verify that all the data in the load table/ file is accurate as per endorsed transformation/ mapping rules (and signed-off DCT data).


    Load

    The load process includes:

    1. Execute the automated data load into target system using load tool or produce the load file as per format in Transformation Rule section 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
    1Confirm readiness of final approved data sets for each ECC source system WP2 and PF2Business / Functional Team
    2Validate transformation rules and mappings in Syniti toolData Team (L2C-Data)
    3Generate target-ready load files based on S/4HANA customer material info records table formatData Team (Syniti)
    4Review and approve load files before executionBusiness / Functional Team
    5Execute the upload program in the S/4HANA systemData Load Team
    6Monitor load progress and capture load statistics (records loaded, errors, duplicates, etc.)Data Team (Syniti) / Technical Team
    7Extract loaded data from S/4HANA for post-load validationData Team (Syniti)
    8Perform post-load data validation (compare target data with source/ approved files) for all loaded customer material info recordsData Team (L2C-Data)
    9Log and resolve any data load errors or mismatches identified during validationData Team (L2C-Data) + Functional Team + Data Team (Syniti)
    10Obtain business sign-off on successful load and validationBusiness Team
    11Archive load logs, error reports, and validation results for audit/complianceData Team (L2C-Data) / Data Team (Syniti) / PMO


    Load Phase and Dependencies

    The Customer Material Information Records (CMIR) will be loaded in the pre-cutover period.

    Before loading, it will have dependency on the configuration and data objects in the S/4 HANA. The configuration needs to be transported into the respective system first.

    Configuration

    Item #Configuration Item

    1

    Sales Organization

    2

    Distribution Channel

    3

    Plant

    4Define Delivery Priority
    5Maintain Rounding Profile
    6Unit of Measure Groups
    7Define Item Category Usage
    8Define Text Types

    Conversion Objects

    Object #Preceding Object Conversion Approach

    3003

    Business Partners - Customer (Sales and Service) - FLCU01

    2003

    Materials - Sales view with sales long text

    Error Handling

    Error TypeError DescriptionAction Taken
    Configuration/ Data TransformationThe value XXX for field XXX doesn't exist1. Check the mapping/ conversion is done properly in the loading file
    2. Validate the target value is configured/ transported in the target system
    3. Reach out to functional team to validate the configuration
    Data ErrorThe Customer Master or Material Master were not defined

    Validate the Customer Master or Material Master relevancy rule and sales area extension for the newly mapped distribution channel; maintain the customer master or material master if it is in migration scope.

    For Material Master if the Plant are maintained in the Customer Material Info Records; also validate if the Material Master Plant view are created.


    Post-Load Validation

    Project Team

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

    Completeness

    TaskAction
    Validate Record count Validate all tables has the same records as the loading file
    Perform Source-to-Target Comparisons1. Validate that migrated data matches source records count.
    2. Check for discrepancies in numerical values, text fields, and timestamps.

    Accuracy

    TaskAction
    Conduct Post-Migration ReconciliationGenerate reports comparing pre- and post-migration data; and the field value are identical. 
    Perform Manual TestingPick up a few random Sales Organization, Distribution Channel, Customer and Material, and run t-code: VD53 to validate the Customer Master Info Records were migrated correctly and can be displayed without any errors. 

    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 ComparisonsValidate that migrated data matches source records count.
    Conduct Post-Migration ReconciliationGo through post-load validation reports comparing pre- and post-migration data.

    Accuracy

    TaskAction

    Perform Manual Testing

    Conduct manual spot-checks for additional assurance.


    Key Assumptions

    • Customer Material Information Records (CMIR) Master Data Standard is up to date as on the date of documenting this conversion approach and data load. 
    • Customer Material Information Records (CMIR) is in scope based on data design and any exception requested by business.
    • There will be 3 2 SAP instances, one for ROW , and one for China and one for CUI only.

    See also

    Change log

    Change History
    limit10

    Workflow history

    Workflow Report
    parent@self
    hideheadertrue
    typeapprovals