Fulfillment orders
When Digital River coordinates an order's physical fulfillment, the Fulfillment Orders API manages the process.
Get all Fulfillment orders.
A cursor for use in pagination. The endingBefore parameter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with xyz your subsequent calls can include endingBefore=xyz in order to fetch the previous page of the list.
A cursor for use in pagination. The startingAfter parameter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with xyz, your subsequent calls can include startingAfter=xyz in order to fetch the next page of the list.
A limit on the number of objects returned. Limit can range between 1 and 100, and the default is 10.
Only return objects with these IDs.
Only return objects with these upstreamIds.
200 OK
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
405 Method Not Allowed
406 Not Acceptable
408 Request Timeout
429 Too Many Requests
500 Internal Server Error
502 Bad Gateway Error
503 Service Unavailable Error
504 Gateway Timeout Error
GET /fulfillment-orders HTTP/1.1
Host: api.digitalriver.com
Accept: */*
{
"data": [
{
"id": 9292981838,
"createdTime": {
"offset": {
"totalSeconds": 0,
"id": "Z",
"rules": {
"fixedOffset": true,
"transitions": [],
"transitionRules": []
}
},
"nano": 0,
"year": 2018,
"monthValue": 4,
"dayOfMonth": 25,
"hour": 20,
"minute": 36,
"second": 0,
"dayOfWeek": "WEDNESDAY",
"dayOfYear": 115,
"month": "APRIL"
},
"currency": "USD",
"locale": "en_US",
"upstreamOrderTime": {
"offset": {
"totalSeconds": 0,
"id": "Z",
"rules": {
"fixedOffset": true,
"transitions": [],
"transitionRules": []
}
},
"nano": 0,
"year": 2018,
"monthValue": 4,
"dayOfMonth": 25,
"hour": 20,
"minute": 36,
"second": 0,
"dayOfWeek": "WEDNESDAY",
"dayOfYear": 115,
"month": "APRIL"
},
"name": "John Smith",
"email": "[email protected]",
"phone": "612-258-1966",
"reservationId": "7765374748",
"upstreamId": "7765374748",
"shipTo": {
"address": {
"line1": "10380 Bren Rd W",
"line2": "text",
"city": "Minnetonka",
"postalCode": "55129",
"state": "MN",
"country": "US"
},
"name": "John Smith",
"phone": "952-111-1111",
"email": "[email protected]",
"organization": "Digital River",
"additionalAddressInfo": {
"neighborhood": "Centro",
"division": "???",
"phoneticName": "??? ??"
}
},
"shippingChoice": {
"shippingInstructions": ".",
"dutiesPaid": false,
"id": "SG",
"signatureRequiredType": "standard"
},
"items": [
[
{
"id": "449838789",
"upstreamId": "123",
"inventoryItemId": "abc",
"name": ".",
"quantity": 1
}
]
],
"state": "pending",
"liveMode": false
}
]
}
Creates a new Fulfillment order.
Athree-letter ISO currency code.
USD
A locale designator that combines a two-letter ISO 639-1 language code with a ISO 3166-1 alpha-2 country code.
en_US
The time at which the upstream order was created.
{"offset":{"totalSeconds":0,"id":"Z","rules":{"fixedOffset":true,"transitions":[],"transitionRules":[]}},"nano":0,"year":2018,"monthValue":4,"dayOfMonth":25,"hour":20,"minute":36,"second":0,"dayOfWeek":"WEDNESDAY","dayOfYear":115,"month":"APRIL"}
The customer's name.
John Smith
The customer's phone number.
612-258-1966
An inventory reservation identifier.
7765374748
The upstream order identifier.
7765374748
201 Created
400 Bad Request
401 Unauthorized
403 Forbidden
405 Method Not Allowed
406 Not Acceptable
408 Request Timeout
409 Conflict
429 Too Many Requests
500 Internal Server Error
502 Bad Gateway Error
503 Service Unavailable Error
504 Gateway Timeout Error
POST /fulfillment-orders HTTP/1.1
Host: api.digitalriver.com
Content-Type: application/json
Accept: */*
Content-Length: 957
{
"currency": "USD",
"locale": "en_US",
"upstreamOrderTime": {
"offset": {
"totalSeconds": 0,
"id": "Z",
"rules": {
"fixedOffset": true,
"transitions": [],
"transitionRules": []
}
},
"nano": 0,
"year": 2018,
"monthValue": 4,
"dayOfMonth": 25,
"hour": 20,
"minute": 36,
"second": 0,
"dayOfWeek": "WEDNESDAY",
"dayOfYear": 115,
"month": "APRIL"
},
"name": "John Smith",
"email": "[email protected]",
"phone": "612-258-1966",
"reservationId": "7765374748",
"upstreamId": "7765374748",
"shipTo": {
"address": {
"line1": "10380 Bren Rd W",
"line2": "text",
"city": "Minnetonka",
"postalCode": "55129",
"state": "MN",
"country": "US"
},
"name": "John Smith",
"phone": "952-111-1111",
"email": "[email protected]",
"organization": "Digital River",
"additionalAddressInfo": {
"neighborhood": "Centro",
"division": "???",
"phoneticName": "??? ??"
}
},
"shippingChoice": {
"shippingInstructions": ".",
"dutiesPaid": false,
"id": "SG",
"signatureRequiredType": "standard"
},
"items": [
[
{
"upstreamId": "123",
"inventoryItemId": "abc",
"name": ".",
"quantity": 1
}
]
]
}
{
"id": 9292981838,
"createdTime": {
"offset": {
"totalSeconds": 0,
"id": "Z",
"rules": {
"fixedOffset": true,
"transitions": [],
"transitionRules": []
}
},
"nano": 0,
"year": 2018,
"monthValue": 4,
"dayOfMonth": 25,
"hour": 20,
"minute": 36,
"second": 0,
"dayOfWeek": "WEDNESDAY",
"dayOfYear": 115,
"month": "APRIL"
},
"currency": "USD",
"locale": "en_US",
"upstreamOrderTime": {
"offset": {
"totalSeconds": 0,
"id": "Z",
"rules": {
"fixedOffset": true,
"transitions": [],
"transitionRules": []
}
},
"nano": 0,
"year": 2018,
"monthValue": 4,
"dayOfMonth": 25,
"hour": 20,
"minute": 36,
"second": 0,
"dayOfWeek": "WEDNESDAY",
"dayOfYear": 115,
"month": "APRIL"
},
"name": "John Smith",
"email": "[email protected]",
"phone": "612-258-1966",
"reservationId": "7765374748",
"upstreamId": "7765374748",
"shipTo": {
"address": {
"line1": "10380 Bren Rd W",
"line2": "text",
"city": "Minnetonka",
"postalCode": "55129",
"state": "MN",
"country": "US"
},
"name": "John Smith",
"phone": "952-111-1111",
"email": "[email protected]",
"organization": "Digital River",
"additionalAddressInfo": {
"neighborhood": "Centro",
"division": "???",
"phoneticName": "??? ??"
}
},
"shippingChoice": {
"shippingInstructions": ".",
"dutiesPaid": false,
"id": "SG",
"signatureRequiredType": "standard"
},
"items": [
[
{
"id": "449838789",
"upstreamId": "123",
"inventoryItemId": "abc",
"name": ".",
"quantity": 1
}
]
],
"state": "pending",
"liveMode": false
}
Retrieves the details of a Fulfillment order. You must supply the unique identifier of the Fulfillment order.
Fulfillment order identifier.
OK.
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
405 Method Not Allowed
406 Not Acceptable
408 Request Timeout
429 Too Many Requests
500 Internal Server Error
502 Bad Gateway Error
503 Service Unavailable Error
504 Gateway Timeout Error
GET /fulfillment-orders/{id} HTTP/1.1
Host: api.digitalriver.com
Accept: */*
{
"id": 9292981838,
"createdTime": {
"offset": {
"totalSeconds": 0,
"id": "Z",
"rules": {
"fixedOffset": true,
"transitions": [],
"transitionRules": []
}
},
"nano": 0,
"year": 2018,
"monthValue": 4,
"dayOfMonth": 25,
"hour": 20,
"minute": 36,
"second": 0,
"dayOfWeek": "WEDNESDAY",
"dayOfYear": 115,
"month": "APRIL"
},
"currency": "USD",
"locale": "en_US",
"upstreamOrderTime": {
"offset": {
"totalSeconds": 0,
"id": "Z",
"rules": {
"fixedOffset": true,
"transitions": [],
"transitionRules": []
}
},
"nano": 0,
"year": 2018,
"monthValue": 4,
"dayOfMonth": 25,
"hour": 20,
"minute": 36,
"second": 0,
"dayOfWeek": "WEDNESDAY",
"dayOfYear": 115,
"month": "APRIL"
},
"name": "John Smith",
"email": "[email protected]",
"phone": "612-258-1966",
"reservationId": "7765374748",
"upstreamId": "7765374748",
"shipTo": {
"address": {
"line1": "10380 Bren Rd W",
"line2": "text",
"city": "Minnetonka",
"postalCode": "55129",
"state": "MN",
"country": "US"
},
"name": "John Smith",
"phone": "952-111-1111",
"email": "[email protected]",
"organization": "Digital River",
"additionalAddressInfo": {
"neighborhood": "Centro",
"division": "???",
"phoneticName": "??? ??"
}
},
"shippingChoice": {
"shippingInstructions": ".",
"dutiesPaid": false,
"id": "SG",
"signatureRequiredType": "standard"
},
"items": [
[
{
"id": "449838789",
"upstreamId": "123",
"inventoryItemId": "abc",
"name": ".",
"quantity": 1
}
]
],
"state": "pending",
"liveMode": false
}
Last updated