Creates or updates a nomination as a supplier
curl --request PUT \
--url https://api.demo.fuelboss.net/v1/nominations/supplier \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"clientReference": "<string>",
"delivery": {
"operationStandardCode": "<string>",
"bunkeringLocationCode": "<string>",
"bunkeringLocationName": "<string>",
"portBunkeringLocationCode": "<string>",
"bunkeringLocationDetails": "<string>",
"berthTime": "2023-11-07T05:31:56Z",
"pilotTime": "2023-11-07T05:31:56Z",
"estimatedTimeOfBunkering": "2023-11-07T05:31:56Z",
"laycanStart": "2023-11-07T05:31:56Z",
"laycanEnd": "2023-11-07T05:31:56Z",
"estimatedTimeOfCompletion": "2023-11-07T05:31:56Z",
"estimatedBunkeringDurationInMinutes": 123,
"supplierAssetBufferTimeInMinutes": 123,
"contractReference": "<string>",
"gasUpRequired": true,
"coolDownRequired": true
},
"supplier": {
"assetIdentifier": {
"vessel": {
"imo": 123,
"mmsi": 123,
"externalId": "<string>"
},
"terminalName": "<string>"
},
"companyIdentifier": "<string>",
"companyEntityReference": "<string>",
"orderReference": "<string>",
"internalReference": "<string>",
"internalInstructions": "<string>",
"assetOperatorCompanyIdentifier": "<string>"
},
"receiver": {
"companyIdentifier": "<string>",
"companyName": "<string>",
"orderReference": "<string>",
"vesselIdentifier": {
"imo": 123,
"mmsi": 123,
"externalId": "<string>"
},
"estimatedTimeOfArrival": "2023-11-07T05:31:56Z",
"estimatedTimeOfDeparture": "2023-11-07T05:31:56Z",
"lastPortCode": "<string>",
"nextPortCode": "<string>",
"counterpartEntityReference": "<string>",
"companyEntityReference": "<string>"
},
"fuelSpecifications": [
{
"fuelType": "<string>",
"quantityRange": {
"minQuantity": 123,
"maxQuantity": 123
},
"brand": "<string>",
"certificateOfQuality": {
"identifier": "<string>"
},
"biofuelProperties": {
"typeOfFeedstock": "<string>",
"blendRatio": 123,
"isccCertified": true,
"isccValue": 123,
"certificateScheme": "<string>"
}
}
],
"stakeholders": [
{
"companyIdentifier": "<string>",
"userEmail": "<string>"
}
]
}
'import requests
url = "https://api.demo.fuelboss.net/v1/nominations/supplier"
payload = {
"clientReference": "<string>",
"delivery": {
"operationStandardCode": "<string>",
"bunkeringLocationCode": "<string>",
"bunkeringLocationName": "<string>",
"portBunkeringLocationCode": "<string>",
"bunkeringLocationDetails": "<string>",
"berthTime": "2023-11-07T05:31:56Z",
"pilotTime": "2023-11-07T05:31:56Z",
"estimatedTimeOfBunkering": "2023-11-07T05:31:56Z",
"laycanStart": "2023-11-07T05:31:56Z",
"laycanEnd": "2023-11-07T05:31:56Z",
"estimatedTimeOfCompletion": "2023-11-07T05:31:56Z",
"estimatedBunkeringDurationInMinutes": 123,
"supplierAssetBufferTimeInMinutes": 123,
"contractReference": "<string>",
"gasUpRequired": True,
"coolDownRequired": True
},
"supplier": {
"assetIdentifier": {
"vessel": {
"imo": 123,
"mmsi": 123,
"externalId": "<string>"
},
"terminalName": "<string>"
},
"companyIdentifier": "<string>",
"companyEntityReference": "<string>",
"orderReference": "<string>",
"internalReference": "<string>",
"internalInstructions": "<string>",
"assetOperatorCompanyIdentifier": "<string>"
},
"receiver": {
"companyIdentifier": "<string>",
"companyName": "<string>",
"orderReference": "<string>",
"vesselIdentifier": {
"imo": 123,
"mmsi": 123,
"externalId": "<string>"
},
"estimatedTimeOfArrival": "2023-11-07T05:31:56Z",
"estimatedTimeOfDeparture": "2023-11-07T05:31:56Z",
"lastPortCode": "<string>",
"nextPortCode": "<string>",
"counterpartEntityReference": "<string>",
"companyEntityReference": "<string>"
},
"fuelSpecifications": [
{
"fuelType": "<string>",
"quantityRange": {
"minQuantity": 123,
"maxQuantity": 123
},
"brand": "<string>",
"certificateOfQuality": { "identifier": "<string>" },
"biofuelProperties": {
"typeOfFeedstock": "<string>",
"blendRatio": 123,
"isccCertified": True,
"isccValue": 123,
"certificateScheme": "<string>"
}
}
],
"stakeholders": [
{
"companyIdentifier": "<string>",
"userEmail": "<string>"
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
clientReference: '<string>',
delivery: {
operationStandardCode: '<string>',
bunkeringLocationCode: '<string>',
bunkeringLocationName: '<string>',
portBunkeringLocationCode: '<string>',
bunkeringLocationDetails: '<string>',
berthTime: '2023-11-07T05:31:56Z',
pilotTime: '2023-11-07T05:31:56Z',
estimatedTimeOfBunkering: '2023-11-07T05:31:56Z',
laycanStart: '2023-11-07T05:31:56Z',
laycanEnd: '2023-11-07T05:31:56Z',
estimatedTimeOfCompletion: '2023-11-07T05:31:56Z',
estimatedBunkeringDurationInMinutes: 123,
supplierAssetBufferTimeInMinutes: 123,
contractReference: '<string>',
gasUpRequired: true,
coolDownRequired: true
},
supplier: {
assetIdentifier: {
vessel: {imo: 123, mmsi: 123, externalId: '<string>'},
terminalName: '<string>'
},
companyIdentifier: '<string>',
companyEntityReference: '<string>',
orderReference: '<string>',
internalReference: '<string>',
internalInstructions: '<string>',
assetOperatorCompanyIdentifier: '<string>'
},
receiver: {
companyIdentifier: '<string>',
companyName: '<string>',
orderReference: '<string>',
vesselIdentifier: {imo: 123, mmsi: 123, externalId: '<string>'},
estimatedTimeOfArrival: '2023-11-07T05:31:56Z',
estimatedTimeOfDeparture: '2023-11-07T05:31:56Z',
lastPortCode: '<string>',
nextPortCode: '<string>',
counterpartEntityReference: '<string>',
companyEntityReference: '<string>'
},
fuelSpecifications: [
{
fuelType: '<string>',
quantityRange: {minQuantity: 123, maxQuantity: 123},
brand: '<string>',
certificateOfQuality: {identifier: '<string>'},
biofuelProperties: {
typeOfFeedstock: '<string>',
blendRatio: 123,
isccCertified: true,
isccValue: 123,
certificateScheme: '<string>'
}
}
],
stakeholders: [{companyIdentifier: '<string>', userEmail: '<string>'}]
})
};
fetch('https://api.demo.fuelboss.net/v1/nominations/supplier', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.demo.fuelboss.net/v1/nominations/supplier",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'clientReference' => '<string>',
'delivery' => [
'operationStandardCode' => '<string>',
'bunkeringLocationCode' => '<string>',
'bunkeringLocationName' => '<string>',
'portBunkeringLocationCode' => '<string>',
'bunkeringLocationDetails' => '<string>',
'berthTime' => '2023-11-07T05:31:56Z',
'pilotTime' => '2023-11-07T05:31:56Z',
'estimatedTimeOfBunkering' => '2023-11-07T05:31:56Z',
'laycanStart' => '2023-11-07T05:31:56Z',
'laycanEnd' => '2023-11-07T05:31:56Z',
'estimatedTimeOfCompletion' => '2023-11-07T05:31:56Z',
'estimatedBunkeringDurationInMinutes' => 123,
'supplierAssetBufferTimeInMinutes' => 123,
'contractReference' => '<string>',
'gasUpRequired' => true,
'coolDownRequired' => true
],
'supplier' => [
'assetIdentifier' => [
'vessel' => [
'imo' => 123,
'mmsi' => 123,
'externalId' => '<string>'
],
'terminalName' => '<string>'
],
'companyIdentifier' => '<string>',
'companyEntityReference' => '<string>',
'orderReference' => '<string>',
'internalReference' => '<string>',
'internalInstructions' => '<string>',
'assetOperatorCompanyIdentifier' => '<string>'
],
'receiver' => [
'companyIdentifier' => '<string>',
'companyName' => '<string>',
'orderReference' => '<string>',
'vesselIdentifier' => [
'imo' => 123,
'mmsi' => 123,
'externalId' => '<string>'
],
'estimatedTimeOfArrival' => '2023-11-07T05:31:56Z',
'estimatedTimeOfDeparture' => '2023-11-07T05:31:56Z',
'lastPortCode' => '<string>',
'nextPortCode' => '<string>',
'counterpartEntityReference' => '<string>',
'companyEntityReference' => '<string>'
],
'fuelSpecifications' => [
[
'fuelType' => '<string>',
'quantityRange' => [
'minQuantity' => 123,
'maxQuantity' => 123
],
'brand' => '<string>',
'certificateOfQuality' => [
'identifier' => '<string>'
],
'biofuelProperties' => [
'typeOfFeedstock' => '<string>',
'blendRatio' => 123,
'isccCertified' => true,
'isccValue' => 123,
'certificateScheme' => '<string>'
]
]
],
'stakeholders' => [
[
'companyIdentifier' => '<string>',
'userEmail' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.demo.fuelboss.net/v1/nominations/supplier"
payload := strings.NewReader("{\n \"clientReference\": \"<string>\",\n \"delivery\": {\n \"operationStandardCode\": \"<string>\",\n \"bunkeringLocationCode\": \"<string>\",\n \"bunkeringLocationName\": \"<string>\",\n \"portBunkeringLocationCode\": \"<string>\",\n \"bunkeringLocationDetails\": \"<string>\",\n \"berthTime\": \"2023-11-07T05:31:56Z\",\n \"pilotTime\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfBunkering\": \"2023-11-07T05:31:56Z\",\n \"laycanStart\": \"2023-11-07T05:31:56Z\",\n \"laycanEnd\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfCompletion\": \"2023-11-07T05:31:56Z\",\n \"estimatedBunkeringDurationInMinutes\": 123,\n \"supplierAssetBufferTimeInMinutes\": 123,\n \"contractReference\": \"<string>\",\n \"gasUpRequired\": true,\n \"coolDownRequired\": true\n },\n \"supplier\": {\n \"assetIdentifier\": {\n \"vessel\": {\n \"imo\": 123,\n \"mmsi\": 123,\n \"externalId\": \"<string>\"\n },\n \"terminalName\": \"<string>\"\n },\n \"companyIdentifier\": \"<string>\",\n \"companyEntityReference\": \"<string>\",\n \"orderReference\": \"<string>\",\n \"internalReference\": \"<string>\",\n \"internalInstructions\": \"<string>\",\n \"assetOperatorCompanyIdentifier\": \"<string>\"\n },\n \"receiver\": {\n \"companyIdentifier\": \"<string>\",\n \"companyName\": \"<string>\",\n \"orderReference\": \"<string>\",\n \"vesselIdentifier\": {\n \"imo\": 123,\n \"mmsi\": 123,\n \"externalId\": \"<string>\"\n },\n \"estimatedTimeOfArrival\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfDeparture\": \"2023-11-07T05:31:56Z\",\n \"lastPortCode\": \"<string>\",\n \"nextPortCode\": \"<string>\",\n \"counterpartEntityReference\": \"<string>\",\n \"companyEntityReference\": \"<string>\"\n },\n \"fuelSpecifications\": [\n {\n \"fuelType\": \"<string>\",\n \"quantityRange\": {\n \"minQuantity\": 123,\n \"maxQuantity\": 123\n },\n \"brand\": \"<string>\",\n \"certificateOfQuality\": {\n \"identifier\": \"<string>\"\n },\n \"biofuelProperties\": {\n \"typeOfFeedstock\": \"<string>\",\n \"blendRatio\": 123,\n \"isccCertified\": true,\n \"isccValue\": 123,\n \"certificateScheme\": \"<string>\"\n }\n }\n ],\n \"stakeholders\": [\n {\n \"companyIdentifier\": \"<string>\",\n \"userEmail\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.demo.fuelboss.net/v1/nominations/supplier")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"clientReference\": \"<string>\",\n \"delivery\": {\n \"operationStandardCode\": \"<string>\",\n \"bunkeringLocationCode\": \"<string>\",\n \"bunkeringLocationName\": \"<string>\",\n \"portBunkeringLocationCode\": \"<string>\",\n \"bunkeringLocationDetails\": \"<string>\",\n \"berthTime\": \"2023-11-07T05:31:56Z\",\n \"pilotTime\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfBunkering\": \"2023-11-07T05:31:56Z\",\n \"laycanStart\": \"2023-11-07T05:31:56Z\",\n \"laycanEnd\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfCompletion\": \"2023-11-07T05:31:56Z\",\n \"estimatedBunkeringDurationInMinutes\": 123,\n \"supplierAssetBufferTimeInMinutes\": 123,\n \"contractReference\": \"<string>\",\n \"gasUpRequired\": true,\n \"coolDownRequired\": true\n },\n \"supplier\": {\n \"assetIdentifier\": {\n \"vessel\": {\n \"imo\": 123,\n \"mmsi\": 123,\n \"externalId\": \"<string>\"\n },\n \"terminalName\": \"<string>\"\n },\n \"companyIdentifier\": \"<string>\",\n \"companyEntityReference\": \"<string>\",\n \"orderReference\": \"<string>\",\n \"internalReference\": \"<string>\",\n \"internalInstructions\": \"<string>\",\n \"assetOperatorCompanyIdentifier\": \"<string>\"\n },\n \"receiver\": {\n \"companyIdentifier\": \"<string>\",\n \"companyName\": \"<string>\",\n \"orderReference\": \"<string>\",\n \"vesselIdentifier\": {\n \"imo\": 123,\n \"mmsi\": 123,\n \"externalId\": \"<string>\"\n },\n \"estimatedTimeOfArrival\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfDeparture\": \"2023-11-07T05:31:56Z\",\n \"lastPortCode\": \"<string>\",\n \"nextPortCode\": \"<string>\",\n \"counterpartEntityReference\": \"<string>\",\n \"companyEntityReference\": \"<string>\"\n },\n \"fuelSpecifications\": [\n {\n \"fuelType\": \"<string>\",\n \"quantityRange\": {\n \"minQuantity\": 123,\n \"maxQuantity\": 123\n },\n \"brand\": \"<string>\",\n \"certificateOfQuality\": {\n \"identifier\": \"<string>\"\n },\n \"biofuelProperties\": {\n \"typeOfFeedstock\": \"<string>\",\n \"blendRatio\": 123,\n \"isccCertified\": true,\n \"isccValue\": 123,\n \"certificateScheme\": \"<string>\"\n }\n }\n ],\n \"stakeholders\": [\n {\n \"companyIdentifier\": \"<string>\",\n \"userEmail\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.demo.fuelboss.net/v1/nominations/supplier")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"clientReference\": \"<string>\",\n \"delivery\": {\n \"operationStandardCode\": \"<string>\",\n \"bunkeringLocationCode\": \"<string>\",\n \"bunkeringLocationName\": \"<string>\",\n \"portBunkeringLocationCode\": \"<string>\",\n \"bunkeringLocationDetails\": \"<string>\",\n \"berthTime\": \"2023-11-07T05:31:56Z\",\n \"pilotTime\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfBunkering\": \"2023-11-07T05:31:56Z\",\n \"laycanStart\": \"2023-11-07T05:31:56Z\",\n \"laycanEnd\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfCompletion\": \"2023-11-07T05:31:56Z\",\n \"estimatedBunkeringDurationInMinutes\": 123,\n \"supplierAssetBufferTimeInMinutes\": 123,\n \"contractReference\": \"<string>\",\n \"gasUpRequired\": true,\n \"coolDownRequired\": true\n },\n \"supplier\": {\n \"assetIdentifier\": {\n \"vessel\": {\n \"imo\": 123,\n \"mmsi\": 123,\n \"externalId\": \"<string>\"\n },\n \"terminalName\": \"<string>\"\n },\n \"companyIdentifier\": \"<string>\",\n \"companyEntityReference\": \"<string>\",\n \"orderReference\": \"<string>\",\n \"internalReference\": \"<string>\",\n \"internalInstructions\": \"<string>\",\n \"assetOperatorCompanyIdentifier\": \"<string>\"\n },\n \"receiver\": {\n \"companyIdentifier\": \"<string>\",\n \"companyName\": \"<string>\",\n \"orderReference\": \"<string>\",\n \"vesselIdentifier\": {\n \"imo\": 123,\n \"mmsi\": 123,\n \"externalId\": \"<string>\"\n },\n \"estimatedTimeOfArrival\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfDeparture\": \"2023-11-07T05:31:56Z\",\n \"lastPortCode\": \"<string>\",\n \"nextPortCode\": \"<string>\",\n \"counterpartEntityReference\": \"<string>\",\n \"companyEntityReference\": \"<string>\"\n },\n \"fuelSpecifications\": [\n {\n \"fuelType\": \"<string>\",\n \"quantityRange\": {\n \"minQuantity\": 123,\n \"maxQuantity\": 123\n },\n \"brand\": \"<string>\",\n \"certificateOfQuality\": {\n \"identifier\": \"<string>\"\n },\n \"biofuelProperties\": {\n \"typeOfFeedstock\": \"<string>\",\n \"blendRatio\": 123,\n \"isccCertified\": true,\n \"isccValue\": 123,\n \"certificateScheme\": \"<string>\"\n }\n }\n ],\n \"stakeholders\": [\n {\n \"companyIdentifier\": \"<string>\",\n \"userEmail\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"clientReference": "<string>",
"status": "supplier_requested",
"lastChangedAtUtc": "2023-11-07T05:31:56Z"
}{
"clientReference": "<string>",
"status": "supplier_requested",
"lastChangedAtUtc": "2023-11-07T05:31:56Z"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"trace_id": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"trace_id": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"trace_id": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"trace_id": "<string>"
}Nominations
Creates or updates a nomination as a supplier
Creates a new nomination or updates an existing one based on the client reference. Uses idempotency to prevent duplicate submissions
PUT
/
v1
/
nominations
/
supplier
Creates or updates a nomination as a supplier
curl --request PUT \
--url https://api.demo.fuelboss.net/v1/nominations/supplier \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"clientReference": "<string>",
"delivery": {
"operationStandardCode": "<string>",
"bunkeringLocationCode": "<string>",
"bunkeringLocationName": "<string>",
"portBunkeringLocationCode": "<string>",
"bunkeringLocationDetails": "<string>",
"berthTime": "2023-11-07T05:31:56Z",
"pilotTime": "2023-11-07T05:31:56Z",
"estimatedTimeOfBunkering": "2023-11-07T05:31:56Z",
"laycanStart": "2023-11-07T05:31:56Z",
"laycanEnd": "2023-11-07T05:31:56Z",
"estimatedTimeOfCompletion": "2023-11-07T05:31:56Z",
"estimatedBunkeringDurationInMinutes": 123,
"supplierAssetBufferTimeInMinutes": 123,
"contractReference": "<string>",
"gasUpRequired": true,
"coolDownRequired": true
},
"supplier": {
"assetIdentifier": {
"vessel": {
"imo": 123,
"mmsi": 123,
"externalId": "<string>"
},
"terminalName": "<string>"
},
"companyIdentifier": "<string>",
"companyEntityReference": "<string>",
"orderReference": "<string>",
"internalReference": "<string>",
"internalInstructions": "<string>",
"assetOperatorCompanyIdentifier": "<string>"
},
"receiver": {
"companyIdentifier": "<string>",
"companyName": "<string>",
"orderReference": "<string>",
"vesselIdentifier": {
"imo": 123,
"mmsi": 123,
"externalId": "<string>"
},
"estimatedTimeOfArrival": "2023-11-07T05:31:56Z",
"estimatedTimeOfDeparture": "2023-11-07T05:31:56Z",
"lastPortCode": "<string>",
"nextPortCode": "<string>",
"counterpartEntityReference": "<string>",
"companyEntityReference": "<string>"
},
"fuelSpecifications": [
{
"fuelType": "<string>",
"quantityRange": {
"minQuantity": 123,
"maxQuantity": 123
},
"brand": "<string>",
"certificateOfQuality": {
"identifier": "<string>"
},
"biofuelProperties": {
"typeOfFeedstock": "<string>",
"blendRatio": 123,
"isccCertified": true,
"isccValue": 123,
"certificateScheme": "<string>"
}
}
],
"stakeholders": [
{
"companyIdentifier": "<string>",
"userEmail": "<string>"
}
]
}
'import requests
url = "https://api.demo.fuelboss.net/v1/nominations/supplier"
payload = {
"clientReference": "<string>",
"delivery": {
"operationStandardCode": "<string>",
"bunkeringLocationCode": "<string>",
"bunkeringLocationName": "<string>",
"portBunkeringLocationCode": "<string>",
"bunkeringLocationDetails": "<string>",
"berthTime": "2023-11-07T05:31:56Z",
"pilotTime": "2023-11-07T05:31:56Z",
"estimatedTimeOfBunkering": "2023-11-07T05:31:56Z",
"laycanStart": "2023-11-07T05:31:56Z",
"laycanEnd": "2023-11-07T05:31:56Z",
"estimatedTimeOfCompletion": "2023-11-07T05:31:56Z",
"estimatedBunkeringDurationInMinutes": 123,
"supplierAssetBufferTimeInMinutes": 123,
"contractReference": "<string>",
"gasUpRequired": True,
"coolDownRequired": True
},
"supplier": {
"assetIdentifier": {
"vessel": {
"imo": 123,
"mmsi": 123,
"externalId": "<string>"
},
"terminalName": "<string>"
},
"companyIdentifier": "<string>",
"companyEntityReference": "<string>",
"orderReference": "<string>",
"internalReference": "<string>",
"internalInstructions": "<string>",
"assetOperatorCompanyIdentifier": "<string>"
},
"receiver": {
"companyIdentifier": "<string>",
"companyName": "<string>",
"orderReference": "<string>",
"vesselIdentifier": {
"imo": 123,
"mmsi": 123,
"externalId": "<string>"
},
"estimatedTimeOfArrival": "2023-11-07T05:31:56Z",
"estimatedTimeOfDeparture": "2023-11-07T05:31:56Z",
"lastPortCode": "<string>",
"nextPortCode": "<string>",
"counterpartEntityReference": "<string>",
"companyEntityReference": "<string>"
},
"fuelSpecifications": [
{
"fuelType": "<string>",
"quantityRange": {
"minQuantity": 123,
"maxQuantity": 123
},
"brand": "<string>",
"certificateOfQuality": { "identifier": "<string>" },
"biofuelProperties": {
"typeOfFeedstock": "<string>",
"blendRatio": 123,
"isccCertified": True,
"isccValue": 123,
"certificateScheme": "<string>"
}
}
],
"stakeholders": [
{
"companyIdentifier": "<string>",
"userEmail": "<string>"
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
clientReference: '<string>',
delivery: {
operationStandardCode: '<string>',
bunkeringLocationCode: '<string>',
bunkeringLocationName: '<string>',
portBunkeringLocationCode: '<string>',
bunkeringLocationDetails: '<string>',
berthTime: '2023-11-07T05:31:56Z',
pilotTime: '2023-11-07T05:31:56Z',
estimatedTimeOfBunkering: '2023-11-07T05:31:56Z',
laycanStart: '2023-11-07T05:31:56Z',
laycanEnd: '2023-11-07T05:31:56Z',
estimatedTimeOfCompletion: '2023-11-07T05:31:56Z',
estimatedBunkeringDurationInMinutes: 123,
supplierAssetBufferTimeInMinutes: 123,
contractReference: '<string>',
gasUpRequired: true,
coolDownRequired: true
},
supplier: {
assetIdentifier: {
vessel: {imo: 123, mmsi: 123, externalId: '<string>'},
terminalName: '<string>'
},
companyIdentifier: '<string>',
companyEntityReference: '<string>',
orderReference: '<string>',
internalReference: '<string>',
internalInstructions: '<string>',
assetOperatorCompanyIdentifier: '<string>'
},
receiver: {
companyIdentifier: '<string>',
companyName: '<string>',
orderReference: '<string>',
vesselIdentifier: {imo: 123, mmsi: 123, externalId: '<string>'},
estimatedTimeOfArrival: '2023-11-07T05:31:56Z',
estimatedTimeOfDeparture: '2023-11-07T05:31:56Z',
lastPortCode: '<string>',
nextPortCode: '<string>',
counterpartEntityReference: '<string>',
companyEntityReference: '<string>'
},
fuelSpecifications: [
{
fuelType: '<string>',
quantityRange: {minQuantity: 123, maxQuantity: 123},
brand: '<string>',
certificateOfQuality: {identifier: '<string>'},
biofuelProperties: {
typeOfFeedstock: '<string>',
blendRatio: 123,
isccCertified: true,
isccValue: 123,
certificateScheme: '<string>'
}
}
],
stakeholders: [{companyIdentifier: '<string>', userEmail: '<string>'}]
})
};
fetch('https://api.demo.fuelboss.net/v1/nominations/supplier', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.demo.fuelboss.net/v1/nominations/supplier",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'clientReference' => '<string>',
'delivery' => [
'operationStandardCode' => '<string>',
'bunkeringLocationCode' => '<string>',
'bunkeringLocationName' => '<string>',
'portBunkeringLocationCode' => '<string>',
'bunkeringLocationDetails' => '<string>',
'berthTime' => '2023-11-07T05:31:56Z',
'pilotTime' => '2023-11-07T05:31:56Z',
'estimatedTimeOfBunkering' => '2023-11-07T05:31:56Z',
'laycanStart' => '2023-11-07T05:31:56Z',
'laycanEnd' => '2023-11-07T05:31:56Z',
'estimatedTimeOfCompletion' => '2023-11-07T05:31:56Z',
'estimatedBunkeringDurationInMinutes' => 123,
'supplierAssetBufferTimeInMinutes' => 123,
'contractReference' => '<string>',
'gasUpRequired' => true,
'coolDownRequired' => true
],
'supplier' => [
'assetIdentifier' => [
'vessel' => [
'imo' => 123,
'mmsi' => 123,
'externalId' => '<string>'
],
'terminalName' => '<string>'
],
'companyIdentifier' => '<string>',
'companyEntityReference' => '<string>',
'orderReference' => '<string>',
'internalReference' => '<string>',
'internalInstructions' => '<string>',
'assetOperatorCompanyIdentifier' => '<string>'
],
'receiver' => [
'companyIdentifier' => '<string>',
'companyName' => '<string>',
'orderReference' => '<string>',
'vesselIdentifier' => [
'imo' => 123,
'mmsi' => 123,
'externalId' => '<string>'
],
'estimatedTimeOfArrival' => '2023-11-07T05:31:56Z',
'estimatedTimeOfDeparture' => '2023-11-07T05:31:56Z',
'lastPortCode' => '<string>',
'nextPortCode' => '<string>',
'counterpartEntityReference' => '<string>',
'companyEntityReference' => '<string>'
],
'fuelSpecifications' => [
[
'fuelType' => '<string>',
'quantityRange' => [
'minQuantity' => 123,
'maxQuantity' => 123
],
'brand' => '<string>',
'certificateOfQuality' => [
'identifier' => '<string>'
],
'biofuelProperties' => [
'typeOfFeedstock' => '<string>',
'blendRatio' => 123,
'isccCertified' => true,
'isccValue' => 123,
'certificateScheme' => '<string>'
]
]
],
'stakeholders' => [
[
'companyIdentifier' => '<string>',
'userEmail' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.demo.fuelboss.net/v1/nominations/supplier"
payload := strings.NewReader("{\n \"clientReference\": \"<string>\",\n \"delivery\": {\n \"operationStandardCode\": \"<string>\",\n \"bunkeringLocationCode\": \"<string>\",\n \"bunkeringLocationName\": \"<string>\",\n \"portBunkeringLocationCode\": \"<string>\",\n \"bunkeringLocationDetails\": \"<string>\",\n \"berthTime\": \"2023-11-07T05:31:56Z\",\n \"pilotTime\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfBunkering\": \"2023-11-07T05:31:56Z\",\n \"laycanStart\": \"2023-11-07T05:31:56Z\",\n \"laycanEnd\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfCompletion\": \"2023-11-07T05:31:56Z\",\n \"estimatedBunkeringDurationInMinutes\": 123,\n \"supplierAssetBufferTimeInMinutes\": 123,\n \"contractReference\": \"<string>\",\n \"gasUpRequired\": true,\n \"coolDownRequired\": true\n },\n \"supplier\": {\n \"assetIdentifier\": {\n \"vessel\": {\n \"imo\": 123,\n \"mmsi\": 123,\n \"externalId\": \"<string>\"\n },\n \"terminalName\": \"<string>\"\n },\n \"companyIdentifier\": \"<string>\",\n \"companyEntityReference\": \"<string>\",\n \"orderReference\": \"<string>\",\n \"internalReference\": \"<string>\",\n \"internalInstructions\": \"<string>\",\n \"assetOperatorCompanyIdentifier\": \"<string>\"\n },\n \"receiver\": {\n \"companyIdentifier\": \"<string>\",\n \"companyName\": \"<string>\",\n \"orderReference\": \"<string>\",\n \"vesselIdentifier\": {\n \"imo\": 123,\n \"mmsi\": 123,\n \"externalId\": \"<string>\"\n },\n \"estimatedTimeOfArrival\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfDeparture\": \"2023-11-07T05:31:56Z\",\n \"lastPortCode\": \"<string>\",\n \"nextPortCode\": \"<string>\",\n \"counterpartEntityReference\": \"<string>\",\n \"companyEntityReference\": \"<string>\"\n },\n \"fuelSpecifications\": [\n {\n \"fuelType\": \"<string>\",\n \"quantityRange\": {\n \"minQuantity\": 123,\n \"maxQuantity\": 123\n },\n \"brand\": \"<string>\",\n \"certificateOfQuality\": {\n \"identifier\": \"<string>\"\n },\n \"biofuelProperties\": {\n \"typeOfFeedstock\": \"<string>\",\n \"blendRatio\": 123,\n \"isccCertified\": true,\n \"isccValue\": 123,\n \"certificateScheme\": \"<string>\"\n }\n }\n ],\n \"stakeholders\": [\n {\n \"companyIdentifier\": \"<string>\",\n \"userEmail\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.demo.fuelboss.net/v1/nominations/supplier")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"clientReference\": \"<string>\",\n \"delivery\": {\n \"operationStandardCode\": \"<string>\",\n \"bunkeringLocationCode\": \"<string>\",\n \"bunkeringLocationName\": \"<string>\",\n \"portBunkeringLocationCode\": \"<string>\",\n \"bunkeringLocationDetails\": \"<string>\",\n \"berthTime\": \"2023-11-07T05:31:56Z\",\n \"pilotTime\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfBunkering\": \"2023-11-07T05:31:56Z\",\n \"laycanStart\": \"2023-11-07T05:31:56Z\",\n \"laycanEnd\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfCompletion\": \"2023-11-07T05:31:56Z\",\n \"estimatedBunkeringDurationInMinutes\": 123,\n \"supplierAssetBufferTimeInMinutes\": 123,\n \"contractReference\": \"<string>\",\n \"gasUpRequired\": true,\n \"coolDownRequired\": true\n },\n \"supplier\": {\n \"assetIdentifier\": {\n \"vessel\": {\n \"imo\": 123,\n \"mmsi\": 123,\n \"externalId\": \"<string>\"\n },\n \"terminalName\": \"<string>\"\n },\n \"companyIdentifier\": \"<string>\",\n \"companyEntityReference\": \"<string>\",\n \"orderReference\": \"<string>\",\n \"internalReference\": \"<string>\",\n \"internalInstructions\": \"<string>\",\n \"assetOperatorCompanyIdentifier\": \"<string>\"\n },\n \"receiver\": {\n \"companyIdentifier\": \"<string>\",\n \"companyName\": \"<string>\",\n \"orderReference\": \"<string>\",\n \"vesselIdentifier\": {\n \"imo\": 123,\n \"mmsi\": 123,\n \"externalId\": \"<string>\"\n },\n \"estimatedTimeOfArrival\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfDeparture\": \"2023-11-07T05:31:56Z\",\n \"lastPortCode\": \"<string>\",\n \"nextPortCode\": \"<string>\",\n \"counterpartEntityReference\": \"<string>\",\n \"companyEntityReference\": \"<string>\"\n },\n \"fuelSpecifications\": [\n {\n \"fuelType\": \"<string>\",\n \"quantityRange\": {\n \"minQuantity\": 123,\n \"maxQuantity\": 123\n },\n \"brand\": \"<string>\",\n \"certificateOfQuality\": {\n \"identifier\": \"<string>\"\n },\n \"biofuelProperties\": {\n \"typeOfFeedstock\": \"<string>\",\n \"blendRatio\": 123,\n \"isccCertified\": true,\n \"isccValue\": 123,\n \"certificateScheme\": \"<string>\"\n }\n }\n ],\n \"stakeholders\": [\n {\n \"companyIdentifier\": \"<string>\",\n \"userEmail\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.demo.fuelboss.net/v1/nominations/supplier")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"clientReference\": \"<string>\",\n \"delivery\": {\n \"operationStandardCode\": \"<string>\",\n \"bunkeringLocationCode\": \"<string>\",\n \"bunkeringLocationName\": \"<string>\",\n \"portBunkeringLocationCode\": \"<string>\",\n \"bunkeringLocationDetails\": \"<string>\",\n \"berthTime\": \"2023-11-07T05:31:56Z\",\n \"pilotTime\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfBunkering\": \"2023-11-07T05:31:56Z\",\n \"laycanStart\": \"2023-11-07T05:31:56Z\",\n \"laycanEnd\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfCompletion\": \"2023-11-07T05:31:56Z\",\n \"estimatedBunkeringDurationInMinutes\": 123,\n \"supplierAssetBufferTimeInMinutes\": 123,\n \"contractReference\": \"<string>\",\n \"gasUpRequired\": true,\n \"coolDownRequired\": true\n },\n \"supplier\": {\n \"assetIdentifier\": {\n \"vessel\": {\n \"imo\": 123,\n \"mmsi\": 123,\n \"externalId\": \"<string>\"\n },\n \"terminalName\": \"<string>\"\n },\n \"companyIdentifier\": \"<string>\",\n \"companyEntityReference\": \"<string>\",\n \"orderReference\": \"<string>\",\n \"internalReference\": \"<string>\",\n \"internalInstructions\": \"<string>\",\n \"assetOperatorCompanyIdentifier\": \"<string>\"\n },\n \"receiver\": {\n \"companyIdentifier\": \"<string>\",\n \"companyName\": \"<string>\",\n \"orderReference\": \"<string>\",\n \"vesselIdentifier\": {\n \"imo\": 123,\n \"mmsi\": 123,\n \"externalId\": \"<string>\"\n },\n \"estimatedTimeOfArrival\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfDeparture\": \"2023-11-07T05:31:56Z\",\n \"lastPortCode\": \"<string>\",\n \"nextPortCode\": \"<string>\",\n \"counterpartEntityReference\": \"<string>\",\n \"companyEntityReference\": \"<string>\"\n },\n \"fuelSpecifications\": [\n {\n \"fuelType\": \"<string>\",\n \"quantityRange\": {\n \"minQuantity\": 123,\n \"maxQuantity\": 123\n },\n \"brand\": \"<string>\",\n \"certificateOfQuality\": {\n \"identifier\": \"<string>\"\n },\n \"biofuelProperties\": {\n \"typeOfFeedstock\": \"<string>\",\n \"blendRatio\": 123,\n \"isccCertified\": true,\n \"isccValue\": 123,\n \"certificateScheme\": \"<string>\"\n }\n }\n ],\n \"stakeholders\": [\n {\n \"companyIdentifier\": \"<string>\",\n \"userEmail\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"clientReference": "<string>",
"status": "supplier_requested",
"lastChangedAtUtc": "2023-11-07T05:31:56Z"
}{
"clientReference": "<string>",
"status": "supplier_requested",
"lastChangedAtUtc": "2023-11-07T05:31:56Z"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"trace_id": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"trace_id": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"trace_id": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"trace_id": "<string>"
}Authorizations
Access token obtained from the /oauth/token endpoint using your client credentials.
Body
application/json
Request body for creating or updating a nomination as a supplier company.
Your unique identifier for the nomination within your company, used to reference the nomination in all subsequent calls.
Delivery information.
Show child attributes
Show child attributes
Supplier information. Omit to nominate as your own company.
Show child attributes
Show child attributes
Receiver information.
Show child attributes
Show child attributes
Fuel specifications for the nomination.
Show child attributes
Show child attributes
Stakeholders involved in the nomination.
Show child attributes
Show child attributes
Response
OK
Response returned after creating or updating a nomination as a supplier company.
Your unique identifier for the nomination within your company.
Status of the nomination after the operation.
Possible values:
supplier_requested— Supplier has been requested for this nomination.supplier_unassigned— Nomination has no supplier assigned.supplier_assigned— Supplier has been assigned to the nomination.operation_started— Bunkering operation has started.cancelled— Nomination has been cancelled.accepted— Nomination has been accepted by the supplier.amended— Nomination has been amended. Not currently returned as a nomination's current status; accept it for forward compatibility.
Available options:
supplier_requested, supplier_unassigned, supplier_assigned, operation_started, cancelled, accepted, amended UTC timestamp of the last change to the nomination.
⌘I