| Status | |
|---|---|
| Owner | VIDWANS-ext, Sauradh |
| Stakeholders |
Purpose
The purpose of this document is to define the conversion approach to create Facilities Transactions in S/4 HANA.
Facilities are borrowing arrangements with either one or multiple banks. If we have a long term borrowing facility with one bank its called as Bi-Lateral Facility. Under this facility you, can define the fund requirements and the Bank will ear mark these funds to be drawn at a certain interval. If this facility is with multiple banks its called as Syndicate Facility. In a Syndicate there is normally a Lead Banker who will arrange the lending commitment from other lenders and will also have a Lead Banker charges.
These instruments are created under a certain Product Type (Instrument Number) and a Transaction Type (Kind of action i.e. buying or selling) against a counterparty (BP Number) in a Company Code.
Conversion Scope
The scope of this document covers the approach for converting active Facilities from Legacy Source System (Quantum) into S/4HANA.
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 | Live Commercial Paper Contracts | 100 <TBC> | S4HANA | 100 <TBC> |
Additional Information
Multi-language Requirement
Document Management
Legal Requirement
Special Requirements
As the conversion involves a source system which is non-SAP, the below area needs special handling:
- Extraction of CP data from source system i.e. Quantum is to be done manually
- Cleansing by business team in the source system (Quantum) to ensure that only active and in use records for CP’s are provided in DCT
- The extracted records to be converted into a DCT and stored in the Syniti for Transformation
- Below Configuration Check Tables needs to be referenced in Syniti to validate the data in the DCT:
- Counterparty to Business Partner - BUT100
- Company Code - T001
- Product Type - TZPA
- Transaction Type - AT10
- Trader - TZDEA
- Portfolio Code - TWPOB
- General Valuation Class - TRGC_COM_VALCL
- Interest Calculation Method - Custom Check Table with Value Fields given in the below CNV
- Amount and date format from source system to align with S4HANA
- As the target structure in S4HANA involves dependency on various Configuration and BP Master Data objects (CNV 3040), all this data needs to be loaded before Transactions Data loads.
Custom Check Tables for Interest Calculation Method, Frequency and Update Rule are as under:
Interest Calculation Method:
Interest Calculation Method | Text |
1 | 360E/360 |
B | 360E/365 |
L | 360/360 (German) |
F | 360/360 (ISDA) |
H | 360/365 (ISDA) |
7 | 360/360 |
2 | act/360 |
E | act/364 |
3 | act/365 |
R | act/365.25 |
4 | act/366 |
M | act/365P |
5 | act/actP (ICMA) |
6 | act/actY (ISDA) |
G | act/actE (AFB) |
Q | act/actEP (AFB) |
N | act/365L |
S | act/365Y |
A | actW/252 |
D | 365/360 |
C | 365/365 |
I | 360E/actY |
8 | 30.42E/360 |
9 | *365.25/360 |
P | 01-01-2026 |
J | m+act/360 |
K | m+30/360 |
0 | Not Specified |
T | act/act[M] |
U | actW/actW[M] |
Update Rule:
| Rule Number | Text |
| 0 | Pro Rata Temporis |
| 1 | Include Fully |
| 2 | Do Not Include |
Frequency:
1 | At End of Term |
5 | On First Day of Month |
2 | On Last Day of Month |
3 | Monthly |
4 | Daily |
0 | Manual Input |
Target Design
For a Transaction Load DCT, since there are no standard LTMC objects that we can use for loading this data, we will be using BAPI’s for this purpose. In a BAPI there are multiple fields, off which all are not necessary to be utilized as part of DCT.
In this section, we will see the full list of fields that are part of the DCT. This section will also explain field by field mapping of the DCT structure and where the data will come from for each field.
The technical design of the target for this conversion approach.
| Table Name | Field | Field Description | Data Type | Length | Requirement |
|---|---|---|---|---|---|
| VTBFHA | BUKRS | COMPANY_CODE | CHAR | 4 | This is a Required Field |
| VTBFHA | SGSART | PRODUCT_TYPE | CHAR | 3 | This is a Required Field |
| VTBFHA | SFHAART | TRANSACTION_TYPE | CHAR | 3 | This is a Required Field |
| VTBFHA | KONTRH | PARTNER | CHAR | 10 | This is a Required Field |
| VTBFHA | DBLFZ | CONTRACT_DATE | DATS | 8 | This is a Required Field |
| VTBFHAZU | RDEALER | TRADER | CHAR | 12 | This is Optional Field |
| VTBFHA | RPORTB | PORTFOLIO | CHAR | 10 | This is Optional Field |
| VTBFHA | ZUOND | ASSIGNMENT | CHAR | 18 | This is Optional Field |
| VTBFHAZU | NORDEXT | EXTERNAL_REFERENCE | CHAR | 16 | This is Optional Field |
| VTBFHA | REFER | INTERNAL_REFERENCE | CHAR | 16 | This is Optional Field |
| VTBFHA | MERKM | CHARACTERISTICS | CHAR | 25 | This is a Required Field |
| VTBFHA | TPM_COM_VAL_CLASS | VALUATION_CLASS | NUMC | 4 | This is a Required Field |
| VTBFHA | DBLFZ | Term Start | DATS | 8 | This is a Required Field |
| VTBFHA | DELFZ | Term End | DATS | 8 | This is a Required Field |
| NA | NA | Calculation Period: Start Inclusive vs. End Inclusive | CHAR | 1 | This is a Required Field |
| VTBFHA | WGSCHFT | Transaction Currency | CUKY | 5 | This is a Required Field |
| VTB_ASGN_LIMIT | LIMIT_DATE | FTR Assignment Management: Limit Date | DATS | 8 | This is a Required Field |
| VTB_ASGN_LIMIT | LIMIT_CHG_AMOUNT | FTR Assignment Management: Drawing Amount | CURR | 17 | This is a Required Field |
| VTB_ASGN_LIMIT | LIMIT_CURRENCY | FTR Assignment Management: Limit Currency | CUKY | 5 | This is a Required Field |
| VTB_ASGN_LIMIT | LIMIT_POS_AMOUNT | FTR Assignment Management: Drawing Amount (BAPI) | DEC | 23 | This is a Required Field |
| VTBFINKO | SRHYTHM | Frequency | NUMC | 3 | This is Optional Field |
| VTBFINKO | AMMRHY OR ATTRHY (Pick any field that has a value. If the Frequency Indicator is set to Months, then AMMRHY will have a value. If Frequency Indicator is set to Days then ATTRHY will have a value. | Unit for Frequency | NUMC | 1 | This is Optional Field |
| VTBFHAPO | PKOND | Percentage rate for condition items | DEC | 10 | This is Optional Field |
| NA | NA | Calculation method for first period of condition item | NUMC | 1 | This is Optional Field |
| NA | NA | Calculation method for last period of condition item | NUMC | 1 | This is Optional Field |
| NA | NA | Interest Calculation Method | CHAR | 1 | This is Optional Field |
| VTBFHAPO | SKALIDWT | Interest Calendar | CHAR | 2 | This is Optional Field |
| NA | NA | Update for Calculation/Due Date for Interest | NUMC | 2 | This is Optional Field |
| VTBFHAPO | DVALUT | Calculation Date | DATS | 8 | This is Optional Field |
| NA | NA | Inclusive Indicator for Calculation Date | CHAR | 1 | This is Optional Field |
| NA | NA | Month-End Indicator for Calculation Date | CHAR | 1 | This is Optional Field |
| VTBFINKO | SVWERK | Working Day Shift for Calculation Day | NUMC | 1 | This is Optional Field |
| VTBFINKO | DFAELL | Due date | DATS | 8 | This is Optional Field |
| NA | NA | Month-End Indicator for Due Date | CHAR | 1 | This is Optional Field |
| VTBFINKO | SFWERK | Working Day Shift for Due Date | NUMC | 1 | This is Optional Field |
| NA | NA | Shift Due Date Back to End of Term | CHAR | 1 | This is Optional Field |
There are 4 main tables in consideration here.
- VTBFHA
- VTBFHAPO
- VTBFINKO
- VTB_ASGN_LIMIT
- VTBFHAZU
The reference between the tables is a combination of Company Code and Transaction Number. This is the Primary Key to join these tables.
In Addition to this, the field "Characteristics" will have the Legacy Quantum Deal Number. This will form a linkage between Deals loaded in the system vs Quantum deals.
In the above table we saw fields in the DCT. Now we will check the fields in the BAPI and the data logic how it will correspond to the DCT.
Data Cleansing
| ID | Criticality | Error Message/Report Description | Rule | Output | Source System |
|---|---|---|---|---|---|
Conversion Process
The high-level process is represented by the diagram below:
Data Privacy and Sensitivity
Extraction
Extract data from a source into . There are 2 possibilities:
- The data exists. connects to the source and loads the data into . There are 3 methods:
- Perform full data extraction from relevant tables in the source system(s).
- Perform extraction through the application layer.
- Only if ; 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 . This is to be conducted using DCT (Data Collection Template) in
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 Description | Team Responsible |
|---|---|---|
Selection Screen
| Selection Ref Screen | Parameter Name | Selection Type | Requirement | Value to be entered/set |
|---|---|---|---|---|
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 Name | Field Description | Rule |
|---|---|---|
Extraction Dependencies
| Item # | Step Description | Team Responsible |
|---|---|---|
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 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
- 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 |
|---|---|---|
Transformation Rules
| Rule # | Source system | Source Table | Source Field | Source Description | Target System | Target Table | Target Field | Target Description | Transformation Logic |
|---|---|---|---|---|---|---|---|---|---|
Transformation Mapping
| Mapping Table Name | Mapping Table Description |
|---|---|
Transformation Dependencies
List the steps that need to occur before transformation can commence| Item # | Step Description | Team Responsible |
|---|---|---|
Pre-Load Validation
Project Team
Completeness
| Task | Action |
|---|---|
Accuracy
| Task | Action |
|---|---|
Business
Completeness
| Task | Action |
|---|---|
Accuracy
| Task | Action |
|---|---|
Load
The load process includes:
- Execute the automated data load into target system using load tool or product the load file if the load must be done manually
- 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 Description | Team Responsible |
|---|---|---|
Load Phase and Dependencies
Configuration
| Item # | Configuration Item |
|---|---|
Conversion Objects
| Object # | Preceding Object Conversion Approach |
|---|---|
| list the exact title of the conversion object of only the immediate predecessor – this will then confirm the DDD (Data Dependency Diagram) | |
Error Handling
| Error Type | Error Description | Action Taken |
|---|---|---|
Post-Load Validation
Project Team
Completeness
| Task | Action |
|---|---|
Accuracy
| Task | Action |
|---|---|
Business
Completeness
| Task | Action |
|---|---|
Accuracy
| Task | Action |
|---|---|
Key Assumptions
- Master Data Standard is up to date as on the date of documenting this conversion approach and data load.
- is in scope based on data design and any exception requested by business.