更新履约

PUT 
/openapi/2022-01/orders/:order_id/fulfillments/:fulfillment_id

通过履约 ID 更新现有履约的详细信息（包括物流信息、通知设置等）。

请求

Path参数

order_id string必填

订单 ID。

fulfillment_id string必填

待更新的履约 ID。

application/json

请求体

请求体

tracking_numberstring

Tracking Number, for example: DHL1231232113

tracking_companystring

Tracking Company, for example: DHL

tracking_company_codestring

Tracking Company's code, for example: dhl

tracking_urlstring

Tracking Url

send_emailboolean

Whether to send email notifications

示例

{
  "tracking_number": "string",
  "tracking_company": "string",
  "tracking_company_code": "string",
  "tracking_url": "string",
  "send_email": true
}

响应

200

200

application/json

数据结构

数据结构

fulfillment object
idstring
示例： 51c7dd5d-8f49-40c3-b2c1-5dfdeef9946d
order_idstring
示例： 633130-00000007
statusstring
示例： shipped
tracking_companystring
示例： 燕文物流
tracking_numberstring
示例： 11111111112
tracking_company_codestring
示例： DJ-11343
tracking_urlstring
示例：
created_atstring
示例： 2024-04-22T08:37:12Z
updated_atstring
示例： 2024-04-22T08:42:54Z
line_items object[]
Array [
idstring
示例： ed8af005-1f4e-42d1-859d-99b0fd420781
product_idstring
示例： a1a88be0-a1d4-47e4-a2f2-ba6e131cf447
variant_idstring
示例： a7175820-36b3-4fc6-9baf-51e3035242ba
variant_titlestring
示例： L-blue-T
product_titlestring
示例： shirt
product_handlestring
示例： shirt
quantityinteger
默认值： 0
示例： 1
notestring
示例：
fulfillment_statusstring
示例： shipped
skustring
示例： T-M-L-blue-T-A001008
weight_unitstring
示例： kg
vendorstring
示例： shoplazza
product_urlstring
示例： /products/shirt
compare_at_pricestring
示例： 97.00
imagestring
示例： //cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpeg
pricestring
示例： 81.00
totalstring
示例： 81.00
weightstring
示例： 1.10
properties object[]
Array [
namestring
示例： size
valuestring
示例： L
]
custom_properties object
object
refund_quantityinteger
默认值： 0
示例： 0
refund_totalstring
示例： 0.00
taxableboolean
默认值： true
示例： true
requires_shippingboolean
默认值： true
示例： true
shipping_quantityinteger
默认值： 0
示例： 1
]

示例

{
  "fulfillment": {
    "id": "51c7dd5d-8f49-40c3-b2c1-5dfdeef9946d",
    "order_id": "633130-00000007",
    "status": "shipped",
    "tracking_company": "燕文物流",
    "tracking_number": "11111111112",
    "tracking_company_code": "DJ-11343",
    "tracking_url": "",
    "created_at": "2024-04-22T08:37:12Z",
    "updated_at": "2024-04-22T08:42:54Z",
    "line_items": [
      {
        "id": "ed8af005-1f4e-42d1-859d-99b0fd420781",
        "product_id": "a1a88be0-a1d4-47e4-a2f2-ba6e131cf447",
        "variant_id": "a7175820-36b3-4fc6-9baf-51e3035242ba",
        "variant_title": "L-blue-T",
        "product_title": "shirt",
        "product_handle": "shirt",
        "quantity": 1,
        "note": "",
        "fulfillment_status": "shipped",
        "sku": "T-M-L-blue-T-A001008",
        "weight_unit": "kg",
        "vendor": "shoplazza",
        "product_url": "/products/shirt",
        "compare_at_price": "97.00",
        "image": "//cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpeg",
        "price": "81.00",
        "total": "81.00",
        "weight": "1.10",
        "properties": [
          {
            "name": "size",
            "value": "L"
          }
        ],
        "custom_properties": {},
        "refund_quantity": 0,
        "refund_total": "0.00",
        "taxable": true,
        "requires_shipping": true,
        "shipping_quantity": 1
      }
    ]
  }
}

Result

{
    "fulfillment": {
        "id": "51c7dd5d-8f49-40c3-b2c1-5dfdeef9946d",
        "order_id": "633130-00000007",
        "status": "shipped",
        "tracking_company": "燕文物流",
        "tracking_number": "11111111112",
        "tracking_company_code": "DJ-11343",
        "tracking_url": "",
        "created_at": "2024-04-22T08:37:12Z",
        "updated_at": "2024-04-22T08:42:54Z",
        "line_items": [
            {
                "id": "ed8af005-1f4e-42d1-859d-99b0fd420781",
                "product_id": "a1a88be0-a1d4-47e4-a2f2-ba6e131cf447",
                "variant_id": "a7175820-36b3-4fc6-9baf-51e3035242ba",
                "variant_title": "L-blue-T",
                "product_title": "shirt",
                "product_handle": "shirt",
                "quantity": 1,
                "note": "",
                "fulfillment_status": "shipped",
                "sku": "T-M-L-blue-T-A001008",
                "weight_unit": "kg",
                "vendor": "shoplazza",
                "product_url": "/products/shirt",
                "compare_at_price": "97.00",
                "image": "//cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpeg",
                "price": "81.00",
                "total": "81.00",
                "weight": "1.10",
                "properties": [
                    {
                        "name": "size",
                        "value": "L"
                    },
                    {
                        "name": "color",
                        "value": "blue"
                    },
                    {
                        "name": "type",
                        "value": "T"
                    }
                ],
                "custom_properties": {},
                "refund_quantity": 0,
                "refund_total": "0.00",
                "taxable": true,
                "requires_shipping": true,
                "shipping_quantity": 1
            }
        ]
    }
}