Purpose

The purpose of this document is to define the conversion approach to create conversion for Object 1183 - Limits Master Data for Treasury related transactions 
in S/4 HANA.

The limits act as an amount against which checks are made to determine whether the limit has been exceeded. Each limit has a validity period.  A Limit is maintained for a limit type which may include combinations of Company Code, Product Group, Business Partner, Currency, Trader or Country.

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 1183- Limits Master, to be used in treasury module of S4HANA.

Key tables and fields: 

There are two tables involved in S4 with respect to the maintenance of the Limit Masters Data and these are:

• VTBLS - Limits - This is used for Mapping Logical - Physical Keys of Limit to a Business Partner, Company Code, Product Group
• VTBLV - Limits - This is used for maintaining the limit amounts in relevant currency

Table: VTBLS is the central table for defining Limit Structures in SAP S/4HANA Treasury and Risk Management (TRM). It maps logical limit definitions to physical keys and characteristics. The key fields of VTBLS are: 

• SLA – Defines the type of limit (e.g., counterparty, product group).
• RLV – Limit Record Number: Unique identifier for each limit record. This is also the field which links table VTBLS to table VTBLV
• BUKRS – Company Code: Organizational unit for financial accounting.
• PARTNR – Business Partner: The entity to which the limit applies.
• SLPG – Limit Product Group: Groups products under a common limit, example - Banks, Bonds, Derivatives, Foreign Exchange etc.
• RPORTB – Portfolio: A portfolio is an organizational element to group together various treasury transactions for reporting purposes.
• RDEALER – Trader: Trader ID of the in-house trader responsible for the transaction.
• WAERS – Currency: Currency in which the limit is defined.
• COUNTRY – Country:

Table: VTBLV is the table in SAP S/4HANA TRM that stores the actual limit values tied to each limit structure defined in VTBLS. It includes validity periods, amounts, currencies, and control parameters.

The key fields of VTBLV are: 

• SLA – Limit Type: Matches the type defined in VTBLS.
  
• RLV – Limit Record Number: Unique identifier for each limit record. Links to the corresponding record in VTBLS.
• DLVB – Valid From:  Date from which the limit is effective.
• DLVE - Valid To: Date on which validity of a limit ends.
• BLIMIT– Internal Limit Amount:  Internal threshold for exposure
• ELIMIT – External Limit Amount: External threshold for exposure
• WLIMIT – Currency: Currency in which the limit is maintained
• PROZLIMIT – Critical Limit Utilization- The threshold limit maintained as % for trigger of warnings  
• COMPERD – Max. Risk Commit Per.Mth: The maximum risk commitment period specifies the maximum risk commitment period in which a transaction is attributed to the limit.
• INFINITE – Do not check limit:If this indicator is set to "do not check", the limit is not checked against existing utilizations. A key consequence is that the system does not display amounts exceeding the limit in reports or in the results for the single transaction 
• EDLVE – Ext.Valid-To Date: External Validity End Date of Limit

The treasury function in legacy is carried out in the Quantum system and therefore for the conversion of this object, the data/details need to be sourced from Quantum and transformed as applicable for S4HANA in Syniti and load using a custom program using LSMW 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 - Limits Master from Legacy Source Systems (Quantum) into S/4HANA following the Master Data Design Standard - DD-FUN-050 Master Data Standard_1183 - Limits Master Data

The data from legacy system includes:

1. Active records for Limits which are still in use/valid and have validity date is > cutover date
2. Limit records pertain to active counterparties which will also be created as business partners with Treasury roles such as Counterparty, Issuer or Depository Bank in S4HANA

The data from legacy system excludes:

1. All limits records which have a validity date in the past and are not in use in any exposure

Additional Information

Multi-language Requirement

None

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:

1. Extraction of Limits record from source system i.e. Quantum is to be done manually.
2. Cleansing by business team to mark the limit records as blocked or completed, where applicable
3. The extracted records to be converted into a DCT and stored in the Syniti for Transformation
4. Below Value mapping tables to be created in Syniti:
   1. Counterparty to Business Partner 
   2. Source and target company code
5. Amount and date format from source system to align with S4HANA 
6. As the target structure in S4HANA involves two tables- VTBLS and VTBLV, therefore the load will file needs to have the linkage via Limit Type (Field: SLA) and Limit Number (Field: RLV) 

Target Design

The Target design of the object 1183 - Limits Master Data based on the MDS - DD-FUN-050 Master Data Standard_1183 - Limits Master Data is as below

<Note: The target design can change subject to business confirmation after 

The technical design of the target for this conversion approach. 

Table - VTBLV: Limits - Mapping/Logical Fields

Note: The fields marked as conditional are based on the field VTBLS=SLA (Limit Type) and accordingly can be either required or optional

Table - VTBLS: Limits 

Note: The fields marked as conditional are based on the field VTBLS=SLA (Limit Type) and accordingly can be either required or optional. The fields SLV and RLV are the link to table VTBLS.

Data Cleansing

For the purpose of the Object 1183- Limit Master Data, the data cleansing should happen in the source systems i.e. Quantum as per below cleansing activity. The business cleansing is expected to be done by the business.

1. Identify all in active records for Limits which are not valid and have validity date in the past
2. Identify all records which may still be having a validity date in the future but are against the counterparties which are nor relevant for migration

Exclude such records from the extraction from the Quantum and populate in the DCT

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 1183- Limit Master Data - 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 using LSMW, as LTMC for this object is not available as of now. As there are two tables involved, the custom program should handle provision of a system generated number for the Limit Number (Field: RLV) 

Data Privacy and Sensitivity

None

Extraction

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

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

Extraction Run Sheet

Selection Screen

Data Collection Template (DCT)

1183 - Limit Mater Data DCT Rules

Extraction Dependencies

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:

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

Transformation Rules

Transformation Mapping

Below value mapping tables should be constructed in Syniti 

Transformation Dependencies

Pre-Load Validation

Project Team

Completeness

Accuracy

Business

Completeness

Accuracy

Load

The load process includes:

1. 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 using LSMW, as LTMC for this object is not available as of now. 
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

Load Phase and Dependencies

The load phase for this object is ideally relevant for pre-cutover Phase 4

Configuration

Below configurations must exist to facilitate the conversion of this object.

Conversion Objects

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

Post-Load Validation

Project Team

Completeness

Accuracy

Business

Completeness

Accuracy

Key Assumptions

• Master Data Standard is up to date as on the date of documenting this conversion approach and data load.
• Object 1183 is in scope based on data design and any exception requested by business.
• Only the relevant limit master data will be extracted by business from Quantum and will be provided in the DCT 
• The load will be done via a custom program as LTMC for this object is not available as of now. 

See also

Change log