{"openapi":"3.0.3","info":{"title":"DCSA - Event Components","description":"Common components for Events. This domain is central for all Event Hubs and `/v?/events` endPoints (used for polling) in APIs. It is used by\n- [T&T (Track & Trace)](https://app.swaggerhub.com/apis-docs/dcsaorg/DCSA_TNT). Event hub for the following Event types:\n  - TransportEvent\n  - EquipmentEvent\n  - ShipmentEvent\n- Documentation Hub used by [EBL (Electronic Bill of Lading)](https://app.swaggerhub.com/apis/dcsaorg/DCSA_EBL) and [BKG (Booking)](https://app.swaggerhub.com/apis/dcsaorg/DCSA_BKG). Event hub for the following Event types:\n  - ShipmentEvent\n\nFor a history of changes in this domain - please check [GitHub](https://github.com/dcsaorg/DCSA-OpenAPI/tree/master/domain/event#v202). Please also [create a GitHub issue](https://github.com/dcsaorg/DCSA-OpenAPI/issues/new) if you have any questions/comments.\n","license":{"name":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"},"contact":{"name":"Digital Container Shipping Association (DCSA)","url":"https://dcsa.org","email":"info@dcsa.org"},"version":"3.1.0"},"components":{"parameters":{"apiVersion":{"in":"header","name":"API-Version","required":true,"schema":{"type":"string","example":"1.0.0"},"description":"SemVer used to indicate the version of the contract (API version) returned.\n"},"notificationSignature":{"in":"header","name":"Notification-Signature","required":true,"description":"the Notification-Signature is used to sign the notification. The header has the following format: \n\n   Notification-Signature: <signature-type>=<signature>\n\nThe `signature-type` part is a keyword that determines which algorithm was used to compute the signature.\n\nThe signature ***MUST*** cover the entire request body of the request including whitespace and newlines. The content ***MUST*** be decoded into bytes using the UTF-8 encoding before computing the signature. None of the HTTP headers nor the request URL is covered by the signature.\n\nSupported signature typies are:\n- sha256\n\nExample: `sha256=ae688919f5e31f4c210ca6af362ce4d9ed87acfb51c1721a8507ee395de5e2de`\n","schema":{"type":"string","pattern":"\\s*([a-zA-Z0-9-_+]+=[0-9a-fA-F]+)\\s*","example":"sha256=ae688919f5e31f4c210ca6af362ce4d9ed87acfb51c1721a8507ee395de5e2de"}},"signatureHeader":{"in":"header","name":"Signature","required":true,"description":"The signature certifying the request originates from the carrier\n","deprecated":true,"schema":{"properties":{"keyId":{"type":"string","format":"uuid","example":"4fb682bc-3cd1-43a9-a23a-618a61bd87ca"},"created":{"type":"integer","example":1591960384},"headers":{"type":"string","example":"(request-target) (created) date host"},"signature":{"type":"string","example":"aGkgZnJvbSBkZW5tYXJr"}}}},"subscriptionIDHeader":{"in":"header","name":"Subscription-ID","required":true,"description":"The ID of the subscription triggering the event being sent\n","schema":{"type":"string","format":"uuid","example":"b80d923d-e8ac-4c34-9506-55d3de347034"}},"eventID":{"in":"path","name":"eventID","schema":{"$ref":"#/components/schemas/eventID"},"required":true,"description":"The ID of the event to retrieve\n","example":"123e4567-e89b-12d3-a456-426614174000"},"subscriptionID":{"in":"path","name":"subscriptionID","schema":{"$ref":"#/components/schemas/subscriptionID"},"required":true,"description":"The ID of the subscription to retrieve\n","example":"123e4567-e89b-12d3-a456-426614174000"},"carrierBookingReference":{"in":"query","name":"carrierBookingReference","description":"A set of unique characters provided by carrier to identify a booking.\n\nSpecifying this filter will only return events related to this particular `carrierBookingReference`.\n","required":false,"schema":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/carrierBookingReference"}},"carrierBookingRequestReference":{"in":"query","name":"carrierBookingRequestReference","description":"A set of unique characters provided by carrier to identify a booking during the booking request phase.\n\nSpecifying this filter will only return events related to this particular `carrierBookingRequestReference`.\n","required":false,"schema":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/carrierBookingRequestReference"}},"carrierExportVoyageNumber":{"in":"query","name":"carrierExportVoyageNumber","description":"Filter on the vessel carrier-specific identifier of the export Voyage.\n\nSpecifying this filter will only return events related to this particular `carrierExportVoyageNumber`.\n","required":false,"schema":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/carrierExportVoyageNumber"}},"carrierImportVoyageNumber":{"in":"query","name":"carrierImportVoyageNumber","description":"Filter on the vessel carrier-specific identifier of the import Voyage.\n\nSpecifying this filter will only return events related to this particular `carrierImportVoyageNumber`.\n","required":false,"schema":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/carrierImportVoyageNumber"}},"carrierServiceCode":{"in":"query","name":"carrierServiceCode","description":"Filter on the carrier specific identifier of the service.\n\nSpecifying this filter will only return events related to this particular `carrierServiceCode`.\n","required":false,"schema":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/carrierServiceCode"}},"documentReference":{"in":"query","name":"documentReference","description":"Filter on the `documentReference`. The `documentReference` can refer to any document - to qualify the type `documentTypeCode` should also be specified. Please be aware that `documentReference` by itself is not unique and may match different 'types' of documents\n\nSpecifying this filter will only return `ShipmentEvents` related to this particular `documentReference`.\n","required":false,"schema":{"$ref":"#/components/schemas/documentReference"}},"documentTypeCodes":{"in":"query","name":"documentTypeCodes","explode":false,"style":"form","description":"The `documentTypeCode` to filter by. `documentTypeCode` refers to the different 'kinds' of documents supported by the `ShipmentEvent`. Possible values are\n- CBR (Carrier Booking Request)\n- BKG (Booking)\n- SHI (Shipping Instruction)\n- TRD (Transport Document)\n- DEI (Delivery Instructions)\n- DEO (Delivery Order)\n- TRO (Transport Order)\n- CRO (Container Release Order)\n- ARN (Arrival Notice)\n- VGM (Verified Gross Mass)\n- CAS (Cargo Survey)\n- CUC (Customs Clearance)\n- DGD (Dangerous Goods Declaration)\n- OOG (Out of Gauge)\n- CQU (Contract Quotation)\n- INV (Invoice)\n- HCE (Health Certificate)\n- PCE (Phytosanitary Certificate)\n- VCE (Veterinary Certificate)\n- FCE (Fumigation Certificate)\n- ICE (Inspection Certificate)\n- CEA (Certificate of Analysis)\n- CEO (Certificate of Origin)\n\nIt is possible to select multiple values by comma (`,`) separating them. For multiple values the **OR**-operator is used. For example\n\n    documentTypeCodes=SHI,TRD\n    \nMatches **both** ShippingInstruction (`SHI`) **and** TransportDocument (`TRD`) `ShipmentEvents`.\n\nDefault is all `documentTypeCodes`.\n\nMore details can be found on [GitHub](https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/documenttypecodes.csv)\n\nThis filter is only relevant when filtering on `ShipmentEvents`\n","example":"SHI,TRD","schema":{"default":"CBR,BKG,SHI,TRD,DEI,DEO,TRO,CRO,ARN,VGM,CAS,CUC,DGD,OOG,CQU,INV,HCE,PCE,VCE,FCE,ICE,CEA,CEO","type":"array","items":{"$ref":"#/components/schemas/documentTypeCode"}}},"equipmentEventTypeCodes":{"in":"query","name":"equipmentEventTypeCodes","explode":false,"style":"form","description":"The `equipmentEventTypeCode` to filter by. Possible values are\n- LOAD (Loaded)\n- DISC (Discharged)\n- GTIN (Gated in)\n- GTOT (Gated out)\n- STUF (Stuffed)\n- STRP (Stripped)\n- PICK (Pick-up)\n- AVPU (Available for Pick-up)\n- DROP (Drop-off)\n- AVDO (Available for Drop-off)\n- INSP (Inspected)\n- RSEA (Resealed)\n- RMVD (Removed)\n- CUSS (Customs Selected for Scan)\n- CUSI (Customs Selected for Inspection)\n- CUSR (Customs Released)\n- CROS (Crossed)\n\nIt is possible to select multiple values by comma (`,`) separating them. For multiple values the **OR**-operator is used. For example\n    \n    equipmentEventTypeCodes=GTIN,GTOT\n    \nmatches **both** Gated in (`GTIN`) **and** Gated out (`GTOT`) `EquipmentEvents`.\n\nDefault is all `equipmentEventTypeCodes`.\n\nMore details can be found on [GitHub](https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/equipmenteventtypecodes.csv)\n\nThis filter is only relevant when filtering on `EquipmentEvents`\n","example":"GTIN,GTOT","schema":{"default":"LOAD,DISC,GTIN,GTOT,STUF,STRP,AVPU,PICK,AVDO,DROP,INSP,RSEA,RMVD,CUSS,CUSI,CUSR,CROS","type":"array","items":{"$ref":"#/components/schemas/equipmentEventTypeCode"}}},"equipmentReference":{"in":"query","name":"equipmentReference","description":"Will filter by the unique identifier for the equipment, which should follow the BIC ISO Container Identification Number where possible.\n\nSpecifying this filter will only return events related to this particular `equipmentReference`\n","required":false,"schema":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/equipmentReference"}},"eventClassifierCode":{"in":"query","name":"eventClassifierCode","description":"Unique identifier for `eventClassifierCode`.\n","schema":{"items":{"$ref":"#/components/schemas/eventClassifierCode"}}},"eventCreatedDateTime":{"in":"query","name":"eventCreatedDateTime","description":"Limit the result based on the creating date of the event. It is possible to use operators on this query parameter. This is done by adding a colon (`:`) followed by an operator at the end of the queryParameterName (before the equal (`=`))\n\n    eventCreatedDateTime:gte=2021-04-01T14:12:56-01:00\n\nwould result in all events created &#8805; 2021-04-01T14&#58;12&#58;56-01&#58;00\n\nThe following operators are supported\n- `:gte` (&#8805; Greater than or equal)\n- `:gt` (&#62; Greater than)\n- `:lte` (&#8804; Less than or equal)\n- `:lt` (&#60; Less than)\n- `:eq` (&#61; Equal to)\n## Ranges\nIn order to `specify a range` the query parameter needs to be used twice with different operators. If multiple operators are used with this query parameter a logical `AND` is to be used between the operators. So for the following filter:\n\n    eventCreatedDateTime:gte=2021-04-01T14:12:56-01:00 & eventCreatedDateTime:lte=2021-04-03T14:12:56-01:00\n    \nWill result in events within the 2 days range (48 hours) specified. The events matched **MUST** be created on or after (`≥`) 2021-04-**01**T14&#58;12&#58;56-01&#58;00 `AND` on or before (`≤`) 2021-04-**03**T14&#58;12&#58;56-01&#58;00\n\nIf no operator is provided, a **strictly equal** is used (this is equivalent to `:eq` operator).\n","required":false,"example":"2021-04-01T14:12:56-01:00","schema":{"$ref":"#/components/schemas/eventCreatedDateTime"}},"eventDateTime":{"in":"query","name":"eventDateTime","description":"Limit the result based on when the event will happen or has happened. It is possible to use operators on this query parameter. This is done by adding a colon (`:`) followed by an operator at the end of the queryParameterName (before the equal (`=`))\n\n    eventDateTime:gte=2021-04-01T14:12:56-01:00\n\nwould result in all events happened and will happen &#8805; 2021-04-01T14&#58;12&#58;56-01&#58;00\n\nThe following operators are supported\n- `:gte` (&#8805; Greater than or equal)\n- `:gt` (&#62; Greater than)\n- `:lte` (&#8804; Less than or equal)\n- `:lt` (&#60; Less than)\n- `:eq` (&#61; Equal to)\n## Ranges\nIn order to `specify a range` the query parameter needs to be used twice with different operators. If multiple operators are used with this query parameter a logical `AND` is to be used between the operators. So for the following filter:\n\n    eventDateTime:gte=2021-04-01T14:12:56-01:00 & eventDateTime:lte=2021-04-03T14:12:56-01:00\n    \nWill result in events within the 2 days range (48 hours) specified. The events matched **MUST** have happened or will happen within the date range greater than (`≥`) 2021-04-**01**T14&#58;12&#58;56-01&#58;00 `AND` less than (`≤`) 2021-04-**03**T14&#58;12&#58;56-01&#58;00\n\nIf no operator is provided, a **strictly equal** is used (this is equivalent to `:eq` operator).\n","required":false,"example":"2021-04-01T14:12:56-01:00","schema":{"$ref":"#/components/schemas/eventDateTime"}},"iotEventTypeCodes":{"in":"query","name":"iotEventTypeCodes","explode":false,"style":"form","description":"The `iotEventTypeCode` to filter by. Possible values are\n- DETC (Detected)\n\nIt is possible to select multiple values by comma (`,`) separating them. For multiple values the **OR**-operator is used. For example\n    \n    iotEventTypeCodes=DETC\n    \nmatches Detected `IoTEvents`.\n\nDefault is all `iotEventTypeCodes`.\n\nMore details can be found on [GitHub](https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/ioteventtypecodes.csv)\n\nThis filter is only relevant when filtering on `IoTEvents`\n","example":"DETC","schema":{"default":"DETC","type":"array","items":{"$ref":"#/components/schemas/iotEventTypeCode"}}},"operationsEventTypeCodes":{"in":"query","name":"operationsEventTypeCodes","description":"The `operationsEventTypeCode` to filter by. Possible values are\n- STRT (Started)\n- CMPL (Completed)\n- ARRI (Arrived)\n- DEPA (Departed)\n- OMIT (Omitted)\n- CANC (Cancelled)\n\nIt is possible to select multiple values by comma (`,`) separating them. For multiple values the **OR**-operator is used. For example\n\n    operationsEventTypeCodes=ARRI,CMPL\n\nmatches **both** Arrived (`ARRI`) **and** Completed (`CMPL`) `OperationsEvents`.\n\nDefault is all `operationsEventTypeCodes`.\n\nMore details can be found on [GitHub](https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/operationseventtypecodes.csv)\n\nThis filter is only relevant when filtering on `OperationsEvents`\n","example":"ARRI,CMPL","schema":{"default":"STRT,CMPL,ARRI,DEPA,OMIT,CANC","type":"array","items":{"$ref":"#/components/schemas/operationsEventTypeCode"}}},"reeferEventTypeCodes":{"in":"query","name":"reeferEventTypeCodes","explode":false,"style":"form","description":"The `reeferEventTypeCode` to filter by. Possible values are\n- MEAS (Measured)\n- ADJU (Adjusted)\n\nIt is possible to select multiple values by comma (`,`) separating them. For multiple values the **OR**-operator is used. For example\n    \n    reeferEventTypeCodes=MEAS,ADJU\n    \nmatches **both** Measured (`MEAS`) **and** Adjusted (`ADJU`) `ReeferEvents`.\n\nDefault is all `reeferEventTypeCodes`.\n\nMore details can be found on [GitHub](https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/reefereventtypecodes.csv)\n\nThis filter is only relevant when filtering on `ReeferEvents`\n","example":"MEAS,ADJU","schema":{"default":"MEAS","type":"array","items":{"$ref":"#/components/schemas/reeferEventTypeCode"}}},"shipmentEventTypeCodes":{"in":"query","name":"shipmentEventTypeCodes","explode":false,"style":"form","description":"The status of the document in the process to filter by. Possible values are\n- RECE (Received)\n- DRFT (Drafted)\n- PENA (Pending Approval)\n- PENU (Pending Update)\n- PENC (Pending Confirmation)\n- CONF (Confirmed)\n- REJE (Rejected)\n- APPR (Approved)\n- ISSU (Issued)\n- SURR (Surrendered)\n- SUBM (Submitted)\n- VOID (Void)\n- REQS (Requested)\n- CMPL (Completed)\n- HOLD (On Hold)\n- RELS (Released)\n- CANC (Cancelled)\n\nIt is possible to select multiple values by comma (`,`) separating them. For multiple values the **OR**-operator is used. For example\n\n    shipmentEventTypeCodes=RECE,DRFT\n\nmatches **both** Received (`RECE`) **and** Drafted (`DRFT`) `ShipmentEvents`.\n\nDefault is all `shipmentEventTypeCodes`.\n\nMore details can be found on [GitHub](https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/shipmenteventtypecodes.csv).\n\nThis filter is only relevant when filtering on `ShipmentEvents`\n","example":"RECE,DRFT","schema":{"default":"RECE,DRFT,PENA,PENU,PENC,CONF,REJE,APPR,ISSU,SURR,SUBM,VOID,REQS,CMPL,HOLD,RELS,CANC","type":"array","items":{"$ref":"#/components/schemas/shipmentEventTypeCode"}}},"shippingInstructionReference":{"in":"query","name":"shippingInstructionReference","description":"The `shippingInstructionReference` to filter by.\n\nSpecifying this filter will only return events related to this particular `shippingInstructionReference`.\n","required":false,"schema":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/shippingInstructionReference"}},"transportCallReference":{"in":"query","name":"transportCallReference","description":"The `transportCallReference` to filter by.\n\nSpecifying this filter will only return events related to this particular `transportCallReference`\n","required":false,"schema":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/transportCallReference"}},"transportDocumentReference":{"in":"query","name":"transportDocumentReference","description":"The `transportDocumentReference` to filter by.\n\nSpecifying this filter will only return events related to this particular `transportDocumentReference`\n","required":false,"schema":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/transportDocumentReference"}},"transportEventTypeCodes":{"in":"query","name":"transportEventTypeCodes","explode":false,"style":"form","description":"The `transportEventTypeCode` to filter by. Possible values are\n- ARRI (Arrived)\n- DEPA (Departed)\n\nIt is possible to select multiple values by comma (`,`) separating them. For multiple values the **OR**-operator is used. For example\n\n    transportEventTypeCodes=ARRI,DEPA\n\nmatches **both** Arrived (`ARRI`) **and** Departed (`DEPA`) `TransportEvents`.\n\nDefault is all `transportEventTypeCodes`.\n\nMore details can be found on [GitHub](https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/transporteventtypecodes.csv)\n\nThis filter is only relevant when filtering on `TransportEvents`\n","example":"ARRI,DEPA","schema":{"default":"ARRI,DEPA","type":"array","items":{"$ref":"#/components/schemas/transportEventTypeCode"}}},"universalImportVoyageReference":{"in":"query","name":"universalImportVoyageReference","description":"Filter on the unique identifier of the import Voyage.\n\nSpecifying this filter will only return events related to this particular `universalImportVoyageReference`.\n","required":false,"schema":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/universalImportVoyageReference"}},"universalExportVoyageReference":{"in":"query","name":"universalExportVoyageReference","description":"Filter on the unique identifier of the export Voyage.\n\nSpecifying this filter will only return events related to this particular `universalExportVoyageReference`.\n","required":false,"schema":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/universalExportVoyageReference"}},"universalServiceReference":{"in":"query","name":"universalServiceReference","description":"Filter on the unique identifier of the service.\n\nSpecifying this filter will only return events related to this particular `universalServiceReference`.\n","required":false,"schema":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/universalServiceReference"}},"UNLocationCode":{"in":"query","name":"UNLocationCode","description":"The `UN Location Code` to filter by.\n\nSpecifying this filter will only return events related to this particular `UN Location Code`.\n","required":false,"schema":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/UNLocationCode"}},"vesselIMONumber":{"in":"query","name":"vesselIMONumber","description":"The `Vessel IMO Number` to filter by.\n\nSpecifying this filter will only return events related to this particular `vesselIMONumber`.\n","required":false,"schema":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/vesselIMONumber"}}},"schemas":{"metadata":{"type":"object","description":"The metadata of the event \n","allOf":[{"type":"object","properties":{"eventID":{"allOf":[{"$ref":"#/components/schemas/eventID"}]}}},{"type":"object","properties":{"eventCreatedDateTime":{"allOf":[{"$ref":"#/components/schemas/eventCreatedDateTime"}]}}},{"type":"object","properties":{"retractedEventID":{"allOf":[{"$ref":"#/components/schemas/retractedEventID"}]}}},{"type":"object","properties":{"publisher":{"allOf":[{"$ref":"#/components/schemas/publisher"}]}}},{"type":"object","properties":{"publisherRole":{"allOf":[{"$ref":"#/components/schemas/tntPublisherRole"}]}}}],"required":["eventID","eventCreatedDateTime","publisher","publisherRole","eventType"]},"baseEvent":{"type":"object","description":"The Event entity is described as a generalization of all the specific event categories. An event always takes place in relation to a shipment and can additionally be linked to a transport or an equipment\n","allOf":[{"type":"object","properties":{"eventClassifierCode":{"allOf":[{"$ref":"#/components/schemas/eventClassifierCode"}]}}},{"type":"object","properties":{"eventDateTime":{"allOf":[{"$ref":"#/components/schemas/eventDateTime"}]}}}],"required":["eventClassifierCode","eventDateTime"]},"shipmentPayload":{"type":"object","title":"Shipment","description":"The business attributes related to the `ShipmentEvent`.\n","allOf":[{"$ref":"#/components/schemas/baseEvent"},{"$ref":"#/components/schemas/baseShipmentEvent"}]},"equipmentPayload":{"type":"object","title":"Equipment","description":"The business attributes related to the `EquipmentEvent`.\n","allOf":[{"$ref":"#/components/schemas/baseEvent"},{"$ref":"#/components/schemas/baseEquipmentEvent"}]},"transportPayload":{"type":"object","title":"Transport","description":"The business attributes related to the `TransportEvent`.\n","allOf":[{"$ref":"#/components/schemas/baseEvent"},{"$ref":"#/components/schemas/baseTransportEvent"}]},"reeferPayload":{"type":"object","description":"The business attributes related to the `ReeferEvent`.\n","allOf":[{"$ref":"#/components/schemas/baseEvent"},{"$ref":"#/components/schemas/baseReeferEvent"}]},"iotPayload":{"type":"object","description":"The business attributes related to the `IoTEvent`.\n","allOf":[{"$ref":"#/components/schemas/baseEvent"},{"$ref":"#/components/schemas/baseIoTEvent"}]},"event":{"type":"object","description":"The Event consists of 2 elements\n\n- metadata\n- payload\n\nThe metadata object is common for all `eventTypes` and is mandatory. The payload can be `Shipment`, `Equipment` or `Transport` related and is conditional\n","allOf":[{"type":"object","properties":{"metadata":{"allOf":[{"$ref":"#/components/schemas/metadata"},{"type":"object","properties":{"eventType":{"type":"string","description":"The type of the Event - to be used as a discriminator. Possible values are\n\n- SHIPMENT (A Shippment event)\n- EQUIPMENT (An Equipment event)\n- TRANSPORT (A Transport event)\n","enum":["SHIPMENT","EQUIPMENT","TRANSPORT"],"example":"SHIPMENT"}}}]}}},{"type":"object","properties":{"payload":{"description":"This is a conditional object - if `retractedEventID` is **not** provided in the `metadata` then this `payload` object is mandatory\n","oneOf":[{"$ref":"#/components/schemas/shipmentPayload"},{"$ref":"#/components/schemas/equipmentPayload"},{"$ref":"#/components/schemas/transportPayload"}]}}}],"required":["metadata"]},"baseShipmentEvent":{"type":"object","description":"The `ShipmentEvent` is a specialized event to handle all events related to documents.\n","allOf":[{"type":"object","properties":{"eventDateTime":{"description":"The local date and time, when the event took place, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. Often this is the same as eventCreatedDateTime (which is when the event is created)\n"}}},{"type":"object","properties":{"eventClassifierCode":{"description":"For `ShipmentEvents` the `eventClassifierCode` **must** be `ACT`\n","enum":["ACT"],"example":"ACT"}}},{"type":"object","properties":{"shipmentEventTypeCode":{"allOf":[{"$ref":"#/components/schemas/shipmentEventTypeCode"}]}}},{"type":"object","properties":{"documentTypeCode":{"allOf":[{"$ref":"#/components/schemas/documentTypeCode"}]}}},{"type":"object","properties":{"documentReference":{"allOf":[{"$ref":"#/components/schemas/documentReference"}]}}},{"type":"object","properties":{"reason":{"allOf":[{"$ref":"#/components/schemas/reason"}]}}},{"type":"object","properties":{"relatedDocumentReferences":{"allOf":[{"$ref":"#/components/schemas/relatedDocumentReferences"}]}}},{"type":"object","properties":{"references":{"allOf":[{"$ref":"#/components/schemas/references"}]}}}],"required":["shipmentEventTypeCode","documentTypeCode","documentReference"]},"shipmentEvent":{"type":"object","description":"The `ShipmentEvent` is a specialized event to handle all events related to documentation.\n","allOf":[{"type":"object","properties":{"metadata":{"description":"The `metadata` of the `ShipmentEvent` - includes all non-business related attributes\n","allOf":[{"$ref":"#/components/schemas/metadata"},{"type":"object","properties":{"eventType":{"type":"string","description":"The type of the Event - in case of a `ShipmentEvent` it must be `SHIPMENT`\n","enum":["SHIPMENT"],"example":"SHIPMENT"}}}]}}},{"type":"object","properties":{"payload":{"description":"The business attributes related to the `ShipmentEvent`.\n\nThis is a conditional object - if `retractedEventID` is **not** provided in the `metadata` then this object is mandatory\n","allOf":[{"$ref":"#/components/schemas/baseEvent"},{"$ref":"#/components/schemas/baseShipmentEvent"}]}}}],"required":["metadata"]},"baseTransportEvent":{"type":"object","description":"The `TransportEvent` is a specialized event to handle all events related to transportation.\n","allOf":[{"type":"object","properties":{"eventClassifierCode":{"description":"For `TransportEvents` the `eventClassifierCode` can be one of the following values\n- ACT (Actual)\n- PLN (Planned)\n- EST (Estimated)\n","enum":["ACT","PLN","EST"],"example":"ACT"}}},{"type":"object","properties":{"transportEventTypeCode":{"$ref":"#/components/schemas/transportEventTypeCode"}}},{"type":"object","properties":{"delayReasonCode":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/delayReasonCode"}}},{"type":"object","properties":{"changeRemark":{"$ref":"#/components/schemas/changeRemark"}}},{"type":"object","properties":{"transportCall":{"$ref":"#/components/schemas/transportCall"}}},{"type":"object","properties":{"relatedDocumentReferences":{"allOf":[{"$ref":"#/components/schemas/relatedDocumentReferences"}]}}},{"type":"object","properties":{"references":{"allOf":[{"$ref":"#/components/schemas/references"}]}}}],"required":["transportEventTypeCode","transportCall"]},"transportEvent":{"type":"object","description":"The `TransportEvent` is a specialized event to handle all events related to transportation.\n","allOf":[{"type":"object","properties":{"metadata":{"description":"The `metadata` of the `TransportEvent` - includes all non-business related attributes\n","allOf":[{"$ref":"#/components/schemas/metadata"},{"type":"object","properties":{"eventType":{"type":"string","description":"The type of the Event - in case of a `TransportEvent` it must be `TRANSPORT`\n","enum":["TRANSPORT"],"example":"TRANSPORT"}}}]}}},{"type":"object","properties":{"payload":{"description":"The business attributes related to the `TransportEvent`.\n\nThis is a conditional object - if `retractedEventID` is **not** provided in the `metadata` then this object is mandatory\n","allOf":[{"$ref":"#/components/schemas/baseEvent"},{"$ref":"#/components/schemas/baseTransportEvent"}]}}}],"required":["metadata"]},"baseEquipmentEvent":{"type":"object","description":"The `EquipmentEvent` is a specialized event to handle all events related to transportation.\n","allOf":[{"type":"object","properties":{"eventClassifierCode":{"description":"For `EquipmentEvents` the `eventClassifierCode` can be one of the following values\n- ACT (Actual)\n- PLN (Planned)\n- EST (Estimated)\n","enum":["ACT","PLN","EST"],"example":"EST"}}},{"type":"object","properties":{"equipmentEventTypeCode":{"allOf":[{"$ref":"#/components/schemas/equipmentEventTypeCode"}]}}},{"type":"object","properties":{"equipmentReference":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/equipmentReference"}]}}},{"type":"object","properties":{"ISOEquipmentCode":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/ISOEquipmentCode"}]}}},{"type":"object","properties":{"emptyIndicatorCode":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/emptyIndicatorCode"}]}}},{"type":"object","properties":{"isTransshipmentMove":{"type":"boolean","description":"Indicates whether this event is originated in relation to an ocean transshipment or inter terminal move. `isTransshipmentMove` can be set to true in combination with one of the following `equipmentEventTypeCodes`:\n\n- `LOAD` (Load)\n- `DISC` (Discharge)\n- `GTIN` (Gate In)\n- `GTOT` (Gate Out)\n- `PICK` (Pick-up)\n- `DROP` (Drop-off)\n","example":true}}},{"type":"object","properties":{"eventLocation":{"description":"General purpose object to capture the location in the `EquipmentEvent` whenever it is **not** associated with a `TransportCall` (this could be stuffing and stripping). The location can be specified in **one** of the following ways:\n\n- `UN Location Code`\n- `Facility`\n- `Address`\n- `Geolocation`\n","oneOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/LOCATION_DOMAIN/3.0.0#/components/schemas/unLocationLocation"},{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/LOCATION_DOMAIN/3.0.0#/components/schemas/facilityLocation"},{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/LOCATION_DOMAIN/3.0.0#/components/schemas/addressLocation"},{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/LOCATION_DOMAIN/3.0.0#/components/schemas/geoLocation"}],"discriminator":{"propertyName":"locationType","mapping":{"UNLO":"https://api.swaggerhub.com/domains/dcsaorg/LOCATION_DOMAIN/3.0.0#/components/schemas/unLocationLocation","FACI":"https://api.swaggerhub.com/domains/dcsaorg/LOCATION_DOMAIN/3.0.0#/components/schemas/facilityLocation","ADDR":"https://api.swaggerhub.com/domains/dcsaorg/LOCATION_DOMAIN/3.0.0#/components/schemas/addressLocation","GEOL":"https://api.swaggerhub.com/domains/dcsaorg/LOCATION_DOMAIN/3.0.0#/components/schemas/geoLocation"}}}}},{"type":"object","properties":{"facilityTypeCode":{"type":"string","description":"The code to identify the specific type of facility. The code indicates which role the facility plays if this `EquipmentEvent` is related to *stuffing*/*stipping* (in case the event does not have a `transportCall`). Possible values\n- BORD (Border)\n- CLOC (Customer location)\n- COFS (Container freight station)\n- OFFD (Off dock storage)\n- DEPO (Depot)\n- INTE (Inland terminal)\n- POTE (Port terminal)\n- RAMP (Ramp)\n- WAYP (Waypoint)\n","enum":["BORD","CLOC","COFS","OFFD","DEPO","INTE","POTE","RAMP","WAYP"],"example":"POTE"}}},{"type":"object","properties":{"transportCall":{"allOf":[{"$ref":"#/components/schemas/transportCall"}]}}},{"type":"object","properties":{"relatedDocumentReferences":{"allOf":[{"$ref":"#/components/schemas/relatedDocumentReferences"}]}}},{"type":"object","properties":{"references":{"allOf":[{"$ref":"#/components/schemas/references"}]}}},{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DOCUMENTATION_DOMAIN/2.1.0#/components/schemas/seals"}],"required":["equipmentEventTypeCode","emptyIndicatorCode"]},"equipmentEvent":{"type":"object","description":"The `EquipmentEvent` is a specialized event to handle all events related to equipment (containers).\n","allOf":[{"type":"object","properties":{"metadata":{"description":"The `metadata` of the `EquipmentEvent` - includes all non-business related attributes\n","allOf":[{"$ref":"#/components/schemas/metadata"},{"type":"object","properties":{"eventType":{"type":"string","description":"The type of the Event - in case of a `EquipmentEvent` it must be `EQUIPMENT`\n","enum":["EQUIPMENT"],"example":"EQUIPMENT"}}}]}}},{"type":"object","properties":{"payload":{"description":"The business attributes related to the `EquipmentEvent`.\n\nThis is a conditional object - if `retractedEventID` is **not** provided in the `metadata` then this object is mandatory\n","allOf":[{"$ref":"#/components/schemas/baseEvent"},{"$ref":"#/components/schemas/baseEquipmentEvent"}]}}}],"required":["metadata"]},"reeferMeasurements":{"type":"object","description":"Measured values from the `Reefer` container. This object is conditionally required if this is an event containing measured values (`reeferEventTypeCode=MEAS)`.\n","allOf":[{"type":"object","properties":{"ambientTemperature":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/measuredAmbientTemperature"}]}}},{"type":"object","properties":{"temperature":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/measuredTemperature"}]}}},{"type":"object","properties":{"temperatureUnit":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/temperatureUnit"}]}}},{"type":"object","properties":{"o2":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/measuredO2"}]}}},{"type":"object","properties":{"co2":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/measuredCo2"}]}}},{"type":"object","properties":{"humidity":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/measuredHumidity"}]}}},{"type":"object","properties":{"airExchange":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/measuredAirExchange"}]}}},{"type":"object","properties":{"airExchangeUnit":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/airExchangeUnit"}]}}}]},"reeferSetpoint":{"type":"object","description":"The setpoint values of the `Reefer` container. In case this is an adjusted event (`reeferEventTypeCode=ADJU`) - only values that have been adjusted should be provided.\n","allOf":[{"type":"object","properties":{"temperature":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/equipmentSetpointTemperature"}]}}},{"type":"object","properties":{"temperatureUnit":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/temperatureUnit"}]}}},{"type":"object","properties":{"o2":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/equipmentSetpointO2"}]}}},{"type":"object","properties":{"co2":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/equipmentSetpointCo2"}]}}},{"type":"object","properties":{"humidity":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/equipmentSetpointHumidity"}]}}},{"type":"object","properties":{"airExchange":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/equipmentSetpointAirExchange"}]}}},{"type":"object","properties":{"airExchangeUnit":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/airExchangeUnit"}]}}}]},"baseReeferEvent":{"type":"object","description":"The `ReeferEvent` is a specialized event to handle all events related to reefer readings.\n","allOf":[{"type":"object","properties":{"eventDateTime":{"description":"The local date and time, when the event took place, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. Often this is the same as eventCreatedDateTime (which is when the event is created)\n"}}},{"type":"object","properties":{"eventClassifierCode":{"description":"For `ReeferEvents` the `eventClassifierCode` **must** be `ACT`\n","enum":["ACT"],"example":"ACT"}}},{"type":"object","properties":{"reeferEventTypeCode":{"allOf":[{"$ref":"#/components/schemas/reeferEventTypeCode"}]}}},{"type":"object","properties":{"measurements":{"allOf":[{"$ref":"#/components/schemas/reeferMeasurements"}]}}},{"type":"object","properties":{"setpoints":{"allOf":[{"$ref":"#/components/schemas/reeferSetpoint"}]}}},{"type":"object","properties":{"geoLocation":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/LOCATION_DOMAIN/2.0.2#/components/schemas/geoLocation"},{"description":"A location expressed using latitude and longitude\n"}]}}},{"type":"object","properties":{"equipmentReference":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/equipmentReference"}]}}},{"type":"object","properties":{"relatedDocumentReferences":{"allOf":[{"$ref":"#/components/schemas/relatedDocumentReferences"}]}}}],"required":["reeferEventTypeCode","equipmentReference"]},"reeferEvent":{"type":"object","description":"The `ReeferEvent` is a specialized event to handle all events related to reefer readings.\n","allOf":[{"type":"object","properties":{"metadata":{"description":"The `metadata` of the `ReeferEvent` - includes all non-business related attributes\n","allOf":[{"$ref":"#/components/schemas/metadata"},{"type":"object","properties":{"eventType":{"type":"string","description":"The type of the Event - in case of a `ReeferEvent` it must be `REEFER`\n","enum":["REEFER"],"example":"REEFER"}}}]}}},{"type":"object","properties":{"payload":{"description":"The business attributes related to the `ReeferEvent`.\n\nThis is a conditional object - if `retractedEventID` is **not** provided in the `metadata` then this object is mandatory\n","allOf":[{"$ref":"#/components/schemas/baseEvent"},{"$ref":"#/components/schemas/baseReeferEvent"}]}}}],"required":["metadata"]},"baseIoTEvent":{"type":"object","description":"The `IoTEvent` is a specialized event to handle all events related to IoT readings.\n","allOf":[{"type":"object","properties":{"eventDateTime":{"description":"The local date and time, when the event took place, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. Often this is the same as eventCreatedDateTime (which is when the event is created)\n"}}},{"type":"object","properties":{"eventClassifierCode":{"description":"For `IoTEvents` the `eventClassifierCode` **must** be `ACT`\n","enum":["ACT"],"example":"ACT"}}},{"type":"object","properties":{"iotEventTypeCode":{"allOf":[{"$ref":"#/components/schemas/iotEventTypeCode"}]}}},{"type":"object","properties":{"iotEventCode":{"allOf":[{"$ref":"#/components/schemas/iotEventCode"}]}}},{"type":"object","properties":{"geoLocation":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/LOCATION_DOMAIN/2.0.2#/components/schemas/geoLocation"},{"description":"A location expressed using latitude and longitude\n"}]}}},{"type":"object","properties":{"equipmentReference":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/equipmentReference"}]}}},{"type":"object","properties":{"relatedDocumentReferences":{"allOf":[{"$ref":"#/components/schemas/relatedDocumentReferences"}]}}}],"required":["iotEventTypeCode","iotEventCode","equipmentReference"]},"iotEvent":{"type":"object","description":"The `IoTEvent` is a specialized event to handle all events related to IoT readings.\n","allOf":[{"type":"object","properties":{"metadata":{"description":"The `metadata` of the `IoTEvent` - includes all non-business related attributes\n","allOf":[{"$ref":"#/components/schemas/metadata"},{"type":"object","properties":{"eventType":{"type":"string","description":"The type of the Event - in case of a `IoTEvent` it must be `IOT`\n","enum":["IOT"],"example":"IOT"}}}]}}},{"type":"object","properties":{"payload":{"description":"The business attributes related to the `IoTEvent`.\n\nThis is a conditional object - if `retractedEventID` is **not** provided in the `metadata` then this object is mandatory\n","allOf":[{"$ref":"#/components/schemas/baseEvent"},{"$ref":"#/components/schemas/baseIoTEvent"}]}}}],"required":["metadata"]},"publisher":{"type":"object","description":"The party sending the event\n","allOf":[{"type":"object","properties":{"partyName":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/partyName"}]}}},{"type":"object","properties":{"carrierCode":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/carrierCode"}]}}},{"type":"object","properties":{"carrierCodeListProvider":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/carrierCodeListProvider"}]}}}],"required":["carrierCode","carrierCodeListProvider"]},"publisherX":{"type":"object","description":"The party sending the event\n","properties":{"partyName":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/partyName"}]},"carrierCode":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/carrierCode"}]},"carrierCodeListProvider":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/carrierCodeListProvider"}]}},"anyOf":[{"required":["carrierCode","carrierCodeListProvider"]}],"required":["carrierCode","carrierCodeListProvider"]},"shipmentSubscriptionBody":{"type":"object","allOf":[{"type":"object","properties":{"shipmentEventTypeCodes":{"allOf":[{"$ref":"#/components/schemas/shipmentEventTypeCodes"}]}}},{"type":"object","properties":{"documentTypeCodes":{"allOf":[{"$ref":"#/components/schemas/documentTypeCodes"}]}}},{"type":"object","properties":{"documentReference":{"allOf":[{"$ref":"#/components/schemas/documentReference"},{"description":"The `documentReference` to filter by. Specifying this value will only return `shipmentEvents` related to this specific `documentReference`.\n\nIf specified - the `documentTypeCode` filter should **also** be used as `documentReference` is not neccessarily unique by itself.\n"}]}}},{"type":"object","properties":{"equipmentReference":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/equipmentReference"},{"description":"The `equipmentReference` to filter by. Specifying this value will only return `shipmentEvents` related to this specific `equipmentReference`.\n"}]}}}]},"equipmentSubscriptionBody":{"type":"object","allOf":[{"type":"object","properties":{"equipmentEventTypeCodes":{"allOf":[{"$ref":"#/components/schemas/equipmentEventTypeCodes"}]}}},{"type":"object","properties":{"equipmentReference":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/equipmentReference"},{"description":"The `equipmentReference` to filter by. Specifying this value will only return `equipmentEvents` related to this specific `equipmentReference`.\n"}]}}},{"$ref":"#/components/schemas/transportCallSubscriptionBody"}]},"transportSubscriptionBody":{"type":"object","allOf":[{"type":"object","properties":{"transportEventTypeCodes":{"allOf":[{"$ref":"#/components/schemas/transportEventTypeCodes"}]}}},{"$ref":"#/components/schemas/transportCallSubscriptionBody"}]},"transportCallSubscriptionBody":{"type":"object","allOf":[{"type":"object","properties":{"transportCallReference":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/transportCallReference"},{"description":"Specifying this filter will only return events related to this specific `transportCallReference`.\n"}]}}},{"type":"object","properties":{"vesselIMONumber":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/vesselIMONumber"},{"description":"This filter can be used to only send events related to a specific `vesselIMONumber`.\n"}]}}},{"type":"object","properties":{"carrierExportVoyageNumber":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/carrierExportVoyageNumber"},{"description":"This filter can be used to only send events related to a specific `carrierExportVoyageNumber`.\n"}]}}},{"type":"object","properties":{"universalExportVoyageReference":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/universalExportVoyageReference"},{"description":"This filter can be used to only send events related to a specific `universalExportVoyageReference`.\n"}]}}},{"type":"object","properties":{"carrierServiceCode":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/carrierServiceCode"},{"description":"This filter can be used to only send events related to a specific `carrierServiceCode`.\n"}]}}},{"type":"object","properties":{"universalServiceReference":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/universalServiceReference"},{"description":"This filter can be used to only send events related to a specific `universalServiceReference`.\n"}]}}},{"type":"object","properties":{"UNLocationCode":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/UNLocationCode"},{"description":"This filter can be used to only send events related to a specific `UNLocationCode`.\n"}]}}}]},"reeferSubscriptionBody":{"type":"object","allOf":[{"type":"object","properties":{"carrierBookingReference":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/carrierBookingReference"},{"description":"The reference to a Booking. Using this filter in a subscription will only return Events that are related to the `carrierBookingReference` specified\n"}]}}},{"type":"object","properties":{"equipmentReference":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/equipmentReference"},{"description":"The `equipmentReference` to filter by. Specifying this value will only return `reeferEvents` related to this specific `equipmentReference`.\n"}]}}}]},"iotSubscriptionBody":{"type":"object","allOf":[{"type":"object","properties":{"iotEventTypeCodes":{"allOf":[{"$ref":"#/components/schemas/iotEventTypeCodes"}]}}},{"type":"object","properties":{"carrierBookingReference":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/carrierBookingReference"},{"description":"The reference to a Booking. Using this filter in a subscription will only return Events that are related to the `carrierBookingReference` specified\n"}]}}},{"type":"object","properties":{"equipmentReference":{"allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/equipmentReference"},{"description":"The `equipmentReference` to filter by. Specifying this value will only return `IoTEvents` related to this specific `equipmentReference`.\n"}]}}}]},"relatedDocumentReferences":{"type":"array","description":"An optional list of key-value (`type`-`value`) pairs representing links to objects relevant to the event. The `type`-field is used to describe where the `value`-field is pointing to.\n","example":[{"type":"BKG","value":"ABC123059"},{"type":"TRD","value":"85943567"}],"items":{"type":"object","properties":{"type":{"type":"string","description":"The `type` is used to identify the type of information `value` points to. Can be one of the following values\n- CBR (Carrier Booking Request)\n- BKG (Booking)\n- SHI (Shipping Instruction)\n- TRD (Transport Document)\n- DEI (Delivery Instructions)\n- DEO (Delivery Order)\n- TRO (Transport Order)\n- CRO (Container Release Order)\n- ARN (Arrival Notice)\n- VGM (Verified Gross Mass)\n- CAS (Cargo Survey)\n- CUC (Customs Clearance)\n- DGD (Dangerous Goods Declaration)\n- OOG (Out of Gauge)\n- CQU (Contract Quotation)\n- INV (Invoice)\n- HCE (Health Certificate)\n- PCE (Phytosanitary Certificate)\n- VCE (Veterinary Certificate)\n- FCE (Fumigation Certificate)\n- ICE (Inspection Certificate)\n- CEA (Certificate of Analysis)\n- CEO (Certificate of Origin)\n\nMore details can be found on [GitHub](https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/documenttypecodes.csv)\n","example":"SHI","enum":["CBR","BKG","SHI","TRD","DEI","DEO","TRO","CRO","ARN","VGM","CAS","CUC","DGD","OOG","CQU","INV","HCE","PCE","VCE","FCE","ICE","CEA","CEO"]},"value":{"type":"string","maxLength":100,"description":"The reference to the object described by `type`\n","example":"123e4567e89b"}}}},"transportCall":{"type":"object","allOf":[{"type":"object","properties":{"transportCallReference":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/transportCallReference"}}},{"type":"object","properties":{"transportCallSequenceNumber":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/transportCallSequenceNumber"}}},{"type":"object","properties":{"location":{"description":"General purpose object to capture the location of the `TransportCall`. The location can be specified in **one** of the following ways:\n\n- `UN Location Code`\n- `Facility`\n- `Address`\n- `GeoLocation`\n","oneOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/LOCATION_DOMAIN/3.0.0#/components/schemas/unLocationLocation"},{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/LOCATION_DOMAIN/3.0.0#/components/schemas/facilityLocation"},{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/LOCATION_DOMAIN/3.0.0#/components/schemas/addressLocation"},{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/LOCATION_DOMAIN/3.0.0#/components/schemas/geoLocation"}],"discriminator":{"propertyName":"locationType","mapping":{"UNLO":"https://api.swaggerhub.com/domains/dcsaorg/LOCATION_DOMAIN/3.0.0#/components/schemas/unLocationLocation","FACI":"https://api.swaggerhub.com/domains/dcsaorg/LOCATION_DOMAIN/3.0.0#/components/schemas/facilityLocation","ADDR":"https://api.swaggerhub.com/domains/dcsaorg/LOCATION_DOMAIN/3.0.0#/components/schemas/addressLocation","GEOL":"https://api.swaggerhub.com/domains/dcsaorg/LOCATION_DOMAIN/3.0.0#/components/schemas/geoLocation"}}}}},{"type":"object","properties":{"facilityTypeCode":{"type":"string","description":"The code to identify the specific type of facility. The code indicates which role the facility plays during the `transportCall`. Possible values\n- BORD (Border)\n- CLOC (Customer location)\n- COFS (Container freight station)\n- OFFD (Off dock storage)\n- DEPO (Depot)\n- INTE (Inland terminal)\n- POTE (Port terminal)\n- RAMP (Ramp)\n- WAYP (Waypoint)\n","enum":["BOCR","CLOC","COFS","OFFD","DEPO","INTE","POTE","RAMP","WAYP"],"example":"POTE"}}},{"type":"object","oneOf":[{"$ref":"#/components/schemas/vesselTransportCall"},{"$ref":"#/components/schemas/bargeTransportCall"},{"$ref":"#/components/schemas/railTransportCall"},{"$ref":"#/components/schemas/truckTransportCall"}],"discriminator":{"propertyName":"modeOfTransport","mapping":{"VESSEL":"#/components/schemas/vesselTransportCall","BARGE":"#/components/schemas/bargeTransportCall","RAIL":"#/components/schemas/railTransportCall","TRUCK":"#/components/schemas/truckTransportCall"}}}],"required":["transportCallReference"]},"railTransportCall":{"type":"object","title":"Rail Transport Call","description":"A Transport Call used for Rail\n","properties":{"modeOfTransport":{"type":"string","description":"The mode of transport as defined by DCSA. For the `RailTransportCall` this needs to be `RAIL`\n","enum":["RAIL"],"example":"RAIL"},"railCar":{"type":"string","maxLength":50,"description":"A railcar is a type of railway vehicle that is designed to transport freight or passengers on a railway track. They are also known as rail vehicles, railcars, or rolling stock. Railcars can be powered by an on-board locomotive or they can be pulled by a separate locomotive. \n"},"railService":{"type":"string","maxLength":50,"description":"A rail service number is a unique identifying number assigned to a specific rail service or train.\n"},"departureID":{"type":"string","maxLength":100,"description":"A departure ID (also known as a departure reference number) is a unique identifying number or code that is assigned to a specific departure of a rail\n"}},"required":["modeOfTransport","transportCallReference"]},"truckTransportCall":{"type":"object","title":"Truck Transport Call","description":"A Transport Call used for Truck\n","properties":{"modeOfTransport":{"type":"string","description":"The mode of transport as defined by DCSA. For the `TruckTransportCall` this needs to be `TRUCK`\n","enum":["TRUCK"],"example":"TRUCK"},"licencePlate":{"type":"string","maxLength":15,"description":"A license plate is a  tag that is attached to a vehicle and displays a unique number or code assigned to the vehicle. The format, design, and issuing authority for license plates vary by country, state, and province.\n"},"chassisLicencePlate":{"type":"string","maxLength":15,"description":"A chassis number is a unique identifying number or code assigned to the chassis of a vehicle.It may also be referred to as a \"vehicle identification number\" (VIN) or \"frame number.\n"}},"required":["modeOfTransport","transportCallReference"]},"bargeTransportCall":{"type":"object","title":"Barge Transport Call","description":"A Transport Call used for Barge\n","properties":{"modeOfTransport":{"type":"string","description":"The mode of transport as defined by DCSA. For the `BargeTransportCall` this needs to be `BARGE`\n","enum":["BARGE"],"example":"BARGE"},"portVisitReference":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/portVisitReference"},"carrierServiceCode":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/carrierServiceCode"},"universalServiceReference":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/universalServiceReference"},"carrierExportVoyageNumber":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/carrierExportVoyageNumber"},"universalExportVoyageReference":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/universalExportVoyageReference"},"carrierImportVoyageNumber":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/carrierImportVoyageNumber"},"universalImportVoyageReference":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/universalImportVoyageReference"},"barge":{"$ref":"#/components/schemas/barge"}},"required":["modeOfTransport","transportCallReference"]},"barge":{"type":"object","description":"A flat-bottomed floating structure built mainly for transport of cargo/equipment at coastal areas, rivers, canals or on open sea. A barge may or may not be self-propelled.\n","properties":{"vesselIMONumber":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/vesselIMONumber"},"name":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/bargeName"},"flag":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/bargeFlag"},"callSign":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/bargeCallSignNumber"},"operatorCarrierCode":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/bargeOperatorCarrierCode"},"operatorCarrierCodeListProvider":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/bargeOperatorCarrierCodeListProvider"}},"required":["name"]},"vesselTransportCall":{"type":"object","title":"Vessel Transport Call","description":"A Transport Call used for Vessels\n","properties":{"modeOfTransport":{"type":"string","description":"The mode of transport as defined by DCSA. For the `VesselTransportCall` this needs to be `VESSEL`\n","enum":["VESSEL"],"example":"VESSEL"},"portVisitReference":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/portVisitReference"},"carrierServiceCode":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/carrierServiceCode"},"universalServiceReference":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/universalServiceReference"},"carrierExportVoyageNumber":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/carrierExportVoyageNumber"},"universalExportVoyageReference":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/universalExportVoyageReference"},"carrierImportVoyageNumber":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/carrierImportVoyageNumber"},"universalImportVoyageReference":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/universalImportVoyageReference"},"vessel":{"$ref":"#/components/schemas/vessel"}},"required":["modeOfTransport","transportCallReference"]},"vessel":{"type":"object","description":"A floating, sea going structure (mother vessels and feeder vessels) with either an internal or external mode of propulsion designed for the transport of cargo and/or passengers.\n","properties":{"vesselIMONumber":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/vesselIMONumber"},"name":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/vesselName"},"flag":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/vesselFlag"},"callSign":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/vesselCallSignNumber"},"operatorCarrierCode":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/vesselOperatorCarrierCode"},"operatorCarrierCodeListProvider":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/vesselOperatorCarrierCodeListProvider"}},"required":["vesselIMONumber"]},"references":{"type":"array","description":"References provided by the shipper or freight forwarder at the time of booking or at the time of providing shipping instruction. Carriers share it back when providing track and trace event updates, some are also printed on the B/L. Customers can use these references to track shipments in their internal systems.\n\nIn addition to the References provided by the shipper or freight forwarder - the carrier can provide an extra `type` called `EQ` which is a reference to an Equipment.\n","example":[{"type":"EQ","value":"APZU4812090"}],"items":{"type":"object","properties":{"type":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/referenceType"},"value":{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/DCSA_DOMAIN/3.0.0#/components/schemas/referenceValue"}}},"required":["type","value"]},"notImplemented":{"type":"object","description":"Error object to return in case an endPoint is not implemented\n","allOf":[{"$ref":"https://api.swaggerhub.com/domains/dcsaorg/ERROR_DOMAIN/2.0.0#/components/schemas/error"},{"type":"object","properties":{"httpMethod":{"example":"GET"}}},{"type":"object","properties":{"requestUri":{"example":"https://dcsa.org/dcsa/tnt/v1/event-subscriptions"}}},{"type":"object","properties":{"statusCode":{"example":501}}},{"type":"object","properties":{"statusCode":{"example":501}}},{"type":"object","properties":{"statusCodeText":{"example":"Not Implemented"}}},{"type":"object","properties":{"errorMessage":{"example":"This endPoint has not been implemented"}}},{"type":"object","properties":{"errors":{"example":[{"reason":"Not implemented","message":"This endPoint has not been implemented"}]}}}]},"ambientTemperatureSetpoint":{"type":"number","description":"Target value of the temperature outside the Reefer.\n","example":15},"callbackUrl":{"type":"string","format":"uri","description":"The endPoint where a Carrier whould send back events to the Shipper. The callback can contain query parameters uniquely identifying the originator of the events.\n","example":"https://myserver.com/send/callback/here?shipperRef=<shipper defined unique id>"},"changeRemark":{"type":"string","maxLength":250,"description":"Free text field to provide information as to why the `TransportEvent` was sent\n","example":"Bad weather"},"documentReference":{"type":"string","maxLength":100,"description":"The reference of the object defined by the `documentTypeCode`\n","example":"<the-reference-of-the-documentTypeCode>"},"documentTypeCode":{"type":"string","maxLength":3,"description":"The `documentTypeCode` is used to identify the type of information `documentReference` points to. Can be one of the following values\n- CBR (Carrier Booking Request)\n- BKG (Booking)\n- SHI (Shipping Instruction)\n- TRD (Transport Document)\n- DEI (Delivery Instructions)\n- DEO (Delivery Order)\n- TRO (Transport Order)\n- CRO (Container Release Order)\n- ARN (Arrival Notice)\n- VGM (Verified Gross Mass)\n- CAS (Cargo Survey)\n- CUC (Customs Clearance)\n- DGD (Dangerous Goods Declaration)\n- OOG (Out of Gauge)\n- CQU (Contract Quotation)\n- INV (Invoice)\n- HCE (Health Certificate)\n- PCE (Phytosanitary Certificate)\n- VCE (Veterinary Certificate)\n- FCE (Fumigation Certificate)\n- ICE (Inspection Certificate)\n- CEA (Certificate of Analysis)\n- CEO (Certificate of Origin)\n\nMore details can be found on [GitHub](https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/documenttypecodes.csv)\n","example":"SHI","enum":["CBR","BKG","SHI","TRD","DEI","DEO","TRO","CRO","ARN","VGM","CAS","CUC","DGD","OOG","CQU","INV","HCE","PCE","VCE","FCE","ICE","CEA","CEO"]},"documentTypeCodes":{"type":"array","description":"List of `documentTypeCode` to filter by. If multiple values are selected - the **OR**-operator will be used.\n\nDefault is none as it will not filter on `documentTypeCode` if not specified.\n","example":["SHI","TRD"],"items":{"$ref":"#/components/schemas/documentTypeCode"}},"equipmentEventTypeCode":{"type":"string","description":"Unique identifier for `equipmentEventTypeCode` - can be one of the following values\n- LOAD (Loaded)\n- DISC (Discharged)\n- GTIN (Gated in)\n- GTOT (Gated out)\n- STUF (Stuffed)\n- STRP (Stripped)\n- PICK (Pick-up)\n- AVPU (Available for Pick-up)\n- DROP (Drop-off)\n- AVDO (Available for Drop-off)\n- INSP (Inspected)\n- RSEA (Resealed)\n- RMVD (Removed)\n- CUSS (Customs Selected for Scan)\n- CUSI (Customs Selected for Inspection)\n- CUSR (Customs Released)\n- CROS (Crossed)\n\nMore details can be found on <a href=\"https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/equipmenteventtypecodes.csv\">GitHub</a>\n","enum":["LOAD","DISC","GTIN","GTOT","STUF","STRP","AVPU","PICK","AVDO","DROP","INSP","RSEA","RMVD","CUSS","CUSI","CUSR","CROS"],"example":"LOAD"},"equipmentEventTypeCodes":{"type":"array","description":"List of `equipmentEventTypeCode` to filter by. If multiple values are selected - the **OR**-operator will be used.\n\nDefault is none as it will not filter on `equipmentEventTypeCode` if not specified.\n","example":["GTIN","GTOT"],"items":{"$ref":"#/components/schemas/equipmentEventTypeCode"}},"eventClassifierCode":{"type":"string","description":"Code for the event classifier. Values can vary depending on eventType\n"},"eventID":{"type":"string","maxLength":100,"description":"The unique identifier for this event (*the message - not the source*).\n","example":"3cecb101-7a1a-43a4-9d62-e88a131651e2"},"eventCreatedDateTime":{"type":"string","format":"date-time","description":"The timestamp of when the event was created.\n","example":"2021-01-09T14:12:56+01:00"},"eventDateTime":{"type":"string","format":"date-time","description":"The local date and time, when the event took place or when the event will take place, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.\n","example":"2019-11-12T07:41:00+08:30"},"eventType":{"type":"string","description":"The type of the Event - to be used as a discriminator. Possible values are\n\n- SHIPMENT (A Shippment event)\n- EQUIPMENT (An Equipment event)\n- TRANSPORT (A Transport event)\n","enum":["SHIPMENT","EQUIPMENT","TRANSPORT"]},"iotEventTypeCode":{"type":"string","description":"Unique identifier for `iotEventTypeCode` - can be one of the following values\n- DETC (Detected)\n\nMore details can be found on <a href=\"https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/ioteventtypecodes.csv\">GitHub</a>\n","enum":["DETC"],"example":"DETC"},"iotEventCode":{"type":"string","maxLength":3,"description":"The `iotTypeCode` is used to identify the type of `IotEvent`. Can be one of the following values\n- DRO (Door Opened)\n\nMore details can be found on [GitHub](https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/iottypecodes.csv)\n","example":"DRO","enum":["DRO"]},"iotEventTypeCodes":{"type":"array","description":"List of `iotEventTypeCode` to filter by. If multiple values are selected - the **OR**-operator will be used.\n\nDefault is none as it will not filter on `iotEventTypeCode` if not specified.\n","example":["DETC"],"items":{"$ref":"#/components/schemas/iotEventTypeCode"}},"milesToDestinationPort":{"type":"number","format":"float","description":"Remaining distance reported by the vessel to the next destination port in nautical miles    \n","example":245.45},"operationsEventTypeCode":{"type":"string","description":"The code to identify the type of event that is related to the operation\n- STRT (Started)\n- CMPL (Completed)\n- ARRI (Arrived)\n- DEPA (Departed)\n- OMIT (Omitted)\n- CANC (Cancelled)\n\nMore details can be found on <a href=\"https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/operationseventtypecodes.csv\">GitHub</a>\n","enum":["STRT","CMPL","ARRI","DEPA","OMIT","CANC"],"example":"STRT"},"operationsEventTypeCodes":{"type":"array","description":"List of `operationsEventTypeCode` to filter by. If multiple values are selected - the **OR**-operator will be used.\n\nDefault is none as it will not filter on `operationsEventTypeCode` if not specified.\n","example":["ARRI","CMPL"],"items":{"$ref":"#/components/schemas/operationsEventTypeCode"}},"portCallPhaseTypeCode":{"type":"string","description":"The general direction of the vessel for which information applies\n- INBD (Inbound)\n- ALGS (Alongside)\n- SHIF (Shifting)\n- OUTB (Outbound)\n\nMore details can be found on <a href=\"https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/portcallphasetypecodes.csv\">GitHub</a>\n","enum":["INBD","ALGS","SHIF","OUTB"],"example":"ALGS"},"portCallServiceTypeCode":{"type":"string","description":"The type of the service provided in the port call\n- PILO (Pilotage)\n- MOOR (Mooring)\n- CRGO (Cargo operations)\n- TOWG (Towage)\n- BUNK (Bunkering)\n- LASH (Lashing)\n- SAFE (Safety)\n- FAST (All Fast)\n- GWAY (Gangway down and secure)\n- ANCO (Anchorage operations)\n- SLUG (Sludge)\n- SHPW (Shore Power)\n- LCRO (Loading cargo operations)\n- DCRO (Discharge cargo operations)\n- VRDY (Vessel ready)\n\nMore details can be found on <a href=\"https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/portcallservicetypecodes.csv\">GitHub</a>\n","enum":["PILO","MOOR","CRGO","TOWG","BUNK","LASH","SAFE","FAST","GWAY","ANCO","SLUG","SHPW","LCRO","DCRO","VRDY"],"example":"BUNK"},"publisherRole":{"type":"string","description":"The party function code of the publisher. The values are divided into 4 categories:\n\n#### Carrier\n- CA (Carrier)\n- AG (Carrier local agent)\n- VSL (Vessel)\n\n#### Port\n- ATH (Port Authorities)\n- PLT (Port Pilot)\n- TWG (Towage service provider)\n- MOR (Mooring service provider)\n\n#### Terminal\n- TR (Terminal)\n\n#### Service Provider\n- LSH (Lashing service provider)\n- BUK (Bunker service provider)\n- SLU (Sludge service provider)\n- SVP (Any other service provider)\n\nMore details can be found on <a href=\"https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/publisherrole.csv\">GitHub</a>\n","enum":["CA","AG","VSL","ATH","PLT","TWG","MOR","TR","LSH","BUK","SLU","SVP"],"example":"TR"},"reason":{"type":"string","maxLength":250,"description":"This field can be used to explain why a specific `ShipmentEvent` has been sent.\n","example":"The following attributes are missing..."},"reeferEventTypeCode":{"type":"string","description":"Unique identifier for `reeferEventTypeCode` - can be one of the following values\n- MEAS (Measured)\n- ADJU (Adjusted)\n\nMore details can be found on <a href=\"https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/reefereventtypecodes.csv\">GitHub</a>\n","enum":["MEAS","ADJU"],"example":"MEAS"},"reeferEventTypeCodes":{"type":"array","description":"List of `reeferEventTypeCode` to filter by. If multiple values are selected - the **OR**-operator will be used.\n\nDefault is none as it will not filter on `reeferEventTypeCode` if not specified.\n","example":["MEAS"],"items":{"$ref":"#/components/schemas/reeferEventTypeCode"}},"remark":{"type":"string","maxLength":500,"description":"Free text to provide additional information on the context.\n","example":"Port closed due to strike"},"retractedEventID":{"type":"string","maxLength":100,"description":"Reference to an Event that is to be retracted. If provided, the `payload` of the event **MUST not** be included.\n","example":"78cca721-8b0b-44c0-b359-c3f7dd7865ba","default":null},"secret":{"type":"string","format":"byte","description":"A Base64 encoded secret shared between the Publisher and the Subscriber.\nIt is used to compute the contents of the Notification-Signature header.\n","example":"MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTIzNDM2NTc4NjIzODk3NDY5MDgyNzM0OTg3MTIzNzg2NA=="},"shipmentEventTypeCode":{"type":"string","description":"The status of the document in the process. Possible values are\n- RECE (Received)\n- DRFT (Drafted)\n- PENA (Pending Approval)\n- PENU (Pending Update)\n- PENC (Pending Confirmation)\n- CONF (Confirmed)\n- REJE (Rejected)\n- APPR (Approved)\n- ISSU (Issued)\n- SURR (Surrendered)\n- SUBM (Submitted)\n- VOID (Void)\n- REQS (Requested)\n- CMPL (Completed)\n- HOLD (On Hold)\n- RELS (Released)\n- CANC (Cancelled)\n\nMore details can be found on [GitHub](https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/shipmenteventtypecodes.csv)\n","enum":["RECE","DRFT","PENA","PENU","PENC","CONF","REJE","APPR","ISSU","SURR","SUBM","VOID","REQS","CMPL","HOLD","RELS","CANC"],"example":"DRFT"},"shipmentEventTypeCodes":{"type":"array","description":"List of `shipmentEventTypeCode` to filter by. If multiple values are selected - the **OR**-operator will be used.\n\nDefault is none as it will not filter on `shipmentEventTypeCode` if not specified.\n","example":["RECE","DRFT"],"items":{"$ref":"#/components/schemas/shipmentEventTypeCode"}},"subscriptionCreatedDateTime":{"type":"string","format":"date-time","description":"The date and time when the subscription was created\n","example":"2021-11-03T09:41:00+08:30","readOnly":true},"subscriptionUpdatedDateTime":{"type":"string","format":"date-time","description":"The date and time when the subscription was last updated\n","example":"2021-11-03T09:41:00+08:30","readOnly":true},"subscriptionID":{"type":"string","format":"uuid","example":"8fbdc2d8-57c8-48b9-a04b-18fd8ec1d809","description":"The carrier issues a unique ID to the shipper or consignee for that subscription\n"},"tntPublisherRole":{"type":"string","description":"The party function code of the publisher. The values are divided into 2 categories:\n\n#### Carrier\n- CA (Carrier)\n- AG (Carrier local agent)\n\n#### Service Provider\n- VSP (Visibility Service Provider)\n- SVP (Any other service provider)\n\nMore details can be found on <a href=\"https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/publisherrole.csv\">GitHub</a>\n","enum":["CA","AG","VSP","SVP"],"example":"CA"},"transportEventTypeCode":{"type":"string","description":"Identifier for type of `transportEvent`\n- ARRI (Arrived)\n- DEPA (Departed)\n\nMore details can be found on <a href=\"https://github.com/dcsaorg/DCSA-Information-Model/blob/master/datamodel/referencedata.d/transporteventtypecodes.csv\">GitHub</a>\n","enum":["ARRI","DEPA"],"example":"ARRI"},"transportEventTypeCodes":{"type":"array","description":"List of `transportEventTypeCode` to filter by. If multiple values are selected - the **OR**-operator will be used.\n\nDefault is none as it will not filter on `transportEventTypeCode` if not specified.\n","example":["ARRI","DEPA"],"items":{"$ref":"#/components/schemas/transportEventTypeCode"}}}}}