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

Compare with Current View Page History

« Previous Version 7 Next »

Status

10%

OwnerVIDWANS-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


SourceScope

Source Approx No. of Records

Target SystemTarget 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:

  1. Extraction of CP data from source system i.e. Quantum is to be done manually
  2. 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
  3. The extracted records to be converted into a DCT and stored in the Syniti for Transformation
  4. Below Configuration Check Tables needs to be referenced in Syniti to validate the data in the DCT:
    1. Counterparty to Business Partner - BUT100
    2. Company Code - T001
    3. Product Type - TZPA
    4. Transaction Type -  AT10
    5. Trader - TZDEA
    6. Portfolio Code - TWPOB  
    7. General Valuation Class - TRGC_COM_VALCL
    8. Interest Calculation Method - Custom Check Table with Value Fields given in the below CNV
  5. Amount and date format from source system to align with S4HANA 
  6. 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 NumberText
0Pro Rata Temporis
1Include Fully
2Do 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 NameFieldField DescriptionData TypeLengthRequirement
VTBFHABUKRSCOMPANY_CODECHAR4This is a Required Field
VTBFHASGSARTPRODUCT_TYPECHAR3This is a Required Field
VTBFHASFHAARTTRANSACTION_TYPECHAR3This is a Required Field
VTBFHAKONTRHPARTNERCHAR10This is a Required Field
VTBFHADBLFZCONTRACT_DATEDATS8This is a Required Field
VTBFHAZURDEALERTRADERCHAR12This is Optional Field
VTBFHARPORTBPORTFOLIOCHAR10This is Optional Field
VTBFHAZUONDASSIGNMENTCHAR18This is Optional Field
VTBFHAZUNORDEXTEXTERNAL_REFERENCECHAR16This is Optional Field
VTBFHAREFERINTERNAL_REFERENCECHAR16This is Optional Field
VTBFHAMERKMCHARACTERISTICSCHAR25This is a Required Field
VTBFHATPM_COM_VAL_CLASSVALUATION_CLASSNUMC4This is a Required Field
VTBFHADBLFZTerm StartDATS8This is a Required Field
VTBFHADELFZTerm EndDATS8This is a Required Field
NANACalculation Period: Start Inclusive vs. End InclusiveCHAR1This is a Required Field
VTBFHAWGSCHFTTransaction CurrencyCUKY5This is a Required Field
VTB_ASGN_LIMITLIMIT_DATEFTR Assignment Management: Limit DateDATS8This is a Required Field
VTB_ASGN_LIMITLIMIT_CHG_AMOUNTFTR Assignment Management: Drawing AmountCURR17This is a Required Field
VTB_ASGN_LIMITLIMIT_CURRENCYFTR Assignment Management: Limit CurrencyCUKY5This is a Required Field
VTB_ASGN_LIMITLIMIT_POS_AMOUNTFTR Assignment Management: Drawing Amount (BAPI)DEC23This is a Required Field
VTBFINKOSRHYTHMFrequencyNUMC3This is Optional Field
VTBFINKOAMMRHY 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 FrequencyNUMC1This is Optional Field
VTBFHAPOPKONDPercentage rate for condition itemsDEC10This is Optional Field
NANACalculation method for first period of condition itemNUMC1This is Optional Field
NANACalculation method for last period of condition itemNUMC1This is Optional Field
NANAInterest Calculation MethodCHAR1This is Optional Field
VTBFHAPOSKALIDWTInterest CalendarCHAR2This is Optional Field
NANAUpdate for Calculation/Due Date for InterestNUMC2This is Optional Field
VTBFHAPODVALUTCalculation DateDATS8This is Optional Field
NANAInclusive Indicator for Calculation DateCHAR1This is Optional Field
NANAMonth-End Indicator for Calculation DateCHAR1This is Optional Field
VTBFINKOSVWERKWorking Day Shift for Calculation DayNUMC1This is Optional Field
VTBFINKODFAELLDue dateDATS8This is Optional Field
NANAMonth-End Indicator for Due DateCHAR1This is Optional Field
VTBFINKOSFWERKWorking Day Shift for Due DateNUMC1This is Optional Field
NANAShift Due Date Back to End of TermCHAR1This is Optional Field


There are 5 main tables in consideration here. 

  1. VTBFHA
  2. VTBFHAPO
  3. VTBFINKO
  4. VTB_ASGN_LIMIT
  5. 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

For the Object 9113 – Treasury Facilities no specific data cleansing is applicable due to below reasons/assumptions:

  1. The Source System is Quantum and therefore it will be a manual extract of relevant data in a DCT form


Data- Pre Load Validation Report

However, for the purpose of the object 9113 – Treasury Facilities, below validations reports should be available in Syniti so that the data as provided in DCT is validated before generating the pre-load file. 


IDCriticalityError Message/Report DescriptionRuleOutput
1HighCompany Code is validCheck if BUKRS is valid as per Company Codes created in the system in Table T001Invalid Company Code
1HighPRODUCT_TYPECheck if VVSART is valid as per Product Types created in the system in Table TZPA.
Value for Facility Product Type is “CPF” or "BLT". If this is not, then the validation should fail. 
Invalid Product Type
1HighTRANSACTION_TYPECheck if SFHAART is valid as per Transaction Types created in the system in Table AT10Invalid Transaction Type
1HighPARTNERCheck if KUNNR is valid as per Business Partners created in the system under CNV 3040 Business Partner CounterpartyInvalid Partner
1HighCONTRACT_DATECheck if DVTRAB is valid in YYYYMMDD Format and is < or = Load DateContract Date greater than Load Date
1HighVALUATION_CLASSCheck if TPM_COM_VAL_CLASS is valid as per Company Codes created in the system in Table TRGC_COM_VALCLInvalid Valuation Class
1HighTERM STARTCheck if DBLFZ is valid in YYYYMMDD Format and is < or = Contract DateTerm Start greater than or equal to Contract Date
1HighTERM ENDCheck if DELFZ is valid in YYYYMMDD Format and is < Start DateTerm End greater than Term Start


Apart from the above, a custom report is required to be created for this. The report needs to have row reference for each Interest Rate Instrument loaded under this CNY and display the standard BAPI return messages successful as well as failed. This will make sure all the deposits successfully pass all checks. An additional check is needed if

  • All dates loaded are correctly transformed into the deals created
  • Payment Details are not going blank and if yes, the BAPI will return a warning for the same. If this warning appears, it will signify the BP Master Maintenance has been missed. Such records must fail and the maintenance needs to be done at the BP Master.

Conversion Process

The generic high-level process steps for the conversion are as below:

  1. Extraction:
    1. Extract from the source systems: Apply the selection parameters and data relevancy as mentioned in this specification, from the relevant tables
    2. 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
  2. Transform 
    1. Transform fields by applying the fields and value mapping in the Syniti 
    2. Generate and validate Pre-load files
  3. Load
    1. Load the validated Pre-load file using SAP's LTMC or the custom upload program as applicable. 

However, with respect to object 9113- Treasury Facilities DCT will be used for transformation and generation of the pre-load file. 


Data Privacy and Sensitivity


Extraction

Extract data from a source into . There are 2 possibilities:

  1. The data exists. connects to the source and loads the data into . 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 ; 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 . 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 DescriptionTeam Responsible













Selection Screen

Selection Ref ScreenParameter NameSelection TypeRequirementValue 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 NameField DescriptionRule












Extraction Dependencies

Item #Step DescriptionTeam 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:

  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
  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













Transformation Rules

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









































Transformation Mapping

Mapping Table NameMapping Table Description








Transformation Dependencies

List the steps that need to occur before transformation can commence
Item #Step DescriptionTeam Responsible













Pre-Load Validation

Project Team

Completeness

TaskAction





Accuracy

TaskAction





Business

Completeness

TaskAction





Accuracy

TaskAction





Load

The load process includes:

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

Load Run Sheet

Item #Step DescriptionTeam Responsible













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 TypeError DescriptionAction Taken










Post-Load Validation

Project Team

Completeness

TaskAction





Accuracy

TaskAction





Business

Completeness

TaskAction





Accuracy

TaskAction





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.


See also

Change log

Version Published Changed By Comment
CURRENT (v. 7) Apr 23, 2026 12:24 VIDWANS-ext, Sauradh
v. 30 Apr 23, 2026 11:43 VIDWANS-ext, Sauradh
v. 29 Mar 25, 2026 08:55 VIDWANS-ext, Sauradh
v. 28 Mar 25, 2026 08:50 VIDWANS-ext, Sauradh
v. 27 Mar 23, 2026 11:37 VIDWANS-ext, Sauradh
v. 26 Mar 23, 2026 11:31 VIDWANS-ext, Sauradh
v. 25 Mar 23, 2026 09:46 VIDWANS-ext, Sauradh
v. 24 Mar 23, 2026 08:31 VIDWANS-ext, Sauradh
v. 23 Mar 19, 2026 13:02 VIDWANS-ext, Sauradh
v. 22 Mar 19, 2026 13:01 VIDWANS-ext, Sauradh

Go to Page History

  • No labels