| Status | |
|---|---|
| Owner | |
| Stakeholders | The business stakeholders involved in making, reviewing, and endorsing this decision. Type @ to mention people by name |
The purpose of this document is to define the conversion approach to create Default routes in S/4 HANA TM (Transportation management).
Default route defines the sequence of stops for a given source and destination combination, which can be locations or zones. For a given source and destination, SAP TM determines matching default routes and chooses the most specific one; a direct location match is more specific than a zone match. Default routes can be modified manually where the desired route is different to that proposed.
The data for default routes in S/4 would need to be constructed in data collection template (DCT).
The scope of this document covers the approach for creating Default routes in S/4HANA following the TM Default routes Master Data Design Standard. This includes:
The data from legacy system includes:
The data from legacy system excludes:
List of source systems and approximate number of records
| Source | Scope | Source Approx No. of Records | Target System | Target Approx No. of Records |
|---|---|---|---|---|
| DCT | Creation of TM Default routes | TBD | S/4 HANA (TM) | TBD |
Default route description will be made available in English.
Multi language is supported for default routes. Login via a different language will show the description displayed in the logon language if the language key is maintained.
Not Applicable.
Not Applicable.
Not Applicable.
If the data conversion involves third-party systems or external data sources, such as Icertis, describe any additional requirements related to data mapping, transformation logic, validation rules or security measures that must be followed.
The complete information of the key fields that hold the default route information follows the Master Data Standard document.
The technical design of the target for this conversion approach.
| Table | Field | Data Element | Field Description | Data Type | Length | Requirement | Notes |
|---|---|---|---|---|---|---|---|
| /SCMTMS/D_SCHROT | SCH_ID | SCH_ID | Default Route ID | CHAR | 40 | Mandatory | |
| /SCMTMS/D_SCHDSC | DESCRIPTION | DESCRIPTION | Default Route Description | CHAR | 40 | Mandatory | |
| /SCMTMS/D_SCHROT | SCH_CAT | SCH_CAT | Schedule Category | CHAR | 2 | Mandatory | Default to “D” |
| /SCMTMS/D_SCHROT | SCH_TYPE | SCH_TYPE | Default route type | CHAR | 4 | Mandatory | |
| /SCMTMS/D_SCHROT | DGO_INDICATOR | DGO_INDICATOR | Dangerous goods | CHAR | 1 | Optional | Values available are: '' Non-Dangerous Goods Only |
| /SCMTMS/D_SCHROT | VAL_FROM_DATE | VAL_FROM_DATE | Valid from date | NUM (DATE) | 15 | Mandatory | |
| /SCMTMS/D_SCHROT | VAL_TO_DATE | VAL_TO_DATE | Valid to date | NUM (DATE) | 15 | Mandatory | |
| /SCMTMS/D_SCHROT | TRANSP_DUR | TRANSP_DUR | Transportation Duration | NUM | 11 | Mandatory | |
| /SCMTMS/D_SCHROT | MOT | MOT | Transportation mode code | CHAR | 2 | Mandatory | Transportation Mode will be a default value which will appear based on the default route type. Values available are : 01 (Road) |
| /SCMTMS/D_SCHLOC | LOC_SEQ | LOC_SEQ | Sequence | NUM | 5 | Mandatory | |
| /SCMTMS/D_SCHLOC | LOC_ID | LOC_ID | Location | CHAR | 20 | Mandatory | |
| /SCMTMS/D_SCHLOC | LOC_TYPE | LOC_TYPE | Location Type | CHAR | 4 | Optional | |
| /SCMTMS/D_SCHLOC | MOT | MOT | Transportation Mode | CHAR | 2 | Mandatory | |
| /SCMTMS/D_SCHLOC | STAGE_TYPE | STAGE_TYPE | Stage Type | CHAR | 3 | Optional | Values: Precarriage (01) , Main carriage (02, Oncarriage(03) |
| /SCMTMS/D_SCHLOC | TSP | TSP | Carrier | CHAR | 16 | Mandatory | |
| /SCMTMS/D_SCHLOC | TRANSIT_TIME | TRANSIT_TIME | Transit Duration | NUM | 11 | Optional | |
| /SCMTMS/D_SCHLOC | STAY_TIME | STAY_TIME | Length of the stay | NUM | 11 | Optional | |
| /SCMTMS/D_SCHLOC | EXEC_ORG_ID | EXEC_ORG_ID | Planning and Execution Organization | NUM | 8 | Optional |
Default route data will be populated directly in the Data Collection Template (DCT).
If data cleansing is managed outside of the source system (e.g. Syniti Migrate, 3rd Party Vendor, DCT), the necessary documentation must be produced and appended to this deliverable for sign-off.
| ID | Criticality | Error Message/Report Description | Rule | Output | Source System |
|---|---|---|---|---|---|
The high-level process is represented by the diagram below:
Please note that the data may have to be loaded in multiple target systems (US instance, China instance and RoW).

The data does not exist (or cannot be converted from its current state). The data is manually collected by the business directly in Syniti Migrate. This is to be conducted using DCT (Data Collection Template) in Syniti Migrate.
The agreed Relevancy criteria is applied to the extracted records to identify the records that are applicable for the Target loads
| Req # | Requirement Description | Team Responsible |
|---|---|---|
| 1 | Data is populated in the DCT or uploaded from downloaded Excel template | Data owner (Business) |
| 2 | If the data is uploaded to DCT in bulk via excel template, any upload errors need to be reviewed and corrected | Data owner (Business), Syniti/ Data Team |
| 3 | The data which has passed validation checks in DCT will be used for transformation/further processing | Syniti |
| Selection Ref Screen | Parameter Name | Selection Type | Requirement | Value to be entered/set |
|---|---|---|---|---|
A Target Ready Data Collection Template will be created for the required data, except for fields that need transformation as per the defined transformation rules. It will follow the format required by the target S/4HANA Default route.
Please find below the DCT details (main DCT page and another page for non English descriptions).
<Object> DCT Rules
Please refer to the above Google sheet for the DCT rules.
| Field Name | Field Description | Rule |
|---|---|---|
Not applicable.
| Item # | Step Description | Team Responsible |
|---|---|---|
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 platform to make the data Target ready:
| Item # | Step Description | Team Responsible |
|---|---|---|
| 1 | Capture the data for Default route in DCT. Review and correct any errors if bulk uploading data via downloaded excel DCT template. | Business team |
| 2 | Ensure the mapping tables which are needed during transformation have been reviewed and signed off by business. | Business team, Data Team (SCM) |
| 3 | Obtain DCT Sign-off from Business | Data Team (SCM) |
| 4 | Generate Pre-Load reports | Data Team (Syniti) |
| 5 | Review and Validate Error and Preload Reports | Data Team (SCM) |
| 6 | Log errors as defects, if any and address resolutions. | Data Team (SCM) |
| 7 | Re-transform and re-validate the Pre-load reports if necessary. | Data Team (SCM), Data Team (Syniti) |
| 8 | Obtain preload validation sign-off from Business | Business + Functional (SCM) + Data Team (SCM) |
| 9 | Generate Load Files | Data Team (Syniti) |
Transformation Rules
Please check the attached file for the complete source-to-target field mapping, validation checks and proposed error messages. The validation checks list is not exhaustive and may change over time as the design and configuration of the system evolves.
| Rule # | Source system | Source Table | Source Field | Source Description | Target System | Target Table | Target Field | Target Description | Transformation Logic | Notes |
|---|---|---|---|---|---|---|---|---|---|---|
| 1053-001 | DCT | SAP S/4 HANA | /SCMTMS/D_SCHROT | SCH_ID | Default Route ID | Direct Mapping | Will be auto generated by SAP (the default route ID in DCT is for uniquely tracking the record however at the time of record creation in SAP, new number will be generated) | |||
| DCT | SAP S/4 HANA | /SCMTMS/D_SCHDSC | DESCRIPTION | Default Route Description | Direct Mapping | |||||
| DCT | SAP S/4 HANA | /SCMTMS/D_SCHDSC | LANGUAGE_CODE | Language Key | Direct Mapping | |||||
| DCT | SAP S/4 HANA | /SCMTMS/D_SCHROT | SCH_TYPE | Default route type | Direct Mapping | |||||
| DCT | SAP S/4 HANA | /SCMTMS/D_SCHROT | SCH_CAT | Schedule Category | Direct Mapping | |||||
| DCT | SAP S/4 HANA | /SCMTMS/D_SCHROT | DGO_INDICATOR | Dangerous goods | Direct Mapping | |||||
| DCT | SAP S/4 HANA | /SCMTMS/D_SCHROT | VAL_FROM_DATE | Valid from date | Direct Mapping | |||||
| DCT | SAP S/4 HANA | /SCMTMS/D_SCHROT | VAL_TO_DATE | Valid to date | Direct Mapping | Must be later than Valid From date. | ||||
| DCT | SAP S/4 HANA | /SCMTMS/D_SCHROT | TRANSP_DUR | Transportation Duration | For preload file - include all three DCT fields (days, hours and minutes) For load file - Combine the three DCT fields (days, hours and minutes) and store in one target field (hhmmss) | |||||
| DCT | SAP S/4 HANA | /SCMTMS/D_SCHROT | MOT | Transportation mode code | Direct Mapping | |||||
| DCT | SAP S/4 HANA | /SCMTMS/D_SCHLOC | LOC_SEQ | Sequence | Direct Mapping | |||||
| DCT | SAP S/4 HANA | /SCMTMS/D_SCHLOC | LOC_ID | Location | Direct Mapping | Location should exist in SAP. Default route must have at least two locations (item level data) | ||||
| DCT | SAP S/4 HANA | /SCMTMS/D_SCHLOC | LOC_TYPE | Location Type | Direct Mapping | |||||
| DCT | SAP S/4 HANA | /SCMTMS/D_SCHLOC | MOT | Transportation Mode | Direct Mapping | |||||
| DCT | SAP S/4 HANA | /SCMTMS/D_SCHLOC | STAGE_TYPE | Stage Type | Direct Mapping | |||||
| DCT | N/A | zLegacySys | Field to capture legacy source system | SAP S/4 HANA | N/A | zLegacySys | Carrier Source system | This will be used together with legacy vendor (carrier) in determining the new (S4) BP number | ||
| DCT | SAP S/4 HANA | /SCMTMS/D_SCHLOC | TSP | Carrier | Value mapping: Use the legacy to SAP vendor mapping table to determine the new (S4) BP number | Carrier (Business partner) should exist in SAP. | ||||
| DCT | SAP S/4 HANA | /SCMTMS/D_SCHLOC | TRANSIT_TIME | Transit Duration | For preload file - include all three DCT fields (days, hours and minutes) For load file - Combine the three DCT fields (days, hours and minutes) and store in one target field (hhmmss) | |||||
| DCT | SAP S/4 HANA | /SCMTMS/D_SCHLOC | STAY_TIME | Length of the stay | For preload file - include all three DCT fields (days, hours and minutes) For load file - Combine the three DCT fields (days, hours and minutes) and store in one target field (hhmmss) | |||||
| DCT | SAP S/4 HANA | /SCMTMS/D_SCHLOC | EXEC_ORG_ID | Planning and Execution Organization | Direct Mapping |
List of Custom Target Reports for this object is maintained here: Conversion Specification - Custom Reports Register.
| Field Name | Mapping Table Name | Mapping Table Description |
|---|---|---|
| TSP | Vendor Number | LIFNR: Old Vendor Code to New Vendor Code cross reference |
| Item # | Step Description | Team Responsible |
|---|---|---|
| 1 | Ensure DCT tables completeness | Data Team (SCM) |
| 2 | Value Mappings are according to the latest design | Functional Team (SCM) + Data Team (SCM) |
| 3 | SAP Transportation management configuration for default routes is complete | Functional Team (SCM) + Data Team (SCM) |
| 4 | Dependent Master Data records for Locations and Carriers (business partners) are loaded | Functional Team (SCM) + Data Team (SCM) |
| Task | Action |
|---|---|
| Check Values | Validate the pre-load data confirming the values are aligned with target system format |
| Validate template structure and required field population | Ensure mandatory fields like DESCRIPTION, SCH_TYPE, MOT, Locations (transportation stops), validity dates are filled |
| Verify Record Count | SCM Data Team to verify that the total number of relevant records from the DCT is equal to the total number of records in the Preload and Load Sheets. |
| Task | Action |
|---|---|
| Conversion Accuracy | SCM Data Team to verify that all fields below meet pass the checks:
|
| Perform format validation (date, currency, decimal separators) | Standardize format to match SAP accepted input (e.g., YYYYMMDD for dates) |
| Review Error Reports | 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. |
| Conduct dry runs using LTMC or BAPIs and review logs | Analyze load results and correct format or conversion errors |
| Task | Action |
|---|---|
| Verify Record Count | Business Data Owner/s to verify that the total number of relevant records from the the DCT is equal to the total number of records in the Preload validation file. |
| Task | Action |
|---|---|
| Conversion Accuracy | Business Data Owner/s to verify that all the data in the preload validation file is accurate as per endorsed transformation/mapping rules (and signed-off DCT data). Review error reports in tool for any mismatch or missing transformed values. |
The load process includes:
Function_Loader_Inlay program or Custom Migration Cockpit Object (LTMOM) will have to be used for automated load of default routes to SAP S/4 HANA TM. There is no standard object available in SAP Migration Cockpit for Default routes. The load file format can be finalized when development system is available.
BAPI: /SCMTMS/BAPI_SCHEDULE_SAVEMULT
| Item # | Step Description | Team Responsible |
|---|---|---|
| 1 | Ensure the load tools are transported into the correct system/instance. | Data Team (SCM) |
| 2 | Ensure Pre-load sign-offs are obtained. | Data Team (SCM) |
| 3 | Execute upload of Default routes using Function_Loader_Inlay program or Custom Migration Cockpit Object. | Data Team (SCM) |
| 4 | Validate few records loaded by accessing standard transactions from S/4HNA E.g. Fiori app 'Display Default Route'. | Data Team (SCM) |
| 5 | Generate the post load reports in tool. | Data Team (SCM), Data Team (Syniti) |
| 6 | Log errors as defects, if any and address resolutions. Close defects. | Data Team (SCM) |
| 7 | Resolve defects by reupload and re-generate post load reports if necessary. | Data Team (SCM), Data Team (Syniti) |
| 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 team |
| 9 | Repeat steps 5 to 7 if necessary. | Data Team (SCM), Data Team (Syniti) |
Load Phase and Dependencies
Default routes data will be loaded in the pre-cutover window.
List the Configurations required before loading can commence
| Item # | Configuration Item |
|---|---|
| 1 | SAP Transportation management configuration MOT (Table & field: TVTR-VKTRA) Stage types (Table & field: /SCMTMS/C_STGTY-STAGE_TYPE) Default route type (Table & field: /SCMTMS/C_SCHTY-TYPE (where CAT = D)) |
| 2 | T002 - Language Keys |
| 3 | Number range for default routes |
| Object # | Preceding Object Conversion Approach |
|---|---|
| 1051 | TM - Locations |
| 3016 | Business Partners - Transporters/Forwarders |
As part of the default routes data load to S/4HANA using the Syniti data migration tool, various data quality, configuration, and technical challenges may arise.
The following table outlines the most commonly observed error types during data load, and the corrective actions typically taken to resolve them. This helps ensure consistency in issue handling, improves traceability during cutover, and supports smooth end-to-end execution of the default routes load.
| Error Type | Error Description | Action Taken |
|---|---|---|
| Configuration | Invalid or missing MOT, Stage types, Default route type | Engage Functional team to expedite and fix the error in the system |
| Formatting Errors | One or more key fields (e.g., TSP) are incorrectly formatted | Ensure formatting is done correctly (e.g., leading zeros for TSP). (Leading zero requirement will be confirmed when loading tool is available/tested) |
| Authorization Errors | Lack of access to execute load in target client/system | Raised access request; obtained necessary authorizations |
| Transformation Miss | Required transformation logic not applied before load | Re-applied transformation rules and revalidated source-target mapping |
| Technical Load Failure | File not processed due to syntax/format error or system issue | Reviewed logs; regenerated file; re-executed load after resolving issue |
| Task | Action |
|---|---|
| Run Fiori app/tcode to check loaded data in SAP | Run Fiori app 'Display Default route' to check if data has been loaded |
| Compare uploaded data against source file values | Use Custom reconciliation tools e.g. SQL Server or Excel based comparison tools to validate the number of records loaded against the load file record volume |
| Check for load errors in load tool | Review custom load tool or Legacy Transfer Migration Cockpit LTMC logs for any failures |
| Task | Action |
|---|---|
| Compare uploaded data against source file values | Use automated postload validation report or standard reports from S/4 HANA to validate field by field value match across all loaded records |
| Task | Action |
|---|---|
| Verify Count | Download Postload validation reports from Syniti and verify that the record count loaded in the target S/4 HANA is the same count as of the endorsed load file. |
| Review loaded Default routes | Access the S/4HANA system (via Fiori app Display Default route) to view loaded default routes |
| Task | Action |
|---|---|
| Compare Against Approved Load File | Cross-check data in S/4HANA against the final business-approved load file used for migration |
| Validate Accuracy of Converted/Transformed Data | Review any transformed fields (e.g., business partner number) for correctness |
| Log and Report Discrepancies | Use provided discrepancy log format or defect management tool to report any findings |
Insert links and references to other documents which are relevant when trying to understand this decision and its implications. Other decisions are often impacted, so it's good to list them here with links. Attachments are also possible but dangerous as they are static documents and not updated by their authors.