ISO 28005-2:2011
(Main)Security management systems for the supply chain — Electronic port clearance (EPC) — Part 2: Core data elements
Security management systems for the supply chain — Electronic port clearance (EPC) — Part 2: Core data elements
ISO 28005-2:2011 contains technical specifications that facilitate efficient exchange of electronic information between ships and shore for coastal transit or port calls. It is intended to cover safety and security information requirements related mainly to the relationships between the ship and the port and coastal state authorities. ISO 28005-2:2011 contains the definition of core data elements for use in electronic port clearance (EPC) messages. It contains definitions of core data elements for electronic messaging between ships and shore in the areas of safety, security and marine operations. It does not define any structuring of messages or provide any guidance on what information is required for a particular purpose; it is rather a general data dictionary for safety, security or operation-related maritime information. It is intended for use in XML messages and will for that reason differ somewhat from the similar trade data elements directory (TDED) International Standard, ISO 7372. The core data elements defined in ISO 28005-2:2011 are specified so that their meaning and interpretation in general are independent of the context in which they are used. ISO 28005-2:2011 does not define the message formats required to exchange information. ISO 28005-2:2011 contains definitions of core data elements for EPC. These elements cover all requirements for ship-to-shore and shore-to-ship reporting as defined in the following. All FAL standard declarations (FAL 1 to 7) as defined in the FAL Convention. ISPS reporting requirements as defined in ISPS and MSC 1305. All general ship reporting requirements as defined in IMO Resolution A.851. Recommended reporting on ship-generated waste as defined in MEPC 644 (mandatory within the European Union, as described in EU/2000/59). Required reporting as defined in the bulk loading and unloading code IMO Resolution A.862. ETA reporting to pilot station as defined in IMO Resolution A.960. ISO 28005-2:2011 can also be used for information exchanges between the ship and the ship agent, the port and ship operator or manager. It will not necessarily cover issues such as customs clearance of imported or exported goods or transport service provisions to goods owners.
Systèmes de management de la sécurité pour la chaîne d'approvisionnement — Opérations portuaires assistées par systèmes électroniques — Partie 2: Éléments de données principaux
General Information
Relations
Related Packages
Standards Content (Sample)
INTERNATIONAL ISO
STANDARD 28005-2
First edition
2011-03-01
Security management systems for the
supply chain — Electronic port clearance
(EPC) —
Part 2:
Core data elements
Systèmes de management de la sécurité pour la chaîne
d'approvisionnement — Opérations portuaires assistées par systèmes
électroniques —
Partie 2: Éléments de données principaux
Reference number
ISO 28005-2:2011(E)
©
ISO 2011
---------------------- Page: 1 ----------------------
ISO 28005-2:2011(E)
PDF disclaimer
This PDF file may contain embedded typefaces. In accordance with Adobe's licensing policy, this file may be printed or viewed but
shall not be edited unless the typefaces which are embedded are licensed to and installed on the computer performing the editing. In
downloading this file, parties accept therein the responsibility of not infringing Adobe's licensing policy. The ISO Central Secretariat
accepts no liability in this area.
Adobe is a trademark of Adobe Systems Incorporated.
Details of the software products used to create this PDF file can be found in the General Info relative to the file; the PDF-creation
parameters were optimized for printing. Every care has been taken to ensure that the file is suitable for use by ISO member bodies. In
the unlikely event that a problem relating to it is found, please inform the Central Secretariat at the address given below.
COPYRIGHT PROTECTED DOCUMENT
© ISO 2011
All rights reserved. Unless otherwise specified, no part of this publication may be reproduced or utilized in any form or by any means,
electronic or mechanical, including photocopying and microfilm, without permission in writing from either ISO at the address below or
ISO's member body in the country of the requester.
ISO copyright office
Case postale 56 • CH-1211 Geneva 20
Tel. + 41 22 749 01 11
Fax + 41 22 749 09 47
E-mail copyright@iso.org
Web www.iso.org
Published in Switzerland
ii © ISO 2011 – All rights reserved
---------------------- Page: 2 ----------------------
ISO 28005-2:2011(E)
Contents Page
Foreword .v
1 Scope.1
1.1 General .1
1.2 Application of the core data elements .1
1.3 Types of data elements defined by this part of ISO 28005.2
1.4 Structure of the data element descriptions .3
2 Normative references.3
3 Terms, definitions and abbreviated terms.4
3.1 Terms and definitions .4
3.2 Abbreviated terms.5
4 General provisions.6
4.1 Use of XML name space .6
4.2 Principle for creating tag names in a message file.6
4.3 Structure of data type definitions .6
4.4 Principles for defining enumerated types.7
4.5 Character sets for data fields.7
4.6 No use of XML attributes .7
4.7 Empty tags .8
4.8 Defaults for minOccurs and maxOccurs.8
5 Adapted XSD data types.8
5.1 Introduction.8
5.2 epc:anyURI – Generalized URI .8
5.3 epc:boolean – Boolean flag.8
5.4 epc:date – General date.8
5.5 epc:dateTime – Time and date, with time zone .9
5.6 epc:decimal – Decimal number.9
5.7 epc:duration – Time duration.10
5.8 epc:int – Integer number.10
5.9 epc:string – General string.10
5.10 epc:token – Computer-understandable string .10
6 General data types .11
6.1 Introduction.11
6.2 epc:AttachmentType – Reference to an attached document.11
6.3 epc:ContactInfoType – Contact information .11
6.4 epc:CommunicationNumberType – Communication number information .12
6.5 epc:CountryCodeContentType – Country identification.12
6.6 epc:GenderContentType – Enumeration type for Male/Female.12
6.7 epc:MeasureType – A physical measurement .13
6.8 epc:NameType – Name of person.13
6.9 epc:OrganisationType – Description of an organization .13
6.10 epc:PortType – Identification of a port.14
6.11 epc:PositionType – Geographical position .14
6.12 epc:PostalAddressType – A postal mail address .15
6.13 epc:RemarksType – General remarks.15
6.14 epc:UNLoCodeContentType – UN location code.15
6.15 epc:VersionType – Version code.16
7 Core data types.16
7.1 Introduction.16
7.2 Ship identity and contacts data types.16
© ISO 2011 – All rights reserved iii
---------------------- Page: 3 ----------------------
ISO 28005-2:2011(E)
7.3 Cargo data types. 19
7.4 Crew and passenger data . 26
7.5 Class and certificates. 31
7.6 Security data types. 33
7.7 Service-related data types . 36
7.8 Ship particular types . 38
7.9 Vessel operation data types . 41
7.10 Waste and environmental data types . 53
8 Electronic representation of this part of ISO 28005. 55
8.1 Main XML schema file . 55
8.2 Code set specification schema . 56
Annex A (informative) Certificate codes . 57
Annex B (informative) Classification society codes. 60
Annex C (informative) Onboard and shore duty codes. 61
Annex D (informative) Waste type codes. 65
Annex E (informative) Message type codes . 66
Annex F (informative) Service type codes. 68
Annex G (informative) Examples of cargo and package codes . 69
Annex H (informative) Common unit codes . 70
Annex I (informative) UN hazard classes. 71
Annex J (informative) Ship type codes . 72
Annex K (informative) UNECE purpose of call codes . 75
Annex L (informative) IMO FAL mapping. 76
Annex M (informative) Short overview of XSD coding . 78
Bibliography. 80
iv © ISO 2011 – All rights reserved
---------------------- Page: 4 ----------------------
ISO 28005-2:2011(E)
Foreword
ISO (the International Organization for Standardization) is a worldwide federation of national standards bodies
(ISO member bodies). The work of preparing International Standards is normally carried out through ISO
technical committees. Each member body interested in a subject for which a technical committee has been
established has the right to be represented on that committee. International organizations, governmental and
non-governmental, in liaison with ISO, also take part in the work. ISO collaborates closely with the
International Electrotechnical Commission (IEC) on all matters of electrotechnical standardization.
International Standards are drafted in accordance with the rules given in the ISO/IEC Directives, Part 2.
The main task of technical committees is to prepare International Standards. Draft International Standards
adopted by the technical committees are circulated to the member bodies for voting. Publication as an
International Standard requires approval by at least 75 % of the member bodies casting a vote.
Attention is drawn to the possibility that some of the elements of this document may be the subject of patent
rights. ISO shall not be held responsible for identifying any or all such patent rights.
ISO 28005-2 was prepared by Technical Committee ISO/TC 8, Ships and marine technology.
This first edition of ISO 28005-2 cancels and replaces ISO/PAS 28005-2:2009 which has been technically
revised.
ISO 28005 consists of the following parts, under the general title Security management systems for the supply
chain — Electronic port clearance (EPC):
⎯ Part 2: Core data elements
The following part is under preparation:
⎯ Part 1: Message structures
© ISO 2011 – All rights reserved v
---------------------- Page: 5 ----------------------
INTERNATIONAL STANDARD ISO 28005-2:2011(E)
Security management systems for the supply chain —
Electronic port clearance (EPC) —
Part 2:
Core data elements
1 Scope
1.1 General
This part of ISO 28005 contains technical specifications that facilitate efficient exchange of electronic
information between ships and shore for coastal transit or port calls. It is intended to cover safety and security
information requirements related mainly to the relationships between the ship and the port and coastal state
authorities as defined in this subclause.
This part of ISO 28005 contains the definition of core data elements for use in electronic port clearance (EPC)
messages. It contains definitions of core data elements for electronic messaging between ships and shore in
the areas of safety, security and marine operations. It does not define any structuring of messages or provide
any guidance on what information is required for a particular purpose; it is rather a general data dictionary for
safety, security or operation-related maritime information.
It is intended for use in XML messages and will for that reason differ somewhat from the similar trade data
elements directory (TDED) International Standard, ISO 7372.
The core data elements defined in this part of ISO 28005 are specified so that their meaning and interpretation
in general are independent of the context in which they are used.
This part of ISO 28005 does not define the message formats required to exchange information.
1.2 Application of the core data elements
This part of ISO 28005 contains definitions of core data elements for electronic port clearance (EPC). These
elements cover all requirements for ship-to-shore and shore-to-ship reporting as defined in the following.
a) All FAL standard declarations (FAL 1 to 7) as defined in the FAL Convention.
b) ISPS reporting requirements as defined in ISPS and MSC 1305.
c) All general ship reporting requirements as defined in IMO Resolution A.851.
d) Recommended reporting on ship-generated waste as defined in MEPC 644 (mandatory within the
European Union, as described in EU/2000/59).
e) Required reporting as defined in the bulk loading and unloading code IMO Resolution A.862.
f) ETA reporting to pilot station as defined in IMO Resolution A.960.
Annex L gives a cross-reference between the above references and the core data elements.
© ISO 2011 – All rights reserved 1
---------------------- Page: 6 ----------------------
ISO 28005-2:2011(E)
This part of ISO 28005 can also be used for information exchanges between the ship and the ship agent, the
port and ship operator or manager. It will not necessarily cover issues such as customs clearance of imported
or exported goods or transport service provisions to goods owners.
1.3 Types of data elements defined by this part of ISO 28005
Figure 1 shows some of the types of elements that are defined and referenced in this part of ISO 28005. The
grey boxes represent objects that are not defined in this part of ISO 28005, but which are respectively basis
information and results of using this part of ISO 28005.
The top-most grey box represents standard data types as defined in XML Schema Part 2 (XSD-2). The
bottom-most grey box represents an electronic XML message containing data elements defined by using this
part of ISO 28005.
Standard XSD types
xs:decimal
xs:token
Adapted XSD types
epc:decimal
epc:token
General data types
epc:PortType
epc:PositionType
Core data types
epc:PortOfArrivalType
epc:LocationType
XML message, XSD schema
PortOfArrival
ReportingLocation
Figure 1 — Elements of this part of ISO 28005
Figure 1 does not include all elements in each group, but has selected a few from each group as examples.
From the top downwards, the defined elements are as follows.
⎯ Adapted XSD types: These are basic XSD types with additional restrictions that apply for the use of these
elements in this part of ISO 28005.
⎯ General data types: These are data types that represent common concepts like a port description or a
certificate which normally need to be specialized more to be given a context-specific meaning.
⎯ Core data types: These are data types that also contain a contextual meaning to the more generic
concept, such as an arrival port instead of a general port or a reporting location instead of a general
location.
2 © ISO 2011 – All rights reserved
---------------------- Page: 7 ----------------------
ISO 28005-2:2011(E)
This part of ISO 28005 does not prohibit the use of data types other than the EPC Core Elements when
messages are defined (this is indicated with the thin arrows in Figure 1). However, such data elements will be
given a specific semantic meaning in the specification of the message format.
1.4 Structure of the data element descriptions
Figure 2 gives an outline of the structure of this part of ISO 28005. The two rectangles at the top represent the
general data types outlined in the previous clause while the row of rectangles at the bottom represents the
EPC core elements.
Adapted XSD types (Clause 5)
General data types
(Clause 6)
Class and
Waste and
Ship ID Cargo Crew and Security Service Ship Vessel
environment
passenger certificates particulars operation
related
7.10
7.2 7.3 7.4 7.5 7.6 7.7 7.8 7.9
Figure 2 — Overview of the structure of this part of ISO 28005
The groups are loosely based on the order in which they appear on typical FAL forms:
a) Ship ID: ship identification and contact details.
b) Cargo: data related to cargo and cargo types.
c) Crew and passenger: crew- and passenger-related data.
d) Class and certificates: data related to class and certificates kept on board.
e) Security: mainly ISPS-related data.
f) Service-related: data related to services requested by the ship, including message headers and clearance
request and status.
g) Ship particulars: static data about the ship.
h) Vessel operation: data that is dependent on current operation or voyage; also physical data that changes,
e.g. with loading such as draught.
i) Waste and environment: currently, this section contains information about waste.
The grouping of core elements is for convenience only and need not result in any particular structuring of EPC
messages. Additionally, the data elements, when defined in an XSD file, will not use any formal grouping; all
data elements will have the same name space.
2 Normative references
The following referenced documents are indispensable for the application of this document. For dated
references, only the edition cited applies. For undated references, the latest edition of the referenced
document (including any amendments) applies.
ISO 3166-1, Codes for the representation of names of countries and their subdivisions — Part 1: Country
codes
© ISO 2011 – All rights reserved 3
---------------------- Page: 8 ----------------------
ISO 28005-2:2011(E)
ISO 6346, Freight containers — Coding, identification and marking
ISO 9711-1, Freight containers — Information related to containers on board vessels — Part 1: Bay plan
system
ISO/IEC 10646:2003, Information technology — Universal Multiple-Octet Coded Character Set (UCS)
IETF RFC 3986, Uniform Resource Identifier (URI): Generic Syntax
International Maritime Dangerous Goods (IMDG) Gde, IMO
MEPC.1/Circ.644, Standard Format for the Advance Notification Form for Waste Delivery of Port Reception
Facilities
UNECE R21 (UNECE Recommendation No. 21), Codes for Passengers, Types of Cargo, Packages and
Packaging Materials (with Complementary Codes for Package Names)
UNTDD, United Nations Directories for Electronic Data Interchange for Administration, Commerce and
Transport
3 Terms, definitions and abbreviated terms
3.1 Terms and definitions
For the purposes of this document, the following terms and definitions apply.
3.1.1
character
atomic unit of text as specified by ISO/IEC 10646:2003
NOTE Legal characters include: tab, carriage return, line feed, and the legal characters of The Unicode Standard and
ISO/IEC 10646. The editions cited in this part of ISO 28005 were current at the time of publication; new characters could
be added to The Unicode Standard or ISO/IEC 10646 by amendments or future editions.
3.1.2
core data element
data object of a type defined in Clause 7 of this part of ISO 28005:2010.
NOTE The core data element will be represented as the contents between XML start and end tags, where the tags
have the same name as the core data type with the trailing string “Type” omitted.
3.1.3
core data type
data type defined in Clause 7 of this part of ISO 28005:2010.
NOTE All core data types will have a trailing “Type” in their name which will be removed when the data type is
instantiated as a core data element.
3.1.4
data type
core data type (3.1.3) or another data type defined in Clauses 5 or 6 of this part of ISO 28005:2010.
NOTE All data types will have a name ending with “Type”.
4 © ISO 2011 – All rights reserved
---------------------- Page: 9 ----------------------
ISO 28005-2:2011(E)
3.1.5
electronic port clearance
EPC
process of exchanging information between the ship and its agent and various parties on shore to allow the
ship clearance to enter port and berth
NOTE EPC does not necessarily include customs clearance of goods that are imported or exported.
3.1.6
leg
part of a voyage between a departure port and an arrival port without any intervening port calls
3.1.7
OBO
oil-bulk-ore carrier
O/O carrier
ship whose design is similar to a conventional bulk carrier but that is equipped with pipelines, pumps and an
inert gas plant so as to enable the carriage of oil cargoes in designated spaces
3.1.8
voyage
sailing of the ship from an initial departure port to a final arrival port with or without a number of intervening
port calls
NOTE 1 What constitutes a voyage is defined by the ship's operator or its owner.
NOTE 2 See also leg (3.1.6).
3.1.9
XML schema
definition of the structure of an XML document, written in the XML schema language (XSD)
NOTE The XML schema language is in itself a valid XML structure.
3.2 Abbreviated terms
1)
BLU bulk loading and unloading
2)
DG dangerous goods
HS World Customs Organization's Harmonized System
FAL Facilitation, IMO's Facilitation Committee and standard forms defined in the FAL Convention
[19]
IRI Internationalized Resource Identifier
3)
ISM international safety management
4)
ISPS international ship and port facility security
RORO Roll-on/Roll-off (ship)
[2]
TDED Trade Data Elements Dictionary
1) The BLU code is described in the annex to IMO Resolution A.862.
2) The term “harmful and noxious substances” is also sometimes used instead of “dangerous goods”.
3) The ISM code is defined in Chapter IX of Reference [6].
4) The ISPS code is defined in Chapter XI-2 of Reference [6].
© ISO 2011 – All rights reserved 5
---------------------- Page: 10 ----------------------
ISO 28005-2:2011(E)
URI Uniform Resource Identifier
URL Uniform Resource Locator
XML Extensible Markup Language
XSD XML Schema Definition Language
4 General provisions
4.1 Use of XML name space
4.1.1 XSD name space
[16][17]
All data elements defined in the Schema standards , and which are used in this part of ISO 28005, use
the name space “xs”. Thus, the data type name will be prefixed with “xs:”. This corresponds to the XSD
definition file header including the following attribute:
xmlns:xs="http://www.w3.org/2001/XMLSchema" .
4.1.2 ISO 28005-1 name space
All data types defined in this part of ISO 28005 will be defined in the namespace “epc”. Thus, the data type
name will be prefixed with “epc:”. This corresponds to the XSD file header including the following attribute:
xmlns:epc="http://www.iso.org/28005-1" .
4.2 Principle for creating tag names in a message file
This part of ISO 28005 defines data types that can be used to construct an XML message for exchange of
information between ship and shore. Each information element in the XML file shall have a tag name derived
from the corresponding core data type defined in this part of ISO 28005. The following rules apply.
a) If the information element in the XML file corresponds directly to a core data type defined in this part of
ISO 28005, the tag name of that information element shall be the same as that for the type name without
the trailing “Type” or “ContentType” that the core data type has.
b) If a new information element is created, it should get a name and type which reflects the principles
employed in this part of ISO 28005.
4.3 Structure of data type definitions
4.3.1 Name
All data types defined in this part of ISO 28005 will be given a name that is also included as the first part of the
heading for the clause where the data type is defined.
[15]
The data type name follows the specifications for XML tag names , with the following additional constraints.
a) The name will always end with the string “Type”.
b) Enumerated data types will have the postfix “ContentType”.
NOTE 1 Some core data elements can also have the ending “Type”. In that case, the corresponding core data
type will have the postfix “TypeType”.
6 © ISO 2011 – All rights reserved
---------------------- Page: 11 ----------------------
ISO 28005-2:2011(E)
c) This part of ISO 28005 will use the “Upper Camel Case” in all core data types, i.e. the first letter will be
upper case and, when the tag name consists of a number of concatenated words, each of the words will
start with an upper case letter.
d) The name consists only of characters from the sets (A-Z), (a-z) and, exceptionally, (0-9).
NOTE 2 The names have been selected to be generally understandable in the context of ship-to-shore
communication for port clearance. The names are in normal British English without any special characters. Names
are in singular form except where the data element contains a list of items, in which case the tag name is in plural
form.
4.3.2 Definition
Each data type will have a definition that is intended to give an unambiguous description of what the data
element shall contain and in what context it is valid. This is the first paragraph after the heading of the clause.
4.3.3 Type
Each data type will be defined as a section of XSD code. This section will only cover the actual data type
definition and will not be a valid XML document in itself. Annex M gives a brief overview of the syntax
elements used, but the user of this part of ISO 28005 should refer to Reference [16] for the definitive
descriptions.
4.3.4 Representation
Additional information about how the data field shall be formatted will be contained in the representation
paragraph. This may give, for example, the normative reference to the official sources of enumeration codes.
4.4 Principles for defining enumerated types
Enumerated types, i.e. types that are associated with a fixed set of code values, are defined in one of three
ways.
a) When the code set is small and not defined and maintained by parties external to this part of ISO 28005,
the allowed code values are
...
Questions, Comments and Discussion
Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.