Professional Documents
Culture Documents
Implementation Guide
Version control
Version Date Status Author Summary of changes
0.1 07JUN2017 initial Dr. Philipp Billion Initial
0.2 09AUG2017 extended “ Extensions
0.3 14AUG2017 extended “ As template for e-DGD Working Group
0.4 04SEP2017 extended “ Extensions
0.5 11SEP2017 extended Sarah Idir, Beverly Added content sent in via Email
Seebach, Ying Lu
0.6 27SEP2017 extended e-DGD PoC WG Input from working Group Meeting
processed
0.7 13OCT2017 extended Dr. Philipp Billion Further completion
0.8 01NOV2017 extended Dr. Philipp Billion / e- Further additions / corrections based
DGD PoC WG on the results of the F2F-Meeting in BSL
0.99 05DEC2017 extended e-DGD PoC WG Further additions / corrections (not
completed yet)
0.99RC2 27DEC2017 extended Dr. Philipp Billion / e- Adjustments to the use of XFSU-DIS
DGD PoC WG
1.0 29JAN2018 extended e-DGD PoC WG
1.1 06FEB2018 extended Dr. Philipp Billion / e- Adjustments to the use of XFSU-DIS –
DGD PoC WG use of errors after alignment with DG
experts
2.2 06JUN2018 extended e-DGD PoC WG
2.3 13AUG2018 extended Dr. Philipp Billion Change to XFSU DIS data elements
according to feedback from IATA
CMWG
2.4 13AUG2018 Extended e-DGD PoC WG Input from e-DGD F2F-Meeting #14
2.5 13AUG2018 extended Dr. Philipp Billion
2.6 08NOV2018 extended Dr. Philipp Billion Principles for the PoC included
2.7, 2.8 22NOV2018 extended e-DGD PoC WG Minor adjustments
3.0 11DEC2018 extended e-DGD PoC WG Final adjustments based on feedback of
IATA DG experts
3.0.1 11DEC2018 extended e-DGD PoC WG Formatting change
3.0.2 12DEC2018 extended Jacinthe De Oliveira Added table of correspondence with
Appendix B
2
Table of Contents
1. Introduction ................................................................................................................................................................................................ 4
1.1. General Introduction.......................................................................................................................................................................... 4
1.2. Background .......................................................................................................................................................................................... 4
1.3. Objectives ............................................................................................................................................................................................. 4
2. e-DGD principles ...................................................................................................................................................................................... 4
2.1. Business process ............................................................................................................................................................................... 4
2.2. e-DGD Data platform ......................................................................................................................................................................... 4
2.3. Identification and data exchange practice ................................................................................................................................ 5
3. Business Process Requirements ....................................................................................................................................................... 5
3.1. Standard Process ............................................................................................................................................................................... 5
3.2. Process variations .............................................................................................................................................................................. 6
3.3. Additional requirements................................................................................................................................................................... 6
4. Technical specification of message and data fields ................................................................................................................... 7
4.1. Shipper´s Reference ID ................................................................................................................................................................... 7
4.2. XSDG ....................................................................................................................................................................................................... 8
4.3. XFNM ....................................................................................................................................................................................................... 9
4.4. FSU/XFSU-FOH (Freight on Hand at airline) .............................................................................................................................. 9
4.5. FSU/XFSU-RCS (Ready for Carriage at airline) ...................................................................................................................... 10
4.6. FSU/XFSU-DIS (Airline Dangerous Goods acceptance check failed)........................................................................... 10
4.7. Digital accompanying documents ............................................................................................................................................. 12
5. Airline´s requirements to platform ................................................................................................................................................. 14
5.1. Station configuration list ............................................................................................................................................................... 14
6. Irregularities process ........................................................................................................................................................................... 14
6.1. Change of AWB Number by forwarder in the “directly assign”-process ..................................................................... 14
7. Improvement potential........................................................................................................................................................................ 14
7.1. Communication of reopening of update channel ................................................................................................................ 14
7.2. Using the IATA matchmaker infrastructure for carrier capabilities ............................................................................... 14
3
1. Introduction
the e-DGD pilot projects during their runtime in 2018. The
standard will be updated continuously to adopt new
requirements and integrate further improvements.
e-DGD creation, modification, cancellation and use shall be Any e-DGD rejected during the DG acceptance check shall
restricted to parties according to permissions (shipper / be reported back to the data platform with the shipper´s
freight forwarder / airline / GHA / 3rd party). The data reference number of the affected e-DGD and a reason for
platform should validate the training expiration of the users rejection.
for all parties acting with it and shall be administered by
each party.
2.3. Identification and data
2.2.2. Print of e-DGD Data
exchange practice
For full traceability, each e-DGD shall be identifiable and
An electronic copy of the e-DGD (non-editable pdf) should
authenticated. Industry communication standard should be
be made available based on the latest version of the data.
favored in order to ensure that the data platforms and
The signature(s) may be electronic signature(s) or may be
systems are compatible and interoperable.
re-placed by the name(s) (in capitals) of the person
authorized to sign, unless facsimile signature is required by
the local applicable laws and regulations. 2.3.1. 2.3.1 Unique identifier
2.2.6. Legal agreement The shipper provides the data, either with web based data
capture, or via an interface connected to their in-house
Terms and conditions of e-DGD data platform shall cover system. The shipper then assigns the shipment to a
legal agreement between stake-holders (according to IATA forwarder. In assigning the shipment to a forwarder, the
DGR Section 8). shipper´s active part of the process in the plat-form is
finished. In addition to the required marks and labels on
5
packages and overpacks, the shipper shall print and affix a • the forwarder hands over the DG data to the
QR code giving access to the direct link (i.e. no need to login subcontractor. This can be made in many ways, e.g.
or register) to the e-DGD lookalike in PDF format. This QR with sending an e-DGD lookalike in PDF format via
code will be provided by the platform (see chapter 3.3.2). email, or giving the agent access to the forwarder´s
document management system.
After the shipment has been prepared, the shipper can have
full transparency on the acceptance process status and Only as a workaround, the airline might provide an option for
send updates in case of irregularities. getting a paper copy of the e-DGD lookalike, either by the
staff or with a self-service terminal. This solution should
only be a last fallback solution, and not be used on a regular
3.1.2. Forwarder: assign shipment to airline for basis. If the airline provides a paper copy, it will always be a
transport black and white paper copy.
The shipper will then use the paper process with their
3.1.3. Airline: perform acceptance check based forwarder. The shipper will print the paper DGD based on
on e-DGD data and transport shipment the latest data in the platform and provide the paper DGD to
the for-warder. The forwarder will then deliver the shipment
The airline receives the data from the platform and with the paper DGD to the airline. The airline will find the e-
performs the dangerous goods acceptance check based DGD data in the system based on the AWB number and
on that data. No paper will be accepted. The result of the reject the pa-per DGD, according to the rule that no paper
acceptance check will be reported back to the platform. is taken into account if the e-DGD data has been submitted
by the shipper on the platform.
Requirement: It is essential that the platform prevents the
airline from changing e-DGD data other than AWB number, Requirement: it is essential that any changes to the DG data
airport of departure and airport of destination. by the shipper is done in the platform in the “directly
assign“-process.
6
As a precondition for this, the airport of departure should be data then should switch to freeze and no modification
inserted in the e-DGD data and should be the should be possible anymore.
station/airport, where the goods will be delivered and
accepted by the airline. For example if Johannesburg is
open for e-DGD by Air France Cargo and Cape Town is not, 3.3.4. Display feedback / updates / status
there will be a problem if an e-DGD shipment with an origin changes for supply chain stakeholder
Johannesburg is delivered by the forwarder at Cape Town,
which doesn´t support e-DGD. Platforms must inform the users (shipper / forwarder) about
updates / status changes / rejections when they are logged
in the platform or working with an integrated in-house sys-
3.3.2. Platform function to provide short URL tem. For example if an update message is rejected by the
link and QR code to e-DGD lookalike in airline, all stakeholders must be informed according to their
PDF format without login self-administration in the platform (e.g. notification).
4. Technical
In terms of e-DGD, there must be a preliminary and a
permanent data freeze. Data freeze requirements of the
forwarder are not in the scope of this guide, only airline
requirement is covered. specification of
• 3.3.3.1 Preliminary data freeze message and data
Preliminary data freeze in a platform should be performed
as soon as another party further down in the supply chain
fields
starts to work on the shipment or the data (e. g. dangerous
goods acceptance checks by airlines or DG checks by the 4.1. Shipper´s Reference ID
forwarder). As soon as one of these conditions is met, the
platform must prevent the shipper from updating / signing
The Shipper´s Reference ID is unique and used to identify
an updated version of the e-DGD. Until that point, any
change in the DG data will automatically update the e-DGD an e-DGD globally. It is mandatory for the e-DGD process.
lookalike in PDF format to the latest version.
It consists of a:
Preliminary data freeze by the airline side is triggered by the
airline with the FOH status message or a message rejection • Platform identifier: it reflects the entity, that
on an XSDG update. There is no option for the shipper or the guarantees the fulfillment of the underlying business
forwarder to send updates during the DG acceptance rules; this is a combination of 3 characters
check process. (alphanumeric);
Preliminary data freeze can be released in many ways: e.g. • Digital / Paper - process indicator: this informs
bilateral communication, a failed DG acceptance check or whether the message originates from a digital process
stop work on the shipment. This communication is not yet (D) or a paper process (P). These letters are identical
covered electronically, and this option is taken up in the with the <ram:ProcessType> in the XSDG message;
chapter “Improvement potential” below.
• Shipper´s Reference component: this is a
• 3.3.3.2 Permanent data freeze in platform combination of alphanumeric characters to ensure
uniqueness within a platform; the Shipper´s Reference
Permanent data freeze is performed once the shipment has component shouldn´t be longer than 15 characters.
been successfully accepted (RCS status) by the airline. The
The structure of the Shipper´s Reference ID is:
7
“Platform identifier”-“Digital / Paper - process indicator”- between DGR units and code used in the XSDG XML
Schema.
“Shipper´s Reference component”
In that case the airline will capture the DG data in his system
and assign a Shipper´s Reference ID as follow:
But in that case, the shipment will still need to fly with the
original paper DGD tendered with the shipment.
4.2. XSDG
If used for data transmission, the XSDG should be used as
per the Cargo XML standard.
8
Translation table: UNECE annex 20 kiloelectronvolt B29 keV
second SEC s
hertz HTZ Hz 4.3. XFNM
kelvin KEL K
The XFNM should be used as per the Cargo XML standard
degree Celsius CEL °C
to confirm the XSDG message has been received
degree
FAH °F (acknowledgement), processed or rejected. In case an
Fahrenheit
electronic DGD is rejected by the receiving system due to
square metre MTK m²
failure of one or more system validation, an XFNM message
square
CMK cm² should be triggered, containing the applicable rejection
centimetre
millimetre code/s as per the MIP Error Code list.
squared per C17 mm²/s
second Additionally the following content should be added into the
litre LTR L following fields:
millilitre MLT mL
<rsm:BusinessHeaderDocument> <ram:ID>: This field
gallon (US) GLL gal
should be filled identical with the same field in the XSDG.
kilopascal KPA kPa
9
4.5. FSU/XFSU-RCS (Ready for in the OSI-part of the XFSU-DIS according to the following
schema:
Carriage at airline)
Once the DG acceptance check and all other ready for
carriage checks have been successfully completed, the First repetition of
accepting party must issue a formal FSU/XFSU-RCS <rsm:MasterConsignment><ram:ReportedStatus><ram:As
containing the AWB number. The RCS status is sent to and sociatedStatus
used by the platform to freeze the DGD data. Consignment><ram:HandlingOSIInstructions><ram:Descr
iption>
4.6. FSU/XFSU-DIS (Airline
Block should contain the free text rejection information
Dangerous Goods
as entered by the DG checker describing the reason why
acceptance check failed) the shipment was rejected plus any additional relevant
information for all stakeholder.
4.6.1. Data transmission format
Second repetition of
Manual rejections due to a failed DG Acceptance check will <rsm:MasterConsignment><ram:ReportedStatus><ram:As
be transmitted via XFSU with a new shipment status code sociatedStatus
“Shipment rejected”. This message will be transmitted Consignment><ram:HandlingOSIInstructions><ram:Descr
directly to the platform from the airline. iption>
The free text information, the rejection reason code, and the
effected Shipper´s Reference ID(s) should be transmitted
10
One example for the content of the OSI-fields:
<rsm:MasterConsignment>
<…>
<ram:ReportedStatus>
<ram:AssociatedStatusConsignment>
<ram:HandlingOSIInstructions>
<ram:Description>The flammable liquid labels on pieces #1 and #15 are missing</ram:Description>
<ram:DescriptionCode>OSI</ram:DescriptionCode>
</ram:HandlingOSIInstructions>
<ram:HandlingOSIInstructions>
<ram:Description>2019DG13.00</ram:Description>
<ram:DescriptionCode>OSI</ram:DescriptionCode>
</ram:HandlingOSIInstructions>
<ram:HandlingOSIInstructions>
<ram:Description>InF-D-1203912</ram:Description>
<ram:DescriptionCode>OSI</ram:DescriptionCode>
</ram:HandlingOSIInstructions>
<ram:HandlingOSIInstructions>
<ram:Description>InF-D-1203913</ram:Description>
<ram:DescriptionCode>OSI</ram:DescriptionCode>
</ram:HandlingOSIInstructions>
<ram:HandlingOSIInstructions>
<ram:Description> ……</ram:Description>
<ram:DescriptionCode>OSI</ram:DescriptionCode>
</ram:HandlingOSIInstructions>
</ram:AssociatedStatusConsignment>
</ram:ReportedStatus>
</rsm:MasterConsignment>
11
4.6.4. Discrepancy Code list 4.7.1. Types of accompanying documents
The discrepancy code list is set up following the logic of the For each XSDG message, there can be one or more
IATA standard DG - / RA-acceptance check sheet. As a additional accompanying documents shared from the DG
schema for the code list, the following wording should be platforms. There will always be an e-DGD lookalike in PDF
used: format (that may include a facsimile signature if required by
the local applicable laws and regulations), but an unlimited
YYYYTyQQ.QQ number of additional documents can be attached as well. All
digital accompanying documents are expected in PDF
Where:
format.
• “YYYY” is the version of the checklist used (e.g. 2018)
In addition to the e-DGD lookalike, the following
• “Ty” is the type of checklist (“DG” for dangerous goods accompanying documents types can be attached:
checklist for a non-radioactive shipment; “RA” for
dangerous goods checklist for a radioactive shipment) • Packaging Certificate
• Exemption
“2019DG13.00” would refer to question 13 on the 2019 for
dangerous goods checklist for a non-radioactive shipment. • Template Airline Acceptance Check Sheet
12
• 4.7.2.2. XML meta data file
ConversationID
ConversationID passed from DG To correlate with XSDG 2
Portal. Should be matching with the message
conversationID in XSDG.
TotalFileCount
Total count of Documents to be
expected in this conversation ID.
13
5. Airline´s requirements 6.1.2. Shipper or forwarder have triggered a
transmission with a wrong / incomplete
to platform data
6. Irregularities process
Currently there is no electronic communication to the
platform by the airline in case a shipment has achieved FOH
status or was rejected, but the update channel was opened
again on the airline side. As FOH already triggered a
6.1. Change of AWB Number by temporary freeze of data in the platform, the required
forwarder in the “directly unfreezing is not communicated electronically. This
communication could be de-fined and added to increase
assign”-process transparency.