Migration Objects For SAP S4HANA Cloud
Migration Objects For SAP S4HANA Cloud
Migration Objects For SAP S4HANA Cloud
2019-11-23
You can use the following table to gain an overview of all migration objects available for SAP S/4HANA Cloud. It
is sorted in alphabetical order by Migration Object Name. Choose a migration object name to navigate to the
corresponding documentation for the migration object.
Use the search field in the relevant column to search for a specific Migration Object Name or Business Object
Name.
Choose Filter to apply further filters for Master data and/or Transactional data in the Business Object Type
column, for the required business roles in the Business Role column, and for the application component in the
Component column to narrow down the results list. If you want to see more or less information, choose Show/
hide columns, and select the respective checkboxes for the columns you would like to show or hide.
You can export the below table in CSV format with the current column visibility and filters applied. Therefore,
choose the CSV button above the table.
Fixed asset - Mas Asset Accounting Master data SAP_BR_AA_ACCO File FI-AA
ter data [page UNTANT Staging Table
151]
Fixed asset - Post Asset Accounting Transactional data SAP_BR_AA_ACCO File FI-AA
ings [page 155] UNTANT Staging Table
Cash memo re Bank Account Transactional data SAP_BR_CASH_MA File FIN-FSCM-CLM-
cord [page 243] NAGER Staging Table CM
TRM - Bank guar Bank Guarantee Transactional data SAP_BR_TREASUR File FIN-FSCM-TRM
antee [page 341] Y_SPECIALIST_F Staging Table
OE
PSS - Raw material Chemical Compli Master data SAP_BR_PROD File EHS-SUS
STWRD_SPLST Staging Table
compliance info ance Info
_PCL
[page 104]
SAP_BR_MD_S
PECIALIST_P
CL
FI-CA Contract ac Contract Account Master data SAP_BR_APR_ File FI-CA
ACCOUNTANT_ Staging Table
count [page 135]
FICA
SAP_BR_APR_
MANAGER_FIC
A
FI-CA Open item Contract Account Transactional data SAP_BR_APR_ File FI-CA
ACCOUNTANT_ Staging Table
[page 138] Document
FICA
SAP_BR_APR_
MANAGER_FIC
A
Document info re Document Info Re Master data SAP_BR_DESIGN_ File CA-DMS
cord [page 95] cord ENGINEER Staging Table
SAP_BR_GL_ACCO File FI
FI - Historical bal Financial Account Transactional data
UNTANT Staging Table
ance [page 174] ing
Fixed asset (incl. Fixed Asset Master data SAP_BR_AA_ACCO File FI-AA
balances and Transactional UNTANT Staging Table
transactions) data
(deprecated)
[page 144]
TRM - Foreign ex Foreign Exchange Transactional data SAP_BR_TREASUR File FIN-FSCM-TRM
change collar - Collar - Contract Y_SPECIALIST_F Staging Table
contract [page OE
356]
TRM - Foreign ex Foreign Exchange Transactional data SAP_BR_TREASUR File FIN-FSCM-TRM-
change spot/ Spot Forward Y_SPECIALIST_F Staging Table TM
forward transac Transaction OE
tion - contract
[page 359]
TRM - Foreign ex Foreign Exchange Transactional data SAP_BR_TREASUR File FIN-FSCM-TRM-
change swap - Swap Contract Y_SPECIALIST_F Staging Table TM
contract [page OE
353]
TRM - Interest rate Interest Rate In Transactional data SAP_BR_TREASUR File FIN-FSCM-TRM
instrument [page strument Y_SPECIALIST_F Staging Table
362] OE
TRM - Interest rate Interest Rate Swap Transactional data SAP_BR_TREASUR File FIN-FSCM-TRM-
swap [page 367] Y_SPECIALIST_F Staging Table TM
OE
JIT - Supply con JIT – Supply Con Master data SAP_BR_MD_SPEC File LE-JIT
trol [page 258] trol IALIST_JIT Staging Table
JVA - Joint operat Joint Operating Master data SAP_BR_JVA_ACC File CA-JVA
ing agreement Agreement (JOA) OUNTANT Staging Table
[page 189]
JVA - Joint venture Joint Venture Master data SAP_BR_JVA_ACC File CA-JVA
master data [page OUNTANT Staging Table
202]
JVA - Joint venture Joint Venture Part Master data SAP_BR_MD_SPEC File CA-JVA
partner [page ner IALIST_PCL Staging Table
192]
File LO
Material (depre Material Master data SAP_BR_PRODMAS
cated) [page 233] TER_SPECIALIST Staging Table
PSM - Fund [page Public Sector Man Master data SAP_BR_BUDG File PSM-FM
ET_RESPONSI Staging Table
290] agement
BLE
SAP_BR_BUDG
ET_SPECIALI
ST
Purchasing info re Purchasing Info Master data SAP_BR_PURCHAS File MM-PUR
cord- extend exist Record ER Staging Table
ing record [page
291]
Purchasing info re Purchasing Info Master data SAP_BR_PURCHAS File MM-PUR
cord with condi Record ER Staging Table
tions [page 294]
Real estate con Real Estate Con Transactional data SAP_BR_RECM_SP File RE-FX
tract [page 306] tract ECIALIST Staging Table
Source list [page Source List Master data SAP_BR_PURCHAS File MM-PUR
329] ER Staging Table
JVA - Cost center Suspended Cost Master data SAP_BR_ADMI File CA-JVA
suspense [page N_JVA Staging Table
Centers
194] SAP_BR_OVER
HEAD_ACCOUN
TANT
JVA - Venture sus Suspended Ven Master data SAP_BR_JVA_ACC File CA-JVA
pense [page 197] Staging Table
tures OUNTANT
The Cost rate migration object is no longer supported in SAP S/4HANA Cloud. You can upload activity prices
using the upload function of the new Manage Cost Rates - Plan SAP Fiori app. For more information and
support, refer to the SAP Fiori apps reference library.
Caution
Data protection legislation may require that personal data is deleted once the data has served its originally
defined purpose and is also no longer subject to additional legal data retention requirements. If data
protection legislation is applicable in your case, then migrating personal data which should have been
deleted could be interpreted as the processing of personal data without any legally justified purpose.
Note
For some migration objects there are additions to the migration object name. These additions include
"restricted" and "deprecated". Restricted means that not all fields and structures of the relevant business
processes are covered by this migration object, deprecated means that there is a newer version of this
migration object available. Deprecated objects will be deleted after a couple of releases. Make sure you
always read the migration object documentation for these objects carefully. Also see SAP Note 2698032
for more details on deprecated migration objects.
Migration objects are built for initial migration of your data to your SAP S/4HANA or SAP S/4HANA Cloud
system. This means that you can create data with a migration object, but you can't change or update
existing data with it.
Note
After an SAP S/4HANA Cloud release upgrade, any new migration objects won’t get added to existing
migration projects. To be able to use new migration objects, you need to create a new migration project. If
there are still migration objects missing after creating a new migration project, please see SAP Note
2538700 for further information.
Further Information
● Use these SAP Help Portal aliases to access the following sections of our product assistance:
● If you want to migrate historical financial transactions into your SAP S/4HANA Cloud using the SAP S/
4HANA migration cockpit, see SAP Note 2587192 .
● If you are using the Fixed asset (incl. balances and transactions) (deprecated) [page 144] migration object,
you can find additional information about the available fields for each asset class in SAP Note 2468501 .
● If you want to view information about the differences between the current release and the previous release,
see SAP Note 2568909 .
Purpose
In Scope
Supported Features
Prerequisites
Mapping Instructions
Level Name
● 1840693
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition The Bank Account Balance is the value date balance of each
bank account, which serves the requirement of cash position
analysis for cash managers.
In Scope
Supported Features
Prerequisites
Bank account needs to be created before initializing the balance, you can find the Technical ID in bank account
master data, on the General data tab and this Technical ID is used as Account ID in the file to be imported.
Cash flow should not be generated for the company code used before migrating this object into the system.
Otherwise the user will get the error message Company code XYZ already has flows generated from
FI in one Exposure.
Mapping Instructions
Level Name
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
You can delete already migrated balance records using the Delete Data from One Exposure app. For further
information, refer to the SAP Fiori apps reference library and the SAP Help Portal.
Note
After deletion, balance records with same key can be migrated again using a new migration project.
1.3 Bank
In Scope
Supported Features
● Bank Country
● Bank Key
● Bank Address Data
Mapping Instructions
Level Name
Tasks
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Further Information
Find information about using the Transfer BIC Data app to upload bank directories, compare them with existing
bank data, and save the new and changed data in the bank master table using a global bank directory in the
Cash and Liquidity Management product assistance. Bank directories can be downloaded from the web pages
of central banks. The Monetary Financial Institutions (MFIs): Download area of the European Central Bank is
an example of this.
Purpose
Business Object Definition Batch Master Data (if batch is unique at material level).
Out of Scope
Supported Features
● Material Number
● Batch Number
● Plant
● Batch Attributes
● Characteristic Values
● Control Parameters
Prerequisites
Mapping Instructions
If you want to create a batch for a material that is defined by its valuation category as a material valuated in
single batches, you have to provide a valid valuation category. In this case, leaving the field valuation category
empty is not allowed .
The values in VALUE_FROM and VALUE_TO always relate to the unit of measurement of the characteristic.
If the unit of measurement specified here does not equal the unit of measurement of the characteristic, the
output is converted into this unit of measurement.
For example, if the Characteristic has the ISO UOM ANN (Year), and the VALUE_FROM field has the value 2, and
if the UNIT_FROM field has the ISO UOM MON, the two years are converted to months, and the system displays
24 months.
● 100,00 kg to 1,00 t
● 10,00 mg to 100,00 g
If you want to assign the interval 100,00 kg to 1,00 t as a value, you have to fill the fields on the Classification
NUM Values sheet like this:
Enter the Internal Floating Point Value From and Internal Floating Point Value To values according to the Base
UoM From (ISO) defined in the Characteristic itself (in this case KGM). The Base UoM From (ISO) and Base UoM
To (ISO) fields are filled with the desired Units of Measure in ISO.
● 1 for EQ (Equal)
● 2 for GE LT (Greater than or equal and Less than)
● 3 for GE LE (Greater than or equal and Less than or equal)
● 4 for GT LT (Greater than and Less than)
● 5 for GT LE (Greater than and Less than or equal)
● 6 for LT (Less than)
● 7 for LE (Less than or equal)
● 8 for GT (Greater than)
● 9 for GE (Greater than or equal)
● VALUE_FROM: 20
● VALUE_TO: 28
● VALUE_RELATION: 2
Imported value:
● 20≤ X <28
Level Name
2 Plant
Tasks
Batch Overview
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
● BOM categories
In the SAP System, BOMs can form different objects
and manage object-related data. You can maintain the
following BOM categories, for example:
○ Material BOM
○ Document structure
○ Equipment BOM
○ Functional location BOM
○ Sales order BOM
● Technical types
To display product variants and production alternatives,
the system provides two technical types:
○ Variant BOM
○ Multiple BOM
In Scope
1. Currently, you can only process one alternative BOM per one material number, plant and BOM usage, but
this can be any number from 01 to 99.
2. Material BOM
3. For object dependency, only the assignment of global dependency is supported, and only the dependency
types Selection condition and Procedure are supported so far.
4. The following Item Categories (Bill of Material) are supported:
○ L-Stock item
○ N-Non-stock item
○ T-Text item
○ K-Class item
Out of Scope
1. Document structure
2. Equipment BOM
3. Functional location BOM
4. Sales order BOM
● BOM Header
● BOM Items
● BOM Subitems
● Global dependency
● Local dependency
● Description of local dependency
● Source code of local dependency
● Documentation of local dependency
● Document assignment
Prerequisites
In order that the data remains consistent, make sure that the decimal separator used in the file is the same as
the one in user settings, please check the user settings first.
Business objects that reference this object must be created within the validity period that fits this object.
If a successor object is created with a validity period starting before this object, this will normally cause an error
message during the creation or migration of the successor object.
You therefore have to check such time dependencies before you create or migrate your objects. This will avoid
later error messages and inconsistent data on your database.
Mapping Instructions
Level Name
1 BOM Header
(mandatory)
2 Document assign
ment
3 BOM Subitems
3 Document assign
ment
4 Global depend
ency
4 Local dependency
5 Description of lo
cal dependency
5 Documentation of
local dependency
Check that the data type of these fields was not changed from String to Number before uploading the XML file
to Migration Cockpit.
Tasks
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Further Information
For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your data
migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/4HANA Cloud
(for customers and partners only).
Purpose
Business Object Definition A certificate profile controls inspection lot selection, the se
quence of characteristics, the characteristic data for a qual
ity certificate. It can be assigned to materials, material
groups, and material/customer combinations.
Supported Features
Prerequisites
Mapping Instructions
Level Name
2 Materials
2 Characteristics
3 Characteristics text
2 Material assignment
2 Material/Customer assign
ment
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition A change number is used to uniquely identify a change mas
ter record. All changes made with reference to a change
number are controlled and logged by the change master re
cord. Numbers are assigned externally.
The object management record is only supported for the following objects:
Out of Scope
Supported Features
Mapping Instructions
2 Alternative Dates
2 Material
2 Material BOM
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
1.8 Characteristic
Business Object Definition Property for describing and distinguishing between objects,
such as length, color, or weight.
In Scope
Supported Features
● Basic Data
● Descriptions
● Characteristic Allowed Values
● Characteristic Value Descriptions
● Characteristic Additional Data
● Characteristic Restrictions
Prerequisites
Business objects that reference this object must be created within the correct validity period for this object.
If a successor object is created with a validity period that starts before the validity period of this object, it will
normally cause an error message during the creation or migration of the successor object.
You therefore have to check such time dependencies before you create or migrate your objects. This will avoid
subsequent error messages and inconsistent data on your database.
Level Name
Valid From
The value of this field can only be inherited from the change number. If the change number is empty, the Valid
from will be ignored.
Document Details
Starting with SAP S/HANA Cloud 1805, the document details in the additional data are supported.
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
1.9 Class
Purpose
In Scope
● Basic Data
● Class Description/Keywords
● Long Texts
● Characteristics
● Document Information
● Standards Data
Prerequisites
Business objects that reference this object must be created within the correct validity period for this object.
If a successor object is created with a validity period that starts before the validity period of this object, it will
normally cause an error message during the creation or migration of the successor object.
You therefore have to check such time dependencies before you create or migrate your objects. This will avoid
subsequent error messages and inconsistent data on your database.
Mapping Instructions
Level Name
2 Long texts
2 Characteristics
Class Type
Organizational Area needs to be filled the same in both Characteristics and on the General data sheet.
The entries possible for the Organizational Area field in General data are a combination of values. An
Organizational Area is represented by an indicator. For example, 'L' or 'S' are organizational area indicators,
which must first be defined and added to a class type in the configuration.
One or both organizational area indicators can be combined. For example, the value 'LS' means the current
class has two organizational areas.
Documentation
The combination of the field values for Document type, Document number, Document version, and Document
part is checked against the database.
If a document with the combined values is not stored on the database (Table DRAW), the following error
message appears: Document <Document Type>-<Document number>-<Document version>-
<Document part> not found, please check the values.
Tasks
Post-Processing
Purpose
Business Object Definition The classes used to define a multi-level search path.
In Scope
1. Assign class
Out of Scope
● Header
● Class Hierarchy
Prerequisites
Business objects that reference this object must be created within the correct validity period for this object.
If a successor object is created with a validity period that starts before the validity period of this object, it will
normally cause an error message during the creation or migration of the successor object.
You therefore have to check such time dependencies before you create or migrate your objects. This will avoid
subsequent error messages and inconsistent data on your database.
Mapping Instructions
Level Name
1 Header (mandatory)
Instance class
The instance is the only class without a superior class.
Each class in the Child class name field also occurs in the parent class name field.
Each class in the Child class name field has exactly one entry without the Link indicator.
Input example:
Hierarchy level
The hierarchy levels (Level) can be anything you like, but we recommend assigning level 1 to the instance, level
2 to its immediate subordinate classes, and so on. The hierarchy level of each class is higher than the level of its
superior class (the one without the Link indicator).
Description (optional)
You can enter some comments here to have a better overview of the class hierarchy.
When a class is assigned to a second superior class, this field must contain X in the first entry.
Example:Class5 has two superior classes, this means we have two entries which Child class name is Class5,
the link must be set to X in the first entry.
Input:
Instance class name Parent class name Child class name Level Link
Class1 Class5 4
Specifies the class name which is is on the left side of child class name.
Specifies the class name which on the right side of child class name.
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Further Information
Purpose
When you assign objects to a class, you assign values for the
object to the characteristics in that class.
In Scope
1. Assign material classes (assign material class name and characteristic values):
1. Class type Material (001) is supported.
2. Class type Equipment (002) is supported.
3. Class type Functional Location (003) is supported.
4. Class type Vendor Class (010) is supported.
5. Class type Customer Class (011) is supported.
6. Class type Document Management (017) is supported.
7. Class type Work Center Class (019) is supported.
8. Class type Batch (022 and 023) is supported.
9. Class type Maintenance Plan (080) is supported.
10. Class type Material - Configurable Objects (200) is supported.
11. Class type Variants (300) is supported.
Out of Scope
1. Batch classes will be assigned via the Batch (if Batch is unique at material level) [page 22] migration
object.
Supported Features
● Basic Data
● Characteristic Values (only for material classification)
● Change Number
Business objects that reference this object must be created within the correct validity period for this object.
If a successor object is created with a validity period that starts before the validity period of this object, it will
normally cause an error message during the creation or migration of the successor object.
You therefore have to check such time dependencies before you create or migrate your objects. This will avoid
subsequent error messages and inconsistent data on your database.
Mapping Instructions
KLART OBTAB
001 MARA
002 EQUI
003 IFLOT
010 LFA1
011 KNA1
017 DRAW
019 CRHD
022 MARA
023 MARA
080 MPLA
200 MARA
300 MARA
Level Name
Material Classification
To assign class and characteristic values to material, the source file must contain the Header Data sheet and
the Value Allocation sheets:
Variants Classification
To assign class and characteristic values to variants, the source file must contain the Header Data sheet and
the Value Allocation sheets. On the Header Data sheet, fill the following fields:
Equipment Classification
To assign class and characteristic values to equipment, the source file must contain the Header Data sheet and
the Value Allocation sheets. On the Header Data sheet, fill the following fields:
Vendor Class
To assign class and characteristic values to vendor, the source file must contain the Header Data sheet and the
Value Allocation sheets. On the Header Data sheet, fill the following fields:
Customer Class
To assign class and characteristic values to customer, the source file must contain the Header Data sheet and
the Value Allocation sheets. On the Header Data sheet, fill the following fields:
To assign class and characteristic values to work center, the source file must contain the Header Data sheet
and the Value Allocation sheets. On the Header Data sheet, fill the following fields:
The values in the Value From and Value To fields always relate to the unit of measurement of the characteristic.
For example, if the unit of measurement of the characteristic is ISO UOM ANN (Year), 2 means two years. The
system ignores units in the Base unit of measure From (ISO Format) field and the Base unit of measure To (ISO
Format) field here. These are only displayed later.
● 1 for EQ (Equal)
● 2 for GE LT (Greater than or equal and Less than)
● 3 for GE LE (Greater than or equal and Less than or equal)
● 4 for GT LT (Greater than and Less than)
● 5 for GT LE (Greater than and Less than or equal)
● 6 for LT (Less than)
● 7 for LE (Less than or equal)
● 8 for GT (Greater than)
● 9 for GE (Greater than or equal)
Input example:
● VALUE_FROM: 20
● VALUE_TO: 28
● VALUE_RELATION: 2
Imported value:
● 20≤ X <28
If the unit of measurement value specified here in the classification does not equal the unit of measurement
value of the characteristic, the output is converted into the classification's unit of measurement.
For example, if the characteristic has the ISO UOM ANN (Year), and the VALUE_FROM field has the value 2, and
if the UNIT_FROM field has the ISO UOM MON, then the two years are converted to months, and the system
displays 24 months.
You can enter values in the Characteristic Value Neutral field. Be aware of using values, that match the format
and domain specification of the characteristic.
The Instance counter field has been removed from SAP S/HANA release 1802, because this field is used in the
userdefined data type, and not supported in SAP S/4HANA, for more details please see SAP Note 2267878 .
Example
1 AB_Root_Level_1
2 A_First_Level_2
3 A_Second_Level_3
2 B_First_Level_2
If you want to assign A_Second_Level_3, you must fill the entries of the Character value allocations structure as
follows:
Starting with SAP S/HANA release 1802, you can now enter values for Lower Boundary for Date-Interval and
Upper Boundary for Date-Interval in the new Characteristic Value (DATE) columns on the Classification NUM
Values sheet in the migration template. The same applies for Lower Boundary for Time-Interval and Upper
Boundary for Time-Interval in the new Characteristic Value (TIME) columns. Please note that values entered for
Internal Floating Point Value From and Internal Floating Point Value To in the Characteristic Value columns are
always given priority. When you enter values for these fields, values entered for Characteristic Value (DATE) and
Characteristic Value (TIME) will not be considered when migrating.
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Further Information
Purpose
In Scope
Supported Features
Prerequisites
Mapping Instructions
Item Condition
The Item Condition structure contains the corresponding fields which define the condition such as the amount,
calculation type or currency. The order key must be part of the condition structure field table.
Condition Scale
The Condition Scale contains the corresponding fields which define the condition scales. The order key must
be part of the condition structure field table.
Settlement Dates
The Settlement Dates structure contains the settlement dates for the different types of settlement (delta
accruals, partial, final, delta, and accruals deferral settlement). You must specify the order key, the settlement
date type, and the settlement date as a minimal data set. All other fields are optional.
Eligible Partners
The Eligible Partners structure contains the eligible partners for the condition contract. You must specify the
order key and an eligible partner as a minimal data set. All other fields are optional. You cannot pass data for
different eligible partner types at the same time.
Level Name
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
This is the most complex and comprehensive object to migrate condition records for pricing. There are also
tailored migration objects available with limited number of available key fields : Condition record for pricing
in sales (restricted) [page 317] or Condition record for pricing in purchasing (restricted) [page 248].
Purpose
Business Object Definition The term pricing is broadly used to describe the calculation
of prices (for external use by customers or vendors). Condi
tions represent a set of circumstances that apply when a
price is calculated.
In Scope
1. Prices
2. Discounts
3. Surcharges
Out of Scope
All condtions that are not white-listed; for further information, please refer SAP Note 2332748 .
Supported Features
Mapping Instructions
Level Name
2 Scales
For more information on how to fill the condition keys, please refer to SAP Note 2332748 .
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Purchaser
(SAP_BR_PURCHASER)
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Examples
Further Information
For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your data
migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/4HANA Cloud
(for customers and partners only).
Purpose
Business Object Definition An object in which you enter configuration parameters for a
configurable object. Each Material must be assigned to at
least one class with a class type that supports variant config
uration.
In Scope
Supported Features
● Attributes
● Global dependencies
● Basic data of local dependency
● Descriptions of dependency
● Documentations of dependency
Prerequisites
1. If the configuration profile needs to be created with a change number, please create a change
number first, and then create a configuration profile using the change number.
2. Material with more than one configuration profile must be loaded with no change numbers or with
change numbers that have a different validity date. Violation leads to an error message, for
example: Changes only allowed with change number or Enter a change number.
3. If Material is not assigned to a class type, the status In Preparation will be assigned to the
configuration profile as standard.
Mapping Instructions
Level Name
1 Attributes (mandatory)
3 Descriptions of dependency
(optional)
3 Documentations of depend
ency (optional)
Note
Local dependencies with syntax errors in the source code cannot be loaded. In the case of syntax
errors, an error message will be displayed and the configuration profile will be skipped for migration.
● Descriptions of Dependency
Enter a local dependency description, one in each language.
Note
The Descriptions of dependency sheet, should contain at least one description per local dependency.
Otherwise, an error message, Maintain at least one description for the dependency, will
be raised.
Note
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
1.15 Consent
Business Object Definition Consent is an assent given by the data subject that allows
lawful processing of their personal data. It facilitates proving
legality and ensures the correct processing of personal data
according to the purpose for which it was given.
In Scope
Supported Features
● Consent
● Consent Text
Mapping Instructions
Level Name
1 Consent (mandatory)
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
1.16 VC - Constraint
Purpose
In Scope
● General data
● Multi-lingual descriptions
● Documentation
● Source code
Prerequisites
Note
1. If a constraint needs to be created with a change number, please create a change number first, and
then create a constraint using the change number.
2. If multiple constraints need to be assigned to a dependency net, all constraints should be migrated
with the same change number or with change numbers with different validity-from dates or with no
change number.
Mapping Instructions
Level Name
2 Documentation
General Data
Multi-Lingual Descriptions
The Multi-lingual description sheet should contain at least one description per constraint. Otherwise, an
error message, Maintain at least one description for the dependency, will be displayed.
Documentation
Enter a documentation, one for each language.
Note
Source Code
Maintain a source code in one line (string), for each constraint.
Note
Constraints with syntax errors in the source code cannot be loaded. In the case of syntax errors, an error
message will be displayed and the constraint will be skipped for migration.
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
● Quantity Contract
● Value Contract
In Scope
1. Header Data
2. Vendor Address
3. Header Texts
4. Item Data
Note
5. Delivery Addresses
6. Account Assignment
Note
7. Item Texts
1. Master conditions:
During the creation of outline agreements, you can specify just one time period per variable key. This
means that you can specify a period for the document header (that is, condition table A019), for each item
(that is, condition table A016), and for each item/plant combination (that is, condition table A068).
Note
If there's an info record already, the price will be taken over from this info record.
Supported Features
● Header Data
● Supplier Address
● Header Texts
● Item Data
● Delivery Addresses
● Account Assignment
● Item Texts
Mapping Instructions
● During migration you can choose between internal and external number assignment for the purchasing
document. Item numbers will be migrated 1:1 from the migration template into the data.
● Net Price:Please provide the price as manual price on item level, additional conditions are not supported. If
a purchasing info record for an item already exists, the conditions (inclusive scales) will be taken over from
this info record. You have to take care and check that the conditions validity period matches with the
stipulated validity period of the agreement.
Level Name
2 Supplier Address
2 Header Texts
3 Delivery Address
3 Account Assignment
3 Item Texts
Tasks
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition A customer is a business partner with whom a business rela
tionship exists, involving the issue of goods or services. The
customer orders goods from the company, and is one of the
most commonly used master data objects, used by almost
all business applications.
In Scope
Out of Scope
Supported Features
Prerequisites
Mapping Instructions
On the General Data sheet, we offer fields which only become relevant when you extend already existing
suppliers/contract partners as customer with the same number. If you want to extend an existing supplier or
Please consider: You can't transfer a value in one of the fields provided on the General Data sheet when the
customer already exists.
If you want to use the Customer ID for integration with external systems, you can activate it during migration.
At the same time, you must also maintain the Business System ID of your source system (to be used for
integration) using the Convert Values task to ensure that the key mapping is added to the central key mapping
store of the SAP S/4HANA system. This is only relevant if you extend an existing supplier or contract partner as
customer with the same number. If you extend an existing customer with new org levels it is not necessary to
switch on the key mapping for the Customer ID.
If you want to use these references to other business partners, make sure these business partners have been
created in advance.
Example
You have three customers, A, B, and C. They have the following relation:
● A is ship-to-party for B
● B is ship-to-party for C
● C is ship-to-party for A
Please note that this data constellation can't be handled with the data migration object. Please remove some of
the relations and add them later via the BP maintenance UI or BP mass maintenance app.
To assign a contact person as partner, first create the customer with the contact person, but without sales
data. Then, use the Customer - extend existing record by new org levels migration object in a second step to
assign the sales data together with the contact person in partner capacity.
If Vertex determines more than one tax jurisdiction code for a record, the migration of this record will fail. If this
happens, you'll have to provide a more detailed/accurate address, for example, a US Postal code with 9 digits
instead of 5 digits.
The more detailed and accurate an address, the better the tax jurisdiction code will be determined by Vertex.
For some addresses, Vertex will always provide more than one tax jurisdiction code. In this case you will have to
maintain this record manually or provide a correct tax jurisdiction code within the template.
In the Suppress Tax Jurisdiction Code Check field on the General Data sheet, you can suppress the check and
the automatic determination of the Tax Jurisdiction Code for each record.
Level Name
2 Additional Addresses
2 General Texts
2 Sales Data
3 Sales Partner
2 Company Data
3 Company Texts
2 Bank Data
2 Industries
2 Tax Classifications
2 Tax Numbers
2 Identification Numbers
2 Contact Person
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition A business partner may have many branches depending on
the various locations from where they operate from. A
branch code is a 4-digit or a 5-digit code assigned by the
Revenue Department in Thailand to uniquely identify each
branch of a business partner. In any case, the head office
branch carries a branch code of 00000 or 0000.
Out of Scope
Supported Features
Prerequisites
Mapping Instructions
● The customer master data needs to be migrated as a prerequisite with the Thailand company code
assigned.
● Only one branch code can be marked as default branch code. If only one branch code is assigned, it will be
marked as default automatically.
● If branch codes are already assigned to the customer, additional branch codes can only be uploaded
without a default indicator.
● As the standard method for communication (part of the address information), only the following values are
supported: Fax, E-Mail and Telephone.
Level Name
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
Out of Scope
Supported Features
Prerequisites
Note
If you submit a credit limit amount, the amount value will be stored in the Requested field on the Credit
Limit tab. This is the standard behavior when maintaining the credit limit for a business partner. The reason
for this is the configuration of the system: A credit limit change triggers the Change to Credit Limit
Requested event with the LIMIT_REQ follow-on process. This also happens during migration, because the
Mapping Instructions
Level Name
Tasks
Post-Processing
Purpose
In Scope
Supported Features
● General Data
● CustMat Text
● CustMat Classsification
● CustMat Classsif Numbers
● CustMat Classsif Characteristic
● CustMat Classsif Currency
Mapping Instructions
Level Name
2 CustMat Text
2 CustMat Classification
Please refer to the tooltips field of the template file for further information.
Tasks
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
1.22 Customer
Tip
For this migration object, the Custom Fields and Logic app is available. If you enhance your business object
with custom fields in the app, these custom fields will automatically be reflected in the XML template of the
corresponding migration object. See SAP Note 2726010 for further details.
Every time you add, change or delete a custom field, the migration project must be updated and a new
migration XML template must be downloaded and used. Thus, if custom fields are added or changed by an
application expert during migration testing, this must be communicated to and coordinated with your data
migration team. Also see the Extensibility section in the SAP S/4HANA Cloud documentation.
Purpose
In Scope
Out of Scope
● General Data
● Additional Addresses
● General Texts
● Sales Data
● Sales Partner
● Sales Organization Texts
● Company Data
● Withholding Tax Data
● Company Texts
● Bank Details
● Payment Card Data
● Industries
● Tax Classifications
● Tax Numbers
● Identification Numbers
● Contact Persons
Note
Any time you add, change or delete a custom field, the migration project must be updated; a new XML
template must be downloaded and used. Thus, if custom fields are added, changed or deleted by an
application expert during migration testing, this must be communicated to, and coordinated with, data
migration.
The Customer (General Data, Company Data, and Sales Data) can be enhanced with the Custom Fields
and Logic app, adding custom fields in the application. If the Customer is enhanced in this way, the
custom fields will be reflected automatically in the XML template as well.
Prerequisites
Mapping Instructions
The customer will be created with the Customer (FLCU01) role. The Customer (Financial Accounting) (FLCU00)
role will be created if company data is provided in the template.
All mandatory partner functions will be created automatically with the same customer number. If you provide
the partner function with a different customer number on the Partner Functions sheet, this entry will be taken.
Example
English Migration
SP AG
SH WE
PY RG
BP RE
ER ZM
It is possible to assign more than one address to a customer. The address data from the General Data sheet is
always the standard address. If you assign only one address to a customer it is not necessary to provide an
external address number. If you provide additional addresses, the external address number is mandatory. The
external address number must be unique for each customer. You can use the same external address number
for different business partners.
During migration, you can choose between internal and external number assignment for new customers.
Assigned contact persons will always get an internal number for the new business partner.
With the BP Grouping field on the General Data sheet, you arrange the different number ranges (internal or
external) and the customer account group. It is possible to create customers and one-time customers.
If you need to create a business partner with both customer and supplier roles, this can be achieved in a two-
step approach. You can extend a customer that has already been migrated, with the Supplier - extend existing
record by new org levels [page 379] object to add the appropriate supplier data.
If you want to use the Customer ID for integration with external systems, you can activate it during migration.
At the same time, you must also maintain the Business System ID of your source system (to be used for
integration) using the Convert Values task to ensure that the key mapping is added to the central key mapping
store of the SAP S/4HANA system.
If you have activated the Define Sensitive Fields for Dual Control (Customers) option in the Configure Your
Solution app, you must confirm all related customer changes in the Confirm Customer List app. Migration of
master data records are then considered as changes, and you must confirm them later on. For this reason, you
should consider to deactivate this option before you start with the data migration, and activate it again
afterwards.
For the customer migration object, you can enter data into fields which could be cross-references to other
business partners, for example alternative payers or ship-to-parties.
If you want to use these references to other business partners, make sure these business partners have been
created in advance.
Example
You have three customers, A, B, and C. They have the following relation:
● A is ship-to-party for B
● B is ship-to-party for C
● C is ship-to-party for A
Please note that this data constellation can't be handled with the data migration object. Please remove some of
the relations and add them later via the BP maintenance UI or BP mass maintenance app.
To assign a contact person as partner, first create the customer with the contact person, but without sales
data. Then, use the Customer - extend existing record by new org levels [page 68] migration object in a second
step to assign the sales data together with the contact person in partner capacity.
Contact Person ID
You must enter a contact person ID in the respective field on the Contact person sheet. This number is required
for internal data processing. However, during processing, a new business partner will be created with an
internal number. This business partner is automatically assigned to the customer with the corresponding
relationship.
If Vertex determines more than one tax jurisdiction code for one record, the migration of this record will fail. If
this happens, you must provide a more detailed/accurate address: for example US Postal codes with 9 digits
instead of 5 digits.
The more detailed and accurate an address, the more accurately Vertex will be determine the tax jurisdiction
code.
For some addresses, Vertex will always provide more than one tax jurisdiction code. If that's the case you must
maintain this record manually or provide a correct tax jurisdiction code within the template.
In the Suppress Tax Jurisdiction Code check field on the General Data sheet, you can suppress the check and
the automatic determination of the Tax Jurisdiction Code for each record.
Level Name
2 Additional Addresses
2 General Texts
2 Sales Data
3 Sales Partner
2 Company Data
3 Company Texts
2 Bank Data
2 Industries
2 Tax Classifications
2 Tax Numbers
2 Identification Numbers
2 Contact Person
Tasks
Post-Processing
Further Information
● For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your
data migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/
4HANA Cloud (for customers and partners only).
● SAP Note 2726010 – Migration Cockpit: Support of custom fields (in-app extensibility)
● SAP Note 2609888 – Mandatory partner function SP is missing for sales area
Purpose
Business Object Definition Object dependencies can be defined between different ob
jects in configuration.
1. Precondition AVC
2. Selection condition AVC
3. Procedure AVC
4. Selection condition (Classic)
5. Procedure (Classic)
Note
Classic dependencies are used in maintaining the low-level configuration for Bill of Material (BOM).
Supported Features
Prerequisites
Note
If the configuration profile needs to be created with a change number, please create a change number first,
and then create a configuration profile using the change number.
Mapping Instructions
Level Name
2 Documentation
2 Multi-lingual descriptions
2 Source code
● Multi-Lingual Descriptions
Enter a description, one in each language.
Note
The Multi-lingual description sheet should contain at least one description per object dependency.
Otherwise, an error message, Maintain at least one description for the dependency, will
be displayed.
● Source Code
Maintain a source code in one line (string), for each dependency.
Note
Dependencies with syntax errors in the source code cannot be loaded. In the case of syntax errors, an
error message will be displayed and the dependency will be skipped for migration.
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition A dependency net is a group of constraints which are de
fined within a solution model and specify the relationships
between the characteristics and characteristic values of sev
eral classes.
In Scope
Supported Features
● General data
● Multi-lingual descriptions
● Documentation
Prerequisites
Note
If the dependency net needs to be created with a change number, please create a change number first, and
then create a dependency net using the change number.
Level Name
2 Documentation
Note
The Multi-lingual description sheet should contain at least one description per dependency net.
Otherwise, an error message, Maintain at least one description for the dependency, will
be displayed.
● Documentation
Enter a documentation, one for each language.
Note
Tasks
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition A dangerous goods assessment for a packaged product con
tains classification data, dangerous goods descriptions, and
information about transport permission for the applicable
modes of transport.
In Scope
1. Migration of dangerous goods assessment data to existing compliance views and existing assessments.
Please note that you can only migrate data for compliance assessment based on compliance requirements
with a compliance pattern of type Text-Based.
Supported Features
Prerequisites
● DG - Assessment for unpackaged product (text-based) [page 92] (object for migrating dangerous goods
assessments for unpackaged products)
Mapping Instructions
Level Name
1 Regulation (mandatory)
2 Modes of Transport
2 Packaging Details
Packaging details are directly assigned to a compliance view. Even though you need to enter the internal
number, regulation, and processing status as key fields, only the internal number is considered during
migration. Therefore, you need only one line for the packaging details for one compliance view. If you enter
more than one line for one compliance view, the packaging details data must be identical in all lines.
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
In Scope
1. Migration of dangerous goods assessment data to existing compliance views and existing assessments.
Please note that you can only migrate data for compliance assessment based on compliance requirements
with a compliance pattern of type Text-Based.
Out of Scope
Supported Features
Prerequisites
● PSS - Product compliance info [page 107] (object for migrating compliance views)
Level Name
1 Regulation (mandatory)
2 Basic Description
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition This fact sheet gives the information associated with a docu
ment that has been created in the Document Management
System. A document is a carrier of information. This infor
mation is either for the user/person responsible or for ex
changing between systems. A document contains informa
tion that can be stored and it can take many different forms
(such as technical drawings, graphics, programs, or text).
When complete, this information gives a full description of
an object. We use the term document info record to refer to
the master record in the SAP System that stores all the busi
ness information for a document. While the document info
record contains the metadata for a document (such as the
storage location), the original file (for example, the design
drawing) contains the actual information in the document.
In Scope
Supported Features
● Document Data
Prerequisites
● Document info record (to create a Document Info Record with reference)
● Various Business Objects (to link to the Document Info Record)
● Document types (to link to the Document Info Record)
Mapping Instructions
Level Name
2 Object Links
2 Descriptions
2 Long Text
Document Data
Document Number, Document Type, Version, and Part must be unique.
In order to create a Document Info Record (DIR) with a reference, create the referenced DIR as an initial step
and use the SAP S/4HANA Document Number, Document Part, and Version in the reference fields.
Object Links
Maintain the SAP S/4HANA Object Type and Object Key. These refer to the SAP S/4HANA objects as defined in
the Business Object Repository. For example, an Equipment in SAP S/4HANA can be defined as Object Type:
EQUI and Object Key: 000000000123456781.
Descriptions
In this view, you can maintain additional descriptions (for languages other than those provided on the
Document Data sheet).
If the description is more than 40 characters long, provide up to 40 characters in the Description sheet and
provide the full text as long text.
Long Text
The long text is an extension to the description. If the description is more than 40 characters long, provide up
to 40 characters in the Description sheet and provide the full text as long text. If the initial 40 characters of a
long text are not a part of the Description sheet, the description will be overwritten by the long text.
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
Out of Scope
Basis for measurement reading as Reference object is not supported while creating a measurement document.
You can only create measurement documents for measuring points.
Supported Features
Prerequisites
Mapping Instructions
Level Name
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Business Object Definition Measuring points in the SAP System describe the physical
and/or logical locations at which a condition is described.
In Scope
Out of Scope
Supported Features
● Header
Prerequisites
Level Name
1 Header (mandatory)
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
Out of Scope
1. Documents
2. Location Data - Address
3. Location Data - Production Work Center
4. Location Data - Plant Section
5. Location Data - Current Location
6. Assignment of Task List
7. Breakdown Duration
8. Organizational Data
Supported Features
● Notification Header
● Notification Item
● Notification Item Cause
● Notification Item Activity
● Notification Item Task
● Notification Activity
● Notification Task
● Notification Partner
Prerequisites
Mapping Instructions
Level Name
2 Notification Item
2 Notification Activity
2 Notification Task
2 Notification Partner
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
Out of Scope
1. Attachments
Supported Features
Prerequisites
Level Name
2 Chemical composition
3 Chemical component
2 Material assignment
2 Bulk assignment
2 Purpose assignment
1. Migrate bulk raw materials using the following data from the migration template:
○ Chemical compliance view
○ Chemical composition
○ Chemical component (substances)
○ Material assignment
○ Purpose assignment
○ Supplier material assignment
2. Migrate packaged products related to the raw materials using the migration template:
○ Chemical compliance view
○ Material assignment
○ Bulk assignment
Tasks
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
1. Attachments
Supported Features
Prerequisites
Mapping Instructions
Level Name
2 Chemical composition
3 Chemical component
2 Application
2 Material assignment
2 Market coverage
2 Market request
2 Bulk assignment
2 Purpose assignment
1. Migrate bulk product using the following data from the migration template:
○ Chemical compliance view
○ Chemical composition
○ Chemical component (substances or raw materials)
○ Component before and after production
○ Legal deviation and substitute substances
○ Application
○ Material assignment
○ Purpose assignment
○ Market request
○ Market coverage
2. Migrate packaged products related to product using the migration template:
○ Chemical compliance view
○ Material assignment
○ Bulk assignment
○ Market coverage
Tasks
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
1. L-Stock item
2. N-Non-stock item
3. T-Text item
Out of Scope
1. Sub-items
2. Document assignment
3. Long text
1. R-Variable-size item
2. K-Class item
Supported Features
● BOM Header
● BOM Item
Prerequisites
Mapping Instructions
Level Name
2 BOM Items
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
A maintenance task list is the generic term for all task lists
that are used in plant maintenance.
In Scope
Supported Features
Prerequisites
Business objects that reference this object must be created within a validity period that matches this object.
If a successor object is created with a validity period starting before this object, this will normally cause an error
message during the creation or migration of the successor object.
You therefore have to check such time dependencies before you create or migrate your objects. This will avoid
later error messages and inconsistent data on your database.
Internal/External number range assignment for Group Counter, with control parameter CTR_TLIST_E_NUM –
you have to decide if it is internal or external during each data load.
Level Name
2 Operations (mandatory)
3 Production resource/tools
3 Material components
3 Maintenance packages
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
Supported Features
Prerequisites
Business objects that reference this object must be created within a validity period that matches this object.
If a successor object is created with a validity period starting before this object, this will normally cause an error
message during the creation or migration of the successor object.
You therefore have to check such time dependencies before you create or migrate your objects. This will avoid
later error messages and inconsistent data on your database.
Mapping Instructions
Level Name
2 Partners
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition A storage bin is the smallest spatial unit in a warehouse.
Therefore, a storage bin represents the exact position in the
warehouse where products can be stored.
In Scope
1. General storage bin data, such as aisle, stack, level, and coordinates
2. Status data, such as putaway and stock removal block
3. Data related to physical inventory, such as physical inventory type and date of last inventory
4. Statistics-related data, such as date and time of last movement or date and time of last bin clearing
In SAP S/4HANA Cloud Warehouse Management, a default bin sorting record is generated for each newly
created storage bin. This functionality also applies for the migration of storage bins. Migration object
warehouse storage bin sorting is available to update the generated default bin sorting data.
Note
Only the initial upload is supported. Updating existing fixed bin assignments is not supported.
Supported Features
● Header Data
● Storage Bin Data
● Status
● Physical Inventory
● Statistics
Prerequisites
● Warehouse number
● Storage types
Mapping Instructions
General Instructions
You can upload storage bins for one warehouse only per file. The same warehouse number must be entered for
all storage bins.
Level Name
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
You can enter selection criteria for storage bins that you
want to select and then see your uploaded bins.
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Further Information
For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your data
migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/4HANA Cloud
(for customers and partners only).
Purpose
In Scope
Out of Scope
1. The scope is limited to the assignment itself. Additional attributes, such as quantities, are not supported.
2. Note that only the initial upload is supported. Updating existing fixed bin assignments is not supported.
Supported Features
● Warehouse number
Mapping Instructions
General Instructions
You can upload fixed bin assignments for one warehouse only per file. The same warehouse number must be
entered for all fixed bin assignments.
Level Name
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition A specific ranking of a storage bin into a defined sort se
quence for the combination of warehouse number, activity,
and activity area.
In Scope
● Header Data
● Bin Sorting Attributes
Prerequisites
● Warehouse number
● Storage types
● Activity areas and activities
Mapping Instructions
General Instructions
You can upload bin sorting data for one warehouse only per file. The same warehouse number must be entered
for all bin sorting records.
Level Name
Prefilled Template
In SAP S/4HANA Cloud Warehouse Management, you can download your existing storage bin sorting data. The
downloaded file can be adjusted (especially the Sort Sequence of Storage Bin field) and uploaded using the SAP
S/4HANA migration cockpit. This approach can be used to facilitate the update of existing bin sorting data in
your system. You can perform the download as follows:
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Further Information
For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your data
migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/4HANA Cloud
(for customers and partners only).
In Scope
1. General warehouse product data, such as required minimum shelf life and preferred unit of measure
2. Putaway-related data, such as putaway control and bulk storage
3. Stock removal control
Out of Scope
1. Slotting-related data
2. Storage typespecific data
Note
Only initial upload is supported. An update of existing warehouse product data is not supported.
Supported Features
● Header Data
● General Data
● Putaway
● Stock Removal
● Warehouse number
Mapping Instructions
General Instructions
You can upload warehouse products for only one warehouse per file. The same warehouse number must be
entered for all warehouse product data.
Level Name
Tasks
Post-Processing
Attribute
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Further Information
For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your data
migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/4HANA Cloud
(for customers and partners only).
Purpose
Business Object Definition Warehouse stock represents goods that are stored physi
cally in a warehouse. The warehouse stock is an entity that
describes the goods with information such as the name of
the product, the quantity, batch information, packaging in
formation, and storage bin.
1. Unpacked stock
2. Stock in handling units (HUs)
3. Sales order and project stock
4. Batch-managed stock
Out of Scope
1. Serial numbers
2. Nested HUs
3. Auxiliary packaging material
4. Subcontractor stock and promotion stock (stock usage)
5. Capacity check: The system does not check whether the selected storage bin has the capacity to store the
quantity that is to be put away.
Supported Features
Prerequisites
● Product [page 277] (products and packaging materials for stock in handling units (HUs))
● Warehouse storage bin [page 117]
● Batch (if Batch is unique at material level) [page 22] on material level (for batch stock)
● Purchasing info record with conditions [page 294] (for vendor consignment stock)
● Warehouse number
General Instructions
You can upload stock for one warehouse only per file. The same warehouse number must be entered for all
stock data.
In the stock item data, there are some fields that are mandatory depending on the entered value for the Item
Category for Stock Data Transfer field. Refer to the tooltips for specific information on each field.
The stock header data is made of one structure containing three fields in its key data. These three fields are
also contained in the stock item structure. Each stock item must always have one corresponding header
record. For non-packed stock, leave the Highest-Level HU field blank in both the header and item record. Also
leave the HU ID field blank in the item record.
If you do not enter specific values, the system determines HU fields of the groups HU Weight Data, HU Volume
Data, and HU Dimension Data.
You can enter a posting date on the sheet 'Stock Header Data' . This date is used in inventory management for
the related material and accounting documents. If you leave this field empty, the current date is used as the
posting date. If the posting date field is filled, the same posting date has to be entered for all warehouse
product data. Please consider that the posting date is checked in inventory management. The posting date
must be within one of the permitted posting periods in inventory management. Your settings in inventory
management determine whether posting is permitted only in the current period or also in the previous period.
Note
If there are existing Inventory Management (IM) managed storage locations, all stock that you migrate into
Warehouse Management is also uploaded to the corresponding IM-managed storage location by default. If
you do not want to upload your stock to IM, you must enter X for the Stock Upload to WM Only field (under
Stock Header Data). You must set this for all header records or for no records. If you do not set this, it may
lead to double stock data and inconsistencies in your IM-managed storage locations.
Level Name
Tasks
Stock
Note
Note that the stock is only uploaded to the correspond
ing IM-managed storage location if the Stock Upload to
WM Only field (under Stock Header Data) is left blank.
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Further Information
For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your data
migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/4HANA Cloud
(for customers and partners only).
In Scope
Supported Features
● Exchange Rates
Mapping Instructions
Level Name
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition A contract partner is a business partner with the role of con
tract partner. Contract Accounting only supports the usage
of contract partner.
In Scope
Out of Scope
Supported Features
● General Data
● Addresses
● International Address Versions
● Bank Data
● Payment Card Data
● Industries
● Tax Numbers
● Identification Numbers
Prerequisites
Mapping Instructions
● During data migration you can choose between internal and external number assignment for the new
contract partners.
● If a contract partner needs to be created with customer or supplier roles, these roles need to be
maintained manually.
● It is possible to assign more than one address to a business partner. If you assign several addresses to one
business partner, you have to assign an external address number to this business partner. The external
address number must be unique for each business partner. You can use the same external address number
Level Name
2 Addresses
2 Bank Data
2 Industries
2 Tax Numbers
2 Identification Numbers
If Vertex determines more than one tax jurisdiction code for one record, the migration of this record will fail. If
this happens, you will have to provide a more detailed/accurate address: For example US Postal codes with 9
digits instead of 5 digits.
The more detailed and accurate an address, the better the tax jurisdiction code will be determined by Vertex.
For some addresses, Vertex will always provide more than one tax jurisdiction code. In this case you will have to
maintain this record manually or provide a correct tax jurisdiction code within the template.
In the Suppress Tax Jurisdiction Code check field on the General Data sheet, you can suppress the check and
the automatic determination of the Tax Jurisdiction Code for each record.
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Tip
For this migration object, the Custom Fields and Logic app is available. If you enhance your business object
with custom fields in the app, these custom fields will automatically be reflected in the XML template of the
corresponding migration object. See SAP Note 2726010 for further details.
Every time you add, change or delete a custom field, the migration project must be updated and a new
migration XML template must be downloaded and used. Thus, if custom fields are added or changed by an
application expert during migration testing, this must be communicated to and coordinated with your data
migration team. Also see the Extensibility section in the SAP S/4HANA Cloud documentation.
In Scope
Supported Features
Prerequisites
Level Name
3 Locks
2 Dunning - Correspondence
3 Correspondence Recipients
2 Convergent Invoicing
2 Tax Exemptions
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
1. Migration of Contract Accounting Data (General Data, Business Partner Line Items and General Ledger
Line Items)
2. Migration of Document Lock
3. Migration of Payment Card Data
Out of Scope
Supported Features
● General Data
● Business Partner Line Items
● General Ledger Line Items
● Locking of Business Partner Items
● Payment Card Data
Prerequisites
Mapping Instructions
● Please be aware you have to fill and save amounts in the migration file in number and not in string format.
Check the Excel settings for a delimiter.
● Posting of an internal or external document number will be managed by the given document type in the
migration template. Document types are assigned to either an internal or external number range. For an
internal number assignment, the value of the OPBEL (Number of Contract Account Receivable & Payable
Note
In the migration template, you have to use the - indicator instead of the known indicator / for the
specified indirect notation.
Level Name
Tasks
Post-Processing
Follow-On Activities
It might be necessary to close used reconciliation keys using the Change Reconciliation Key or Delete and Close
Reconciliation Keys apps which are included in the Reconciliation Specialist role
SAP_BR_RECONC_SPEC_APR_FICA.
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition A provider contract comprises all legally binding agreements
regarding the provision and billing of services that are en
tered into by a company for a specified period of time.
Note
During the migration of provider contracts, only the current status of provider contracts is considered.
Changes to the contract in the past, which led to a chronology of the provider contract in the legacy
system, are not transferred.
Out of Scope
Supported Features
Prerequisites
A provider contract relates to exactly one business partner. Creating Business Partners in the required role
(Contract Partner, Contract Accounts and Materials) is mandatory before the migration of Provider contracts.
Please refer to the FI-CA Contract partner [page 132], FI-CA Contract account [page 135], and Product [page
277] migration objects.
Level Name
1 Provider Contract
Header (mandatory)
3 PC Item Discount
Enter the GUID of the contract in the SAP CRM source system. If your source is not an SAP CRM source, please
provide a valid GUID.
You may search on the Internet for GUID Generator to generate valid GUID. The GUID must not be used in the
current SAP S/4HANA or SAP S/4HANA Cloud systems.
Tasks
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Caution
This migration object is deprecated as of release SAP S/4HANA Cloud 1911. Until its final deletion, it is
solely available for compatibility reasons. Only customers who started their migration project in release
SAP S/4HANA Cloud 1908 may still use it.
Be aware that the documentation for this migration object which you find below, only reflects the status of
release SAP S/4HANA Cloud 1908.
Purpose
With this migration object, you perform a legacy data transfer for fixed assets.
Business Object Type Master data and transactional data (asset values)
In Scope
Supported Features
● Master Details
● Inventory
● Posting Information
● Time-Dependent Data
● Origin
● Acct Assignment for Investment
● Depreciation Areas
● Cumulative Values
● Posted Values
● Transactions
● Proportional Values on Transactions
● CountrySpecific
Note
As of SAP S/4HANA Cloud 1905, the following countryspecific fields for Japan are supported:
● Sort Key 5 (Allocations category) is enabled as city code for the Japan Property Tax Report.
● Property Classification Key (Net worth valuation category) is enabled as Property Classification Code
for the Japan Property Tax Report.
● Reason for Manual Valuation of Net (Net worth valuation category) is enabled as reason code for a
special depreciation rate for the Japan Property Tax Report.
● Leasing Agreement Date (Leasing category) is enabled as leasing agreement date for the Japan
Annex16 Report.
You use the SAP S/4HANA Migration Cockpit to transfer legacy data for fixed assets.
Note
The legacy asset number is migrated to the Original Asset field on the Origin tab page.
Note
○ Asset subnumbers must be migrated within the same migration project. (This is due to the project
specific mapping table of the main asset number.)
○ Asset subnumbers must be transferred in a separate file. (Reason: The mapping table for main
asset number is only filled after the transfer of a complete source file of main assets.)
● You can transfer balances and transactions that have already been posted:
○ With transfers at the end of a fiscal year, the following applies:
The accumulated acquisition cost (APC) and the accumulated depreciation values are transferred.
○ With transfers during the year, the following applies:
The accumulated APC and the accumulated depreciation values are transferred. In addition to this,
you also transfer the transactions starting from the beginning of the fiscal year up to the time of the
transfer date. By default, you also transfer the posted depreciation of the year of transfer up to the
time of the transfer date. But you have the option not to transfer the posted depreciation in the year of
transfer. In this case, you first perform the legacy data transfer (without depreciation values in the year
of transfer), and then you calculate and post the depreciation in the system. In this case, you select the
corresponding checkbox in the Make Company Code Settings app.
Note
When using the SAP S/4HANA Migration Cockpit, asset balances are updated automatically. No special
transfer for asset reconciliation accounts in G/L is needed.
Note
As of SAP S/4HANA Cloud 1902, customers with active company codes in the country USA (but not
customers who scoped US Corporate GAAP only) have to consider the following:
In order to fulfill the requirements of the mid-month convention, there is a different period control with 24
real calculation periods (instead of the previously used 12 periods). The change is only relevant for Asset
Accounting; the fiscal year variant used in the general ledger remains unchanged.
You have to take the new system behavior into account when specifying the useful life in the asset master
data. Example: In previous releases, you would have entered 4 years and 5 periods (representing 5 months)
for the useful life; now you have to enter 4 years and 10 periods instead.
Restrictions
External number assignment for assets is not supported. All asset classes must have internal number
assignment.
Prerequisites
Mapping Instructions
Level Name
2 Inventory
2 Time-Dependent Data
2 Allocations
2 Origin
2 Leasing
2 Depreciation Areas
2 Cumulative Values
2 Posted Values
2 Transactions
2 CountrySpecific
2 CountrySpecific - Time-dependent
● You have made the Customizing settings for the relevant depreciation areas. These settings determine
which data is accepted from the upload file. The upload is only successful if the values are compatible with
the depreciation area settings.
Here are some examples:
○ Per default, acquisition values must be positive, whereas depreciation values must be negative.
○ Acquisition values should be greater than the depreciation values (considering the absolute values).
It would be incorrect to enter an acquisition value of 3,000 with a depreciation value of -10,000.
○ Only for real depreciation areas do you need to specify transfer values in accordance with the settings
of the depreciation areas. You do not specify values for derived depreciation areas.
If a depreciation is defined to take over acquisition values from other depreciation areas (for example,
areas 15, 31, and 33 take over values from areas 01 and 32), and you enter values in the upload file
anyway, the system will ignore these values.
○ If you have parallel currencies, you must consider the following:
You can decide whether you want to transfer your historical foreign currency values or if you want to
have these values translated automatically instead.
If you do not specify any historical foreign currency values, then the system executes an automatic
translation; the exchange rate is then determined as follows:
○ For accumulated values at the start of the year: With the exchange rate on the capitalization date
of the fixed asset
○ For transactions during the year: With the exchange rate on the date of the legacy data transfer
○ For open items on a line item-managed fixed asset under construction (transaction type 900
and/or 910): With the exchange rate on the date of the legacy data transfer (as with a transaction
during the year)
If you want to transfer historical foreign currency values for the parallel currency areas, specify them
for the legacy data transfer. The system responds to this by not translating anything.
Note
In the XML template, make sure that you enter your historical foreign currency values consistently
in the Cumulated Values and Posted Values worksheets.
● Make sure that all your asset classes are assigned to the correct number range interval before you start
migrating the fixed assets into your system.
● The offsetting account for the legacy data transfer (asset balance sheet account) must be defined in
Customizing for Asset Accounting under Define Offsetting Account for Legacy Data Transfer.
You either use the default setting or you contact the SAP Service Center team.
● You have created a legacy data transfer segment and for it you have specified the transfer date, the
document type and the legacy data transfer status in the Make Company Code Settings app.
● If you want to perform a transfer during the year, you must enter the Last Period Posted
(FAA_DEPR_PERIOD) field on the Posted Values sheet.
You must specify the last posted depreciation period (from the legacy system) for each asset. The system
requires this information to determine the first period for the depreciation that should be posted in the SAP
system.
● Make sure that the configuration settings in the Q system are the same as in the P system.
Pretest
We recommend that you perform a pretest in the test system: First, test system settings by performing a
manual legacy data transfer.
After this, you prepare the Microsoft Excel template and fill it with sample assets only (for example, one asset
per asset class). After the test, you should ideally clear the data from the test system:
● For asset master data, you can set a deactivation date to prevent the assets from receiving postings in the
future.
● You reverse the transfer postings.
● You check if the system contains any values for assets.
The productive system must not contain data before the data transfer.
Tasks
Post-Processing
In order to ensure that the legacy data transfer was carried out completely, you reconcile the data in the SAP
system with the data in your legacy system. You must reconcile the legacy data transfer and the corresponding
lists for documentation purposes before you release the SAP system for running operations in Asset
Accounting. This is because you may no longer be able to generate the corresponding lists later with only the
values from the legacy data transfer.
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Display Asset
Asset Balances
Note
You should also check the G/L balances.
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
When uploading the migration template, the system posts the asset values. We recommend the following: If
incorrect transfer values were posted, you should reverse the journal entry and then enter the transfer values
again. You can only change transfer values by reversing the posted transfer document and making a new
posting. For the asset master data already created, you set a deactivation date and block it from receiving
postings. In the productive system, there should be no data before you start the file upload.
Further Information
Product Assistance
For more information, see the SAP Help Portal. Choose the your SAP S/4HANA system, and navigate to
Asset Accounting Legacy Data Transfer .
Further Links
● Fixed asset (incl. balances and transactions) (deprecated): Available Fields per Asset Class
● For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your
data migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/
4HANA Cloud (for customers and partners only).
● SAP Note 2427888 – Balance carryforward is required during legacy data transfer to AA in the first fiscal
year
● SAP Note 2208321 – FAQ for legacy data transfer in SAP_FIN 720 and subsequent releases
Purpose
With this migration object, you perform a legacy data transfer for asset master records.
Business Object Definition A fixed asset is an object, a right, or another item owned by
the enterprise that is intended for long-term use, and can be
identified individually in the balance sheet.
If you want to transfer both, asset master data and transaction data, you proceed as follows:
1. You transfer the asset master data with this migration object:Fixed asset - Master data
2. You transfer the transaction data with migration object Fixed asset - Postings [page 155].
In Scope
Supported Features
● General
● Origin
● Allocations
● Account Assignment
● Valuation
● Time-Based Valuation
Note
As of SAP S/4HANA Cloud 1911, countryspecific fields are supported for the following countries:
● Russia
● Japan
● Portugal
● China
● India
You use the SAP S/4HANA Migration Cockpit to transfer legacy data asset master records.
When you want to transfer asset subnumbers, you need to consider the following:
● Asset subnumbers must be migrated within the same migration project. (This is due to the projectspecific
mapping table of the main asset number.)
● Asset subnumbers must be transferred in a separate file. (Reason: The mapping table for main asset
number is only filled after the transfer of a complete source file of main assets.)
Restrictions
External number assignment for assets is not supported. All asset classes must have internal number
assignment.
The transfer of assets under construction (AUC) that are integrated with investment measures is not
supported. Data for AUC and WBS must be transferred manually in a consistent manner, and the information
must be linked afterwards.
Prerequisites
Mapping Instructions
Level Name
1 General (mandatory)
2 Origin
2 Inventory
2 Allocations
2 Origin
2 Account Assignment
2 Valuation
2 Time-Based Valuation
2 Country-Spec.
2 Country-Spec. - TDD
Dependencies: If you use the Country-Spec. - TDD for Val. sheet in the migration template, you must also fill in
the Valuation sheet.
● Make sure that all your asset classes are assigned to the correct number range interval before you start
migrating the fixed assets into your system.
● You have created a legacy data transfer segment, and you have specified the transfer date, the document
type and the legacy data transfer status for it in the Make Company Code Settings app.
● Make sure that the configuration settings in the Q system are the same as in the P system.
Required Activities
We recommend that you perform a pretest in the test system: First, test system settings by performing a
manual legacy data transfer.
For master records, you can use the Manage Legacy Assets app.
After this, you prepare the Microsoft Excel template and fill it with sample assets only (for example, one asset
per asset class). After the test, you should ideally clear the data from the test system:
For asset master data, you can set a deactivation date to prevent the assets from receiving postings in the
future.
The productive system must not contain data before the data transfer.
Tasks
Post-Processing
To ensure that the legacy data transfer was carried out completely, you reconcile the data in the SAP system
with the data in your legacy system. You must reconcile the legacy data transfer and the corresponding lists for
documentation purposes before you release the SAP system for running operations in Asset Accounting. This
is because you may no longer be able to generate the corresponding lists later with only the values from the
legacy data transfer.
Asset Balances
Note
You should also check the G/L balances.
When uploading the migration template, the system transfers the asset master records. If incorrect data has
been transferred, we recommend the following: For the asset master data already created, you set a
deactivation date and block it from receiving postings.
In the productive system, there should be no data before you start the file upload.
Further Information
Application help (product assistance) under Asset Accounting Legacy Data Transfer .
Purpose
With this migration object, you perform a legacy data transfer for transaction data in asset accounting (asset
values).
In Scope
Supported Features
● Posting Key
● Cumulative Values
● Posted Values
● Posting Headers
● Transactions
● Proportional Values
You use the SAP S/4HANA Migration Cockpit to transfer legacy data for asset transactions.
● You can transfer balances and transactions that have already been posted:
○ With transfers at the end of a fiscal year, the following applies:
The accumulated acquisition cost (APC) and the accumulated depreciation values are transferred.
○ With transfers during the year, the following applies:
The accumulated APC and the accumulated depreciation values are transferred. In addition to this,
you also transfer the transactions starting from the beginning of the fiscal year up to the time of the
transfer date. By default, you also transfer the posted depreciation of the year of transfer up to the
time of the transfer date. But you have the option not to transfer the posted depreciation in the year of
transfer. In this case, you first perform the legacy data transfer (without depreciation values in the year
of transfer), and then you calculate and post the depreciation in the system. In this case, you select the
corresponding checkbox in the Make Company Code Settings app.
● You can also transfer quantities:
○ To transfer quantities, you use the Posting Headers sheet in the migration template.
○ If an opening balance for an asset needs to be posted as a quantity, the Assignment Number field
needs to be filled with the string STARTQUANTITY. Please note the following:
○ Only one such an entry is allowed per asset.
○ Apart from the key fields, the field Base Unit of Measure must be filled as well.
Example
You want to post the quantity 5 pieces as opening balance quantity for the fiscal year of the legacy
transfer.
Quantity = 5
● You use this migration object and its migration template to post accumulated data for amount values as
well as quantity. In either case, you need to transfer the master data beforehand with the Fixed asset -
Master data [page 151] migration object.
Note
When using the SAP S/4HANA Migration Cockpit, asset-related G/L account balances are updated
automatically. No special transfer for asset reconciliation accounts in G/L is needed.
Note
Customers with active company codes in the country USA (but not customers who scoped US Corporate
GAAP only) have to consider the following:
To fulfill the requirements of the mid-month convention, there is a different period control with 24 real
calculation periods (instead of the 12 periods previously used). The change is only relevant for Asset
Accounting; the fiscal year variant used in the general ledger remains unchanged.
You have to take the new system behavior into account when specifying the useful life in the asset master
data. For example: In previous releases, you would have entered 4 years and 5 periods (representing 5
months) for the useful life; now you have to enter 4 years and 10 periods instead.
Restrictions
The transfer of assets under construction (AUC) that are integrated with investment measures is not
supported. Data for AUC and WBS must be transferred manually in a consistent manner, and the information
must be linked afterwards.
Mapping Instructions
Level Name
2 Cumulative Values
2 Posted Values
2 Posting Headers
2 Transactions
2 Proportional Values
● You have made the configuration settings for the relevant depreciation areas. These settings determine
which data is accepted from the upload file. The upload is only successful if the values are compatible with
the depreciation area settings.
Here are some examples:
○ Per default, acquisition values must be positive, whereas depreciation values must be negative.
○ Acquisition values should be greater than the depreciation values (considering the absolute values).
It would be incorrect to enter an acquisition value of 3,000 with a depreciation value of -10,000.
○ Only for real depreciation areas do you need to specify transfer values in accordance with the settings
of the depreciation areas. You do not specify values for derived depreciation areas.
○ If you have parallel currencies, you must consider the following:
You can decide whether you want to transfer your historical foreign currency values or if you want to
have these values translated automatically instead.
If you do not specify any historical foreign currency values, then the system executes an automatic
translation; the exchange rate is then determined as follows:
○ For accumulated values at the start of the year: With the exchange rate on the capitalization date
of the fixed asset
○ For transactions during the year: With the exchange rate on the date of the legacy data transfer
○ For open items on a line item-managed fixed asset under construction (transaction type 900
and/or 910): With the exchange rate on the date of the legacy data transfer (as with a transaction
during the year)
If you want to transfer historical foreign currency values for the parallel currency areas, specify them
for the legacy data transfer. The system responds to this by not translating anything.
In the migration template, make sure that you enter your historical foreign currency values
consistently in the Cumulated Values and Posted Values worksheets.
● The offsetting account for the legacy data transfer (asset balance sheet account) must be defined.
This is done in the Manage Your Solution app under Configure Your Solution Finance Asset
Accounting Configure Asset Accounting Assign General Ledger Accounts . In this configuration step
(SSCUI), you have to make sure, that the Offsetting Account for Legacy Data Transfer (KTLDT) is set, the
default account is 39913000.
● You have created a legacy data transfer segment and for it you have specified the transfer date, the
document type and the legacy data transfer status in the Make Company Code Settings app.
● If you want to perform a transfer during the year and you want to transfer the posted depreciation, you
must enter the Last Period Posted (FAA_DEPR_PERIOD) field on the Posted Values sheet.
You must specify the last posted depreciation period (from the legacy system) for each asset. The system
requires this information to determine the first period for the depreciation to be posted in the SAP system.
● Make sure that the configuration settings in the Q system are the same as in the P system.
Required Activities
Pretest
We recommend that you perform a pretest in the test system: First, test system settings by performing a
manual legacy data transfer.
After this, you prepare the Microsoft Excel migration template and fill it with sample assets only (for example,
one asset per asset class). After the test, you should ideally clear the data from the test system:
● For asset master data, you can set a deactivation date to prevent the assets from receiving postings in the
future.
● You reverse the transfer postings.
● You check if the system contains any values for assets.
The productive system must not contain data before the data transfer.
Post-Processing
To ensure that the legacy data transfer was carried out completely, you reconcile the data in the SAP system
with the data in your legacy system. You must reconcile the legacy data transfer and the corresponding lists for
documentation purposes before you release the SAP system for running operations in Asset Accounting. This
is because you may no longer be able to generate the corresponding lists later with only the values from the
legacy data transfer.
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Asset Balances
Depreciation Lists
Asset Transactions
Note
You should also check the G/L balances.
When uploading the migration template, the system posts the asset values. We recommend the following: If
incorrect transfer values were posted, you should reverse the journal entry and then enter the transfer values
again. You can only change transfer values by reversing the posted transfer document and making a new
posting.
In the productive system, there should be no data before you start the file upload.
Migration object documentation for Fixed asset - Master data [page 151].
Application help (product assistance) under Asset Accounting Legacy Data Transfer .
Purpose
A maintenance task list is the generic term for all task lists
that are used in plant maintenance.
In Scope
Supported Features
Prerequisites
Business objects that reference this object must be created within the correct validity period for this object.
If a successor object is created with a validity period that starts before the validity period of this object, it will
normally cause an error message during the creation or migration of the successor object.
You therefore have to check such time dependencies before you create or migrate your objects. This will avoid
subsequent error messages and inconsistent data on your database.
Mapping Instructions
Internal/External number range assignment for Group Counter with control parameter CTR_TLIST_T_NUM –
you have to decide if it is internal or external during each data load.
Level Name
2 Operations (mandatory)
3 Production resource/tools
3 Material components
3 Maintenance packages
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
1. L-Stock item
2. N-Non-stock item
3. T-Text item
Out of Scope
1. Sub-items
2. Document assignment
3. Long Text
1. R-Variable-size item
2. K-Class item
Supported Features
● BOM Header
● BOM Item
Prerequisites
Mapping Instructions
Level Name
2 BOM item
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition An organizational unit in logistics that structures the mainte
nance objects of a company according to functional, proc
ess-oriented, or spatial criteria.
Supported Features
Prerequisites
Business objects that reference this object must be created within the correct validity period for this object.
If a successor object is created with a validity period that starts before the validity period of this object, it will
normally cause an error message during the creation or migration of the successor object.
You therefore have to check such time dependencies before you create or migrate your objects. This will avoid
subsequent error messages and inconsistent data on your database.
Mapping Instructions
Level Name
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
A maintenance task list is the generic term for all task lists
that are used in plant maintenance.
In Scope
Supported Features
Business objects that reference this object must be created within the correct validity period for this object.
If a successor object is created with a validity period that starts before the validity period of this object, it will
normally cause an error message during the creation or migration of the successor object.
You therefore have to check such time dependencies before you create or migrate your objects. This will avoid
subsequent error messages and inconsistent data on your database.
Mapping Instructions
● The Group and Group Counter must be provided in source file, and joint with task list type to distinguish
different type of task list. For the scenario of one Group with several Group Counters, they must be grouped
logically in the source file.
Level Name
2 Operations (mandatory)
3 Production resource/tools
3 Material components
3 Maintenance packages
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
For this migration object, the Custom Fields and Logic app is available. If you enhance your business object
with custom fields in the app, these custom fields will automatically be reflected in the XML template of the
corresponding migration object. See SAP Note 2726010 for further details.
Every time you add, change or delete a custom field, the migration project must be updated and a new
migration XML template must be downloaded and used. Thus, if custom fields are added or changed by an
application expert during migration testing, this must be communicated to and coordinated with your data
migration team. Also see the Extensibility section in the SAP S/4HANA Cloud documentation.
Purpose
Business Object Definition G/L account balance: The balance of a G/L account is the
amount resulting from the difference between the debit and
credit balances of the account. There are two types of bal
ance:
In Scope
Out of Scope
Supported Features
● Header
● G/L Account Item
● Currency Item
Prerequisites
Before starting with the initial data transfer, you must define an overall migration key date for each company
code. This migration key date will be used for all migration objects which are posting into financial accounting,
except for the Fixed asset - Postings [page 155] object.
Use the Define Settings for Legacy Data Transfer app to maintain these settings:
● Set the Migration Key Date for each required company code
● Set the Legacy Data Transfer Status:
○ In Preparation: migration key date is still unclear (Migration of transactional data is not possible)
○ Ongoing: required for the initial data transfer (Migration of transactional data is possible)
○ Completed: after successful finish of the initial data transfer (Migration of transactional data is not
possible)
Dependencies
Please in keep in mind that no documents will be migrated. Only balances and open items will be taken over.
Clear as many of the open items payable, receivables, taxes and outgoing checks as possible from the
accounts in the source system. By reducing these open items, you will reduce the amount of variables,
resulting in a lower possibility of error as well as reducing the amount of reconciliation needed to verify the data
migration.
Normally, no items or balances from the tax accounts need to be migrated because they are usually balance
zero (for normal VATs) when the migration takes place. We assume that the tax transfer has already been done
and therefore no tax has to be migrated. Exception: Deferred taxes can be migrated with the migration
activities for Open items payable and Open items receivable.
Mapping Instructions
● Enter only one line per document post into the migration file. The offsetting entry will be automatically
generated for the offsetting G/L account.
● The combination of key fields Company Code + Ledger Group + Reference Document Number + Line Item
Number + G/L Account are used for duplicate check. Data records with this combination should be unique
in the migration template. Otherwise, the migration tool will display a duplicate error message. The Line
Item Number will just be used as an additional key field and will not be migrated.
● Please be aware you must fill and save value amounts in the migration file in number and not in string
format. Check the settings for a delimiter.
● For migration, the posting keys will be controlled by the sign in the amount fields. The sign for negative
values should be set at the beginning:
○ A negative value will use posting key 50 (Credit entry) for G/L Account and 40 (Debit entry) for
Offsetting G/L Account
Keep the second local/group currency field and related amount empty in the template. In this case, the amount
will be automatically calculated by valid exchange rates in the system.
The exchange rate will be determined using the document date provided.
Two approaches for CO account assignment for an account that is relevant to cost
accounting:
Provide the required CO account assignment via migration template.
Define configuration of automatic CO assignment on accounts: Manage Your Solution Configure Your
Solution Finance | General Settings | Journal Entry ; Manage Default Account Assignment step. Please note,
if this required CO object is not provided via template, the default CO assignment will be used automatically for
migration.
Level Name
Tasks
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Further Information
For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your data
migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/4HANA Cloud
(for customers and partners only).
Purpose
This object loads the historical balance for general ledger ac
counts without any complex plausibility checks into the uni
versal journal with zero effects. This means that these balan
ces will automatically be reversed on the predefined migra
tion key date in order to have a zero balance. The migrated
historical balances are intended as an approach for report
ing. It is not possible to view the migrated documents them
selves.
In Scope
Out of Scope
Supported Features
Before starting with the initial data transfer, you must define an overall migration key date for each company
code. This migration key date will be used for all migration objects which are posting into financial accounting,
except for the Fixed asset - Postings [page 155] object.
Use the Define Settings for Legacy Data Transfer app to maintain these settings:
● Set the Migration Key Date for each required company code
● Set the Legacy Data Transfer Status:
○ In Preparation: migration key date is still unclear (Migration of transactional data is not possible)
○ Ongoing: required for the initial data transfer (Migration of transactional data is possible)
○ Completed: after successful finish of the initial data transfer (Migration of transactional data is not
possible)
Mapping Instructions
● Choose the required migration approach for historical balances in Migration Cockpit via the Import method
for historical balances parameter:
○ Balance Carry Forward (BCF): Post the accumulated balance at the end of each period and reverse the
balance of the previous period.
○ Next Period Movement (NPM): Post the initial cumulative balance in the first period and the
subsequent movements at the end of each following period. The cumulative balance will be increased
or reduced by the amount of the subsequent movements and will be automatically reversed in the
period of the migration key date which is predefined via the Define Settings for Legacy Data Transfer
app.
● Enter only one line per document post for each period into the migration file. The offsetting entry will be
generated automatically to ensure the balance is zero. You don't need to reverse any data as this uploaded
data wasn't posted.
● Please be aware you must fill and save value amounts in the migration file in number and not in string
format. Check the settings for a delimiter.
● For migration, the debit/credit indicator will be controlled by the sign in the amount fields. Do not use
different signs (positive and negative) within same record. The sign for negative values should be set at the
beginning:
○ A positive value will post a debit entry (S)
○ A negative value will post a credit entry (H)
● Fiscal year and period must be before the migration key date. Postings after this key date are not allowed.
● Currency and amount:
○ All currency amount fields in the migration template are mandatory. The amounts will not be derived
automatically.
○ Transaction/document currency is mandatory. Local/company code currency and group currency are
optional and will be derived automatically by the customizing settings maintained in system. An error
Level Name
1 Item (mandatory)
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
Supported Features
Prerequisites
Mapping Instructions
Level Name
Tasks
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition Description of the quality inspection process for materials in
a plant
In Scope
Supported Features
Prerequisites
Business objects that reference this object must be created within the correct validity period for this object.
If a successor object is created with a validity period that starts before the validity period of this object, it will
normally cause an error message during the creation or migration of the successor object.
You therefore have to check such time dependencies before you create or migrate your objects. This will avoid
subsequent error messages and inconsistent data on your database.
Mapping Instructions
2 - Valuation
Level Name
2 Operations (mandatory)
3 Inspection Characteristics
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
Supported Features
Prerequisites
Mapping Instructions
● During migration, you can choose via control parameter whether the inspection setup data should be taken
from the source file or if it should be taken from the default which is defined in the system.
Level Name
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition A detailed list of all objects in stock at a specific time, result
ing from a physical inventory (stocktaking process).
In Scope
Note
If you've activated the Third-Party Warehouse Management System Integration (1ZQ) scope item,
download the respective Set-up instructions from SAP Best Practices Explorer and carefully follow the
instructions. You must migrate the inventory balances before you assign the warehouse number to the
plant/storage location. Otherwise, the initial entry of inventory data will always create an inbound delivery
and the posting date will always be set to the current date by the system, and the posting date won't be
derived via the Define Settings for Legacy Data Transfer app. Material documents would only be posted to
SAP S/4HANA Cloud if the deliveries have been processed in the decentralized warehouse management
system and the confirmation messages have been received by SAP S/4HANA Cloud.
See the Set-up instructions of the Third-Party Warehouse Management System Integration (1ZQ) scope
item.
For Extended Warehouse Management please use the Warehouse stock [page 127] migration object.
Note
For special stock indicators ‘O’ and ‘V’, the stock can only be posted in Unrestricted use stock.
Note
For Vendor consignment stock, please provide special stock indicator ‘K’ and the vendor.
For Customer consignment stock, please provide special stock indicator ‘W’and the customer.
For Returnable packaging stock, please provide special stock indicator ‘V’ and the customer.
For Parts provided to vendor stock, please provide special stock indicator ‘O’ and the vendor.
For Orders on hand, please provide special stock indicator ‘E’ and the sales order with the corresponding
item
For Project stock, please provide special stock indicator ‘Q’ and the WBS element
For Materials which are serial managed, please provide for each serial number one item with quantity 1.
Out of Scope
Supported Features
Prerequisites
Before starting with the initial data transfer, you must define an overall migration key date for each company
code. This migration key date will be used for all migration objects which are posting into financial accounting,
except for the Fixed asset - Master data [page 151] object.
● Set the Migration Key Date for each required company code
● Set the Legacy Data Transfer Status:
○ In Preparation: migration key date is still unclear (Migration of transactional data is not possible)
○ Ongoing: required for the initial data transfer (Migration of transactional data is possible)
○ Completed: after successful finish of the initial data transfer (Migration of transactional data is not
possible)
● Product [page 277]: If you don't provide the external amount for the stock load the system will calculate
the value with the material prices defined in the material master in the accounting data. Please ensure in
that case that the price data provided in the material master is accurate.
● Batch (if Batch is unique at material level) [page 22] (otherwise the system will create the batch
automatically during stock posting).
Note
In the case of single batch valuation you have to migrate the batches with a valid valuation category
assigned before you can post inventory. In this case we do not allow automatic creation of the batch
and the valuation category during inventory posting.
● Supplier [page 386]/Customer [page 79] (only relevant for special stock: K – vendor consignment , V –
Returnable packaging with customer, and O - Parts provided to vendor)
● WBS element (only relevant for special stock Q - Project stock)
● Purchasing info record with conditions [page 294] with info category Consignment (only relevant for
vendor consignment stock)
Mapping Instructions
General Information
You can use the Technical Item Number field on the Material Document Item sheet itself to determine the
numbers of items posted according to the unique identifier entered on the Material Document Header sheet.
SAP recommends that you structure the document with a maximum of 1000 records per document.
Note
The Technical Item Number field on the Material Document Item sheet and the Technical Document Number
on the Material Document Header sheet are not mapped to a target field.
Mapping of the Batch Number field on the Material Document Item sheet
You want to post stock for a material that is defined by its valuation category as a material valuated in single
batches. In this case you have to provide a valid batch. The valuation category must be assigned in the batch
itself.
● The price and type of price control defined in the accounting data of the material master record
● Whether or not you provide a value for the quantity entered:
For a material valuated at a standard price, the initial entry of inventory data is valuated on the basis of the
standard price. If you provide an alternative value in the External Amount in Local Currency field, the
system posts the difference to a price difference account.
For a material valuated at moving average price, the initial entry of inventory data is valuated as follows:
○ If you enter a value when entering initial data, the quantity entered is valuated at this price. If the
quotient of the value and the quantity of the initial data differs from the moving average price, the
moving average price changes when initial data is entered.
○ If you do not enter a value when entering initial data, the quantity entered is valuated at the moving
average price. In this case, the moving average price does not change.
Level Name
Tasks
Post-Processing
Trial Balance
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Further Information
● For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your
data migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/
4HANA Cloud (for customers and partners only).
● Find FAQs relating to this migration object in SAP Knowledge Base Article 2813720 .
Purpose
Business Object Component/Area Joint Venture Accounting for Oil and Gas (CA-JVA)
In Scope
Supported Features
Mapping Instructions
Level Name
2 Equity groups
2 General overhead
2 Payroll burden
2 CI penalties
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Component/Area Joint Venture Accounting for Oil and Gas (CA-JVA)
In Scope
Out of Scope
Supported Features
Prerequisites
Level Name
1 Partner (mandatory)
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Business Object Component/Area Joint Venture Accounting for Oil and Gas (CA-JVA)
Business Object Definition If a partner, or equity group or cost object is suspended, cut
back postings are not executed. When you remove the
project, partner, cost object or equity group from suspense,
cutback processes all expenses incurred during suspense.
Suspended partners do not receive an invoice. When part
ners are removed from suspense, they receive an invoice
that includes expenses for the complete period of suspense.
Suspense:
Unsuspense:
In Scope
Out of Scope
1. Partner
2. Equity group
3. Projects
4. Ventures
5. Orders
Prerequisites
Note
The organizational structure and master data of the company must have been created in the system during
activation. The organizational structure reflects the structure of the company.
Mapping Instructions
Level Name
Tasks
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Component/Area Joint Venture Accounting for Oil and Gas (CA-JVA)
Suspense:
Unsuspense:
In Scope
Out of Scope
1. Partner
2. Equity group
3. Cost Centers
4. Projects
5. Orders
Supported Features
Note
The organizational structure and master data of the company must have been created in the system during
activation. The organizational structure reflects the structure of the company.
Level Name
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Component/Area Joint Venture Accounting for Oil and Gas (CA-JVA)
Business Object Definition If a partner, or equity group or cost object is suspended, cut
back postings are not executed. When you remove the
project, partner, cost object or equity group from suspense,
then cutback processes all expenses incurred during sus
pense. Suspended partners do not receive an invoice. When
partners are removed from suspense, they receive an invoice
that includes expenses for the complete period of suspense.
Suspense:
Unsuspense:
In Scope
1. JV Project in Suspense
Out of Scope
1. Partner
Supported Features
● JV Project in Suspense
Prerequisites
Note
The organizational structure and master data of the company must have been created in the system during
activation. The organizational structure reflects the structure of the company.
Mapping Instructions
Level Name
1 JV Project in suspense
Tasks
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Component/Area Joint Venture Accounting for Oil and Gas (CA-JVA)
In Scope
Out of Scope
Supported Features
● Joint Venture
● Joint Venture Description
● Equity Group Assignment
● Equity Group JV Level
● Equity Group JV level - Partner Share
● Equity Group - Cross Company Venture
● Equity Group - Substitute Cost Object
● Equity Group JV Level - Funding Currency
Mapping Instructions
Level Name
Tasks
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition An organizational unit within a controlling area that repre
sents a defined location of cost incurrence.
In Scope
● Main Data
● Basic Data
● Control
● Organizational Units
● Budget Availability Control
● Address
● Communication
● Joint venture
Prerequisites
Business objects that reference this object must be created within the correct validity period for this object.
If a successor object is created with a validity period that starts before the validity period of this object, it will
normally cause an error message during the creation or migration of the successor object.
You therefore have to check such time dependencies before you create or migrate your objects. This will avoid
later error messages and inconsistent data on your database.
Mapping Instructions
Level Name
The more detailed and accurate an address, the better the tax jurisdiction code will be determined by Vertex.
For some addresses, Vertex will always provide more than one tax jurisdiction code. In this case, you will have to
maintain this record manually or provide a correct tax jurisdiction code within the template.
If there is a field available in the migration object template to provide the correct tax jurisdiction within the
record, then fill this field with the correct code and start the transfer again with this new file.
Hierarchy area
Cost center groups entered in the KHINR/Hierarchy area field must be assigned to the standard hierarchy. If
this is not the case, you will get the error message Cost Center Group cannot be used.
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Further Information
For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your data
migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/4HANA Cloud
(for customers and partners only).
Purpose
Business Object Definition Business object that is used to manage the lifecycle of legal
content as part of a business transaction or a business sce
nario.
In Scope
1. Header Data
2. Entity Data
3. Internal Contact Data
4. External Contact Data
5. Linked Objects Data
6. Renewal and Termination Data
7. Relationship Data
8. Date Data
9. Categories Data
Out of Scope
Supported Features
● Header
● Entity
● Internal Contact
● External Contact
● Linked Objects
● Renewal and Termination
● Relationship
● Date
● Categories
Prerequisites
Mapping Instructions
Level Name
1 Header (mandatory)
2 Entity
2 Internal Contact
2 External Contact
2 Linked Objects
2 Relationship
2 Date
2 Categories
The more detailed and accurate an address, the better the tax jurisdiction code will be determined by Vertex.
For some addresses, Vertex will always provide more than one tax jurisdiction code. In this case you will have to
maintain this record manually.
If there is a field available in the Migration object template to provide the correct tax jurisdiction within the
record, then fill this field with the correct code and start the transfer again with this new file.
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
For information regarding the used API see SAP Note 1348099 .
Purpose
Business Object Definition A unit in a controlling area that classifies the activities per
formed in a cost center.
In Scope
Supported Features
● Basic Data
● Indicator
● Output
Prerequisites
If you set the TESTRUN flag, the migration will be simulated but no data will be posted to the system.
Level Name
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
In Scope
Out of Scope
1. Multi-Counter plans
2. Cycle information for strategy plans:
This is taken from the Maintenance Strategy object
3. Data transfer for settlement rule of maintenance plan item
4. Data transfer for object list item of maintenance plan item
5. Data transfer for individual accounting and location data:
This taken from the Reference object, where this exists
Supported Features
● Maintenance Plan
● Maintenance Item
Mapping Instructions
● During migration you can choose between internal and external number assignment for the maintenance
plan. The Maintenance Item Number will be generated by the system during creation.
● The difference between a single cycle plan and a strategy plan is made via the STRATfield (blank or filled).
Level Name
Tasks
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Caution
A prerequisite for this object (previously named Material commodity code) to be visible is that either the
Intrastat Processing (BDT) or the SAP Global Trade Services Integration - Primary Master Data (1WA) scope
item is activated. Refer to the Set-up instructions on SAP Best Practices Explorer for BDT and/or 1WA
to activate the respective scope item.
Purpose
In Scope
Supported Features
Prerequisites
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Restriction
● To migrate material consumptions please use the new Product consumption [page 275] migration
object.
Purpose
In Scope
Supported Features
● Forecast values
Prerequisites
Mapping Instructions
Restrictions
You can migrate several org. levels for a specific material with one migration template of a specific project.
Tasks
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
Note
With this migration object you can extend existing material by new org levels (for example plant, sales org,
or storage location) once per migration project.
A material view, such as Accounting or Costing, contains fields of different org levels (for example basic,
plant, or accounting data). It is therefore not recommended to enhance a material by a different material
view.
Note
The valuation data is a prerequisite for loading the stocks with the Material inventory balance [page
184] migration object, as the system will calculate the values of the stock posting with the price data
provided in the material master.
6. Sales data
7. Descriptions data
8. Units of Measure data
In this view you can maintain Alternative Units of Measure
9. Tax Classifications
In this view you can maintain the tax data (from Sales Org Data 1) and the tax indicator for material
(Purchasing)
For tax data (Sales) please provide the country, the tax category and the tax classification. If you have more
than one tax category for a country, please use the Tax category 2/Tax classification 2 fields and further on,
use the Tax classification sheet to provide the additional tax data.
For the tax indicator for material (Purchasing), please enter the value in the Tax indicator for material field
on the Tax classification sheet for the country relating to your plant.
10. Warehouse Number data
11. Storage Type data
12. Production Resource Tool (PRT) Fields in the Material Master
13. Data Transfer for Forecast Values
Out of Scope
Supported Features
● Basic Data
Prerequisites
Mapping Instructions
Basic Data
On the Basic Data sheet we only offer fields which might become relevant when you migrate a new
organizational unit. This can be the case, for example when you migrate a new plant including purchasing
relevant data (like purchasing group). Then the Order Unit field on the Basic Data sheet might also become
relevant to provide a value.
Please consider: You can't transfer a value in one of the fields provided on the Basic Data sheet which has
already a value in the related material master. It's not allowed to change already existing values in the related
material master: Therefore you can use the Manage Mass Maintenance – Products app. For further information,
refer to the online documentation of the Manage Mass Maintenance – Products app.
Example: In SAP standard delivery, material status 01 is configured in such a way that, during the posting of
inventory, you'll get an error message. Consider that when you assign the status, the use of the material can be
restricted. Depending on the status, the system issues either a warning message or an error message for
follow-on postings. Therefore, we recommend that you consider this field carefully so that you won't run into
follow-on problems during the data migration process. You can easily set the content of these fields after the
initial data migration using the Manage Mass Maintenance – Products app.
For further information, refer to the online documentation of the Manage Mass Maintenance – Products app.
Single Batch Valuation enables you to valuate stocks of material for each batch in a different way. You can use it
if you want to keep the price and value of each individual batch in inventory management on a value basis.
To work with valuation for a single batch, you must choose valuation category X - for Automat. Batch. Please
provide this on the Accounting Data sheet in the Valuation Category field.
Note
You need to manage the material itself in batches. Therefore you have to provide the Batch management
requirement indicator on the Basic Data sheet.
If you use the single batch valuation for your material, you have to enter the valuation records as follows:
You have to define a valuation header record with specified valuation category X, an initial valuation type and a
dependent record for each valuation type (one valuation type for each batch) with its own price information.
Note
For the valuation header record only price control 'V' - moving average price is possible. For the dependent
records for each valuation type, you can choose between moving average price or standard price.
Level Name
2 Plant Data
3 Forecast Parameters
2 Accounting Data
2 Sales Data
2 Material Descriptions
2 Tax Classification
1. The maintenance status will automatically be detected by the system for the fields used. In our example,
the Purchasing Group is available for the Purchasing view E and the MRP view D. The maintenance status
will therefore be DE for this field. This procedure will be followed for all mapped fields, after which a
combined maintenance status for all fields will be available, for example: BELV.
2. You, yourself define the views to be created via the Maintenance Status Settings worksheet/tab of your
migration object template. Here, you define a name for your view definition in the Material Views field, for
example, PLANT_HAWA to define the maintenance status for the plantspecific data for materials of that
type, which will be extended. For each view that you want to create, you must enter an x in the specific
Material Views column of that worksheet/tab, for example: PLANT_HAWA
○ Sales Data = X
○ Purchasing Data = X
○ MRP Data = X
○ Storage Data =X
○ Accounting Data = X
You fill out the Material Views field on the Plant Data worksheet/tab with PLANT_HAWA for all trading goods
materials of type HAWA, which you want to extend. You always have to provide values for both fields. As a
result, only the selected views are created for these materials.
Note
If you maintain the status using method 2, only the selected views will be created.
For example: You maintain the status for Sales Data (V) but not for Accounting Data (B). You maintain
values for fields on the Accounting Data worksheet/tab. As a result, the status for the Accounting view will
not be set.
● If you want to create a material with a specific Purchasing Group, the system will determine the
Purchasing view and the MRP view to be filled. However, you do not want to maintain the fields in the
MRP view.
Solution: In this case, you also have to provide values for some mandatory fields like Availability Check
and MRP Type in the MRP view. To avoid this, choose method 2 and select only the Purchasing view as a
view to be created.
● You want to automatically have the Storage Location view created for a material and its storage location
by migrating its inventory stock.
Solution: You need to explicitly set the maintenance status for the Storage Location (L) on the Plant
Data level (also refer to SAP Note 62913 ).
Tasks
Post-Processing
Follow-On Activities
You can use the Material - extend existing record with long text [page 227] migration object to migrate material-
related long texts
You can use the Material - Forecast planning [page 217] migration object to migrate material consumptions and
forecast values (only supported for on premise).
Purpose
Business Object Definition You can use this migration object to classify products for le
gal control. This includes the assignment of control classes
and control groupings as well as the setting of the control
relevance.
In Scope
Out of Scope
It is not possible to maintain the validity start and validity end of the product classification. The validity is
derived from the control class.
Supported Features
● Legal Regulation
● Control Classes (if used in the template)
● Control Groupings (if used in the template)
Mapping Instructions
Level Name
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
International Trade
Purpose
Business Object Definition You can create different long texts for a material. The key for
long texts is built with text object, text name, text ID and lan
guage key. The text object and text name are provided by the
migration object itself. The text ID defines the various types
of texts relating to a text object. The following table defines
which combinations are permitted for material long texts.
In Scope
Supported Features
Prerequisites
Mapping Instructions
Level Name
1 Material (mandatory)
Tasks
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition The material master record of a material variant is linked to
the configurable material and configured using the charac
teristics of the configurable material. This variant of the con
figurable material can then be manufactured and kept in
stock.
In Scope
1. In SAP S/4HANA Cloud, we only support the data migration to Advanced Variant Configuration (AVC).
2. Class type variants (300) is supported.
3. Multiple values and negative values are allowed for characteristic value
Supported Features
● Basic Data
● Characteristic Valuation
Prerequisites
Mapping Instructions
Level Name
2 Characteristic Valuation
Tasks
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition Material determination enables you to carry out the follow
ing tasks during sales order processing:
In Scope
● General Data
Prerequisites
Mapping Instructions
Level Name
Please refer to the field tooltips of the template file for further information.
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
Note
The valuation data is a prerequisite for loading the stocks with the Material inventory balance [page
184] migration object as the system will calculate the values of the stock posting with the price data
provided in the material master.
In the case of Single Batch Valuation, please follow the mapping instructions provided.
7. Sales Data
8. Description Data
In this view, you can maintain additional descriptions (for languages other than those provided on the Basic
Data sheet).
9. Units of Measure Data
In this view, you can enter Alternative Units of Measure (provide only the Base Unit of Measure on the Basic
Data sheet).
10. Tax Classifications
In this view, you can maintain the Tax data (from Sales Org Data 1) and the Tax indicator for material
(Purchasing).
For Tax Data (Sales), provide the country, the tax category and the tax classification. If you have more than
one tax category for a country, use the Tax category 2/Tax classification 2 fields and, further on, the Tax
classification sheet to provide the additional tax data.
For Tax indicator for material (Purchasing), enter the value in the Tax indicator for material field on the Tax
classification sheet for the country relating to your plant.
11. Maintenance Status Settings (maintain the views for your materials).
For more details, see the Maintenance Status Settings section under Mapping Instructions below.
12. Warehouse Number Data
13. Storage Type Data
14. Production Resource Tool (PRT) Fields in the Material Master
15. Data Transfer for Forecast Values
16. Data for Quality Management
17. Additional EANs
Out of Scope
Data migration doesn’t trigger the replication or the communication arrangement of the product
master via Data Replication (DRF). Nevertheless, you can replicate your product master after all
product master records have been migrated. This can be done with the following apps:
○ Use the Replicate by Object Selection app to specify the product numbers to be replicated and to
execute the replication.
○ Use the Replicate by Replication Model app if many product numbers need to be replicated with
the respective filter criteria, if needed.
For details about the apps, check the related SAP S/4HANA Cloud product assistance on SAP Help
Portal:
○ Replicate by Object Selection
○ Replicate by Replication Model
Supported Features
● Basic Data
● Plant Data
● Storage Location Data
● Accounting Data
● Sales Data
● Description Data
● Unit of Measure Data
● Tax Classification Data
● Forecast Parameters
Prerequisites
Mapping Instructions
● Be aware of the defined length set for the material number in the system. Do not convert a material
number to a new number longer than the defined length set.
If you want to set the indicator material as configurable for materials with other material types assigned (not
KMAT), you have to enter this indicator on the Basic Data sheet in the Material is configurable field.
If your material is managed in batches, set the Batch management requirement indicator under Multiple View
Data on the Basic Data sheet of the migration template. If you fill out this field, the system will set the Batch
management requirement indicator automatically for all plants defined on the Plant Data sheet for this material.
This is applicable for all plants that are not flagged with the Batch Management not active by default indicator in
the SSCUI .
Example: in SAP standard delivery, the material status 01 is configured in such a way that, during posting of
inventory, you will receive an error message. Consider that by assigning this status, the use of the material can
be restricted. Depending on the status, the system issues either a warning message or an error message for
follow-on postings. Therefore, SAP recommends that you consider this field carefully so that you will not run
into follow-on problems during the data migration process. You can easily set the content of these fields after
the initial data migration, using the Manage Mass Maintenance – Products app.
The Master Data Specialist for Product Data business role (SAP_BR_PRODMASTER_SPECIALIST) provides you
with several tiles to manage and start the Manage Mass Maintenance – Products app. The app can be launched
from the SAP Fiori launchpad. You can import a file with changed data (supported formats are Comma-
Separated Values (CSV) and Office Open XML spreadsheet (XLSX). You have to provide the following details:
Note
For further information, refer to the online documentation of the Manage Mass Maintenance – Products
app.
Single Batch Valuation enables you to valuate stocks of material for each batch in a different way. You can use it
if you want to keep the price and value of each individual batch in inventory management on a value basis.
To work with valuation for a single batch, you must choose valuation category X - for Automat. Batch. Provide
this on the Accounting Data sheet in the Valuation Category field.
Note
The material itself needs to be managed in batches, therefore you have to provide the Batch management
requirement indicator on the Basic Data sheet.
If you use the single batch valuation for your material, you have to enter the valuation records as follows:
● You have to define a valuation header record with specified valuation category X, and an initial valuation
type and a dependent record for each valuation type (one valuation type for each batch) with the
respective price information.
For example:
Note
For the valuation header record, only price control V - moving average price is possible. For the dependent
records for each valuation type, you can choose between moving average price or standard price.
Level Name
2 Plant Data
3 Forecast Parameters
2 Accounting Data
2 Sales Data
2 Material Descriptions
2 Additional EANs
2 Tax Classification
As well as the organizational-dependent data, the material master data is also organized via so called views
(Basic, Purchasing, Accounting view, and so on). These views are represented as tabs in your SAP Fiori app and
as material master transactions (MM01, MM02, MM03) in the on-premise system. Fields can be assigned to
multiple views. The Purchasing Group field, for example, is assigned to both the Purchasing and the
Manufacturing views. Each view may have different mandatory fields to maintain. A view is assigned a specific
letter. For example, the MRP view has the letter D whereas the Basic Data view has letter K assigned. A
combination of letters, that represents the available views for a specific material, is stored in a field called
Maintenance Status. The maintenance status can be defined differently for the following sheets in the
Administrative Data field group of the migration object template:
● Basic Data
● Plant Data
You always have to provide the material maintenance status, we do not support an automatic maintenance
status determination.
There are two different procedures to define the maintenance status that should be available for a specific
material:
1. You, yourself, define the views to be created via the Maintenance Status Settings worksheet/tab of your
migration object template.
○ Here, you define a name for your view definition in the Material Views field. For example:
○ BASIC_HAWA to define the overall maintenance status for material of the type trading goods
(Handelsware, HAWA) and
○ PLANT1_HAWA to define the maintenance status for the plantspecific data for materials of that
type (for plant PLANT1).
○ PLANT2_HAWA to define the maintenance status for the plantspecific data for materials of that
type (for plant PLANT2).
○ For each view you want to create, you must enter an X in the specific Material Views column of that
worksheet/tab.
○ For example: BASIC_HAWA
○ Basic Data = X
○ Sales Data = X
○ Purchasing Data = X
○ MRP Data = X
○ Storage Data = X
○ Accounting Data = X
○ For example: PLANT1_HAWA
○ Sales Data = X
○ Accounting Data = X
○ For example: PLANT2_HAWA
○ Purchasing Data = X
More details on the maintenance status can be found in SAP Note 2145027 .
Note
If you maintain the status using method 1 or 2, only the selected views will be created.
For example: You maintain the status for Basic Data (K) and Sales Data (V), but not for Accounting Data (B).
You maintain values for fields on the Accounting Data worksheet/tab. As a result, the status for the
Accounting view will not be set.
Additional examples:
● If you want to create a material with a specific Purchasing Group, the system will determine the Purchasing
view and the MRP view to be filled. However, you do not want to maintain the fields in the MRP view.
Solution: In this case, you also have to provide values for some mandatory fields like Availability Check and
MRP Type on the MRP view. To avoid this, choose procedure 2 or 3, and select only the Purchasing view as a
view to be created.
● You want to automatically have the Storage Location view created for a material and its storage location by
migrating its inventory stock.
Tasks
Post-Processing
Follow-On Activities
You can use the Material - extend existing record with long text [page 227] migration object to migrate material
related long texts.
You can use the Material - Forecast planning [page 217] migration object to migrate material consumptions and
forecast values (only supported for on-premise solution).
You can use the Product classification - Commodity code [page 215] migration object to migrate product
classification with commodity code.
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
● For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your
data migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/
4HANA Cloud (for customers and partners only).
● Find FAQs relating to this migration object in SAP Knowledge Base Article 2811788 .
Purpose
Business Object Definition During migration of material master, the system will create
the accounting data (prices and values) for the company
code currency. For other deviant currencies (for example,
group currency) the system converts the currency using the
current exchange rate defined in the system. If this is not the
original price, you can use this migration object to change
the price for the other deviant currencies.
Note
The system will post a price change document and, if
stock of the material exists, a revaluation posting will be
created.
In Scope
Supported Features
● Material
● Valuation Area
● Price Data
● Prices
Prerequisites
Mapping Instructions
Level Name
Tasks
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition Memo Record is used by cash manager to log the expected
outgoing and incoming payments that are not logged into
the SAP system via various postings.
In Scope
Supported Features
If the source symbol for planning level is BNK (Bank Accounting) for example if planning level is AB, then in that
case Bank account should be existing in the system before creating memo record.
Mapping Instructions
Level Name
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Note
To open the EHS - Incident migration object in the SAP S/4HANA Migration Cockpit, the Industrial Hygienist
(SAP_BR_INDUSTRIAL_HYGIENIST) business role must be assigned to the relevant user.
Purpose
Business Object Definition You can use the EHS - Incident business object to record in
cidents that occur at your organization. You can record a de
scription of the events, when and where the incident occur
red, and which persons were involved. This business object
also allows you to record situations where an incident could
have occurred (near miss) and where any unsafe behavior or
condition could lead to an incident in the future (safety ob
servation).
In Scope
1. Notice of Violation
2. Investigation
3. Reports and documents
4. Tasks
5. Links to incidents
Supported Features
Prerequisites
● Locations
● Business Partners
Level Name
2 Group Data
2 Regulation Data
2 Person Data
3 Person Texts
3 Person Statement
Data
4 Person Statement
Texts
3 Injury/Illness Data
4 Injury/Illness Texts
Tasks
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Restriction
This migration object only supports the condition types and key combinations mentioned in the Supported
Combinations of Key Fields for Price Conditions file. For other condition types and key combinations,
please use the Condition record for pricing (general template) [page 54] migration object.
Purpose
Business Object Definition The term pricing is used broadly to describe the calculation
of prices (for external use by customers or vendors). Condi
tions represent a set of circumstances that apply when a
price is calculated.
Out of Scope
1. Sales conditions (see migration object Condition record for pricing in sales (restricted) [page 317])
Supported Features
● This migration object only supports the condition types and key combinations mentioned in the Supported
Combinations of Key Fields for Price Conditions file.
● For other key combinations you must use the Condition record for pricing (general template) [page 54]
migration object.
Prerequisites
Mapping Instructions
Level Name
2 Scales
For more information on how to fill the condition types and key combinations refer to the Supported
Combinations of Key Fields for Price Conditions file.
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Purchaser (SAP_BR_PURCHASER)
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Examples
Further Information
● For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your
data migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/
4HANA Cloud (for customers and partners only).
● This migration object only supports the condition types and key combinations mentioned in the Supported
Combinations of Key Fields for Price Conditions file. For other condition types and key combinations,
please use the Condition record for pricing (general template) [page 54] migration object.
Purpose
In Scope
● General Data
● Characteristic Control Indicators
● Assign Inspection Methods
● Assign Inspection Catalogs
● Long Texts
Prerequisites
Business objects that reference this object must be created within the correct validity period for this object.
If a successor object is created with a validity period that starts before the validity period of this object, it will
normally cause an error message during the creation or migration of the successor object.
You therefore have to check such time dependencies before you create or migrate your objects. This will avoid
subsequent error messages and inconsistent data on your database.
Mapping Instructions
Level Name
For each master inspection characteristic, there may be several languages here, but for each language, there is
only one text line in the source file.
The object will separate the text line into several lines automatically into the long texts for each language.
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Business Object Definition Customer Master enables you to manage Customer Data
and receive Just-In-Time requests from these customers.
In Scope
Supported Features
● Basic Data
● Destinations
● External Status Mapping
● Additional Reference text
Prerequisites
Mapping Instructions
2 Destinations
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Business Object Definition The package specification enables you to create a package
definition based on which package units can be created for
delivery.
In Scope
Supported Features
Prerequisites
Mapping Instructions
2 Slot Group
Tasks
Post-Processing
Follow-On Activities
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition Supply controls enable you to control the business process
ing of JIT calls received from customers.
In Scope
Supported Features
● Basic Data
● Tolerance
● Supply Control Description
Prerequisites
Level Name
2 Tolerance
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Tip
For this migration object, the Custom Fields and Logic app is available. If you enhance your business object
with custom fields in the app, these custom fields will automatically be reflected in the XML template of the
corresponding migration object. See SAP Note 2726010 for further details.
Every time you add, change or delete a custom field, the migration project must be updated and a new
migration XML template must be downloaded and used. Thus, if custom fields are added or changed by an
application expert during migration testing, this must be communicated to and coordinated with your data
migration team. Also see the Extensibility section in the SAP S/4HANA Cloud documentation.
Purpose
Business Object Definition Open items are those items that are not yet to be cleared.
In Scope
1. Restricted migration of deferred taxes: only invoice, debit memo, and credit memo are supported
Out of Scope
Supported Features
● Header
● G/L Account Item
● Vendor Item
● One-Time Account Data
● Tax Item
● Withholding Tax Item
● Currency Item
Prerequisites
Before starting with the initial data transfer, you must define an overall migration key date for each company
code. This migration key date will be used for all migration objects which are posting into financial accounting,
except for the Fixed asset - Postings [page 155] object.
Use the Define Settings for Legacy Data Transfer app to maintain these settings:
● Set the Migration Key Date for each required company code
● Set the Legacy Data Transfer Status:
○ In Preparation: migration key date is still unclear (Migration of transactional data is not possible)
○ Ongoing: required for the initial data transfer (Migration of transactional data is possible)
○ Completed: after successful finish of the initial data transfer (Migration of transactional data is not
possible)
Please bear in mind that no documents will be migrated. Only balances and open items will be taken over.
Clear as many of the open items payable, receivables, taxes and outgoing checks as possible from the
accounts in the source system. By reducing these open items, you will reduce the amount of variables resulting
in a lower possibility of error as well as reducing the amount of reconciliation needed to verify the data
migration.
From the tax accounts, no items and no balances would normally need to be migrated because they are usually
at balance zero (for normal VATs) when the migration takes place. We assume that the tax transfer has already
been done. Therefore, no tax has to be migrated. Exception: Deferred taxes can be migrated with the migration
activities for open items payable and open items receivable.
Mapping Instructions
● Enter only one line per document post into the migration file. The offsetting entry will be generated
automatically for the offsetting G/L account.
● The combination of key fields Company Code + Reference Document Number + Line Item Number + Vendor
Number are used for duplicate check. Data records with this combination should be unique in the
migration template. Otherwise, the migration tool will display a duplicate error message. The Line Item
Number will just be used as an additional key field and will not be migrated.
● Please be careful to fill and save value amounts in the migration file in number and not in string format.
Check the settings for a delimiter.
For migration, the posting keys are always derived based on the account type and on the special GL
indicator that is submitted in the line item. Additionally, the posting keys are controlled by the sign in the
amount fields. The sign for negative values should be set at the beginning:
○ A negative value will use posting key 31 (Invoice) for vendor and 40 (Debit entry) for Offsetting G/L
Account (only without special GL indicator).
○ A positive value will use posting key 21 (Credit memo) for vendor and 50 (Credit entry) for Offsetting
G/L Account (only without special GL indicator).
Note
During migration of credit memo line item, the Invoice Reference field will be automatically set by
the BAPI to 'V'. This is hard coded and can not be changed.
● The initial offsetting (transfer booking) accounts to be used in the open items and open balances migration
objects are described in the BH5 test script :
○ 39914000 (Initial FI-AR offset)
○ 39915000 (Initial FI-AP offset)
○ 39916000 (Initial other GL offset)
○ 39917000 (Initial other Open Item GL offset)
The sign of the tax amounts and tax base amounts must be opposite to the amounts of the vendor item.
If there is at least one deferred tax code in an invoice then full tax information including non-deferred taxes
should be provided in the migration template. This is necessary for a correct proportion calculation.
In the template, keep the second local/group currency field and the related amount empty. In this case, the
amount will be automatically calculated by valid exchange rates in the system.
The exchange rate will be determined using the provided document date.
In order to use this field, the following configuration must be predefined: Configure Your Solution Chart of
Accounts Define Alternative Reconciliation Accounts (search for ID 102631).
Level Name
Tasks
Post-Processing
Follow-On Activities
The total balance of all migration clearing accounts, which are used for the offsetting postings, must be zero.
Business Role (country specific for deferred tax): General Ledger Accountant for Malaysia
(SAP_BR_GL_ACCOUNTANT_MY)
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your data
migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/4HANA Cloud
(for customers and partners only).
Tip
For this migration object, the Custom Fields and Logic app is available. If you enhance your business object
with custom fields in the app, these custom fields will automatically be reflected in the XML template of the
corresponding migration object. See SAP Note 2726010 for further details.
Every time you add, change or delete a custom field, the migration project must be updated and a new
migration XML template must be downloaded and used. Thus, if custom fields are added or changed by an
application expert during migration testing, this must be communicated to and coordinated with your data
migration team. Also see the Extensibility section in the SAP S/4HANA Cloud documentation.
Purpose
Business Object Definition Open items are items that are not yet to be cleared.
In Scope
1. Restricted migration of deferred taxes: only invoice, debit memo, and credit memo are supported.
Supported Features
● Header
● G/L Account Item
● Customer Item
● One-Time Account Data
● Tax Item
● Withholding Tax Item
● Currency Item
Prerequisites
Before starting with the initial data transfer, you must define an overall migration key date for each company
code. This migration key date will be used for all migration objects which are posting into financial accounting,
except for the Fixed asset - Postings [page 155] object.
Use the Define Settings for Legacy Data Transfer app to maintain these settings:
● Set the Migration Key Date for each required company code
● Set the Legacy Data Transfer Status:
○ In Preparation: migration key date is still unclear (Migration of transactional data is not possible)
○ Ongoing: required for the initial data transfer (Migration of transactional data is possible)
○ Completed: after successful finish of the initial data transfer (Migration of transactional data is not
possible)
Dependencies
Please in keep in mind that no documents will be migrated. Only balances and open items will be taken over.
Clear as many of the open items payable, receivables, taxes and outgoing checks as possible from the
accounts in the source system. By reducing these open items, you will reduce the amount of variables resulting
in a lower possibility of error as well as reducing the amount of reconciliation needed to verify the data
migration.
From the tax accounts, no items and no balances would normally need to be migrated because they are usually
at balance zero (for normal VATs) when the migration takes place. We assume that the tax transfer has already
been done. Therefore, no tax has to be migrated. Exception: Deferred taxes can be migrated with the migration
activities for open items payable and open items receivable.
Mapping Instructions
● Enter only one line per document post into the migration file. The offsetting entry will be generated
automatically for the offsetting G/L account.
● The combination of key fields Company Code + Reference Document Number + Line Item Number + Vendor
Number are used for duplicate check. Data records with this combination should be unique in the
migration template. Otherwise, the migration tool will display a duplicate error message. The Line Item
Number will just be using as additional key field and will not be migrated.
● Please be careful to fill and save value amounts in the migration file in number and not in string format.
Check the settings for a delimiter.
For migration, the posting keys are always derived based on the account type and on the special GL
indicator that is submitted in the line item. Additionally, the posting keys are controlled by the sign in the
amount fields. The sign for negative values should be set at the beginning:
○ A negative value will use posting key 31 (Invoice) for vendor and 40 (Debit entry) for Offsetting G/L
Account (only without special GL indicator).
○ A positive value will use posting key 21 (Credit memo) for vendor and 50 (Credit entry) for Offsetting
G/L Account (only without special GL indicator).
Note
During migration of credit memo line item, the Invoice Reference field will be set automatically by
the BAPI to 'V'. This is hard coded and can not be changed.
Deferred Tax
For posting of an invoice with deferred taxes it is necessary to providea tax account, tax code, tax amount and a
tax base amount via the migration template.
The sign of the tax amounts and tax base amounts must be opposite to the amounts of the vendor item.
If there is at least one deferred tax code in an invoice, then full tax information including non-deferred taxes
should be provided in the migration template. This is necessary for a correct proportion calculation.
In the template, keep the second local/group currency field and the related amount empty. In this case, the
amount will be automatically calculated by valid exchange rates in system.
The exchange rate will be determined using the provided document date.
In order to use this field, the following configuration must be predefined: Configure Your Solution Chart of
Accounts Define Alternative Reconciliation Accounts (search for ID 102631).
Level Name
Tasks
Follow-On Activities
The total balance of all migration clearing accounts, which are used for the offsetting postings, must be zero.
To ensure this, the offsetting amounts for the migration clearing accounts must be balanced with the initial G/L
offsetting account for data migration. This can be done with the FI - G/L account balance and open/line item
[page 169] migration object.
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Business Role (country specific for deferred tax): General Ledger Accountant for Malaysia
(SAP_BR_GL_ACCOUNTANT_MY)
Further Information
For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your data
migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/4HANA Cloud
(for customers and partners only).
Purpose
Business Object Definition Enterprise projects serve as the basis for project planning,
execution and monitoring processes. For simple project sce
narios, the definition of general project data is sufficient. If a
hierarchical project structure is required, for example, for hi
erarchical project accounting purposes or more complex
project management requirements, work packages can be
created to form a project hierarchy.
In Scope
Prerequisites
Mapping Instructions
Fields in the Joint Venture Accounting (JVA) group must only be filled if the Joint Venture has been activated in
the system.
JVA fields are dependent on Company code. Hence, Company code is a mandatory field if JVA fields are
entered.
In order to migrate a project with JVA fields, Joint venture name, Recovery indicator, Equity type, and Object
type must be entered.
Tax Jurisdiction Code is dependent on Company code. Hence, Company code is a mandatory field if a Tax
Jurisdiction Code is entered.
Work Package
Work package ID must be unique across the system. Maintain only a positive (+ve) value in the Sort number
field.
Fields in the Joint Venture Accounting (JVA) group must only be filled if the Joint Venture has been activated in
the system.
JVA fields are dependent on Company code. Hence, Company code is a mandatory field if JVA fields are
entered.
In order to migrate a work package with JVA fields, Joint venture name, Recovery indicator, Equity type, and
Object type must be entered.
Tax Jurisdiction Code is dependent on Company code. Hence, Company code is a mandatory field if Tax
Jurisdiction Code entered.
Level Name
2 Work package
Tasks
Post-Processing
Project Builder
Project Control
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
In Scope
Supported Features
● Basic Data
● Indicator
● Address Data
● Communication
● Company Codes
Prerequisites
● Profit Center
● Controlling Area
● Valid from Date
● Valid to Date
● Profit Center Text
● Person Responsible
● Profit Center Group
Level Name
The LANGU field shows the language in which text is saved. The Profit Center name and description will be
saved according to the entry in the LANGU field. If the field is not completed, the text will be saved in the user
logon language as the default language. A profit center with a description in a different language is not
supported.
If Vertex is activated (especially on US installations) the tax jurisdiction code will be determined by the address.
If Vertex determines more than one tax jurisdiction code for a record, the migration of this record will fail. If this
happens, you have to provide a more detailed/accurate address, for example, US Postal codes with 9 digits
instead of 5 digits.
The more detailed and accurate an address, the better the tax jurisdiction code will be determined by Vertex.
For some addresses, Vertex will always provide more than one tax jurisdiction code. In this case, you will have to
maintain this record manually or provide a correct tax jurisdiction code within the template.
If there is a field available in the migration object template to provide the correct tax jurisdiction within the
record, then fill this field with the correct code and start the transfer again with this new file.
Hierarchy area
Profit center groups entered in the KHINR- Profit center group field must be assigned to the standard hierarchy.
If this is not the case you will get the error message Profit Center Group cannot be used.
Tasks
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Restriction
You can migrate several org. levels for a specific material with one migration template of a specific project.
If you have already migrated material consumptions (org. level view) and you want to extend those
materials by additional consumptions for a different plant, please create a new project and use a new
template.
Purpose
Business Object Definition A quantity usually updated by the system when a material is
withdrawn from the warehouse or stores, indicating how
much of the material has been used or consumed over a par
ticular past period.
In Scope
Supported Features
● Material
● Total Consumptions
● Unplanned Consumptions
Prerequisites
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
Note
The valuation data is a prerequisite for loading the stocks with the Material inventory balance [page
184] migration object as the system will calculate the values of the stock posting with the price data
provided in the product master if you don't provide the External Amount for loading the stocks.
In the case of Single Batch Valuation, please follow the mapping instructions provided.
7. Distribution Chain Data
8. Description Data
In this view, you can maintain additional descriptions (for languages other than those provided on the Basic
Data sheet).
9. Units of Measure Data
In this view, you can enter Alternative Units of Measure (provide only the Base Unit of Measure on the Basic
Data sheet).
10. Tax Classifications
In this view, you can maintain the Tax data (from Sales Org Data 1) .
Note
For the tax indicator for the product (purchasing), enter the value in the Tax Indicator field in the
Purchasing group on the Plant Data sheet for the country relating to your plant.
Out of Scope
11. Caution
Data migration doesn’t trigger the replication or the communication arrangement of the product
master via Data Replication (DRF). Nevertheless, you can replicate your product master after all
product master records have been migrated. This can be done with the following apps:
○ Use the Replicate by Object Selection app to specify the product numbers to be replicated and to
execute the replication.
○ Use the Replicate by Replication Model app if many product numbers need to be replicated with
the respective filter criteria, if needed.
For details about the apps, check the related SAP S/4HANA Cloud product assistance on SAP Help
Portal:
○ Replicate by Object Selection
○ Replicate by Replication Model
Supported Features
● Basic Data
● Material Descriptions
● Alternative Unit of Measure
● Additional EAN's
● Distribution Chains
● Tax Classification
● Plant Data
● Forecasting Data
● Storage Locations
● MRP Area
● Valuation Data
● Valuation Current Period
● Valuation Future Prices
Prerequisites
Mapping Instructions
● Be aware of the defined length set for the product number in the system. Do not convert a product number
to a new number longer than the defined length set.
● If the Product ID is to be used for integration with external systems, it can be switched on during migration.
In this connection, you must also maintain the Business System ID of your source system (to be used for
integration) in the Convert Values step, to ensure that the key mapping will be added to the central key
mapping store of the SAP S/4HANA system.
If your product is managed in batches, set the Batch management requirement indicator on the Basic Data
sheet of the migration template. If you fill out this field, the system will set the Batch management requirement
indicator automatically for all plants defined on the Plant Data sheet for this product. This is applicable for all
plants that are not flagged with the Batch Management not active by default indicator in the SSCUI .
Unit of Weight
If you want to migrate sales data for your product, the Unit of Weight field will be set to the default
automatically if it's assigned to the related Product group. If no default unit of weight is assigned to the Product
group, you have to provide the Unit of Weight field on the Basic Data sheet.
Example: in SAP standard delivery, the product status 01 is configured in such a way that, during posting of
inventory, you will receive an error message. Consider that by assigning this status, the use of the product can
be restricted. Depending on the status, the system issues either a warning message or an error message for
follow-on postings. Therefore, SAP recommends that you consider this field carefully so that you will not run
into follow-on problems during the data migration process. You can easily set the content of these fields after
the initial data migration, using the Manage Mass Maintenance – Products app.
The Master Data Specialist for Product Data business role (SAP_BR_PRODMASTER_SPECIALIST) provides you
with several tiles to manage and start the Manage Mass Maintenance – Products app. The app can be launched
from the SAP Fiori launchpad. You can import a file with changed data (supported formats are Comma-
Separated Values (CSV) and Office Open XML spreadsheet (XLSX). You have to provide the following details:
Note
For further information, refer to the online documentation of the Manage Mass Maintenance – Products
app.
Valuation Data
During migration, you have various possible ways in which to migrate your valuation data. If you only provide
your data on the Valuation Data sheet, the system will create the accounting data (prices and values) for the
company code currency. For other deviant currencies (for example, group currency), the system converts the
currency using the current exchange rate defined in the system. If this is not the original price for your deviant
Example
You provide the prices for company currency on the Valuation Data sheet only . The system will determine
the prices automatically for all deviant currencies, depending on the current exchange rate defined in the
system :
Inventory Inventory
Price Price
Product Valuation Valuation Valuation Price Moving Standard
Number Area Type Category ... Control Currency Average Price ...
Example
You provide the prices for company currency on the Valuation Data sheet and the prices for the deviant
currencies (for example, group currency with currency type 30) on the Valuation Current Period sheet and
on the Valuation Future Price sheet:
Inven Inven
tory tory
Price Price
Product Valuation Valuation Valuation Price Moving Standard
Number Area Type Category ... Control Currency Average Price ...
Inventory Inventory
Price Mov Price
Product Valuation Currency Price Con ing Aver Standard
Number Area ... Type trol Currency age Price ...
To work with valuation for a single batch, you must choose valuation category X - for Automat. Batch. Provide
this on the Valuation Data sheet in the Valuation Category field.
Note
The product itself needs to be managed in batches, therefore you have to provide the Batch management
requirement indicator on the Basic Data sheet.
If you use the single batch valuation for your product, you have to enter the valuation records as follows:
You have to define a valuation header record with specified valuation category X, and an initial valuation type
and a dependent record for each valuation type (one valuation type for each batch) with the respective price
information.
Example
Inventory Inventory
Price Price
Product Valuation Valuation Valuation Cur Price Moving Standard
Number Area Type Category rency... Control ... Average Price ...
Note
For the valuation header record, only price control V - moving average price is possible. For the dependent
records for each valuation type, you can choose between moving average price or standard price.
For the valuation header record, you can't provide Material Ledger prices on the Valuation Current Period or
Valuation Future Price sheets. This is only possible for the dependent type records with the valuation type
specified.
Inventory Inventory
Price Price
Product Valuation Valuation Valuation Currency Price Moving Standard
No. Area Type Category Type Control Currency Average Price Price unit
Level Name
2 Material Descriptions
2 Additional EANs
2 Distribution Chains
2 Tax Classification
2 Plant Data
3 Forecasting Data
3 Storage Locations
2 MRP Area
2 Valuation Data
Tasks
Post-Processing
Follow-On Activities
You can use the Material - extend existing record with long text [page 227] migration object to migrate material
related long texts.
You can use the Material - Forecast planning [page 217] migration object to migrate material consumptions and
forecast values (only supported for on-premise solution).
You can use the Product classification - Commodity code [page 215] migration object to migrate product
classification with commodity code.
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Display Material
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Further Information
● SAP Note 2726010 – Migration Cockpit: Support of custom fields (in-app extensibility)
Business Object Definition Key determining the various production techniques accord
ing to which a material is to be manufactured. You specify,
for example, the following in the production version:
In Scope
Supported Features
● General Data
Prerequisites
Business objects that reference this object must be created within the correct validity period for this object.
If a successor object is created with a validity period that starts before the validity period of this object, it will
normally cause an error message during the creation or migration of the successor object.
You therefore have to check such time dependencies before you create or migrate your objects. This will avoid
subsequent error messages and inconsistent data on your database.
Level Name
As the internal group number may be created from the object routing, in this condition, the system will map the
related internal number automatically if the external number has been provided in the template. However,
make sure the two objects routing and production version need to be used in the same project.
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Note
This migration object was renamed from CPM project to Commercial project.
Tip
For this migration object, the Custom Fields and Logic app is available. If you enhance your business object
with custom fields in the app, these custom fields will automatically be reflected in the XML template of the
corresponding migration object. See SAP Note 2726010 for further details.
Every time you add, change or delete a custom field, the migration project must be updated and a new
migration XML template must be downloaded and used. Thus, if custom fields are added or changed by an
application expert during migration testing, this must be communicated to and coordinated with your data
migration team. Also see the Extensibility section in the SAP S/4HANA Cloud documentation.
Purpose
Business Object Type Master data and transactional data (sales order)
In Scope
Migration of Commercial Projects in the following phases: In Planning, Contract Preparation, In Execution.
Out of Scope
Migration of Commercial Projects in phase: Completed or Closed. Project duration of more than 5 years is not
recommended. Projects with a longer duration decrease upload performance significantly.
The migration of customer projects (project type "C") and internal projects (project type "I") within a single
source file is not supported. Customer projects and internal projects must be migrated using separate source
files.
● Engagement Project
● Work Package
● Work Item
● Activity Planning
● Expense Planning
● Sales Order Header
● Sales Order Item
● Billing Plan Item
The Commercial project (the Engagement Project and Work Package parts) can be enhanced with the Custom
Fields and Logic app, adding custom fields in the application. If the Commercial project is enhanced in this way,
the custom fields will be reflected automatically in the XML template as well.
Note
Any time you add, change or delete a custom field, the migration project must be updated and a new XML
template must be downloaded and used. Thus, if custom fields are added, changed or deleted by an
application expert during migration testing, this must be communicated to and coordinated with data
migration.
Prerequisites
Mapping Instructions
Level Name
1 Engagement Project
(mandatory)
2 Work Package
3 Work Item
3 Plan Data
Tasks
Post-Processing
Customer Projects
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Further Information
● For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your
data migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/
4HANA Cloud (for customers and partners only).
● SAP Note 2726010 – Migration Cockpit: Support of custom fields (in-app extensibility)
● Professional Services – Customer Projects Migration blog series in the SAP S/4HANA Cloud Customer
Community
Purpose
Business Object Definition Public Sector Management (PSM) provides solution for
managing the budget of income and expenditure at public
institutions, records the execution of this budget and prevent
budget overruns.
In Scope
Supported Features
Mapping Instructions
Level Name
Post-Processing
or
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
1. Extend already existing purchasing info records with new purchasing organization, new purchasing info
record category or new plant. The following purchasing info categories are supported:
○ Standard
○ Consignment
○ Subcontracting
○ For purchasing info records to material groups, only the Standard and Consignment purchasing info
categories are supported.
2. General Data (only Legacy Number of purchasing info record, Material Number, Material Group and
Supplier's account number)
3. Purchasing Organization Data; when you create an Info Record you can choose the following options:
○ Purchasing info record which is only related to a purchasing organization. That means the price is the
same for all plants.
○ Purchasing info record which is related to a plant. That means the price can be different for each plant.
4. Conditions; the condition type indicates, for example, whether during pricing, the system applies a price, a
discount, a surcharge, or other pricing elements, such as freight costs and sales taxes. For each of these
pricing elements, there's a condition type defined in the system.
5. Scales
6. Purchasing Organization Text
Out of Scope
Supported Features
● General Data
● Purchasing Organization Data
Prerequisites
Mapping Instructions
● If you want to extend an existing purchasing info record with a material group and vendor, you need the
purchasing info record number. If you want to create a new info record number for the same combination,
please use the Purchasing info record with conditions [page 294] object.
● If you use the identical Legacy Number of purchasing info record in the objects Purchasing info record with
conditions [page 294] and Purchasing info record- extend existing record in the same project, then the
mapping of records takes place automatically. After migration of the purchasing info record with the
Purchasing info record with conditions [page 294] object, the info record number is stored in the migration
mapping table. The Purchasing info record- extend existing record object then uses this mapping value.
● If you have provided a different Legacy Number of purchasing info record in the Purchasing info record-
extend existing record object, you have to select the correct info record number in the Convert Values step
in the Mapping of Purchasing info record numbers mapping rule.
● If you have provided the newly created info record number in the Legacy Number of purchasing info record
field, you can check and confirm the Mapping of Purchasing info record numbers mapping rule in the
Convert Values step.
Level Name
2 Purchasing Organiza
tion Data
3 Conditions
4 Scales
3 Purchasing Organiza
tion Text
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Further Information
Find FAQs relating to this migration object in SAP Knowledge Base Article 2776897 .
Business Object Definition A source of information for the procurement of a certain ma
terial from a certain vendor.
In Scope
1. General Data; only to create info record with material specific or material group
The following Info Categories are supported:
○ Standard
○ Consignment
○ Subcontracting
2. General Text
3. Purchasing Organization Data; when you create an Info Record you can choose the following options:
○ Purchasing info record which is only related to a purchasing organization. That means the price is the
same for all plants.
○ Purchasing info record which is related to a plant. That means the price can be different for each plant.
4. Conditions; the condition type indicates, for example, whether during pricing, the system applies a price, a
discount, a surcharge, or other pricing elements, such as freight costs and sales taxes. For each of these
pricing elements, there is a condition type defined in the system.
5. Scales
6. Purchasing Organization Text
Out of Scope
1. Update Info Record is not supported; if an info record with a certain vendor and with a specific material
exists or with a material group, it is not possible to enhance this record with purchasing organization data.
Supported Features
● General Data
● General Text
● Purchasing Organization Data
Prerequisites
Mapping Instructions
Migration with identical combinations of material group and vendor leads to different purchasing info record
numbers. The combination of material number and vendor is always unique.
Level Name
2 General Text
2 Purchasing Organiza
tion Data
3 Conditions
4 Scales
3 Purchasing Organiza
tion Text
Tasks
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Further Information
● For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your
data migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/
4HANA Cloud (for customers and partners only).
● Find FAQs relating to this migration object in SAP Knowledge Base Article 2776897 .
Purpose
You can only migrate open purchase orders, that is, items which haven't been delivered and invoiced yet.
In Scope
1. Header Data
2. Header Address
3. Header Texts
4. Item Data; the following Item Categories are supported:
○ Standard
○ Third-Party
○ Enhanced Limits
○ Consignment
○ Subcontracting
5. Item Addresses
6. Item Account Assignments; the following Account Assignment categories are supported:
○ Cost Center
○ Asset
○ Sales Order
○ Project
○ Unknown
7. Item Schedule Lines
8. Purchase Order Item Components for Subcontracting
Note
If your ordered material is not a BOM, provide the relevant entries on the Schedule Line sheet and the
materials to be provided on the Components for Subcontracting sheet.
Note
If your ordered material is a BOM, the system will automatically generate the subcontracting
components. You can also provide the components manually on the Components for subcontracting
sheet.
9. Item Texts
Out of Scope
Supported Features
● Header Data
● Header Address
● Header Texts
● Item Data
● Item Addresses
● Item Account Assignments
● Item Schedule Lines
● Purchase Order Item Components for Subcontracting
● Item Texts
Prerequisites
Mapping Instructions
● During migration you can choose between internal and external number assignment for the purchasing
document. Item numbers will be migrated 1:1 from the data in the migration template.
● Consider: During migration there is no defaulting of values from existing purchasing info records.
Exceptional case: purchase order items with item category Consignment.
● Net Price: Please provide the price as manual price on item level. Migration of conditions for example -
discounts or surcharges - is not supported!
Level Name
2 Header Address
2 Header Texts
3 Item Address
3 Account Assignment
3 Schedule Line
3 Item Texts
Tasks
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
● 0: Action Reasons
● 1: Characteristic attributes
● 2: Tasks
● 5: Causes
● 8: Activities (QM)
● 9: Defect types
● A: Activities (PM)
● B: Object Parts
● C: Overview of damage
● D: Coding
● E: Defect Locations
● a characteristic attribute
● a defect type
● a usage decision
In Scope
Out of Scope
Mapping Instructions
Level Name
The object will separate the text line into several lines automatically into the long texts for each language.
Tasks
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
Supported Features
Business objects that reference this object must be created within the validity period that fits this object.
If a successor object is created with a validity period starting before this object, this will normally cause an error
message during the creation or migration of the successor object.
You therefore have to check such time dependencies before you create or migrate your objects. This will avoid
later error messages and inconsistent data on your database.
Mapping Instructions
Level Name
Tasks
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
● Lease-out
● Lease-in
● Service
1. General Data
2. Partners
3. Term Without Renewal and Notice Rules
4. Objects
5. Conditions
6. Posting Terms
7. Frequency Terms
8. Organization Assignment Terms
Out of Scope
1. Valuation Parameters
2. Adjustment
3. Resubmit
4. Overviews
5. Renewal Rules
6. Notice Rules
7. Adjustment Terms
8. Multiple Posting Terms on one Condition
9. Multiple Frequency Terms on one Condition
10. Multiple Main Partner Assignments
Supported Features
● General Data
● Partners
● Term
● Objects
● Conditions
● Posting
● Frequency
● Organizational Assignment
Business Partner
If you want to assign a partner in a vendor or customer role, you must first create the corresponding partner
and capture the number in the partner assignment structure.
If you want to use main contracts, you must first migrate them. The main contract is then available in the
conversion value and can be mapped to a second file, including any contracts referring to these main contracts.
As the jurisdiction-dependent tax is activated for a US company, the following structure and fields become
mandatory.
Level Name
2 Partners
2 Term (mandatory)
2 Objects
2 Conditions
2 Posting
2 Frequency
2 Organizational Assignment
Tasks
Follow-On Activities
Data which is not migrated, such as renewal and notice rules or organizational information, must be added
during post-processing.
The valuation process must also be part of post-processing, but handled separately, using another role
template (SAP_BR_RECM_VALSPECIALIST).
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
1.100 Routing
Purpose
In Scope
Tip
● For task list of type Q (Inspection Plan), use the QM - Inspection plan [page 180] migration object.
● For task list of type A (General Maintenance task list), use the PM - General maintenance task list [page
167] migration object.
● For task list of type E (Equipment Task List), use the PM - Equipment task list [page 112] migration
object.
● For task list of type T (Task List for Functional Location), use the PM - Functional location task list [page
161] migration object.
Out of Scope
Task list types other than those mentioned above aren't supported by the data migration content.
Supported Features
Prerequisites
Business objects that reference this object must be created within the correct validity period for this object.
You therefore have to check such time dependencies before you create or migrate your objects. This will avoid
subsequent error messages and inconsistent data on your database.
● For routing migration, for example, the validity period of costing view in work center must be within the
routing validity period, otherwise this will lead to an issue with the cost simulation run.
● For routing as an example, if the valid-from date on operational level starts earlier than the validity start
date of costing view in work center, this will lead to an issue with missing activity types in routing and no
cost being calculated in the cost simulation run.
Mapping Instructions
Note
The system doesn't support combining internal and external number ranges in one source file.
● The Valid-From Date will be the current date if no value is provided in the source file.
● The Valid-From Date for BOM must be earlier than the Valid-From Date of the Routing. Otherwise, the BOM
can't be expanded and it will return an error.
● The Numerator will be set to 1 if no value is provided in the source file.
● The Denominator will be set to 1 if no value is provided in the source file.
● The BOM Usage and BOM Application are only mandatory for component allocation.
○ The BOM Usage controls the selection of the relevant BOM in the component assignment.
○ The BOM Application, in connection with the BOM Usage, controls the selection of the correct
alternative BOMs.
● BOM Item Category, BOM Component, and BOM Component Description are just provided in the template
to help you allocate the component; this data may be copied from the BOM Data Migration file or from the
target system.
● The Indicator for Relevancy to Costing on Operation Level field is mandatory; with the following options:
○ If you want the Costing Relevancy to be copied from the Control Key on the target system, enter the
value D.
○ If you want the operation to be irrelevant to costing, enter the value N.
○ If you want to enter a value for this field, then the field should be populated with either X, or another
option, as required.
Long Text
If you create a long text in the dialog, then the current logon language will be taken as the long text language.
Level Name
2 Operations (mandatory)
3 Production resources/tools
3 Sub-operations
3 Component assignment
3 Inspection Characteristics
Tasks
Post-Processing
Follow-On Activities
It's mandatory to migrate all routing in the Q system first and run a cost simulation run in your Q system. Then,
verify the results and check for inconsistencies before starting the data migration into the productive system.
After data migration into the productive system, It's mandatory to run the cost simulation and validation steps
in that system as well.
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Further Information
For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your data
migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/4HANA Cloud
(for customers and partners only).
Purpose
Business Object Definition Sales Order (SD): A customer request to the company for
delivery of goods or services at a certain time. The request is
received by a sales area that is then responsible for fulfilling
the contract.
In Scope
Out of Scope
Supported Features
Prerequisites
Mapping Instructions
● The Sold-to Party and Ship-to Party on Header level must be provided in the Partner sheet using 0000 in
the Sales Document Item field.
● The total number of ordered items will be calculated based on the items in the schedule line data.
● During migration, you can choose between internal and external number assignment for the sales
document number and item numbers.
Level Name
1 Header (mandatory)
2 Item (mandatory)
2 Partner (mandatory)
Tasks
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
In Scope
Out of Scope
1. Scheduling agreements with document conditions (only time-dependent conditions are supported)
2. Creation of delivery schedule
Supported Features
Prerequisites
Level Name
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
This migration object only supports the condition types and key combinations mentioned in the Supported
Combinations of Key Fields for Price Conditions file. For other condition types and key combinations,
please use the Condition record for pricing (general template) [page 54] migration object.
Purpose
Business Object Definition The term pricing is used broadly to describe the calculation
of prices (for external use by customers or vendors). Condi
tions represent a set of circumstances that apply when a
price is calculated.
In Scope
1. Prices
2. Discounts
3. Surcharges
Out of Scope
1. Purchasing conditions (see migration object Condition record for pricing in purchasing (restricted) [page
248])
● This migration object only supports the condition types and key combinations mentioned in the Supported
Combinations of Key Fields for Price Conditions file.
● For other key combinations you must use the Condition record for pricing (general template) [page 54]
migration object.
Prerequisites
Mapping Instructions
Level Name
2 Scales
For more information on how to fill the condition types and key combinations refer to the Supported
Combinations of Key Fields for Price Conditions file.
Tasks
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Examples
● For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your
data migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/
4HANA Cloud (for customers and partners only).
● This migration object only supports the condition types and key combinations mentioned in the Supported
Combinations of Key Fields for Price Conditions file. For other condition types and key combinations,
please use the Condition record for pricing (general template) [page 54] migration object.
Purpose
Business Object Definition An outline sales agreement that contains special conditions
negotiated between the vendor and a customer, for example,
price, target value or target quantity. A sales contract is valid
for a specified period. A customer submits a sales order to
release products from the amount agreed in the contract.
Types of sales contract include value contracts and quantity
contracts.
In Scope
Supported Features
Prerequisites
Mapping Instructions
Level Name
2 Item (mandatory)
3 Item Partners
Tasks
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
Prerequisites
Mapping Instructions
Level Name
Text line in Selected set long texts: For each Selected set, there may be several languages here, but for each
language, there is only one text line in the source file. The object will separate the text line into several lines
automatically into the long texts for each language.
Tasks
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
Prerequisites
Mapping Instructions
Level Name
Tasks
Post-Processing
Purpose
In Scope
Supported Features
Mapping Instructions
Level Name
Template Structure
The template structure lists the minimum mandatory fields for creating a SEPA mandate in status 0 (entered).
For mandate status 1 (active), the following additional fields are mandatory:
Please refer to the tooltips field of the template file for further information.
Tasks
or
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Further Information
For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your data
migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/4HANA Cloud
(for customers and partners only).
Purpose
The source list lets you determine the source that is valid (ef
fective) at a certain time.
In Scope
Supported Features
Prerequisites
Business objects that reference this object must be created within the correct validity period for this object.
If a successor object is created with a validity period starting before this object, it will normally cause an error
message during the creation or migration of the successor object.
You therefore must check such time dependencies before you create or migrate your objects. This will avoid
subsequent error messages and inconsistent data on your database.
Level Name
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Business Object Definition Service contracts are outline agreements with business
partners and define the services offered for a particular pe
riod.
In Scope
Out of Scope
Service contracts that are processed in external systems will not be migrated to SAP S/4HANA.
Supported Features
● Header text
● Item
● Item condition
● Pricing elements
Mapping Instructions
Level Name
1 Header Data
2 Header Notes
2 Header Item
3 Item notes
Tasks
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition A customer request to the company for delivery of goods or
services at a certain time. The request is received by a serv
ice area responsible for fulfilling the service order or service
contract.
In Scope
Out of Scope
Supported Features
Prerequisites
Mapping Instructions
Level Name
1 Header (mandatory)
2 Item Mandatory
Tasks
Post-Processing
Follow-On Activities
For SAP S/4HANA Cloud on-premise related migration, validation of data can be done using the following app:
Purpose
In Scope
Out of Scope
1. Substance groups
2. Attachments
Supported Features
● Basic Data
● Company Specific Names
● Conditions
Listed substance must exist ( Manage Listed Substance app) and responsible unit must be configured
(Customizing).
Mapping Instructions
Level Name
2 Conditions
1. Migrate a substance linked to an existing listed substance using the following data from the migration
template:
○ Internal Number
○ Internal Name
○ Listed Substance
○ Responsible Unit
2. .
Migrate a substance linked to an new listed substance using the following data from the migration
template:
○ Internal Number
○ Internal Name
○ Listed Substance Name
○ CAS Number
○ EC Number
○ Molecular Formula
○ Responsible Unit
Tasks
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition Constraints maintained for a software material to define the
compatibility relationships between this software material
and other materials (such as a bill of materials). A software/
hardware constraint includes a constraint rule, materials
that have a compatibility relationship with the subject soft
ware material, and versions of the software material.
In Scope
● Software Material
Prerequisites
Mapping Instructions
Level Name
2 Constraint (mandatory)
Tasks
Post-Processing
Purpose
In Scope
1. Structure data
2. Condition
3. Single date
4. Collateral data
5. Administration data
6. Other flows data
7. Payment details data
Out of Scope
1. Cash flow
2. Memos
3. Analysis parameter
4. Partner assignment
5. Default risk limit
6. Status
● Structure
● Condition
● Single date
● Collateral
● Administration
● Other Flows
● Payment Details
0 - Regular 0 - Regular
2 - SingleDate 2 - SingleDate
Mapping Instructions
Level Name
1 Structure (mandatory)
2 Condition
3 Single date
2 Collateral
2 Administration(mandatory)
2 Other Flows
2 Payment Details
2 Long Text
Other Flows
1. There are two options when determining how to migrate other flows via the control parameter below. You
can control this during the run time.
Note
In this case, if you leave the Other Flow sheet empty, then the system determines the other flow
from configuration level.
Note
In this case, the system only takes the other flows from the excel template into account; these are
not related to configuration level.
Payment Details
1. There are two options when determining how to migrate payment details via the control parameter below.
You can control this during the run time.
2. Control Parameter: CTR_TR_PAYDET_C (Indicates whether entries in payment details are complete).
○ Not Complete (by default): means payment details are automatically created from standing
instructions (configuration level), but you can add additional payment details or change existing
payment details.
Note
In this case, if you leave the Payment Detail sheet empty, then the system determines the payment
detail from configuration level.
Note
In this case, the system only takes the payment details from the excel template into account; these
are not related to configuration level.
Tasks
Follow-on Activities
The Treasury Specialist – Back Office will find the apps for legacy data transfer on the launchpad under Utilities:
After the import of your financial transactions, the valuation-area-independent information such as quantity
information (for example, units, nominal amounts), the purchase value and cost are transferred.
Depending on your scenario, you might have to post the transactions to the general ledger. Even if you do not
have to post the transactions into the general ledger, you still mark the flows of the financial transactions as
posted. Use the Mark Flows as Posted app to do this.
The flows are indicated as being posted but are not actually posted. A posting log is generated.
The Mark Flows as Reversed app is also available, if needed, to set the flows as reversed:
The remaining valuation-area-dependent position component values are entered in the Legacy Data table using
the Enter Position Component Values app.
● Using the Execute Initial Load of Position Value app (OP: TPM63 Execute Data Transfer), enter the positions
component values in the Positions Management tables.
Should any errors occur, you can reverse the initial load using the Reverse Initial Load of Position Value app .
To check the values entered, you can display the positions component values with the Treasury Position
Reporting or Display Treasury Position Values apps or, available for the Treasury Accountant business role
(SAP_BR_TREASURY_ACCOUNTANT), with the Treasury Position Analysis app.
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
1. Structure data
2. Administration data
3. Data migration of contract activities
Out of Scope
Supported Features
● Structure Data
● Administration Data
Business objects that reference this object must be created within the correct validity period for this object.
If a successor object is created with a validity period starting before this object, it will normally cause an error
message during the creation or migration of the successor object.
You must therefore check such time dependencies before you create or migrate your objects. This will avoid
subsequent error messages and inconsistent data on your database.
Mapping Instructions
Level Name
Tasks
Post-Processing
Follow-on Activities
The Treasury Specialist – Back Office will find the apps for legacy data transfer on the launchpad under Utilities:
After the import of your financial transactions, the valuation-area-independent information such as quantity
information (for example, units, nominal amounts) the purchase value and cost are transferred.
The flows are indicated as being posted but are not actually posted. A posting log is generated.
The Mark Flows as Reversed app is also available, if needed, to set the flows as reversed:
The remaining valuation-area-dependent position component values are entered in the Legacy Data table using
the Enter Position Component Values app. Alternatively, use the SAP S/4HANA Migration Cockpit app to enter
the position values (see the TRM - Position value [page 370] migration object). If you do not know the financial
transaction number (because this number was generated during the migration of your financial transactions to
the SAP S/4HANA Cloud system), the migration cockpit can derive the financial transaction number if you can
fill one of the following fields or field combinations instead:
● Internal Reference
● Business Partner ID and External Reference
● Legal Basis (SAP S/4HANA Cloud preconfigured value 01) and External Trade ID
Note
These fields are available in the financial transaction data and should have been filled during the migration
of the financial transaction.
The migration cockpit searches for the corresponding financial transactions and enters the identified financial
transaction number in the Legacy Data Transfer table for position component values.
● Using the Execute Initial Load of Position Value app (OP: TPM63 Execute Data Transfer), enter the positions
component values in the Positions Management tables.
Should any errors occur, you can reverse the initial load using the Reverse Initial Load of Position Value app .
To check the values entered, you can display the positions component values with the Treasury Position
Reporting or Display Treasury Position Values apps or, available for the Treasury Accountant business role
(SAP_BR_TREASURY_ACCOUNTANT), with the Treasury Position Analysis app.
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
1. Structure data
2. Administration data
3. The object only supports the creation of contract activity
Out of Scope
Supported Features
● Structure Data
Business objects that reference this object must be created within the correct validity period for this object.
If a successor object is created with a validity period starting before this object it will normally cause an error
message during the creation or migration of the successor object.
You therefore must check such time dependencies before you create or migrate your objects. This will avoid
subsequent error messages and inconsistent data on your database.
Mapping Instructions
Level Name
Tasks
Post-Processing
Follow-on Activities
The Treasury Specialist – Back Office will find the apps for legacy data transfer on the launchpad under Utilities:
Depending on your scenario, you might have to post the transactions to the general ledger. Even if you do not
have to post the transactions into the general ledger, you still mark the flows of the financial transactions as
posted. Use the Mark Flows as Posted app to do this.
The flows are indicated as being posted but are not actually posted. A posting log is generated.
The Mark Flows as Reversed app is also available, if needed, to set the flows as reversed:
The remaining valuation area-dependent position component values are entered in the Legacy Data table using
the Enter Position Component Values app. Alternatively, use the SAP S/4HANA Migration Cockpit app to enter
the position values (see the TRM - Position value [page 370] migration object ). If you do not know the financial
transaction number (because this number was generated during the migration of your financial transactions to
S/4HANA Cloud system), the migration cockpit can derive the financial transaction number if you can fill one
of the following fields or field combinations instead:
● Internal Reference
● Business Partner ID and External Reference
● Legal Basis (SAP S/4HANA Cloud preconfigured value 01) and External Trade ID
Note
The fields are available in the financial transaction data and should have been filled during the migration of
the financial transaction.
The migration cockpit searches for the corresponding financial transactions and enters the identified financial
transaction number in the legacy data transfer table for position component values.
● Using the Execute Initial Load of Position Value app (OP: TPM63 Execute Data Transfer), enter the positions
component values in the Positions Management tables.
Should any errors occur, you can reverse the initial load using the Reverse Initial Load of Position Value app .
To check the values entered, you can display the positions component values with the Treasury Position
Reporting or Display Treasury Position Values apps or, available for the Treasury Accountant business role
(SAP_BR_TREASURY_ACCOUNTANT), with the Treasury Position Analysis app.
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
1. Structure data
2. Administration data
3. Migration of contract activities
4. Only the creation of financial transactions is considered, data transfer for ongoing transactions is not
supported.
Supported Features
● Structure Data
● Administration Data
Mapping Instructions
Level Name
2 Administration data
Tasks
Post-Processing
Follow-on Activities
The Treasury Specialist – Back Office will find the apps for legacy data transfer on the launchpad under Utilities:
After the import of your financial transactions, the valuation-area-independent information such as quantity
information (for example, units, nominal amounts), the purchase value, and cost are transferred.
Depending on your scenario, you might have to post the transactions to the general ledger. Even if you do not
have to post the transactions into the general ledger, you still mark the flows of the financial transactions as
posted. Use the Mark Flows as Posted app to do this.
The flows are indicated as being posted but are not actually posted. A posting log is generated.
The Mark Flows as Reversed app is also available, if needed, to set the flows as reversed:
The remaining valuation-area-dependent position component values are entered in the Legacy Data table using
the Enter Position Component Values app.
● Using the Execute Initial Load of Position Value app (OP: TPM63 Execute Data Transfer), enter the positions
component values in the Position Management tables
Should any errors occur, you can reverse the initial load using the Reverse Initial Load of Position Value app .
To check the values entered, you can display the positions component values with the Treasury Position
Reporting or Display Treasury Position Values apps or, available for the Treasury Accountant business role
(SAP_BR_TREASURY_ACCOUNTANT), with the Treasury Position Analysis app.
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
In Scope
1. Structure data
2. Migration of contract activities
3. Only the creation of financial transactions is considered, data transfer for ongoing transactions is not
supported.
Out of Scope
Supported Features
● Structure
Level Name
1 Structure (mandatory)
Tasks
Post-Processing
Follow-on Activities
The Treasury Specialist – Back Office will find the apps for legacy data transfer on the launchpad under Utilities:
After the import of your financial transactions, the valuation-area-independent information such as quantity
information (for example, units, nominal amounts), the purchase value and cost are transferred.
Depending on your scenario, you might have to post the transactions to the general ledger. Even if you do not
have to post the transactions into the general ledger, you still mark the flows of the financial transactions as
posted. Use the Mark Flows as Posted app to do this.
The flows are indicated as being posted but are not actually posted. A posting log is generated.
The Mark Flows as Reversed app is also available, if needed, to set the flows as reversed:
The remaining valuation-area-dependent position component values are entered in the Legacy Data table using
the Enter Position Component Values app.
● Using the Execute Initial Load of Position Value app (OP: TPM63 Execute Data Transfer), enter the positions
component values in the tables of the Position Management tables.
Should any errors occur, you can reverse the initial load using the Reverse Initial Load of Position Value app .
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
1. Structure data
2. Migration of contract activities
3. Only the creation of financial transactions is considered, data transfer for ongoing transactions is not
supported.
Supported Features
● Structure
Prerequisites
Mapping Instructions
Level Name
1 Structure (mandatory)
Tasks
Follow-on Activities
The Treasury Specialist – Back Office will find the apps for legacy data transfer on the launchpad under Utilities:
After the import of your financial transactions, the valuation area-independent information such as quantity
information (for example, units, nominal amounts), the purchase value and cost are transferred.
Depending on your scenario, you might have to post the transactions to the general ledger. Even if you do not
have to post the transactions into the general ledger, you still mark the flows of the financial transactions as
posted. Use the Mark Flows as Posted app to do this.
The flows are indicated as being posted but are not actually posted. A posting log is generated.
The Mark Flows as Reversed app is also available, if needed, to set the flows as reversed:
The remaining valuation-area-dependent position component values are entered in the Legacy Data table using
the Enter Position Component Values app.
● Using the Execute Initial Load of Position Value app (OP: TPM63 Execute Data Transfer), enter the positions
component values in the Positions Management tables
Should any errors occur, you can reverse the initial load using the Reverse Initial Load of Position Value app .
To check the values entered, you can display the positions component values with the Treasury Position
Reporting or Display Treasury Position Values apps or, available for the Treasury Accountant business role
(SAP_BR_TREASURY_ACCOUNTANT), with the Treasury Position Analysis app.
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
In Scope
1. Structure data
2. Administration data
3. Other flows data
4. Payment details data
5. Migration of contract activities
6. Only the creation of financial transactions is considered
Out of Scope
● Structure
● Administration
● Other Flows
● Payment Details
Mapping Instructions
Level Name
1 Structure (mandatory)
2 Administration (mandatory)
2 Other Flows
2 Payment Details
Other Flows
1. There are two options when determining how to migrate other flows via the control parameter below. You
can control this during the run time.
2. Control Parameter: CTR_TR_OTHERF_C (Indicates whether entries in other flows are complete).
○ Not Complete (by default): means other flows are automatically created from standing instructions
(configuration level), but you can add additional other flows or change existing other flows.
Note
In this case, if you leave the Other Flow sheet empty, then the system determines the other flow
from configuration level.
Note
In this case, the system only takes the other flows from the excel template into account, these are
not related to configuration level.
Payment Details
1. There are two options when determining how to migrate payment details via the control parameter below.
You can control this during the run time.
2. Control Parameter: CTR_TR_PAYDET_C (Indicates whether entries in payment details are complete).
○ Not Complete (by default): means payment details are automatically created from standing
instructions (configuration level), but you can add additional payment details or change existing
payment details.
In this case, if you leave the Payment Detail sheet empty, then the system determines the payment
detail from configuration level.
Note
In this case, the system only takes the payment details from excel template into account, these are
not related to configuration level.
Tasks
Post-Processing
Follow-on Activities
The Treasury Specialist – Back Office will find the apps for legacy data transfer on the launchpad under Utilities:
After the import of your financial transactions, the valuation-area-independent information such as quantity
information (for example, units, nominal amounts), the purchase value and cost are transferred.
Depending on your scenario, you might have to post the transactions to the general ledger. Even if you do not
have to post the transactions into the general ledger, you still mark the flows of the financial transactions as
posted. Use the Mark Flows as Posted app to do this.
The flows are indicated as being posted but are not actually posted. A posting log is generated.
The Mark Flows as Reversed app is also available, if needed, to set the flows as reversed:
The remaining valuation-area-dependent position component values are entered in the Legacy Data table using
the Enter Position Component Values app. Alternatively, use the SAP S/4HANA Migration Cockpit app to enter
● Internal Reference
● Business Partner ID and External Reference
● Legal Basis (SAP S/4HANA Cloud preconfigured value 01) and External Trade ID
Note
These fields are available in the financial transaction data and should have been filled during the migration
of the financial transaction.
The migration cockpit searches for the corresponding financial transactions and enters the identified financial
transaction number in the Legacy Data Transfer table for position component values.
● Using the Execute Initial Load of Position Value app (OP: TPM63 Execute Data Transfer), enter the positions
component values in the Positions Management tables.
Should errors occur, you can reverse the initial load using the Reverse Initial Load of Position Value app.
To check the values entered, you can display the positions component values with the Treasury Position
Reporting or Display Treasury Position Values apps or, available for the Treasury Accountant business role
(SAP_BR_TREASURY_ACCOUNTANT), with the Treasury Position Analysis app.
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
In Scope
1. Structure data
2. Administration data
3. Conditions
4. Main flows
5. Other flows
6. Payment details
7. Only the creation of financial transactions is considered, data transfer for ongoing transactions is not
supported.
Out of Scope
Supported Features
● Structure
● Administration
● Conditions
● Main Flows
● Other Flows
● Payment Details
Level Name
1 Structure (mandatory)
2 Administration
2 Conditions
2 Main Flows
2 Other Flows
2 Payment Details
Conditions
1. There are two options when determining how to migrate conditions via the control parameter below. You
can control this during the run time.
2. Control Parameter: CTR_TR_COND_C (Indicates whether entries in conditions are complete).
○ Not Complete (by default): means conditions are automatically created from standing instructions
(configuration level), but you can add additional conditions or change existing conditions.
Note
In this case, if you leave the Condition sheet empty, then the system determines the condition from
configuration level.
Note
In this case, the system only takes the conditions from the excel template into account, these are
not related to configuration level.
Main Flows
1. There are two options when determining how to migrate main flows via the control parameter below.You
can control this during the run time.
2. Control Parameter:CTR_TR_MAINF_C (Indicates whether entries in main flows are complete).
○ Not Complete (by default): means main flows are automatically created from standing instructions
(configuration level), but you can add additional main flows or change existing main flows.
Note
In this case, if you leave the Main Flow sheet empty, then the system determines the main flow
from configuration level.
Note
In this case, the system only takes the main flows from the excel template into account, these are
not related to configuration level.
Note
In this case, if you leave the Other Flow sheet empty, then the system determines the other flows
from configuration level.
Note
In this case, the system only takes the other flows from the excel template into account, these are
not related to configuration level.
Payment Details
1. There are two options when determining how to migrate payment details via the control parameter below.
You can control this during the run time.
2. Control Parameter: CTR_TR_PAYDET_C (Indicates whether entries in payment details are complete).
○ Not Complete (by default): means payment details are automatically created from standing
instructions (configuration level), but you can add additional payment details or change existing
payment details.
Note
In this case, if you leave the Payment Detail sheet empty, then the system determines the payment
details from configuration level.
Note
In this case, the system only takes the payment details from the excel template into account, these
are not related to configuration level.
Tasks
Follow-on Activities
The Treasury Specialist – Back Office will find the apps for legacy data transfer on the launchpad under Utilities:
After the import of your financial transactions, the valuation area-independent information such as quantity
information (for example, units, nominal amounts,) the purchase value and cost is transferred.
Depending on your scenario, you might have to post the transactions to the general ledger. Even if you do not
have to post the transactions into the general ledger, you still mark the flows of the financial transactions as
posted. Use the Mark Flows as Posted app to do this.
The flows are indicated as being posted but are not actually posted. A posting log is generated.
The Mark Flows as Reversed app is also available, if needed, to set the flows as reversed
The remaining valuation area-dependent position component values are entered in the Legacy Data table using
the Enter Position Component Values app:
● Using the Execute Initial Load of Position Value app (OP: TPM63 Execute Data Transfer), enter the positions
component values in the Positions Management tables.
Should errors occur, you can reverse the initial load using the Reverse Initial Load of Position Value app .
To check the values entered, you can display the positions component values with the Treasury Position
Reporting or Display Treasury Position Values apps or, available for the Treasury Accountant business role
(SAP_BR_TREASURY_ACCOUNTANT), with the Treasury Position Analysis app.
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition An exchange transaction with a term of more than one year,
based on different interest rates using the same currency.
In Scope
1. Structure data
2. Administration data
3. The object only supports the creation of a contract activity
Supported Features
● Structure Data
● Administration Data
Business objects that reference this object must be created within the correct validity period for this object.
If a successor object is created with a validity period starting before this object it will normally cause an error
message during the creation or migration of the successor object.
You must therefore check such time dependencies before you create or migrate your objects. This will avoid
subsequent error messages and inconsistent data on your database.
Mapping Instructions
Level Name
● 1903011
Tasks
Post-Processing
Follow-on Activities
The Treasury Specialist – Back Office will find the apps for legacy data transfer on the launchpad under Utilities:
After the import of your financial transactions, the valuation-area-independent information such as quantity
information (for example, units, nominal amounts), the purchase value and cost are transferred.
Depending on your scenario, you might have to post the transactions to the general ledger. Even if you do not
have to post the transactions into the general ledger, you still mark the flows of the financial transactions as
posted. Use the Mark Flows as Posted app to do this.
The flows are indicated as being posted but are not actually posted. A posting log is generated.
The Mark Flows as Reversed app is also available, if needed, to set the flows as reversed
The remaining valuation area-dependent position component values are entered in the Legacy Data table using
the Enter Position Component Values app. Alternatively, you can use the SAP S/4HANA Migration Cockpit app
to enter the position values (see the TRM - Position value [page 370] migration object). If you do not know the
financial transaction number (because this number was generated during the migration of your financial
transactions to S/4HANA Cloud system), the migration cockpit can derive the financial transaction number if
you can fill one of the following fields or field combinations instead:
● Internal Reference
● Business Partner ID and External Reference
● Legal Basis (SAP S/4HANA Cloud preconfigured value 01) and External Trade ID
Note
The fields are available in the financial transaction data and should have been filled during the migration of
the financial transaction.
The migration cockpit searches for the corresponding financial transactions and enters the identified financial
transaction number in the Legacy Data Transfer table for position component values.
● Using the Execute Initial Load of Position Value app (OP: TPM63 Execute Data Transfer), enter the positions
component values in the Positions Management tables.
To check the values entered, you can display the positions component values with the Treasury Position
Reporting or Display Treasury Position Values apps or, available for the Treasury Accountant business role
(SAP_BR_TREASURY_ACCOUNTANT), with the Treasury Position Analysis app.
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition Valuation-area-dependent data for MM, FX, OTC transac
tions
In Scope
● Position Value
Prerequisites
To migrate the position value data, the financial transaction should exist in the system. This means that the
following objects should be migrated before the position object.
Mapping Instructions
Level Name
Enter the financial transaction number to import the position value data. If the transaction number is not
available (because this number was generated during the migration of your financial transactions to the SAP
S/4HANA Cloud system), there are the following three fields or field combinations which you can fill instead, to
determine the transaction number.
● Internal Reference.
● Business Partner Number and External Reference.
● Legal Basis (SAP S/4HANA Cloud preconfigured value 01) and External Trade ID.
Note
These fields are available in the financial transaction data and should have been filled during the migration
of the financial transaction.
The migration cockpit searches for the corresponding financial transactions and enters the identified financial
transaction number in the Legacy Data Transfer table for position component values.
Post-Processing
Follow-on Activities
The Treasury Specialist – Back Office will find the apps for legacy data transfer on the launchpad under Utilities:
After the import of position value data, you can execute the initial load of position data.
● Using the Execute Initial Load of Position Value app (OP: TPM63 Execute Data Transfer), enter the positions
component values in the Positions Management tables.
Should any errors occur, you can reverse the initial load using the Reverse Initial Load of Position Value app .
To check the values entered, you can display the positions component values with the Treasury Position
Reporting or Display Treasury Position Values apps or, available for the Treasury Accountant business role
(SAP_BR_TREASURY_ACCOUNTANT), with the Treasury Position Analysis app.
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition The object dependency is used to define dependencies be
tween different objects in a configuration.
In Scope
Supported Features
● Header
● Global Dependencies
Prerequisites
You can only create object dependencies assigned to one Engineering Change Number in one migration run.
Mapping Instructions
Level Name
1 Header (mandatory)
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition The object dependency is used to define dependencies be
tween different objects in a configuration.
In Scope
Supported Features
● Header
● Global Dependencies
● The Characteristic [page 34] must be created in the same project using the SAP S/4HANA Migration
Cockpit; a manually-created version of the characteristic cannot be used in this object.
● Even if the Characteristic [page 34] object has been migrated in a previous release of SAP S/4HANA Cloud,
it still can't be used in this object, because the Characteristic [page 34] migration object was enhanced
with SAP S/4HANA Cloud 1911. You will get a warning message if you try to use a manually-created version.
● You can only create object dependencies assigned to one Engineering Change Number in one migration
run.
Mapping Instructions
The characteristic name and item can be retrieved from the Characteristic [page 34] migration object.
Therefore, fill out the second sheet of the migration template, Character. value dependency. It's not necessary
to enter a value, but make sure you have entered the correct item number for the correct characteristic.
Level Name
1 Header (mandatory)
Tasks
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Further Information
Purpose
Business Object Definition A table used to store consistent combinations of values for
different characteristics in product modeling.
In Scope
● Variant table
● Contents of Variant Table
Prerequisites
Mapping Instructions
1. You have defined not only the value Space but also a value description in the characteristic master.
2. The values for the table content are transferred to the VAR_TAB_ENTRIES table. If a characteristic uses the
value Space, you must specify the value description in the VTVALDESCR field.
Level Name
● 1840693
● 1963379
Tasks
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition A supplier is a business partner who supplies goods and de
livers them to consumers/customers.
1. Extend already existing suppliers with new org levels and extend already existing customers/contract
partners as supplier with the same number
2. General data (only fields which might become relevant when you extend a customer/contract partner as
supplier)
3. Additional addresses
4. Company data
5. Withholding tax data
6. Purchasing organization data
7. Purchasing partner functions
8. Bank data
9. Industries
10. Tax numbers
11. Identification numbers
12. Contact persons, including address data with telephone, fax and email
Out of Scope
Supported Features
● General Data
● Additional Addresses
● Company Data
● Withholding Tax Data
● Purchasing Organization Data
● Partner Functions
● Bank Details
● Industries
● Tax Numbers
Prerequisites
Mapping Instructions
On the General Data sheet, we only offer fields which might become relevant when you extend already existing
customers/contract partners as supplier with the same number. If you want to extend an existing customer or
contract partner as supplier with the same number, you have to fill out either the customer number or contract
partner. It's not possible to provide both fields. If you want to extend an already existing supplier by new org
levels, you have to leave the reference numbers empty.
Please consider: You can't transfer a value in one of the fields provided on the General Data sheet when the
supplier already exists.
If you want to use the Supplier ID for integration with external systems, you can activate it during migration. At
the same time, you must also maintain the Business System ID of your source system (to be used for
integration) using the Convert Values task to ensure that the key mapping is added to the central key mapping
store of the SAP S/4HANA system. This is only relevant if you extend an existing customer or contract partner
as supplier with the same number. If you extend an existing supplier with new org levels it is not necessary to
switch on the key mapping for the Supplier ID.
If you want to use these references to other business partners, make sure these business partners have been
created in advance.
You have three suppliers, A, B, and C. They have the following relation:
Please note that this data constellation can't be handled with the data migration object. Please remove some of
the relations and add them later via the BP maintenance UI or BP mass maintenance app.
To assign a contact person as partner, first create the supplier with the contact person, but without purchasing
data. Then, use the Supplier - extend existing record by new org levels migration object in a second step to
assign the purchasing data together with the contact person in partner capacity.
Contact Person ID
You must enter a contact person ID in the respective field in the Contact person sheet. This number is required
for internal data processing. However, during processing, a new business partner will be created with an
internal number. This business partner is automatically assigned to the supplier with the corresponding
relationship.
If Vertex determines more than one tax jurisdiction code for a record, the migration of this record will fail. If this
happens, you'll have to provide a more detailed/accurate address, for example, a US Postal code with 9 digits
instead of 5 digits.
The more detailed and accurate an address, the better the tax jurisdiction code will be determined by Vertex.
For some addresses, Vertex will always provide more than one tax jurisdiction code. In this case you will have to
maintain this record manually or provide a correct tax jurisdiction code within the template.
In the Suppress Tax Jurisdiction Code Check field on the General Data sheet, you can suppress the check and
the automatic determination of the Tax Jurisdiction Code for each record.
Level Name
2 BP Roles
2 Additional Addresses
2 General Texts
2 Company Data
3 Company Texts
2 Purchasing Organization
Data
3 Partner Functions
3 Purchasing Texts
2 Bank Details
2 Industries
2 Tax Numbers
2 Identification Numbers
2 Contact Persons
Tasks
Post-Processing
Log on to your SAP S/4HANA Cloud system as Configuration Expert - Data Migration and use the Data
Migration Status app to validate your data in the system. Alternatively, use the following app:
Mass change after an extend existing record by new org level migration can be done through:
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Purpose
Business Object Definition A business partner may have many branches depending on
the various locations from where they operate from. A
branch code is a 4-digit or a 5-digit code assigned by the
Revenue Department in Thailand to uniquely identify each
branch of a business partner. In any case, the head office
branch carries a branch code of 00000 or 0000.
In Scope
Out of Scope
Prerequisites
Mapping Instructions
● The supplier master data needs to be migrated as a prerequisite with Thailand company code assigned.
● Only one branch code can be marked as default branch code. If only one branch code is assigned it will be
marked as default automatically.
● If branch codes are already assigned to the supplier, additional branch codes can only be uploaded w/o
default indicator.
● As standard method for communication (part of the address information) the following values are
supported only: Fax, E-mail and Telephone.
Level Name
Tasks
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
1.128 Supplier
Tip
For this migration object, the Custom Fields and Logic app is available. If you enhance your business object
with custom fields in the app, these custom fields will automatically be reflected in the XML template of the
corresponding migration object. See SAP Note 2726010 for further details.
Every time you add, change or delete a custom field, the migration project must be updated and a new
migration XML template must be downloaded and used. Thus, if custom fields are added or changed by an
application expert during migration testing, this must be communicated to and coordinated with your data
migration team. Also see the Extensibility section in the SAP S/4HANA Cloud documentation.
Purpose
In Scope
Out of Scope
● General Data
● Additional Addresses
● Company Data
● Withholding Tax Data
● Purchasing Organization Data
● Partner Functions
● Bank Details
● Industries
● Tax Numbers
● Identification Numbers
● Contact Persons
Note
Any time you add, change or delete a custom field, the migration project must be updated; a new XML
template must be downloaded and used. Thus, if custom fields are added, changed or deleted by an
application expert during migration testing, this must be communicated to, and coordinated with, data
migration.
The Supplier (General Data, Company Data, and Purchasing Organization Data) can be enhanced with
the Custom Fields and Logic app, adding custom fields in the application. If the Supplier is enhanced in
this way, the custom fields will be reflected automatically in the XML template as well.
Prerequisites
Mapping Instructions
The supplier will be created with the Supplier (FLVN01) role. The Supplier (Financial Accounting) (FLVN00) role
will be created if company data is provided in the template.
All mandatory partner functions will be created automatically with the same supplier number. If you provide the
partner function with a different supplier number on the Partner Functions sheet, this entry will be taken.
It's possible to assign more than one address to a supplier. The address data from the General Data sheet is
always the standard address. If you assign only one address to a supplier, it's not necessary to provide an
external address number. If you provide additional addresses, however, the external address number becomes
mandatory. The external address number must be unique for each supplier. You can use the same external
address number for different business partners.
Assigned contact persons will always get an internal number for the new business partner.
With the BP Grouping field on the General Data sheet, you arrange the different number ranges (internal or
external) and the vendor account group. It's possible to create a supplier and a one-time supplier.
If you need to create a business partner with both customer and supplier roles, you can enter this manually or
extend an already migrated customer with the Supplier - extend existing record by new org levels [page 379]
migration object.
If you want to use the Supplier ID for integration with external systems, you can activate it during migration. At
the same time, you must also maintain the Business System ID of your source system (to be used for
integration) using the Convert Values task to ensure that the key mapping is added to the central key mapping
store of the SAP S/4HANA system.
If you want to use these references to other business partners, make sure these business partners have been
created in advance.
Example
You have three suppliers, A, B, and C. They have the following relation:
Please note that this data constellation can't be handled with the data migration object. Please remove some of
the relations and add them later via the BP maintenance UI or BP mass maintenance app.
To assign a contact person as partner, first create the supplier with the contact person, but without purchasing
data. Then, use the Supplier - extend existing record by new org levels [page 379] migration object in a second
step to assign the purchasing data together with the contact person in partner capacity.
If Vertex determines more than one tax jurisdiction code for a record, the migration of this record will fail. If this
happens, you'll have to provide a more detailed/accurate address, for example, a US Postal code with 9 digits
instead of 5 digits.
The more detailed and accurate an address, the better the tax jurisdiction code will be determined by Vertex.
For some addresses, Vertex will always provide more than one tax jurisdiction code. In this case you will have to
maintain this record manually or provide a correct tax jurisdiction code within the template.
In the Suppress Tax Jurisdiction Code Check field on the General Data sheet, you can suppress the check and
the automatic determination of the Tax Jurisdiction Code for each record.
Level Name
2 Additional Addresses
2 General Texts
2 Company Data
3 Company Texts
2 Purchasing Organization
Data
3 Partner Functions
3 Purchasing Texts
2 Bank Details
2 Industries
2 Tax Numbers
2 Identification Numbers
2 Contact Persons
Post-Processing
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Further Information
● For this migration object, SAP delivers a prefilled sample XML template that helps you in filling out your
data migration template. Use this link to navigate to the Data Migration Template Samples for SAP S/
4HANA Cloud (for customers and partners only).
● SAP Note 2726010 – Migration Cockpit: Support of custom fields (in-app extensibility)
In Scope
The description is always stored in the logon language of the user that is used to migrate the work center data.
Note
Prerequisites
Business objects that reference this object must be created within the correct validity period for this object.
If a successor object is created with a validity period that starts before the validity period of this object, it will
normally cause an error message during the creation or migration of the successor object.
You therefore have to check such time dependencies before you create or migrate your objects. This will avoid
subsequent error messages and inconsistent data on your database.
Mapping Instructions
Level Name
Post-Processing
SAP_BR_PRODN_ENG_DISC)
Find more information about SAP Fiori apps in the SAP Fiori apps reference library. This information covers
required business roles and includes links to the respective app documentation.
Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:
● Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your
agreements with SAP) to this:
● The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
● SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
● Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering a SAP-hosted Web site. By using such
links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this
information.
Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax
and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of
example code unless damages have been caused by SAP's gross negligence or willful misconduct.
Gender-Related Language
We try not to use genderspecific word forms and formulations. As appropriate for context and readability, SAP may use masculine word forms to refer to all genders.
SAP and other SAP products and services mentioned herein as well as
their respective logos are trademarks or registered trademarks of SAP
SE (or an SAP affiliate company) in Germany and other countries. All
other product and service names mentioned are the trademarks of their
respective companies.