Fulfillment

A fulfillment represents a shipment of one or more items in an order. When we say that an order has been completely fulfilled, we mean that all the items that make up that order have been sent to the customer.

Fulfillment

Ideally, a shop owner would want to make just one fulfillment per order, but there are times when the availability or size of items in the order make it necessary to make more than one shipment, which is why an order can have one or more fulfillments.

What can you do with Fulfillment?

The Shopify API lets you do the following with the Fulfillment resource. More detailed versions of these general actions may be available:

Fulfillment Properties

created_at
{ "created_at" : "2012-03-13T16:09:54-04:00" }

The date and time when the fulfillment was created. The API returns this value in ISO 8601 format.

id
{ "id" : 255858046 }

A unique numeric identifier for the fulfillment.

line_items
{ "fulfillable_quantity" : 1 }
{ "fulfillment_service" : "manual" }
{ "fulfillment_status" : null }
{ "grams" : 200 }
{ "id" : 466157049 }
{ "price" : "199.00" }
{ "product_id" : 632910392 }
{ "quantity" : 1 }
{ "requires_shipping" : true }
{ "sku" : "IPOD2008GREEN" }
{ "title" : "IPod Nano - 8gb" }
{ "variant_id" : "39072856" }
{ "variant_title" : "green" }
{ "vendor" : null }
{ "name" : "IPod Nano - 8gb - green" }
{ "shipment_status" : "in_transit" }
{ "variant_inventory_management" : "shopify" }
{ "properties" : "[ ]" }
{ "product_exists" : true }

A historical record of each item in the fulfillment:

  • fulfillable_quantity: The amount available to fulfill. This is the quantity - max(refunded_quantity, fulfilled_quantity) - pending_fulfilled_quantity - open_fulfilled_quantity.
  • fulfillment_service: Service provider who is doing the fulfillment.
  • fulfillment_status: Status of an order in terms of the line_items being fulfilled. Valid values are: fulfilled, null or partial.
  • grams: The weight of the item in grams.
  • id: The id of the line_item within the fulfillment.
  • price: The price of the item.
  • product_id: The unique numeric identifier for the product in the fulfillment.
  • quantity: The number of items in the fulfillment.
  • requires_shipping: Specifies whether or not a customer needs to provide a shipping address when placing an order for this product variant. Valid values are: "true" or "false."
  • sku: A unique identifier of the item in the fulfillment.
  • title: The title of the product.
  • variant_id: The id of the product variant being fulfilled.
  • variant_title: The title of the product variant being fulfilled.
  • vendor: The name of the supplier of the item.
  • name: The name of the product variant.
  • shipment_status: Returns the fulfillment's shipment status. Valid values are "confirmed", "in_transit", "out_for_delivery", "delivered", and "failure".
  • variant_inventory_management: Returns the name of the inventory management system.
  • properties: Returns additional properties associated with the line item.
  • product_exists: States whether or not the product exists. Valid values are "true" or "false".

notify_customer
{ "notify_customer" : true }

A flag indicating whether the customer should be notified. If set to true, an email will be sent when the fulfillment is created or updated. The default value is false. If you don't specify a value, the customer won't receive an email.

order_id
{ "order_id" : 450789469 }

The unique numeric identifier for the order.

receipt
{ "testcase" : true }
{ "authorization" : "123456" }

Text field that provides information about the receipt:

  • testcase: States whether or not the fulfillment was a testcase. Valid values are "true" or "false".
  • authorization: The authorization code.

status
{ "status" : "failure" }

The status of the fulfillment. Valid values are:

  • pending: The fulfillment is pending.
  • open: The fulfillment has been acknowledged by the service and is in processing.
  • success: The fulfillment was successful.
  • cancelled: The fulfillment was cancelled.
  • error: There was an error with the fulfillment request.
  • failure: The fulfillment request failed.

tracking_company
{ "tracking_company" : "China Post" }

'The name of the tracking company.'

  • 4PX
  • APC
  • Amazon Logistics UK
  • Amazon Logistics US
  • Australia Post
  • Bluedart
  • Canada Post
  • China Post
  • DHL
  • DHL eCommerce
  • DHL eCommerce Asia
  • Delhivery
  • Eagle
  • FSC
  • FedEx
  • FedEx UK
  • Globegistics
  • Japan Post
  • New Zealand Post
  • Post Danmark
  • Purolator
  • Royal Mail
  • TNT
  • TNT Post
  • UPS
  • USPS

Important

When creating a fulfillment for a supported carrier, send the tracking_company exactly as written in the list above.

tracking_numbers
{ "tracking_numbers" : ["112345Z2345"] }

A list of tracking numbers, provided by the shipping company.

tracking_urls
{ "tracking_urls" : ["http://track-chinapost.com/startairmail.php?code=112345Z2345"] }

The URLs to track the fulfillment.

updated_at
{ "updated_at" : "2012-05-01T14:22:25-04:00" }

The date and time when the fulfillment was last modified. The API returns this value in ISO 8601 format.

variant_inventory_management
{ "variant_inventory_management" : "shopify" }

States the name of the inventory management service.

Endpoints

GET /admin/orders/450789469/fulfillments.json
limit

Amount of results

(default: 50) (maximum: 250)
page

Page to show

(default: 1)
since_id

Restrict results to after the specified ID

created_at_min

Show fulfillments created after date (format: 2014-04-25T16:15:47-04:00)

created_at_max

Show fulfillments created before date (format: 2014-04-25T16:15:47-04:00)

updated_at_min

Show fulfillments last updated after date (format: 2014-04-25T16:15:47-04:00)

updated_at_max

Show fulfillments last updated before date (format: 2014-04-25T16:15:47-04:00)

fields

comma-separated list of fields to include in the response

Get a list of all fulfillments for an order.

GET /admin/orders/#{id}/fulfillments.json
View Response
HTTP/1.1 200 OK
{
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2016-11-15T15:54:14-05:00",
      "service": "manual",
      "updated_at": "2016-11-15T15:54:14-05:00",
      "tracking_company": null,
      "shipment_status": null,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "http:\/\/wwwapps.ups.com\/etracking\/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track",
      "tracking_urls": [
        "http:\/\/wwwapps.ups.com\/etracking\/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "grams": 200,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "total_discount": "0.00",
          "fulfillment_status": null,
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        }
      ]
    }
  ]
}

Get all fulfillments after the specified ID

GET /admin/orders/#{id}/fulfillments.json?since_id=255858046
View Response
HTTP/1.1 200 OK
{
  "fulfillments": [
    {
      "id": 1022782970,
      "order_id": 450789469,
      "status": "success",
      "created_at": "2016-11-15T15:55:02-05:00",
      "service": "manual",
      "updated_at": "2016-11-15T15:55:02-05:00",
      "tracking_company": "Bluedart",
      "shipment_status": null,
      "tracking_number": "123456789",
      "tracking_numbers": [
        "123456789"
      ],
      "tracking_url": "http:\/\/bluedarttracking.in\/success.php?numbers=123456789",
      "tracking_urls": [
        "http:\/\/bluedarttracking.in\/success.php?numbers=123456789"
      ],
      "receipt": {},
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "grams": 200,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 0,
          "total_discount": "0.00",
          "fulfillment_status": "fulfilled",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "grams": 200,
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [
          ],
          "product_exists": true,
          "fulfillable_quantity": 0,
          "total_discount": "0.00",
          "fulfillment_status": "fulfilled",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "grams": 200,
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [
          ],
          "product_exists": true,
          "fulfillable_quantity": 0,
          "total_discount": "0.00",
          "fulfillment_status": "fulfilled",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        }
      ]
    }
  ]
}
GET /admin/orders/450789469/fulfillments/count.json
created_at_min

Count fulfillments created after date (format: 2014-04-25T16:15:47-04:00)

created_at_max

Count fulfillments created before date (format: 2014-04-25T16:15:47-04:00)

updated_at_min

Count fulfillments last updated after date (format: 2014-04-25T16:15:47-04:00)

updated_at_max

Count fulfillments last updated before date (format: 2014-04-25T16:15:47-04:00)

Count all the total number of fulfillments for an order.

GET /admin/orders/#{id}/fulfillments/count.json
View Response
HTTP/1.1 200 OK
{
  "count": 1
}
GET /admin/orders/450789469/fulfillments/255858046.json
fields

comma-separated list of fields to include in the response

Get the Representation of a specific fulfillment.

GET /admin/orders/#{id}/fulfillments/#{id}.json
View Response
HTTP/1.1 200 OK
{
  "fulfillment": {
    "id": 255858046,
    "order_id": 450789469,
    "status": "failure",
    "created_at": "2016-11-15T15:54:14-05:00",
    "service": "manual",
    "updated_at": "2016-11-15T15:54:14-05:00",
    "tracking_company": null,
    "shipment_status": null,
    "tracking_number": "1Z2345",
    "tracking_numbers": [
      "1Z2345"
    ],
    "tracking_url": "http:\/\/wwwapps.ups.com\/etracking\/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track",
    "tracking_urls": [
      "http:\/\/wwwapps.ups.com\/etracking\/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track"
    ],
    "receipt": {
      "testcase": true,
      "authorization": "123456"
    },
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ]
  }
}
POST /admin/orders/450789469/fulfillments.json

Creates a fulfillment for the specified order and line items. If the line items in the fulfillment use a manual or custom fulfillment service the status of the returned fulfillment will be set immediately. If the line items use an external fulfillment service they will be queued for fulfillment and the status will be set to pending until the external fulfillment service has been invoked.

A fulfillment may then transition to open which implies it is being processed by the service, before transitioning to success when the items have shipped. Not specifying line item IDs causes all unfulfilled and partially fulfilled line items for the order to be fulfilled.

Note that all line items being fulfilled must have the same fulfillment service.

About tracking urls

If you are creating a fulfillment for a supported carrier, you can simply send the tracking_company, and tracking_numbers and Shopify will generate the tracking_url for you. If creating a fulfillment for an unsupported carrier (not in the tracking_company list) send the tracking_company, tracking_numbers and tracking_urls fields.

Note

If you send an unsupported carrier without a tracking_url Shopify will still try to generate a valid tracking_url using pattern matching on tracking_numbers.

Fulfill an order using a supported tracking_company in an incorrect format fuzzy matches to generate tracking URL, but respects tracking company supplied

POST /admin/orders/#{id}/fulfillments.json
{
  "fulfillment": {
    "tracking_number": "123456789010",
    "tracking_company": "fed ex",
    "line_items": [
      {
        "id": 466157049
      },
      {
        "id": 518995019
      },
      {
        "id": 703073504
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "fulfillment": {
    "id": 1022782959,
    "order_id": 450789469,
    "status": "success",
    "created_at": "2016-11-15T15:54:50-05:00",
    "service": "manual",
    "updated_at": "2016-11-15T15:54:50-05:00",
    "tracking_company": "fed ex",
    "shipment_status": null,
    "tracking_number": "123456789010",
    "tracking_numbers": [
      "123456789010"
    ],
    "tracking_url": "http:\/\/www.fedex.com\/Tracking?tracknumbers=123456789010&action=track",
    "tracking_urls": [
      "http:\/\/www.fedex.com\/Tracking?tracknumbers=123456789010&action=track"
    ],
    "receipt": {},
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ]
  }
}

Fulfill an order using only a tracking number and a custom tracking URL, respects tracking URL but attempts to generate tracking company if number matches recognizable pattern

POST /admin/orders/#{id}/fulfillments.json
{
  "fulfillment": {
    "tracking_number": "CJ274101086US",
    "tracking_url": "http:\/\/www.custom-tracking.com\/?tracking_number=CJ274101086US",
    "line_items": [
      {
        "id": 466157049
      },
      {
        "id": 518995019
      },
      {
        "id": 703073504
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "fulfillment": {
    "id": 1022782960,
    "order_id": 450789469,
    "status": "success",
    "created_at": "2016-11-15T15:54:52-05:00",
    "service": "manual",
    "updated_at": "2016-11-15T15:54:52-05:00",
    "tracking_company": "USPS",
    "shipment_status": null,
    "tracking_number": "CJ274101086US",
    "tracking_numbers": [
      "CJ274101086US"
    ],
    "tracking_url": "http:\/\/www.custom-tracking.com\/?tracking_number=CJ274101086US",
    "tracking_urls": [
      "http:\/\/www.custom-tracking.com\/?tracking_number=CJ274101086US"
    ],
    "receipt": {},
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ]
  }
}

Fulfill an order using a non-supported tracking_company without a tracking URL does not generates google URL if tracking number does not match a recognizable pattern

POST /admin/orders/#{id}/fulfillments.json
{
  "fulfillment": {
    "tracking_number": "1234567",
    "tracking_company": "Custom Tracking Company",
    "line_items": [
      {
        "id": 466157049
      },
      {
        "id": 518995019
      },
      {
        "id": 703073504
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "fulfillment": {
    "id": 1022782961,
    "order_id": 450789469,
    "status": "success",
    "created_at": "2016-11-15T15:54:53-05:00",
    "service": "manual",
    "updated_at": "2016-11-15T15:54:53-05:00",
    "tracking_company": "Custom Tracking Company",
    "shipment_status": null,
    "tracking_number": "1234567",
    "tracking_numbers": [
      "1234567"
    ],
    "tracking_url": "http:\/\/www.google.com\/search?q=1234567",
    "tracking_urls": [
      "http:\/\/www.google.com\/search?q=1234567"
    ],
    "receipt": {},
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ]
  }
}

Fulfill line items without a tracking number

POST /admin/orders/#{id}/fulfillments.json
{
  "fulfillment": {
    "tracking_number": null,
    "line_items": [
      {
        "id": 466157049
      },
      {
        "id": 518995019
      },
      {
        "id": 703073504
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "fulfillment": {
    "id": 1022782962,
    "order_id": 450789469,
    "status": "success",
    "created_at": "2016-11-15T15:54:54-05:00",
    "service": "manual",
    "updated_at": "2016-11-15T15:54:54-05:00",
    "tracking_company": null,
    "shipment_status": null,
    "tracking_number": null,
    "tracking_numbers": [
    ],
    "tracking_url": null,
    "tracking_urls": [
    ],
    "receipt": {},
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ]
  }
}

Fulfill an order using a supported tracking_company generates tracking URL

POST /admin/orders/#{id}/fulfillments.json
{
  "fulfillment": {
    "tracking_number": "123456789",
    "tracking_company": "China Post",
    "line_items": [
      {
        "id": 466157049
      },
      {
        "id": 518995019
      },
      {
        "id": 703073504
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "fulfillment": {
    "id": 1022782963,
    "order_id": 450789469,
    "status": "success",
    "created_at": "2016-11-15T15:54:55-05:00",
    "service": "manual",
    "updated_at": "2016-11-15T15:54:55-05:00",
    "tracking_company": "China Post",
    "shipment_status": null,
    "tracking_number": "123456789",
    "tracking_numbers": [
      "123456789"
    ],
    "tracking_url": "http:\/\/www.track-chinapost.com\/startems.php?code=123456789",
    "tracking_urls": [
      "http:\/\/www.track-chinapost.com\/startems.php?code=123456789"
    ],
    "receipt": {},
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ]
  }
}

Fulfill all line items for an order with multiple tracking numbers

POST /admin/orders/#{id}/fulfillments.json
{
  "fulfillment": {
    "tracking_numbers": [
      "09ee2d5bfff60f85e20d39e074ed0be7",
      "ddd27f2170df057d68ae6c9e937af270",
      "dc2e741b631b8f4e54ede64ce293668d"
    ],
    "line_items": [
      {
        "id": 466157049
      },
      {
        "id": 518995019
      },
      {
        "id": 703073504
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "fulfillment": {
    "id": 1022782964,
    "order_id": 450789469,
    "status": "success",
    "created_at": "2016-11-15T15:54:56-05:00",
    "service": "manual",
    "updated_at": "2016-11-15T15:54:56-05:00",
    "tracking_company": null,
    "shipment_status": null,
    "tracking_number": "09ee2d5bfff60f85e20d39e074ed0be7",
    "tracking_numbers": [
      "09ee2d5bfff60f85e20d39e074ed0be7",
      "ddd27f2170df057d68ae6c9e937af270",
      "dc2e741b631b8f4e54ede64ce293668d"
    ],
    "tracking_url": "http:\/\/www.google.com\/search?q=09ee2d5bfff60f85e20d39e074ed0be7",
    "tracking_urls": [
      "http:\/\/www.google.com\/search?q=09ee2d5bfff60f85e20d39e074ed0be7",
      "http:\/\/www.google.com\/search?q=ddd27f2170df057d68ae6c9e937af270",
      "http:\/\/www.google.com\/search?q=dc2e741b631b8f4e54ede64ce293668d"
    ],
    "receipt": {},
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ]
  }
}

Fulfill all line items for an order and use a custom tracking URL and company

POST /admin/orders/#{id}/fulfillments.json
{
  "fulfillment": {
    "tracking_url": "http:\/\/www.packagetrackr.com\/track\/somecarrier\/1234567",
    "tracking_company": "Jack Black's Pack, Stack and Track",
    "line_items": [
      {
        "id": 466157049
      },
      {
        "id": 518995019
      },
      {
        "id": 703073504
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "fulfillment": {
    "id": 1022782965,
    "order_id": 450789469,
    "status": "success",
    "created_at": "2016-11-15T15:54:57-05:00",
    "service": "manual",
    "updated_at": "2016-11-15T15:54:57-05:00",
    "tracking_company": "Jack Black's Pack, Stack and Track",
    "shipment_status": null,
    "tracking_number": null,
    "tracking_numbers": [
    ],
    "tracking_url": "http:\/\/www.packagetrackr.com\/track\/somecarrier\/1234567",
    "tracking_urls": [
      "http:\/\/www.packagetrackr.com\/track\/somecarrier\/1234567"
    ],
    "receipt": {},
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ]
  }
}

Fulfill an order using a non-supported tracking_company without a tracking URL generates best guess URL if number matches recognizable pattern

POST /admin/orders/#{id}/fulfillments.json
{
  "fulfillment": {
    "tracking_number": "RR123456789CN",
    "tracking_company": "Chinese Post",
    "line_items": [
      {
        "id": 466157049
      },
      {
        "id": 518995019
      },
      {
        "id": 703073504
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "fulfillment": {
    "id": 1022782967,
    "order_id": 450789469,
    "status": "success",
    "created_at": "2016-11-15T15:54:59-05:00",
    "service": "manual",
    "updated_at": "2016-11-15T15:55:00-05:00",
    "tracking_company": "Chinese Post",
    "shipment_status": null,
    "tracking_number": "RR123456789CN",
    "tracking_numbers": [
      "RR123456789CN"
    ],
    "tracking_url": "http:\/\/www.track-chinapost.com\/startems.php?code=RR123456789CN",
    "tracking_urls": [
      "http:\/\/www.track-chinapost.com\/startems.php?code=RR123456789CN"
    ],
    "receipt": {},
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ]
  }
}

Fulfill an order using a supported tracking_company in an incorrect format and custom tracking URL, respects sent URL

POST /admin/orders/#{id}/fulfillments.json
{
  "fulfillment": {
    "tracking_number": "123456789010",
    "tracking_company": "fed ex",
    "tracking_url": "https:\/\/www.new-fedex-tracking.com\/?number=123456789010",
    "line_items": [
      {
        "id": 466157049
      },
      {
        "id": 518995019
      },
      {
        "id": 703073504
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "fulfillment": {
    "id": 1022782968,
    "order_id": 450789469,
    "status": "success",
    "created_at": "2016-11-15T15:55:00-05:00",
    "service": "manual",
    "updated_at": "2016-11-15T15:55:00-05:00",
    "tracking_company": "fed ex",
    "shipment_status": null,
    "tracking_number": "123456789010",
    "tracking_numbers": [
      "123456789010"
    ],
    "tracking_url": "https:\/\/www.new-fedex-tracking.com\/?number=123456789010",
    "tracking_urls": [
      "https:\/\/www.new-fedex-tracking.com\/?number=123456789010"
    ],
    "receipt": {},
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ]
  }
}

Partially fulfill a single line item by explicitly specifying the line item and quantity to be fulfilled.

POST /admin/orders/#{id}/fulfillments.json
{
  "fulfillment": {
    "tracking_number": null,
    "line_items": [
      {
        "id": 466157049,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "fulfillment": {
    "id": 1022782969,
    "order_id": 450789469,
    "status": "success",
    "created_at": "2016-11-15T15:55:01-05:00",
    "service": "manual",
    "updated_at": "2016-11-15T15:55:01-05:00",
    "tracking_company": null,
    "shipment_status": null,
    "tracking_number": null,
    "tracking_numbers": [
    ],
    "tracking_url": null,
    "tracking_urls": [
    ],
    "receipt": {},
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "total_discount": "0.00",
        "fulfillment_status": "partial",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ]
  }
}

Fulfill all line items for an order and send the shipping confirmation email. Not specifying line item IDs causes all unfulfilled and partially fulfilled line items for the order to be fulfilled.

POST /admin/orders/#{id}/fulfillments.json
{
  "fulfillment": {
    "tracking_number": "123456789",
    "tracking_urls": [
      "https:\/\/shipping.xyz\/track.php?num=123456789",
      "https:\/\/anothershipper.corp\/track.php?code=abc"
    ],
    "notify_customer": true
  }
}
View Response
HTTP/1.1 201 Created
{
  "fulfillment": {
    "id": 1022782971,
    "order_id": 450789469,
    "status": "success",
    "created_at": "2016-11-15T15:55:03-05:00",
    "service": "manual",
    "updated_at": "2016-11-15T15:55:03-05:00",
    "tracking_company": "Bluedart",
    "shipment_status": null,
    "tracking_number": "123456789",
    "tracking_numbers": [
      "123456789"
    ],
    "tracking_url": "https:\/\/shipping.xyz\/track.php?num=123456789",
    "tracking_urls": [
      "https:\/\/shipping.xyz\/track.php?num=123456789",
      "https:\/\/anothershipper.corp\/track.php?code=abc"
    ],
    "receipt": {},
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ]
  }
}

Fulfill a single line item by explicitly specifying the line items to be fulfilled.

POST /admin/orders/#{id}/fulfillments.json
{
  "fulfillment": {
    "tracking_number": null,
    "line_items": [
      {
        "id": 466157049
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "fulfillment": {
    "id": 1022782973,
    "order_id": 450789469,
    "status": "success",
    "created_at": "2016-11-15T15:55:05-05:00",
    "service": "manual",
    "updated_at": "2016-11-15T15:55:05-05:00",
    "tracking_company": null,
    "shipment_status": null,
    "tracking_number": null,
    "tracking_numbers": [
    ],
    "tracking_url": null,
    "tracking_urls": [
    ],
    "receipt": {},
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ]
  }
}
PUT /admin/orders/450789469/fulfillments/255858046.json

Update tracking number for a fulfillment.

PUT /admin/orders/#{id}/fulfillments/#{id}.json
{
  "fulfillment": {
    "tracking_number": "987654321",
    "id": 255858046
  }
}
View Response
HTTP/1.1 200 OK
{
  "fulfillment": {
    "id": 255858046,
    "order_id": 450789469,
    "status": "failure",
    "created_at": "2016-11-15T15:54:14-05:00",
    "service": "manual",
    "updated_at": "2016-11-15T15:55:06-05:00",
    "tracking_company": "Bluedart",
    "shipment_status": null,
    "tracking_number": "987654321",
    "tracking_numbers": [
      "987654321"
    ],
    "tracking_url": "http:\/\/bluedarttracking.in\/success.php?numbers=987654321",
    "tracking_urls": [
      "http:\/\/bluedarttracking.in\/success.php?numbers=987654321"
    ],
    "receipt": {
      "testcase": true,
      "authorization": "123456"
    },
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ]
  }
}
POST /admin/orders/450789469/fulfillments/255858046/complete.json

Complete a fulfillment.

POST /admin/orders/#{id}/fulfillments/#{id}/complete.json
{}
View Response
HTTP/1.1 201 Created
{
  "fulfillment": {
    "id": 255858046,
    "order_id": 450789469,
    "status": "success",
    "created_at": "2016-11-15T15:54:14-05:00",
    "service": "manual",
    "updated_at": "2016-11-15T15:55:05-05:00",
    "tracking_company": "UPS",
    "shipment_status": null,
    "tracking_number": "1Z2345",
    "tracking_numbers": [
      "1Z2345"
    ],
    "tracking_url": "http:\/\/wwwapps.ups.com\/etracking\/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track",
    "tracking_urls": [
      "http:\/\/wwwapps.ups.com\/etracking\/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track"
    ],
    "receipt": {
      "testcase": true,
      "authorization": "123456"
    },
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ]
  }
}
POST /admin/orders/450789469/fulfillments/255858046/open.json

Transition a fulfillment from pending to open.

POST /admin/orders/#{id}/fulfillments/#{id}/open.json
{}
View Response
HTTP/1.1 201 Created
{
  "fulfillment": {
    "id": 255858046,
    "order_id": 450789469,
    "status": "open",
    "created_at": "2016-11-15T15:54:14-05:00",
    "service": "manual",
    "updated_at": "2016-11-15T15:54:51-05:00",
    "tracking_company": "UPS",
    "shipment_status": null,
    "tracking_number": "1Z2345",
    "tracking_numbers": [
      "1Z2345"
    ],
    "tracking_url": "http:\/\/wwwapps.ups.com\/etracking\/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track",
    "tracking_urls": [
      "http:\/\/wwwapps.ups.com\/etracking\/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track"
    ],
    "receipt": {
      "testcase": true,
      "authorization": "123456"
    },
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ]
  }
}
POST /admin/orders/450789469/fulfillments/255858046/cancel.json

Cancel a fulfillment.

POST /admin/orders/#{id}/fulfillments/#{id}/cancel.json
{}
View Response
HTTP/1.1 201 Created
{
  "fulfillment": {
    "id": 255858046,
    "order_id": 450789469,
    "status": "cancelled",
    "created_at": "2016-11-15T15:54:14-05:00",
    "service": "manual",
    "updated_at": "2016-11-15T15:54:58-05:00",
    "tracking_company": "UPS",
    "shipment_status": null,
    "tracking_number": "1Z2345",
    "tracking_numbers": [
      "1Z2345"
    ],
    "tracking_url": "http:\/\/wwwapps.ups.com\/etracking\/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track",
    "tracking_urls": [
      "http:\/\/wwwapps.ups.com\/etracking\/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track"
    ],
    "receipt": {
      "testcase": true,
      "authorization": "123456"
    },
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "grams": 200,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ]
  }
}