Creates or updates a draft nomination
curl --request PUT \
--url https://api.demo.fuelboss.net/v1/nominations/drafts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"clientReference": "<string>",
"delivery": {
"operationStandardCode": "<string>",
"laycanStart": "2023-11-07T05:31:56Z",
"laycanEnd": "2023-11-07T05:31:56Z",
"bunkeringLocationCode": "<string>",
"portBunkeringLocationCode": "<string>",
"bunkeringLocationDetails": "<string>",
"berthTime": "2023-11-07T05:31:56Z",
"pilotTime": "2023-11-07T05:31:56Z",
"estimatedTimeOfBunkering": "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>",
"vesselIdentifier": {
"imo": 123,
"mmsi": 123,
"externalId": "<string>"
},
"vesselName": "<string>",
"estimatedTimeOfArrival": "2023-11-07T05:31:56Z",
"estimatedTimeOfDeparture": "2023-11-07T05:31:56Z",
"orderReference": "<string>",
"lastPortCode": "<string>",
"nextPortCode": "<string>",
"counterpartEntityReference": "<string>",
"companyEntityReference": "<string>"
},
"fuelSpecifications": [
{
"fuelType": "<string>",
"brand": "<string>",
"quantityRange": {
"minQuantity": 123,
"maxQuantity": 123
},
"certificateOfQuality": {
"identifier": "<string>",
"flashPoint": {
"value": "<string>"
},
"pourPoint": {
"value": 123
},
"viscosity": {
"value": 123
},
"sulphurContent": {
"value": "<string>"
},
"density": {
"value": 123
},
"waterContent": {
"value": "<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/drafts"
payload = {
"clientReference": "<string>",
"delivery": {
"operationStandardCode": "<string>",
"laycanStart": "2023-11-07T05:31:56Z",
"laycanEnd": "2023-11-07T05:31:56Z",
"bunkeringLocationCode": "<string>",
"portBunkeringLocationCode": "<string>",
"bunkeringLocationDetails": "<string>",
"berthTime": "2023-11-07T05:31:56Z",
"pilotTime": "2023-11-07T05:31:56Z",
"estimatedTimeOfBunkering": "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>",
"vesselIdentifier": {
"imo": 123,
"mmsi": 123,
"externalId": "<string>"
},
"vesselName": "<string>",
"estimatedTimeOfArrival": "2023-11-07T05:31:56Z",
"estimatedTimeOfDeparture": "2023-11-07T05:31:56Z",
"orderReference": "<string>",
"lastPortCode": "<string>",
"nextPortCode": "<string>",
"counterpartEntityReference": "<string>",
"companyEntityReference": "<string>"
},
"fuelSpecifications": [
{
"fuelType": "<string>",
"brand": "<string>",
"quantityRange": {
"minQuantity": 123,
"maxQuantity": 123
},
"certificateOfQuality": {
"identifier": "<string>",
"flashPoint": { "value": "<string>" },
"pourPoint": { "value": 123 },
"viscosity": { "value": 123 },
"sulphurContent": { "value": "<string>" },
"density": { "value": 123 },
"waterContent": { "value": "<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>',
laycanStart: '2023-11-07T05:31:56Z',
laycanEnd: '2023-11-07T05:31:56Z',
bunkeringLocationCode: '<string>',
portBunkeringLocationCode: '<string>',
bunkeringLocationDetails: '<string>',
berthTime: '2023-11-07T05:31:56Z',
pilotTime: '2023-11-07T05:31:56Z',
estimatedTimeOfBunkering: '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>',
vesselIdentifier: {imo: 123, mmsi: 123, externalId: '<string>'},
vesselName: '<string>',
estimatedTimeOfArrival: '2023-11-07T05:31:56Z',
estimatedTimeOfDeparture: '2023-11-07T05:31:56Z',
orderReference: '<string>',
lastPortCode: '<string>',
nextPortCode: '<string>',
counterpartEntityReference: '<string>',
companyEntityReference: '<string>'
},
fuelSpecifications: [
{
fuelType: '<string>',
brand: '<string>',
quantityRange: {minQuantity: 123, maxQuantity: 123},
certificateOfQuality: {
identifier: '<string>',
flashPoint: {value: '<string>'},
pourPoint: {value: 123},
viscosity: {value: 123},
sulphurContent: {value: '<string>'},
density: {value: 123},
waterContent: {value: '<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/drafts', 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/drafts",
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>',
'laycanStart' => '2023-11-07T05:31:56Z',
'laycanEnd' => '2023-11-07T05:31:56Z',
'bunkeringLocationCode' => '<string>',
'portBunkeringLocationCode' => '<string>',
'bunkeringLocationDetails' => '<string>',
'berthTime' => '2023-11-07T05:31:56Z',
'pilotTime' => '2023-11-07T05:31:56Z',
'estimatedTimeOfBunkering' => '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>',
'vesselIdentifier' => [
'imo' => 123,
'mmsi' => 123,
'externalId' => '<string>'
],
'vesselName' => '<string>',
'estimatedTimeOfArrival' => '2023-11-07T05:31:56Z',
'estimatedTimeOfDeparture' => '2023-11-07T05:31:56Z',
'orderReference' => '<string>',
'lastPortCode' => '<string>',
'nextPortCode' => '<string>',
'counterpartEntityReference' => '<string>',
'companyEntityReference' => '<string>'
],
'fuelSpecifications' => [
[
'fuelType' => '<string>',
'brand' => '<string>',
'quantityRange' => [
'minQuantity' => 123,
'maxQuantity' => 123
],
'certificateOfQuality' => [
'identifier' => '<string>',
'flashPoint' => [
'value' => '<string>'
],
'pourPoint' => [
'value' => 123
],
'viscosity' => [
'value' => 123
],
'sulphurContent' => [
'value' => '<string>'
],
'density' => [
'value' => 123
],
'waterContent' => [
'value' => '<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/drafts"
payload := strings.NewReader("{\n \"clientReference\": \"<string>\",\n \"delivery\": {\n \"operationStandardCode\": \"<string>\",\n \"laycanStart\": \"2023-11-07T05:31:56Z\",\n \"laycanEnd\": \"2023-11-07T05:31:56Z\",\n \"bunkeringLocationCode\": \"<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 \"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 \"vesselIdentifier\": {\n \"imo\": 123,\n \"mmsi\": 123,\n \"externalId\": \"<string>\"\n },\n \"vesselName\": \"<string>\",\n \"estimatedTimeOfArrival\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfDeparture\": \"2023-11-07T05:31:56Z\",\n \"orderReference\": \"<string>\",\n \"lastPortCode\": \"<string>\",\n \"nextPortCode\": \"<string>\",\n \"counterpartEntityReference\": \"<string>\",\n \"companyEntityReference\": \"<string>\"\n },\n \"fuelSpecifications\": [\n {\n \"fuelType\": \"<string>\",\n \"brand\": \"<string>\",\n \"quantityRange\": {\n \"minQuantity\": 123,\n \"maxQuantity\": 123\n },\n \"certificateOfQuality\": {\n \"identifier\": \"<string>\",\n \"flashPoint\": {\n \"value\": \"<string>\"\n },\n \"pourPoint\": {\n \"value\": 123\n },\n \"viscosity\": {\n \"value\": 123\n },\n \"sulphurContent\": {\n \"value\": \"<string>\"\n },\n \"density\": {\n \"value\": 123\n },\n \"waterContent\": {\n \"value\": \"<string>\"\n }\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/drafts")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"clientReference\": \"<string>\",\n \"delivery\": {\n \"operationStandardCode\": \"<string>\",\n \"laycanStart\": \"2023-11-07T05:31:56Z\",\n \"laycanEnd\": \"2023-11-07T05:31:56Z\",\n \"bunkeringLocationCode\": \"<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 \"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 \"vesselIdentifier\": {\n \"imo\": 123,\n \"mmsi\": 123,\n \"externalId\": \"<string>\"\n },\n \"vesselName\": \"<string>\",\n \"estimatedTimeOfArrival\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfDeparture\": \"2023-11-07T05:31:56Z\",\n \"orderReference\": \"<string>\",\n \"lastPortCode\": \"<string>\",\n \"nextPortCode\": \"<string>\",\n \"counterpartEntityReference\": \"<string>\",\n \"companyEntityReference\": \"<string>\"\n },\n \"fuelSpecifications\": [\n {\n \"fuelType\": \"<string>\",\n \"brand\": \"<string>\",\n \"quantityRange\": {\n \"minQuantity\": 123,\n \"maxQuantity\": 123\n },\n \"certificateOfQuality\": {\n \"identifier\": \"<string>\",\n \"flashPoint\": {\n \"value\": \"<string>\"\n },\n \"pourPoint\": {\n \"value\": 123\n },\n \"viscosity\": {\n \"value\": 123\n },\n \"sulphurContent\": {\n \"value\": \"<string>\"\n },\n \"density\": {\n \"value\": 123\n },\n \"waterContent\": {\n \"value\": \"<string>\"\n }\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/drafts")
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 \"laycanStart\": \"2023-11-07T05:31:56Z\",\n \"laycanEnd\": \"2023-11-07T05:31:56Z\",\n \"bunkeringLocationCode\": \"<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 \"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 \"vesselIdentifier\": {\n \"imo\": 123,\n \"mmsi\": 123,\n \"externalId\": \"<string>\"\n },\n \"vesselName\": \"<string>\",\n \"estimatedTimeOfArrival\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfDeparture\": \"2023-11-07T05:31:56Z\",\n \"orderReference\": \"<string>\",\n \"lastPortCode\": \"<string>\",\n \"nextPortCode\": \"<string>\",\n \"counterpartEntityReference\": \"<string>\",\n \"companyEntityReference\": \"<string>\"\n },\n \"fuelSpecifications\": [\n {\n \"fuelType\": \"<string>\",\n \"brand\": \"<string>\",\n \"quantityRange\": {\n \"minQuantity\": 123,\n \"maxQuantity\": 123\n },\n \"certificateOfQuality\": {\n \"identifier\": \"<string>\",\n \"flashPoint\": {\n \"value\": \"<string>\"\n },\n \"pourPoint\": {\n \"value\": 123\n },\n \"viscosity\": {\n \"value\": 123\n },\n \"sulphurContent\": {\n \"value\": \"<string>\"\n },\n \"density\": {\n \"value\": 123\n },\n \"waterContent\": {\n \"value\": \"<string>\"\n }\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": "unknown",
"lastChangedAtUtc": "2023-11-07T05:31:56Z"
}{
"clientReference": "<string>",
"status": "unknown",
"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>"
}Nominations
Creates or updates a draft nomination
Creates a new draft nomination or updates an existing one based on the client reference. Uses idempotency to prevent duplicate submissions.
PUT
/
v1
/
nominations
/
drafts
Creates or updates a draft nomination
curl --request PUT \
--url https://api.demo.fuelboss.net/v1/nominations/drafts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"clientReference": "<string>",
"delivery": {
"operationStandardCode": "<string>",
"laycanStart": "2023-11-07T05:31:56Z",
"laycanEnd": "2023-11-07T05:31:56Z",
"bunkeringLocationCode": "<string>",
"portBunkeringLocationCode": "<string>",
"bunkeringLocationDetails": "<string>",
"berthTime": "2023-11-07T05:31:56Z",
"pilotTime": "2023-11-07T05:31:56Z",
"estimatedTimeOfBunkering": "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>",
"vesselIdentifier": {
"imo": 123,
"mmsi": 123,
"externalId": "<string>"
},
"vesselName": "<string>",
"estimatedTimeOfArrival": "2023-11-07T05:31:56Z",
"estimatedTimeOfDeparture": "2023-11-07T05:31:56Z",
"orderReference": "<string>",
"lastPortCode": "<string>",
"nextPortCode": "<string>",
"counterpartEntityReference": "<string>",
"companyEntityReference": "<string>"
},
"fuelSpecifications": [
{
"fuelType": "<string>",
"brand": "<string>",
"quantityRange": {
"minQuantity": 123,
"maxQuantity": 123
},
"certificateOfQuality": {
"identifier": "<string>",
"flashPoint": {
"value": "<string>"
},
"pourPoint": {
"value": 123
},
"viscosity": {
"value": 123
},
"sulphurContent": {
"value": "<string>"
},
"density": {
"value": 123
},
"waterContent": {
"value": "<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/drafts"
payload = {
"clientReference": "<string>",
"delivery": {
"operationStandardCode": "<string>",
"laycanStart": "2023-11-07T05:31:56Z",
"laycanEnd": "2023-11-07T05:31:56Z",
"bunkeringLocationCode": "<string>",
"portBunkeringLocationCode": "<string>",
"bunkeringLocationDetails": "<string>",
"berthTime": "2023-11-07T05:31:56Z",
"pilotTime": "2023-11-07T05:31:56Z",
"estimatedTimeOfBunkering": "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>",
"vesselIdentifier": {
"imo": 123,
"mmsi": 123,
"externalId": "<string>"
},
"vesselName": "<string>",
"estimatedTimeOfArrival": "2023-11-07T05:31:56Z",
"estimatedTimeOfDeparture": "2023-11-07T05:31:56Z",
"orderReference": "<string>",
"lastPortCode": "<string>",
"nextPortCode": "<string>",
"counterpartEntityReference": "<string>",
"companyEntityReference": "<string>"
},
"fuelSpecifications": [
{
"fuelType": "<string>",
"brand": "<string>",
"quantityRange": {
"minQuantity": 123,
"maxQuantity": 123
},
"certificateOfQuality": {
"identifier": "<string>",
"flashPoint": { "value": "<string>" },
"pourPoint": { "value": 123 },
"viscosity": { "value": 123 },
"sulphurContent": { "value": "<string>" },
"density": { "value": 123 },
"waterContent": { "value": "<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>',
laycanStart: '2023-11-07T05:31:56Z',
laycanEnd: '2023-11-07T05:31:56Z',
bunkeringLocationCode: '<string>',
portBunkeringLocationCode: '<string>',
bunkeringLocationDetails: '<string>',
berthTime: '2023-11-07T05:31:56Z',
pilotTime: '2023-11-07T05:31:56Z',
estimatedTimeOfBunkering: '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>',
vesselIdentifier: {imo: 123, mmsi: 123, externalId: '<string>'},
vesselName: '<string>',
estimatedTimeOfArrival: '2023-11-07T05:31:56Z',
estimatedTimeOfDeparture: '2023-11-07T05:31:56Z',
orderReference: '<string>',
lastPortCode: '<string>',
nextPortCode: '<string>',
counterpartEntityReference: '<string>',
companyEntityReference: '<string>'
},
fuelSpecifications: [
{
fuelType: '<string>',
brand: '<string>',
quantityRange: {minQuantity: 123, maxQuantity: 123},
certificateOfQuality: {
identifier: '<string>',
flashPoint: {value: '<string>'},
pourPoint: {value: 123},
viscosity: {value: 123},
sulphurContent: {value: '<string>'},
density: {value: 123},
waterContent: {value: '<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/drafts', 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/drafts",
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>',
'laycanStart' => '2023-11-07T05:31:56Z',
'laycanEnd' => '2023-11-07T05:31:56Z',
'bunkeringLocationCode' => '<string>',
'portBunkeringLocationCode' => '<string>',
'bunkeringLocationDetails' => '<string>',
'berthTime' => '2023-11-07T05:31:56Z',
'pilotTime' => '2023-11-07T05:31:56Z',
'estimatedTimeOfBunkering' => '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>',
'vesselIdentifier' => [
'imo' => 123,
'mmsi' => 123,
'externalId' => '<string>'
],
'vesselName' => '<string>',
'estimatedTimeOfArrival' => '2023-11-07T05:31:56Z',
'estimatedTimeOfDeparture' => '2023-11-07T05:31:56Z',
'orderReference' => '<string>',
'lastPortCode' => '<string>',
'nextPortCode' => '<string>',
'counterpartEntityReference' => '<string>',
'companyEntityReference' => '<string>'
],
'fuelSpecifications' => [
[
'fuelType' => '<string>',
'brand' => '<string>',
'quantityRange' => [
'minQuantity' => 123,
'maxQuantity' => 123
],
'certificateOfQuality' => [
'identifier' => '<string>',
'flashPoint' => [
'value' => '<string>'
],
'pourPoint' => [
'value' => 123
],
'viscosity' => [
'value' => 123
],
'sulphurContent' => [
'value' => '<string>'
],
'density' => [
'value' => 123
],
'waterContent' => [
'value' => '<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/drafts"
payload := strings.NewReader("{\n \"clientReference\": \"<string>\",\n \"delivery\": {\n \"operationStandardCode\": \"<string>\",\n \"laycanStart\": \"2023-11-07T05:31:56Z\",\n \"laycanEnd\": \"2023-11-07T05:31:56Z\",\n \"bunkeringLocationCode\": \"<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 \"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 \"vesselIdentifier\": {\n \"imo\": 123,\n \"mmsi\": 123,\n \"externalId\": \"<string>\"\n },\n \"vesselName\": \"<string>\",\n \"estimatedTimeOfArrival\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfDeparture\": \"2023-11-07T05:31:56Z\",\n \"orderReference\": \"<string>\",\n \"lastPortCode\": \"<string>\",\n \"nextPortCode\": \"<string>\",\n \"counterpartEntityReference\": \"<string>\",\n \"companyEntityReference\": \"<string>\"\n },\n \"fuelSpecifications\": [\n {\n \"fuelType\": \"<string>\",\n \"brand\": \"<string>\",\n \"quantityRange\": {\n \"minQuantity\": 123,\n \"maxQuantity\": 123\n },\n \"certificateOfQuality\": {\n \"identifier\": \"<string>\",\n \"flashPoint\": {\n \"value\": \"<string>\"\n },\n \"pourPoint\": {\n \"value\": 123\n },\n \"viscosity\": {\n \"value\": 123\n },\n \"sulphurContent\": {\n \"value\": \"<string>\"\n },\n \"density\": {\n \"value\": 123\n },\n \"waterContent\": {\n \"value\": \"<string>\"\n }\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/drafts")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"clientReference\": \"<string>\",\n \"delivery\": {\n \"operationStandardCode\": \"<string>\",\n \"laycanStart\": \"2023-11-07T05:31:56Z\",\n \"laycanEnd\": \"2023-11-07T05:31:56Z\",\n \"bunkeringLocationCode\": \"<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 \"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 \"vesselIdentifier\": {\n \"imo\": 123,\n \"mmsi\": 123,\n \"externalId\": \"<string>\"\n },\n \"vesselName\": \"<string>\",\n \"estimatedTimeOfArrival\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfDeparture\": \"2023-11-07T05:31:56Z\",\n \"orderReference\": \"<string>\",\n \"lastPortCode\": \"<string>\",\n \"nextPortCode\": \"<string>\",\n \"counterpartEntityReference\": \"<string>\",\n \"companyEntityReference\": \"<string>\"\n },\n \"fuelSpecifications\": [\n {\n \"fuelType\": \"<string>\",\n \"brand\": \"<string>\",\n \"quantityRange\": {\n \"minQuantity\": 123,\n \"maxQuantity\": 123\n },\n \"certificateOfQuality\": {\n \"identifier\": \"<string>\",\n \"flashPoint\": {\n \"value\": \"<string>\"\n },\n \"pourPoint\": {\n \"value\": 123\n },\n \"viscosity\": {\n \"value\": 123\n },\n \"sulphurContent\": {\n \"value\": \"<string>\"\n },\n \"density\": {\n \"value\": 123\n },\n \"waterContent\": {\n \"value\": \"<string>\"\n }\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/drafts")
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 \"laycanStart\": \"2023-11-07T05:31:56Z\",\n \"laycanEnd\": \"2023-11-07T05:31:56Z\",\n \"bunkeringLocationCode\": \"<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 \"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 \"vesselIdentifier\": {\n \"imo\": 123,\n \"mmsi\": 123,\n \"externalId\": \"<string>\"\n },\n \"vesselName\": \"<string>\",\n \"estimatedTimeOfArrival\": \"2023-11-07T05:31:56Z\",\n \"estimatedTimeOfDeparture\": \"2023-11-07T05:31:56Z\",\n \"orderReference\": \"<string>\",\n \"lastPortCode\": \"<string>\",\n \"nextPortCode\": \"<string>\",\n \"counterpartEntityReference\": \"<string>\",\n \"companyEntityReference\": \"<string>\"\n },\n \"fuelSpecifications\": [\n {\n \"fuelType\": \"<string>\",\n \"brand\": \"<string>\",\n \"quantityRange\": {\n \"minQuantity\": 123,\n \"maxQuantity\": 123\n },\n \"certificateOfQuality\": {\n \"identifier\": \"<string>\",\n \"flashPoint\": {\n \"value\": \"<string>\"\n },\n \"pourPoint\": {\n \"value\": 123\n },\n \"viscosity\": {\n \"value\": 123\n },\n \"sulphurContent\": {\n \"value\": \"<string>\"\n },\n \"density\": {\n \"value\": 123\n },\n \"waterContent\": {\n \"value\": \"<string>\"\n }\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": "unknown",
"lastChangedAtUtc": "2023-11-07T05:31:56Z"
}{
"clientReference": "<string>",
"status": "unknown",
"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>"
}Authorizations
Access token obtained from the /oauth/token endpoint using your client credentials.
Body
application/json
Request body for Create or Update Draft Nomination.
Your unique identifier for the draft within your company. Used to reference the draft in subsequent calls.
Delivery information.
Show child attributes
Show child attributes
Supplier information.
Show child attributes
Show child attributes
Receiver information.
Show child attributes
Show child attributes
Fuel specifications of the draft.
Show child attributes
Show child attributes
Stakeholders involved in the draft.
Show child attributes
Show child attributes
Response
OK
Response returned by Create or Update Draft Nomination.
Your unique identifier for the draft.
Status of the draft after the operation.
Possible values:
unknown— Status is unknown.in_progress— Draft is still being prepared.completed— Draft has been completed and is ready to be sent.
Available options:
unknown, in_progress, completed Timestamp (UTC) of the last change to the draft.
⌘I