Status
Owner	BAJAJ-ext, Manoj
Stakeholders	PILLAY-ext, Lawrence

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:

Active records for Limits which are still in use/valid and have validity date is > cutover date
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:

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

List of source systems and approximate number of records <number of company codes to be confirmed>

Source	Scope	Source Approx No. of Records	Target System	Target Approx No. of Records
Quantum	Active and in use Limit Records	300	S4HANA	300

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:

Extraction of Limits record from source system i.e. Quantum is to be done manually.
Cleansing by business team to mark the limit records as blocked or completed, where applicable
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:
1. Counterparty to Business Partner
2. Source and target company code
Amount and date format from source system to align with S4HANA
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

Table	Field	Data Element	Field Description	Data Type	Length	Requirement
VTBLS	SLA	TB_SLA	Limit Type	CHAR	3	Mandatory
VTBLS	RLV	TB_RLV	Limit Record	NUMC	20	System Generated
VTBLS	BUKRS	BUKRS	Company Code	CHAR	4	Mandatory
VTBLS	PARTNR	BP_PARTNR_NEW	Business Partner	CHAR	10	Conditional
VTBLS	SLPG	TB_SLPG	Limit Product Group	CHAR	3	Conditional
VTBLS	RPORTB	RPORTB	Portfolio	CHAR	10	Conditional
VTBLS	RDEALER	RDEALER	Trader	CHAR	12	Conditional
VTBLS	WAERS	TB_WCHAR	Currency	CUKY	5	Conditional
VTBLS	COUNTRY	LAND1_GP	COUNTRY	CHAR	3	Conditional

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

Table	Field	Data Element	Field Description	Data Type	Length	Requirement
VTBLV	SLA	TB_SLA	Limit Type	CHAR	3	Mandatory
VTBLV	RLV	TB_RLV	Limit Record	NUMC	20	Mandatory
VTBLV	DLVB	TB_DLVB	Valid From	DATS	8	Mandatory
VTBLV	DLVE	TB_DLVE	Valid to	DATS	8	Mandatory
VTBLV	BLIMIT	TB_BLIMIT	Internal Limit Amount	CURR	17 2 decimals	Mandatory
VTBLV	ELIMIT	TB_ELIMIT	External Limit Amount	CURR	17 2 decimals	Mandatory
VTBLV	PROZLIMIT	TB_PROZLIMIT	Critical Limit Utilization	DEC	5 2 decimals	Mandatory
VTBLV	COMPERD	TB_COMPERD	Max. Risk Commit Per.Mth	NUMC	4	Mandatory
VTBLV	INFINITE	TB_LIMIT_INFINITE	Do not check limit	CHAR	1	Conditional
VTBLV	EDLVE	TB_EDLVE	Ext.Valid-To Date	DATS	8	Mandatory

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.

Identify all in active records for Limits which are not valid and have validity date in the past
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

ID	Criticality	Error Message/Report Description	Rule	Output	Source System
1	High	Validity date of the Limit	Check the valid to date is not lower than the cutover date	Show records in error	DCT
2	Medium	Business Partner not found	Check the Business Partner of source counterparty to the target BP (value mapping)	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 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:

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

Req #	Requirement Description	Team Responsible
01	Extract from table Quantum all valid and in use Limit Records and place them into a DCT format	Business

Selection Screen

Not applicable:

Data Collection Template (DCT)

Target Ready Data Collection Template will be created for1183- Limit Master Data with exception of some fields which require transformation as mentioned in the transformation rule.

1183 - Limit Mater Data DCT Rules

Field Name	Field Description	Rule
VTBLS-SLA	Limit Type	The limit type from allowed values as per configuration
VTBLS-RLV	Limit Record	Existing Limit number. in S4 the limit number will be auto generated by the system
VTBLS-BUKRS	Company Code	The company code/entity of the source. The value mapping of the source and target Company codes to be maintained separately
VTBLS-PARTNR	Business Partner	The counterparty number/code of the source. The value mapping of the source and target partners to be maintained separately
VTBLS-SLPG	Limit Product Group	Limit Product Group as per below configuration values: BA - Banks BND - Bond DE - Derivatives FX - Foreign Exchange MM - Money market MMF - Mutual Money Market Fund SH - Shareholding ST - Stock TF - Trade Finance
VTBLS-RPORTB	Portfolio	Portfolio as per the configuration list
VTBLS-RDEALER	Trader	Trader as per available value
VTBLS-WAERS	Currency	Currency key - 3 char ISO code
VTBLS-COUNTRY	Country	Country key - 2 char ISO Code
VTBLV-DLVB	Valid From	The valid from Date - Original date as per source
VTBLV-DLVE	Valid To	The valid to Date - Original date as per source
VTBLV-BLIMIT	Internal Limit Amount	Amount
VTBLV-ELIMIT	External Limit Amount	Amount
VTBLV-WLIMIT	Limit Currency	Amount
VTBLV-PROZLIMIT	Critical Limit Utilization	Percentage utilized as per source. If this is not available, then business to provide
VTBLV-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.
VTBLV-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 check. keep blank
VTBLV-EDLVE	Ext.Valid-To Date	Date

Extraction Dependencies

Item #	Step Description	Team Responsible
01	Any period / year end close activities have been fully completed	Business
02	Active limit records have been identified, and business cleansing has happened in Quantum	Business

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.
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
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 DCT 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	DCT	S4HANA	VTBLS	SLA	Limit Type	As per DCT
02	NA	NA	NA	DCT	S4HANA	VTBLS	RLV	Limit Record	System generated
03	NA	NA	NA	DCT	S4HANA	VTBLS	BUKRS	Company Code	From value mapping
04	NA	NA	NA	DCT	S4HANA	VTBLS	PARTNR	Business Partner	From value mapping
05	NA	NA	NA	DCT	S4HANA	VTBLS	SLPG	Limit Product Group	As per DCT
06	NA	NA	NA	DCT	S4HANA	VTBLS	RPORTB	Portfolio	As per DCT
07	NA	NA	NA	DCT	S4HANA	VTBLS	RDEALER	Trader	As per DCT
08	NA	NA	NA	DCT	S4HANA	VTBLS	WAERS	Currency	As per DCT
09	NA	NA	NA	DCT	S4HANA	VTBLS	COUNTRY	Country	As per DCT
10	NA	NA	NA	DCT	S4HANA	VTBLV	DLVB	Valid From	As per DCT
11	NA	NA	NA	DCT	S4HANA	VTBLV	DLVE	Valid to	As per DCT
12	NA	NA	NA	DCT	S4HANA	VTBLV	BLIMIT	Internal Limit Amount	As per DCT
13	NA	NA	NA	DCT	S4HANA	VTBLV	ELIMIT	External Limit Amount	As per DCT
14	NA	NA	NA	DCT	S4HANA	VTBLV	PROZLIMIT	Critical Limit Utilization	As per DCT
15	NA	NA	NA	DCT	S4HANA	VTBLV	COMPERD	Max. Risk Commit Per.Mth	As per DCT
16	NA	NA	NA	DCT	S4HANA	VTBLV	INFINITE	Do not check limit	leave blank
17	NA	NA	NA	DCT	S4HANA	VTBLV	EDLVE	Ext.Valid-To Date	As per DCT

Transformation Mapping

Below value mapping tables should be constructed in Syniti

Mapping Table Name	Mapping Table Description
Company Code	Mapping Table for Quantum company/entity code to S4HANA entity code
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
Pre-load reports

Mandatory field check.

Limit Master is having a valid limit type
Limit Master is having a valid start and end date
The end date is in the future
The company code assigned to limit master is as per scope
Limit is assigned to a valid business partner
Limit Master is assigned to a valid limit product group
The trader id in the Limit Master is from allowed values
The date fields are as per DD.MM.YYYY or DD/MM/YYYY format

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

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.
Mandatory field check.

Company Code is rightly picked up
Business Partner with treasury role is correctly picked up

Business Value Checks

The total values as per the DCT and pre-load value are matching for the fields containing the limit amounts

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 using LSMW, 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
1	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
2	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
3	Proceed with the full load if steps one and two were succeed else fix the issue with records	Data team
4	Validate few records loaded by accessing standard transactions from S/4HNA e.g. TBL3 or TBL1 to view limits.	Data team
5	Generate post load report if step 5 is validated	Data team
6	Log errors as defects, if any and address resolutions. Close defects.	Data team
7	Resolve defects by reupload and re-generate post load reports if necessary.	Data team
8	Business to validate the post load files as part of post-load validation, raise data defects or provide the post-load sign-off.	Business
9	Repeat steps 1 to 5 if necessary.	Data team

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.

Item #	Configuration Item
01	Company Codes relevant for Treasury
02	Limit Types
03	Limit Product Groups
04	Portfolio Types
05	Trader IDs

Conversion Objects

Object #

Preceding Object Conversion Approach

CNV-3040

BP with Treasury role

(note: the conversion object number will change as this is under Change Request)

CNV-1182

Trader Authorisations

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
Missing Trader Authorisation	Trader ID used for Limit Master is missing authorisation	Update the trader authorisations
Validity date	Validity date of the limit is in past	Check the Limit master and correct the dates

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 TBL3 or TBL1 to cross check the Limit Masters

Accuracy

Task

Action

Field Checks

Check the fields to ensure that Limit Masters against Limit Types have been properly maintained

Check the other key fields such as Portfolio, Trader IDs etc.

Value Check

Check the values

The limit amounts by the limit types are matching as per the pre-load files

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.

Purpose

Conversion Scope

Additional Information

Multi-language Requirement

Document Management

Special Requirements

Target Design

Data Cleansing

Conversion Process

Extraction

Extraction Run Sheet

Extraction Dependencies

Transformation

Transformation Run Sheet

Transformation Dependencies

Pre-Load Validation

Project Team

Completeness

Accuracy

Business

Completeness

Accuracy

Load

Load Run Sheet

Configuration

Conversion Objects

Error Handling

Post-Load Validation

Project Team

Completeness

Accuracy

Business

Completeness

Accuracy

Key Assumptions

See also

Change log