High- Level Specification

Functional Overview

Syensqo uses Descartes (3rd party system) which is the market-leading global trade content for GTS that provides the most current regulatory data for Compliance Classification Codes (Export Control on EARUS). New classification codes are always provided by Descartes on a regular basis via XML files.

The purpose of this integration specification is to automatize the process by, extracting the list of EARUS compliance classification codes published by the Government from Descartes's website and upload it to GTS. The update should occur when a file is provided by Descartes. Updates can be received on a weekly basis, hence the set up of the program will be marked as weekly to do the file movement. The files will be taken from the directory path within Descartes SFTP location in a zip format. The files are supposed to the stored after successful upload to GTS system - for audit purposes (the upload program to the GTS system is covered within FS ERP-717.

Scope and Objectives

While GTS is the leading system for classification codes and product assignment, this step is the prerequisite before classifying any product and before any export can happen in the system. 

This new automatization follows one straight objective: to reduce the workload of man/hour which involves → emails, dependency on an user action/availability or knowledge transfer within the team.

With the 3 different instances of GTS system for US, China and Rest of World, the EARUS file must be available in all systems for the product-classification codes to happen.

Detail the functional scope and objectives of the Interface. Please also describe the gap that will be addressed by this interface (Compared to SAP Standard)

Process Flow Diagram

Assumptions

1. SAP Cloud Platform Integration connectivity is available.
2. SAP GTS E4H system is available at the time of extraction.

Describe any assumptions that have been made in the process of completing this design. What functionality is expected of configuration or other developments that pass information to this development and/ or retrieve the information processed by it (performance, triggers, exceptions, etc.)

Dependencies

Descartes must published first the XML content for Export Control Classification Numbers- EARUS codes.

Indicate any dependencies or constraints that may impact development, in terms of requirements from internal or external applications or teams, limited access to legacy systems, time constraints or data restrictions. Also, please specify schedule dependencies e.g. interface or batch jobs that must run prior to execution.

Security, Integrity and Controls

• Connection to Descartes to retrieve files will use SAP Integration Suite Middleware CPI (download zip, unzip, upload) using secure protocols.

To detail the security requirements for processing this object, 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 interface, encryption requirement, etc.

Configuration Requirements

N/A

Specify the configuration requirements for this object. Like in case of substitution/ routine specify the configuration needed

Special Requirements

Overwriting should be possible. Whenever there is an emergency and cannot wait for the interface program to run, the GTS IT user can login to the FTP server, download the XML file and then upload the file to GTS manually.. However, at the next run of the program this should overwrite the entries stated by the GTS IT user.

Specify any special requirements or considerations that may impact the interface based on specific locations, regulatory compliance or system limitations. Clearly outline requirements e.g. localization rules for countries like China

If the interface interacts with third-party systems such as Icertis, describe any additional integration, security or authentication considerations that must be taken into account.

Design Rationale

Existing process is a manual XML upload of ECCN codes for the Legal Reg. EARUS on a regularly basis into GTS and it needs to be replaced by this automated solution:

• The CPI middleware will handle the file from FTP and push it to GTS (S/4 instance).
• Connection details:
  • SFTP Server: sftp://download.custominfo.com
  • Directory Path: /E4H/Dual Use and LDR
  • Filename : E4H_ECCN_US_EN_vXXXXXX.zip (do not select the other .zip like *LDR or *DULUS)

• The program should download the .zip folder, unzip it and upload the XML in GTS.
• If error appears during integration process, a notification should be send to the GTS IT users (see Interface Alert & Monitoring chapter).

This template section may be used to specify an integration flow design between two systems.

Data Structure

N/A

Source Structure

The following fields will be used to provide the required information for this interface:

Target Structure

The following fields will be used to provide the required information for this interface:

Mapping and Calculation

N/A

Populate the table below to list the target / source data field mapping between the Source system and Target system

Processing Logic

Processing within Source

For this integration there will be no processing within the Source. 

Describe the processing requirement from Source System

Processing within Middleware

CPI will pass the file without modification or transformation.

Describe the processing requirement within Middleware Layer

Processing within Target

The files will not be modified in the target but placed directly in the file server without any transformation. Once this interface notifies the GTS system via the System Interface developed in ERP-717, the data will be loaded to relevant tables.

The files fetched from the data provider will be uploaded to GTS system using standard transaction /n/SAPSLL/LLNS_UPL002.

Describe the processing requirement from Target System

Interface Dependency

N/A

Please describe any dependency to other interfaces, e.g. messages of interface x need to be processed before message processing of interface y can start.

Interface Constraints

Upon polling, if CPI finds an updated file in Data Provider (Descartes) SFTP, it will be processed.

Descartes does not provide a Test or Dev tenant, so all CPI and GTS tenants will connect and access the Production Descartes SFTP.

Please describe any limitations on source and targets. i.e. target system can only accept maximum 100mb files, first-in-first-out, etc.

Delivery Requirements

This interface should work like a batch program which runs on the same time every week (TBD the day and time).

Please describe delivery requirements driven by business. i.e. real time, batch, scheduled, synchronous, triggering requirement, push or pull, etc.

Delta or Full Load Requirements

First upload will be considered as the initial upload for EARUS XML classification codes → full upload.

After that, the rest are considered delta, whenever new codes shows up or changes.

Please describe change tracking requirements, i.e. transferring only delta, or always full load

Interface Alert & Monitoring

Technical alerts are sent to the GTS IT super user team listed under sco-digops-gts@syensqo.com in case the interface face any issues. 

CALM interface alerts are send out if the interface has an issue allowing users to monitor and manage system.

Interface Reporting

N/A

Please describe any reporting requirement that is expected to be provided in support of this interface

Language Requirements

English

Specify multi language requirements

User Interface Requirements

N/A

Capture the requirements for the user interface (UI) associated with the interface. It should provide a clear description of how users will interact with the interface and how information will be presented to ensure usability and accuracy.

Volumetrics

File sizes: 
ZIP file, less than 1MB

Extracted XML file, around 5MB

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

Performance Consideration

File sizes: 
ZIP file, less than 1MB

Extracted XML file, around 5MB

Specify if there are any specific performance factors that need to be taken into consideration during development i.e. interface must be able to handle 100 posting per-hour, etc.

Error Handling

Log requirements:

1. Extract - Not able to access file server→ technical alert to the GTS IT users.
2. Authorization issue to access the FTP site → technical alert to the GTS IT users.
3. File matching the naming convention is not found in the FTP site →  technical alert to the GTS IT users.
4. Interface face issue to trigger the wrapper program →  technical alert to the GTS IT users.

Detail how errors will be handled: Notification, Restart/ Recovery and Re-Processing Procedures

Testing

How to Test

Open the FTP site and login with the credentials given. 

Download the file with naming convention E4H_EECN_US_EN_vXXXXX.zip from the week before of the run date.

Run the file interface and the file should be successfully placed in the defined file server for this requirement.

Please provide some guidance and/or test data to help the developer unit test the interface. Please include both positive and negative testing (to validate error situations handling)

The developer will need to test repeatedly, so where appropriate provide instructions to reverse the actions performed so the test may be run again, or explain how to create new input data to the test. In particular, the developer will need logons for test users representing the various roles within the approval process.

Test Conditions and Expected Results

Test Considerations/Dependencies

Test the file interface program and then test the standard transaction to upload the file to GTS system.

List any considerations essential for application test planning (e.g., test this before ABC along with DEF separate from GHI). If the development encompasses a user interface, explain how to test it. List any insights as to how this component could be tested the most efficiently.

Other Information

Development Details

Package

Other Development Objects

Appendix

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