Upsert order by external identifier with delivery window
curl --request POST \
--url https://api.sandbox.usenash.com/v1/order/external-identifier/{externalId}/delivery-window \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"externalId": "<string>",
"pickupAddress": "<string>",
"pickupPlaceId": "<string>",
"pickupPhoneNumber": "<string>",
"pickupBusinessName": "<string>",
"pickupFirstName": "<string>",
"pickupLastName": "<string>",
"pickupInstructions": "<string>",
"pickupStoreLocationId": "<string>",
"pickupExternalStoreLocationId": "<string>",
"pickupStoreLocationIds": [
"<string>"
],
"pickupZoneIds": [
"<string>"
],
"pickupBarcodes": [
"<string>"
],
"pickupEmail": "<string>",
"dropoffAddress": "<string>",
"dropoffPlaceId": "<string>",
"dropoffPhoneNumber": "<string>",
"dropoffBusinessName": "<string>",
"dropoffFirstName": "<string>",
"dropoffLastName": "<string>",
"dropoffInstructions": "<string>",
"dropoffBarcodes": [
"<string>"
],
"dropoffEmail": "<string>",
"deliveryMode": "<string>",
"pickupStartTime": "2023-11-07T05:31:56Z",
"pickupEndTime": "2023-11-07T05:31:56Z",
"dropoffStartTime": "2023-11-07T05:31:56Z",
"dropoffEndTime": "2023-11-07T05:31:56Z",
"deliveryWindowId": "<string>",
"description": "<string>",
"itemsCount": 123,
"currency": "<string>",
"valueCents": 123,
"tipAmountCents": 123,
"dueAmountCents": 10000,
"requirements": [
"photo_proof_of_delivery",
"age_verification_on_delivery"
],
"minimumVehicleSize": "car",
"dispatchStrategyId": "<string>",
"orderMetadata": {},
"tags": [
"<string>"
],
"referenceId": "<string>",
"pickupAddressNumber": "<string>",
"pickupAddressSecondarynumber": "<string>",
"pickupAddressFormattedStreet": "<string>",
"pickupAddressCity": "<string>",
"pickupAddressCounty": "<string>",
"pickupAddressState": "<string>",
"pickupAddressZip": "<string>",
"pickupAddressCountry": "<string>",
"pickupLat": 123,
"pickupLng": 123,
"dropoffAddressNumber": "<string>",
"dropoffAddressSecondarynumber": "<string>",
"dropoffAddressFormattedStreet": "<string>",
"dropoffAddressCity": "<string>",
"dropoffAddressCounty": "<string>",
"dropoffAddressState": "<string>",
"dropoffAddressZip": "<string>",
"dropoffAddressCountry": "<string>",
"dropoffLat": 123,
"dropoffLng": 123,
"weight": 123,
"weightUnit": "<string>",
"height": 123,
"width": 123,
"depth": 123,
"volume": 123,
"lengthUnit": "<string>",
"items": [
{
"id": "abc-123",
"description": "A box of books",
"count": 2,
"dimensions": {
"depth": 14,
"height": 10,
"width": 12
},
"weight": 1.5,
"valueCents": 1000,
"requirements": [
"age_verification_on_delivery"
],
"category": "<string>",
"barcode": "0199312650999998913643M221872801002010908",
"metadata": {
"packaging_type": "CTN"
},
"volume": 1200,
"subItems": [
{
"id": "abc-123",
"description": "A box of books",
"count": 2,
"dimensions": {
"depth": 14,
"height": 10,
"width": 12
},
"weight": 1.5,
"valueCents": 1000,
"requirements": [
"age_verification_on_delivery"
],
"category": "<string>",
"barcode": "0199312650999998913643M221872801002010908",
"metadata": {
"packaging_type": "CTN"
},
"sku": "<string>",
"substitution": {
"preference": "substitute",
"source": "<string>",
"substituteItems": [
{
"id": "<string>",
"sku": "<string>",
"quantity": 123
}
]
},
"subItems": "<unknown>"
}
]
}
],
"optimizationParameters": {
"pickupDoorstepTimeSeconds": 90,
"dropoffDoorstepTimeSeconds": 180,
"costsByMetric": {
"distance": 10,
"weight": 200
},
"clusterLabel": "<string>",
"mxLabel": "<string>",
"assignmentPriority": 1,
"sequencePriority": 249,
"sequenceGroup": "<string>",
"pickupOnly": true,
"alternativeDropoffTimeWindows": [
{
"start": "<string>",
"end": "<string>"
}
]
},
"pickupPayment": {
"barcode": {
"type": "CODE128",
"value": "1234567890"
},
"providerCard": true
},
"reapplyAutomations": true,
"maxDeliveryFeeCents": 123,
"requestedDeliveryWindowsStartTime": "2023-11-07T05:31:56Z",
"requestedDeliveryWindowsEndTime": "2023-11-07T05:31:56Z",
"deliveryWindowExpiresAt": "2023-11-07T05:31:56Z",
"deliveryWindowRequestedCapacity": 123
}
'import requests
url = "https://api.sandbox.usenash.com/v1/order/external-identifier/{externalId}/delivery-window"
payload = {
"externalId": "<string>",
"pickupAddress": "<string>",
"pickupPlaceId": "<string>",
"pickupPhoneNumber": "<string>",
"pickupBusinessName": "<string>",
"pickupFirstName": "<string>",
"pickupLastName": "<string>",
"pickupInstructions": "<string>",
"pickupStoreLocationId": "<string>",
"pickupExternalStoreLocationId": "<string>",
"pickupStoreLocationIds": ["<string>"],
"pickupZoneIds": ["<string>"],
"pickupBarcodes": ["<string>"],
"pickupEmail": "<string>",
"dropoffAddress": "<string>",
"dropoffPlaceId": "<string>",
"dropoffPhoneNumber": "<string>",
"dropoffBusinessName": "<string>",
"dropoffFirstName": "<string>",
"dropoffLastName": "<string>",
"dropoffInstructions": "<string>",
"dropoffBarcodes": ["<string>"],
"dropoffEmail": "<string>",
"deliveryMode": "<string>",
"pickupStartTime": "2023-11-07T05:31:56Z",
"pickupEndTime": "2023-11-07T05:31:56Z",
"dropoffStartTime": "2023-11-07T05:31:56Z",
"dropoffEndTime": "2023-11-07T05:31:56Z",
"deliveryWindowId": "<string>",
"description": "<string>",
"itemsCount": 123,
"currency": "<string>",
"valueCents": 123,
"tipAmountCents": 123,
"dueAmountCents": 10000,
"requirements": ["photo_proof_of_delivery", "age_verification_on_delivery"],
"minimumVehicleSize": "car",
"dispatchStrategyId": "<string>",
"orderMetadata": {},
"tags": ["<string>"],
"referenceId": "<string>",
"pickupAddressNumber": "<string>",
"pickupAddressSecondarynumber": "<string>",
"pickupAddressFormattedStreet": "<string>",
"pickupAddressCity": "<string>",
"pickupAddressCounty": "<string>",
"pickupAddressState": "<string>",
"pickupAddressZip": "<string>",
"pickupAddressCountry": "<string>",
"pickupLat": 123,
"pickupLng": 123,
"dropoffAddressNumber": "<string>",
"dropoffAddressSecondarynumber": "<string>",
"dropoffAddressFormattedStreet": "<string>",
"dropoffAddressCity": "<string>",
"dropoffAddressCounty": "<string>",
"dropoffAddressState": "<string>",
"dropoffAddressZip": "<string>",
"dropoffAddressCountry": "<string>",
"dropoffLat": 123,
"dropoffLng": 123,
"weight": 123,
"weightUnit": "<string>",
"height": 123,
"width": 123,
"depth": 123,
"volume": 123,
"lengthUnit": "<string>",
"items": [
{
"id": "abc-123",
"description": "A box of books",
"count": 2,
"dimensions": {
"depth": 14,
"height": 10,
"width": 12
},
"weight": 1.5,
"valueCents": 1000,
"requirements": ["age_verification_on_delivery"],
"category": "<string>",
"barcode": "0199312650999998913643M221872801002010908",
"metadata": { "packaging_type": "CTN" },
"volume": 1200,
"subItems": [
{
"id": "abc-123",
"description": "A box of books",
"count": 2,
"dimensions": {
"depth": 14,
"height": 10,
"width": 12
},
"weight": 1.5,
"valueCents": 1000,
"requirements": ["age_verification_on_delivery"],
"category": "<string>",
"barcode": "0199312650999998913643M221872801002010908",
"metadata": { "packaging_type": "CTN" },
"sku": "<string>",
"substitution": {
"preference": "substitute",
"source": "<string>",
"substituteItems": [
{
"id": "<string>",
"sku": "<string>",
"quantity": 123
}
]
},
"subItems": "<unknown>"
}
]
}
],
"optimizationParameters": {
"pickupDoorstepTimeSeconds": 90,
"dropoffDoorstepTimeSeconds": 180,
"costsByMetric": {
"distance": 10,
"weight": 200
},
"clusterLabel": "<string>",
"mxLabel": "<string>",
"assignmentPriority": 1,
"sequencePriority": 249,
"sequenceGroup": "<string>",
"pickupOnly": True,
"alternativeDropoffTimeWindows": [
{
"start": "<string>",
"end": "<string>"
}
]
},
"pickupPayment": {
"barcode": {
"type": "CODE128",
"value": "1234567890"
},
"providerCard": True
},
"reapplyAutomations": True,
"maxDeliveryFeeCents": 123,
"requestedDeliveryWindowsStartTime": "2023-11-07T05:31:56Z",
"requestedDeliveryWindowsEndTime": "2023-11-07T05:31:56Z",
"deliveryWindowExpiresAt": "2023-11-07T05:31:56Z",
"deliveryWindowRequestedCapacity": 123
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
externalId: '<string>',
pickupAddress: '<string>',
pickupPlaceId: '<string>',
pickupPhoneNumber: '<string>',
pickupBusinessName: '<string>',
pickupFirstName: '<string>',
pickupLastName: '<string>',
pickupInstructions: '<string>',
pickupStoreLocationId: '<string>',
pickupExternalStoreLocationId: '<string>',
pickupStoreLocationIds: ['<string>'],
pickupZoneIds: ['<string>'],
pickupBarcodes: ['<string>'],
pickupEmail: '<string>',
dropoffAddress: '<string>',
dropoffPlaceId: '<string>',
dropoffPhoneNumber: '<string>',
dropoffBusinessName: '<string>',
dropoffFirstName: '<string>',
dropoffLastName: '<string>',
dropoffInstructions: '<string>',
dropoffBarcodes: ['<string>'],
dropoffEmail: '<string>',
deliveryMode: '<string>',
pickupStartTime: '2023-11-07T05:31:56Z',
pickupEndTime: '2023-11-07T05:31:56Z',
dropoffStartTime: '2023-11-07T05:31:56Z',
dropoffEndTime: '2023-11-07T05:31:56Z',
deliveryWindowId: '<string>',
description: '<string>',
itemsCount: 123,
currency: '<string>',
valueCents: 123,
tipAmountCents: 123,
dueAmountCents: 10000,
requirements: ['photo_proof_of_delivery', 'age_verification_on_delivery'],
minimumVehicleSize: 'car',
dispatchStrategyId: '<string>',
orderMetadata: {},
tags: ['<string>'],
referenceId: '<string>',
pickupAddressNumber: '<string>',
pickupAddressSecondarynumber: '<string>',
pickupAddressFormattedStreet: '<string>',
pickupAddressCity: '<string>',
pickupAddressCounty: '<string>',
pickupAddressState: '<string>',
pickupAddressZip: '<string>',
pickupAddressCountry: '<string>',
pickupLat: 123,
pickupLng: 123,
dropoffAddressNumber: '<string>',
dropoffAddressSecondarynumber: '<string>',
dropoffAddressFormattedStreet: '<string>',
dropoffAddressCity: '<string>',
dropoffAddressCounty: '<string>',
dropoffAddressState: '<string>',
dropoffAddressZip: '<string>',
dropoffAddressCountry: '<string>',
dropoffLat: 123,
dropoffLng: 123,
weight: 123,
weightUnit: '<string>',
height: 123,
width: 123,
depth: 123,
volume: 123,
lengthUnit: '<string>',
items: [
{
id: 'abc-123',
description: 'A box of books',
count: 2,
dimensions: {depth: 14, height: 10, width: 12},
weight: 1.5,
valueCents: 1000,
requirements: ['age_verification_on_delivery'],
category: '<string>',
barcode: '0199312650999998913643M221872801002010908',
metadata: {packaging_type: 'CTN'},
volume: 1200,
subItems: [
{
id: 'abc-123',
description: 'A box of books',
count: 2,
dimensions: {depth: 14, height: 10, width: 12},
weight: 1.5,
valueCents: 1000,
requirements: ['age_verification_on_delivery'],
category: '<string>',
barcode: '0199312650999998913643M221872801002010908',
metadata: {packaging_type: 'CTN'},
sku: '<string>',
substitution: {
preference: 'substitute',
source: '<string>',
substituteItems: [{id: '<string>', sku: '<string>', quantity: 123}]
},
subItems: '<unknown>'
}
]
}
],
optimizationParameters: {
pickupDoorstepTimeSeconds: 90,
dropoffDoorstepTimeSeconds: 180,
costsByMetric: {distance: 10, weight: 200},
clusterLabel: '<string>',
mxLabel: '<string>',
assignmentPriority: 1,
sequencePriority: 249,
sequenceGroup: '<string>',
pickupOnly: true,
alternativeDropoffTimeWindows: [{start: '<string>', end: '<string>'}]
},
pickupPayment: {barcode: {type: 'CODE128', value: '1234567890'}, providerCard: true},
reapplyAutomations: true,
maxDeliveryFeeCents: 123,
requestedDeliveryWindowsStartTime: '2023-11-07T05:31:56Z',
requestedDeliveryWindowsEndTime: '2023-11-07T05:31:56Z',
deliveryWindowExpiresAt: '2023-11-07T05:31:56Z',
deliveryWindowRequestedCapacity: 123
})
};
fetch('https://api.sandbox.usenash.com/v1/order/external-identifier/{externalId}/delivery-window', 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.sandbox.usenash.com/v1/order/external-identifier/{externalId}/delivery-window",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'externalId' => '<string>',
'pickupAddress' => '<string>',
'pickupPlaceId' => '<string>',
'pickupPhoneNumber' => '<string>',
'pickupBusinessName' => '<string>',
'pickupFirstName' => '<string>',
'pickupLastName' => '<string>',
'pickupInstructions' => '<string>',
'pickupStoreLocationId' => '<string>',
'pickupExternalStoreLocationId' => '<string>',
'pickupStoreLocationIds' => [
'<string>'
],
'pickupZoneIds' => [
'<string>'
],
'pickupBarcodes' => [
'<string>'
],
'pickupEmail' => '<string>',
'dropoffAddress' => '<string>',
'dropoffPlaceId' => '<string>',
'dropoffPhoneNumber' => '<string>',
'dropoffBusinessName' => '<string>',
'dropoffFirstName' => '<string>',
'dropoffLastName' => '<string>',
'dropoffInstructions' => '<string>',
'dropoffBarcodes' => [
'<string>'
],
'dropoffEmail' => '<string>',
'deliveryMode' => '<string>',
'pickupStartTime' => '2023-11-07T05:31:56Z',
'pickupEndTime' => '2023-11-07T05:31:56Z',
'dropoffStartTime' => '2023-11-07T05:31:56Z',
'dropoffEndTime' => '2023-11-07T05:31:56Z',
'deliveryWindowId' => '<string>',
'description' => '<string>',
'itemsCount' => 123,
'currency' => '<string>',
'valueCents' => 123,
'tipAmountCents' => 123,
'dueAmountCents' => 10000,
'requirements' => [
'photo_proof_of_delivery',
'age_verification_on_delivery'
],
'minimumVehicleSize' => 'car',
'dispatchStrategyId' => '<string>',
'orderMetadata' => [
],
'tags' => [
'<string>'
],
'referenceId' => '<string>',
'pickupAddressNumber' => '<string>',
'pickupAddressSecondarynumber' => '<string>',
'pickupAddressFormattedStreet' => '<string>',
'pickupAddressCity' => '<string>',
'pickupAddressCounty' => '<string>',
'pickupAddressState' => '<string>',
'pickupAddressZip' => '<string>',
'pickupAddressCountry' => '<string>',
'pickupLat' => 123,
'pickupLng' => 123,
'dropoffAddressNumber' => '<string>',
'dropoffAddressSecondarynumber' => '<string>',
'dropoffAddressFormattedStreet' => '<string>',
'dropoffAddressCity' => '<string>',
'dropoffAddressCounty' => '<string>',
'dropoffAddressState' => '<string>',
'dropoffAddressZip' => '<string>',
'dropoffAddressCountry' => '<string>',
'dropoffLat' => 123,
'dropoffLng' => 123,
'weight' => 123,
'weightUnit' => '<string>',
'height' => 123,
'width' => 123,
'depth' => 123,
'volume' => 123,
'lengthUnit' => '<string>',
'items' => [
[
'id' => 'abc-123',
'description' => 'A box of books',
'count' => 2,
'dimensions' => [
'depth' => 14,
'height' => 10,
'width' => 12
],
'weight' => 1.5,
'valueCents' => 1000,
'requirements' => [
'age_verification_on_delivery'
],
'category' => '<string>',
'barcode' => '0199312650999998913643M221872801002010908',
'metadata' => [
'packaging_type' => 'CTN'
],
'volume' => 1200,
'subItems' => [
[
'id' => 'abc-123',
'description' => 'A box of books',
'count' => 2,
'dimensions' => [
'depth' => 14,
'height' => 10,
'width' => 12
],
'weight' => 1.5,
'valueCents' => 1000,
'requirements' => [
'age_verification_on_delivery'
],
'category' => '<string>',
'barcode' => '0199312650999998913643M221872801002010908',
'metadata' => [
'packaging_type' => 'CTN'
],
'sku' => '<string>',
'substitution' => [
'preference' => 'substitute',
'source' => '<string>',
'substituteItems' => [
[
'id' => '<string>',
'sku' => '<string>',
'quantity' => 123
]
]
],
'subItems' => '<unknown>'
]
]
]
],
'optimizationParameters' => [
'pickupDoorstepTimeSeconds' => 90,
'dropoffDoorstepTimeSeconds' => 180,
'costsByMetric' => [
'distance' => 10,
'weight' => 200
],
'clusterLabel' => '<string>',
'mxLabel' => '<string>',
'assignmentPriority' => 1,
'sequencePriority' => 249,
'sequenceGroup' => '<string>',
'pickupOnly' => true,
'alternativeDropoffTimeWindows' => [
[
'start' => '<string>',
'end' => '<string>'
]
]
],
'pickupPayment' => [
'barcode' => [
'type' => 'CODE128',
'value' => '1234567890'
],
'providerCard' => true
],
'reapplyAutomations' => true,
'maxDeliveryFeeCents' => 123,
'requestedDeliveryWindowsStartTime' => '2023-11-07T05:31:56Z',
'requestedDeliveryWindowsEndTime' => '2023-11-07T05:31:56Z',
'deliveryWindowExpiresAt' => '2023-11-07T05:31:56Z',
'deliveryWindowRequestedCapacity' => 123
]),
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.sandbox.usenash.com/v1/order/external-identifier/{externalId}/delivery-window"
payload := strings.NewReader("{\n \"externalId\": \"<string>\",\n \"pickupAddress\": \"<string>\",\n \"pickupPlaceId\": \"<string>\",\n \"pickupPhoneNumber\": \"<string>\",\n \"pickupBusinessName\": \"<string>\",\n \"pickupFirstName\": \"<string>\",\n \"pickupLastName\": \"<string>\",\n \"pickupInstructions\": \"<string>\",\n \"pickupStoreLocationId\": \"<string>\",\n \"pickupExternalStoreLocationId\": \"<string>\",\n \"pickupStoreLocationIds\": [\n \"<string>\"\n ],\n \"pickupZoneIds\": [\n \"<string>\"\n ],\n \"pickupBarcodes\": [\n \"<string>\"\n ],\n \"pickupEmail\": \"<string>\",\n \"dropoffAddress\": \"<string>\",\n \"dropoffPlaceId\": \"<string>\",\n \"dropoffPhoneNumber\": \"<string>\",\n \"dropoffBusinessName\": \"<string>\",\n \"dropoffFirstName\": \"<string>\",\n \"dropoffLastName\": \"<string>\",\n \"dropoffInstructions\": \"<string>\",\n \"dropoffBarcodes\": [\n \"<string>\"\n ],\n \"dropoffEmail\": \"<string>\",\n \"deliveryMode\": \"<string>\",\n \"pickupStartTime\": \"2023-11-07T05:31:56Z\",\n \"pickupEndTime\": \"2023-11-07T05:31:56Z\",\n \"dropoffStartTime\": \"2023-11-07T05:31:56Z\",\n \"dropoffEndTime\": \"2023-11-07T05:31:56Z\",\n \"deliveryWindowId\": \"<string>\",\n \"description\": \"<string>\",\n \"itemsCount\": 123,\n \"currency\": \"<string>\",\n \"valueCents\": 123,\n \"tipAmountCents\": 123,\n \"dueAmountCents\": 10000,\n \"requirements\": [\n \"photo_proof_of_delivery\",\n \"age_verification_on_delivery\"\n ],\n \"minimumVehicleSize\": \"car\",\n \"dispatchStrategyId\": \"<string>\",\n \"orderMetadata\": {},\n \"tags\": [\n \"<string>\"\n ],\n \"referenceId\": \"<string>\",\n \"pickupAddressNumber\": \"<string>\",\n \"pickupAddressSecondarynumber\": \"<string>\",\n \"pickupAddressFormattedStreet\": \"<string>\",\n \"pickupAddressCity\": \"<string>\",\n \"pickupAddressCounty\": \"<string>\",\n \"pickupAddressState\": \"<string>\",\n \"pickupAddressZip\": \"<string>\",\n \"pickupAddressCountry\": \"<string>\",\n \"pickupLat\": 123,\n \"pickupLng\": 123,\n \"dropoffAddressNumber\": \"<string>\",\n \"dropoffAddressSecondarynumber\": \"<string>\",\n \"dropoffAddressFormattedStreet\": \"<string>\",\n \"dropoffAddressCity\": \"<string>\",\n \"dropoffAddressCounty\": \"<string>\",\n \"dropoffAddressState\": \"<string>\",\n \"dropoffAddressZip\": \"<string>\",\n \"dropoffAddressCountry\": \"<string>\",\n \"dropoffLat\": 123,\n \"dropoffLng\": 123,\n \"weight\": 123,\n \"weightUnit\": \"<string>\",\n \"height\": 123,\n \"width\": 123,\n \"depth\": 123,\n \"volume\": 123,\n \"lengthUnit\": \"<string>\",\n \"items\": [\n {\n \"id\": \"abc-123\",\n \"description\": \"A box of books\",\n \"count\": 2,\n \"dimensions\": {\n \"depth\": 14,\n \"height\": 10,\n \"width\": 12\n },\n \"weight\": 1.5,\n \"valueCents\": 1000,\n \"requirements\": [\n \"age_verification_on_delivery\"\n ],\n \"category\": \"<string>\",\n \"barcode\": \"0199312650999998913643M221872801002010908\",\n \"metadata\": {\n \"packaging_type\": \"CTN\"\n },\n \"volume\": 1200,\n \"subItems\": [\n {\n \"id\": \"abc-123\",\n \"description\": \"A box of books\",\n \"count\": 2,\n \"dimensions\": {\n \"depth\": 14,\n \"height\": 10,\n \"width\": 12\n },\n \"weight\": 1.5,\n \"valueCents\": 1000,\n \"requirements\": [\n \"age_verification_on_delivery\"\n ],\n \"category\": \"<string>\",\n \"barcode\": \"0199312650999998913643M221872801002010908\",\n \"metadata\": {\n \"packaging_type\": \"CTN\"\n },\n \"sku\": \"<string>\",\n \"substitution\": {\n \"preference\": \"substitute\",\n \"source\": \"<string>\",\n \"substituteItems\": [\n {\n \"id\": \"<string>\",\n \"sku\": \"<string>\",\n \"quantity\": 123\n }\n ]\n },\n \"subItems\": \"<unknown>\"\n }\n ]\n }\n ],\n \"optimizationParameters\": {\n \"pickupDoorstepTimeSeconds\": 90,\n \"dropoffDoorstepTimeSeconds\": 180,\n \"costsByMetric\": {\n \"distance\": 10,\n \"weight\": 200\n },\n \"clusterLabel\": \"<string>\",\n \"mxLabel\": \"<string>\",\n \"assignmentPriority\": 1,\n \"sequencePriority\": 249,\n \"sequenceGroup\": \"<string>\",\n \"pickupOnly\": true,\n \"alternativeDropoffTimeWindows\": [\n {\n \"start\": \"<string>\",\n \"end\": \"<string>\"\n }\n ]\n },\n \"pickupPayment\": {\n \"barcode\": {\n \"type\": \"CODE128\",\n \"value\": \"1234567890\"\n },\n \"providerCard\": true\n },\n \"reapplyAutomations\": true,\n \"maxDeliveryFeeCents\": 123,\n \"requestedDeliveryWindowsStartTime\": \"2023-11-07T05:31:56Z\",\n \"requestedDeliveryWindowsEndTime\": \"2023-11-07T05:31:56Z\",\n \"deliveryWindowExpiresAt\": \"2023-11-07T05:31:56Z\",\n \"deliveryWindowRequestedCapacity\": 123\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.sandbox.usenash.com/v1/order/external-identifier/{externalId}/delivery-window")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"externalId\": \"<string>\",\n \"pickupAddress\": \"<string>\",\n \"pickupPlaceId\": \"<string>\",\n \"pickupPhoneNumber\": \"<string>\",\n \"pickupBusinessName\": \"<string>\",\n \"pickupFirstName\": \"<string>\",\n \"pickupLastName\": \"<string>\",\n \"pickupInstructions\": \"<string>\",\n \"pickupStoreLocationId\": \"<string>\",\n \"pickupExternalStoreLocationId\": \"<string>\",\n \"pickupStoreLocationIds\": [\n \"<string>\"\n ],\n \"pickupZoneIds\": [\n \"<string>\"\n ],\n \"pickupBarcodes\": [\n \"<string>\"\n ],\n \"pickupEmail\": \"<string>\",\n \"dropoffAddress\": \"<string>\",\n \"dropoffPlaceId\": \"<string>\",\n \"dropoffPhoneNumber\": \"<string>\",\n \"dropoffBusinessName\": \"<string>\",\n \"dropoffFirstName\": \"<string>\",\n \"dropoffLastName\": \"<string>\",\n \"dropoffInstructions\": \"<string>\",\n \"dropoffBarcodes\": [\n \"<string>\"\n ],\n \"dropoffEmail\": \"<string>\",\n \"deliveryMode\": \"<string>\",\n \"pickupStartTime\": \"2023-11-07T05:31:56Z\",\n \"pickupEndTime\": \"2023-11-07T05:31:56Z\",\n \"dropoffStartTime\": \"2023-11-07T05:31:56Z\",\n \"dropoffEndTime\": \"2023-11-07T05:31:56Z\",\n \"deliveryWindowId\": \"<string>\",\n \"description\": \"<string>\",\n \"itemsCount\": 123,\n \"currency\": \"<string>\",\n \"valueCents\": 123,\n \"tipAmountCents\": 123,\n \"dueAmountCents\": 10000,\n \"requirements\": [\n \"photo_proof_of_delivery\",\n \"age_verification_on_delivery\"\n ],\n \"minimumVehicleSize\": \"car\",\n \"dispatchStrategyId\": \"<string>\",\n \"orderMetadata\": {},\n \"tags\": [\n \"<string>\"\n ],\n \"referenceId\": \"<string>\",\n \"pickupAddressNumber\": \"<string>\",\n \"pickupAddressSecondarynumber\": \"<string>\",\n \"pickupAddressFormattedStreet\": \"<string>\",\n \"pickupAddressCity\": \"<string>\",\n \"pickupAddressCounty\": \"<string>\",\n \"pickupAddressState\": \"<string>\",\n \"pickupAddressZip\": \"<string>\",\n \"pickupAddressCountry\": \"<string>\",\n \"pickupLat\": 123,\n \"pickupLng\": 123,\n \"dropoffAddressNumber\": \"<string>\",\n \"dropoffAddressSecondarynumber\": \"<string>\",\n \"dropoffAddressFormattedStreet\": \"<string>\",\n \"dropoffAddressCity\": \"<string>\",\n \"dropoffAddressCounty\": \"<string>\",\n \"dropoffAddressState\": \"<string>\",\n \"dropoffAddressZip\": \"<string>\",\n \"dropoffAddressCountry\": \"<string>\",\n \"dropoffLat\": 123,\n \"dropoffLng\": 123,\n \"weight\": 123,\n \"weightUnit\": \"<string>\",\n \"height\": 123,\n \"width\": 123,\n \"depth\": 123,\n \"volume\": 123,\n \"lengthUnit\": \"<string>\",\n \"items\": [\n {\n \"id\": \"abc-123\",\n \"description\": \"A box of books\",\n \"count\": 2,\n \"dimensions\": {\n \"depth\": 14,\n \"height\": 10,\n \"width\": 12\n },\n \"weight\": 1.5,\n \"valueCents\": 1000,\n \"requirements\": [\n \"age_verification_on_delivery\"\n ],\n \"category\": \"<string>\",\n \"barcode\": \"0199312650999998913643M221872801002010908\",\n \"metadata\": {\n \"packaging_type\": \"CTN\"\n },\n \"volume\": 1200,\n \"subItems\": [\n {\n \"id\": \"abc-123\",\n \"description\": \"A box of books\",\n \"count\": 2,\n \"dimensions\": {\n \"depth\": 14,\n \"height\": 10,\n \"width\": 12\n },\n \"weight\": 1.5,\n \"valueCents\": 1000,\n \"requirements\": [\n \"age_verification_on_delivery\"\n ],\n \"category\": \"<string>\",\n \"barcode\": \"0199312650999998913643M221872801002010908\",\n \"metadata\": {\n \"packaging_type\": \"CTN\"\n },\n \"sku\": \"<string>\",\n \"substitution\": {\n \"preference\": \"substitute\",\n \"source\": \"<string>\",\n \"substituteItems\": [\n {\n \"id\": \"<string>\",\n \"sku\": \"<string>\",\n \"quantity\": 123\n }\n ]\n },\n \"subItems\": \"<unknown>\"\n }\n ]\n }\n ],\n \"optimizationParameters\": {\n \"pickupDoorstepTimeSeconds\": 90,\n \"dropoffDoorstepTimeSeconds\": 180,\n \"costsByMetric\": {\n \"distance\": 10,\n \"weight\": 200\n },\n \"clusterLabel\": \"<string>\",\n \"mxLabel\": \"<string>\",\n \"assignmentPriority\": 1,\n \"sequencePriority\": 249,\n \"sequenceGroup\": \"<string>\",\n \"pickupOnly\": true,\n \"alternativeDropoffTimeWindows\": [\n {\n \"start\": \"<string>\",\n \"end\": \"<string>\"\n }\n ]\n },\n \"pickupPayment\": {\n \"barcode\": {\n \"type\": \"CODE128\",\n \"value\": \"1234567890\"\n },\n \"providerCard\": true\n },\n \"reapplyAutomations\": true,\n \"maxDeliveryFeeCents\": 123,\n \"requestedDeliveryWindowsStartTime\": \"2023-11-07T05:31:56Z\",\n \"requestedDeliveryWindowsEndTime\": \"2023-11-07T05:31:56Z\",\n \"deliveryWindowExpiresAt\": \"2023-11-07T05:31:56Z\",\n \"deliveryWindowRequestedCapacity\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.usenash.com/v1/order/external-identifier/{externalId}/delivery-window")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"externalId\": \"<string>\",\n \"pickupAddress\": \"<string>\",\n \"pickupPlaceId\": \"<string>\",\n \"pickupPhoneNumber\": \"<string>\",\n \"pickupBusinessName\": \"<string>\",\n \"pickupFirstName\": \"<string>\",\n \"pickupLastName\": \"<string>\",\n \"pickupInstructions\": \"<string>\",\n \"pickupStoreLocationId\": \"<string>\",\n \"pickupExternalStoreLocationId\": \"<string>\",\n \"pickupStoreLocationIds\": [\n \"<string>\"\n ],\n \"pickupZoneIds\": [\n \"<string>\"\n ],\n \"pickupBarcodes\": [\n \"<string>\"\n ],\n \"pickupEmail\": \"<string>\",\n \"dropoffAddress\": \"<string>\",\n \"dropoffPlaceId\": \"<string>\",\n \"dropoffPhoneNumber\": \"<string>\",\n \"dropoffBusinessName\": \"<string>\",\n \"dropoffFirstName\": \"<string>\",\n \"dropoffLastName\": \"<string>\",\n \"dropoffInstructions\": \"<string>\",\n \"dropoffBarcodes\": [\n \"<string>\"\n ],\n \"dropoffEmail\": \"<string>\",\n \"deliveryMode\": \"<string>\",\n \"pickupStartTime\": \"2023-11-07T05:31:56Z\",\n \"pickupEndTime\": \"2023-11-07T05:31:56Z\",\n \"dropoffStartTime\": \"2023-11-07T05:31:56Z\",\n \"dropoffEndTime\": \"2023-11-07T05:31:56Z\",\n \"deliveryWindowId\": \"<string>\",\n \"description\": \"<string>\",\n \"itemsCount\": 123,\n \"currency\": \"<string>\",\n \"valueCents\": 123,\n \"tipAmountCents\": 123,\n \"dueAmountCents\": 10000,\n \"requirements\": [\n \"photo_proof_of_delivery\",\n \"age_verification_on_delivery\"\n ],\n \"minimumVehicleSize\": \"car\",\n \"dispatchStrategyId\": \"<string>\",\n \"orderMetadata\": {},\n \"tags\": [\n \"<string>\"\n ],\n \"referenceId\": \"<string>\",\n \"pickupAddressNumber\": \"<string>\",\n \"pickupAddressSecondarynumber\": \"<string>\",\n \"pickupAddressFormattedStreet\": \"<string>\",\n \"pickupAddressCity\": \"<string>\",\n \"pickupAddressCounty\": \"<string>\",\n \"pickupAddressState\": \"<string>\",\n \"pickupAddressZip\": \"<string>\",\n \"pickupAddressCountry\": \"<string>\",\n \"pickupLat\": 123,\n \"pickupLng\": 123,\n \"dropoffAddressNumber\": \"<string>\",\n \"dropoffAddressSecondarynumber\": \"<string>\",\n \"dropoffAddressFormattedStreet\": \"<string>\",\n \"dropoffAddressCity\": \"<string>\",\n \"dropoffAddressCounty\": \"<string>\",\n \"dropoffAddressState\": \"<string>\",\n \"dropoffAddressZip\": \"<string>\",\n \"dropoffAddressCountry\": \"<string>\",\n \"dropoffLat\": 123,\n \"dropoffLng\": 123,\n \"weight\": 123,\n \"weightUnit\": \"<string>\",\n \"height\": 123,\n \"width\": 123,\n \"depth\": 123,\n \"volume\": 123,\n \"lengthUnit\": \"<string>\",\n \"items\": [\n {\n \"id\": \"abc-123\",\n \"description\": \"A box of books\",\n \"count\": 2,\n \"dimensions\": {\n \"depth\": 14,\n \"height\": 10,\n \"width\": 12\n },\n \"weight\": 1.5,\n \"valueCents\": 1000,\n \"requirements\": [\n \"age_verification_on_delivery\"\n ],\n \"category\": \"<string>\",\n \"barcode\": \"0199312650999998913643M221872801002010908\",\n \"metadata\": {\n \"packaging_type\": \"CTN\"\n },\n \"volume\": 1200,\n \"subItems\": [\n {\n \"id\": \"abc-123\",\n \"description\": \"A box of books\",\n \"count\": 2,\n \"dimensions\": {\n \"depth\": 14,\n \"height\": 10,\n \"width\": 12\n },\n \"weight\": 1.5,\n \"valueCents\": 1000,\n \"requirements\": [\n \"age_verification_on_delivery\"\n ],\n \"category\": \"<string>\",\n \"barcode\": \"0199312650999998913643M221872801002010908\",\n \"metadata\": {\n \"packaging_type\": \"CTN\"\n },\n \"sku\": \"<string>\",\n \"substitution\": {\n \"preference\": \"substitute\",\n \"source\": \"<string>\",\n \"substituteItems\": [\n {\n \"id\": \"<string>\",\n \"sku\": \"<string>\",\n \"quantity\": 123\n }\n ]\n },\n \"subItems\": \"<unknown>\"\n }\n ]\n }\n ],\n \"optimizationParameters\": {\n \"pickupDoorstepTimeSeconds\": 90,\n \"dropoffDoorstepTimeSeconds\": 180,\n \"costsByMetric\": {\n \"distance\": 10,\n \"weight\": 200\n },\n \"clusterLabel\": \"<string>\",\n \"mxLabel\": \"<string>\",\n \"assignmentPriority\": 1,\n \"sequencePriority\": 249,\n \"sequenceGroup\": \"<string>\",\n \"pickupOnly\": true,\n \"alternativeDropoffTimeWindows\": [\n {\n \"start\": \"<string>\",\n \"end\": \"<string>\"\n }\n ]\n },\n \"pickupPayment\": {\n \"barcode\": {\n \"type\": \"CODE128\",\n \"value\": \"1234567890\"\n },\n \"providerCard\": true\n },\n \"reapplyAutomations\": true,\n \"maxDeliveryFeeCents\": 123,\n \"requestedDeliveryWindowsStartTime\": \"2023-11-07T05:31:56Z\",\n \"requestedDeliveryWindowsEndTime\": \"2023-11-07T05:31:56Z\",\n \"deliveryWindowExpiresAt\": \"2023-11-07T05:31:56Z\",\n \"deliveryWindowRequestedCapacity\": 123\n}"
response = http.request(request)
puts response.read_body{
"id": "ord_1234567890",
"createdAt": "2023-08-29T19:17:46.264523",
"portalUrl": "https://portal.dev.usenash.com/orders/ord_1234567890",
"publicTrackingUrl": "https://tracking.dev.usenash.com/ord_1234567890",
"status": "needs_attention",
"tags": [
"REST_API"
],
"externalId": "1234567890",
"externalGroupId": "1234567890",
"referenceId": "1234567890",
"orderMetadata": {
"key": "value"
},
"pickupAddress": "185 University Ave, Palo Alto, CA 94301",
"pickupPlaceId": "ChIJd8BlQJq3t4kRUKhH43CQ",
"pickupAddressNumber": "185",
"pickupAddressSecondarynumber": "<string>",
"pickupAddressFormattedStreet": "University Ave",
"pickupAddressCity": "Palo Alto",
"pickupAddressCounty": "Santa Clara",
"pickupAddressState": "CA",
"pickupAddressZip": "94301",
"pickupAddressCountry": "US",
"pickupLat": 37.422222,
"pickupLng": -122.139776,
"pickupPhoneNumber": "+15555555555",
"pickupEmail": "store@example.com",
"pickupFirstName": "Manager",
"pickupLastName": "Manager",
"pickupBusinessName": "Store ABC",
"pickupInstructions": "Leave at the front door",
"pickupStoreLocationId": "stl_VwpoPJaaqWiPGnXEhWfX",
"pickupExternalStoreLocationId": "0021112",
"pickupZoneIds": [
"<string>"
],
"pickupBarcodes": [
"1234567890",
"0987654321"
],
"pickupPayment": {
"barcode": {
"type": "CODE128",
"value": "1234567890"
},
"providerCard": false
},
"dropoffAddress": "401 San Antonio Rd, Mountain View, CA 94040",
"dropoffPlaceId": "ChIJd8BlQJq3t4kRUKhH43CQ",
"dropoffAddressNumber": "401",
"dropoffAddressSecondarynumber": "<string>",
"dropoffAddressFormattedStreet": "San Antonio Rd",
"dropoffAddressCity": "Mountain View",
"dropoffAddressCounty": "Santa Clara",
"dropoffAddressState": "CA",
"dropoffAddressZip": "94040",
"dropoffAddressCountry": "US",
"dropoffLat": 37.422222,
"dropoffLng": -122.139776,
"dropoffPhoneNumber": "+15555555556",
"dropoffEmail": "customer@example.com",
"dropoffFirstName": "Quote",
"dropoffLastName": "Request",
"dropoffBusinessName": "<string>",
"dropoffInstructions": "Leave at the front door",
"dropoffStoreLocationId": "<string>",
"dropoffBarcodes": [
"<string>"
],
"deliveryMode": "scheduled",
"pickupStartTime": "2024-08-22T23:54:08Z",
"pickupEndTime": "2024-08-22T23:54:08Z",
"dropoffStartTime": "2024-08-22T23:54:08Z",
"dropoffEndTime": "2024-08-22T23:54:08Z",
"description": "Order description",
"itemsCount": "1",
"requirements": [
"photo_proof_of_delivery"
],
"minimumVehicleSize": "car",
"currency": "USD",
"valueCents": "10000",
"tipAmountCents": "1000",
"dueAmountCents": "10000",
"width": "100",
"depth": "100",
"height": "100",
"volume": "<string>",
"weight": "100",
"items": [
{
"id": "abc-123",
"description": "A box of books",
"count": 2,
"dimensions": {
"depth": 14,
"height": 10,
"width": 12
},
"weight": 1.5,
"valueCents": 1000,
"requirements": [
"age_verification_on_delivery"
],
"category": "<string>",
"barcode": "0199312650999998913643M221872801002010908",
"metadata": {
"packaging_type": "CTN"
},
"volume": 1200,
"subItems": [
{
"id": "abc-123",
"description": "A box of books",
"count": 2,
"dimensions": {
"depth": 14,
"height": 10,
"width": 12
},
"weight": 1.5,
"valueCents": 1000,
"requirements": [
"age_verification_on_delivery"
],
"category": "<string>",
"barcode": "0199312650999998913643M221872801002010908",
"metadata": {
"packaging_type": "CTN"
},
"sku": "<string>",
"substitution": {
"preference": "substitute",
"source": "<string>",
"substituteItems": [
{
"id": "<string>",
"sku": "<string>",
"quantity": 123
}
]
},
"subItems": "<unknown>"
}
]
}
],
"dispatchStrategyId": "dss_1234567890",
"maxDeliveryFeeCents": "1000",
"documents": [
{
"contentType": "application/pdf",
"data": "SGVsbG8gd29ybGQ=",
"id": "doc_1234567890",
"type": "shipping_label",
"url": "https://example.com/document.pdf"
}
],
"validationErrors": {
"pickupStartTime": "Time is in the past"
},
"quotes": [
{
"costSplitBusinessCents": null,
"costSplitCustomerCents": null,
"createdTime": "2024-09-03T20:43:45.899094",
"currency": "USD",
"dropoffEta": "2024-09-03T22:20:47.569000",
"expireTime": "2024-09-03T21:43:45.899102",
"id": "qot_2oWASjGxMtucwGgu6A7BYC",
"insuranceFeeCents": 0,
"nashFeeCents": 300,
"pickupWindow": null,
"priceCents": 100,
"providerId": "dispatch_partner",
"providerIsInternal": false,
"providerLogo": "https://nash-provider-logos.s3.amazonaws.com/dispatchit-logo.jpg",
"providerName": "Dispatch",
"tags": null,
"taxAmountCents": null,
"tollFeeCents": 0,
"totalPriceBreakdown": {
"priceCents": 100
},
"totalPriceCents": 100,
"type": "LOCAL"
}
],
"failedQuotes": [
"quote_1234567890",
"quote_0987654321"
],
"quoteFailure": {},
"deliveryWindowId": "<string>",
"deliveryWindowStatus": "<string>",
"deliveryWindowExpiresAt": "2023-11-07T05:31:56Z",
"deliveryWindowRequestedCapacity": "<string>",
"eligibleDeliveryWindows": [
{
"id": "<string>",
"ineligibleReason": "Ineligible due to order tags",
"allowedTags": "['rapid', 'oversize']",
"startTime": "2024-10-06T00:00:00.000000",
"startTimeLocal": "2024-10-06T00:00:00.000000",
"endTime": "2024-10-07T00:00:00.000000",
"endTimeLocal": "2024-10-07T00:00:00.000000",
"name": "S21",
"storeLocationId": "stl_1234567890",
"storeLocationExternalId": "1001",
"zoneId": "zone_1234567890",
"zoneExternalId": "1001",
"cutoffTime": "2024-10-04T00:00:00.000000",
"cutoffTimeLocal": "2024-10-04T00:00:00.000000",
"remainingCapacity": 10,
"maximumCapacity": 10,
"minimumOrderValueCents": 1000,
"timezoneId": "America/New_York",
"priceCents": 1000,
"score": 1,
"windowMetadata": {
"key": "value"
}
}
],
"ineligibleDeliveryWindows": [
{
"id": "<string>",
"ineligibleReason": "Ineligible due to order tags",
"allowedTags": "['rapid', 'oversize']",
"startTime": "2024-10-06T00:00:00.000000",
"startTimeLocal": "2024-10-06T00:00:00.000000",
"endTime": "2024-10-07T00:00:00.000000",
"endTimeLocal": "2024-10-07T00:00:00.000000",
"name": "S21",
"storeLocationId": "stl_1234567890",
"storeLocationExternalId": "1001",
"zoneId": "zone_1234567890",
"zoneExternalId": "1001",
"cutoffTime": "2024-10-04T00:00:00.000000",
"cutoffTimeLocal": "2024-10-04T00:00:00.000000",
"remainingCapacity": 10,
"maximumCapacity": 10,
"minimumOrderValueCents": 1000,
"timezoneId": "America/New_York",
"priceCents": 1000,
"score": 1,
"windowMetadata": {
"key": "value"
}
}
],
"deliveryWindow": {
"id": "dw_01234567890123456789",
"name": "Monday Delivery Window",
"startTime": "2024-01-01T10:00:00Z",
"startTimeLocal": "2024-01-01T10:00:00",
"endTime": "2024-01-01T12:00:00Z",
"endTimeLocal": "2024-01-01T12:00:00",
"timezoneId": "America/New_York",
"cutoffTime": "2024-01-01T10:00:00Z",
"cutoffTimeLocal": "2024-01-01T10:00:00",
"rrule": "RRULE:FREQ=WEEKLY;BYDAY=MO",
"exceptionDates": [
"2024-01-01",
"2024-01-02"
],
"allowedTags": [
"service:rapid",
"service:express",
"franchise_location"
],
"leadTimeMinutes": 60,
"priceCents": 1000,
"minimumOrderValueCents": 1000,
"maximumCapacity": 1000,
"storeLocationId": "stl_01234567890123456789",
"zoneId": "zone_01234567890123456789",
"zoneExternalId": "ext_01234567890123456789",
"windowMetadata": {
"key": "value"
},
"isActive": true,
"isDeleted": false
}
}[
{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"response_status": "<string>",
"RequestID": "<string>"
}
]Upsert order by external identifier with delivery window
Create or update an order by external identifier and associate it with a delivery window. The order is linked to the specified delivery window for scheduled delivery.
POST
/
v1
/
order
/
external-identifier
/
{externalId}
/
delivery-window
Upsert order by external identifier with delivery window
curl --request POST \
--url https://api.sandbox.usenash.com/v1/order/external-identifier/{externalId}/delivery-window \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"externalId": "<string>",
"pickupAddress": "<string>",
"pickupPlaceId": "<string>",
"pickupPhoneNumber": "<string>",
"pickupBusinessName": "<string>",
"pickupFirstName": "<string>",
"pickupLastName": "<string>",
"pickupInstructions": "<string>",
"pickupStoreLocationId": "<string>",
"pickupExternalStoreLocationId": "<string>",
"pickupStoreLocationIds": [
"<string>"
],
"pickupZoneIds": [
"<string>"
],
"pickupBarcodes": [
"<string>"
],
"pickupEmail": "<string>",
"dropoffAddress": "<string>",
"dropoffPlaceId": "<string>",
"dropoffPhoneNumber": "<string>",
"dropoffBusinessName": "<string>",
"dropoffFirstName": "<string>",
"dropoffLastName": "<string>",
"dropoffInstructions": "<string>",
"dropoffBarcodes": [
"<string>"
],
"dropoffEmail": "<string>",
"deliveryMode": "<string>",
"pickupStartTime": "2023-11-07T05:31:56Z",
"pickupEndTime": "2023-11-07T05:31:56Z",
"dropoffStartTime": "2023-11-07T05:31:56Z",
"dropoffEndTime": "2023-11-07T05:31:56Z",
"deliveryWindowId": "<string>",
"description": "<string>",
"itemsCount": 123,
"currency": "<string>",
"valueCents": 123,
"tipAmountCents": 123,
"dueAmountCents": 10000,
"requirements": [
"photo_proof_of_delivery",
"age_verification_on_delivery"
],
"minimumVehicleSize": "car",
"dispatchStrategyId": "<string>",
"orderMetadata": {},
"tags": [
"<string>"
],
"referenceId": "<string>",
"pickupAddressNumber": "<string>",
"pickupAddressSecondarynumber": "<string>",
"pickupAddressFormattedStreet": "<string>",
"pickupAddressCity": "<string>",
"pickupAddressCounty": "<string>",
"pickupAddressState": "<string>",
"pickupAddressZip": "<string>",
"pickupAddressCountry": "<string>",
"pickupLat": 123,
"pickupLng": 123,
"dropoffAddressNumber": "<string>",
"dropoffAddressSecondarynumber": "<string>",
"dropoffAddressFormattedStreet": "<string>",
"dropoffAddressCity": "<string>",
"dropoffAddressCounty": "<string>",
"dropoffAddressState": "<string>",
"dropoffAddressZip": "<string>",
"dropoffAddressCountry": "<string>",
"dropoffLat": 123,
"dropoffLng": 123,
"weight": 123,
"weightUnit": "<string>",
"height": 123,
"width": 123,
"depth": 123,
"volume": 123,
"lengthUnit": "<string>",
"items": [
{
"id": "abc-123",
"description": "A box of books",
"count": 2,
"dimensions": {
"depth": 14,
"height": 10,
"width": 12
},
"weight": 1.5,
"valueCents": 1000,
"requirements": [
"age_verification_on_delivery"
],
"category": "<string>",
"barcode": "0199312650999998913643M221872801002010908",
"metadata": {
"packaging_type": "CTN"
},
"volume": 1200,
"subItems": [
{
"id": "abc-123",
"description": "A box of books",
"count": 2,
"dimensions": {
"depth": 14,
"height": 10,
"width": 12
},
"weight": 1.5,
"valueCents": 1000,
"requirements": [
"age_verification_on_delivery"
],
"category": "<string>",
"barcode": "0199312650999998913643M221872801002010908",
"metadata": {
"packaging_type": "CTN"
},
"sku": "<string>",
"substitution": {
"preference": "substitute",
"source": "<string>",
"substituteItems": [
{
"id": "<string>",
"sku": "<string>",
"quantity": 123
}
]
},
"subItems": "<unknown>"
}
]
}
],
"optimizationParameters": {
"pickupDoorstepTimeSeconds": 90,
"dropoffDoorstepTimeSeconds": 180,
"costsByMetric": {
"distance": 10,
"weight": 200
},
"clusterLabel": "<string>",
"mxLabel": "<string>",
"assignmentPriority": 1,
"sequencePriority": 249,
"sequenceGroup": "<string>",
"pickupOnly": true,
"alternativeDropoffTimeWindows": [
{
"start": "<string>",
"end": "<string>"
}
]
},
"pickupPayment": {
"barcode": {
"type": "CODE128",
"value": "1234567890"
},
"providerCard": true
},
"reapplyAutomations": true,
"maxDeliveryFeeCents": 123,
"requestedDeliveryWindowsStartTime": "2023-11-07T05:31:56Z",
"requestedDeliveryWindowsEndTime": "2023-11-07T05:31:56Z",
"deliveryWindowExpiresAt": "2023-11-07T05:31:56Z",
"deliveryWindowRequestedCapacity": 123
}
'import requests
url = "https://api.sandbox.usenash.com/v1/order/external-identifier/{externalId}/delivery-window"
payload = {
"externalId": "<string>",
"pickupAddress": "<string>",
"pickupPlaceId": "<string>",
"pickupPhoneNumber": "<string>",
"pickupBusinessName": "<string>",
"pickupFirstName": "<string>",
"pickupLastName": "<string>",
"pickupInstructions": "<string>",
"pickupStoreLocationId": "<string>",
"pickupExternalStoreLocationId": "<string>",
"pickupStoreLocationIds": ["<string>"],
"pickupZoneIds": ["<string>"],
"pickupBarcodes": ["<string>"],
"pickupEmail": "<string>",
"dropoffAddress": "<string>",
"dropoffPlaceId": "<string>",
"dropoffPhoneNumber": "<string>",
"dropoffBusinessName": "<string>",
"dropoffFirstName": "<string>",
"dropoffLastName": "<string>",
"dropoffInstructions": "<string>",
"dropoffBarcodes": ["<string>"],
"dropoffEmail": "<string>",
"deliveryMode": "<string>",
"pickupStartTime": "2023-11-07T05:31:56Z",
"pickupEndTime": "2023-11-07T05:31:56Z",
"dropoffStartTime": "2023-11-07T05:31:56Z",
"dropoffEndTime": "2023-11-07T05:31:56Z",
"deliveryWindowId": "<string>",
"description": "<string>",
"itemsCount": 123,
"currency": "<string>",
"valueCents": 123,
"tipAmountCents": 123,
"dueAmountCents": 10000,
"requirements": ["photo_proof_of_delivery", "age_verification_on_delivery"],
"minimumVehicleSize": "car",
"dispatchStrategyId": "<string>",
"orderMetadata": {},
"tags": ["<string>"],
"referenceId": "<string>",
"pickupAddressNumber": "<string>",
"pickupAddressSecondarynumber": "<string>",
"pickupAddressFormattedStreet": "<string>",
"pickupAddressCity": "<string>",
"pickupAddressCounty": "<string>",
"pickupAddressState": "<string>",
"pickupAddressZip": "<string>",
"pickupAddressCountry": "<string>",
"pickupLat": 123,
"pickupLng": 123,
"dropoffAddressNumber": "<string>",
"dropoffAddressSecondarynumber": "<string>",
"dropoffAddressFormattedStreet": "<string>",
"dropoffAddressCity": "<string>",
"dropoffAddressCounty": "<string>",
"dropoffAddressState": "<string>",
"dropoffAddressZip": "<string>",
"dropoffAddressCountry": "<string>",
"dropoffLat": 123,
"dropoffLng": 123,
"weight": 123,
"weightUnit": "<string>",
"height": 123,
"width": 123,
"depth": 123,
"volume": 123,
"lengthUnit": "<string>",
"items": [
{
"id": "abc-123",
"description": "A box of books",
"count": 2,
"dimensions": {
"depth": 14,
"height": 10,
"width": 12
},
"weight": 1.5,
"valueCents": 1000,
"requirements": ["age_verification_on_delivery"],
"category": "<string>",
"barcode": "0199312650999998913643M221872801002010908",
"metadata": { "packaging_type": "CTN" },
"volume": 1200,
"subItems": [
{
"id": "abc-123",
"description": "A box of books",
"count": 2,
"dimensions": {
"depth": 14,
"height": 10,
"width": 12
},
"weight": 1.5,
"valueCents": 1000,
"requirements": ["age_verification_on_delivery"],
"category": "<string>",
"barcode": "0199312650999998913643M221872801002010908",
"metadata": { "packaging_type": "CTN" },
"sku": "<string>",
"substitution": {
"preference": "substitute",
"source": "<string>",
"substituteItems": [
{
"id": "<string>",
"sku": "<string>",
"quantity": 123
}
]
},
"subItems": "<unknown>"
}
]
}
],
"optimizationParameters": {
"pickupDoorstepTimeSeconds": 90,
"dropoffDoorstepTimeSeconds": 180,
"costsByMetric": {
"distance": 10,
"weight": 200
},
"clusterLabel": "<string>",
"mxLabel": "<string>",
"assignmentPriority": 1,
"sequencePriority": 249,
"sequenceGroup": "<string>",
"pickupOnly": True,
"alternativeDropoffTimeWindows": [
{
"start": "<string>",
"end": "<string>"
}
]
},
"pickupPayment": {
"barcode": {
"type": "CODE128",
"value": "1234567890"
},
"providerCard": True
},
"reapplyAutomations": True,
"maxDeliveryFeeCents": 123,
"requestedDeliveryWindowsStartTime": "2023-11-07T05:31:56Z",
"requestedDeliveryWindowsEndTime": "2023-11-07T05:31:56Z",
"deliveryWindowExpiresAt": "2023-11-07T05:31:56Z",
"deliveryWindowRequestedCapacity": 123
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
externalId: '<string>',
pickupAddress: '<string>',
pickupPlaceId: '<string>',
pickupPhoneNumber: '<string>',
pickupBusinessName: '<string>',
pickupFirstName: '<string>',
pickupLastName: '<string>',
pickupInstructions: '<string>',
pickupStoreLocationId: '<string>',
pickupExternalStoreLocationId: '<string>',
pickupStoreLocationIds: ['<string>'],
pickupZoneIds: ['<string>'],
pickupBarcodes: ['<string>'],
pickupEmail: '<string>',
dropoffAddress: '<string>',
dropoffPlaceId: '<string>',
dropoffPhoneNumber: '<string>',
dropoffBusinessName: '<string>',
dropoffFirstName: '<string>',
dropoffLastName: '<string>',
dropoffInstructions: '<string>',
dropoffBarcodes: ['<string>'],
dropoffEmail: '<string>',
deliveryMode: '<string>',
pickupStartTime: '2023-11-07T05:31:56Z',
pickupEndTime: '2023-11-07T05:31:56Z',
dropoffStartTime: '2023-11-07T05:31:56Z',
dropoffEndTime: '2023-11-07T05:31:56Z',
deliveryWindowId: '<string>',
description: '<string>',
itemsCount: 123,
currency: '<string>',
valueCents: 123,
tipAmountCents: 123,
dueAmountCents: 10000,
requirements: ['photo_proof_of_delivery', 'age_verification_on_delivery'],
minimumVehicleSize: 'car',
dispatchStrategyId: '<string>',
orderMetadata: {},
tags: ['<string>'],
referenceId: '<string>',
pickupAddressNumber: '<string>',
pickupAddressSecondarynumber: '<string>',
pickupAddressFormattedStreet: '<string>',
pickupAddressCity: '<string>',
pickupAddressCounty: '<string>',
pickupAddressState: '<string>',
pickupAddressZip: '<string>',
pickupAddressCountry: '<string>',
pickupLat: 123,
pickupLng: 123,
dropoffAddressNumber: '<string>',
dropoffAddressSecondarynumber: '<string>',
dropoffAddressFormattedStreet: '<string>',
dropoffAddressCity: '<string>',
dropoffAddressCounty: '<string>',
dropoffAddressState: '<string>',
dropoffAddressZip: '<string>',
dropoffAddressCountry: '<string>',
dropoffLat: 123,
dropoffLng: 123,
weight: 123,
weightUnit: '<string>',
height: 123,
width: 123,
depth: 123,
volume: 123,
lengthUnit: '<string>',
items: [
{
id: 'abc-123',
description: 'A box of books',
count: 2,
dimensions: {depth: 14, height: 10, width: 12},
weight: 1.5,
valueCents: 1000,
requirements: ['age_verification_on_delivery'],
category: '<string>',
barcode: '0199312650999998913643M221872801002010908',
metadata: {packaging_type: 'CTN'},
volume: 1200,
subItems: [
{
id: 'abc-123',
description: 'A box of books',
count: 2,
dimensions: {depth: 14, height: 10, width: 12},
weight: 1.5,
valueCents: 1000,
requirements: ['age_verification_on_delivery'],
category: '<string>',
barcode: '0199312650999998913643M221872801002010908',
metadata: {packaging_type: 'CTN'},
sku: '<string>',
substitution: {
preference: 'substitute',
source: '<string>',
substituteItems: [{id: '<string>', sku: '<string>', quantity: 123}]
},
subItems: '<unknown>'
}
]
}
],
optimizationParameters: {
pickupDoorstepTimeSeconds: 90,
dropoffDoorstepTimeSeconds: 180,
costsByMetric: {distance: 10, weight: 200},
clusterLabel: '<string>',
mxLabel: '<string>',
assignmentPriority: 1,
sequencePriority: 249,
sequenceGroup: '<string>',
pickupOnly: true,
alternativeDropoffTimeWindows: [{start: '<string>', end: '<string>'}]
},
pickupPayment: {barcode: {type: 'CODE128', value: '1234567890'}, providerCard: true},
reapplyAutomations: true,
maxDeliveryFeeCents: 123,
requestedDeliveryWindowsStartTime: '2023-11-07T05:31:56Z',
requestedDeliveryWindowsEndTime: '2023-11-07T05:31:56Z',
deliveryWindowExpiresAt: '2023-11-07T05:31:56Z',
deliveryWindowRequestedCapacity: 123
})
};
fetch('https://api.sandbox.usenash.com/v1/order/external-identifier/{externalId}/delivery-window', 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.sandbox.usenash.com/v1/order/external-identifier/{externalId}/delivery-window",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'externalId' => '<string>',
'pickupAddress' => '<string>',
'pickupPlaceId' => '<string>',
'pickupPhoneNumber' => '<string>',
'pickupBusinessName' => '<string>',
'pickupFirstName' => '<string>',
'pickupLastName' => '<string>',
'pickupInstructions' => '<string>',
'pickupStoreLocationId' => '<string>',
'pickupExternalStoreLocationId' => '<string>',
'pickupStoreLocationIds' => [
'<string>'
],
'pickupZoneIds' => [
'<string>'
],
'pickupBarcodes' => [
'<string>'
],
'pickupEmail' => '<string>',
'dropoffAddress' => '<string>',
'dropoffPlaceId' => '<string>',
'dropoffPhoneNumber' => '<string>',
'dropoffBusinessName' => '<string>',
'dropoffFirstName' => '<string>',
'dropoffLastName' => '<string>',
'dropoffInstructions' => '<string>',
'dropoffBarcodes' => [
'<string>'
],
'dropoffEmail' => '<string>',
'deliveryMode' => '<string>',
'pickupStartTime' => '2023-11-07T05:31:56Z',
'pickupEndTime' => '2023-11-07T05:31:56Z',
'dropoffStartTime' => '2023-11-07T05:31:56Z',
'dropoffEndTime' => '2023-11-07T05:31:56Z',
'deliveryWindowId' => '<string>',
'description' => '<string>',
'itemsCount' => 123,
'currency' => '<string>',
'valueCents' => 123,
'tipAmountCents' => 123,
'dueAmountCents' => 10000,
'requirements' => [
'photo_proof_of_delivery',
'age_verification_on_delivery'
],
'minimumVehicleSize' => 'car',
'dispatchStrategyId' => '<string>',
'orderMetadata' => [
],
'tags' => [
'<string>'
],
'referenceId' => '<string>',
'pickupAddressNumber' => '<string>',
'pickupAddressSecondarynumber' => '<string>',
'pickupAddressFormattedStreet' => '<string>',
'pickupAddressCity' => '<string>',
'pickupAddressCounty' => '<string>',
'pickupAddressState' => '<string>',
'pickupAddressZip' => '<string>',
'pickupAddressCountry' => '<string>',
'pickupLat' => 123,
'pickupLng' => 123,
'dropoffAddressNumber' => '<string>',
'dropoffAddressSecondarynumber' => '<string>',
'dropoffAddressFormattedStreet' => '<string>',
'dropoffAddressCity' => '<string>',
'dropoffAddressCounty' => '<string>',
'dropoffAddressState' => '<string>',
'dropoffAddressZip' => '<string>',
'dropoffAddressCountry' => '<string>',
'dropoffLat' => 123,
'dropoffLng' => 123,
'weight' => 123,
'weightUnit' => '<string>',
'height' => 123,
'width' => 123,
'depth' => 123,
'volume' => 123,
'lengthUnit' => '<string>',
'items' => [
[
'id' => 'abc-123',
'description' => 'A box of books',
'count' => 2,
'dimensions' => [
'depth' => 14,
'height' => 10,
'width' => 12
],
'weight' => 1.5,
'valueCents' => 1000,
'requirements' => [
'age_verification_on_delivery'
],
'category' => '<string>',
'barcode' => '0199312650999998913643M221872801002010908',
'metadata' => [
'packaging_type' => 'CTN'
],
'volume' => 1200,
'subItems' => [
[
'id' => 'abc-123',
'description' => 'A box of books',
'count' => 2,
'dimensions' => [
'depth' => 14,
'height' => 10,
'width' => 12
],
'weight' => 1.5,
'valueCents' => 1000,
'requirements' => [
'age_verification_on_delivery'
],
'category' => '<string>',
'barcode' => '0199312650999998913643M221872801002010908',
'metadata' => [
'packaging_type' => 'CTN'
],
'sku' => '<string>',
'substitution' => [
'preference' => 'substitute',
'source' => '<string>',
'substituteItems' => [
[
'id' => '<string>',
'sku' => '<string>',
'quantity' => 123
]
]
],
'subItems' => '<unknown>'
]
]
]
],
'optimizationParameters' => [
'pickupDoorstepTimeSeconds' => 90,
'dropoffDoorstepTimeSeconds' => 180,
'costsByMetric' => [
'distance' => 10,
'weight' => 200
],
'clusterLabel' => '<string>',
'mxLabel' => '<string>',
'assignmentPriority' => 1,
'sequencePriority' => 249,
'sequenceGroup' => '<string>',
'pickupOnly' => true,
'alternativeDropoffTimeWindows' => [
[
'start' => '<string>',
'end' => '<string>'
]
]
],
'pickupPayment' => [
'barcode' => [
'type' => 'CODE128',
'value' => '1234567890'
],
'providerCard' => true
],
'reapplyAutomations' => true,
'maxDeliveryFeeCents' => 123,
'requestedDeliveryWindowsStartTime' => '2023-11-07T05:31:56Z',
'requestedDeliveryWindowsEndTime' => '2023-11-07T05:31:56Z',
'deliveryWindowExpiresAt' => '2023-11-07T05:31:56Z',
'deliveryWindowRequestedCapacity' => 123
]),
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.sandbox.usenash.com/v1/order/external-identifier/{externalId}/delivery-window"
payload := strings.NewReader("{\n \"externalId\": \"<string>\",\n \"pickupAddress\": \"<string>\",\n \"pickupPlaceId\": \"<string>\",\n \"pickupPhoneNumber\": \"<string>\",\n \"pickupBusinessName\": \"<string>\",\n \"pickupFirstName\": \"<string>\",\n \"pickupLastName\": \"<string>\",\n \"pickupInstructions\": \"<string>\",\n \"pickupStoreLocationId\": \"<string>\",\n \"pickupExternalStoreLocationId\": \"<string>\",\n \"pickupStoreLocationIds\": [\n \"<string>\"\n ],\n \"pickupZoneIds\": [\n \"<string>\"\n ],\n \"pickupBarcodes\": [\n \"<string>\"\n ],\n \"pickupEmail\": \"<string>\",\n \"dropoffAddress\": \"<string>\",\n \"dropoffPlaceId\": \"<string>\",\n \"dropoffPhoneNumber\": \"<string>\",\n \"dropoffBusinessName\": \"<string>\",\n \"dropoffFirstName\": \"<string>\",\n \"dropoffLastName\": \"<string>\",\n \"dropoffInstructions\": \"<string>\",\n \"dropoffBarcodes\": [\n \"<string>\"\n ],\n \"dropoffEmail\": \"<string>\",\n \"deliveryMode\": \"<string>\",\n \"pickupStartTime\": \"2023-11-07T05:31:56Z\",\n \"pickupEndTime\": \"2023-11-07T05:31:56Z\",\n \"dropoffStartTime\": \"2023-11-07T05:31:56Z\",\n \"dropoffEndTime\": \"2023-11-07T05:31:56Z\",\n \"deliveryWindowId\": \"<string>\",\n \"description\": \"<string>\",\n \"itemsCount\": 123,\n \"currency\": \"<string>\",\n \"valueCents\": 123,\n \"tipAmountCents\": 123,\n \"dueAmountCents\": 10000,\n \"requirements\": [\n \"photo_proof_of_delivery\",\n \"age_verification_on_delivery\"\n ],\n \"minimumVehicleSize\": \"car\",\n \"dispatchStrategyId\": \"<string>\",\n \"orderMetadata\": {},\n \"tags\": [\n \"<string>\"\n ],\n \"referenceId\": \"<string>\",\n \"pickupAddressNumber\": \"<string>\",\n \"pickupAddressSecondarynumber\": \"<string>\",\n \"pickupAddressFormattedStreet\": \"<string>\",\n \"pickupAddressCity\": \"<string>\",\n \"pickupAddressCounty\": \"<string>\",\n \"pickupAddressState\": \"<string>\",\n \"pickupAddressZip\": \"<string>\",\n \"pickupAddressCountry\": \"<string>\",\n \"pickupLat\": 123,\n \"pickupLng\": 123,\n \"dropoffAddressNumber\": \"<string>\",\n \"dropoffAddressSecondarynumber\": \"<string>\",\n \"dropoffAddressFormattedStreet\": \"<string>\",\n \"dropoffAddressCity\": \"<string>\",\n \"dropoffAddressCounty\": \"<string>\",\n \"dropoffAddressState\": \"<string>\",\n \"dropoffAddressZip\": \"<string>\",\n \"dropoffAddressCountry\": \"<string>\",\n \"dropoffLat\": 123,\n \"dropoffLng\": 123,\n \"weight\": 123,\n \"weightUnit\": \"<string>\",\n \"height\": 123,\n \"width\": 123,\n \"depth\": 123,\n \"volume\": 123,\n \"lengthUnit\": \"<string>\",\n \"items\": [\n {\n \"id\": \"abc-123\",\n \"description\": \"A box of books\",\n \"count\": 2,\n \"dimensions\": {\n \"depth\": 14,\n \"height\": 10,\n \"width\": 12\n },\n \"weight\": 1.5,\n \"valueCents\": 1000,\n \"requirements\": [\n \"age_verification_on_delivery\"\n ],\n \"category\": \"<string>\",\n \"barcode\": \"0199312650999998913643M221872801002010908\",\n \"metadata\": {\n \"packaging_type\": \"CTN\"\n },\n \"volume\": 1200,\n \"subItems\": [\n {\n \"id\": \"abc-123\",\n \"description\": \"A box of books\",\n \"count\": 2,\n \"dimensions\": {\n \"depth\": 14,\n \"height\": 10,\n \"width\": 12\n },\n \"weight\": 1.5,\n \"valueCents\": 1000,\n \"requirements\": [\n \"age_verification_on_delivery\"\n ],\n \"category\": \"<string>\",\n \"barcode\": \"0199312650999998913643M221872801002010908\",\n \"metadata\": {\n \"packaging_type\": \"CTN\"\n },\n \"sku\": \"<string>\",\n \"substitution\": {\n \"preference\": \"substitute\",\n \"source\": \"<string>\",\n \"substituteItems\": [\n {\n \"id\": \"<string>\",\n \"sku\": \"<string>\",\n \"quantity\": 123\n }\n ]\n },\n \"subItems\": \"<unknown>\"\n }\n ]\n }\n ],\n \"optimizationParameters\": {\n \"pickupDoorstepTimeSeconds\": 90,\n \"dropoffDoorstepTimeSeconds\": 180,\n \"costsByMetric\": {\n \"distance\": 10,\n \"weight\": 200\n },\n \"clusterLabel\": \"<string>\",\n \"mxLabel\": \"<string>\",\n \"assignmentPriority\": 1,\n \"sequencePriority\": 249,\n \"sequenceGroup\": \"<string>\",\n \"pickupOnly\": true,\n \"alternativeDropoffTimeWindows\": [\n {\n \"start\": \"<string>\",\n \"end\": \"<string>\"\n }\n ]\n },\n \"pickupPayment\": {\n \"barcode\": {\n \"type\": \"CODE128\",\n \"value\": \"1234567890\"\n },\n \"providerCard\": true\n },\n \"reapplyAutomations\": true,\n \"maxDeliveryFeeCents\": 123,\n \"requestedDeliveryWindowsStartTime\": \"2023-11-07T05:31:56Z\",\n \"requestedDeliveryWindowsEndTime\": \"2023-11-07T05:31:56Z\",\n \"deliveryWindowExpiresAt\": \"2023-11-07T05:31:56Z\",\n \"deliveryWindowRequestedCapacity\": 123\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.sandbox.usenash.com/v1/order/external-identifier/{externalId}/delivery-window")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"externalId\": \"<string>\",\n \"pickupAddress\": \"<string>\",\n \"pickupPlaceId\": \"<string>\",\n \"pickupPhoneNumber\": \"<string>\",\n \"pickupBusinessName\": \"<string>\",\n \"pickupFirstName\": \"<string>\",\n \"pickupLastName\": \"<string>\",\n \"pickupInstructions\": \"<string>\",\n \"pickupStoreLocationId\": \"<string>\",\n \"pickupExternalStoreLocationId\": \"<string>\",\n \"pickupStoreLocationIds\": [\n \"<string>\"\n ],\n \"pickupZoneIds\": [\n \"<string>\"\n ],\n \"pickupBarcodes\": [\n \"<string>\"\n ],\n \"pickupEmail\": \"<string>\",\n \"dropoffAddress\": \"<string>\",\n \"dropoffPlaceId\": \"<string>\",\n \"dropoffPhoneNumber\": \"<string>\",\n \"dropoffBusinessName\": \"<string>\",\n \"dropoffFirstName\": \"<string>\",\n \"dropoffLastName\": \"<string>\",\n \"dropoffInstructions\": \"<string>\",\n \"dropoffBarcodes\": [\n \"<string>\"\n ],\n \"dropoffEmail\": \"<string>\",\n \"deliveryMode\": \"<string>\",\n \"pickupStartTime\": \"2023-11-07T05:31:56Z\",\n \"pickupEndTime\": \"2023-11-07T05:31:56Z\",\n \"dropoffStartTime\": \"2023-11-07T05:31:56Z\",\n \"dropoffEndTime\": \"2023-11-07T05:31:56Z\",\n \"deliveryWindowId\": \"<string>\",\n \"description\": \"<string>\",\n \"itemsCount\": 123,\n \"currency\": \"<string>\",\n \"valueCents\": 123,\n \"tipAmountCents\": 123,\n \"dueAmountCents\": 10000,\n \"requirements\": [\n \"photo_proof_of_delivery\",\n \"age_verification_on_delivery\"\n ],\n \"minimumVehicleSize\": \"car\",\n \"dispatchStrategyId\": \"<string>\",\n \"orderMetadata\": {},\n \"tags\": [\n \"<string>\"\n ],\n \"referenceId\": \"<string>\",\n \"pickupAddressNumber\": \"<string>\",\n \"pickupAddressSecondarynumber\": \"<string>\",\n \"pickupAddressFormattedStreet\": \"<string>\",\n \"pickupAddressCity\": \"<string>\",\n \"pickupAddressCounty\": \"<string>\",\n \"pickupAddressState\": \"<string>\",\n \"pickupAddressZip\": \"<string>\",\n \"pickupAddressCountry\": \"<string>\",\n \"pickupLat\": 123,\n \"pickupLng\": 123,\n \"dropoffAddressNumber\": \"<string>\",\n \"dropoffAddressSecondarynumber\": \"<string>\",\n \"dropoffAddressFormattedStreet\": \"<string>\",\n \"dropoffAddressCity\": \"<string>\",\n \"dropoffAddressCounty\": \"<string>\",\n \"dropoffAddressState\": \"<string>\",\n \"dropoffAddressZip\": \"<string>\",\n \"dropoffAddressCountry\": \"<string>\",\n \"dropoffLat\": 123,\n \"dropoffLng\": 123,\n \"weight\": 123,\n \"weightUnit\": \"<string>\",\n \"height\": 123,\n \"width\": 123,\n \"depth\": 123,\n \"volume\": 123,\n \"lengthUnit\": \"<string>\",\n \"items\": [\n {\n \"id\": \"abc-123\",\n \"description\": \"A box of books\",\n \"count\": 2,\n \"dimensions\": {\n \"depth\": 14,\n \"height\": 10,\n \"width\": 12\n },\n \"weight\": 1.5,\n \"valueCents\": 1000,\n \"requirements\": [\n \"age_verification_on_delivery\"\n ],\n \"category\": \"<string>\",\n \"barcode\": \"0199312650999998913643M221872801002010908\",\n \"metadata\": {\n \"packaging_type\": \"CTN\"\n },\n \"volume\": 1200,\n \"subItems\": [\n {\n \"id\": \"abc-123\",\n \"description\": \"A box of books\",\n \"count\": 2,\n \"dimensions\": {\n \"depth\": 14,\n \"height\": 10,\n \"width\": 12\n },\n \"weight\": 1.5,\n \"valueCents\": 1000,\n \"requirements\": [\n \"age_verification_on_delivery\"\n ],\n \"category\": \"<string>\",\n \"barcode\": \"0199312650999998913643M221872801002010908\",\n \"metadata\": {\n \"packaging_type\": \"CTN\"\n },\n \"sku\": \"<string>\",\n \"substitution\": {\n \"preference\": \"substitute\",\n \"source\": \"<string>\",\n \"substituteItems\": [\n {\n \"id\": \"<string>\",\n \"sku\": \"<string>\",\n \"quantity\": 123\n }\n ]\n },\n \"subItems\": \"<unknown>\"\n }\n ]\n }\n ],\n \"optimizationParameters\": {\n \"pickupDoorstepTimeSeconds\": 90,\n \"dropoffDoorstepTimeSeconds\": 180,\n \"costsByMetric\": {\n \"distance\": 10,\n \"weight\": 200\n },\n \"clusterLabel\": \"<string>\",\n \"mxLabel\": \"<string>\",\n \"assignmentPriority\": 1,\n \"sequencePriority\": 249,\n \"sequenceGroup\": \"<string>\",\n \"pickupOnly\": true,\n \"alternativeDropoffTimeWindows\": [\n {\n \"start\": \"<string>\",\n \"end\": \"<string>\"\n }\n ]\n },\n \"pickupPayment\": {\n \"barcode\": {\n \"type\": \"CODE128\",\n \"value\": \"1234567890\"\n },\n \"providerCard\": true\n },\n \"reapplyAutomations\": true,\n \"maxDeliveryFeeCents\": 123,\n \"requestedDeliveryWindowsStartTime\": \"2023-11-07T05:31:56Z\",\n \"requestedDeliveryWindowsEndTime\": \"2023-11-07T05:31:56Z\",\n \"deliveryWindowExpiresAt\": \"2023-11-07T05:31:56Z\",\n \"deliveryWindowRequestedCapacity\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.usenash.com/v1/order/external-identifier/{externalId}/delivery-window")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"externalId\": \"<string>\",\n \"pickupAddress\": \"<string>\",\n \"pickupPlaceId\": \"<string>\",\n \"pickupPhoneNumber\": \"<string>\",\n \"pickupBusinessName\": \"<string>\",\n \"pickupFirstName\": \"<string>\",\n \"pickupLastName\": \"<string>\",\n \"pickupInstructions\": \"<string>\",\n \"pickupStoreLocationId\": \"<string>\",\n \"pickupExternalStoreLocationId\": \"<string>\",\n \"pickupStoreLocationIds\": [\n \"<string>\"\n ],\n \"pickupZoneIds\": [\n \"<string>\"\n ],\n \"pickupBarcodes\": [\n \"<string>\"\n ],\n \"pickupEmail\": \"<string>\",\n \"dropoffAddress\": \"<string>\",\n \"dropoffPlaceId\": \"<string>\",\n \"dropoffPhoneNumber\": \"<string>\",\n \"dropoffBusinessName\": \"<string>\",\n \"dropoffFirstName\": \"<string>\",\n \"dropoffLastName\": \"<string>\",\n \"dropoffInstructions\": \"<string>\",\n \"dropoffBarcodes\": [\n \"<string>\"\n ],\n \"dropoffEmail\": \"<string>\",\n \"deliveryMode\": \"<string>\",\n \"pickupStartTime\": \"2023-11-07T05:31:56Z\",\n \"pickupEndTime\": \"2023-11-07T05:31:56Z\",\n \"dropoffStartTime\": \"2023-11-07T05:31:56Z\",\n \"dropoffEndTime\": \"2023-11-07T05:31:56Z\",\n \"deliveryWindowId\": \"<string>\",\n \"description\": \"<string>\",\n \"itemsCount\": 123,\n \"currency\": \"<string>\",\n \"valueCents\": 123,\n \"tipAmountCents\": 123,\n \"dueAmountCents\": 10000,\n \"requirements\": [\n \"photo_proof_of_delivery\",\n \"age_verification_on_delivery\"\n ],\n \"minimumVehicleSize\": \"car\",\n \"dispatchStrategyId\": \"<string>\",\n \"orderMetadata\": {},\n \"tags\": [\n \"<string>\"\n ],\n \"referenceId\": \"<string>\",\n \"pickupAddressNumber\": \"<string>\",\n \"pickupAddressSecondarynumber\": \"<string>\",\n \"pickupAddressFormattedStreet\": \"<string>\",\n \"pickupAddressCity\": \"<string>\",\n \"pickupAddressCounty\": \"<string>\",\n \"pickupAddressState\": \"<string>\",\n \"pickupAddressZip\": \"<string>\",\n \"pickupAddressCountry\": \"<string>\",\n \"pickupLat\": 123,\n \"pickupLng\": 123,\n \"dropoffAddressNumber\": \"<string>\",\n \"dropoffAddressSecondarynumber\": \"<string>\",\n \"dropoffAddressFormattedStreet\": \"<string>\",\n \"dropoffAddressCity\": \"<string>\",\n \"dropoffAddressCounty\": \"<string>\",\n \"dropoffAddressState\": \"<string>\",\n \"dropoffAddressZip\": \"<string>\",\n \"dropoffAddressCountry\": \"<string>\",\n \"dropoffLat\": 123,\n \"dropoffLng\": 123,\n \"weight\": 123,\n \"weightUnit\": \"<string>\",\n \"height\": 123,\n \"width\": 123,\n \"depth\": 123,\n \"volume\": 123,\n \"lengthUnit\": \"<string>\",\n \"items\": [\n {\n \"id\": \"abc-123\",\n \"description\": \"A box of books\",\n \"count\": 2,\n \"dimensions\": {\n \"depth\": 14,\n \"height\": 10,\n \"width\": 12\n },\n \"weight\": 1.5,\n \"valueCents\": 1000,\n \"requirements\": [\n \"age_verification_on_delivery\"\n ],\n \"category\": \"<string>\",\n \"barcode\": \"0199312650999998913643M221872801002010908\",\n \"metadata\": {\n \"packaging_type\": \"CTN\"\n },\n \"volume\": 1200,\n \"subItems\": [\n {\n \"id\": \"abc-123\",\n \"description\": \"A box of books\",\n \"count\": 2,\n \"dimensions\": {\n \"depth\": 14,\n \"height\": 10,\n \"width\": 12\n },\n \"weight\": 1.5,\n \"valueCents\": 1000,\n \"requirements\": [\n \"age_verification_on_delivery\"\n ],\n \"category\": \"<string>\",\n \"barcode\": \"0199312650999998913643M221872801002010908\",\n \"metadata\": {\n \"packaging_type\": \"CTN\"\n },\n \"sku\": \"<string>\",\n \"substitution\": {\n \"preference\": \"substitute\",\n \"source\": \"<string>\",\n \"substituteItems\": [\n {\n \"id\": \"<string>\",\n \"sku\": \"<string>\",\n \"quantity\": 123\n }\n ]\n },\n \"subItems\": \"<unknown>\"\n }\n ]\n }\n ],\n \"optimizationParameters\": {\n \"pickupDoorstepTimeSeconds\": 90,\n \"dropoffDoorstepTimeSeconds\": 180,\n \"costsByMetric\": {\n \"distance\": 10,\n \"weight\": 200\n },\n \"clusterLabel\": \"<string>\",\n \"mxLabel\": \"<string>\",\n \"assignmentPriority\": 1,\n \"sequencePriority\": 249,\n \"sequenceGroup\": \"<string>\",\n \"pickupOnly\": true,\n \"alternativeDropoffTimeWindows\": [\n {\n \"start\": \"<string>\",\n \"end\": \"<string>\"\n }\n ]\n },\n \"pickupPayment\": {\n \"barcode\": {\n \"type\": \"CODE128\",\n \"value\": \"1234567890\"\n },\n \"providerCard\": true\n },\n \"reapplyAutomations\": true,\n \"maxDeliveryFeeCents\": 123,\n \"requestedDeliveryWindowsStartTime\": \"2023-11-07T05:31:56Z\",\n \"requestedDeliveryWindowsEndTime\": \"2023-11-07T05:31:56Z\",\n \"deliveryWindowExpiresAt\": \"2023-11-07T05:31:56Z\",\n \"deliveryWindowRequestedCapacity\": 123\n}"
response = http.request(request)
puts response.read_body{
"id": "ord_1234567890",
"createdAt": "2023-08-29T19:17:46.264523",
"portalUrl": "https://portal.dev.usenash.com/orders/ord_1234567890",
"publicTrackingUrl": "https://tracking.dev.usenash.com/ord_1234567890",
"status": "needs_attention",
"tags": [
"REST_API"
],
"externalId": "1234567890",
"externalGroupId": "1234567890",
"referenceId": "1234567890",
"orderMetadata": {
"key": "value"
},
"pickupAddress": "185 University Ave, Palo Alto, CA 94301",
"pickupPlaceId": "ChIJd8BlQJq3t4kRUKhH43CQ",
"pickupAddressNumber": "185",
"pickupAddressSecondarynumber": "<string>",
"pickupAddressFormattedStreet": "University Ave",
"pickupAddressCity": "Palo Alto",
"pickupAddressCounty": "Santa Clara",
"pickupAddressState": "CA",
"pickupAddressZip": "94301",
"pickupAddressCountry": "US",
"pickupLat": 37.422222,
"pickupLng": -122.139776,
"pickupPhoneNumber": "+15555555555",
"pickupEmail": "store@example.com",
"pickupFirstName": "Manager",
"pickupLastName": "Manager",
"pickupBusinessName": "Store ABC",
"pickupInstructions": "Leave at the front door",
"pickupStoreLocationId": "stl_VwpoPJaaqWiPGnXEhWfX",
"pickupExternalStoreLocationId": "0021112",
"pickupZoneIds": [
"<string>"
],
"pickupBarcodes": [
"1234567890",
"0987654321"
],
"pickupPayment": {
"barcode": {
"type": "CODE128",
"value": "1234567890"
},
"providerCard": false
},
"dropoffAddress": "401 San Antonio Rd, Mountain View, CA 94040",
"dropoffPlaceId": "ChIJd8BlQJq3t4kRUKhH43CQ",
"dropoffAddressNumber": "401",
"dropoffAddressSecondarynumber": "<string>",
"dropoffAddressFormattedStreet": "San Antonio Rd",
"dropoffAddressCity": "Mountain View",
"dropoffAddressCounty": "Santa Clara",
"dropoffAddressState": "CA",
"dropoffAddressZip": "94040",
"dropoffAddressCountry": "US",
"dropoffLat": 37.422222,
"dropoffLng": -122.139776,
"dropoffPhoneNumber": "+15555555556",
"dropoffEmail": "customer@example.com",
"dropoffFirstName": "Quote",
"dropoffLastName": "Request",
"dropoffBusinessName": "<string>",
"dropoffInstructions": "Leave at the front door",
"dropoffStoreLocationId": "<string>",
"dropoffBarcodes": [
"<string>"
],
"deliveryMode": "scheduled",
"pickupStartTime": "2024-08-22T23:54:08Z",
"pickupEndTime": "2024-08-22T23:54:08Z",
"dropoffStartTime": "2024-08-22T23:54:08Z",
"dropoffEndTime": "2024-08-22T23:54:08Z",
"description": "Order description",
"itemsCount": "1",
"requirements": [
"photo_proof_of_delivery"
],
"minimumVehicleSize": "car",
"currency": "USD",
"valueCents": "10000",
"tipAmountCents": "1000",
"dueAmountCents": "10000",
"width": "100",
"depth": "100",
"height": "100",
"volume": "<string>",
"weight": "100",
"items": [
{
"id": "abc-123",
"description": "A box of books",
"count": 2,
"dimensions": {
"depth": 14,
"height": 10,
"width": 12
},
"weight": 1.5,
"valueCents": 1000,
"requirements": [
"age_verification_on_delivery"
],
"category": "<string>",
"barcode": "0199312650999998913643M221872801002010908",
"metadata": {
"packaging_type": "CTN"
},
"volume": 1200,
"subItems": [
{
"id": "abc-123",
"description": "A box of books",
"count": 2,
"dimensions": {
"depth": 14,
"height": 10,
"width": 12
},
"weight": 1.5,
"valueCents": 1000,
"requirements": [
"age_verification_on_delivery"
],
"category": "<string>",
"barcode": "0199312650999998913643M221872801002010908",
"metadata": {
"packaging_type": "CTN"
},
"sku": "<string>",
"substitution": {
"preference": "substitute",
"source": "<string>",
"substituteItems": [
{
"id": "<string>",
"sku": "<string>",
"quantity": 123
}
]
},
"subItems": "<unknown>"
}
]
}
],
"dispatchStrategyId": "dss_1234567890",
"maxDeliveryFeeCents": "1000",
"documents": [
{
"contentType": "application/pdf",
"data": "SGVsbG8gd29ybGQ=",
"id": "doc_1234567890",
"type": "shipping_label",
"url": "https://example.com/document.pdf"
}
],
"validationErrors": {
"pickupStartTime": "Time is in the past"
},
"quotes": [
{
"costSplitBusinessCents": null,
"costSplitCustomerCents": null,
"createdTime": "2024-09-03T20:43:45.899094",
"currency": "USD",
"dropoffEta": "2024-09-03T22:20:47.569000",
"expireTime": "2024-09-03T21:43:45.899102",
"id": "qot_2oWASjGxMtucwGgu6A7BYC",
"insuranceFeeCents": 0,
"nashFeeCents": 300,
"pickupWindow": null,
"priceCents": 100,
"providerId": "dispatch_partner",
"providerIsInternal": false,
"providerLogo": "https://nash-provider-logos.s3.amazonaws.com/dispatchit-logo.jpg",
"providerName": "Dispatch",
"tags": null,
"taxAmountCents": null,
"tollFeeCents": 0,
"totalPriceBreakdown": {
"priceCents": 100
},
"totalPriceCents": 100,
"type": "LOCAL"
}
],
"failedQuotes": [
"quote_1234567890",
"quote_0987654321"
],
"quoteFailure": {},
"deliveryWindowId": "<string>",
"deliveryWindowStatus": "<string>",
"deliveryWindowExpiresAt": "2023-11-07T05:31:56Z",
"deliveryWindowRequestedCapacity": "<string>",
"eligibleDeliveryWindows": [
{
"id": "<string>",
"ineligibleReason": "Ineligible due to order tags",
"allowedTags": "['rapid', 'oversize']",
"startTime": "2024-10-06T00:00:00.000000",
"startTimeLocal": "2024-10-06T00:00:00.000000",
"endTime": "2024-10-07T00:00:00.000000",
"endTimeLocal": "2024-10-07T00:00:00.000000",
"name": "S21",
"storeLocationId": "stl_1234567890",
"storeLocationExternalId": "1001",
"zoneId": "zone_1234567890",
"zoneExternalId": "1001",
"cutoffTime": "2024-10-04T00:00:00.000000",
"cutoffTimeLocal": "2024-10-04T00:00:00.000000",
"remainingCapacity": 10,
"maximumCapacity": 10,
"minimumOrderValueCents": 1000,
"timezoneId": "America/New_York",
"priceCents": 1000,
"score": 1,
"windowMetadata": {
"key": "value"
}
}
],
"ineligibleDeliveryWindows": [
{
"id": "<string>",
"ineligibleReason": "Ineligible due to order tags",
"allowedTags": "['rapid', 'oversize']",
"startTime": "2024-10-06T00:00:00.000000",
"startTimeLocal": "2024-10-06T00:00:00.000000",
"endTime": "2024-10-07T00:00:00.000000",
"endTimeLocal": "2024-10-07T00:00:00.000000",
"name": "S21",
"storeLocationId": "stl_1234567890",
"storeLocationExternalId": "1001",
"zoneId": "zone_1234567890",
"zoneExternalId": "1001",
"cutoffTime": "2024-10-04T00:00:00.000000",
"cutoffTimeLocal": "2024-10-04T00:00:00.000000",
"remainingCapacity": 10,
"maximumCapacity": 10,
"minimumOrderValueCents": 1000,
"timezoneId": "America/New_York",
"priceCents": 1000,
"score": 1,
"windowMetadata": {
"key": "value"
}
}
],
"deliveryWindow": {
"id": "dw_01234567890123456789",
"name": "Monday Delivery Window",
"startTime": "2024-01-01T10:00:00Z",
"startTimeLocal": "2024-01-01T10:00:00",
"endTime": "2024-01-01T12:00:00Z",
"endTimeLocal": "2024-01-01T12:00:00",
"timezoneId": "America/New_York",
"cutoffTime": "2024-01-01T10:00:00Z",
"cutoffTimeLocal": "2024-01-01T10:00:00",
"rrule": "RRULE:FREQ=WEEKLY;BYDAY=MO",
"exceptionDates": [
"2024-01-01",
"2024-01-02"
],
"allowedTags": [
"service:rapid",
"service:express",
"franchise_location"
],
"leadTimeMinutes": 60,
"priceCents": 1000,
"minimumOrderValueCents": 1000,
"maximumCapacity": 1000,
"storeLocationId": "stl_01234567890123456789",
"zoneId": "zone_01234567890123456789",
"zoneExternalId": "ext_01234567890123456789",
"windowMetadata": {
"key": "value"
},
"isActive": true,
"isDeleted": false
}
}[
{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"response_status": "<string>",
"RequestID": "<string>"
}
]Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The external id of the order to update
Example:
"1234567890"
Body
application/json
Order unique identifier from an external system.
The full address in one line for the pickup location. Format: [Number] [Street], [second line], [city], [state], [zip code].
Google place id for the pickup location.
The phone number to contact at the pickup location in the form: '+15555555555'
Pickup business name at the origin. Limited to 80 characters.
First name of the person to pickup from. If unknown pass 'Manager'. Limited to 80 characters.
Last name of the person to pickup from. If unknown pass 'Manager'. Limited to 80 characters.
Any special instructions for pickup. Limited to 280 characters.
A unique identifier for store location created in Nash.
The external identifier used for your store.
A list of store location IDs (internal or external) to consider for the Order. The optimal store will be selected and returned in the response in pickupStoreLocationId and/or pickupStoreLocationExternalId.
A list of zone IDs to consider for the Order. The pickup store location will be selected later via selected delivery window.
Array containing barcode values that are required to be scanned at the pickup waypoint.
The email of the contact at the pickup location.
The full address in one line for the dropoff location. Format: [Number] [Street], [second line], [city], [state], [zip code].
Google place id for the dropoff location.
The phone number to contact at the dropoff location in the form: '+15555555555'
Name of the business at the destination. Should be left empty if there is no business. Limited to 80 characters.
First name of the contact at the destination. Limited to 80 characters.
Last name of the contact at the destination. Limited to 80 characters.
Any special instructions for dropoff. Limited to 280 characters.
Array containing barcode values/types that are required to be scanned at the dropoff waypoint.
The email of the contact at the dropoff location.
'now' or 'scheduled' when the delivery should be scheduled
The earliest pickup time in UTC in the form 'YYYY-MM-DDTHH:MM:SSZ'
The latest pickup time in UTC in the form 'YYYY-MM-DDTHH:MM:SSZ'
The earliest dropoff time in UTC in the form 'YYYY-MM-DDTHH:MM:SSZ'
The latest dropoff time in UTC in the form 'YYYY-MM-DDTHH:MM:SSZ'
Specify the delivery window that the customer requested this order to be delivered.
Order description and notes. Limited to 280 characters.
The number of items in this order
Local currency
Order value in cents
Tip paid to the driver in cents
Cash the driver must collect from the recipient on delivery, in cents. Set it to valueCents for a cash-on-delivery order and to 0 for a prepaid one; must not exceed valueCents. Omit when not applicable — providers then treat the order as prepaid. Forwarded to providers that support collect-on-delivery (currently Dash).
Example:
10000
Package requirements.
Detailed description: https://docs.usenash.com/reference/package-requirements.
Available options:
photo_proof_of_delivery, signature_proof_of_delivery, photo_proof_of_pickup, photo_reference_on_dropoff, photo_reference_capture_on_dropoff, signature_proof_of_pickup, photo_pre_delivery_verification, age_verification_on_delivery, id_verification_on_delivery, barcode_scan_on_pickup, barcode_scan_on_dropoff, barcode_scan_on_return, meet_on_delivery, shipping_label, two_person_team, pincode_verification, schedule_ii_controlled_substances, alcohol, tobacco, vapes, parking_check_in, display_barcode_on_pickup, pick_and_pack Example:
[
"photo_proof_of_delivery",
"age_verification_on_delivery"
]
The requested minimum vehicle size. Allowed values: ['any', 'bike', 'motorbike', 'cargobike', 'cargo_bike', 'sedan', 'car', 'suv', 'pickup_truck', 'pickup', 'van', 'large_van', 'extra_large_van', 'truck']
Available options:
any, bike, motorbike, cargobike, cargo_bike, sedan, car, suv, pickup_truck, pickup, van, large_van, extra_large_van, truck Example:
"car"
The dispatch strategy id (or option group id) to be associated with the order.
Note: Best practice is to allow automations to control dispatch strategy and not send the dispatch strategy id in the request.
Key-value data to attach to this order.
Optional order tags, they will be included in every response
A non-unique identifier for orders, visible to the courier if supported by the provider.
The number on a house.
Secondary number on an address e.g. an apartment building.
The street of the address.
The city of the pickup address.
The county associated with the pickup address.
The state of the pickup address.
The zip or postal code of the pickup address.
The ISO 3166-1 alpha-2 country code of the pickup address.
The pickup latitude coordinate.
The pickup longitude coordinate.
The number on a house.
Secondary number on an address e.g. an apartment building.
The street of the address.
The city of the dropoff address.
The county associated with the dropoff address.
The state of the dropoff address.
The zip or postal code of the dropoff address.
The ISO 3166-1 alpha-2 country code of the dropoff address.
The dropoff latitude coordinate.
The dropoff longitude coordinate.
The total weight of the package in kilograms (kg)
Unit for weight: 'kg' or 'lbs'. Defaults to 'kg'. Weight is always stored in kg; a weight provided in 'lbs' is converted on ingest.
The total height of the package in centimeters (cm)
The total width of the package in centimeters (cm)
The total depth of the package in centimeters (cm)
The total volume of the package in cubic centimeters (cm^3)
Unit for height/width/depth and volume: 'cm' or 'in'. Defaults to 'cm'. Dimensions are always stored in cm (cm^3 for volume); values provided in 'in' (cubic inches for volume) are converted on ingest.
Lists of items in the delivery
Show child attributes
Show child attributes
Order-level optimization parameters
Show child attributes
Show child attributes
How the courier should pay for the order at pickup (e.g. a barcode or provider card).
Show child attributes
Show child attributes
If set to true, the order will be re-evaluated with automations.
The maximum delivery fee for the order in cents. This will override the dispatch strategy max delivery fee if both are set.
The earliest delivery windows start time for the range of windows to return, in UTC in the form 'YYYY-MM-DDTHH:MM:SSZ'
The latest delivery windows start time for the range of windows to return, in UTC in the form 'YYYY-MM-DDTHH:MM:SSZ'
The time at which the booked delivery window expires
The amount of capacity to book from the delivery window for this order
Response
OK
The id of the order
Example:
"ord_1234567890"
The date and time when the order was created
Example:
"2023-08-29T19:17:46.264523"
The URL of the order in the Nash portal
Example:
"https://portal.dev.usenash.com/orders/ord_1234567890"
The URL of the order in the public tracking system
Example:
"https://tracking.dev.usenash.com/ord_1234567890"
The status of the order
Example:
"needs_attention"
The tags of the order
Example:
["REST_API"]
The external id of the order
Example:
"1234567890"
The external group id of the order
Example:
"1234567890"
A non-unique identifier for orders, visible to the courier if supported by the provider.
Example:
"1234567890"
Key-value data to attach to Nash Jobs.
Example:
{ "key": "value" }
The pickup address of the order
Example:
"185 University Ave, Palo Alto, CA 94301"
Google place id for the pickup location.
Example:
"ChIJd8BlQJq3t4kRUKhH43CQ"
The number on a house.
Example:
"185"
Secondary number on an address e.g. an apartment building.
The street of the address.
Example:
"University Ave"
The city of the pickup address.
Example:
"Palo Alto"
The county associated with the pickup address.
Example:
"Santa Clara"
The state of the pickup address.
Example:
"CA"
The zip or postal code of the pickup address.
Example:
"94301"
The ISO 3166-1 alpha-2 country code of the pickup address.
Example:
"US"
The pickup latitude coordinate.
Example:
37.422222
The pickup longitude coordinate.
Example:
-122.139776
The phone number to contact at the pickup location in the form: '+15555555555'
Example:
"+15555555555"
The email of the contact at the pickup location.
Example:
"store@example.com"
First name of the person to pickup from. If unknown pass 'Manager'. Limited to 80 characters.
Example:
"Manager"
Last name of the person to pickup from. If unknown pass 'Manager'. Limited to 80 characters.
Example:
"Manager"
Pickup business name at the origin.
Example:
"Store ABC"
Any special instructions for pickup.
Example:
"Leave at the front door"
A unique identifier for store location created in Nash.
Example:
"stl_VwpoPJaaqWiPGnXEhWfX"
The external identifier used for your store.
Example:
"0021112"
A list of zone IDs to consider for the Order. The pickup store location will be selected later via selected delivery window.
Array containing barcode values that are required to be scanned at the pickup waypoint.
Example:
["1234567890", "0987654321"]
How the courier should pay for the order at pickup (e.g. a barcode or provider card).
Show child attributes
Show child attributes
Example:
{
"barcode": { "type": "CODE128", "value": "1234567890" },
"providerCard": false
}
The dropoff address of the order
Example:
"401 San Antonio Rd, Mountain View, CA 94040"
Google place id for the dropoff location.
Example:
"ChIJd8BlQJq3t4kRUKhH43CQ"
The number on a house.
Example:
"401"
Secondary number on an address e.g. an apartment building.
The street of the address.
Example:
"San Antonio Rd"
The city of the dropoff address.
Example:
"Mountain View"
The county associated with the dropoff address.
Example:
"Santa Clara"
The state of the dropoff address.
Example:
"CA"
The zip or postal code of the dropoff address.
Example:
"94040"
The ISO 3166-1 alpha-2 country code of the dropoff address.
Example:
"US"
The dropoff latitude coordinate.
Example:
37.422222
The dropoff longitude coordinate.
Example:
-122.139776
The phone number to contact at the dropoff location in the form: '+15555555555'
Example:
"+15555555556"
The email of the contact at the dropoff location.
Example:
"customer@example.com"
First name of the contact at the destination.
Example:
"Quote"
Last name of the contact at the destination.
Example:
"Request"
Dropoff business name at the destination.
Any special instructions for dropoff.
Example:
"Leave at the front door"
A unique identifier for store location created in Nash.
Array containing barcode values that are required to be scanned at the dropoff waypoint.
The delivery mode of the order
Example:
"scheduled"
The start time of the pickup window.
Example:
"2024-08-22T23:54:08Z"
The end time of the pickup window.
Example:
"2024-08-22T23:54:08Z"
The start time of the dropoff window.
Example:
"2024-08-22T23:54:08Z"
The end time of the dropoff window.
Example:
"2024-08-22T23:54:08Z"
The description of the order
Example:
"Order description"
The number of items in the order
Example:
"1"
The requirements of the order
Example:
["photo_proof_of_delivery"]
The requested minimum vehicle size. Allowed values: ['any', 'bike', 'motorbike', 'cargobike', 'cargo_bike', 'sedan', 'car', 'suv', 'pickup_truck', 'pickup', 'van', 'large_van', 'extra_large_van', 'truck']
Available options:
any, bike, motorbike, cargobike, cargo_bike, sedan, car, suv, pickup_truck, pickup, van, large_van, extra_large_van, truck Example:
"car"
The currency of the order
Example:
"USD"
The value of the order in cents
Example:
"10000"
The tip amount of the order in cents
Example:
"1000"
Cash the driver must collect from the recipient on delivery, in cents. Null when not specified.
Example:
"10000"
The width of the order in cm
Example:
"100"
The depth of the order in cm
Example:
"100"
The height of the order in cm
Example:
"100"
The volume of the order in cm^3
The weight of the order in kg
Example:
"100"
The items of the order
Show child attributes
Show child attributes
The dispatch strategy id (or option group id) to be associated with the order. Note: It is the best practice to allow automations to control dispatch strategy and not send the dispatch strategy id in the request.
Example:
"dss_1234567890"
The max delivery fee of the order in cents
Example:
"1000"
The documents of the order
Show child attributes
Show child attributes
Example:
[
{
"contentType": "application/pdf",
"data": "SGVsbG8gd29ybGQ=",
"id": "doc_1234567890",
"type": "shipping_label",
"url": "https://example.com/document.pdf"
}
]
The validation errors of the order
Show child attributes
Show child attributes
Example:
{ "pickupStartTime": "Time is in the past" }
The quotes of the order
Show child attributes
Show child attributes
Example:
[
{
"costSplitBusinessCents": null,
"costSplitCustomerCents": null,
"createdTime": "2024-09-03T20:43:45.899094",
"currency": "USD",
"dropoffEta": "2024-09-03T22:20:47.569000",
"expireTime": "2024-09-03T21:43:45.899102",
"id": "qot_2oWASjGxMtucwGgu6A7BYC",
"insuranceFeeCents": 0,
"nashFeeCents": 300,
"pickupWindow": null,
"priceCents": 100,
"providerId": "dispatch_partner",
"providerIsInternal": false,
"providerLogo": "https://nash-provider-logos.s3.amazonaws.com/dispatchit-logo.jpg",
"providerName": "Dispatch",
"tags": null,
"taxAmountCents": null,
"tollFeeCents": 0,
"totalPriceBreakdown": { "priceCents": 100 },
"totalPriceCents": 100,
"type": "LOCAL"
}
]
The failed quotes of the order
Example:
["quote_1234567890", "quote_0987654321"]
Summary when every provider rejects the package requirements
The delivery window id that the end customer requested this order to be delivered in.
The status of the delivery window (e.g. booked, confirmed).
The delivery window expiration time of the booking.
The requested capacity of the Order to be deducted from the delivery window.
The eligible delivery windows that the customers can choose from for this order.
Show child attributes
Show child attributes
The ineligible delivery windows for the order.
Show child attributes
Show child attributes
The delivery window object
Show child attributes
Show child attributes
Was this page helpful?