DHL Messaging Gateway

Maintenance Requirement Statement (MRS)

IT Services

Shipment Type Analytics (STAN)

DHL Messaging Gateway

Maintenance Requirement Statement (MRS)

Doc. Ref: 535209653.docx1.0

Version: 1.0
Status: Baseline
Author Naveen Perarapu
Last Updated by: Naveen Perarapu
Last Updated on: 21st April 2021
Approved by: See document history

Doc. Ref: 535209653.docx0

DHL PROPRIETARY AND CONFIDENTIAL
DHL Messaging Gateway
Maintenance Requirement Statement (MRS)

Version History

Revision Release Date Updated by Remarks/Comments Status

0.1 25th Mar 2021 Naveen Perarapu First Draft Draft
0.2 30th Mar 2021 Naveen Perarapu Updated based on internal review Draft
0.3 05th April 2021 Naveen Perarapu Updated Draft
th
0.4 04 April 2021 Naveen Perarapu Updated based on internal review Draft
1.0 21st April 2021 Naveen Perarapu Baseline MRS Baseline

Document Reviewed By

Version Review Date Organization Reviewer Name Remarks/Comments

0.1 25th Mar 2021 ITS Yau Han Min Reviewed

0.2 30th March 2021 ITS Ven Han Choke Reviewed

0.2 30th March 2021 GHO Ops Programs Steve WHORF Reviewed

0.2 30th March 2021 BUIT Pankaj Pund Reviewed

0.2 30th March 2021 BUIT Olga Sholomitskaya Reviewed

0.2 30th March 2021 BUIT Ahamed Shiraz Faiz Reviewed

0.3 05th April 2021 ITS Yau Han Min Reviewed

Doc. Ref: 535209653.docx0

DHL PROPRIETARY AND CONFIDENTIAL
DHL Messaging Gateway
Maintenance Requirement Statement (MRS)

Distribution List

Name Department/ Location Role Action/Information

Gavin Conboy Global Network Operations VP Operations Programs Global Review and Approve
MeiSim Yap Global NetOps Program Program Manager Review and Approve
Pankaj Joshi DHL EXPRESS GHO Express DA Review and Approve
Steve Whorf DHL EXPRESS GHO Senior Director, Operations Programs Review and Approve
Greg Pilkington DHL EXPRESS GHO Head of Global Customs Programs Review and Approve
Alvin Javier Flores DHL EXPRESS GHO Principal Systems Specialist, Business Review and Approve
Intelligence, Global BIT
Boey Kok Wai BUIT Global Domain Director, NetData (Integration Review & Approve
Platforms)
Pankaj Pund BUIT Principal Solution Architect, Global BIT Review & Approve
Ashwin Gawli BUIT Sr. System Specialist (Messaging & Review & Approve
Integration), Global BIT
Erick Chen ITS Solution Delivery Product Owner Review & Approve
Ven Han Choke ITS Solution Delivery Senior Solution Architect Review & Approve
Wilson Kirubakaran BUIT Infrastructure Products Manager Review
Ahamed Shiraz Faiz BUIT GBIT Network Operations/BUIT Review
Fazular Rahman BUIT Project Manager Review
Thomas MOERKERKE DHL Express GHO VP Global Head of Data Analytics DHL Express Information
Charles Mak van Waay DHL EXPRESS GHO Program Manager Migration Europe, Information
Marketing & Sales Board
Simon Tetley BUIT Enterprise Architecture Information
Sammy Madasamy BUIT Global Head of Network Operations Domain Information
Olga Sholomitskaya BUIT Data Analytics and Convergence Manager Information
Elaine Estioko ITS Solution Delivery Principal Consultant (STAN Program) Information
Soo Yaw Chua ITS Solution Delivery Head of Sub-Domain Clearance and Gateway Information
Joy Ngu Wah Aye ITS Solution Delivery Project Analyst (STAN Program) Information
Mun Kit Wong ITS Solution Delivery Manager of Team Terminal and Hubs Information
Michelle Ong ITS Solution Delivery Senior Consultant DCC Information
Ikin Othman ITS Solution Delivery DMG Project Manager Information
Saravanan Nagalingam ITS Solution Delivery Team Manager, SD EXP DMG/PRIME Information
Anuar Mansor ITS  Solution Support DMG Solution Support Manager Information
Mohd Zaiham Aman ITS  Solution Support DMG Principal Application Support Specialist Information
Busyra Samsudin ITS  Solution Support DMG Principal Application Support Specialist Information
Yau Han Min ITS Solution Delivery Senior Software Engineer Information
Wong Chee Kin ITS Solution Delivery Senior Software Engineer Information
Dinesh Seeram ITS Solution Delivery Senior Software Engineer Information
Naveen Perarapu ITS Solution Delivery Associate Software Engineer Information

Doc. Ref: 535209653.docx0

DHL PROPRIETARY AND CONFIDENTIAL
DHL Messaging Gateway
Maintenance Requirement Statement (MRS)

Table of Contents
1. INTRODUCTION............................................................................................................ 6
1.1 BACKGROUND........................................................................................................................ 6
2. SYSTEM REQUIREMENTS...........................................................................................7
2.1 REQUIREMENT....................................................................................................................... 7
1. Query STAN, Enrich SDCM, and Send SDCM to DCC.....................................................................7
2.2 TRANSPORT MECHANISMS...................................................................................................... 9
2.3 MESSAGE ENCODING AND LIMITATIONS...................................................................................9
3. NON-FUNCTIONAL REQUIREMENTS........................................................................10
3.1 GENERAL NON-FUNCTIONAL REQUIREMENTS.........................................................................10
3.1.1 Product Specific Non-Functional Requirements............................................................10
3.1.2 Development Specific Non-Functional Requirements....................................................10
3.1.3 Operations Specific Non-Functional Requirements.......................................................10
APPENDIX A: GLOSSARY OF TERMS...............................................................................12

Doc. Ref: 535209653.docx0

DHL PROPRIETARY AND CONFIDENTIAL
DHL Messaging Gateway
Maintenance Requirement Statement (MRS)

1. Introduction
1.1 Background

The objective of Shipment Type Analytics (STAN) is to deliver a centralized solution that uses a
combination of pre-defined business rules and machine learning models to determine the business party
trader type, trading transaction type and shipment type classification based on available information in
shipment detail and commercial invoice.

This analytic results will be used to aid custom broker team in deriving the Shipment Transaction Type
Classification, Business Party Trader Type and Trading Transaction Type which determines how duties and
taxes (if applicable) are calculated.

Cross-references

Document ID Document Name Version

Doc. Ref: 535209653.docx0

DHL PROPRIETARY AND CONFIDENTIAL
DHL Messaging Gateway
Maintenance Requirement Statement (MRS)

2. System Requirements
The summary of requirement that needs to be built in DMG is as below:

2.1 Requirement

1. Query STAN, Enrich SDCM, and Send SDCM to DCC

 Currently DMG receives SDCM from DCVS3, and sends a verbatim copy to DCC, subject to the
different routing rules for different countries.

Identifying what to query:

o For shipments that DMG is currently routing to DCC EU Import instances, DMG will
divert them into a new flow that queries STAN for the Shipment Transaction Type
Classification, Business Party Trader Type and Trading Transaction Type.
What to do for the query:
o The request message to and the response message from STAN are in JSON format.
o DMG will construct the JSON format request from the SDCM, and also read the JSON
format response back from STAN.
o DMG will enrich the SDCM with the Shipment Transaction Type Classification,
Business Party Trader Type and Trading Transaction Type from the query response
coming back from STAN.
After the query:
o With the same routing rules for each country’s DCC Import instance, the enriched
SDCM will be sent to DCC.
o In the event that STAN query doesn’t respond with a positive result, DMG will retry
the request (number of attempted will be configurable in DMG). If the number of
retries are exhausted, DMG will still send the SDCM to DCC, albeit without any
enrichment.
Error alerts:
o DMG will generate warning messages for the following scenarios.
1. Web service exception.
2. Response with error codes given by STAN API.
3.Web service query threshold breached (Query Response Threshold is 300
milliseconds and it will be configurable in DMG).
o Scripts will periodically (15 mins configurable) check for these warning messages, and
will send consolidated email alerts for all erroneous shipments found in that
cycle/batch.

 The HTTP request will be secured with HTTPS.

Doc. Ref: 535209653.docx0

DHL PROPRIETARY AND CONFIDENTIAL
DHL Messaging Gateway
Maintenance Requirement Statement (MRS)

Note: SDCM converted from legacy systems (GNS Notify Feed) is not considered.
DMG Routing/Filtering Rules:

Field Name SDCM Fields

Origin Service Area ShpPcdDetailsMsg/Bd/Shp/OrgSrvACd
Origin Country Derived based on Origin Service Area
Origin Region Derived based on Origin Service Area
Origin Facility ShpPcdDetailsMsg/Bd/Shp/OrgFcCd
Destination Service Area ShpPcdDetailsMsg/Bd/Shp/DstSrvACd
Destination Country Derived based on Destination Service Area
Destination Region Derived based on Destination Service Area
Destination Facility ShpPcdDetailsMsg/Bd/Shp/DstFcCd
ShpPcdDetailsMsg/Bd/Shp/GI/@SrcUpdSrvaCd
Else
Generated Service Area ShpPcdDetailsMsg/Bd/Shp/GI/@SrcSrvaCd
Generated Country Derived based on Generated Service Area
Generated Region Derived based on Generated Service Area
Generated Facility ShpPcdDetailsMsg/Bd/Shp/GI/@SrcUpdFcCd
ShpPcdDetailsMsg/Bd/Shp/GI/SrcUpdAppCd
Else
Origin Application ShpPcdDetailsMsg/Bd/Shp/GI/SrcAppCd
ShpPcdDetailsMsg/Bd/Shp/GlProdSrvCd IS NOT 'NULL'
And
ShpPcdDetailsMsg/Bd/Shp/GlProdSrvCd/GlProdSrvClssCd ='P'
Product Code Then Map ShpPcdDetailsMsg/Bd/Shp/GlProdSrvCd
VALID State ShpPcdDetailsMsg/Bd/Shp/St/StCd[TyCd='VAL'] = 'VALID'
VERIF State ShpPcdDetailsMsg/Bd/Shp/St/StCd[TyCd='VER'] = 'VERIF'
ACTIV State ShpPcdDetailsMsg/Bd/Shp/St/StCd[TyCd='ACT'] = 'ACTIV'

Flow diagram:

Doc. Ref: 535209653.docx0

DHL PROPRIETARY AND CONFIDENTIAL
DHL Messaging Gateway
Maintenance Requirement Statement (MRS)

2.2 Transport Mechanisms

 Transport Mechanism between DCVS, DCC, and DMG will remain as IBM Web Sphere MQ.
 Query from DMG to STAN will be via HTTP request.

2.3 Message Encoding and Limitations

 All messages size are limited to 100Mb (IBM WebSphere MQ limitation)
 DMG is an asynchronous infrastructure and sequence of messages cannot be guaranteed in
cases where messages are very close to each other
 DMG individual POP servers do have reboot downtimes of a maximum of 15 minutes per
region at different weeks
 DMG stores audit data for 15 days. No automatic resubmission capabilities are built into
DMG.

Doc. Ref: 535209653.docx0

DHL PROPRIETARY AND CONFIDENTIAL
DHL Messaging Gateway
Maintenance Requirement Statement (MRS)

3. Non-Functional Requirements
3.1 General Non-Functional Requirements

3.1.1 Product Specific Non-Functional Requirements

3.1.1.1Availability & Reliability Requirements

 All DMG components will remain as it is today.

3.1.1.2Performance & Resource Requirements

 There is no change in existing input & output volumes
 The current DMG EU infrastructure is sufficient to cater for this requirement.

3.1.1.3 Error Handling

 No change to existing DMG error logging strategy. All failed messages will be in error logs.

3.1.1.4Security Requirements
 All DMG components will remain as today.
 Communication between DCVS, DCC, and DMG will remain as IBM Websphere MQ.
 Query from DMG to STAN will be via HTTP request.

3.1.2 Development Specific Non-Functional Requirements

3.1.2.1Deliverables
 The following documentation will be provided:
o Maintenance Requirement Specifications
o Release Notes

3.1.2.2Introduction into Operation/Deployment of the Solution

 All DMG components will remain as it is today.

3.1.3 Operations Specific Non-Functional Requirements

3.1.3.1Resource Requirements
 No change to existing DMG setup.

3.1.3.2Hardware to be Used
 Existing DMG hardware.

3.1.3.3Software to be Used
 This section states all the software/frameworks used to support the requirements:

# Environment / Frameworks Software License Remark/Purpose

1 App Connect Enterprise V11.0.x Licensed Message Translator
2 IBM WebSphere MQ V9.x Licensed To serve as point of input and output for clients to
DMG
3 Oracle Database 19c Licensed Configuration of Routing and Static Reference Data
4 JMQI V1.5.x N/A Custom built software for transferring Files to
Queues and vice-versa
5 Java Development Kit 1.8.0_221 N/A Required by JMQI

Doc. Ref: 535209653.docx0

DHL PROPRIETARY AND CONFIDENTIAL
DHL Messaging Gateway
Maintenance Requirement Statement (MRS)

3.1.3.4Deployment Related Requirements

 Refer to RTP plan document.

3.1.3.5Backup & Recovery

 No change to existing DMG production implementation.

3.1.3.6Support
 No additional RUN cost is required for DMG to support these changes.

Doc. Ref: 535209653.docx0

DHL PROPRIETARY AND CONFIDENTIAL
DHL Messaging Gateway
Maintenance Requirement Statement (MRS)

Appendix A: Glossary of Terms

Name Description
DMG DHL Messaging Gateway
DCVS Data Capture Validation Service
DCC Data Cleansing & Classification
STAN Shipment Type Analytics

Mapping Document:

Message_Implemen
tation_Guide_-_STAN_v0.7.xlsx

SDCM_Merge_DCC_
v0.1.xlsx

Sample JSON Request Message:

STAN_Sample_Requ
est_JSON_Msg_20200405_1.json

Sample JSON Response Message:

STAN_Sample_Resp
onse_JSON_Msg_20210406_1.json

Sample SDCM Output to DCC:

SDCM_to_DCC.xml

Doc. Ref: 535209653.docx0

DHL PROPRIETARY AND CONFIDENTIAL