| Status | |
|---|---|
| Owner | Prasad Naidu |
| Stakeholders | The business stakeholders involved in making, reviewing, and endorsing this decision. Type @ to mention people by name |
The purpose of this document is to define the conversion approach to create Business Partners - FI Customer (FLCU00) in S/4 HANA.
Business Partner - FI Customer Role captures the Customer’s FI data attributes such as Reconciliation Account, Tax Code, etc. at the Company Code level.
The scope of this document covers the approach for converting active Customer Master Data from Legacy Source Systems into S/4HANA Business Partner Collection Management (UDM00) Master Data Design Standard.
The CNV-3007 Business Partners – General (Role 000000) relevancy criteria will also be used for this conversion document.
Customer Master Data - General Information
The data from legacy system includes:
1. Customer with AR Balance under the company codes within S4 Hana implementation scope (BSID-KUNNR).
2. or (Customer doesn't have central deletion indicator (KNA1-LOEVM="") AND Customer has active sales view data within the sales organizations in scope(KNVV-KUNNR)) and there is usage within 4 years. * modified on 16/Oct/2025
3. or (Customer doesn't have central deletion indicator and customer has active company code view within the company codes in scope) and there is usage within 4 years. * modified on 16/Oct/2025
4. or there is customer consignment stock and the plant for the consignment stock is within S4 Hana implementation scope.
5. or Customer is set as the credit account for other customers, and either the customer or credit account customer is not deleted. (if both customer or credit account is deleted, then not in migration scope)
6. Intercompany customer will be defined based on the Enterprise structure. (To identify Intercompany customer, trading partner will be used. In the meantime, Group field(KNA1-KONZS) from customer general data will be used. For WP2/PF2, Group value = 0000810135 (Syensqo) )
7. or the customer in the partner function is active, then the parent customer will also be migrated. * added on 16/Oct/2025
8. or the customer is active in Salesforce and there are activities within 48 months.* added on 16/Oct/2025
9. or there is an existing forecast for the customer in Kinaxis. * added on 16/Oct/2025
10. or there is active master data for the customer, such as active Pricing Condition records. * added on 16/Oct/2025
| Criteria | Relevancy Rule | Technical Details |
| 1 | Customer with AR Balance under the company codes within S4 Hana implementation scope | Select KUNNR from BSID where BSID-BUKRS in (Company code in scope) |
| 2 | or (Customer doesn't have central deletion indicator AND Customer has active sales view data within the sales organizations in scope) and there is usage within 4 years. | Select KUNNR from KNA1 where KNA1-LOEVM="" and KNVV-KUNNR = KNA1-KUNNR AND KNVV-VKORG in (Sales Org in scope) and KNVV-LOEVM = "" and usage within 4 years.
|
| 3 | or (Customer doesn't have central deletion indicator and customer has active company code view within the company codes in scope) and there is usage within 4 years | Select KUNNR from KNA1 where KNA1-LOEVM="" and KNB1-KUNNR = KNA1-KUNNR AND KNB1-BUKRS in (Company code in scope) and KNB1-LOVEM = "" and usage with 4 years
|
| 4 | or there is customer consignment stock and the plant for the consignment stock is within S4 Hana implementation scope. | Select KUNNR from MSKU where MSKU-WERKS in (Plant in scope) |
| 5 | or Customer is used for Credit Limit Reference in Credit Management, only when the credit account is different from the customer, and at least credit account or customer is still active. | Select KNKLI from KNKK where KNKK-KKBER = T001CM-KKBER and T001CM-BUKRS in (Company Code in scope based on the sales organization) where KNKK-KUNNR<>KNKK-KNKLI AND (KNA1-LOEVM is initial where KNA1-KUNNR = KNKK-KUNNR or KNA1-LOEVM is initial where KNA1-KUNNR = KNKK-KNKLI) |
| 6 | Intercompany Customer is in migration scope, but it will be use Data Collection Template to collect the information | KNA1-VBUND <>"" or KNA1-KONZS |
| 7 | or the customer in the partner function is active and in migration scope, then the parent customer will also be migrated based on rule 2. * added on 16/Oct/2025 | Select KNVP-KUNNR INNER JOIN KNA1 as a WHERE KNVP-KUNNR = a.kunnr and a.loevm = X and KNVP-VKORG in 'Sales Org in scope' inner join kna1 as b where knvp-kunn2 = b.kunnr and b.loevm = '' and kunn2 in rule 2 |
| 8 | or the customer is active in Salesforce and there are activities within 48 months. | Two reports will be provided. iCare - If (there is value in field 'PRS Code (Account)' or 'RCS code (Account)') and 'Last Activity' is within 48 months and Type <> "Inactive Customer". then the account is in scope. 'PRS Code (Account)' is mapped to PF2 customer number, 'RCS code (Account)' is mapped to WP2 customer number. Core CRM - If (there is value in field 'PRS ID / RCS ID') and 'Last Activity' is within 48 months and 'Account Organization' = 'SCO' and 'Status'<>"Rejected", then the account is in scope. 'PRS ID / RCS ID' need to split using "/" to get the PRS/RCS code and 'GBU' in (Novecare, Technology Solutions). |
| 9 | or there is an existing forecast for the customer in Kinaxis. |
|
| 10 | or there is relevant Pricing Condition records maintained for the customer 4 years ago. a. The relevant condition table will be provided, which includes the customer field b. The price valid-from date is >= current date - 4 years c. Based on the selection criteria mentioned in a&b to select the condition header index table (KONH), then use it to match the customer number. If there is match, then the customer is taken into consideration. | Select KNA1-KUNNR from KONH where KONH-KOTABNR IN (List to be provided) and KONH-DATAB >= current date - 4 years and KONH-VAKEY CS KNA1-KUNNR |
The data from legacy system excludes:
| 1 | One time customer (Account group is Z004) | KNA1-KTOKD = Z004 or ZCPD |
List of source systems and approximate number of records
| Source | Scope | Source Approx. No. of records | Target System | Target Approx. No. of records |
| PF2 | Customer Master Data General Information | 55371 | S4 | 4200 |
| WP2 | Customer Master Data General Information | 36983 | S4 | 24000 |
Summarize Multi-language Requirement/s, if any
Summarize Document Management requirement, if any
Summarize Legal Requirement/s, if any
Specify any special requirements or considerations that may impact the data conversion process based on specific locations, regulatory compliance or system limitations. Clearly outline any regional or localization requirements such as country-specific data formats, legal reporting obligations or industry standards that must be adhered to (e.g., localization rules for countries like China).
If the data conversion involves third-party systems or external data sources, such as Icertis, describe any additional requirements related to data mapping, transformation logic, validation rules or security measures that must be followed.
With Functional input, document the technical design of the target fields that are in the scope of this document.
The technical design of the target for this conversion approach.
| Table | Field | Data Element | Field Description | Data Type | Length | Requirement |
|---|---|---|---|---|---|---|
| MARA | MATNR | MATNR | Material Number | CHAR | 18 | Mandatory |
All data cleansing should take place in the data source system as defined in this document, unless system limitations prevent it.
If data cleansing is managed outside of the source system (e.g. Syniti Migrate, 3rd Party Vendor, DCT), the necessary documentation must be produced and appended to this deliverable for sign-off.
| ID | Criticality | Error Message/Report Description | Rule | Output | Source System |
|---|---|---|---|---|---|
| No legacy cleansing | Relevancy | ||||
The high-level process is represented by the diagram below:

Extract data from a source into Syniti Migrate. There are 2 possibilities:
The agreed Relevancy criteria is applied to the extracted records to identify the records that are applicable for the Target loads
| Req # | Requirement Description | Team Responsible |
|---|---|---|
| 1 | Refresh KNB1 tables via Syniti (Customer data) | Data |
| Selection Ref Screen | Parameter Name | Selection Type | Requirement | Value to be entered/set |
|---|---|---|---|---|
<Object> DCT Rules
| Field Name | Field Description | Rule |
|---|---|---|
List the steps that need to occur before extraction can commence
| Item # | Step Description | Team Responsible |
|---|---|---|
| 1 | Ensure Syniti has the necessary connection and access to legacy servers | Data |
| 2 | Ensure that the necessary cleansing activities in legacy sources are complete | Data / Business |
| 3 | Ensure that create, change and deletion of master data is freeze in legacy Production system | Legacy IT |
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:
| Item # | Step Description | Team Responsible |
|---|---|---|
| 1 | KNA1 relevancy execution in Syniti | Data |
| 2 | KNB1 relevancy execution in Syniti | Data |
| 3 | BP relevancy execution in Syniti | Data |
| 4 | Business partner FI Customer execution in Syniti | Data |
Transformation Rules
| Rule # | Source system | Source Table | Source Field | Source Description | Target System | Target Table | Target Field | Target Description |
| 1 | PF2/PI2/WP2 | KNB1 | KUNNR | Customer Account Number | S/4HANA | BP000 | PARTNER | Business Partner Number |
| 2 | PF2/PI2/WP2 | KNB1 | BUKRS | Company Code | S/4HANA | BP001 | BUKRS | Company Code |
| 3 | PF2/PI2/WP2 | KNB1 | AKONT | Reconciliation Account | S/4HANA | BP001 | AKONT | Reconciliation Account |
| 4 | PF2/PI2/WP2 | KNB1 | ZTERM | Payment Terms | S/4HANA | BP001 | ZTERM | Payment Terms |
| 5 | PF2/PI2/WP2 | KNB1 | ZWELS | Payment Methods | S/4HANA | BP001 | ZWELS | Payment Methods |
| 6 | PF2/PI2/WP2 | KNB1 | VZSKZ | Payment Block | S/4HANA | BP001 | VZSKZ | Payment Block Indicator |
| 7 | PF2/PI2/WP2 | KNB1 | XPORE | Individual Payment | S/4HANA | BP001 | XPORE | Individual Payment Indicator |
| 8 | PF2/PI2/WP2 | KNB1 | ZUAWA | Sort Key | S/4HANA | BP001 | ZUAWA | Sort Key |
| 9 | PF2/PI2/WP2 | KNB1 | DTAWS | Instruction Key | S/4HANA | BP001 | DTAWS | Instruction Key |
Mapping Table Name | Description |
Legacy Customer-BP Master Mapping | Legacy to S4 Business Partner customer mapping |
Business Partner deDupe mapping (Global Data) | dedupe Golden-child (Global) mapping |
Company Code Mapping | Legacy to S4 Company Code Mapping |
Payment Terms Mapping | Legacy to S4 Payment Terms Mapping |
Payment Method Mapping | Payment Method Mapping |
Tax Category Mapping | Legacy to S4 Tax Category Mapping |
Reconciliation Account Mapping | Legacy to S4 Reconciliation Account Mapping |
Sort Key Mapping | Legacy to S4 Sort Key Mapping |
Planning Group Mapping | Legacy to S4 Planning Group Mapping |
deDupe customer Company Code Nominations Mapping | Golden-Child Company Code data Mapping |
| Item # | Step Description | Team Responsible |
|---|---|---|
1 | Extract PF2/PI2/WP2 source tables – KNB1 | Data |
2 | Ensure that Business Partner – General is loaded | Data |
2 | Ensure all Customer master data collection templates, deduplication and cleansing completeness and no errors | Data |
3 | Ensure that all required Configurations are in S/4HANA | Data |
| Task | Action |
|---|---|
Verify count | Verify that the record count in the pre-load file is the same as the record count based on the approved DCT records |
| Task | Action |
|---|---|
Data Accuracy | Data team to verify that all the data in the load table/file is accurate as per signed-off transformation rules and DCT contents |
Mapping Error Reports | Verify that all necessary error reports have been validated, and that errors have been addressed. |
| Task | Action |
|---|---|
Verify Count for all customers | Verify that the record count in the pre-load file is the same as the record count based on the relevancy (including deduplication) results |
Verify Relevancy Rules | Verify that the relevancy rules were correctly applied |
| Task | Action |
|---|---|
Verify Data Accuracy | Verify that all the data in the load table/file is accurate as per signed-off transformation rules and DCT contents |
Review Error Reports | Verify that all necessary error reports have been validated, and that errors have been addressed. |
Verify Transformation Rules | Verify that the transformation rules are correct and have been carried out correctly |
The load process includes:
Item # | Step description | Team responsible |
1 | Load Sample Business Partners | Data |
2 | Validate sample Business Partners | Data |
3 | Load remaining Business Partners | Data |
4 | Validate data loaded for Business Partners | Data |
5 | Load Sample BP Type – Customer Contact Persons | Data |
6 | Validate sample BP Type – Customer Contact Persons | Data |
7 | Load remaining BP Type – Customer Contact Persons | Data |
8 | Validate data loaded for BP Type – Customer Contact Persons | Data |
9 | Load Sample BP Type – Vendor Contact Persons | Data |
10 | Validate sample BP Type – Vendor Contact Persons | Data |
11 | Load remaining BP Type – Vendor Contact Persons | Data |
12 | Validate data loaded for BP Type – Vendor Contact Persons | Data |
13 | Load Sample BP Type - Bank Contacts (First Name, Last Name) | Data |
14 | Validate sample BP Type - Bank Contacts (First Name, Last Name) | Data |
15 | Load remaining BP Type - Bank Contacts (First Name, Last Name) | Data |
16 | Validate data loaded for BP Type - Bank Contacts (First Name, Last Name) | Data |
17 | Load Sample BP Type – BP General, FI Customer, FI Vendor | Data |
18 | Validate sample BP Type – BP General, FI Customer, FI Vendor | Data |
19 | Load remaining BP Type – BP General, FI Customer, FI Vendor | Data |
20 | Validate data loaded for BP Type – BP General, FI Customer, FI Vendor | Data |
21 | Load Sample Vendors Default Partner | Data |
22 | Validate sample Vendors Default Partner | Data |
23 | Load remaining Vendors Default Partner | Data |
24 | Validate data loaded for Vendors Default Partner | Data |
25 | Load Sample BP - General for remaining customer roles | Data |
26 | Validate sample BP - General for remaining customer roles | Data |
27 | Load remaining BP - General for remaining customer roles | Data |
28 | Validate data loaded for BP - General for remaining customer roles | Data |
29 | Load Sample BP – Customers with Default Partner | Data |
30 | Validate sample BP – Customers with Default Partner | Data |
31 | Load remaining BP – Customers with Default Partner | Data |
32 | Validate data loaded BP – Customers with Default Partner | Data |
33 | Load Sample BP - Bank Role | Data |
34 | Validate sample BP - Bank Role | Data |
35 | Load remaining BP - Bank Role | Data |
36 | Validate data loaded BP - Bank Role | Data |
37 | Load Sample BP Relationship Contact Person to Organisation (Will create KNVK records) | Data |
38 | Validate sample BP Relationship Contact Person to Organisation (Will create KNVK records) | Data |
39 | Load remaining BP Relationship Contact Person to Organisation (Will create KNVK records) | Data |
40 | Validate data loaded for BP Relationship Contact Person to Organisation (Will create KNVK records) | Data |
41 | Load Sample BP - Carrier | Data |
42 | Validate sample BP - Carrier | Data |
43 | Load remaining BP - Carrier | Data |
44 | Validate data loaded BP - Carrier | Data |
45 | Load Sample BP - Credit Management | Data |
46 | Validate sample BP - Credit Management | Data |
47 | Load remaining BP - Credit Management | Data |
48 | Validate data loaded BP - Credit Management | Data |
49 | Load Sample BP Collections Management | Data |
50 | Validate sample BP Collections Management | Data |
51 | Load remaining BP Collections Management | Data |
52 | Validate data loaded BP Collections Management | Data |
Load Phase and Dependencies
Identify the phase as to “when” the load for this object will occur. <Pre-Cutover, Cutover, Post Cutover> and list the steps that need to occur before the load can commence
List the Configurations required before loading can commence
| Item # | Configuration Item |
|---|---|
1 | Obtain the approved upload USER ID’s to be used (e.g. Firefighter ID) |
2 | SAP USER profile (SU3) Date and Decimal Notation Formats are in sync with the load format |
3 | Company Code Configuration |
4 | Incoterms Configuration |
5 | Plant Configuration |
6 | Confirmation Control Configuration |
7 | Payment Terms Configuration |
8 | Payment Method Configuration |
9 | Reconciliation Account Configuration |
10 | Withholding Tax Types Configuration |
| Object # | Preceding Object Conversion Approach |
|---|---|
| Intercompany Business Partners | |
Business Partner - Contact | |
Business Partner – General | |
GL Accounts |
The table below depicts some possible system errors for this data object during data load. All data load error is to be logged as defect and managed within the Defect Management
| Error Type | Error Description | Action Taken |
|---|---|---|
Configuration | <configuration> is not valid/missing | If it is a missing configuration item then engage Functional team to expedite and fix the error in the system. |
Invalid Data | <parameter> is not valid. | The parameter entry needs to be reviewed (ex. invalid payment terms). If it is an invalid data, business needs to review and correct the source of the data either in PF2/PI2/WP2 or if it’s mapped in DCT. |
Technical Setup | Interface / Connection issue within target system’s landscape | N/A – the data will be loaded directly to S/4HANA environment |
| Task | Action |
|---|---|
Verify full Count of Customers | Verify that the record count in the post-load file is the same as the record count based on the relevancy (including deduplication) results |
| Task | Action |
|---|---|
Data Accuracy | Data team to verify that all the data in the load table/file is accurate as per signed-off transformation rules and DCT contents |
Error Reports | Verify that all necessary error reports have been validated, and that errors have been addressed. |
| Task | Action |
|---|---|
Verify full Count of Customers | Verify that the record count in the post-load file is the same as the record count based on the relevancy (including deduplication) results |
Validate Loaded Data | Validate, as per the loads files signed-off, that all records were created |
| Task | Action |
|---|---|
Verify Data Accuracy | Data team to verify that all the data in the load table/file is accurate as per signed-off transformation rules and DCT contents |
Review Error Reports | Verify that all necessary error reports have been validated, and that errors have been addressed. |
Validate Loaded Data | Validate, as per the loads files signed-off, that all records were created |
Any additional key assumptions.
Insert links and references to other documents which are relevant when trying to understand this decision and its implications. Other decisions are often impacted, so it's good to list them here with links. Attachments are also possible but dangerous as they are static documents and not updated by their authors.