Skip to main content
Skip table of contents

Notifications for Shipping Agents

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

For Shipping Agents, there are three types of CPu notifications:

  1. Responses: asynchronous responses sent to your notification channel after you have sent a request tot the CPu API. These notifications indicate an error and require you to take action

  2. Release Light events: events which relate to the Release Lights of the container (Terminal release, Customs release, Commercial release - released, blocked etc.)

  3. 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 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

Explanation

How to mitigate?

Notification Body

Commercial release already exists

Commercial release can not be created or updated since there’s already an active commercial release for this EquipmentNumber and BillOfLadingNumbers and TerminalNxtEntityId.

Delete the active commercial release first.

CODE
{
  "assetId": "00000000-0000-0001-0000-000000000037",
  "body": "Release right already exists for {EquipmentNumber} and B/L {BillOfLadingNumbers} and Terminal {TerminalCode} | {TerminalNxtEntityId}",
  "errors": [],
  "event": "NotValidated",
  "externalReferenceId": null,
  "id": "{{equipmentNumber}}",
  "publicReferenceId": "{{nxtport_public_reference_id}}",
  "receiverId": "{{your_nxtport_id}}",
  "senderId": null,
  "timestamp": "{{ISO_timestamp}}",
  "type": "ReleaseRight",
  "warnings": []
}

Missing Parameters

No Commercial Release action processed due to missing parameters:

When mandatory properties such as equipmentNumber, BillOfLading, portLocode are missing or invalid; a list of all missing/invalid properties is returned as a notification.

The body of the notification contains information on the parameters which are missing.

Verify you provided all mandatory values and try again.

JSON
{
  "assetId": "00000000-0000-0001-0000-000000000037",
  "body": "'Equipment Number' must not be empty.<br>\n'Bill Of Lading Numbers' <br>must not be empty.\n'Port Lo Code' must not be empty.\n'Port Lo Code' must be equal to 'BEANR'.",
  "errors": [],
  "event": "NotValidated",
  "externalReferenceId": "{{external_reference_id}}",
  "id": "Unknown",
  "publicReferenceId": "{{nxtport_public_reference_id}}",
  "receiverId": "{{your_nxtport_id}}",
  "senderId": null,
  "timestamp": "{{ISO_timestamp}}",
  "type": "ReleaseLight",
  "warnings": []
}

Invalid terminal code

Invalid Terminal Code.

When a provided terminalCode in the Submit Commercial Release request could not be matched with an existing terminal code or NxtPort entity.

Verify the provided terminal code. Make sure it is was communicated to NxtPort during the onboarding.

JSON
{
  "assetId": "00000000-0000-0001-0000-000000000037",
  "body": "SubmitReleaseLightActionCommand <br>does not have a valid terminal code {{submitted_terminal_code}} for port BEANR. No NxtEntityId found.",
  "errors": [],
  "event": "NotValidated",
  "externalReferenceId": "{{external_reference_id}}",
  "id": "{{equipment_number}}",
  "publicReferenceId": "{{nxtport_public_reference_id}}",
  "receiverId": "{{your_nxtport_id}}",
  "senderId": null,
  "timestamp": "{{ISO_timestamp}}",
  "type": "ReleaseLight",
  "warnings": []
}

No match found for identifiers

No Commercial Release action (Update, Revoke etc…) (different from Release) processed due to: no matching release right found for provided identifiers.

When a Submit Release Light action (except for the Release action) fails due to no matching release right reference found based on the equipmentNumber, one or more billOfLading & releaseIdentification.

Verify the identifiers of the Release Right you provided. Make sure they exist.

JSON
{
  "assetId": "00000000-0000-0001-0000-000000000037",
  "body": "No releaseRightReference found for unique key {{equipment_number}}, {{bl_number}}, {{unique_release_identification}}",
  "errors": [],
  "event": "NotValidated",
  "externalReferenceId": "{{external_reference_id}}",
  "id": "{{equipment_number}}",
  "publicReferenceId": "{{nxtport_public_reference_id}}",
  "receiverId": "{{your_nxtport_id}}",
  "senderId": null,
  "timestamp": "{{ISO_timestamp}}",
  "type": "ReleaseLight",
  "warnings": []
}

No state change

No Commercial Release / Terminal Release / … action processed due to: the current state of the Release Light 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": "{{external_reference_id}}",
  "id": "{{equipment_number}}",
  "publicReferenceId": "{{nxtport_public_reference_id}}",
  "receiverId": "{{your_nxtport_id}}",
  "senderId": null,
  "timestamp": "{{ISO_timestamp}}",
  "type": "ReleaseLight",
  "warnings": []
}

Mismatch in entity

No Release Right Transfer / Accept / Decline due to: mismatch in provided identity

When a SubmitReleaseRight 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 Accept on {{equipment_number}} due to invalid identification",
  "errors": [],
  "event": "NotValidated",
  "externalReferenceId": "{{external_reference_id}}",
  "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 Release Right Transfer / Accept / Decline due to: no matching NxtPort Entity found for provided parameters

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 {{provided_identification_code}}",
  "errors": [],
  "event": "NotValidated",
  "externalReferenceId": "{{external_reference_id}}",
  "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": "{{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 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 e.g. 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": "{{external_reference_id}}",
  "id": "{{equipment_number}}",
  "publicReferenceId": "{{nxtport_public_reference_id}}",
  "receiverId": "{{your_nxtport_id}}",
  "senderId": null,
  "timestamp": "{{ISO_Timestamp}}",
  "type": "ReleaseRight",
  "warnings": []
}

Release party unknown

No Release Right Transfer due to: no matching NxtPort entity found for releaseTo parameter.

This response has a special indication showing the request has been logged but could not be completed.
In case there was a “submit commercial release”, the commercial release is created but could not be transferred to the releaseTo party.

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": "Could not find a release right to transfer or one of the to-or-from parties is unidentified.",
  "errors": [],
  "event": "NotValidated",
  "externalReferenceId": "{{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 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": "{{external_reference_id}}",
  "id": "{{equipment_number}}",
  "publicReferenceId": "{{nxtport_public_reference_id}}",
  "receiverId": "{{your_nxtport_id}}",
  "senderId": null,
  "timestamp": "{{ISO_Timestamp}}",
  "type": "ReleaseRight",
  "warnings": []
}

Release Light events

These are notifications that you will receive that are triggered by either an action you have performed in CPu or by an action by another party, but for a release for which you have sent the Commercial Release.

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",
        "meansOfTransport": null,
        "releaseId": "137162ca-d3dd-4d5e-952a-32c74378315a",
        "releaseDateTimeUtc": "2024-03-09T09:35:25.189Z",
        "expirationDateTimeUtc": "2024-05-08T09:35:25.189Z"
    },
    "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 created

You have successfully created a new Commercial Release.

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}}",
            "externalId": "{{carrier_identification_code_externalId}}"
        },
        "terminalCode": "{{terminal_code}}",
        "equipmentNumber": "{{equipment_number}}",
        "billOfLadingNumbers": [
            "{{bl_number}}",
            "{{bl_number}}"
        ],
        "releaseIdentification": "{{unique_release_identification}}",
        "greenLightName": "CommercialRelease",
        "originalValue": "UNKNOWN",
        "newValue": "OK",
        "meansOfTransport": null,
        "releaseId": "{{release_uuid}}",
        "releaseDateTimeUtc": "{{ISO_Timestamp}}",
        "expirationDateTimeUtc": "{{ISO_Timestamp}}"
    },
    "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": []
}

Commercial Release blocked

You have successfully blocked a Commercial Release.

The Commercial Release Light switches to RED.

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 deleted

You have successfully deleted a Commercial Release.

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 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}}",
            "externalId": "{{carrier_identification_code_externalId}}"
        },
        "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": null,
    "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}}",
            "externalId": "{{carrier_identification_code_externalId}}"
        },
        "terminalCode": "{{terminal_code}}",
        "equipmentNumber": "{{equipment_number}}",
        "billOfLadingNumbers": [
            "{{bl_number}}",
            "{{bl_number}}"
        ],
        "releaseIdentification": "{{unique_release_identification}}",
        "greenLightName": "TerminalReady",
        "originalValue": "RELEASED",
        "newValue": "BLOCKED"
    },
    "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": []
}

Terminal Operation Discharge submitted

The container has been discharged from the vessel by the Terminal Operator (API call or COARRI DISCHARGE).

The Terminal Discharge 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": "TerminalOperation",
        "originalValue": "UNKNOWN",
        "newValue": "DISCHARGED"
    },
    "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": []
}

Terminal Gate Out submitted

The container has left the terminal, this event is triggered by the Terminal Gate Out (CODECO OUT) message.

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": "GateOperation",
        "originalValue": "UNKNOWN",
        "newValue": "GATEOUTRECEIVED"
    },
    "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 Release

 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": "{{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": "RELEASED"
    },
    "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 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}}",
            "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": "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}}",
            "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": "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}}",
            "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": "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}}",
            "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": "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}}",
            "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": "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}}",
            "externalId": "{{carrier_identification_code_externalId}}"
        },
        "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}}",
            "externalId": "{{carrier_identification_code_externalId}}"
        },
        "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 driver, barge - or rail operator was assigned for pick up by the last 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}}",
            "externalId": "{{carrier_identification_code_externalId}}"
        },
        "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}}",
            "externalId": "{{carrier_identification_code_externalId}}"
        },
        "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,
            "externalId": null
        },
        "carrier": {
            "nxtEntityId": "NXT210000274362",
            "name": "Shipping Agent",
            "eori": "btw53698888",
            "tin": "BE1234567898",
            "apcs": "ZA0000",
            "duns": null,
            "externalId": null
        },
        "releaseTo": {
            "nxtEntityId": "NXT21000057840",
            "name": "Transport Operator 1",
            "eori": "BTW005611",
            "tin": "BE567891",
            "apcs": "ZA0002",
            "duns": null,
            "externalId": null
        },
        "releaseFrom": {
            "nxtEntityId": "NXT21055057655",
            "name": "Release Party 1",
            "eori": null,
            "tin": "BE345678",
            "apcs": "ZA0001",
            "duns": null,
            "externalId": 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": null,
        "releaseIdentification": "SARI2022112885212",
        "emptyReturnReference": null,
        "equipmentSupplier": null,
        "equipmentStatus": null,
        "fullEmptyIndicator": null,
        "equipmentOperator": null,
        "vesselName": null,
        "vesselCallSign": null,
        "voyageNumber": null
    },
    "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.

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}}",
            "externalId": "{{carrier_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}}"
        },
        "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}}",
            "externalId": "{{carrier_identification_code_externalId}}"
        },
        "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}}",
            "externalId": "{{carrier_identification_code_externalId}}"
        },
        "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": []
}

Release Right revoked

You have revoked the transferred (but not accepted by the releaseTo party yet) Release Right, returning the ownership to the releaseFrom party (yourself).

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": "{{carrier_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}}"
        },
        "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}}",
            "externalId": "{{carrier_identification_code_externalId}}"
        },
        "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}}",
            "externalId": "{{carrier_identification_code_externalId}}"
        },
        "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.

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": "{{carrier_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}}"
        },
        "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}}",
            "externalId": "{{carrier_identification_code_externalId}}"
        },
        "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}}",
            "externalId": "{{carrier_identification_code_externalId}}"
        },
        "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

The transferred Release Right was declined by the releaseTo party, returning the ownership to the releaseFrom party (yourself).

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": "{{carrier_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}}"
        },
        "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}}",
            "externalId": "{{carrier_identification_code_externalId}}"
        },
        "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}}",
            "externalId": "{{carrier_identification_code_externalId}}"
        },
        "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.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.