**版本：202601**

# 取消履约

**POST** `/openapi/2026-01/orders/:order_id/fulfillments/:fulfillment_id/cancel`

取消订单的指定履约；该操作会将履约标记为已取消，停止后续处理与发货操作。

## 请求

**Path参数**

- `order_id` string (required)

  订单 ID
- `fulfillment_id` string (required)

  待取消的履约 ID

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `fulfillment` object

    已取消的履约

    - `id` string

      履约 ID
    - `order_id` string

      订单 ID
    - `status` string

      物流单状态：

      *   `pending`: 待发货
      *   `shipped`: 已发货
      *   `finished`: 已完成
      *   `cancelled`: 已取消
    - `created_at` string

      创建时间（ISO-8601 格式）
    - `updated_at` string

      最后更新时间（ISO-8601 格式）
    - `tracking_company` string

      物流商
    - `tracking_number` string

      运单号
    - `tracking_company_code` string

      物流商编码
    - `line_items` object[]

      本次履约包含的订单商品项列表

      *   Array \[

      - `id` string

        订单商品项 ID
      - `product_id` string

        商品 ID
      - `product_title` string

        已购商品名称
      - `variant_id` string

        子款式 ID
      - `variant_title` string

        子款式标题，例如 `Blue, Size M`
      - `quantity` uint32

        已购该商品的数量
      - `note` string

        订单商品项的商品备注
      - `image` object

        商品图片

        - `src` string

          图片来源 URL
        - `width` int32

          图片宽度（像素）
        - `height` int32

          图片高度（像素）
        - `alt` string

          图片替代文本
      - `price` string

        售价
      - `compare_at_price` string

        划线价
      - `total_price` string

        总价
      - `fulfillment_status` string

        订单商品项的履约状态，例如 `fulfilled`（已履约）、`unfulfilled`（未履约）；详见履约状态文档
      - `sku` string

        SKU
      - `weight` string

        商品重量
      - `weight_unit` string

        商品重量的计量单位，例如 `kg`、`lbs`
      - `vendor` string

        商品供应商
      - `product_url` string

        商品页面 URL
      - `created_at` string

        创建时间（ISO-8601 格式）
      - `updated_at` string

        最后更新时间（ISO-8601 格式）
      - `options` object[]

        订单商品项关联的商品款式属性列表

        *   Array \[

        - `name` string

          商品款式属性名称
        - `value` string

          商品款式属性值
        *   \]
      - `product_slug` string

        商品的 URL 友好标识
      - `taxable` boolean

        是否需要纳税
      - `requires_shipping` boolean

        订单商品项是否需要物流
      - `spu` string

        标准商品单元（SPU）
      - `product_tags` string

        商品标签
      - `refund_quantity_total` uint32

        退款数量
      - `ship_quantity` uint32

        发货数量
      - `custom` boolean

        是否为自定义商品项
      - `trunk_price` string

        主干价格
      - `discount_applications` string

        订单商品项运费的折扣应用数量
      - `tax_price` string

        订单商品项的税费
      - `duty_price` string

        关税费用
      - `payment_discount_price` string

        应用于订单商品项的支付折扣金额
      - `custom_properties` object

        订单商品项的自定义属性（如尺码、颜色等），JSON 格式
      *   \]
    - `tracking_url` string

      物流链接
    - `phone_number` string

      电话号码

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "fulfillment": {
      "id": "string",
      "order_id": "string",
      "status": "string",
      "created_at": "string",
      "updated_at": "string",
      "tracking_company": "string",
      "tracking_number": "string",
      "tracking_company_code": "string",
      "line_items": [
        {
          "id": "string",
          "product_id": "string",
          "product_title": "string",
          "variant_id": "string",
          "variant_title": "string",
          "quantity": 0,
          "note": "string",
          "image": {
            "src": "string",
            "width": 0,
            "height": 0,
            "alt": "string"
          },
          "price": "string",
          "compare_at_price": "string",
          "total_price": "string",
          "fulfillment_status": "string",
          "sku": "string",
          "weight": "string",
          "weight_unit": "string",
          "vendor": "string",
          "product_url": "string",
          "created_at": "string",
          "updated_at": "string",
          "options": [
            {
              "name": "string",
              "value": "string"
            }
          ],
          "product_slug": "string",
          "taxable": true,
          "requires_shipping": true,
          "spu": "string",
          "product_tags": "string",
          "refund_quantity_total": 0,
          "ship_quantity": 0,
          "custom": true,
          "trunk_price": "string",
          "discount_applications": "string",
          "tax_price": "string",
          "duty_price": "string",
          "payment_discount_price": "string",
          "custom_properties": {}
        }
      ],
      "tracking_url": "string",
      "phone_number": "string"
    }
  }
}
```