Canceling a fulfillment

Learn how to cancel a fulfillment.

If your fulfillment subsystem is unable to fulfill part or all of an order, it should send a fulfillment request with a cancel quantity.

Example cancel request and response

To cancel a fulfillment, you must include the skuId and the cancelQuantity with a POST request:

cURL
cURL
curl https://api.digitalriver.com/fulfillments \
-u sk_test_db9682a2-b04a-4e94-8e11-35fe8ec0b324: \
-d orderId="ord_5678901234" \
-d items[skuId]="sku_5823594809" \
-d items[cancelQuantity]=1 \
-d trackingCompany="Fedex" \
-d trackingNumber="5678901234" \
-d trackingUrl="http://www.digitalriver.com?code=5678901234"

A 201 returns response returns a Fulfillment object:

JSON
JSON
{
"id": "25c651d0-8079-48d7-b22e-eb1e2f451966",
"createdTime": "2020-05-15T12:20:38Z",
"orderId": "5678901234",
"items": [
{
"skuId": "sku_5823594809",
"cancelQuantity": 1,
}
],
"liveMode": false,
"trackingCompany": "Fedex",
"trackingNumber": "5678901234",
"trackingUrl": "http://www.digitalriver.com?code=5678901234"
}