FulfillmentRequest
Version 2020-01
The FulfillmentRequest resource represents a fulfillment request made by the merchant to a fulfillment service for a fulfillment order.
What you can do with FulfillmentRequest
The Shopify API lets you do the following with the FulfillmentRequest resource. More detailed versions of these general actions may be available:
- POST /admin/api/2020-01/fulfillment_orders/{fulfillment_order_id}/fulfillment_request.json Sends a fulfillment request
- POST /admin/api/2020-01/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/accept.json Accepts a fulfillment request
- POST /admin/api/2020-01/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/reject.json Rejects a fulfillment request
Endpoints
POST
/admin/api/2020-01/fulfillment_orders/{fulfillment_order_id}/fulfillment_request.json
Sends a fulfillment request to the fulfillment service of a fulfillment order.
| message
|
An optional message for the fulfillment request. |
| fulfillment_order_line_items
|
The fulfillment order line items to be requested for fulfillment. If left blank, all line items of the fulfillment order are requested for fulfillment. |
Sends a fulfillment request to the fulfillment service of a fulfillment order for the specified line items
POST /admin/api/2020-07/fulfillment_orders/1046000779/fulfillment_request.json
{
"fulfillment_request": {
"message": "Fulfill this ASAP please.",
"fulfillment_order_line_items": [
{
"id": 1025578625,
"quantity": 1
},
{
"id": 1025578626,
"quantity": 1
}
]
}
}
View Response
HTTP/1.1 200 OK
{
"original_fulfillment_order": {
"id": 1046000779,
"shop_id": 690933842,
"order_id": 1073459966,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "unsubmitted",
"status": "closed",
"supported_actions": [],
"destination": {
"id": 1025578621,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578625,
"shop_id": 690933842,
"fulfillment_order_id": 1046000779,
"quantity": 1,
"line_item_id": 1071823180,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578626,
"shop_id": 690933842,
"fulfillment_order_id": 1046000779,
"quantity": 1,
"line_item_id": 1071823181,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578627,
"shop_id": 690933842,
"fulfillment_order_id": 1046000779,
"quantity": 1,
"line_item_id": 1071823182,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": []
},
"submitted_fulfillment_order": {
"id": 1046000780,
"shop_id": 690933842,
"order_id": 1073459966,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "submitted",
"status": "open",
"supported_actions": [
"cancel_fulfillment_order"
],
"destination": {
"id": 1025578622,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578628,
"shop_id": 690933842,
"fulfillment_order_id": 1046000780,
"quantity": 1,
"line_item_id": 1071823180,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578629,
"shop_id": 690933842,
"fulfillment_order_id": 1046000780,
"quantity": 1,
"line_item_id": 1071823181,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
}
],
"outgoing_requests": [
{
"message": "Fulfill this ASAP please.",
"request_options": {
"notify_customer": false
},
"sent_at": "2020-09-08T13:12:00-04:00",
"kind": "fulfillment_request"
}
]
},
"unsubmitted_fulfillment_order": {
"id": 1046000781,
"shop_id": 690933842,
"order_id": 1073459966,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "unsubmitted",
"status": "open",
"supported_actions": [
"request_fulfillment",
"create_fulfillment"
],
"destination": {
"id": 1025578623,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578630,
"shop_id": 690933842,
"fulfillment_order_id": 1046000781,
"quantity": 1,
"line_item_id": 1071823182,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": []
}
}
Sends a fulfillment request to the fulfillment service for all line items on the fulfillment order if fulfillment_order_line_items is left blank
POST /admin/api/2020-07/fulfillment_orders/1046000782/fulfillment_request.json
{
"fulfillment_request": {
"message": "Fulfill this ASAP please."
}
}
View Response
HTTP/1.1 200 OK
{
"original_fulfillment_order": {
"id": 1046000782,
"shop_id": 690933842,
"order_id": 1073459967,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "submitted",
"status": "open",
"supported_actions": [
"cancel_fulfillment_order"
],
"destination": {
"id": 1025578624,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578631,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823183,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578632,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823184,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578633,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823185,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": [
{
"message": "Fulfill this ASAP please.",
"request_options": {
"notify_customer": false
},
"sent_at": "2020-09-08T13:12:03-04:00",
"kind": "fulfillment_request"
}
]
},
"submitted_fulfillment_order": {
"id": 1046000782,
"shop_id": 690933842,
"order_id": 1073459967,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "submitted",
"status": "open",
"supported_actions": [
"cancel_fulfillment_order"
],
"destination": {
"id": 1025578624,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578631,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823183,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578632,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823184,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578633,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823185,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": [
{
"message": "Fulfill this ASAP please.",
"request_options": {
"notify_customer": false
},
"sent_at": "2020-09-08T13:12:03-04:00",
"kind": "fulfillment_request"
}
]
},
"unsubmitted_fulfillment_order": null
}
POST
/admin/api/2020-01/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/accept.json
Accepts a fulfillment request sent to a fulfillment service for a fulfillment order.
| message
|
An optional reason for accepting the fulfillment request. |
Accepts a fulfillment request sent to a fulfillment service and updates the fulfillment order
POST /admin/api/2020-07/fulfillment_orders/1046000777/fulfillment_request/accept.json
{
"fulfillment_request": {
"message": "We will start processing your fulfillment on the next business day."
}
}
View Response
HTTP/1.1 200 OK
{
"fulfillment_order": {
"id": 1046000777,
"shop_id": 690933842,
"order_id": 1073459964,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "accepted",
"status": "in_progress",
"supported_actions": [
"request_cancellation",
"create_fulfillment"
],
"destination": {
"id": 1025578619,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578619,
"shop_id": 690933842,
"fulfillment_order_id": 1046000777,
"quantity": 1,
"line_item_id": 1071823174,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578620,
"shop_id": 690933842,
"fulfillment_order_id": 1046000777,
"quantity": 1,
"line_item_id": 1071823175,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578621,
"shop_id": 690933842,
"fulfillment_order_id": 1046000777,
"quantity": 1,
"line_item_id": 1071823176,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": []
}
}
POST
/admin/api/2020-01/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/reject.json
Rejects a fulfillment request sent to a fulfillment service for a fulfillment order.
| message
|
An optional reason for rejecting the fulfillment request. |
Rejects a fulfillment request sent to a fulfillment service and updates the fulfillment order
POST /admin/api/2020-07/fulfillment_orders/1046000778/fulfillment_request/reject.json
{
"fulfillment_request": {
"message": "Not enough inventory on hand to complete the work."
}
}
View Response
HTTP/1.1 200 OK
{
"fulfillment_order": {
"id": 1046000778,
"shop_id": 690933842,
"order_id": 1073459965,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "rejected",
"status": "open",
"supported_actions": [
"request_fulfillment",
"create_fulfillment"
],
"destination": {
"id": 1025578620,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578622,
"shop_id": 690933842,
"fulfillment_order_id": 1046000778,
"quantity": 1,
"line_item_id": 1071823177,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578623,
"shop_id": 690933842,
"fulfillment_order_id": 1046000778,
"quantity": 1,
"line_item_id": 1071823178,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578624,
"shop_id": 690933842,
"fulfillment_order_id": 1046000778,
"quantity": 1,
"line_item_id": 1071823179,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": []
}
}
Version 2020-04
The FulfillmentRequest resource represents a fulfillment request made by the merchant to a fulfillment service for a fulfillment order.
What you can do with FulfillmentRequest
The Shopify API lets you do the following with the FulfillmentRequest resource. More detailed versions of these general actions may be available:
- POST /admin/api/2020-04/fulfillment_orders/{fulfillment_order_id}/fulfillment_request.json Sends a fulfillment request
- POST /admin/api/2020-04/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/accept.json Accepts a fulfillment request
- POST /admin/api/2020-04/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/reject.json Rejects a fulfillment request
Endpoints
POST
/admin/api/2020-04/fulfillment_orders/{fulfillment_order_id}/fulfillment_request.json
Sends a fulfillment request to the fulfillment service of a fulfillment order.
| message
|
An optional message for the fulfillment request. |
| fulfillment_order_line_items
|
The fulfillment order line items to be requested for fulfillment. If left blank, all line items of the fulfillment order are requested for fulfillment. |
Sends a fulfillment request to the fulfillment service of a fulfillment order for the specified line items
POST /admin/api/2020-07/fulfillment_orders/1046000779/fulfillment_request.json
{
"fulfillment_request": {
"message": "Fulfill this ASAP please.",
"fulfillment_order_line_items": [
{
"id": 1025578625,
"quantity": 1
},
{
"id": 1025578626,
"quantity": 1
}
]
}
}
View Response
HTTP/1.1 200 OK
{
"original_fulfillment_order": {
"id": 1046000779,
"shop_id": 690933842,
"order_id": 1073459966,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "unsubmitted",
"status": "closed",
"supported_actions": [],
"destination": {
"id": 1025578621,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578625,
"shop_id": 690933842,
"fulfillment_order_id": 1046000779,
"quantity": 1,
"line_item_id": 1071823180,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578626,
"shop_id": 690933842,
"fulfillment_order_id": 1046000779,
"quantity": 1,
"line_item_id": 1071823181,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578627,
"shop_id": 690933842,
"fulfillment_order_id": 1046000779,
"quantity": 1,
"line_item_id": 1071823182,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": []
},
"submitted_fulfillment_order": {
"id": 1046000780,
"shop_id": 690933842,
"order_id": 1073459966,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "submitted",
"status": "open",
"supported_actions": [
"cancel_fulfillment_order"
],
"destination": {
"id": 1025578622,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578628,
"shop_id": 690933842,
"fulfillment_order_id": 1046000780,
"quantity": 1,
"line_item_id": 1071823180,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578629,
"shop_id": 690933842,
"fulfillment_order_id": 1046000780,
"quantity": 1,
"line_item_id": 1071823181,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
}
],
"outgoing_requests": [
{
"message": "Fulfill this ASAP please.",
"request_options": {
"notify_customer": false
},
"sent_at": "2020-09-08T13:12:00-04:00",
"kind": "fulfillment_request"
}
]
},
"unsubmitted_fulfillment_order": {
"id": 1046000781,
"shop_id": 690933842,
"order_id": 1073459966,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "unsubmitted",
"status": "open",
"supported_actions": [
"request_fulfillment",
"create_fulfillment"
],
"destination": {
"id": 1025578623,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578630,
"shop_id": 690933842,
"fulfillment_order_id": 1046000781,
"quantity": 1,
"line_item_id": 1071823182,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": []
}
}
Sends a fulfillment request to the fulfillment service for all line items on the fulfillment order if fulfillment_order_line_items is left blank
POST /admin/api/2020-07/fulfillment_orders/1046000782/fulfillment_request.json
{
"fulfillment_request": {
"message": "Fulfill this ASAP please."
}
}
View Response
HTTP/1.1 200 OK
{
"original_fulfillment_order": {
"id": 1046000782,
"shop_id": 690933842,
"order_id": 1073459967,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "submitted",
"status": "open",
"supported_actions": [
"cancel_fulfillment_order"
],
"destination": {
"id": 1025578624,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578631,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823183,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578632,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823184,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578633,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823185,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": [
{
"message": "Fulfill this ASAP please.",
"request_options": {
"notify_customer": false
},
"sent_at": "2020-09-08T13:12:03-04:00",
"kind": "fulfillment_request"
}
]
},
"submitted_fulfillment_order": {
"id": 1046000782,
"shop_id": 690933842,
"order_id": 1073459967,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "submitted",
"status": "open",
"supported_actions": [
"cancel_fulfillment_order"
],
"destination": {
"id": 1025578624,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578631,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823183,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578632,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823184,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578633,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823185,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": [
{
"message": "Fulfill this ASAP please.",
"request_options": {
"notify_customer": false
},
"sent_at": "2020-09-08T13:12:03-04:00",
"kind": "fulfillment_request"
}
]
},
"unsubmitted_fulfillment_order": null
}
POST
/admin/api/2020-04/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/accept.json
Accepts a fulfillment request sent to a fulfillment service for a fulfillment order.
| message
|
An optional reason for accepting the fulfillment request. |
Accepts a fulfillment request sent to a fulfillment service and updates the fulfillment order
POST /admin/api/2020-07/fulfillment_orders/1046000777/fulfillment_request/accept.json
{
"fulfillment_request": {
"message": "We will start processing your fulfillment on the next business day."
}
}
View Response
HTTP/1.1 200 OK
{
"fulfillment_order": {
"id": 1046000777,
"shop_id": 690933842,
"order_id": 1073459964,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "accepted",
"status": "in_progress",
"supported_actions": [
"request_cancellation",
"create_fulfillment"
],
"destination": {
"id": 1025578619,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578619,
"shop_id": 690933842,
"fulfillment_order_id": 1046000777,
"quantity": 1,
"line_item_id": 1071823174,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578620,
"shop_id": 690933842,
"fulfillment_order_id": 1046000777,
"quantity": 1,
"line_item_id": 1071823175,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578621,
"shop_id": 690933842,
"fulfillment_order_id": 1046000777,
"quantity": 1,
"line_item_id": 1071823176,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": []
}
}
POST
/admin/api/2020-04/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/reject.json
Rejects a fulfillment request sent to a fulfillment service for a fulfillment order.
| message
|
An optional reason for rejecting the fulfillment request. |
Rejects a fulfillment request sent to a fulfillment service and updates the fulfillment order
POST /admin/api/2020-07/fulfillment_orders/1046000778/fulfillment_request/reject.json
{
"fulfillment_request": {
"message": "Not enough inventory on hand to complete the work."
}
}
View Response
HTTP/1.1 200 OK
{
"fulfillment_order": {
"id": 1046000778,
"shop_id": 690933842,
"order_id": 1073459965,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "rejected",
"status": "open",
"supported_actions": [
"request_fulfillment",
"create_fulfillment"
],
"destination": {
"id": 1025578620,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578622,
"shop_id": 690933842,
"fulfillment_order_id": 1046000778,
"quantity": 1,
"line_item_id": 1071823177,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578623,
"shop_id": 690933842,
"fulfillment_order_id": 1046000778,
"quantity": 1,
"line_item_id": 1071823178,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578624,
"shop_id": 690933842,
"fulfillment_order_id": 1046000778,
"quantity": 1,
"line_item_id": 1071823179,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": []
}
}
Version 2020-07
(Latest)
The FulfillmentRequest resource represents a fulfillment request made by the merchant to a fulfillment service for a fulfillment order.
What you can do with FulfillmentRequest
The Shopify API lets you do the following with the FulfillmentRequest resource. More detailed versions of these general actions may be available:
- POST /admin/api/2020-07/fulfillment_orders/{fulfillment_order_id}/fulfillment_request.json Sends a fulfillment request
- POST /admin/api/2020-07/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/accept.json Accepts a fulfillment request
- POST /admin/api/2020-07/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/reject.json Rejects a fulfillment request
Endpoints
POST
/admin/api/2020-07/fulfillment_orders/{fulfillment_order_id}/fulfillment_request.json
Sends a fulfillment request to the fulfillment service of a fulfillment order.
| message
|
An optional message for the fulfillment request. |
| fulfillment_order_line_items
|
The fulfillment order line items to be requested for fulfillment. If left blank, all line items of the fulfillment order are requested for fulfillment. |
Sends a fulfillment request to the fulfillment service of a fulfillment order for the specified line items
POST /admin/api/2020-07/fulfillment_orders/1046000779/fulfillment_request.json
{
"fulfillment_request": {
"message": "Fulfill this ASAP please.",
"fulfillment_order_line_items": [
{
"id": 1025578625,
"quantity": 1
},
{
"id": 1025578626,
"quantity": 1
}
]
}
}
View Response
HTTP/1.1 200 OK
{
"original_fulfillment_order": {
"id": 1046000779,
"shop_id": 690933842,
"order_id": 1073459966,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "unsubmitted",
"status": "closed",
"supported_actions": [],
"destination": {
"id": 1025578621,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578625,
"shop_id": 690933842,
"fulfillment_order_id": 1046000779,
"quantity": 1,
"line_item_id": 1071823180,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578626,
"shop_id": 690933842,
"fulfillment_order_id": 1046000779,
"quantity": 1,
"line_item_id": 1071823181,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578627,
"shop_id": 690933842,
"fulfillment_order_id": 1046000779,
"quantity": 1,
"line_item_id": 1071823182,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": []
},
"submitted_fulfillment_order": {
"id": 1046000780,
"shop_id": 690933842,
"order_id": 1073459966,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "submitted",
"status": "open",
"supported_actions": [
"cancel_fulfillment_order"
],
"destination": {
"id": 1025578622,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578628,
"shop_id": 690933842,
"fulfillment_order_id": 1046000780,
"quantity": 1,
"line_item_id": 1071823180,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578629,
"shop_id": 690933842,
"fulfillment_order_id": 1046000780,
"quantity": 1,
"line_item_id": 1071823181,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
}
],
"outgoing_requests": [
{
"message": "Fulfill this ASAP please.",
"request_options": {
"notify_customer": false
},
"sent_at": "2020-09-08T13:12:00-04:00",
"kind": "fulfillment_request"
}
]
},
"unsubmitted_fulfillment_order": {
"id": 1046000781,
"shop_id": 690933842,
"order_id": 1073459966,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "unsubmitted",
"status": "open",
"supported_actions": [
"request_fulfillment",
"create_fulfillment"
],
"destination": {
"id": 1025578623,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578630,
"shop_id": 690933842,
"fulfillment_order_id": 1046000781,
"quantity": 1,
"line_item_id": 1071823182,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": []
}
}
Sends a fulfillment request to the fulfillment service for all line items on the fulfillment order if fulfillment_order_line_items is left blank
POST /admin/api/2020-07/fulfillment_orders/1046000782/fulfillment_request.json
{
"fulfillment_request": {
"message": "Fulfill this ASAP please."
}
}
View Response
HTTP/1.1 200 OK
{
"original_fulfillment_order": {
"id": 1046000782,
"shop_id": 690933842,
"order_id": 1073459967,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "submitted",
"status": "open",
"supported_actions": [
"cancel_fulfillment_order"
],
"destination": {
"id": 1025578624,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578631,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823183,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578632,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823184,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578633,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823185,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": [
{
"message": "Fulfill this ASAP please.",
"request_options": {
"notify_customer": false
},
"sent_at": "2020-09-08T13:12:03-04:00",
"kind": "fulfillment_request"
}
]
},
"submitted_fulfillment_order": {
"id": 1046000782,
"shop_id": 690933842,
"order_id": 1073459967,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "submitted",
"status": "open",
"supported_actions": [
"cancel_fulfillment_order"
],
"destination": {
"id": 1025578624,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578631,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823183,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578632,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823184,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578633,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823185,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": [
{
"message": "Fulfill this ASAP please.",
"request_options": {
"notify_customer": false
},
"sent_at": "2020-09-08T13:12:03-04:00",
"kind": "fulfillment_request"
}
]
},
"unsubmitted_fulfillment_order": null
}
POST
/admin/api/2020-07/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/accept.json
Accepts a fulfillment request sent to a fulfillment service for a fulfillment order.
| message
|
An optional reason for accepting the fulfillment request. |
Accepts a fulfillment request sent to a fulfillment service and updates the fulfillment order
POST /admin/api/2020-07/fulfillment_orders/1046000777/fulfillment_request/accept.json
{
"fulfillment_request": {
"message": "We will start processing your fulfillment on the next business day."
}
}
View Response
HTTP/1.1 200 OK
{
"fulfillment_order": {
"id": 1046000777,
"shop_id": 690933842,
"order_id": 1073459964,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "accepted",
"status": "in_progress",
"supported_actions": [
"request_cancellation",
"create_fulfillment"
],
"destination": {
"id": 1025578619,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578619,
"shop_id": 690933842,
"fulfillment_order_id": 1046000777,
"quantity": 1,
"line_item_id": 1071823174,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578620,
"shop_id": 690933842,
"fulfillment_order_id": 1046000777,
"quantity": 1,
"line_item_id": 1071823175,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578621,
"shop_id": 690933842,
"fulfillment_order_id": 1046000777,
"quantity": 1,
"line_item_id": 1071823176,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": []
}
}
POST
/admin/api/2020-07/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/reject.json
Rejects a fulfillment request sent to a fulfillment service for a fulfillment order.
| message
|
An optional reason for rejecting the fulfillment request. |
Rejects a fulfillment request sent to a fulfillment service and updates the fulfillment order
POST /admin/api/2020-07/fulfillment_orders/1046000778/fulfillment_request/reject.json
{
"fulfillment_request": {
"message": "Not enough inventory on hand to complete the work."
}
}
View Response
HTTP/1.1 200 OK
{
"fulfillment_order": {
"id": 1046000778,
"shop_id": 690933842,
"order_id": 1073459965,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "rejected",
"status": "open",
"supported_actions": [
"request_fulfillment",
"create_fulfillment"
],
"destination": {
"id": 1025578620,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578622,
"shop_id": 690933842,
"fulfillment_order_id": 1046000778,
"quantity": 1,
"line_item_id": 1071823177,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578623,
"shop_id": 690933842,
"fulfillment_order_id": 1046000778,
"quantity": 1,
"line_item_id": 1071823178,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578624,
"shop_id": 690933842,
"fulfillment_order_id": 1046000778,
"quantity": 1,
"line_item_id": 1071823179,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": []
}
}
Version 2020-10
(Release candidate)
The FulfillmentRequest resource represents a fulfillment request made by the merchant to a fulfillment service for a fulfillment order.
What you can do with FulfillmentRequest
The Shopify API lets you do the following with the FulfillmentRequest resource. More detailed versions of these general actions may be available:
- POST /admin/api/2020-10/fulfillment_orders/{fulfillment_order_id}/fulfillment_request.json Sends a fulfillment request
- POST /admin/api/2020-10/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/accept.json Accepts a fulfillment request
- POST /admin/api/2020-10/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/reject.json Rejects a fulfillment request
Endpoints
POST
/admin/api/2020-10/fulfillment_orders/{fulfillment_order_id}/fulfillment_request.json
Sends a fulfillment request to the fulfillment service of a fulfillment order.
| message
|
An optional message for the fulfillment request. |
| fulfillment_order_line_items
|
The fulfillment order line items to be requested for fulfillment. If left blank, all line items of the fulfillment order are requested for fulfillment. |
Sends a fulfillment request to the fulfillment service of a fulfillment order for the specified line items
POST /admin/api/2020-07/fulfillment_orders/1046000779/fulfillment_request.json
{
"fulfillment_request": {
"message": "Fulfill this ASAP please.",
"fulfillment_order_line_items": [
{
"id": 1025578625,
"quantity": 1
},
{
"id": 1025578626,
"quantity": 1
}
]
}
}
View Response
HTTP/1.1 200 OK
{
"original_fulfillment_order": {
"id": 1046000779,
"shop_id": 690933842,
"order_id": 1073459966,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "unsubmitted",
"status": "closed",
"supported_actions": [],
"destination": {
"id": 1025578621,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578625,
"shop_id": 690933842,
"fulfillment_order_id": 1046000779,
"quantity": 1,
"line_item_id": 1071823180,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578626,
"shop_id": 690933842,
"fulfillment_order_id": 1046000779,
"quantity": 1,
"line_item_id": 1071823181,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578627,
"shop_id": 690933842,
"fulfillment_order_id": 1046000779,
"quantity": 1,
"line_item_id": 1071823182,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": []
},
"submitted_fulfillment_order": {
"id": 1046000780,
"shop_id": 690933842,
"order_id": 1073459966,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "submitted",
"status": "open",
"supported_actions": [
"cancel_fulfillment_order"
],
"destination": {
"id": 1025578622,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578628,
"shop_id": 690933842,
"fulfillment_order_id": 1046000780,
"quantity": 1,
"line_item_id": 1071823180,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578629,
"shop_id": 690933842,
"fulfillment_order_id": 1046000780,
"quantity": 1,
"line_item_id": 1071823181,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
}
],
"outgoing_requests": [
{
"message": "Fulfill this ASAP please.",
"request_options": {
"notify_customer": false
},
"sent_at": "2020-09-08T13:12:00-04:00",
"kind": "fulfillment_request"
}
]
},
"unsubmitted_fulfillment_order": {
"id": 1046000781,
"shop_id": 690933842,
"order_id": 1073459966,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "unsubmitted",
"status": "open",
"supported_actions": [
"request_fulfillment",
"create_fulfillment"
],
"destination": {
"id": 1025578623,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578630,
"shop_id": 690933842,
"fulfillment_order_id": 1046000781,
"quantity": 1,
"line_item_id": 1071823182,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": []
}
}
Sends a fulfillment request to the fulfillment service for all line items on the fulfillment order if fulfillment_order_line_items is left blank
POST /admin/api/2020-07/fulfillment_orders/1046000782/fulfillment_request.json
{
"fulfillment_request": {
"message": "Fulfill this ASAP please."
}
}
View Response
HTTP/1.1 200 OK
{
"original_fulfillment_order": {
"id": 1046000782,
"shop_id": 690933842,
"order_id": 1073459967,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "submitted",
"status": "open",
"supported_actions": [
"cancel_fulfillment_order"
],
"destination": {
"id": 1025578624,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578631,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823183,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578632,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823184,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578633,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823185,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": [
{
"message": "Fulfill this ASAP please.",
"request_options": {
"notify_customer": false
},
"sent_at": "2020-09-08T13:12:03-04:00",
"kind": "fulfillment_request"
}
]
},
"submitted_fulfillment_order": {
"id": 1046000782,
"shop_id": 690933842,
"order_id": 1073459967,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "submitted",
"status": "open",
"supported_actions": [
"cancel_fulfillment_order"
],
"destination": {
"id": 1025578624,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578631,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823183,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578632,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823184,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578633,
"shop_id": 690933842,
"fulfillment_order_id": 1046000782,
"quantity": 1,
"line_item_id": 1071823185,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": [
{
"message": "Fulfill this ASAP please.",
"request_options": {
"notify_customer": false
},
"sent_at": "2020-09-08T13:12:03-04:00",
"kind": "fulfillment_request"
}
]
},
"unsubmitted_fulfillment_order": null
}
POST
/admin/api/2020-10/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/accept.json
Accepts a fulfillment request sent to a fulfillment service for a fulfillment order.
| message
|
An optional reason for accepting the fulfillment request. |
Accepts a fulfillment request sent to a fulfillment service and updates the fulfillment order
POST /admin/api/2020-07/fulfillment_orders/1046000777/fulfillment_request/accept.json
{
"fulfillment_request": {
"message": "We will start processing your fulfillment on the next business day."
}
}
View Response
HTTP/1.1 200 OK
{
"fulfillment_order": {
"id": 1046000777,
"shop_id": 690933842,
"order_id": 1073459964,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "accepted",
"status": "in_progress",
"supported_actions": [
"request_cancellation",
"create_fulfillment"
],
"destination": {
"id": 1025578619,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578619,
"shop_id": 690933842,
"fulfillment_order_id": 1046000777,
"quantity": 1,
"line_item_id": 1071823174,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578620,
"shop_id": 690933842,
"fulfillment_order_id": 1046000777,
"quantity": 1,
"line_item_id": 1071823175,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578621,
"shop_id": 690933842,
"fulfillment_order_id": 1046000777,
"quantity": 1,
"line_item_id": 1071823176,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": []
}
}
POST
/admin/api/2020-10/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/reject.json
Rejects a fulfillment request sent to a fulfillment service for a fulfillment order.
| message
|
An optional reason for rejecting the fulfillment request. |
Rejects a fulfillment request sent to a fulfillment service and updates the fulfillment order
POST /admin/api/2020-07/fulfillment_orders/1046000778/fulfillment_request/reject.json
{
"fulfillment_request": {
"message": "Not enough inventory on hand to complete the work."
}
}
View Response
HTTP/1.1 200 OK
{
"fulfillment_order": {
"id": 1046000778,
"shop_id": 690933842,
"order_id": 1073459965,
"assigned_location_id": 48752903,
"fulfillment_service_handle": "shipwire-app",
"request_status": "rejected",
"status": "open",
"supported_actions": [
"request_fulfillment",
"create_fulfillment"
],
"destination": {
"id": 1025578620,
"address1": "Chestnut Street 92",
"address2": "",
"city": "Louisville",
"company": null,
"country": "United States",
"email": "bob.norman@hostmail.com",
"first_name": "Bob",
"last_name": "Norman",
"phone": "555-625-1199",
"province": "Kentucky",
"zip": "40202"
},
"origin": {
"address1": null,
"address2": null,
"city": null,
"country_code": "DE",
"location_id": 48752903,
"name": "Apple Api Shipwire",
"phone": null,
"province": null,
"zip": null
},
"line_items": [
{
"id": 1025578622,
"shop_id": 690933842,
"fulfillment_order_id": 1046000778,
"quantity": 1,
"line_item_id": 1071823177,
"inventory_item_id": 39072856,
"fulfillable_quantity": 1,
"variant_id": 39072856
},
{
"id": 1025578623,
"shop_id": 690933842,
"fulfillment_order_id": 1046000778,
"quantity": 1,
"line_item_id": 1071823178,
"inventory_item_id": 457924702,
"fulfillable_quantity": 1,
"variant_id": 457924702
},
{
"id": 1025578624,
"shop_id": 690933842,
"fulfillment_order_id": 1046000778,
"quantity": 1,
"line_item_id": 1071823179,
"inventory_item_id": 49148385,
"fulfillable_quantity": 1,
"variant_id": 49148385
}
],
"outgoing_requests": []
}
}