High- Level Specification

ParameterValue
Application SystemS/4HANA
Business Process Reference12.01.01.01. Set-up GTS Organizational Structure

Functional Overview

Foreign Trade Organization(FTO) and Legal Units(LU) are the organizational elements in GTS. These organizational elements are required to comply with the legal and customs requirements to allow execution of the respective country's import and export processes. Foreign Trade Organization (FTO) is the top level organizational unit in SAP GTS and it corresponds to the company code in the feeder system. Legal unit(LU) corresponds to the plant in the feeder system. FTO and LU are created as business partner in SAP GTS system with different roles. The objective of this application job is to automate the creation of the FTO and LU business partner in GTS by executing the report in the feeder S/4 HANA system.


Scope and Objectives

Foreign Trade Organization and Legal unit business partners are created manually in SAP GTS. Due to the huge volume of these organizational elements in Syensqo, creation of FTO and LU 

business partner data is to be automated. Mapping of company code is 1: 1 and mapping of plants is also 1: 1. For every company code in feeder, only one FTO will be created in GTS. Similarly for every plant in feeder, only one legal unit will be created.

Process Flow Diagram

Insert the flowchart and fill in the steps

Step

Description

Comment

1.Company codes are  created in feeder system as a business partner
2Plants are created in feeder systems as a business partner
3Company codes to be replicated in GTS system as a business partner
4Plants to be replicated in GTS system as a business partner


Assumptions

  1. Company code must be available in S/4 HANA Feeder system.
  2. Plants must be available in S/4 HANA system.
  3. SAP GTS system should be available during transfer. 
  4. Address elements like name, street, city , country etc are available in the feeder business partner. 

Dependencies

Finance team will be responsible for the creation of company codes.

Supply Chain team will be responsible for the creation of plants.

These are mandatory for the bp creation in GTS.


Security, Integrity and Controls

Master Data Specialist - Business Partner Data is the role for the BP transaction and it should be available for the application job to create bp.


To detail the security requirements for processing this enhancement, any data integrity issues associated with the object and the teams that will be responsible for processing the object, i.e. authorization/roles required to who can execute the enhancements, etc.

- Custom Tables, enhancement, transaction codes, programs, Web Dynpro Application, Code Data Services (CDS), Open Data Protocol (OData), BI reports, and Functional Modules need to have at least one authority check either standard or custom. (custom should be an exception)

- All custom tables will be maintained in a certain Authorization Group (example: ZFIN, etc.)

- In the case of transaction codes an additional check other than the object S_TCODE is required. You can use SU24 to find the related authorization objects to check.

All other WRICEFs

- If the authorization check is already performed in the calling Programs, this section can be filled as “Follow calling programs authorization check” (example : BADI to redirect DMS to OpenText, in which the calling Manage Purchase requisition Fiori App already performed authorization check)

- If the authorization check is not checked in any of the development, this section should be filled with the proposed authorization check. You can refer to SU24 to see the standard authorization objects. (example: full custom Fiori App to enable user to download/upload the project plan)


Configuration Requirements

RFC connection should be established between the S/4 HANA and GTS E4H system. 

Language Requirements

English

Special Requirements

N/A

Design Rationale

Functional Requirements

Existing process of creating the organizational elements FTO and LU is manual. In BP transaction , FTO and LU will be created one by one by referring to the data from the S/4 feeder. 

Going forward, as part of this enhancement execution, company codes and plants will be replicated as business partners in GTS. For FTOs, the naming convention will be FTO_XXXX where XXXX will be the company code from S/4 feeder. For LUs, the naming convention will be LU_XXXX where XXXX is the plant from S/4 feeder. 

For FTO, it should be created in 3 different BP roles -000000 Business Partner (General), SLLFTO(Foreign Trade Org) and FS0000(Financial Services BP).

For LU, it should be created in 3 different BP roles- 000000 Business Partner (General), SLLSIT(Legal Unit) and FS0000(Financial Services BP).

The BP fields which are usually populated for FTO and LU are : Name, Street/House number, Postal Code/City, Country, Region, Timezone. Communication details if available in feeder can also be copied including email, telephone etc.

Proposed Technology to Use

Application job in GTS that reads the change object class for plant  BETRIEB and it creates the BP or updates the BP in GTS for legal units (table T001). 

Data Source Considerations

Include an overview of the source

TableField NameComments/Calculation/Field Manipulation
T001BUKRS
T001WWERKS





Data Validation Considerations

Only one to one mapping should exist between company code from feeder and FTO in GTS.

Similary one to one mapping for plants and legal units from feeder to GTS.

Include an overview of the data validation requirement

TableField NameComments/Calculation/Field Manipulation
T001BUKRSValidate the company code using this table
T001WPLANTValidate the plant using this table







Custom Tables

N/A

Master Data

N/A

FieldDescriptionData Type/LengthValidation rule/ Value Help









Configuration Table

N/A

FieldDescriptionData Type/LengthValidation rule/ Value Help








Selection Screen Enhancement

This section will give the details on the selection screen parameters, parameter type and whether it’s obligatory or not. This section can be used to define the Import Export parameters for Function Module or User Exit or Screens.

Field NameDescription

Select:

Option or Parameter

Check box or Radio button

Import or Export

Data Type/LengthDefault Value/ Validation rule/ Value HelpSelection Logic
BUKRSCompany CodeOptionCHAR 4

WERKSPlantOptionCHAR 4

Simulation 
Checkbox 

To run the program in simulation mode


Processing Logic

On scheduling the application job for company code transfer , the program should validate the entries are company codes. Error should be shown if the details entered in selection screen are not valid company codes. 

And then fetch the relevant business partner master data from feeder including Name , Street/House number, Postal Code/City, Country, Time zone. If communication relevant details are present in the bp master data including language, telephone, email etc. those details also to be transferred.

And in GTS system , corresponding to this company code, BP master data should be created and available in transaction BP with all the fields populated. 

Three roles are to be created for the FTO(Foreign Trade Organization ) in GTS - 000000 Business Partner (General), SLLFTO(Foreign Trade Org) and FS0000(Financial Services BP). 

From S/4 HANA system, the details in the Business Partner (General) tab of the company code  should be mapped to all the 3 roles - 000000 Business Partner (General), SLLFTO(Foreign Trade Org) and FS0000(Financial Services BP) in GTS. 


Similarly on scheduling the application job for transfer of  plants, program should validate the entries are plants. Error should be shown if the details entered in selection screen are not valid plants. 

And then fetch the relevant business partner master data from feeder including Name , Street/House number, Postal Code/City, Country, Time zone. If communication relevant details are present in the bp master data including language, telephone, email etc. those details also to be transferred.

And in GTS system , corresponding to this plant, BP master data should be created and available in transaction BP with all the fields populated. 

Three roles are to be created for the Legal Unit(LU) in GTS -000000 Business Partner (General), SLLSIT(Legal Unit) and FS0000(Financial Services BP).

From S/4 HANA system, the details in the Business Partner (General) tab of the plant  should be mapped to all the 3 roles - 000000 Business Partner (General), SLLSIT(Legal Unit) and FS0000(Financial Services BP) in GTS. 


There should be option to run this program in simulation mode and check the details. 

A log should be generated with the details of transfer  and also record any errors during transfer. 




Volumetrics

Provide volumetrics details: Initial load volumes, Number of Records, Expected Frequency, Expected Long term Growth)

This program should be run as part of cutover task to have all the company code and plants to be created in GTS same as the feeder system S/4. Also after go-live , if any new company codes/plants  are created/changed, it should be possible to transfer them as well.  

Performance Considerations

Specify if there are any specific performance factors that need to be taken into consideration during development i.e. enhancement must be able to be executed by 10 users at the same time, etc.

As part of Syensqo,we have more than 3000 + company codes and plants and the number may vary. So the program should be able to handle this transfer. 


Error Handling

Any failures in the report must be logged for further review. 


Testing

How to Test

Run the application job and validate in GTS system , the corresponding org units are created.

Test Conditions and Expected Results

IDConditionExpected Result
1Replicate a company code  XXXX transfer via the application jobFTO_XXXX created in GTS with 3 different roles - BP General(0000000), SLLFTO, FS00000
2Replicate a plant YYYY transfer via the application jobLU_YYYY created in GTS with 3 different roles-BP General(0000000), SLLSIT, FS00000
3Negative case- Invalid company code entered in selection and try to schedule the application jobError showing incorrect company code entered
4Negative case- Invalid plant entered in selection and try to schedule the application jobError showing incorrect plants.


Test Considerations/Dependencies


For this report to work, company codes and plants are to be available in S/4 HANA. 


Other Information


Development Details

Package

Package NameParent Package




Enhancement Implementation

Enhancement TypeStandard Definition NameCustom Implementation NameDesign Rationale Reference









Other Development Objects

Object TypeObject NamePurpose/High Level LogicDesign Rationale Reference








Appendix

Custom Authorization Group Naming Convention

This table is based on the Syensqo development standards document. It provides the naming conventions for authorization groups to associated with custom reports and tables to comply with security requirements.

ABAP

ZFIZMMZPSZCOZSDZBCZFIZCA
TABLESZFITZMMTZPSTZCOTZSDTZBCTZFITZCAT

See also

Insert links and references to other documents which are relevant when trying to understand this decision and its implications. Other decisions are often impacted, so it's good to list them here with links. Attachments are also possible but dangerous as they are static documents and not updated by their authors.


Change log