Notifications for Transport Operators

This page will guide you through the notifications you - as a Transport Operator - might receive in Certified Pick up (CPu). We will guide you through the different types of notifications and what to do with them.

For Transport Operators, there are three types of CPu notifications:

Responses: asynchronous responses sent to your notification channel after you have sent a request to the CPu API. These notifications indicate an error and require you to take action
Release Light events: events which relate to the Release Lights of the container (Terminal release, Customs release, Commercial release - released, blocked etc.)
Release Right events: events which happen to the Release Right (transferred to next party, accepted, declined, revoked)

For each type there is an example for display purposes. Click the expand to see the full notification.

The notification schemes also contain CPu variables (between double curly braces {{}}) which are different for each notification you will receive. An overview & explanation of these CPu variables can be found on this page CPu variables overview .

Implementation of the notifications also requires you to have read Getting Started with the API integration !

Important: you need to have set up a notification channel for your company in order to receive and process these notifications. See Setting up notification channels if you have not done so already.

Notifications - generic fields

Every notification that is sent by NxtPort will be built up with a generic part, allowing integrators to identify the asset, sender, error or warning messages and a Use case or type specific body.

Field Name	Type	Allowed values	Field Description
assetId	string	Contains the name or ID of the asset	For CPu, the assetId (NxtPort identification number) is used and contains the value `00000000-0000-0001-0000-000000000037`
id	string	The unique ID linked to the notification	For CPu, the container number is included in this field.
PublicReferenceId	guid		Automatically generated GUID from NxtPort. This is a unique ID throughout our platform. In case of questions, please provide this ID, allowing us to clearly retrieve the corresponding information.
externalReferenceId	string		Your own reference, as provided in the request header (optional). Will be null in case the notification was triggered by another party.
senderId	string	NxtPort ID	The NxtPort ID of the owner that generated the notification. If a 3rd party triggered the event, this information will still be the owner of the original source that will be listed here.
receiverId	string	NxtPort ID	This should always be your NxtPort ID as you are the receiver of this message.
type	enumeration	releaseRight releaseLight pickUp terminalEvent	Depending on the notification, one of these values will be used. Within the NxtPort Console, you can use these type to filter out notifications to multiple channels.
event	enumeration	Multiple values allowed	Values will define the body of the notification and is explained further on in this document.
body	N/A	N/A	Contains the event specific body related to this notification. This body is included in the details of the notifications and described later on in this document.
timestamp	DateTime	UTC datetime	The timestamp when the notification was created by the Certified Pick-up platform. This will always be in UTC ISO 8601 format.
errors	Array	free text	These arrays are not used in CPu notifications. The error message can be found in the body of the notification.
warnings	Array	free text	These arrays are not used in CPu notifications. The warning message can be found in the body of the notification.

Notifications list

Responses

As stated previously, CPu is an asynchronous process (with some exceptions), meaning that when data is sent to the API, NxtPort will first receive and ‘store’ the data and then in a separate process will process the action in a CPu context. This means however, that not all errors or issues can be reported in a synchronous API response and that you will need to integrate the notifications you receive to make sure all data you provide is processed correctly.

Response notifications are asynchronous responses sent to your notification channel after you have sent a request tot the CPu API. These notifications indicate an error and are characterized by the "event": "NotValidated" field in the JSON body.

There is a problem with the action you performed on the Release Right. The error message is included in the "body" field, all possible messages are listed below, including the mitigation steps.

Example of a notification

Mismatch in Entity

JSON

{
  "assetId": "00000000-0000-0001-0000-000000000037",
  "body": "Unable to perform SubmitReleaseRight action Accept on CAIU1234567 due to invalid identification",
  "errors": [],
  "event": "NotValidated",
  "externalReferenceId": null,
  "id": "CAIU1234567",
  "publicReferenceId": "8cb81019-80d1-4cc7-b15e-76b1a5b4c450",
  "receiverId": "NXT22125864695",
  "senderId": null,
  "timestamp": "2022-11-22T08:53:05.5688854Z",
  "type": "ReleaseRight",
  "warnings": []
}

Notification received	Explanation	How to mitigate?	Notification body
Mismatch in entity	No Release Right action <Transfer / Accept / Decline / Revoke> due to: mismatch in provided identity. When a Release Right action with a non-existing identification is performed or when the sender’s identity is different from the current owner (during Transfer, Revoke) or next owner (during Accept, Decline).	Verify if you are allowed to perform the required action on the Release Right.	JSON `{ "assetId": "00000000-0000-0001-0000-000000000037", "body": "Unable to perform SubmitReleaseRight action <see explanation> on {{equipment_number}} due to invalid identification", "errors": [], "event": "NotValidated", "externalReferenceId": null, "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseRight", "warnings": [] }`
No matching entity found	No matching entity found. No Release Right Transfer / Accept / Decline due to: no matching NxtPort Entity found for provided parameters (NxtEntityId, APCS, DUNS, EORI or TIN).	Verify if the receiving company has been correctly registered for CPu (check their NxtPort ID or use the Company Registry call)	JSON { "assetId": "00000000-0000-0001-0000-000000000037", "body": "Couldn't find the entities based on the following parameters: IdentificationType: {{identification_type}} and IdentificationCode {{identification_code}}", "errors": [], "event": "NotValidated", "externalReferenceId": "external*BEANRCN20220126165159", "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseRight", "warnings": [] }
No matching release right	No Release Right Transfer / Accept / Decline due to: no matching Release Right found for provided parameters. When a Release Right action with a non-existing Equipment Number / Bill of Lading Number(s) / Release Identification combination is performed.	Verify the provided identifiers (`equipmentNumber`, `billOfLadingNumbers` & `releaseIdentification` ) and try again.	JSON `{ "assetId": "00000000-0000-0001-0000-000000000037", "body": "Could not find release right for unique key {{equipment_number}}, {{bl_number}}, {{unique_release_identification}}", "errors": [], "event": "NotValidated", "externalReferenceId": null, "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseRight", "warnings": [] }`
Release Right not pending	No Release Right Revoke due to: Release Right not in state ‘Pending’. When a Release Right Revoke is performed on on a Release Right that is not ‘pending’ (awaiting accept or decline) but instead is f.e. active.	Verify if the Release Right you wish to revoke has the Pending status (CPu UI or Get Release Detail call).	JSON `{ "assetId": "00000000-0000-0001-0000-000000000037", "body": ""Unable to perform SubmitReleaseRight action Revoke on {{equipment_number}} because Release right is not Pending but Accepted", "errors": [], "event": "NotValidated", "externalReferenceId": null, "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseRight", "warnings": [] }`
Release Right transferred to current owner	When a Transfer Release Right action is performed with `releaseTo` equal to current owner of Release Right. You will only receive this if you are the current owner of the Release Right.	Make sure to provide the correct identifiers of the `releaseTo` party.	JSON `{ "assetId": "00000000-0000-0001-0000-000000000037", "body": "It is not possible to transfer {{equipment_number}} to the current owner", "errors": [], "event": "NotValidated", "externalReferenceId": null, "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseRight", "warnings": [] }`
Mismatch in terminal	No Pickup Right assigned due to: provided terminal code does not match existing terminal for Release Right. When a Assign / Revoke / Update Pickup action contains a terminal code that is mapped to a different terminal on the CPu platform then the terminal that is registered for the Release Right.	Verify if you have provided the correct terminal code in the Pickup action call.	JSON `{ "assetId": "00000000-0000-0001-0000-000000000037", "body": "Terminal codes do not match for container {{equipment_number}} and bill of lading {{bl_number}}.", "errors": [], "event": "NotValidated", "externalReferenceId": null, "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "PickUp", "warnings": [] }`
Release Right not active - no pickup	No Pickup Right Assigned due to: Release Right not active for an owner. When a Assign / Revoke / Update Pickup action is performed via API for a Release Right that is currently in state ‘pending’ (waiting for accept, decline or revoke).	Verify that the Release Right has been accepted before assigning the Pick up.	JSON `{ "assetId": "00000000-0000-0001-0000-000000000037", "body": "Unable to perform SubmitPickupRight action on {{equipment_number}} due to invalid Release Right state : Pending", "errors": [], "event": "NotValidated", "externalReferenceId": null, "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "PickUp", "warnings": [] }`
Release Right not active - no revoke/update	No Pickup Right Revoked/Updated: no matching active Pickup Right found. When a Revoke / Update Pickup action is performed via API for a Release Right that is currently has no active Pickup Right assigned.	Verify if the Pickup Right is active before Revoking / Updating.	JSON `{ "assetId": "00000000-0000-0001-0000-000000000037", "body": "Unable to revoke/update the existing Pickup Right, no matching active Pickup Right was found", "errors": [], "event": "NotValidated", "externalReferenceId": null, "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "PickUp", "warnings": [] }`
No Green Light change detected	No Commercial Release / Terminal Release / … action processed due to: the current state of the Release Right is identical to the new provided state. When a Terminal / Commercial / … Light is received but the value is identical to the existing value for this light.	Verify the current state of the Release Light and find out which action you want/need to take.	JSON `{ "assetId": "00000000-0000-0001-0000-000000000037", "body": "No change detected for Light {{greenLightName}} - Value: {{greenLightValue}}", "errors": [], "event": "NotValidated", "externalReferenceId": null, "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseLight", "warnings": [] }`

Release Light events

Event notifications are notifications sent to your notification channel when an event occurs on a Release Right for which you are a stakeholder.

You will only receive these notifications if you are the current owner of the Release Right.

Example of a notification

Commercial Release created

JSON

{
    "assetId": "00000000-0000-0001-0000-000000000037",
    "body": {
        "carrier": {
            "nxtEntityId": "NXT210000274362",
            "name": "Shipping Agent",
            "eori": "btw53698888",
            "tin": "BE1234567898",
            "apcs": "ZA0000",
            "duns": null
        },
        "terminalCode": "0100",
        "portLoCode": "BEANR",
        "equipmentNumber": "HBMU2699709",
        "billOfLadingNumbers": [
            "BOL2022112885212"
        ],
        "releaseIdentification": "SARI2022112885212",
        "greenLightName": "CommercialRelease",
        "originalValue": null,
        "newValue": "OK"
    },
    "errors": [],
    "event": "ReleaseLightChanged",
    "externalReferenceId": "ERI+CommercialRelease+772",
    "id": "HBMU2699709",
    "publicReferenceId": "65daa575-966a-4619-8c55-0bf51ba3032b",
    "receiverId": "NXT22125864695",
    "senderId": null,
    "timestamp": "2022-11-22T08:22:09.6647756Z",
    "type": "ReleaseLight",
    "warnings": []
}

Event	Explanation	Notification Body
Commercial Release blocked	A Commercial Release was blocked by the submitting Shipping Agent. The Commercial Release Light switches to RED. The container cannot be picked up from the terminal.	JSON { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "sender": { "nxtEntityId": "{{sender_identification_code_nxtentityid}}", "name": "{{sender_name}}", "eori": "{{sender_identification_code_eori}}", "tin": "{{sender_identification_code_tin}}", "apcs": "{{sender_identification_code_apcs}}", "duns": "{{sender_identification_code_duns}}", "externalId": "{{sender_identification_code_externalId}}" }, "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": "{{carrier_identification_code_apcs}}", "duns": "{{carrier_identification_code_duns}}", "externalId": "{{carrier_identification_code_externalId}}" }, "releaseIdentification": "{{unique_release_identification}}", "releaseOrderReference": "", "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "{{bl_number}}", "{{bl_number}}" ], "portLoCode": "{{portLo_code}}", "terminalCode": "{{terminal_code}}", "reason": "{{provided by shipping agent}}" "actionType": "Block", "releaseDatetimeUtc": "{{ISO_Timestamp}}", "expirationDatetimeUtc": {{ISO_Timestamp}}" }, "errors": [], "event": "Block", "externalReferenceId": "{{external_reference_id}}", "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseLight", "warnings": [] }
Commercial Release unblocked	The previously blocked Commercial Release was unblocked by the submitting Shipping Agent. The Commercial Release Light switches to GREEN.	JSON { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": "{{carrier_identification_code_apcs}}", "duns": "{{carrier_identification_code_duns}}" }, "terminalCode": "{{terminal_code}}", "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "{{bl_number}}", "{{bl_number}}" ], "releaseIdentification": "{{unique_release_identification}}", "greenLightName": "CommercialRelease", "originalValue": "BLOCKED", "newValue": "OK" }, "errors": [], "event": "ReleaseLightChanged", "externalReferenceId": "{{external_reference_id}}", "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseLight", "warnings": [] } AND JSON { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "sender": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": null, "duns": "{{carrier_identification_code_duns}}" }, "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": null, "duns": "{{carrier_identification_code_duns}}" }, "releaseIdentification": "{{unique_release_identification}}", "releaseOrderReference": null, "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "{{bl_number}}" ], "portLoCode": "BEANR", "terminalCode": "{{terminal_code}}", "actionType": "Unblock", "releaseDatetimeUtc": {{ISO_timestamp}}, "expirationDatetimeUtc": {{ISO_timestamp}} }, "errors": [], "event": "Unblock", "externalReferenceId": "{{external_reference_id}}", "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_timestamp}}", "type": "ReleaseLight", "warnings": [] }
Commercial Release updated	An existing Commercial Release was updated (e.g. terminal, release date) by the submitting Shipping Agent. You will need to make a Get Release Detail call to retrieve the updated details for the Release Right.	JSON { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "sender": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": null, "duns": "{{carrier_identification_code_duns}}" }, "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": null, "duns": "{{carrier_identification_code_duns}}" }, "releaseIdentification": "{{unique_release_identification}}", "releaseOrderReference": "SAupdate454upd", "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "BOL2022128101749" ], "portLoCode": "BEANR", "terminalCode": "{{terminal_code}}", "actionType": "Update", "releaseDatetimeUtc": "2022-12-08T10:18:48.725Z", "expirationDatetimeUtc": null }, "errors": [], "event": "Update", "externalReferenceId": "{{external_reference_id}}", "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_timestamp}}", "type": "ReleaseLight", "warnings": [] }
Commercial Release deleted	A Commercial Release was deleted by the submitting Shipping Agent. The Release Right is no longer active in CPu.	JSON { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "sender": { "nxtEntityId": "{{sender_identification_code_nxtentityid}}", "name": "{{sender_name}}", "eori": "{{sender_identification_code_eori}}", "tin": "{{sender_identification_code_tin}}", "apcs": null, "duns": "{{sender_identification_code_duns}}" "externalId": "{{sender_identification_code_externalId}}" }, "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": null, "duns": "{{carrier_identification_code_duns}}", "externalId": "{{carrier_identification_code_externalId}}" }, "releaseIdentification": "{{unique_release_identification}}", "releaseOrderReference": "SAupdate454upd", "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "BOL2022128101749" ], "releaseId": "{{release_uuid}}" "portLoCode": "BEANR", "terminalCode": "{{terminal_code}}", "reason": {{reason_provided_by_carrier}} "actionType": "Delete", "releaseDatetimeUtc": "{{ISO_timestamp}}", "expirationDatetimeUtc": "{{ISO_timestamp}}" }, "errors": [], "event": "Delete", "externalReferenceId": "{{external_reference_id}}", "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_timestamp}}", "type": "ReleaseLight", "warnings": [] }
Terminal discharge submitted	A Terminal Discharge was submitted by the Terminal Operator, indicating the contain has arrived on the terminal. The Terminal Operation Light switches to GREEN.	JSON { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "carrier": { "nxtEntityId": "NXT21000057436", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": null, "duns": "{{carrier_identification_code_duns}}" }, "terminalCode": "{{terminal_code}}", "portLoCode": "BEANR", "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "BOL2022128101749" ], "releaseIdentification": "{{unique_release_identification}}", "greenLightName": "TerminalOperation", "originalValue": "UNKNOWN", "newValue": "DISCHARGED" }, "errors": [], "event": "ReleaseLightChanged", "externalReferenceId": "{{external_reference_id}}", "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_timestamp}}", "type": "ReleaseLight", "warnings": [] }
Terminal Release submitted	The container has been Released on the terminal by the Terminal Operator (API call or CPu UI). The Terminal Release Light switches to GREEN.	JSON { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": "{{carrier_identification_code_apcs}}", "duns": "{{carrier_identification_code_duns}}" }, "terminalCode": "{{terminal_code}}", "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "{{bl_number}}", "{{bl_number}}" ], "releaseIdentification": "{{unique_release_identification}}", "greenLightName": "TerminalReady", "originalValue": "UNKNOWN", // can be "BLOCKED" as well "newValue": "RELEASED" }, "errors": [], "event": "ReleaseLightChanged", "externalReferenceId": "{{external_reference_id}}", "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseLight", "warnings": [] }
Terminal Release blocked	The container has been blocked on the terminal by the Terminal Operator (API call or CPu UI). The Terminal Release Light switches to RED.	JSON { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": "{{carrier_identification_code_apcs}}", "duns": "{{carrier_identification_code_duns}}" }, "terminalCode": "{{terminal_code}}", "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "{{bl_number}}", "{{bl_number}}" ], "releaseIdentification": "{{unique_release_identification}}", "greenLightName": "TerminalReady", "originalValue": "RELEASED", // can be "UNKNOWN" as well "newValue": "BLOCKED" }, "errors": [], "event": "ReleaseLightChanged", "externalReferenceId": "{{external_reference_id}}", "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseLight", "warnings": [] }
Selected for Terminal scan	The container has been marked selected for scan by the Terminal Operator (API call or CPu UI). The Terminal Release Light switches to YELLOW.	JSON { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": "{{carrier_identification_code_apcs}}", "duns": "{{carrier_identification_code_duns}}" }, "terminalCode": "{{terminal_code}}", "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "{{bl_number}}", "{{bl_number}}" ], "releaseIdentification": "{{unique_release_identification}}", "greenLightName": "TerminalReady", "originalValue": "RELEASED", // can be "UNKNOWN" or "BLOCKED" as well "newValue": "SELECTEDFORSCAN" }, "errors": [], "event": "ReleaseLightChanged", "externalReferenceId": "{{external_reference_id}}", "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseLight", "warnings": [] }
Customs Release submitted	The container has been released by the competent customs authority (CCRM message). The Customs Release Light switches to GREEN.	JSON { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "carrier": { "nxtEntityId": "NXT21000057436", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": null, "duns": "{{carrier_identification_code_duns}}" }, "terminalCode": "{{terminal_code}}", "portLoCode": "BEANR", "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "BOL2022128101749" ], "releaseIdentification": "{{unique_release_identification}}", "greenLightName": "Customs", "originalValue": "NOTRELEASED", "newValue": "RELEASED" }, "errors": [], "event": "ReleaseLightChanged", "externalReferenceId": "{{external_reference_id}}", "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_timestamp}}", "type": "ReleaseLight", "warnings": [] }
Customs Selected for Scan	The container has been selected for scanning by the competent customs authority (CCRM/NGPS message). The Customs Release Light switches to YELLOW.	CODE { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": "{{carrier_identification_code_apcs}}", "duns": "{{carrier_identification_code_duns}}" }, "terminalCode": "{{terminal_code}}", "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "{{bl_number}}", "{{bl_number}}" ], "releaseIdentification": "{{unique_release_identification}}", "greenLightName": "Customs", "originalValue": "NOTRELEASED", "newValue": "SELECTEDFORSCAN" }, "errors": [], "event": "ReleaseLightChanged", "externalReferenceId": null, "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseLight", "warnings": [] }
Customs Transhipment	The container has been identified by the competent customs authority (CCRM message) as a Transhipment container. The Customs Release Light switches to YELLOW.	CODE { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": "{{carrier_identification_code_apcs}}", "duns": "{{carrier_identification_code_duns}}" }, "terminalCode": "{{terminal_code}}", "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "{{bl_number}}", "{{bl_number}}" ], "releaseIdentification": "{{unique_release_identification}}", "greenLightName": "Customs", "originalValue": "NOTRELEASED", "newValue": "TRANSHIPMENT" }, "errors": [], "event": "ReleaseLightChanged", "externalReferenceId": null, "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseLight", "warnings": [] }
Customs Port Equalisation	There’s a gate-in message for this import container. The Customs Release Light switches to YELLOW.	CODE { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": "{{carrier_identification_code_apcs}}", "duns": "{{carrier_identification_code_duns}}" }, "terminalCode": "{{terminal_code}}", "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "{{bl_number}}", "{{bl_number}}" ], "releaseIdentification": "{{unique_release_identification}}", "greenLightName": "Customs", "originalValue": "NOTRELEASED", "newValue": "PORTEQUALISATION" }, "errors": [], "event": "ReleaseLightChanged", "externalReferenceId": null, "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseLight", "warnings": [] }
Customs FAVV	The container has been identified by the competent customs authority as a FAVV container. The Customs Release Light switches to YELLOW. This information is subject to 1 day delay.	CODE { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": "{{carrier_identification_code_apcs}}", "duns": "{{carrier_identification_code_duns}}" }, "terminalCode": "{{terminal_code}}", "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "{{bl_number}}", "{{bl_number}}" ], "releaseIdentification": "{{unique_release_identification}}", "greenLightName": "Customs", "originalValue": "NOTRELEASED", "newValue": "FAVV" }, "errors": [], "event": "ReleaseLightChanged", "externalReferenceId": null, "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseLight", "warnings": [] }
Customs Documentary Control	The container’s documents are being investigated by the customs authority (PLDA message). The Customs Release Light switches to RED. This information is subject to 1 day delay.	CODE { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": "{{carrier_identification_code_apcs}}", "duns": "{{carrier_identification_code_duns}}" }, "terminalCode": "{{terminal_code}}", "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "{{bl_number}}", "{{bl_number}}" ], "releaseIdentification": "{{unique_release_identification}}", "greenLightName": "Customs", "originalValue": "NOTRELEASED", "newValue": "DOCUMENTARYCONTROL" }, "errors": [], "event": "ReleaseLightChanged", "externalReferenceId": null, "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseLight", "warnings": [] }
Customs Progress Partially Cleared	The container is partially cleared by the customs authority. At least 1 item for a bill of lading has been cleared by the customs authority. The Customs Progress Light switches to YELLOW. This information is subject to 1 day delay.	CODE { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": "{{carrier_identification_code_apcs}}", "duns": "{{carrier_identification_code_duns}}" }, "terminalCode": "{{terminal_code}}", "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "{{bl_number}}", "{{bl_number}}" ], "releaseIdentification": "{{unique_release_identification}}", "greenLightName": "CustomsProgress", "originalValue": "UNKNOWN", "newValue": "PARTIALLYCLEARED" }, "errors": [], "event": "ReleaseLightChanged", "externalReferenceId": null, "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseLight", "warnings": [] }
Customs Manual Overwrite	The container has been Released manually by the Ship Agent or Terminal Operator. The Customs Release Light switches to GREEN.	JSON { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": "{{carrier_identification_code_apcs}}", "duns": "{{carrier_identification_code_duns}}", "externalId": "{{carrier_identification_code_externalId}}" }, "terminalCode": "{{terminal_code}}", "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "{{bl_number}}", "{{bl_number}}" ], "releaseIdentification": "{{unique_release_identification}}", "greenLightName": "Customs", "originalValue": "NOTRELEASED", "newValue": "MANUALOVERWRITE" }, "errors": [], "event": "ReleaseLightChanged", "externalReferenceId": null, "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseLight", "warnings": [] }
Pick up Right generated	A Pick up Right has been generated, meaning a driver, barge - or rail operator was assigned for pick up by the last Transport Operator holding the Release Right. The Pick up Light switches to GREEN.	JSON { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": "{{carrier_identification_code_apcs}}", "duns": "{{carrier_identification_code_duns}}" }, "terminalCode": "{{terminal_code}}", "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "{{bl_number}}", "{{bl_number}}" ], "releaseIdentification": "{{unique_release_identification}}", "greenLightName": "PickupLight", "originalValue": "UNKNOWN", "newValue": "ASSIGNED", "meansOfTransport": { "oldMeansOfTransport": "{{oldMeansOfTransport}}", "newMeansOfTransport": "{{newMeansOfTransport}}" }, "releaseId": "{{release_uuid}}" }, "errors": [], "event": "ReleaseLightChanged", "externalReferenceId": null, "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseLight", "warnings": [] }
Pick up Right updated	A Pick up Right has been updated, meaning a new pickup for truck (new driver), barge or rail was assigned by the Transport Operator holding the Release Right. The Pick up Light remains GREEN.	CODE { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": "{{carrier_identification_code_apcs}}", "duns": "{{carrier_identification_code_duns}}" }, "terminalCode": "{{terminal_code}}", "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "{{bl_number}}", "{{bl_number}}" ], "releaseIdentification": "{{unique_release_identification}}", "greenLightName": "PickupLight", "originalValue": "ASSIGNED", "newValue": "ASSIGNED", "meansOfTransport": { "oldMeansOfTransport": "{{oldMeansOfTransport}}", "newMeansOfTransport": "{{newMeansOfTransport}}" }, "releaseId": "{{release_uuid}}" }, "errors": [], "event": "ReleaseLightChanged", "externalReferenceId": null, "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseLight", "warnings": [] }

Pick up Right revoked	A Pick up Right has been revoked, meaning the driver, barge - or rail operator was de-assigned by the last Transport Operator holding the Release Right. The Pick up Light switches to RED.	CODE { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": "{{carrier_identification_code_apcs}}", "duns": "{{carrier_identification_code_duns}}" }, "terminalCode": "{{terminal_code}}", "equipmentNumber": "{{equipment_number}}", "billOfLadingNumbers": [ "{{bl_number}}", "{{bl_number}}" ], "releaseIdentification": "{{unique_release_identification}}", "greenLightName": "PickupLight", "originalValue": "ASSIGNED", "newValue": "REVOKED", "meansOfTransport": { "oldMeansOfTransport": "{{oldMeansOfTransport}}", "newMeansOfTransport": "{{newMeansOfTransport}}" }, "releaseId": "{{release_uuid}}" }, "errors": [], "event": "ReleaseLightChanged", "externalReferenceId": null, "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseLight", "warnings": [] }

Release Right events

Event notifications are notifications sent to your notification channel when an event occurs on a Release Right for which you are a stakeholder.

Example of a notification

Release Right accepted

JSON

{
    "assetId": "00000000-0000-0001-0000-000000000037",
    "body": {
        "sender": {
            "nxtEntityId": "NXT21055057655",
            "name": "Release Party 1",
            "eori": null,
            "tin": "BE345678",
            "apcs": "ZA0001",
            "duns": null
        },
        "carrier": {
            "nxtEntityId": "NXT210000274362",
            "name": "Shipping Agent",
            "eori": "btw53698888",
            "tin": "BE1234567898",
            "apcs": "ZA0000",
            "duns": null
        },
        "releaseTo": {
            "nxtEntityId": "NXT21000057840",
            "name": "Transport Operator 1",
            "eori": "BTW005611",
            "tin": "BE567891",
            "apcs": "ZA0002",
            "duns": null
        },
        "releaseFrom": {
            "nxtEntityId": "NXT21055057655",
            "name": "Release Party 1",
            "eori": null,
            "tin": "BE345678",
            "apcs": "ZA0001",
            "duns": null
        },
        "equipmentNumber": "HBMU2699709",
        "equipmentType": "45G1",
        "portLoCode": "BEANR",
        "terminalCode": "0100",
        "actionType": "Transfer",
        "reasonForAction": "Transfer to Transport Company",
        "billOfLadingNumbers": [
            "BOL2022112885212"
        ],
        "releaseDatetimeUtc": "2022-11-28T08:52:12.928Z",
        "expirationDatetimeUtc": "2023-01-27T08:52:12.928Z",
        "releaseIdentification": "SARI2022112885212",
        "emptyReturnReference": null,
        "equipmentSupplier": "Container Co",
        "equipmentStatus": "Import",
        "fullEmptyIndicator": "Full",
        "equipmentOperator": "Maersk",
        "vesselName": "EMMA MAERSK",
        "vesselCallSign": "OYGR2",
        "voyageNumber": "002W"
    },
    "errors": [],
    "event": "Transferred",
    "externalReferenceId": "ERI+transferReleaseRight+159",
    "id": "HBMU2699709",
    "publicReferenceId": "03c7c559-8f5f-47fb-b284-46096d1c45f6",
    "receiverId": "NXT22125864695",
    "senderId": null,
    "timestamp": "2022-11-22T08:52:38.042174Z",
    "type": "ReleaseRight",
    "warnings": []
}

Event	Explanation	Notification Body
Release Right Transferred	The Release Right was successfully transferred to the `releaseTo` party, awaiting their Accept / Decline. You will only receive this notification if you are the `releaseFrom` or `releaseTo` party.	CODE { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "sender": { "nxtEntityId": "{{sender_identification_code_nxtentityid}}", "name": "{{sender_name}}", "eori": "{{sender_identification_code_eori}}", "tin": "{{sender_identification_code_tin}}", "apcs": "{{sender_identification_code_apcs}}", "duns": "{{sender_identification_code_duns}}" }, "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": "{{carrier_identification_code_apcs}}", "duns": "{{carrier_identification_code_duns}}" }, "releaseTo": { "nxtEntityId": "{{releaseto_identification_code_nxtentityid}}", "name": "{{releaseto_name}}", "eori": "{{releaseto_identification_code_eori}}", "tin": "{{releaseto_identification_code_tin}}", "apcs": "{{releaseto_identification_code_apcs}}", "duns": "{{releaseto_identification_code_duns}}" }, "releaseFrom": { "nxtEntityId": "{{releasefrom_identification_code_nxtentityid}}", "name": "{{releasefrom_name}}", "eori": "{{releasefrom_identification_code_eori}}", "tin": "{{releasefrom_identification_code_tin}}", "apcs": "{{releasefrom_identification_code_apcs}}", "duns": "{{releasefrom_identification_code_duns}}" }, "releaseIdentification": "{{unique_release_identification}}", "equipmentNumber": "{{equipment_number}}", "equipmentType": "{{equipment_type}}", "portLoCode": "BEANR", "terminalCode": "{{terminal_code}}", "actionType": "Transfer", "reasonForAction": "{{your_reason_for_action}}", "billOfLadingNumbers": [ "{{bl_number}}", "{{bl_number}}" ], "releaseDatetimeUtc": "{{ISO_Timestamp}}", "expirationDatetimeUtc": "{{ISO_Timestamp}}" }, "errors": [], "event": "Transferred", "externalReferenceId": "{{your_external_reference_id}}", "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseRight", "warnings": [] } Temporary format: JSON { "assetId": "00000000-0000-0001-0000-000000000037", "body": "Container {{equipment_number}} transfer to IdentificationType NxtEntityId and IdentificationCode {{releaseto_identification_code_nxtentityid}}", "errors": [], "event": "Transferred", "externalReferenceId": "{{your_external_reference_id}}", "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{receiver_identification_code_nxtentityid}}", "senderId": "{{sender_identification_code_nxtentityid}}", "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseRight", "warnings": [] }
Release Right Revoked	The transferred (but not accepted by the `releaseTo` party yet) Release Right was revoked by the `releaseFrom` party, returning the ownership to the `releaseFrom` party. You will only receive this notification if you are the `releaseFrom` or `releaseTo` party.	JSON { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "sender": { "nxtEntityId": "{{sender_identification_code_nxtentityid}}", "name": "{{sender_name}}", "eori": "{{sender_identification_code_eori}}", "tin": "{{sender_identification_code_tin}}", "apcs": "{{sender_identification_code_apcs}}", "duns": "{{sender_identification_code_duns}}" }, "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": "{{carrier_identification_code_apcs}}", "duns": "{{carrier_identification_code_duns}}" }, "releaseTo": { "nxtEntityId": "{{releaseto_identification_code_nxtentityid}}", "name": "{{releaseto_name}}", "eori": "{{releaseto_identification_code_eori}}", "tin": "{{releaseto_identification_code_tin}}", "apcs": "{{releaseto_identification_code_apcs}}", "duns": "{{releaseto_identification_code_duns}}" }, "releaseFrom": { "nxtEntityId": "{{releasefrom_identification_code_nxtentityid}}", "name": "{{releasefrom_name}}", "eori": "{{releasefrom_identification_code_eori}}", "tin": "{{releasefrom_identification_code_tin}}", "apcs": "{{releasefrom_identification_code_apcs}}", "duns": "{{releasefrom_identification_code_duns}}" }, "releaseIdentification": "{{unique_release_identification}}", "equipmentNumber": "{{equipment_number}}", "equipmentType": "{{equipment_type}}", "portLoCode": "BEANR", "terminalCode": "{{terminal_code}}", "actionType": "Revoke", "reasonForAction": "{{your_reason_for_action}}", "billOfLadingNumbers": [ "{{bl_number}}", "{{bl_number}}" ], "releaseDatetimeUtc": "{{ISO_Timestamp}}", "expirationDatetimeUtc": "{{ISO_Timestamp}}" }, "errors": [], "event": "RevokedByPreviousParty", "externalReferenceId": "{{your_external_reference_id}}", "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseRight", "warnings": [] }
Release Right Accepted	The transferred Release Right was accepted by the `releaseTo` party, transferring the ownership to the `releaseTo` party. You will only receive this notification if you are the `releaseFrom` or `releaseTo` party.	JSON { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "sender": { "nxtEntityId": "{{sender_identification_code_nxtentityid}}", "name": "{{sender_name}}", "eori": "{{sender_identification_code_eori}}", "tin": "{{sender_identification_code_tin}}", "apcs": "{{sender_identification_code_apcs}}", "duns": "{{sender_identification_code_duns}}" }, "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": "{{carrier_identification_code_apcs}}", "duns": "{{carrier_identification_code_duns}}" }, "releaseTo": { "nxtEntityId": "{{releaseto_identification_code_nxtentityid}}", "name": "{{releaseto_name}}", "eori": "{{releaseto_identification_code_eori}}", "tin": "{{releaseto_identification_code_tin}}", "apcs": "{{releaseto_identification_code_apcs}}", "duns": "{{releaseto_identification_code_duns}}" }, "releaseFrom": { "nxtEntityId": "{{releasefrom_identification_code_nxtentityid}}", "name": "{{releasefrom_name}}", "eori": "{{releasefrom_identification_code_eori}}", "tin": "{{releasefrom_identification_code_tin}}", "apcs": "{{releasefrom_identification_code_apcs}}", "duns": "{{releasefrom_identification_code_duns}}" }, "releaseIdentification": "{{unique_release_identification}}", "equipmentNumber": "{{equipment_number}}", "equipmentType": "{{equipment_type}}", "portLoCode": "BEANR", "terminalCode": "{{terminal_code}}", "actionType": "Accept", "reasonForAction": "{{your_reason_for_action}}", "billOfLadingNumbers": [ "{{bl_number}}", "{{bl_number}}" ], "releaseDatetimeUtc": "{{ISO_Timestamp}}", "expirationDatetimeUtc": "{{ISO_Timestamp}}" }, "errors": [], "event": "AcceptedByNextParty", "externalReferenceId": "{{your_external_reference_id}}", "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseRight", "warnings": [] }
Release Right Declined	A Decline Release Right action was successfully processed, declining the pending release right and returning the ownership to the previous party. You will only receive this notification if you are the `releaseFrom` or `releaseTo` party.	JSON { "assetId": "00000000-0000-0001-0000-000000000037", "body": { "sender": { "nxtEntityId": "{{sender_identification_code_nxtentityid}}", "name": "{{sender_name}}", "eori": "{{sender_identification_code_eori}}", "tin": "{{sender_identification_code_tin}}", "apcs": "{{sender_identification_code_apcs}}", "duns": "{{sender_identification_code_duns}}" }, "carrier": { "nxtEntityId": "{{carrier_identification_code_nxtentityid}}", "name": "{{carrier_name}}", "eori": "{{carrier_identification_code_eori}}", "tin": "{{carrier_identification_code_tin}}", "apcs": "{{carrier_identification_code_apcs}}", "duns": "{{carrier_identification_code_duns}}" }, "releaseTo": { "nxtEntityId": "{{releaseto_identification_code_nxtentityid}}", "name": "{{releaseto_name}}", "eori": "{{releaseto_identification_code_eori}}", "tin": "{{releaseto_identification_code_tin}}", "apcs": "{{releaseto_identification_code_apcs}}", "duns": "{{releaseto_identification_code_duns}}" }, "releaseFrom": { "nxtEntityId": "{{releasefrom_identification_code_nxtentityid}}", "name": "{{releasefrom_name}}", "eori": "{{releasefrom_identification_code_eori}}", "tin": "{{releasefrom_identification_code_tin}}", "apcs": "{{releasefrom_identification_code_apcs}}", "duns": "{{releasefrom_identification_code_duns}}" }, "releaseIdentification": "{{unique_release_identification}}", "equipmentNumber": "{{equipment_number}}", "equipmentType": "{{equipment_type}}", "portLoCode": "BEANR", "terminalCode": "{{terminal_code}}", "actionType": "Decline", "reasonForAction": "{{your_reason_for_action}}", "billOfLadingNumbers": [ "{{bl_number}}", "{{bl_number}}" ], "releaseDatetimeUtc": "{{ISO_Timestamp}}", "expirationDatetimeUtc": "{{ISO_Timestamp}}" }, "errors": [], "event": "DeclinedByNextParty", "externalReferenceId": "{{your_external_reference_id}}", "id": "{{equipment_number}}", "publicReferenceId": "{{nxtport_public_reference_id}}", "receiverId": "{{your_nxtport_id}}", "senderId": null, "timestamp": "{{ISO_Timestamp}}", "type": "ReleaseRight", "warnings": [] }

You have reached the end of the page. Go back to the integration guidelines.

Notifications - generic fields

Notifications list

Responses

Mismatch in entity

No matching entity found

No matching release right

Release Right not pending

Release Right transferred to current owner

Mismatch in terminal

Release Right not active - no pickup

Release Right not active - no revoke/update

No Green Light change detected

Release Light events

Commercial Release blocked

Commercial Release unblocked

Commercial Release updated

Commercial Release deleted

Terminal discharge submitted

Terminal Release submitted

Terminal Release blocked

Selected for Terminal scan

Customs Release submitted

Customs Selected for Scan

Customs Transhipment

Customs Port Equalisation

Customs FAVV

Customs Documentary Control

Customs Progress Partially Cleared

Customs Manual Overwrite

Pick up Right generated

Pick up Right updated

Pick up Right revoked

Release Right events

Release Right Transferred

Release Right Revoked

Release Right Accepted

Release Right Declined