0% found this document useful (0 votes)
836 views10 pages

IT Services: Doc. Ref: 535209655.docx Status: Author Last Updated By: Last Updated On: Approved by

The document describes requirements for updating the DHL Messaging Gateway (DMG) to convert messages between different formats. It requires DMG to: 1) Convert messages from the current SDCM v2 format to the new JCM v12 format to support customs customer contact needs. 2) Query the STAN system to enrich shipment details with transaction type classifications during the conversion. 3) Send the converted JCM v12 messages to the Customs Customer Contact portal via a message queue. 4) Use specified fields for routing and filtering messages during the conversion between formats.

Uploaded by

Rakkammal Rama
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as DOCX, PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
836 views10 pages

IT Services: Doc. Ref: 535209655.docx Status: Author Last Updated By: Last Updated On: Approved by

The document describes requirements for updating the DHL Messaging Gateway (DMG) to convert messages between different formats. It requires DMG to: 1) Convert messages from the current SDCM v2 format to the new JCM v12 format to support customs customer contact needs. 2) Query the STAN system to enrich shipment details with transaction type classifications during the conversion. 3) Send the converted JCM v12 messages to the Customs Customer Contact portal via a message queue. 4) Use specified fields for routing and filtering messages during the conversion between formats.

Uploaded by

Rakkammal Rama
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as DOCX, PDF, TXT or read online on Scribd
You are on page 1/ 10

IT Services

GCCP(Global Customer Contact Portal) Project

DHL Messaging Gateway

Maintenance Requirement Statement (MRS)

Doc. Ref: 535209655.docx


Version: 0.1
Status: Draft
Author Rakkammal R
Last Updated by: Rakkammal R
Last Updated on: 26th July 2021
Approved by: See document history

DHL PROPRIETARY AND CONFIDENTIAL


DHL Messaging Gateway
Maintenance Requirement Statement (MRS)

Version History

Revision Release Date Updated by Remarks/Comments Status


th
0.1 26 July 2021 Rakkammal Rakkappan First Draft Draft

Document Reviewed By

Version Review Date Organization Reviewer Name Remarks/Comments


0.1 22nd July 2020 ITS Yau Han Min

Doc. Ref: 535209655.docx0.1


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: 535209655.docx0.1


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

Table of Contents
1. INTRODUCTION............................................................................................................ 5
1.1 BACKGROUND........................................................................................................................ 5
2. SYSTEM REQUIREMENTS...........................................................................................6
2.1 REQUIREMENT....................................................................................................................... 6
2.1.1 Convert SDCM v2 to JCM v12......................................................................................... 6
2.2 TRANSPORT MECHANISMS...................................................................................................... 7
2.3 MESSAGE ENCODING AND LIMITATIONS...................................................................................7
2.4 DATA CLASSIFICATION............................................................................................................ 7
3. NON-FUNCTIONAL REQUIREMENTS..........................................................................8
3.1 GENERAL NON-FUNCTIONAL REQUIREMENTS...........................................................................8
3.1.1 Product Specific Non-Functional Requirements..............................................................8
3.1.2 Development Specific Non-Functional Requirements......................................................8
3.1.3 Operations Specific Non-Functional Requirements.........................................................8
APPENDIX A: GLOSSARY OF TERMS...............................................................................10

Doc. Ref: 535209655.docx0.1


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

1. Introduction
1.1 Background

There has been a constant increase in the need to contact customers for missing mandatory information,
delaying the completion of customs’ declaration. This increase was due to:
• Increase in B2C volume
• Focus on undervaluation for proof of purchase
• VAT 2021 changes (changes in the usage of generic data elements)
• Brexit (new clearance requirements)

Cross-references

Document ID Document Name Version

153511- Customs Customer Contact Portal BRS v13.0 V13

Doc. Ref: 535209655.docx0.1


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

2.1.1 Convert SDCM v2 to JCM v12


 DMG currently receives SDCM v2 XML from DCVS.

 For shipment details needed by CCRE, DMG will:


o Query STAN & enrich the shipment detail with the shipment transaction type
classification
*Note: STAN query in DMG is an interim solution. Once DCVS is able to produce the
same information, this querying component will be removed.
o Convert SDCM v2 into JCM v12

 The converted JCM v12 will be sent to CCRE via MQ.

 Fields that can be used for routing & filtering purposes are listed in the table below:

Field Name SDCM Fields


Shipment Origin Service Area ShpPcdDetailsMsg/Bd/Shp/OrgSrvACd
Shipment Origin Country Derived based on Origin Service Area
Shipment Origin Region Derived based on Origin Service Area
Shipment Origin Facility ShpPcdDetailsMsg/Bd/Shp/OrgFcCd
Shipment Destination Service Area ShpPcdDetailsMsg/Bd/Shp/DstSrvACd
Shipment Destination Country Derived based on Destination Service Area
Shipment Destination Region Derived based on Destination Service Area
Shipment Destination Facility ShpPcdDetailsMsg/Bd/Shp/DstFcCd
ShpPcdDetailsMsg/Bd/Shp/GI/@SrcUpdSrvaCd
Else
Generating Service Area ShpPcdDetailsMsg/Bd/Shp/GI/@SrcSrvaCd
Generating Country Derived based on Generated Service Area
Generating Region Derived based on Generated Service Area
Generating Facility ShpPcdDetailsMsg/Bd/Shp/GI/@SrcUpdFcCd
ShpPcdDetailsMsg/Bd/Shp/GI/SrcUpdAppCd
Else
Source Application Code ShpPcdDetailsMsg/Bd/Shp/GI/SrcAppCd
ShpPcdDetailsMsg/Bd/Shp/GlProdSrvCd
WHERE
Product Code ShpPcdDetailsMsg/Bd/Shp/GlProdSrvCd/GlProdSrvClssCd ='P'
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'
Derived based on existence of Service Code “PL” and merge status is
OCR Flag “DTMRG”

Doc. Ref: 535209655.docx0.1


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

Flow diagram:

2.2 Transport Mechanisms


 Transport Mechanism between DCVS,CCRE 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

2.4 Data Classification


 All data processed by the requirements above are classified as restricted.

Doc. Ref: 535209655.docx0.1


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.
 There will be additional internal volume within DMG for query STAN & JCM v12 conversion
before the data out to CCRE, which will be hosted in both AP & EU.
 The current DMG AP & EU infrastructures are sufficient to cater for this requirement.

3.1.1.3Error 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, CCRE and DMG will remain as IBM MQ.

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 IBM ACE 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: 535209655.docx0.1


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: 535209655.docx0.1


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
CCRE Custom Customer Rules Engine
STAN Shipment Type Analytics

Mapping Document:

Mapping_Details_G
CCP.xlsx

Doc. Ref: 535209655.docx0.1


DHL PROPRIETARY AND CONFIDENTIAL

You might also like