Guidelines : 4-IncidentService from SSN

The message structure of MS2SSN_IncidentDetail_Not can be found here.

In the CISE data model, the common part of the notification can be exchange as described below. The detailed part is composed mainly of free text fields and should be sent as an attached document, either as an XML format (eg the original XML format of SSN) or as a document (PDF, DOC...).

Common part for all incident type

<?xml version="1.0" encoding="UTF-8"?>
<MaritimeSafetyIncident xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://cise.jrc.ec.europa.eu/datamodel/last/xsd/MaritimeSafetyIncident.xsd" xsi:schemaLocation="http://www.cise.eu/datamodel/v1/entity/vessel/ https://cise.jrc.ec.europa.eu/datamodel/last/xsd/entity/vessel/Vessel.xsd http://www.cise.eu/datamodel/v1/entity/movement/ https://cise.jrc.ec.europa.eu/datamodel/last/xsd/entity/movement/Movement.xsd http://www.cise.eu/datamodel/v1/entity/location/ https://cise.jrc.ec.europa.eu/datamodel/last/xsd/entity/location/PortLocation.xsd http://www.cise.eu/datamodel/v1/entity/document/ https://cise.jrc.ec.europa.eu/datamodel/last/xsd/entity/document/VesselDocument.xsd http://www.cise.eu/datamodel/v1/entity/person/ https://cise.jrc.ec.europa.eu/datamodel/last/xsd/entity/person/Person.xsd http://www.cise.eu/datamodel/v1/entity/location/ https://cise.jrc.ec.europa.eu/datamodel/last/xsd/entity/location/NamedLocation.xsd http://www.cise.eu/datamodel/v1/entity/organization/ https://cise.jrc.ec.europa.eu/datamodel/last/xsd/entity/organization/FormalOrganization.xsd http://www.cise.eu/datamodel/v1/entity/document/ https://cise.jrc.ec.europa.eu/datamodel/last/xsd/entity/document/EventDocument.xsd" xmlns:vessel="http://www.cise.eu/datamodel/v1/entity/vessel/" xmlns:movement="http://www.cise.eu/datamodel/v1/entity/movement/" xmlns:loc="http://www.cise.eu/datamodel/v1/entity/location/" xmlns:doc="http://www.cise.eu/datamodel/v1/entity/document/" xmlns:person="http://www.cise.eu/datamodel/v1/entity/person/" xmlns:orga="http://www.cise.eu/datamodel/v1/entity/organization/">

<!-- location of the incident -->
    <LocationRel>
        <Location xsi:type="loc:NamedLocation"><Geometry><Latitude>37.9333</Latitude><Longitude>23.5301</Longitude></Geometry><GeographicName>Balearic Sea</GeographicName></Location>
        <LocationRole>StartPlace</LocationRole>
        <SourceType>Observation</SourceType>
    </LocationRel>
<!-- Information about the vessel involved in the Incident -->
    <InvolvedObjectRel>
        <Object xsi:type="vessel:Vessel"><!-- vessel involved -->
            <Name>HANOVER EXPRESS</Name>
            <LocationRel><!-- Location of the vessel at the time of the reporting -->
                <Location xsi:type="loc:NamedLocation"><Geometry><Latitude>37.9333</Latitude><Longitude>23.5301</Longitude></Geometry><GeographicName>Balearic Sea</GeographicName></Location>
            </LocationRel>
            <InvolvedEventRel> <!-- voyage information of this vessel -->
                <Event xsi:type="movement:Movement">
                    <LocationRel><!-- port of departure of the current voyage -->
                        <Location xsi:type="loc:PortLocation"><LocationCode>EGDAM</LocationCode></Location>
                        <DateTime><EndDate>2017-11-18</EndDate><EndTime>07:35:00Z</EndTime></DateTime>
                        <LocationRole>StartPlace</LocationRole>
                        <SourceType>Declaration</SourceType>
                    </LocationRel>
                    <LocationRel><!-- port of arrival of the current voyage -->
                        <Location xsi:type="loc:PortLocation"><LocationCode>ESBCN</LocationCode></Location>
                        <DateTime><EndDate>2017-11-22</EndDate><EndTime>02:30:00Z</EndTime><StartDate>2017-11-21</StartDate><StartTime>19:00:00Z</StartTime></DateTime>
                        <LocationRole>EndPlace</LocationRole>
                        <SourceType>Declaration</SourceType>
                    </LocationRel>
                    <DocumentRel><!-- information about Hazmat involved in this voyage -->
                        <Document xsi:type="doc:VesselDocument">
                            <ReferenceURI>http://myserver.com/GetDGManifest?imo=9343716</ReferenceURI>
                            <DocumentType>DangerousGoodsManifest</DocumentType>
                        </Document>
                    </DocumentRel>
                    <MovementType>Voyage</MovementType>
                </Event>
                <ObjectRole>Participant</ObjectRole>
            </InvolvedEventRel>
            <InvolvedAgentRel> <!-- Contact for DG Manifest (for Hazmat notification) -->
                <Agent xsi:type="person:Person">
                    <ContactInformation>
                        BEGIN:VCARD
                        VERSION:4.0
                        N:Dupont;Jean;;Mr.;
                        FN:Jean Dupont
                        ORG:ESBCN
                        TEL;TYPE=work,voice;VALUE=uri:tel:+34123456789
                        TEL;TYPE=work,fax;VALUE=uri:tel:+34012345678
                        EMAIL:jean.dupont@example.com
                        END:VCARD
                    </ContactInformation>
                    <FamilyName>Dupont</FamilyName>
                    <GivenName>Jean</GivenName>
                </Agent>
                <AgentRole>DGPContactPoint</AgentRole>
            </InvolvedAgentRel>
            <Nationality>DE</Nationality>
            <TotalPersonsOnBoard>21</TotalPersonsOnBoard>
            <CallSign>DFGX2</CallSign>
            <IMONumber>9343716</IMONumber>
            <IRNumber>000000000</IRNumber>
            <MMSI>218092000</MMSI>
        </Object>
        <ObjectRole>Victim</ObjectRole>
    </InvolvedObjectRel>
<!-- document attached with more details about the incident -->
    <DocumentRel>
        <Document xsi:type="doc:EventDocument">
            <Metadata><FileMediaType>image/jpeg</FileMediaType></Metadata><!-- the document type attached in base 64 -Nota: the code list needs to be improved-->
            <Content><!-- Base 64 binary document -->
77u/PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjw/eG1sLXN0eWxlc2hlZXQgdHlwZT0ndGV4dC94c2wnIGhyZWY9J2h0dHA6Ly9zc25tYWx0YS5tbWEuZ292Lm10OjkwOTAvWFNML1dBU1RFUy54c2wnPz4NCjxXQVNURVMgeG1sbnM9InVybjpldS5lbXNhLnNzbiIgeG1sbnM6eHNpPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYS1pbnN0YW5jZS8iPg0KICAgIDxWZXNzZWxJZGVudGlmaWNhdGlvbiBDYWxsU2lnbj0iVENPTSIgSU1PTnVtYmVyPSI4MjA2NzkxIiBTaGlwTmFtZT0iS0FTSU0gSU1BTU9HTFUiIEZsYWc9IlRVUiIgLz4NCiAgICA8Tm9uQ29tcGxpYW5jZUluZm9ybWF0aW9uIEluc3BlY3Rpb25SZWFzb249IlRpbWJvIiAvPg0KICAgIDxJbnNwZWN0aW9uSW5mb3JtYXRpb24gRGVmaWNpZW5jaWVzPSJsYWNrIG9mIGNsZWFubGluZXNzIiBBY3Rpb25UYWtlbj0ibm9uZSI+DQogICAgICAgIDxJbnNwZWN0aW9uQXV0aG9yaXR5IENvb3JkaW5hdGVzPSJtbXUiIC8+DQogICAgPC9JbnNwZWN0aW9uSW5mb3JtYXRpb24+DQogICAgPEF1dGhvcml0aWVzTm90aWZpZWQgTmV4dFBvcnRPZkNhbGw9IklUQlJJIiBPdGhlckF1dGhvcml0aWVzPSIyMjIyMjIyMjIyMjIyMjIyMjIyMiIgLz4NCjwvV0FTVEVTPg==
            </Content>
            <DocumentType>AccidentReport</DocumentType>
        </Document>
    </DocumentRel>
<!-- the organization reporting the incident-->
    <InvolvedAgentRel>
        <Agent xsi:type="orga:FormalOrganization">
            <ContactInformation>
                BEGIN:VCARD
                VERSION:4.0
                FN:Spanish Guardia Civil
                ORG:ESBCN
                TEL;TYPE=work,voice;VALUE=uri:tel:+34123456789
                TEL;TYPE=work,fax;VALUE=uri:tel:+34012345678
                EMAIL:jean.dupont@example.com
                END:VCARD
            </ContactInformation>            
            <LegalName>Spanish Guardia Civil</LegalName>
        </Agent>
        <AgentRole>Reporter</AgentRole>
    </InvolvedAgentRel>
</MaritimeSafetyIncident>

 

Detailed mapping

CISE data model

element

MS2SSN_PortPlus_Not elementformating or code conversionRemarks
SSNCISE
MaritimeSafetyIncident.InvolvedObjectRel.ObjectRole--

fixed value:

Victim

To be more accurate, it is possible to use also the values: Cause, Participant, Reporter...
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.IMOBody.Notification.Incident.IRVesselIdentificationList.IR_VesselIdentification.IRVessel_IdentityVerified.IMONumber   
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.MMSIBody.Notification.Incident.IRVesselIdentificationList.IR_VesselIdentification.IRVessel_IdentityVerified.MMSINumber   
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.CallSignBody.Notification.Incident.IRVesselIdentificationList.IR_VesselIdentification.IRVessel_IdentityVerified.CallSign   
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.NameBody.Notification.Incident.IRVesselIdentificationList.IR_VesselIdentification.IRVessel_IdentityVerified.ShipName   
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.NationalityBody.Notification.Incident.IRVesselIdentificationList.IR_VesselIdentification.IRVessel_IdentityVerified.Flag   
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.IRNumberBody.Notification.Incident.IRVesselIdentificationList.IR_VesselIdentification.IRVessel_IdentityVerified.IRNumber_FishingVessel   
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.TotalPersonsOnBoardBody.Notification.Incident.IRVesselIdentificationList.IRVesselIdentification.IRVoyageInformation.TotalPersonsOnBoard   
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.InvolvedEventRel.Movement.MovementType--

fixed value:

Voyage

 
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.InvolvedEventRel.Movement.LocationRel1.PortLocation.LocationCodeBody.Notification.Incident.IRVesselIdentificationList.IRVesselIdentification.IRVoyageInformation.PortOfDeparture   
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.InvolvedEventRel.Movement.LocationRel1.LocationRole--fixed value: StartPlace 
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.InvolvedEventRel.Movement.LocationRel1.SourceType--

fixed value:

Declaration

 
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.InvolvedEventRel.Movement.LocationRel2.PortLocation.LocationCodeBody.Notification.Incident.IRVesselIdentificationList.IRVesselIdentification.IRVoyageInformation.PortOfDestination   
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.InvolvedEventRel.Movement.LocationRel2.LocationRole--fixed value: EndPlace 
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.InvolvedEventRel.Movement.LocationRel2.SourceType--

fixed value:

Declaration
 
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.InvolvedEventRel.Movement.DocumentRel.VesselDocument.DocumentType--

fixed value:

DangerousGoodsManifest

 
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.InvolvedEventRel.Movement.DocumentRel.VesselDocument.ReferenceURIBody.Notification.Incident.IRVesselIdentificationList.IRVesselIdentification.CargoManifest.UrlDetails.Url   
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.InvolvedAgentRel.AgentRole--

fixed value:

DGPContactPoint

 

MaritimeSafetyIncident.InvolvedObjectRel.Vessel.InvolvedAgentRel.Person.FamilyName

Body.Notification.Incident.IRVesselIdentificationList.IRVesselIdentification.CargoManifest.ContactDetails.LastName   
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.InvolvedAgentRel.Person.GivenNameBody.Notification.Incident.IRVesselIdentificationList.IRVesselIdentification.CargoManifest.ContactDetails.FirstName   
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.InvolvedAgentRel.Person.ContactInformation.TEL;TYPE=voiceBody.Notification.Incident.IRVesselIdentificationList.IRVesselIdentification.CargoManifest.ContactDetails.Phone   
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.InvolvedAgentRel.Person.ContactInformation.TEL;TYPE=faxBody.Notification.Incident.IRVesselIdentificationList.IRVesselIdentification.CargoManifest.ContactDetails.Fax   
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.InvolvedAgentRel.Person.ContactInformation.EMAILBody.Notification.Incident.IRVesselIdentificationList.IRVesselIdentification.CargoManifest.ContactDetails.EMail   
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.InvolvedAgentRel.Person.ContactInformation.ORGBody.Notification.Incident.IRVesselIdentificationList.IRVesselIdentification.CargoManifest.ContactDetails.LoCode   
MaritimeSafetyIncident.LocationRel.NamedLocation.Geometry.LongitudeBody.Notification.Incident.IRVesselIdentificationList.IRVesselIdentification.ShipPositionAtTimeOfIncident.GeoCoordinates.Longitude  This is the position at the time of the incident
MaritimeSafetyIncident.LocationRel.NamedLocation.Geometry.LatitudeBody.Notification.Incident.IRVesselIdentificationList.IRVesselIdentification.ShipPositionAtTimeOfIncident.GeoCoordinates.Latitude   
MaritimeSafetyIncident.LocationRel.NamedLocation.GeographicNameBody.Notification.Incident.IRVesselIdentificationList.IRVesselIdentification.ShipPositionAtTimeOfIncident.Area.GeographicalArea   
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.LocationRel.NamedLocation.Geometry.LongitudeBody.Notification.Incident.IRVesselIdentificationList.IRVesselIdentification.ShipPositionAtTimeOfReporting.Longitude   
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.LocationRel.NamedLocation.Geometry.LatitudeBody.Notification.Incident.IRVesselIdentificationList.IRVesselIdentification.ShipPositionAtTimeOfReporting.Latitude   
MaritimeSafetyIncident.InvolvedObjectRel.Vessel.LocationRel.NamedLocation.GeographicNameBody.Notification.Incident.IRVesselIdentificationList.IRVesselIdentification.ShipPositionAtTimeOfReporting.GeographicalArea   
MaritimeSafetyIncident.InvolvedAgentRel.AgentRole---

fixed value:

Reporter

MaritimeSafetyIncident.InvolvedAgentRel.FormalOrganization.LegalNameBody.Notification.Incident.AuthorityReportingIncident.AuthorityName   
MaritimeSafetyIncident.InvolvedAgentRel.FormalOrganization.ContactInformation.FNBody.Notification.Incident.AuthorityReportingIncident.AuthorityName   
MaritimeSafetyIncident.InvolvedAgentRel.FormalOrganization.ContactInformation.TEL;TYPE=voiceBody.Notification.Incident.AuthorityReportingIncident.Phone   
MaritimeSafetyIncident.InvolvedAgentRel.FormalOrganization.TEL;TYPE=faxBody.Notification.Incident.AuthorityReportingIncident.Fax   
MaritimeSafetyIncident.InvolvedAgentRel.FormalOrganization.EMAILBody.Notification.Incident.AuthorityReportingIncident.EMail   
MaritimeSafetyIncident.InvolvedAgentRel.FormalOrganization.ORGBody.Notification.Incident.AuthorityReportingIncident.LoCode   
MaritimeSafetyIncident.DocumentRel.DocumentTypeBody.Notification.Incident.IncidentIdentification.Type

codes:

  • Waste
  • SITREP
  • POLREP
  • LostFoundContainers
  • Others
  • FailedNotification
  • VTSRulesInfringement
  • BannedShip
  • InsuranceFailure
  • PilotOrPortReport

codes:

  • IncidentReport
  • AccidentReport
  • EnvironmentalIncidentReport
  • IncidentReport
  • IncidentReport
  • IncidentReport
  • IncidentReport
  • IncidentReport
  • IncidentReport
  • IncidentReport
the codes list of CISE should be improved.
MaritimeSafetyIncident.DocumentRel.Metadata.FileMediaTypeBody.Notification.Incident.IncidentDetailsDocument.Base64Details.DocType

codes:

  • DOC
  • HTML
  • PDF
  • TXT
  • XML
  • XLS

codes:

(code list to be improved)