updateFulfillmentOrder - Amazon Selling Partner API (SP-API)-中文

更新和/或请求发货一个有订单暂停的履行订单。

使用计划：

速率（每秒请求数）	峰值
2	30

x-amzn-RateLimit-Limit 响应头返回了适用于请求操作的使用计划速率限制（如果可用）。上表指示了该操作的默认速率和峰值值。业务需求要求更高吞吐量的销售合作伙伴可能会看到比这里显示的更高的速率和峰值值。更多信息，请参考销售合作伙伴API中的使用计划和速率限制。

请求参数

Path 参数

sellerFulfillmentOrderId

string

必需

卖方在创建履行订单时分配给该项目的标识符。

<= 40 字符

Body 参数application/json

`updateFulfillmentOrder` 操作的请求体模式。

marketplaceId

string

可选

该履行订单所针对的市场。

displayableOrderId

string

可选

卖家创建的配送订单标识符。该值显示为收件人面对的材料中的订单标识符，例如外发货物的包装单。DisplayableOrderId的值应与卖家提供给收件人的订单标识符匹配。卖家可以使用SellerFulfillmentOrderId作为该值，或者如果他们希望收件人引用替代的订单标识符，可以指定一个替代的值。

<= 40 字符

displayableOrderDate

string <date-time>

日期时间戳

可选

displayableOrderComment

string

可选

订单特定的文本，出现在面向收件人的材料中，例如外发货物的装箱单。

<= 750 字符

shippingSpeedCategory

enum<string>

可选

用于履行订单的运输方式。当此值为 ScheduledDelivery 时，选择 Ship 作为 fulfillmentAction。当 shippingSpeedCategory 值为 ScheduledDelivery 时，Hold 不是有效的 fulfillmentAction 值。

枚举值:

StandardExpeditedPriorityScheduledDelivery

destinationAddress

object (Address)

一个实际地址。

可选

name

string

必需

地址上的个人、企业或机构名称。

addressLine1

string

地址的第一行。

必需

addressLine2

string

可选

如有需要，附加地址信息。

addressLine3

string

可选

如有需要，附加地址信息。

city

string

可选

此属性是指个人、企业或机构所在地的城市。除日本外，此属性在所有国家都是必需的。在日本不应使用此属性。

districtOrCounty

string

可选

该人员、企业或机构所在的区或县。

stateOrRegion

string

必需

该人、企业或机构所在的州或地区。

postalCode

string

地址的邮政编码。

必需

countryCode

string

必需

两位数字的国家代码。采用 ISO 3166-1 alpha-2 格式。

phone

string

可选

位于该地址的人、企业或机构的电话号码。

fulfillmentAction

enum<string>

可选

指定履行订单是否应该立即发货或暂时搁置。

枚举值:

ShipHold

fulfillmentPolicy

enum<string>

可选

您在提交 createFulfillmentOrder 操作时指定的 FulfillmentPolicy 值。

枚举值:

FillOrKillFillAllFillAllAvailable

shipFromCountryCode

string

可选

发货订单发货国家的两字母国家代码。必须使用ISO 3166-1 alpha-2格式。

notificationEmails

array[string]

可选

卖方提供的一份电子邮件地址列表，这些地址由亚马逊用于代表卖方向收件人发送发货完成通知。

featureConstraints

array[object (FeatureSettings) {2}]

可选

将应用于订单的功能列表及其履行政策。

featureName

string

功能的名称。

可选

featureFulfillmentPolicy

enum<string>

可选

指定在履行订单时使用的政策。

枚举值:

RequiredNotRequired

items

array[object (UpdateFulfillmentOrderItem) {10}]

可选

用于更新履行订单的履行订单项信息数组。

sellerSku

string

可选

该商品的卖家SKU。

sellerFulfillmentOrderItemId

string

必需

识别要更新的履行订单项目。该项目是通过先前调用 createFulfillmentOrder 操作创建的。

<= 50 字符

quantity

integer <int32>

物品数量。

必需

giftMessage

string

可选

给礼物接受者的信息（如适用）。

<= 512 字符

displayableComment

string

可选

在面向收件人的材料中显示的项目特定文本，例如出货包装单。

<= 250 字符

fulfillmentNetworkSku

string

可选

亚马逊履行网络的商品SKU。

orderItemDisposition

string

可选

指示该项目是可售还是不可售。

perUnitDeclaredValue

object (Money)

可选

一笔钱，包括以货币形式存在的单位。

perUnitPrice

object (Money)

可选

一笔钱，包括以货币形式存在的单位。

perUnitTax

object (Money)

可选

一笔钱，包括以货币形式存在的单位。

示例

{
    "marketplaceId": "string",
    "displayableOrderId": "string",
    "displayableOrderDate": "2019-08-24T14:15:22Z",
    "displayableOrderComment": "string",
    "shippingSpeedCategory": "Standard",
    "destinationAddress": {
        "name": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "addressLine3": "string",
        "city": "string",
        "districtOrCounty": "string",
        "stateOrRegion": "string",
        "postalCode": "string",
        "countryCode": "string",
        "phone": "string"
    },
    "fulfillmentAction": "Ship",
    "fulfillmentPolicy": "FillOrKill",
    "shipFromCountryCode": "string",
    "notificationEmails": [
        "string"
    ],
    "featureConstraints": [
        {
            "featureName": "string",
            "featureFulfillmentPolicy": "Required"
        }
    ],
    "items": [
        {
            "sellerSku": "string",
            "sellerFulfillmentOrderItemId": "string",
            "quantity": 0,
            "giftMessage": "string",
            "displayableComment": "string",
            "fulfillmentNetworkSku": "string",
            "orderItemDisposition": "string",
            "perUnitDeclaredValue": {
                "currencyCode": "string",
                "amount": "string"
            },
            "perUnitPrice": {
                "currencyCode": "string",
                "amount": "string"
            },
            "perUnitTax": {
                "currencyCode": "string",
                "amount": "string"
            }
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

您对此操作的速率限制（每秒请求数量）。

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

`updateFulfillmentOrder` 操作的响应模式。

errors

array[object (Error) {3}]

可选

请求失败时返回的错误响应列表。

code

string

必需

一个标识发生错误类型的错误代码。

message

string

必需

描述错误状态的消息。

details

string

可选

可以帮助拨打者理解或解决问题的附加细节。

示例

{
    "errors": [
        {
            "code": "string",
            "message": "string",
            "details": "string"
        }
    ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障