| Status |
| |
|---|---|---|
| Owner | ||
| Stakeholders |
Purpose
The purpose of this document is to define the conversion approach to create TM-Freight agreements in S/4 HANA TM (Transportation management).
Freight agreements serve as contracts with companies providing transportation services, as well as service providers for transportation related services. They contain links to charge sheets for rates and validity dates. The parties involved in the contract are the purchasing organisation and the carrier.
The Freight Agreement represents the actual contract with the carrier/Freight forwarder. The information is taken from Keelvar and then replicated manually in SAP TM. The Freight Agreement can have 1 to many Calculation Sheets, and each Calculation Sheet can have 1 to many Charge Types.
The data for freight agreements in S/4 would need to be constructed in data collection template (DCT).
Conversion Scope
The scope of this document covers the approach for creating Freight Agreements in S/4HANA following the TM-Freight Agreements Master Data Design Standard.
This includes:
- Capturing and using the Freight agreements data in data collection template (DCT).
- Applying transformation logic via Syniti to conform with the S/4 HANA data model.
- Loading the transformed data into SAP S/4 HANA while ensuring data integrity.
The data from legacy system includes:
- N/A (Manual data collection)
The data from legacy system excludes:
- N/A (Manual data collection)
| Source | Scope | Source Approx No. of Records | Target System | Target Approx No. of Records |
|---|---|---|---|---|
| DCT | Creation of TM Freight Agreements | TBD | S/4 HANA (TM) | TBD |
Additional Information
Multi-language Requirement
Not Applicable.
Document Management
Not Applicable.
Legal Requirement
Not Applicable.
Special Requirements
Not Applicable.
There are two key components i.e. Calculation sheet and Rate table which drive important functionality in Freight Agreement and they have to be created in DCT/SAP before they can be referenced in the Freight Agreement.
The below diagram shows the relationship between the different components (the data in the diagram is for illustration purposes).
DCT pages should be built for the following components as part of 9053 Freight Agreement object.
- Freight Agreement header and items
- Calculation sheet header and items (this gets referenced in the agreement line item)
- Rate table header and items (this gets referenced in the calculation sheet)
There should be at least one calculation sheet and one rate table in the Freight Agreement.
TM functional team have mentioned that they would create the structure for rate tables in SAP S/4 system as a design activity. These would then be used for uploading the relevant rate table data in SAP using the excel integration feature (to download template and upload the populated data). Data team would create the Freight Agreement and calculation sheet data in SAP as part of data load activities.
The DCT design for rate tables would need to be reviewed at a later stage to see if any adjustments are required for the DCT as a result of the above described approach.
TM and Procurement data owner (business) would need to collaborate closely on maintaining the correct Outline Agreement (Purchase Contract) in the Freight Agreement DCT.
Additional Information
Multi-language Requirement
Not Applicable.
Document Management
Not Applicable.
Legal Requirement
Not Applicable.
Special Requirements
Not Applicable.
Target Design
The complete information of the key fields that hold the Freight agreements 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_FAGROT | FAGRMNTID044 | FAGRMNTID044 | Agreement | CHAR | 20 | Required | Agreement Name assigned by system or manually |
| /SCMTMS/D_FAGROT | FAGTYPEID103 | FAGTYPEID103 | Agreement Type | CHAR | 4 | Required | |
| /SCMTMS/D_FAGRTT | MNEMONIC | MNEMONIC | Agreement Description | CHAR | 30 | Required | |
| /SCMTMS/D_FAGROT | TIMEZONE | TIMEZONE | Time Zone | CHAR | 6 | Required | |
| /SCMTMS/D_FAGROT | FAGUSAGEID105 | FAGUSAGEID105 | Agreement Usage | CHAR | 3 | Optional | Default to 2 |
| /SCMTMS/D_FAGROT | VALIDITY_START | VALIDITY_START | Start Date of Validity | NUM (DATE) | 8 | Required | |
| /SCMTMS/D_FAGROT | VALIDITY_END | VALIDITY_END | End Date of Validity | NUM (DATE) | 8 | Required | |
| /SCMTMS/D_FAGCTR | ORG_UNIT | ORG_UNIT | Purchasing Organization | CHAR | 8 | Required | |
| /SCMTMS/D_FAGPTY | PTYINTID_ID133_I | PTYINTID_ID133_I | Carrier | CHAR | 10 | Required | |
| /SCMTMS/D_FAGROT | DOC_CURRENCY | DOC_CURRENCY | Document Currency | CHAR | 5 | Required | |
| /SCMTMS/D_FAGROT | STATUS | STATUS | Agreement Status | CHAR | 2 | Required | |
| /SCMTMS/D_FAGROT | EXTERNAL_FA_ID | EXTERNAL_FA_ID | External Freight Agreement | CHAR | 35 | Optional | Conditional. Needed only if the freight agreement also exists in the external system. |
Target Design
The complete information of the key fields that hold the Freight agreements 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_FAGROT | FAGRMNTID044 | FAGRMNTID044 | Agreement | CHAR | 20 | Required | Agreement Name assigned by system or manually | ||||||||||||
| /SCMTMS/D_FAGROT | FAGTYPEID103ZOUTAGR FAGTYPEID103 | ZOUTAGR | Outline Agreement Type | CHAR | 420 | Required | ID of the contract negotiated by Procurement Team | ||||||||||||
| /SCMTMS/D_FAGRTTFAGITM | MNEMONIC | MNEMONIC | Agreement Description | CHAR | ITEM_NO | ITEM_NO | Item number | NUM | 1030 | Required | |||||||||
| /SCMTMS/D_FAGROTFAGITM | TIMEZONE | TIMEZONE | TCCS_ID | TCCS_ID | Calculation SheetTime Zone | CHAR | 6 | 20 | Optional | Conditional. Not necessary if Spot Tender. Required | |||||||||
| /SCMTMS/D_FAGROTFAGITM | FAGUSAGEID105MOT | FAGUSAGEID105 | MOT | Mode of TransportAgreement Usage | CHAR | 3 | Optional | Default to 2 | /SCMTMS/D_FAGROT | VALIDITY_START | VALIDITY_START | Start Date of Validity | NUM (DATE) | 8 | 2 | Optional | Conditional. Necessary only if the forwarder has several different services to offer and hence different pack of ratesRequired | ||
| /SCMTMS/D_FAGROTTCCSRT | VALIDITYTCCS_ENDID047VALIDITY | TCCS_END | End Date of Validity | NUM (DATE) | ID047 | Calculation Sheet | CHAR | 208 | Required | ||||||||||
| /SCMTMS/D_FAGCTRTCCSTX | ORG_UNIT | ORG_UNIT | DESCRIPTION | DESCRIPTION | DescriptionPurchasing Organization | CHAR | 875 | Required | |||||||||||
| /SCMTMS/D_FAGPTY | PTYINTID_ID133_I | PTYINTID_ID133_I | TCCSRT | TCUSAGECD085 | TCUSAGECD085 | Charge UsageCarrier | CHAR | 103 | Required | ||||||||||
| /SCMTMS/D_FAGROTTCCSRT | DOC_CURRENCY | DOC_CURRENCY | TIMEZONE | TIMEZONE | Time ZoneDocument Currency | CHAR | 56 | Required | |||||||||||
| /SCMTMS/D_FAGROTTCCSIT | STATUSLINENR | STATUS | Agreement Status | CHAR | LINENR | Line No. | NUM | 62 | Required | ||||||||||
| /SCMTMS/D_FAGROT | EXTERNAL_FA_ID | EXTERNAL_FA_ID | TCCSIT | TCET084 | TCET084 | Charge TypeExternal Freight Agreement | CHAR | 3515 | Optional | Conditional. Needed only if the freight agreement also exists in the external system. | Required | ||||||||
| /SCMTMS/D_FAGROTTCCSIT | ZOUTAGR CURRCODE016ZOUTAGR | CURRCODE016 | Outline AgreementCurrency | CHAR | 205 | Required | Optional | Conditional. Only used if manually input the amount.ID of the contract negotiated by Procurement Team | |||||||||||
| /SCMTMS/D_FAGITM | ITEM_NO | ITEM_NO | Item number | NUM | 10 | TCCSIT | UUID026 | UUID026 | Rate Table | CHAR | 16 | Optional | Conditional. Only used when charge type uses rate table to retrieve pricingRequired | ||||||
| /SCMTMS/D_FAGITMTCCSIT | TCCS_ID | TCCS_ID | Calculation Sheet | CHAR | AMOUNT | AMOUNT | Amount | NUM | 2820 | Optional | Conditional. Not necessary if Spot Tender. Only used for fix price rates. | ||||||||
| /SCMTMS/D_FAGITMTCCSIT | MOT | MOT | MANUAL_ENTRY | MANUAL_ENTRY | Manual Charge ItemMode of Transport | CHAR | 21 | Optional | Conditional. Necessary only if the forwarder has several different services to offer and hence different pack of ratesOnly used when charge type is considered manually-input. | ||||||||||
| /SCMTMS/D_TCCSRTTCRATE | TCCSRATE_ID047IDTCCS | RATE_ID047ID | Calculation SheetRate Table | CHAR | 20 | Required | |||||||||||||
| /SCMTMS/D_TCCSTXTCRTTX | DESCRIPTION | DESCRIPTION | Description | CHAR | 75 | Required | |||||||||||||
| /SCMTMS/D_TCCSRTTCRATE | TCUSAGECD085 | TCUSAGECD085 | Charge Usage | CHAR | 3 | Required | |||||||||||||
| /SCMTMS/D_TCCSRTTCRATE | TIMEZONE | TIMEZONE | Time Zone | CHAR | 6 | Required | |||||||||||||
| /SCMTMS/D_TCCSITTCRATE | LINENR | LINENR | Line No. | NUM | 6 | Required | RATE_SPLIT | RATE_SPLIT | Rate Validity Split | CHAR | 1 | /SCMTMS/D_TCCSIT | TCET084 | TCET084 | Charge Type | CHAR | 15 | Required | |
| /SCMTMS/D_TCCSITTCRATE | CURRCODE016 | CURRCODE016 | ARCHIVING_STATUS | ARCHIVING_STATUS | Archiving StatusCurrency | CHAR | 52 | Optional | Automatic | Not relevant for data collectionConditional. Only used if manually input the amount. | |||||||||
| /SCMTMS/D_TCCSIT | UUID026 | UUID026 | TCRATE | MULTI_CHRG_TYPE | MULTI_CHRG_TYPE | Multiple Charges Types AllowedRate Table | CHAR | 161 | Optional | Required | Rate Table can be used for one single charge type or many. This flag controls it. Conditional. Only used when charge type uses rate table to retrieve pricing | ||||||||
| /SCMTMS/D_TCCSITTCRATE | AMOUNTTCETAMOUNT | TCETAmount | Charge Type | NUMCHAR | 2815 | Optional | Conditional. Only used for fix price ratesif "Multiple Charge Types Allowed" is flagged. | ||||||||||||
| /SCMTMS/D_TCCSITTCRATE | MANUALVAL_ENTRYINDICATORMANUAL | VAL_ENTRYINDICATOR | Value TypeManual Charge Item | CHAR | 1 | Optional | Required | Absolute value or percentage values in Rate Table. Conditional. Only used when charge type is considered manually-input. | |||||||||||
| /SCMTMS/D_TCRATE | RATE_IDTAB_TYPE | RATE_TAB_IDTYPE | Rate Table Type | CHAR | 20 | 4 | Required | ||||||||||||
| /SCMTMS/D_TCRTSR | DIMENSION_INDX | DIMENSION_INDX | Scale No. | NUM | 2 | AutomaticRequired | |||||||||||||
| /SCMTMS/D_TCRTTX | DESCRIPTION | DESCRIPTION | TCRTSR | GLOBAL_SCALE_ID | GLOBAL_SCALE_ID | ScaleDescription | CHAR | 7520 | Required | Variable type within the rate table that help determine the proper value. | |||||||||
| /SCMTMS/D_TCRATETCRTSR | TCUSAGECD085 | TCUSAGECD085 | CALC_BASE | CALC_BASE | Calculation BaseCharge Usage | CHAR | 315 | Required | Variable base within the rate table that help determine the proper value. It has only one Scale. | ||||||||||
| /SCMTMS/D_TCRATE | TIMEZONE | TIMEZONE | Time Zone | CHAR | 6 | Required | /SCMTMS/D_TCRATETCRTSR | RATE_SPLIT | RATE_SPLIT | SCATYP | SCATYP | Scale TypeRate Validity Split | CHAR | 1 | Required | ||||
| /SCMTMS/D_TCRATETCRTSR | ARCHIVINGCURRENCY_STATUSRELARCHIVING | CURRENCY_STATUSREL | Scale Relevant for Currency MaintenanceArchiving Status | CHAR | 21 | Automatic | Required | Whether the scale used needs to have a specific currency out of the Header currency of the Rate TableNot relevant for data collection | |||||||||||
| /SCMTMS/D_TCRATETCRTSR | MULTIMINVAL_CHRG_TYPESUPPORTEDMULTI | MINVAL_CHRG_TYPESUPPORTED | Minimum ValueMultiple Charges Types Allowed | CHAR | 1 | Required | Optional | Conditional. Only for those cases where a minimum amount is to be paidRate Table can be used for one single charge type or many. This flag controls it. | |||||||||||
| /SCMTMS/D_TCRATETCRTSR | TCET | TCET | MAXVAL_SUPPORTED | MAXVAL_SUPPORTED | Maximum ValueCharge Type | CHAR | 151 | Optional | Conditional. Only used if "Multiple Charge Types Allowed" is flagged.for those cases where a maximum amount is to be paid | ||||||||||
| /SCMTMS/D_TCRATESCAH1 | VAL_INDICATOR | VAL_INDICATOR | SCALEBASE | SCALEBASE | Scale BaseValue Type | CHAR | 16 | Required | Absolute value or percentage values in Rate Table. | Automatic | Automatic. Set by the system once "Calculation Base" is selected. Not relevant for data collection | ||||||||
| /SCMTMS/D_TCRATESCAIT2 | RATECALC_TAB_TYPETYPRATE | CALC_TAB_TYPETYP | Calculation typeRate Table Type | CHAR | 41 | Required | |||||||||||||
| /SCMTMS/D_TCRTSRSCAIT2 | DIMENSION_INDX | UOM | UOMDIMENSION_INDX | Scale No. UoM | NUMCHAR | 23 | AutomaticRequired | ||||||||||||
| /SCMTMS/D_TCRTSRTCRTVP | GLOBALVALID_SCALESTART_IDDTGLOBAL | VALID_SCALESTART_ID | Scale | CHAR | 20 | Required | Variable type within the rate table that help determine the proper value. | DT | Valid-from date | NUM (DATE) | 8 | Required | |||||||
| /SCMTMS/D_TCRTSRTCRTVP | CALCVALID_END_BASEDTCALC | VALID_END_BASE | Calculation Base | CHAR | 15 | Required | DT | Valid-to date | NUM (DATE) | 8 | RequiredVariable base within the rate table that help determine the proper value. It has only one Scale. | ||||||||
| /SCMTMS/D_TCRTSRTCRTVP | SCATYPCURRENCYSCATYP | CURRENCY | Scale TypeCurrency | CHAR | 15 | Required | |||||||||||||
| /SCMTMS/D_TCRTSR | CURRENCY_REL | CURRENCY_REL | Scale Relevant for Currency Maintenance | CHAR | 1 | Required | Whether the scale used needs to have a specific currency out of the Header currency of the Rate Table | ||||||||||||
| /SCMTMS/D_TCRTSR | MINVAL_SUPPORTED | MINVAL_SUPPORTED | Minimum Value | CHAR | 1 | Optional | Conditional. Only for those cases where a minimum amount is to be paid | ||||||||||||
| /SCMTMS/D_TCRTSR | MAXVAL_SUPPORTED | MAXVAL_SUPPORTED | Maximum Value | CHAR | 1 | Optional | Conditional. Only for those cases where a maximum amount is to be paid | ||||||||||||
| /SCMTMS/D_SCAH1 | SCALEBASE | SCALEBASE | Scale Base | CHAR | 6 | Automatic | Automatic. Set by the system once "Calculation Base" is selected. Not relevant for data collection |
Data Cleansing
Freight agreements data will be populated directly in the Data Collection Template (DCT).
Conversion Process
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).
Data Privacy and Sensitivity
Data Cleansing
Freight agreements data will be populated directly in the Data Collection Template (DCT).
| ID | Criticality | Error Message/Report Description | Rule | Output | Source System |
|---|---|---|---|---|---|
Conversion Process
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).
Data Privacy and Sensitivity
Extraction
The data does not exist (or cannot be converted from its current state). The data is manually collected by the business directly in Syniti ADMM. This is to be conducted using DCT (Data Collection Template).
Extraction Run Sheet
| 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 Screen
| Selection Ref Screen | Parameter Name | Selection Type | Requirement | Value to be entered/set |
|---|---|---|---|---|
Data Collection Template (DCT)
Target Ready Data Collection Template will be created for TM Freight Agreement data with exception of some fields which require transformation as mentioned in the transformation rule.
Please refer to the below Google sheet for the DCT rules.
Google Drive Live Link url https://docs.google.com/spreadsheets/d/1ETDpLw-qR7PYyHLnRUrvg6BHVt7-CR_wQNm_TaLyU_0/edit?gid=0#gid=0
| Field Name | Field Description | Rule |
|---|---|---|
Extraction Dependencies
| Item # | Step Description | Team Responsible |
|---|---|---|
Transformation
The Target fields are mapped to the applicable Legacy field that will be its source, this is a 3-way activity involving the Business, Functional team and Data team. This identifies the transformation activity required to allow to make the data Target ready:
- Perform value mapping and data transformation rules.
- Legacy values are mapped to the to-be values (this could include a default value)
- Values are transformed according to the rules defined in
- 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 | Capture the data for Freight agreements 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.
Google Drive Live Link url https://docs.google.com/spreadsheets/d/1Y9LhL8SrtFXrJdQPOHYJ5tjRw-ofPMK_xiV0QcfSvE8/edit?gid=0#gid=0
| Rule # | Source system | Source Table | Source Field | Source Description | Target System | Target Table | Target Field | Target Description | Transformation Logic | Notes |
|---|---|---|---|---|---|---|---|---|---|---|
| DCT | SAP S/4 HANA | /SCMTMS/D_FAGROT | FAGRMNTID044 | Agreement | Direct Mapping | |||||
| DCT | SAP S/4 HANA | /SCMTMS/D_FAGROT | FAGTYPEID103 | Agreement Type | Direct Mapping | |||||
| DCT | SAP S/4 HANA | /SCMTMS/D_FAGRTT | MNEMONIC | Agreement Description | Direct Mapping | |||||
| DCT | SAP S/4 HANA | /SCMTMS/D_FAGROT | TIMEZONE | Time Zone | Direct Mapping | |||||
| DCT | SAP S/4 HANA | /SCMTMS/D_FAGROT | FAGUSAGEID105 | Agreement Usage | Default to 2 |
Extraction
The data does not exist (or cannot be converted from its current state). The data is manually collected by the business directly in Syniti ADMM. This is to be conducted using DCT (Data Collection Template).
Extraction Run Sheet
Selection Screen
Data Collection Template (DCT)
Target Ready Data Collection Template will be created for TM Freight Agreement data with exception of some fields which require transformation as mentioned in the transformation rule.
Please refer to the below Google sheet for the DCT rules.
Google Drive Live Link url https://docs.google.com/spreadsheets/d/1ETDpLw-qR7PYyHLnRUrvg6BHVt7-CR_wQNm_TaLyU_0/edit?gid=0#gid=0
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 to make the data Target ready:
- Perform value mapping and data transformation rules.
- Legacy values are mapped to the to-be values (this could include a default value)
- Values are transformed according to the rules defined in
- 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
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.
Google Drive Live Link url https://docs.google.com/spreadsheets/d/1Y9LhL8SrtFXrJdQPOHYJ5tjRw-ofPMK_xiV0QcfSvE8/edit?gid=0#gid=0
| Rule # | Source system | Source Table | Source Field | Source Description | Target System | Target Table | Target Field | Target Description | Transformation Logic | Notes||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| DCT | SAP S/4 HANA | /SCMTMS/D_FAGROT | FAGRMNTID044 | VALIDITY_START | Start Date of ValidityAgreement | Direct Mapping | |||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_FAGROT | FAGTYPEID103 | VALIDITY_END | End Date of ValidityAgreement Type | Direct Mapping | Must be later than Valid From date. | ||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_FAGRTT | MNEMONIC | Agreement Description | Direct Mapping | DCTFAGCTR | ORG_UNIT | Purchasing Organization | Direct Mapping | ||||||||
| DCT | N/A | zLegacySys | Field to capture legacy source system | SAP S/4 HANA | N/ | SCMTMS/D_FAGROTTIMEZONE | Time Zone | Direct MappingA | 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_FAGROT | FAGUSAGEID105 | Agreement Usage | Default to 2 | FAGPTY | PTYINTID_ID133_I | 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_FAGROT | VALIDITY_START | Start Date of Validity | Direct Mapping | DCT | SAP S/4 HANA | /SCMTMS/D_FAGROT | VALIDITYDOC_ENDCURRENCY | Document CurrencyEnd Date of Validity | Direct Mapping | ||||||
| Must be later than Valid From date. | DCT | SAP S/4 HANA | /SCMTMS/D_FAGCTRFAGROT | ORG_UNIT | Purchasing Organization | Direct Mapping | DCT | N/A | zLegacySys | STATUS | Agreement Status | Direct Mapping | |||||
| DCT | Field to capture legacy source systemSAP 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/SCMTMS/D_FAGROT | EXTERNAL_FA_ID | External Freight Agreement | Direct Mapping | |||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_FAGPTY | PTYINTID_ID133_I | FAGROT | ZOUTAGR | Outline AgreementCarrier | Value mapping: Use the legacy to SAP vendor mapping Purchase contract table to determine the new (S4) BP numberpurchase contract /Outline Agreement number | Outline Agreement/Purchase Contract Carrier (Business partner) should exist in SAP. | |||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_FAGROTFAGITM | DOCITEM_CURRENCYNO | Document CurrencyItem number | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_FAGROTFAGITM | STATUS | TCCS_ID | Calculation SheetAgreement Status | Direct Mapping | Calculation sheet has to exist in SAP before it can be referenced in the FA line item | ||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_FAGROTFAGITM | MOT | Mode of Transport | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCCSRT | TCCS_ID047 | Calculation Sheet | EXTERNAL_FA_ID | External Freight Agreement | Direct Mapping | ||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_FAGROTTCCSTX | ZOUTAGR DESCRIPTION | Outline AgreementDescription | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_FAGITMTCCSRT | ITEM_NO | TCUSAGECD085 | Charge UsageItem number | Direct Mapping | |||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_FAGITMTCCSRT | TCCS_ID | TIMEZONE | Time ZoneCalculation Sheet | Direct Mapping | Calculation sheet has to exist in SAP before it can be referenced in the FA line item | ||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_FAGITMTCCSIT | MOT | LINENR | Line No.Mode of Transport | Direct Mapping | |||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCCSRTTCCSIT | TCCS_ID047 | TCET084 | Charge TypeCalculation Sheet | Direct Mapping | |||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCCSTXTCCSIT | DESCRIPTIONCURRCODE016 | DescriptionCurrency | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCCSRTTCCSIT | TCUSAGECD085UUID026 | Charge UsageRate Table | Direct Mapping | Rate table has to exist in SAP before it can be referenced here | |||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCCSRTTCCSIT | TIMEZONEAMOUNT | Time ZoneAmount | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCCSIT | LINENR | MANUAL_ENTRY | Manual Charge ItemLine No. | Direct Mapping | |||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCCSITTCRATE | TCET084 | RATE_ID | Rate TableCharge Type | Direct Mapping | |||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCCSITTCRTTX | CURRCODE016DESCRIPTION | CurrencyDescription | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCCSIT | UUID026 | Rate Table | Direct Mapping | TCRATE | TCUSAGECD085 | Charge Usage | Direct MappingRate table has to exist in SAP before it can be referenced here | ||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCCSITTCRATE | AMOUNTTIMEZONE | AmountTime Zone | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCCSITTCRATE | MANUALRATE_ENTRYSPLIT | Rate Validity SplitManual Charge Item | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCRATE | RATEMULTI_CHRG_IDTYPE | Multiple Charges Types AllowedRate Table | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCRTTXTCRATE | DESCRIPTIONTCET | DescriptionCharge Type | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCRATE | TCUSAGECD085 | VAL_INDICATOR | Value TypeCharge Usage | Direct Mapping | |||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCRATE | TIMEZONE | RATE_TAB_TYPE | Rate Table TypeTime Zone | Direct Mapping | |||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCRATETCRTSR | RATEDIMENSION_SPLITINDX | Scale No. Rate Validity Split | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCRATETCRTSR | MULTIGLOBAL_CHRGSCALE_TYPEID | ScaleMultiple Charges Types Allowed | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCRATETCRTSR | TCET | CALC_BASE | Calculation BaseCharge Type | Direct Mapping | |||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCRATETCRTSR | VAL_INDICATORSCATYP | Value Scale Type | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCRATETCRTSR | RATECURRENCY_TAB_TYPEREL | Scale Relevant for Currency MaintenanceRate Table Type | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCRTSR | DIMENSIONMINVAL_INDXSUPPORTED | Minimum ValueScale No. | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCRTSR | GLOBALMAXVAL_SCALE_IDSUPPORTED | Maximum ValueScale | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCRTSRSCAIT2 | CALC_BASETYP | Calculation Basetype | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCRTSRSCAIT2 | SCATYPUOM | Scale TypeUoM | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCRTSRTCRTVP | CURRENCYVALID_START_RELDT | Valid-from dateScale Relevant for Currency Maintenance | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCRTSRTCRTVP | MINVALVALID_END_SUPPORTEDDT | Valid-to dateMinimum Value | Direct Mapping | ||||||||||||
| DCT | SAP S/4 HANA | /SCMTMS/D_TCRTSRTCRTVP | MAXVAL_SUPPORTED | CURRENCY | CurrencyMaximum Value | Direct Mapping |
List of Custom Target Reports for this object is maintained here: Conversion Specification - Custom Reports Register.
Transformation Mapping
| Field name | Mapping Table Name | Mapping Table Description |
|---|---|---|
| /SCMTMS/D_FAGPTY-PTYINTID_ID133_I | Vendor Number | LIFNR: Old Vendor Code to New Vendor Code cross reference |
| /SCMTMS/D_FAGROT-ZOUTAGR | Outline Agreement (Purchase Contract) | TBD |
Transformation Dependencies
List the steps that need to occur before transformation can commence| Item # | Step Description | Team Responsible |
|---|---|---|
| 1 | Dependent Master Data records for Carriers (business partnerspartners) and Outline Agreements (Purchase Contracts) are loaded | Functional Team (SCM) + Data Team (SCM) |
| 2 | Value Mappings are according to the latest design | Functional Team (SCM) + Data Team (SCM) |
| 3 | SAP Transportation management configuration for Freight agreements is complete | Functional Team (SCM) |
| 4 | Ensure DCT tables completeness | Data Team (SCM) |
Pre-Load Validation
Project Team
Completeness
| 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 Agreement Type, Means of Transport, Description, Purchasing Organization, Carrier, 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. |
Accuracy
| 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 |
Business
Completeness
| Task | Action |
|---|---|
| Provide relevant data | Business Data Owners to provide the required data in DCT which will be used in transportation planning and execution processes. |
| 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. |
Accuracy
| 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. |
Load
The load process includes:
- Execute the automated data load into target system using load tool or produce the load file if the load must be done manually
- 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_DCT, 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)
Custom load tool will need to be developed for loading rate table, calculation sheet and Freight Agreement data. There is no known standard SAP mass upload tool for Freight Agreement.
The load file format can be finalized when the load tool is developed.
Please refer to the below SAP community post for more information.
Load Run Sheet
| 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 Freight agreements using custom load program. | Data Team (SCM) |
| 4 | Validate few records loaded by accessing standard transactions from S/4HNA E.g. Fiori app 'Display Freight Agreement'. | 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
Freight agreements data will be loaded in the cutover window.
Configuration
| -load sign-off. | Business team | |
| 9 | Repeat steps 5 to 7 if necessary. | Data Team (SCM), Data Team (Syniti) |
Load Phase and Dependencies
Freight agreements data will be loaded in the cutover window.
Configuration
| Item # | Configuration Item |
|---|---|
| 1 | SAP Transportation management configuration
|
| 2 | SAP USER profile (SU3) Date and Decimal Notation Formats are in sync with the load format |
| 3 | Purchasing Organization configuration (Enterprise structure) |
| Item # | Configuration Item |
| 1 | SAP Transportation management configuration (TBC)
Conversion Objects
| Object # | Preceding Object Conversion Approach |
|---|---|
| 3016 | Business Partners - Transporters/Forwarders |
| 1051 | TM Location |
| 1052 | Transportation Zones |
| 1042 | Transportation Lanes |
| 9040 | Purchase Contracts |
Error Handling
As part of the Freight agreements 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 transportation lanes load.
| Error Type | Error Description | Action Taken |
|---|---|---|
| Configuration | Invalid or missing Means of TransportFreight agreement type (example) | Engage Functional team to expedite and fix the error in the system |
| Formatting Errors | One or more key fields (e.g., partner) are incorrectly formatted | Ensure formatting is done correctly (e.g., leading zeros for partner). (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 |
Post-Load Validation
Project Team
Completeness
| Task | Action |
|---|---|
| Run Fiori app/tcode to check loaded data in SAP | Run Fiori app 'Display Freight Agreement' 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 |
Accuracy
| 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 |
Business
Completeness
| 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 Freight agreements | Access the S/4HANA system (via Fiori app Display Freight Agreement) to view loaded Freight agreements |
Accuracy
| 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 |
Key Assumptions
- Master Data Standard is up to date as on the date of documenting this conversion approach and data load.
- Freight agreements is in scope based on data design and any exception requested by business.
- Data entries in DCT are target-ready data unless a specific transformation rule is stated for that field in the transformation rules.
- The list of validation checks in transformation section is not exhaustive and may change over time as the design and configuration of the system evolves.
- Any additional key assumptions.
See also
Change log
| Change History | ||
|---|---|---|
|
Workflow history
| Workflow Report | ||||||
|---|---|---|---|---|---|---|
|