Fetch latest data after receiving event notification.

After receiving a notification, you need to GET the release in order to receive the latest data.

EXAMPLE:

webhook

{
    "release": "0x24Fc2D465AaAbf47DA7284920A7B5c3b368EC1D9",
    "event": "TRANSFER",
    "organization": "0x78f13e5253a30f0EE079f5DDE281B3F1efe70B94",
    "vat": "BE2020112701"
}

server = https://url:port/tmining/api/v1

RESPONSE

{
   "release_data":{
      "billOfLading":{
         "blNumber":"RELEASE-API-TEST-1612",
         "portOfLoading":"BEANR",
         "portOfDestination":"BEANR",
         "vessel":"AAA",
         "agent":"BBB",
         "stayNumber":"00001",
         "lloydsNumber":"0002",
         "voyageNumber":"0003",
         "lineCode":"ABC"
      },
      "container":{
         "containerNumber":"CSQU32345690",
         "containerStatus":"released",
         "pickupLocation":"ECTDCD",
         "turnInLocation":"terminal_locode",
         "turnInReference":"aref",
         "termsAndConditions":"base64 encoded data",
         "validFrom":"2017-01-05T14:00:00.000Z",
         "validUntil":"2025-01-05T14:00:00.000Z",
         "isoTypeCode":"45G1",
         "loadStatus":"full",
         "moveType":"import"
      }
   },
   "address":"0x24Fc2D465AaAbf47DA7284920A7B5c3b368EC1D9",
   "deleted":false,
   "blocked":false,
   "encryptedPin":"18570bfece4999db5cd9b6102f9cff472acb5d7e1470bdde8a03cc3db01a6dc1aaf7e132984e7b2b6d7a07aa021f79c833636d8d9bfe4a62a3bef06567b701c579673768ad435d216050edda2f2b99709cc542b65c226f0bfd4f30c8500a4eba300cd538bc565409fe01d01d0d0c23d42bab76c7efe283e89f6e94a5f1b663141aecfe3a97bfeb826996656f622d97e05d4dd7f950f15a9312c507a90ed58f435b13878adf09d2c727fb518ba8d566bbb8c9a9fb2a1a6fefa73a55ec6bc05b14dc6f3cacd201a941f9af018ab1e54f88e0d031e92968a99fa16f9359b8fb943409736f7d2d20ee0011ed1a817e1a12cd760b9473077b6daa533521563dcaf322d6674a4b4417dd09a42a228211289bfedcd07529f983cd26387abfe2b1cd4b6817635d788d6d855104055f7ed6102f0604ac4382204eddfb9e62a9a3c199182319c948d0dabfc62080a93b0c8dac0067431751a4e1e9864fd5d548cd93f9c4edb0b95e0edb500f7846ee05dd13d7578f06c26d11ef107dd0713cc1b42f2e70a75a1a70b5ba107c2eeb6b1aba0723dbf3f8eee674a8ba3ff41da47d9fb91587d9e9c4143f4dadb2c9aa61b444c953720108af392ff3ff85a21542a2100eff453b8c9ffc307200b2fce89a2284716ab14a05b133c22b58359cf9183522fdab46cf033a39c7b262bb7e1015be8c6af837a0a48993a31600db207505f3c9ea1f1c3e",
   "gateOut":null,
   "createdAt":"2021-12-20T14:17:05.623Z",
   "updatedAt":"2022-02-16T08:52:13.251Z",
   "owner":"0x79F98099b2Bf4e5a47244E0cDba500F68b567ce5",
   "creator":"0xa2039dC115B5904c224FEc057684fcCcc88E2f05",
   "greenLights":{
      "total":"green",
      "events":{
         "customs":{
            "color":"green",
            "value":"released",
            "updatedAt":"2023-07-10 13:00"
         },
         "pickuplight":{
            "color":"gray",
            "value":"unknown",
            "updatedAt":""
         },
         "gateoperation":{
            "color":"green",
            "value":"gateoutreceived",
            "updatedAt":"2023-07-12 14:16"
         },
         "terminalready":{
            "color":"green",
            "value":"released",
            "updatedAt":"2023-07-10 12:00"
         },
         "customsprogress":{
            "color":"gray",
            "value":"unknown",
            "updatedAt":""
         },
         "commercialrelease":{
            "color":"green",
            "value":"ok",
            "updatedAt":"2023-07-05 13:37"
         },
         "terminaloperation":{
            "color":"green",
            "value":"discharged",
            "updatedAt":"2023-07-10 11:50"
         }
      },
      "source":"NxtPort"
   },
   "version":"1.2.1",
   "pinRetrieved":false,
   "previousOwner":"0xa2039dC115B5904c224FEc057684fcCcc88E2f05",
   "nextOwner":null,
   "conditions":[
      
   ]
}

Please note that almost all fields in the release details (from the GET /releases-endpoints) can be updated by the carrier.

Please find a list below of these fields:

Field	Can be updated?	By who?	Is updated in practice?
billOfLading
blNumber	yes	carrier	no
portOfLoading	yes	carrier	no
portOfDestination	yes	carrier	no
vessel	yes	carrier	no
agent	no
stayNumber	yes	carrier	no
lloydsNumber	yes	carrier	no
voyageNumber	yes	carrier	no
container
containerNumber	yes	carrier	no
containerStatus	yes	SCR app	Yes, when the carrier blocks or unblocks a release this field is updated.
pickupLocation	yes	carrier	Yes, when the pickup location (deep sea terminal) changes.
turnInLocation	yes	carrier	Yes, when the turn in location (depot) changes.
turnInReference	yes	carrier	Yes, when the turn in location (depot) changes.
termsAndConditions	yes	carrier	no
validFrom	yes	carrier	no
validUntil	yes	carrier	Yes, when the validity period is updated.
isoTypeCode	yes	carrier	no
address	no
deleted	yes	carrier	no
blocked	yes	carrier	Yes, this can occur when a container has to be scanned or when the carrier blocks the release temporarily.
encryptedPin	yes	SCR app	Yes, when the PIN is updated, for instance when the release is revoked while the pin was already retrieved.
gateOut	yes	terminal	Yes, when the container leaves the terminal.
createdAt	no
updatedAt	yes	SCR app	Yes, when a release is updated.
owner	yes	SCR app	Yes, when a release is transferred or revoked.
creator	no
version	no
pinRetrieved	yes	SCR app	Yes, when the pin is retrieved.
previousOwner	yes	SCR app	Yes, when a release is transferred or revoked.
nextOwner	yes	SCR app	Yes, when a release is transferred or revoked.
conditions	yes	carrier	no
greenLights	yes	Nxtport	Yes.