| Status | |
|---|---|
| Owner | GANESAN-ext, Shivkumar |
| Stakeholders |
Purpose
The purpose of this document is to define the conversion approach to create BIC Assignment to Business Partner (object 1198) in S/4 HANA.
BIC Assignment to Business Partner is a master data in Treasury and Risk Management module of S4HANA. This assignment is important to ensure that the financial transactions are processed accurately and efficiently. The BIC assignment facilitates international transfers, ensure compliance with regulations, enhances security, streamlines communications, which helps reduce errors and manual intervention. In S4HANA, the transaction code to assign BIC to business partner is FTR_BP_BIC.
The document details out the field list, extraction criteria, scoping, mapping, transformation logic, generation of the pre-load file and loading of the same with respect to the object 1198- Assign BIC to business partner, to be used in treasury module of S4HANA.
Key tables and fields:
The following table is involved in S4HANA with respect to the assignment of BIC to BP.
Table TCORT_BP_BIC (Treasury: BIC Codes / Account Numbers for Business Partners) holds the BIC information. The key fields of this table are:
- PARTNER – Business Partner Number – This field provides the unique identification number of the business partner.
- VALID FROM – Valid From – Date of exposure – This field determines the validity start date of a raw exposure and any related exposure position flows created when releasing the raw exposure. This field determines the validity start date of the assignment of the BIC
- RECIPIENT TYPE – Recipient / Sender Type – This field captures the partner or acting party information, who can receive/send correspondence. The correspondence recipient type is mainly used to differentiate between internal and external recipients/senders. It is also a control parameter used in the creation of outgoing/incoming messages. E.g. “Controller Email”.
- FUNCTION – Correspondence Class – This field helps identify the type of TRM correspondence between the organisation and the partner. The correspondence class is related to the business transactions of the available message formats, such as SWIFT messages. Correspondence classes are used as configuration terms that control the channel, format, and other attributes of TRM correspondence communication. E.g. “SE Order – Order to buy or sell securities”.
- BIC - SWIFT/BIC for International Payments – The BIC (Bank identifier code) also known as SWIFT code, uniquely identifies a bank throughout the world. SWIFT stands for Society for Worldwide Interbank Financial Telecommunication. This globally unique code can be used in international payment transactions to identify the bank without the need to specify an address or bank number. Specification of the SWIFT code/BIC is mainly relevant for automatic payment transactions. It can be 8 or 11 digits.
The treasury function in legacy is carried out in the Quantum system and therefore for the conversion of this object i.e. BIC assignment to BP, the data/details need to be sourced from Quantum and transformed as applicable for S4HANA in Syniti and load using a custom program as the LTMC for this object is not available in the Data Migration Cockpit.
Conversion Scope
The scope of this document covers the approach for converting active Treasury – BIC assignments to BP from Legacy Source Systems (Quantum) into S/4HANA following the Master Data Design Standard - DD-FUN-050 Master Data Standard_1198 – Assign BIC to Business Partner.
The relevancy criteria is not applicable for this object as the relevant data will be provided by business in a DCT (Data Collection Template)
List of source systems and approximate number of records
Source | Scope | Source Approx No. of Records | Target System | Target Approx No. of Records |
Quantum | Active and in use BIC Assignment to BP | 100 <TBC> | S4HANA | 100 <TBC> |
Additional Information
Multi-language Requirement
Not applicable
Document Management
Not applicable
Legal Requirement
Not applicable
Special Requirements
As the conversion involves a source system which is non-SAP, the below area needs special handling:
- Extraction of BIC Assignment to BP from source system i.e. Quantum is to be done manually.
- Cleansing by business team to identify valid records in the source system i.e. to ensure that only active records are provided in DCT.
- The extracted records to be converted into a DCT and stored in the Syniti for transformation
- Below Value mapping tables to be created in Syniti:
- Source and target company code
- Customer / Vendor (BP) mappings i.e. source to target
- Amount and date format from source system to align with S4HANA
Target Design
The Target design of the object 1198 – Assign BIC to Business Partner on the MDS - DD-FUN-050 Master Data Standard_1198 – Assign BIC to Business Partner is as below
The technical design of the target for this conversion approach.
Table TCORT_BP_BIC - Treasury: BIC Codes / Account Numbers for Business Partners
Table | Field | Data Element | Field Description | Data Type | Length | Requirement |
TCORT_BP_BIC | PARTNER | BP_PARTNR_NEW | Business Partner Number | CHAR | 10 | Required |
TCORT_BP_BIC | VALID FROM | FTR_VALID_FROM | Valid-From Date of Exposure | DATS | 8 | Required |
TCORT_BP_BIC | RECIPIENT TYPE | FTR_RECIPIENT_TYPE | Recipient/Sender Type | CHAR | 15 | Conditional |
TCORT_BP_BIC | FUNCTION | FTR_FUNCTION | Correspondence Class | CHAR | 15 | Conditional |
TCORT_BP_BIC | BIC | SWIFT | SWIFT/BIC for International Payments | CHAR | 11 | Mandatory |
Data Cleansing
For the purpose of the Object 1201- BP Group Assignment for Inbound Correspondence, the data cleansing is not applicable. It is expected that relevant records will be provided in DCT by business.
However, for the purpose of the checking the DCT, below preload validation reports are applicable:
ID | Criticality | Error Message/Report Description | Rule | Output | Source System |
01 | High | BP Role check | Please check field RLTYP in table BUT100 to ensure that roles TR0151 and TR0152 are assigned to the business partner. As Business Partners assigned with these roles i.e. Counterpart (TR0151) or Depository Role (TR0152) will be relevant for this object. | Show records in error | DCT |
02 | Medium | Bank Master | Check that the relevant bank masters exist in the system. Please check that the SWIFT code is not blank and the bank details are correctly updated in table BUT0BK. | Show records in error | DCT |
Conversion Process
The generic high-level process steps for the conversion are as below:
- Extraction:
- Extract from the source systems: Apply the selection parameters and data relevancy as mentioned in this specification, from the relevant tables
- DCT: The DCT to be prepared if the data to be transformed and is part of the load file is not available in the Source system
- Transform
- Transform fields by applying the fields and value mapping in the Syniti
- Generate and validate Pre-load files
- Load
- Load the validated Pre-load file using SAP's LTMC or the custom upload program as applicable.
However, with respect to object 1198- Assign BIC to Business Partner - the conversion process will depend upon the DCT (Data Collection Template) which will be provided by the business based on the source data from Quantum system. This DCT will be used for transformation and generation of the pre-load file.
The load will be done via a custom program <to be confirmed>, as LTMC for this object is not available as of now.
Data Privacy and Sensitivity
None
Extraction
Extract data from a source into Syniti. There are 2 possibilities:
- The data exists. Syniti connects to the source and loads the data into Syniti. There are 3 methods:
- Perform full data extraction from relevant tables in the source system(s).
- Perform extraction through the application layer.
- Only if Syniti; cannot connect to the source, data is loaded to the repository from the provided source system extract/report.
- The data does not exist (or cannot be converted from its current state). The data is manually collected by the business directly in Syniti. This is to be conducted using DCT (Data Collection Template) in Syniti.
The agreed Relevancy criteria is applied to the extracted records to identify the records that are applicable for the Target loads
In case of the object 1198-Assign BIC to Business Partner the data is to be provided in a DCT by the business, therefore extraction related activity is outside Syniti.
Extraction Run Sheet
Req # | Requirement Description | Team Responsible |
01 | Extract from relevant tables/details from Quantum all relevant information required to populate the DCT for BIC Assignment to BP for relevant Company Codes | Business |
Selection Screen
Not applicable
Data Collection Template (DCT)
Target Ready Data Collection Template will be created for Object 1198- Assign BIC to Business Partner with exception of some fields which require transformation as mentioned in the transformation rule.
1198 – Assign BIC to Business Partner DCT Rules
Note:
- Only the fields which are marked as Required or Conditional in the MDS for this object have been considered below
- Business Users to provide the values in the DCT.
- DCT checks only the field length and field behaviour (mandatory/optional etc.) checks, therefore Users must provide valid Configuration values where applicable
Field Name | Field Description | Rule |
TCORT_BP_BIC-PARTNER | Partner | This is required field For the DCT, please update a business partner number for which the BIC / SWIFT code needs to be assigned. |
TCORT_BP_BIC-VALID_FROM | Valid From Date | This is a required field. In the DCT please enter the "Valid from" date i.e. the validity start date of the assignment of the BIC |
TCORT_BP_BIC-RECIPIENT_TYPE | Recipient/Sender Type | This is Conditional field For the DCT, please update the valid recipient type relevant for the business partner i.e. any partner or acting party who can receive/send correspondence. |
TCORT_BP_BIC-FUNCTION | Correspondence Class | This is Conditional field For the DCT, please update the type of TRM correspondence between Syensqo and the Business Partner. The correspondence class is related to the business transactions of the available message formats, such as SWIFT messages. e.g. SE Order. |
TCORT_BP_BIC-BIC | SWIFT / BIC | This is a mandatory field For the DCT, please update the SWIFT code, unique to the business partner. |
Extraction Dependencies
For object 1198- Assign BIC to Business Partner, no extraction dependencies is applicable as this is DCT and a Master Data by nature.
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 to make the data Target ready:
- Perform value mapping and data transformation rules.
- Legacy values are mapped to the to-be values (this could include a default value)
- Values are transformed according to the rules defined in Syniti
- 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 Description | Team Responsible |
1 | Ensure all the fields that require value mapping, as stipulated Mapping tables, have the latest signed-off mapping files imported into Syniti | Data team |
2 | Ensure that signed off value mappings have been maintained in the Syniti | Syniti team |
3 | Confirm the value mappings as maintained in the Syniti | Data team |
4 | Ensure that Signed off CONSTRUCT from business has been received and maintained in Syniti | Syniti/Data team |
5 | Execute transformation for the object | Syniti team |
6 | Monitor the transformation progress and ensure performance and completion is within allowed timeframe | Syniti/Data team |
7. | Generate Pre-Load reports. | Syniti team |
8. | Generate data load count. | Syniti team |
9. | Log errors as defects, if any and address resolutions. Close defects. | Syniti/Data team |
10. | Re-transform and re-validate the Pre-load reports if necessary. | Syniti/Data team |
11. | Validate the transformed file as part of pre-load validation, raise data defects or provide the pre-load sign-off. | Business |
12. | Analyse and resolve any pre-load defects logged by business. | Syniti/Data team |
13. | Repeat steps 5 to 11 if necessary | Syniti/Data team |
14. | Proceed to pre-load validations | Data team |
Transformation Rules
Rule # | Source system | Source Table | Source Field | Source Description | Target System | Target Table | Target Field | Target Description | Transformation Logic |
01 | NA | NA | NA | CONSTRUCT | S4HANA | TCORT_BP_BIC | PARTNER | Business Partner Number | As per DCT |
02 | NA | NA | NA | CONSTRUCT | S4HANA | TCORT_BP_BIC | VALID FROM | Valid-From Date of Exposure | As per DCT |
03 | NA | NA | NA | CONSTRUCT | S4HANA | TCORT_BP_BIC | RECIPIENT TYPE | Recipient/Sender Type | As per DCT |
04 | NA | NA | NA | CONSTRUCT | S4HANA | TCORT_BP_BIC | FUNCTION | Correspondence Class | As per DCT |
05 | NA | NA | NA | CONSTRUCT | S4HANA | TCORT_BP_BIC | BIC | SWIFT/BIC for International Payments | As per DCT |
Transformation Mapping
Mapping Table Name | Mapping Table Description |
Business Partner | Mapping Table for Quantum counterparty/partner code to S4HANA Business Partner |
Transformation Dependencies
List the steps that need to occur before transformation can commence
Item # | Step Description | Team Responsible |
1 | Ensure all the fields that require value mapping, as stipulated Mapping tables, have the latest signed-off mapping files imported into Syniti | Data team |
2 | Ensure that signed off value mappings have been maintained in the Syniti | Syniti team |
3 | Confirm the value mappings as maintained in the Syniti | Data team |
4 | Ensure that Signed off DCT from business has been received and maintained in Syniti | Syniti/Data team |
5 | Confirm on the extracted values | Syniti, Data and business |
Pre-Load Validation
Project Team
The Pre Load validations are performed by Project Team
Completeness
Task | Action |
Generation of | Mandatory field check.
|
Record Count | Record Count Confirm the record counts in preload summary report
|
Business Confirmation | Data team after the initial validation of Pre-Load validation based on the pre agreed validation checklist To send the Pre-Load file to the Business Representatives for all plants/valuation area in scope for conversion Business Representatives to validate the pre-load file Agree with data team on the next steps for erroneous records |
Accuracy
Task | Action |
Mandatory field mapping and transformation | Obtain a list of the fields to be populated with values from mapping files and ensure all these fields contain S/4HANA values.
|
Business Value Checks |
|
Records in Errors | Review and correct the errors. Achieve a zero-error record count as much as possible. Raise defects for data remediated and requiring a correction in the source data. |
Business
The following pre-load validations will be performed by business.
Completeness
Task | Action |
Check Data load register count | Business Data Owner/s to verify that the total number of relevant records to be converted as per DCT is equal to the total number of records in the Preload file. |
Accuracy
Task | Action |
Conversion accuracy | To check and validate the load files with all the transformation and mapping rules, to be signed off. |
Load
The load process includes:
- Execute the automated data load into target system using load tool or produce the load file if the loading of records to be done via a custom program <TBC>, as LTMC for this object is not available as of now.
- Once the data is loaded to the target system, it will be extracted and prepared for Post Load Data Validation with side by side check of each fields in scope of the objects with fields to be displayed as XXXX_ECC, XXXX_S4HANA, XXXX_MATCH ( As TRUE or FALSE) with an additional column denoting fields not matching and status of loading in S/4HANA as LOADED_IN_S4HANA ( As TRUE or FALSE)
Load Run Sheet
Item # | Step Description | Team Responsible |
01 | Go to load file and pick 5 data records, load manually without any tool. See what happens. If all okay, proceed with the next step. | Data team |
02 | Go to load file and pick 10 records and load them with the tool. No action if the previous step has fallen. If not, then continue to load 10 records with the tool. Check if everything went okay. | Data team |
03 | Proceed with the full load if steps one and two were succeed else fix the issue with records | Data team |
04 | Validate few records loaded by accessing standard transactions from S/4HNA e.g. FTR_BP_BIC | Data team |
05 | Generate post load report if step 5 is validated | Data team |
06 | Log errors as defects, if any and address resolutions. Close defects. | Data team |
07 | Resolve defects by reupload and re-generate post load reports if necessary. | Data team |
08 | Business to validate the post load files as part of post-load validation, raise data defects or provide the post-load sign-off. | Business |
09 | Repeat steps 1 to 5 if necessary. | Data team |
Load Phase and Dependencies
The load phase for the object 1198-Assign BIC to Business Partner
Configuration
Below configurations should exist
Item # | Configuration Item |
01 | Recipient Type |
02 | Correspondence class |
03 | Bank Keys |
Conversion Objects
Object # | Preceding Object Conversion Approach |
CNV- 3018 | Business Partners - FI Vendor (FLVN00) |
CNV- 3007 | Business Partners - General (Role 000000) |
CNV-1203 | Treasury Business Partner Depository Bank - TR0152 |
CNV-3040 | BP Counterparty |
Error Handling
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 |
Valid Master | Business Partner is not having a valid treasury role | Ensure that Business Partner is updated |
Update Type | Update Type (Valid From Date) date is in the past | Check the Security Account's update type field value and correct the record |
Post-Load Validation
Project Team
The following post load validations will be done by Project Team
Completeness
Task | Action |
Reconciliation of Record Count | Record Count - Count and check how many records were loaded vs. Records in the load file (Each mock has it's own data record count) Check for logs from Load and fix erroneous records, if any. |
Accuracy
Task | Action |
Check values in key fields for accuracy | Post-load reports will have the same structure as the load file and some additional columns as required to facilitate the post load validation. Leverage on tool to create a Post Load report that reports S/4HANA loaded records along with the legacy values side-by-side to allow for 100% check of all these fields in the shortest possible time. Any mismatch will be reported under the Post Load - Error report. |
Business
The following post load validations will be done by business.
Completeness
Task | Action |
Record Count Check | Review the record count report from the Data Team and ensure it is correct by cross-checking with the record count confirmed during Pre-load Business Validations Business may also run transaction code FWDP to cross check the records created for Securities Account |
Accuracy
Task | Action |
Field Checks | Check the fields to ensure that Security Accounts against Depository Banks and Clearing Accounts have been properly maintained Check the other key fields such as Portfolio, Valid from, Update Types as applicable |
Key Assumptions
- Master Data Standard is up to date as on the date of documenting this conversion approach and data load.
- Object 1198 is in scope based on data design and any exception requested by business.
- Only the relevant records for BIC Accounts to BP will be provided by business (sourced from Quantum) in the DCT
- The load will be done via a custom program <TBC> for this object is not available as of now.
1 Comment
GARCIA-ext, Angel Luis
PILLAY-ext, Lawrence GANESAN-ext, Shivkumar
Please move to tech review in order we can approve it