Status

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

100 <TBC>

S4HANA

100 <TBC>

Additional Information

Multi-language Requirement

Summarize Multi-language Requirement/s, if any

Document Management

Summarize Document Management requirement, if any

Legal Requirement

Summarize Legal Requirement/s, if any

Special Requirements


As the conversion involves a source system which is non-SAP, the below area needs special handling:

  1. Extraction of Facilities 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 Facilities 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. Portfolio Code - TWPOB  
    6. General Valuation Class - TRGC_COM_VALCL
    7. 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


BP Number 

BP NumberBP Name
0000000001TEST





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
Utility Field
(VTBFHA)
ZSTDTINCLCalculation Period: Start Inclusive vs. End InclusiveCHAR1This is a Required Field
Utility Field
(VTBFHA)
ZCALCMETHCalculation method for first period of condition itemNUMC1This is Optional Field
Utility Field
(VTBFHA)
ZCALCENDCalculation method for last period of condition itemNUMC1This is Optional Field
Utility Field
(VTBFHA)
ZINTCALCMETInterest Calculation MethodCHAR1This is Optional Field
Utility Field
(VTBFHA)
ZUPDATERULEUpdate for Calculation/Due Date for InterestNUMC2This is Optional Field
Utility Field
(VTBFHA)
ZINCLINDInclusive Indicator for Calculation DateCHAR1This is Optional Field
Utility Field
(VTBFHA)
ZMENDINDIMonth-End Indicator for Calculation DateCHAR1This is Optional Field
Utility Field
(VTBFHA)
ZMENDINDIRMonth-End Indicator for Due DateCHAR1This is Optional Field
Utility Field
(VTBFHA)
ZDUEDATEINDIShift Due Date Back to End of TermCHAR1This is Optional Field
VTBFHABUKRSCOMPANY_CODECHAR4This is a Required Field
VTBFHARFHATRANSACTION NUMBERCHAR13This is Internal Field
VTBFHASGSARTPRODUCT_TYPECHAR3This is a Required Field
VTBFHASFHAARTTRANSACTION_TYPECHAR3This is a Required Field
VTBFHAKONTRHPARTNERCHAR10This is a Required Field
VTBFHADBLFZCONTRACT_DATEDATS8This is a Required Field
VTBFHARPORTBPORTFOLIOCHAR10This is Optional Field
VTBFHAZUONDASSIGNMENTCHAR18This is Optional Field
VTBFHAREFERINTERNAL_REFERENCECHAR16This is Optional Field
VTBFHAMERKMCHARACTERISTICSCHAR25This is a Required Field
VTBFHARCOMVALCLVALUATION_CLASSNUMC4This is a Required Field
VTBFHADBLFZTerm StartDATS8This is a Required Field
VTBFHADELFZTerm EndDATS8This is a Required Field
VTBFHAWGSCHFTTransaction CurrencyCUKY5This is a Required Field
VTB_ASGN_LIMITBUKRSCOMPANY_CODECHAR4This is a Required Field
VTB_ASGN_LIMITRFHATRANSACTION NUMBERCHAR13This is Internal Field
VTB_ASGN_LIMITRELAT_OBJFTR Assignment Management: Assignment ObjectCHAR22This is Internal Field
VTB_ASGN_LIMITRELAT_OBJ_CATFTR Assignment Management: Category of Assignment ObjectCHAR3This is Internal 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
VTBFHAPOBUKRSCOMPANY_CODECHAR4This is a Required Field
VTBFHAPORFHATRANSACTION NUMBERCHAR13This is Internal Field
VTBFHAPORFHAZUTransaction ActivityNUMC5This is Internal Field
VTBFHAPODCRDATENTERED ONDATS8This is Internal Field
VTBFHAPOTCRTIMENTRY TIMETIMS6This is Internal Field
VTBFHAPORFHAZBTRANSACTION FLOWNUMC4This is Internal Field
VTBFHAPOPKONDPercentage rate for condition itemsDEC10, 7This is Optional Field
VTBFHAPOSKALIDWTInterest CalendarCHAR2This is Optional Field
VTBFHAPODVALUTCalculation DateDATS8This is Optional Field
VTBFHAZUBUKRSCOMPANY_CODECHAR4This is a Required Field
VTBFHAZURFHATRANSACTION NUMBERCHAR13This is Internal Field
VTBFHAZURFHAZUTRANSACTION ACTIVITYNUMC5This is Internal Field
VTBFHAZUNORDEXTEXTERNAL_REFERENCECHAR16This is Optional Field
VTBFINKOBUKRSCOMPANY_CODECHAR4This is a Required Field
VTBFINKORFHATRANSACTION NUMBERCHAR13This is Internal Field
VTBFINKORGATTCLASSCHAR13This is Internal Field
VTBFINKORFHAZUTransaction ActivityNUMC5This is Internal Field
VTBFINKORKONDGRDIRECTION OF TRANSACTIONNUMC1This is Internal Field
VTBFINKORKONDCONDITIONNUMC4This is Internal Field
VTBFINKODGUEL_KPCONDITION ITEM EFFECTIVE FROMDATS8This is Internal Field
VTBFINKONSTUFELEVEL NUMBER OF CONDITION ITEMS FOR RECURRING PAYMENTNUMC2This is Internal Field
VTBFINKOSRHYTHMFrequencyNUMC1This is Optional Field
VTBFINKOAMMRHY OR ATTRHYUnit for FrequencyNUMC1This is Optional Field
VTBFINKOSVWERKWorking Day Shift for Calculation DayNUMC1This is Optional Field
VTBFINKODFAELLDue dateDATS8This is Optional Field
VTBFINKOSFWERKWorking Day Shift for Due DateNUMC1This 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

Not Applicable


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

01

Extract from relevant tables/reports from Quantum all relevant information required to populate the DCT for Interest Rate Instruments for relevant Company Codes.

This extraction is dependent on the extraction, validation and load of Master Data Object CNV 3040 BP Master. It is also dependent on completion of configuration for items like Company Code, Product Type, Transaction Type, Portfolio Codes, General Valuation Class. 

Business


Selection Screen

Not applicable as the extraction is manual activity to be performed by business in Quantum system.


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.Target Ready Data Collection Template will be created for 9113 - TRM Facilities with exception of some fields which require transformation as mentioned in the transformation rule.

9113 - TRM Facilities DCT Rules


Field NameField DescriptionData TypeLengthRule
BUKRSCOMPANY_CODESame as Target Design
This is a Required field. 

This data will be captured by business. It is the Company Code under which a Stock is to be created.

In DCT, S4HANA number to be populated based upon the list of Company Codes. This list needs to be provided to the Business Team who will be downloading data from Quantum System.

Default Value "1010"
SGSARTPRODUCT_TYPESame as Target Design
This is a Required field. 

This data will be captured by business. It is the Product Type under which a Stock is to be created.

In DCT, S4HANA number is defaulted to “EAP”.

Drop Down Value "CPF" and "BLT"
SFHAARTTRANSACTION_TYPESame as Target Design
This is a Required field. 

This data will be captured by business. It is the Transaction Type under which a Stock is to be created.

In DCT, S4HANA number is defaulted to “100”.

Default Value "OBT"
KONTRHPARTNERCHAR20

This is a Required field.

This data will be captured by business for Counterparties. A validation is needed to check the BP number captured in the DCT is valid one and is present as per CNV 3040 - Business Partner Counterparty.

Drop Down Value needed as a Composite Drop Down box. Please refer to the Table BP Number in the special requirements section.

DBLFZCONTRACT_DATESame as Target Design
This is a Required field.

Date format is YYYYMMDD. Contract Date will always be LESS Than the Load Date. This check needs to be implemented. 

Example: 99991231
RPORTBPORTFOLIOSame as Target Design
This is a Optional field. 

This data will be captured by business. It is the Portfolio Code to bucket all Stock under for reporting purposes.In DCT, S4HANA Portfolio Codes needs to be populated based upon the list of Portfolio's configured in the system. This list needs to be provided to the Business Team who will be downloading data from Quantum System.
Validation check needs to be done with check table TWPOB
ZUONDASSIGNMENTSame as Target Design
This is a Optional field.

This is a freely maintainable field to capture additional data for the deal. No validations needed for this field. 
NORDEXTEXTERNAL_REFERENCESame as Target Design
This is a Optional field.

This is a freely maintainable field to capture additional data for the deal. No validations needed for this field. 
REFERINTERNAL_REFERENCESame as Target Design
This is a Optional field.

This is a freely maintainable field to capture additional data for the deal. No validations needed for this field. 
MERKMCHARACTERISTICSSame as Target Design
This is a Required field.

This field will be populated with the Legacy Quantum Deal Number
TPM_COM_VAL_CLASSVALUATION_CLASSSame as Target Design
This is a Required field. 

This data will be captured by business. It is the Valuation Class under which a Stock is to be accounted for.

In DCT, S4HANA GVC number needs to be populated based upon the list of GVC's configured in the system. This list needs to be provided to the Business Team who will be downloading data from Quantum System.
DBLFZTerm StartSame as Target Design
This is a Required Field

Date format is YYYYMMDD. Start Term Date will always be LESS Than or Equal to Load Date. This check needs to be implemented as part of Preload Validation.

Example: If load date is 20260401 and date in DCT is 20260501, then the Validation Check should fail this record.  
DELFZTerm EndSame as Target Design
This is a Required Field

Date format is YYYYMMDD. End Term will always be Greater Than the Load Date. This check needs to be implemented.

Example: If load date is 20260401 and date in DCT is 20250401, then the Validation Check should fail this record.  
ZCALCMETHCalculation Period: Start Inclusive vs. End InclusiveSame as Target Design
This is a Optional Field

This field defines if the Start Date is to be made inclusive in the calculation of Interest
WGSCHFTTransaction CurrencySame as Target Design
This is a Required Field

This data will be captured by business. It is the Currency of the Fixed Deposit.

Currency Codes are ISO standards hence it will be same in all Treasury systems. Still a Validation check is needed in Syniti to check if a valid Currency Code is used in the DCT.

Drop Down value from table "TCURC"
LIMIT_DATEFTR Assignment Management: Limit DateSame as Target Design
This is a Required field

This field defines from when the Facility Limit is applicable from.
LIMIT_CHG_AMOUNTFTR Assignment Management: Drawing AmountSame as Target Design
This is a Required field

This field defines what is value of the facility.
LIMIT_CURRENCYFTR Assignment Management: Limit CurrencySame as Target Design
This is a Required field

This field defines what is the currency of the facility
LIMIT_POS_AMOUNTFTR Assignment Management: Drawing Amount (BAPI)Same as Target Design
This is a Required field

This field defines what amount of the facility is available to be drawn.
SRHYTHMFrequencySame as Target Design
This is a Optional field

This field defines the Frequency on which Interest is to be paid

There is a domain value range for this field which needs to be given to business which they extract and prepare this DCT.

For Eg. Monthly or Quarterly.

Drop Down Value as per the "Frequency Category" table provided Above.
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 FrequencySame as Target Design
This is a Optional field

This field defines the number of days or months when Interest needs to be paid
PKONDPercentage rate for condition itemsSame as Target Design
This is a Optional Field

This field defines the  Interest Rate if applicable to the deal.
ZCALCMETHCalculation method for first period of condition itemSame as Target Design
This is a Optional field

This field defines what is the calculation method of first period of Interest.

Drop Down Value from the table "Update Rule"
ZCALCENDCalculation method for last period of condition itemSame as Target Design
This is a Optional field

This field defines what is the calculation method of Last period of Interest.

Drop Down Value from the table "Update Rule"
ZINTCALCMETInterest Calculation MethodSame as Target Design
This is a Optional field

This is the Interest Calculation Method for Day Counting of Interest and needs to be provided by business.

There is a domain value range for this field which needs to be given to business which they extract and prepare this DCT.

For Eg. ACT/360 in SAP means 2.

Drop Down Value as per the "Interest Calculation Methods" table provided Above.
SKALIDWTInterest CalendarSame as Target Design
This is a Optional field

This defines Calendar to be considered to check if the Payment date is a holiday. Calendars are another configuration item and a list needs to be provided to business to populate the DCT.

A Pre Validation check is needed if the calendar is valid in the DCT.

Drop Down Values from table "TFACD - IDENT"
ZUPDATERULEUpdate for Calculation/Due Date for InterestSame as Target Design
This is a Optional field

This field defines the update rule for Calculation Date and Due Date.

Drop Down Values from table "Update Rules"
DVALUTCalculation DateSame as Target Design
This is a Optional field

Date format is YYYYMMDD. Calculation Date will always be GREATER Than or Equal to Load Date. This check needs to be implemented as part of Preload Validation.

Example: If load date is 20260401 and date in DCT is 20260501, then the Validation Check should fail this record.  
ZINCLINDInclusive Indicator for Calculation DateSame as Target Design
This is a Optional field

This field defines if calculation period is to be shiftred to Start Inclusive or End Enclusive

Drop Down Value is "X"
ZMENDINDIMonth-End Indicator for Calculation DateSame as Target Design
This is a Optional field

This field defines if Calculation Date is to be shifted to nearest Month End

Drop Down Value is "X"
SVWERKWorking Day Shift for Calculation DaySame as Target Design
This is a Optional field

This field defines the how the Working Day needs to be calculated, for eg. If the interest payment date is a holiday then it should shift it to the Next working date.

Default Value "1"
DFAELLDue dateSame as Target Design
This is a Optional field

This field defines if calculation Date is to be shiftred to Start Inclusive or End Enclusive

Drop Down Value is "X"
ZMENDINDIRMonth-End Indicator for Due DateSame as Target Design
This is a Optional field

This field defines if calculation period is to be shiftred to Start Inclusive or End Enclusive

Drop Down Value is "X"
SFWERKWorking Day Shift for Due DateSame as Target Design
This is a Optional field

This field defines the how the Working Day needs to be calculated, for eg. If the interest payment date is a holiday then it should shift it to the Next working date.

Default Value "1"
ZDUEDATEINDIShift Due Date Back to End of TermSame as Target Design
This is a Optional field

This field defines if the due date is to be shifted to the end date of the deal.

Drop Down Value for this is "X"

Extraction Dependencies

For object 9113 - Facilities there will be no extraction dependencies since the data is captured as part of the DCT from Quantum System. 

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

Source systemSource TableSource FieldSource DescriptionTarget SystemTarget TableTarget FieldTarget DescriptionTransformation Logic
NANANACONSTRUCTS4HANAUtility Table
(VTBFHA)
ZSTDTINCLCalculation Period: Start Inclusive vs. End InclusiveFrom DCT Field Calculation Period: Start Inclusive vs. End Inclusive
NANANACONSTRUCTS4HANAUtility Table
(VTBFHA)
ZCALCMETHCalculation method for first period of condition itemFrom DCT Field Calculation method for first period of condition item
NANANACONSTRUCTS4HANAUtility Table
(VTBFHA)
ZCALCENDCalculation method for last period of condition itemFrom DCT Field Calculation method for last period of condition item
NANANACONSTRUCTS4HANAUtility Table
(VTBFHA)
ZINTCALCMETInterest Calculation MethodFrom DCT Field Interest Calculation Method
NANANACONSTRUCTS4HANAUtility Table
(VTBFHA)
ZUPDATERULEUpdate for Calculation/Due Date for InterestFrom DCT Field Update for Calculation/Due Date for Interest
NANANACONSTRUCTS4HANAUtility Table
(VTBFHA)
ZINCLINDInclusive Indicator for Calculation DateFrom DCT Field Inclusive Indicator for Calculation Date
NANANACONSTRUCTS4HANAUtility Table
(VTBFHA)
ZMENDINDIMonth-End Indicator for Calculation DateFrom DCT Field Month-End Indicator for Calculation Date
NANANACONSTRUCTS4HANAUtility Table
(VTBFHA)
ZMENDINDIRMonth-End Indicator for Due DateFrom DCT Field Month-End Indicator for Due Date
NANANACONSTRUCTS4HANAUtility Table
(VTBFHA)
ZDUEDATEINDIShift Due Date Back to End of TermFrom DCT Field Shift Due Date Back to End of Term
NANANACONSTRUCTS4HANAVTBFHABUKRSCOMPANY_CODEFrom DCT Field BUKRS
NANANACONSTRUCTS4HANAVTBFHARFHATRANSACTION NUMBERInternal Field generated by SAP. 
Note Copy field MERKM field in DCT to ZLEGACYRFHA
NANANACONSTRUCTS4HANAVTBFHASGSARTPRODUCT_TYPEFrom DCT Field SGSART
NANANACONSTRUCTS4HANAVTBFHASFHAARTTRANSACTION_TYPEFrom DCT Field SFHAART
NANANACONSTRUCTS4HANAVTBFHAKONTRHPARTNERFrom DCT field "KONTRH"

Step 1 - Compare the BP Number in the DCT with BP XREFF - BPEXT field

Step 2 - Find the BP Number for the match BP XREFF - PARTNER Field

Step 3 - Pass the BP Number fetched from BP XREFF in table BUT100 to check if Role "TR0151" is assigned to the BP

Step 4 - If the condition matches, then replace the BP Number in the DCT field VTBFHA - KONTRH
NANANACONSTRUCTS4HANAVTBFHADBLFZCONTRACT_DATEFrom DCT Field DBLFZ
NANANACONSTRUCTS4HANAVTBFHARPORTBPORTFOLIOFrom DCT Field RPORTB
NANANACONSTRUCTS4HANAVTBFHAZUONDASSIGNMENTFrom DCT Field ZUOND
NANANACONSTRUCTS4HANAVTBFHAREFERINTERNAL_REFERENCEFrom DCT Field REFER
NANANACONSTRUCTS4HANAVTBFHAMERKMCHARACTERISTICSFrom DCT Field MERKM
NANANACONSTRUCTS4HANAVTBFHATPM_COM_VAL_CLASSVALUATION_CLASSFrom DCT Field TPM_COM_VAL_CLASS
NANANACONSTRUCTS4HANAVTBFHADBLFZTerm StartFrom DCT Field DBLFZ
NANANACONSTRUCTS4HANAVTBFHADELFZTerm EndFrom DCT Field DELFZ
NANANACONSTRUCTS4HANAVTBFHAWGSCHFTTransaction CurrencyFrom DCT Field WGSCHFT
NANANACONSTRUCTS4HANAVTB_ASGN_LIMITBUKRSCOMPANY_CODEFrom DCT Field BUKRS
NANANACONSTRUCTS4HANAVTB_ASGN_LIMITRFHATRANSACTION NUMBERInternal Field generated by SAP. 
Note Copy field MERKM field in DCT to ZLEGACYRFHA
NANANACONSTRUCTS4HANAVTB_ASGN_LIMITRELAT_OBJFTR Assignment Management: Assignment Object

Internal Field generated by SAP.


Use Internally generated Sequential Number

NANANACONSTRUCTS4HANAVTB_ASGN_LIMITRELAT_OBJ_CATFTR Assignment Management: Category of Assignment Object

Internal Field generated by SAP.


Use Internally generated Sequential Number

NANANACONSTRUCTS4HANAVTB_ASGN_LIMITLIMIT_DATEFTR Assignment Management: Limit DateFrom DCT Field LIMIT_DATE
NANANACONSTRUCTS4HANAVTB_ASGN_LIMITLIMIT_CHG_AMOUNTFTR Assignment Management: Drawing AmountFrom DCT Field LIMIT_CHG_AMOUNT
NANANACONSTRUCTS4HANAVTB_ASGN_LIMITLIMIT_CURRENCYFTR Assignment Management: Limit CurrencyFrom DCT Field LIMIT_CURRENCY
NANANACONSTRUCTS4HANAVTB_ASGN_LIMITLIMIT_POS_AMOUNTFTR Assignment Management: Drawing Amount (BAPI)From DCT Field LIMIT_POS_AMOUNT
NANANACONSTRUCTS4HANAVTBFHAPOBUKRSCOMPANY_CODEFrom DCT Field BUKRS
NANANACONSTRUCTS4HANAVTBFHAPORFHATRANSACTION NUMBERInternal Field generated by SAP. 
Note Copy field MERKM field in DCT to ZLEGACYRFHA
NANANACONSTRUCTS4HANAVTBFHAPORFHAZUTransaction Activity

Internal Field generated by SAP.


Use Internally generated Sequential Number

NANANACONSTRUCTS4HANAVTBFHAPODCRDATENTERED ON

Internal Field generated by SAP.


Use System Date while you generate your report

NANANACONSTRUCTS4HANAVTBFHAPOTCRTIMENTRY TIME

Internal Field generated by SAP


Use System Time when you generate your report.

NANANACONSTRUCTS4HANAVTBFHAPORFHAZBTRANSACTION FLOW

Internal Field generated by SAP.


Use Internally generated Sequential Number

NANANACONSTRUCTS4HANAVTBFHAPOPKONDPercentage rate for condition itemsFrom DCT Field PKOND
NANANACONSTRUCTS4HANAVTBFHAPOSKALIDWTInterest CalendarFrom DCT Field SKALIDWT
NANANACONSTRUCTS4HANAVTBFHAPODVALUTCalculation DateFrom DCT Field DVALUT
NANANACONSTRUCTS4HANAVTBFHAZUBUKRSCOMPANY_CODEFrom DCT Field BUKRS
NANANACONSTRUCTS4HANAVTBFHAZURFHATRANSACTION NUMBERInternal Field generated by SAP. 
Note Copy field MERKM field in DCT to ZLEGACYRFHA
NANANACONSTRUCTS4HANAVTBFHAZURFHAZUTRANSACTION ACTIVITY

Internal Field generated by SAP.


Use Internally generated Sequential Number

NANANACONSTRUCTS4HANAVTBFHAZUNORDEXTEXTERNAL_REFERENCEFrom DCT Field NORDEXT
NANANACONSTRUCTS4HANAVTBFINKOBUKRSCOMPANY_CODEFrom DCT Field BUKRS
NANANACONSTRUCTS4HANAVTBFINKORFHATRANSACTION NUMBERInternal Field generated by SAP. 
Note Copy field MERKM field in DCT to ZLEGACYRFHA
NANANACONSTRUCTS4HANAVTBFINKORGATTCLASS

Internal Field generated by SAP


Use System Time when you generate your report.

NANANACONSTRUCTS4HANAVTBFINKORFHAZUTransaction Activity

Internal Field generated by SAP


Use System Time when you generate your report.

NANANACONSTRUCTS4HANAVTBFINKORKONDGRDIRECTION OF TRANSACTION

Internal Field generated by SAP


Use System Time when you generate your report.

NANANACONSTRUCTS4HANAVTBFINKORKONDCONDITION

Internal Field generated by SAP


Use System Time when you generate your report.

NANANACONSTRUCTS4HANAVTBFINKODGUEL_KPCONDITION ITEM EFFECTIVE FROM

Internal Field generated by SAP.


Use System Date while you generate your report

NANANACONSTRUCTS4HANAVTBFINKONSTUFELEVEL NUMBER OF CONDITION ITEMS FOR RECURRING PAYMENT

Internal Field generated by SAP


Use System Time when you generate your report.

NANANACONSTRUCTS4HANAVTBFINKOSRHYTHMFrequencyFrom DCT Field SRHYTHM
NANANACONSTRUCTS4HANAVTBFINKOAMMRHY OR ATTRHYUnit for FrequencyFrom DCT Field AMMRHY OR ATTRHY
NANANACONSTRUCTS4HANAVTBFINKOSVWERKWorking Day Shift for Calculation DayFrom DCT Field SVWERK
NANANACONSTRUCTS4HANAVTBFINKODFAELLDue dateFrom DCT Field DFAELL
NANANACONSTRUCTS4HANAVTBFINKOSFWERKWorking Day Shift for Due DateFrom DCT Field SFWERK



Transformation Mapping


Mapping Table NameMapping 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 DescriptionTeam 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

TaskAction

Generation of
Pre-load reports

 Mandatory field check.

  • Company Code for which deal is created is part of the scope
  • The business partner is in the Counterparty role
  • Product Type, Transaction Type, Portfolio Code and General Valuation Class is matching the configuration check tables
  • The validity end date of the deal in the Pre-load file is not prior to cutover/go-live date
  • All other fields marked as Mandatory are not kept blank in the DCT File

Record Count

Record Count

Confirm the record counts in preload summary report

  • Total Records: 
    • Valid Records:
    • Invalid Records

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

TaskAction

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. 

  • Company Code, Product Type, Transaction Type, Portfolio Code and GVC in the DCT is matching with the Check Tables provided
  • Custom Table checks for Interest Calculation Method and Frequency are matched

Business Value Checks

All dates, Amount and Interest Rate for the Fixed Deposits are accurately populated in the deal as per DCT.

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

TaskAction

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.

Key Fields Check

Business to check some key fields such as validity end date, Start an End Date, Amount, Interest Rate, etc., are correctly populated against the DCT


Accuracy

TaskAction

Conversion accuracy

To check and validate the load files with all the transformation and mapping rules, to be signed off.


Load


For loading Facilities, SAP has provided a standard BAPI which will have all the necessary fields for successful creation of Facilities. The said BAPI has various Sub-Sections which will form a Load Template and a mapping rule between the DCT and BAPI load format. 

BAPI Name : BAPI_FTR_FAC_DEALCREATE


Target BAPITarget FieldTarget DescriptionTransformation Logic
BAPI_FTR_FAC_DEALCREATEBUKRSCOMPANY_CODEFrom DCT field "BUKRS”
BAPI_FTR_FAC_DEALCREATEVVSARTPRODUCT_TYPEFrom DCT field "SGSART"
BAPI_FTR_FAC_DEALCREATETB_SFHAARTTRANSACTION_TYPEFrom DCT field "SFHAART"
BAPI_FTR_FAC_DEALCREATETB_KUNNR_NEWPARTNERFrom DCT field "KONTRH"
BAPI_FTR_FAC_DEALCREATETB_DVTRABCONTRACT_DATEFrom DCT field "DBLFZ"
BAPI_FTR_FAC_DEALCREATETB_TVTRABCONTRACT_TIMESystem Time at the time of Data Load
BAPI_FTR_FAC_DEALCREATERPORTBPORTFOLIOFrom DCT field "RPORTB"
BAPI_FTR_FAC_DEALCREATETB_ZUONDASSIGNMENTFrom DCT field "ZUOND"
BAPI_FTR_FAC_DEALCREATETB_NORDEXTEXTERNAL_REFERENCEFrom DCT field "NORDEXT"
BAPI_FTR_FAC_DEALCREATETB_REFERINTERNAL_REFERENCEFrom DCT field "REFER"
BAPI_FTR_FAC_DEALCREATETB_MERKMCHARACTERISTICSFrom DCT field "MERKM"
BAPI_FTR_FAC_DEALCREATETB_DCRDATENTRY_DATEDate on which the data is getting loaded.
BAPI_FTR_FAC_DEALCREATETPM_COM_VAL_CLASSVALUATION_CLASSFrom DCT field "TPM_COM_VAL_CLASS”
BAPI_FTR_FAC_DEALCREATESTART_TERMTerm StartFrom DCT Field DBLFZ
BAPI_FTR_FAC_DEALCREATEEND_TERMTerm EndFrom DCT Field DELFZ
BAPI_FTR_FAC_DEALCREATESTART_INCLUSIVECalculation Period: Start Inclusive vs. End InclusiveFrom DCT Field Calculation Period: Start Inclusive vs. End Inclusive
BAPI_FTR_FAC_DEALCREATECURRENCYTransaction CurrencyFrom DCT Field WGSCHFT
BAPI_FTR_FAC_DEALCREATEFREQUENCYFrequencyFrom DCT Field SRHYTHM
BAPI_FTR_FAC_DEALCREATEFREQUENCY_UNITUnit for FrequencyFrom DCT Field AMMRHY OR ATTRHY
BAPI_FTR_FAC_DEALCREATEPERCENTAGE_RATEPercentage rate for condition itemsFrom DCT Field PKOND
BAPI_FTR_FAC_DEALCREATECALC_1ST_PERIODCalculation method for first period of condition itemFrom DCT Field Calculation method for first period of condition item
BAPI_FTR_FAC_DEALCREATECALC_LST_PERIODCalculation method for last period of condition itemFrom DCT Field Calculation method for last period of condition item
BAPI_FTR_FAC_DEALCREATECALC_METHODInterest Calculation MethodFrom DCT Field Interest Calculation Method
BAPI_FTR_FAC_DEALCREATECALC_CALENDARInterest CalendarFrom DCT Field SKALIDWT
BAPI_FTR_FAC_DEALCREATEDATE_UPDATE_RULEUpdate for Calculation/Due Date for InterestFrom DCT Field Update for Calculation/Due Date for Interest
BAPI_FTR_FAC_DEALCREATECALC_DATECalculation DateFrom DCT Field DVALUT
BAPI_FTR_FAC_DEALCREATECALC_DATE_INCLUSIVEInclusive Indicator for Calculation DateFrom DCT Field Inclusive Indicator for Calculation Date
BAPI_FTR_FAC_DEALCREATECALC_DATE_MONTH_ENDMonth-End Indicator for Calculation DateFrom DCT Field Month-End Indicator for Calculation Date
BAPI_FTR_FAC_DEALCREATECALC_DATE_WKDAY_SHIFTWorking Day Shift for Calculation DayFrom DCT Field SVWERK
BAPI_FTR_FAC_DEALCREATEDUE_DATEDue dateFrom DCT Field DFAELL
BAPI_FTR_FAC_DEALCREATEDUE_DATE_MONTH_ENDMonth-End Indicator for Due DateFrom DCT Field Month-End Indicator for Due Date
BAPI_FTR_FAC_DEALCREATEDUE_DATE_WKDAY_SHIFTWorking Day Shift for Due DateFrom DCT Field SFWERK
BAPI_FTR_FAC_DEALCREATESHIFT_DUE_DATE_TO_ENDShift Due Date Back to End of TermFrom DCT Field Shift Due Date Back to End of Term
BAPI_FTR_FAC_DEALCREATEVALID_FROMFTR Assignment Management: Limit DateFrom DCT Field LIMIT_DATE
BAPI_FTR_FAC_DEALCREATEAMOUNTFTR Assignment Management: Drawing AmountFrom DCT Field LIMIT_CHG_AMOUNT
BAPI_FTR_FAC_DEALCREATECURRENCYFTR Assignment Management: Limit CurrencyFrom DCT Field LIMIT_CURRENCY
BAPI_FTR_FAC_DEALCREATEAMOUNT_NEWFTR Assignment Management: Drawing Amount (BAPI)From DCT Field LIMIT_POS_AMOUNT


This BAPI has a simulation run provision. As part of the Pre-Load check when all the Syniti ADMM checks are performed, before making the production run of all the Interest Rate Instruments, a simulation run should be performed and all the standard BAPI errors needs to be documented.

A custom report, if required needs to be created for this. The report needs to have row reference and display the standard BAPI return messages successful as well as failed. This will make sure all the Interest Rate Instruments successfully pass all checks.

Note: It is also assumed that the DCT will not bring in Payment Details of Interest Rate Instruments. This information will be loaded as part of CNV 3040 – Business Partner Counterparty. Under this CNV, Payment SI details are created and assigned to this instrument. If this is done, once the BAPI is executed, it will automatically get assigned to the deal as part of Standard BAPI processing. A Data Pre-Validation check has been introduced for this step.


 The load process includes:

  1. Execute the automated data load into target system using "BAPI_FTR_IRATE_CREATE" and use the DCT File vs structure section of this document to populate the BAPI details.  
  2. 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 DescriptionTeam 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_EDIT or check in the tables - VTBFHA, VTBFHAZU or VTBFHAPO

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 9116-Treasury Interest Rate Instruments is Pre-Cutover Phase 3

Configuration

List the Configurations required before loading can commence

Item #Configuration Item

01

Company Codes relevant for Treasury- Field BUKRS (Check Table: T001)

02

Treasury Business Partners - BUT100

03

House Bank Ids- Field HKTID (Check Table: T012K)

04

Payment Methods- Field ZLSCH (Check Table: T042Z)

05

Contract Type - Field RANTYP  

06

Product Category- Field SANLF (Check Table: TZAF)

07

Product Type- Field SGSART (Check Table: TZPA)

08

Financial Transaction Types- Field SFHAART (Check Table: AT10)

09

Portfolio Code - Check Table: TWPOB 

10

General Valuation Class - Check Table: TRGC_COM_VALCL

Conversion Objects

Object #Preceding Object Conversion Approach

CNV-3007

Business Partner - General Role

CNV-1083

Bank Master

CNV-3040

Business Partner - Treasury

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

Valid Master 

Business Partner is not having a valid treasury role i.e. TR0151

Ensure that Business Partner is updated with correct role

Invalid Company Code

Company Code in the DCT is invalid based on the check table T001

Ensure correct Company Code is supplied to the BAPI

Invalid Product Type

 Product Type in the DCT is invalid based on the check table TZPA

Ensure correct Product Type is supplied to the BAPI

Invalid Transaction Type

Transaction Type in the DCT is invalid based on the check table AT10

Ensure correct Transaction Type is supplied to the BAPI

Invalid Trader

 Trader in the DCT is invalid based on the check table TZDEA

Ensure correct Trader is supplied to the BAPI

Invalid Portfolio Code

Portfolio Code in the DCT is invalid based on the check table TWPOB

Ensure correct Portfolio Code is supplied to the BAPI

Invalid Interest Calculation Method

 Interest Calculation Method is invalid as per the Custom Check Table

Ensure correct Interest Calculation method is supplied to the BAPI

Invalid Frequency Category

Frequency Category is invalid as per the Custom Check Table

Ensure correct Frequency Category is supplied to the BAPI


Post-Load Validation

Project Team

The following post load validations will be done by Project Team

Completeness

TaskAction

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.

To check the records loaded, a variant will be created in standard SAP report "FTR_00". We can take a dump from this standard report to verify all the relevant information as part of the load.  


Accuracy

TaskAction

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

TaskAction

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 FTR_EDIT or FTR_00 to cross check the records created for Counterparties


Accuracy

TaskAction

Field Checks

Check key fields to ensure that Business Partner - Counterparty has been maintained with proper details such as 

  • Right Amount is loaded in the created deal
  • Correct Payment Details are loaded in the deal
  • Ensure Correct Interest Rate is loaded in the deal
  • Ensure correct Start and End Date are loaded in the created deal


Key Assumptions

  • Master Data Standard is up to date as on the date of documenting this conversion approach and data load.
  • All configuration items like Company Code, Product Type, Transaction Type, etc are approved by business and pre-configured before this data can be loaded
  • All Bank Account information is approved by business and loaded in the system. Same are also created as SI details in BP master and assigned to the correct Product Type/Transaction Type combination in the BP master as these will be auto loaded in the deal and will not be part of the DCT. 


Change log