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

请求亚马逊从其履行网络中的卖方库存中发货到指定地址。

使用计划：

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

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

请求参数

Body 参数application/json

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

marketplaceId

string

可选

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

sellerFulfillmentOrderId

string

必需

一个履行订单标识符，由卖家创建以跟踪他们的履行订单。SellerFulfillmentOrderId 对于卖家创建的每个履行订单必须是唯一的。如果卖家的系统已经创建了唯一的订单标识符，那么这些可能是他们可以使用的良好值。

<= 40 字符

displayableOrderId

string

必需

卖家创建的履行订单标识符。该值在发给收件人的材料中显示为订单标识符，例如出库装箱单。DisplayableOrderId的值应与卖家提供给收件人的订单标识符相匹配。卖家可以使用SellerFulfillmentOrderId作为该值，或者如果他们希望收件人参考另一个订单标识符，可以指定一个替代值。

该值必须是一个长度在一到40个字符之间的字母数字或符合ISO 8859-1的字符串。不能包含两个连续的空格。前后的空白将被删除。

<= 40 字符

displayableOrderDate

string <date-time>

日期时间戳

必需

displayableOrderComment

string

必需

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

<= 750 字符

shippingSpeedCategory

enum<string>

必需

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

枚举值:

StandardExpeditedPriorityScheduledDelivery

deliveryWindow

object (DeliveryWindow)

可选

调度交付履行订单应交付的时间范围。此功能仅在日本市场可用。

startDate

string <date-time>

日期时间戳

必需

endDate

string <date-time>

日期时间戳

必需

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

可选

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

deliveryPreferences

object (DeliveryPreferences)

可选

运送偏好已应用于目的地地址。这些偏好将在可能的情况下应用，并将尽力而为。该功能目前仅在日本市场支持，不适用于其他市场。

deliveryInstructions

string

可选

附加送货说明。例如，这可能是进入建筑物的指示、附近的地标或导航指示、'注意狗'等。

<= 250 字符

dropOffLocation

object (DropOffLocation)

可选

在目的地址留下包裹的首选位置。

fulfillmentAction

enum<string>

可选

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

枚举值:

ShipHold

fulfillmentPolicy

enum<string>

可选

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

枚举值:

FillOrKillFillAllFillAllAvailable

codSettings

object (CODSettings)

可选

您与货到付款（COD）履行订单相关的货到付款（COD）费用。

isCodRequired

boolean

必需

当为真时，此履行订单要求货到付款。

codCharge

object (Money)

可选

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

codChargeTax

object (Money)

可选

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

shippingCharge

object (Money)

可选

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

shippingChargeTax

object (Money)

可选

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

shipFromCountryCode

string

可选

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

notificationEmails

array[string]

可选

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

featureConstraints

array[object (FeatureSettings) {2}]

可选

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

featureName

string

功能的名称。

可选

featureFulfillmentPolicy

enum<string>

可选

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

枚举值:

RequiredNotRequired

items

array[object (CreateFulfillmentOrderItem) {9}]

必需

用于创建履行订单的物品信息数组。

sellerSku

string

必需

该商品的卖家SKU。

<= 50 字符

sellerFulfillmentOrderItemId

string

必需

卖家创建的履行订单商品标识符，用于跟踪履行订单商品。用于区分具有相同 SellerSKU 的多个履行商品。例如，卖家可能会为一个履行订单中的两个具有相同 SellerSKU 但具有不同 GiftMessage 值的商品分配不同的 SellerFulfillmentOrderItemId 值。

<= 50 字符

quantity

integer <int32>

物品数量。

必需

giftMessage

string

可选

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

<= 512 字符

displayableComment

string

可选

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

<= 250 字符

fulfillmentNetworkSku

string

可选

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

perUnitDeclaredValue

object (Money)

可选

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

perUnitPrice

object (Money)

可选

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

perUnitTax

object (Money)

可选

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

paymentInformation

array[object (PaymentInformation) {3}]

可选

与该履行订单相关的各种支付属性的数组。

paymentTransactionId

string

必需

此付款的交易标识符。

paymentMode

string

该付款的交易方式。

必需

paymentDate

string <date-time>

日期时间戳

必需

示例

{
    "marketplaceId": "string",
    "sellerFulfillmentOrderId": "string",
    "displayableOrderId": "string",
    "displayableOrderDate": "2019-08-24T14:15:22Z",
    "displayableOrderComment": "string",
    "shippingSpeedCategory": "Standard",
    "deliveryWindow": {
        "startDate": "2019-08-24T14:15:22Z",
        "endDate": "2019-08-24T14:15:22Z"
    },
    "destinationAddress": {
        "name": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "addressLine3": "string",
        "city": "string",
        "districtOrCounty": "string",
        "stateOrRegion": "string",
        "postalCode": "string",
        "countryCode": "string",
        "phone": "string"
    },
    "deliveryPreferences": {
        "deliveryInstructions": "string",
        "dropOffLocation": {
            "type": "FRONT_DOOR",
            "attributes": {
                "property1": "string",
                "property2": "string"
            }
        }
    },
    "fulfillmentAction": "Ship",
    "fulfillmentPolicy": "FillOrKill",
    "codSettings": {
        "isCodRequired": true,
        "codCharge": {
            "currencyCode": "string",
            "amount": "string"
        },
        "codChargeTax": {
            "currencyCode": "string",
            "amount": "string"
        },
        "shippingCharge": {
            "currencyCode": "string",
            "amount": "string"
        },
        "shippingChargeTax": {
            "currencyCode": "string",
            "amount": "string"
        }
    },
    "shipFromCountryCode": "string",
    "notificationEmails": [
        "string"
    ],
    "featureConstraints": [
        {
            "featureName": "string",
            "featureFulfillmentPolicy": "Required"
        }
    ],
    "items": [
        {
            "sellerSku": "string",
            "sellerFulfillmentOrderItemId": "string",
            "quantity": 0,
            "giftMessage": "string",
            "displayableComment": "string",
            "fulfillmentNetworkSku": "string",
            "perUnitDeclaredValue": {
                "currencyCode": "string",
                "amount": "string"
            },
            "perUnitPrice": {
                "currencyCode": "string",
                "amount": "string"
            },
            "perUnitTax": {
                "currencyCode": "string",
                "amount": "string"
            }
        }
    ],
    "paymentInformation": [
        {
            "paymentTransactionId": "string",
            "paymentMode": "string",
            "paymentDate": "2019-08-24T14:15:22Z"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders' \
--header 'Content-Type: application/json' \
--data-raw '{
    "marketplaceId": "string",
    "sellerFulfillmentOrderId": "string",
    "displayableOrderId": "string",
    "displayableOrderDate": "2019-08-24T14:15:22Z",
    "displayableOrderComment": "string",
    "shippingSpeedCategory": "Standard",
    "deliveryWindow": {
        "startDate": "2019-08-24T14:15:22Z",
        "endDate": "2019-08-24T14:15:22Z"
    },
    "destinationAddress": {
        "name": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "addressLine3": "string",
        "city": "string",
        "districtOrCounty": "string",
        "stateOrRegion": "string",
        "postalCode": "string",
        "countryCode": "string",
        "phone": "string"
    },
    "deliveryPreferences": {
        "deliveryInstructions": "string",
        "dropOffLocation": {
            "type": "FRONT_DOOR",
            "attributes": {
                "property1": "string",
                "property2": "string"
            }
        }
    },
    "fulfillmentAction": "Ship",
    "fulfillmentPolicy": "FillOrKill",
    "codSettings": {
        "isCodRequired": true,
        "codCharge": {
            "currencyCode": "string",
            "amount": "string"
        },
        "codChargeTax": {
            "currencyCode": "string",
            "amount": "string"
        },
        "shippingCharge": {
            "currencyCode": "string",
            "amount": "string"
        },
        "shippingChargeTax": {
            "currencyCode": "string",
            "amount": "string"
        }
    },
    "shipFromCountryCode": "string",
    "notificationEmails": [
        "string"
    ],
    "featureConstraints": [
        {
            "featureName": "string",
            "featureFulfillmentPolicy": "Required"
        }
    ],
    "items": [
        {
            "sellerSku": "string",
            "sellerFulfillmentOrderItemId": "string",
            "quantity": 0,
            "giftMessage": "string",
            "displayableComment": "string",
            "fulfillmentNetworkSku": "string",
            "perUnitDeclaredValue": {
                "currencyCode": "string",
                "amount": "string"
            },
            "perUnitPrice": {
                "currencyCode": "string",
                "amount": "string"
            },
            "perUnitTax": {
                "currencyCode": "string",
                "amount": "string"
            }
        }
    ],
    "paymentInformation": [
        {
            "paymentTransactionId": "string",
            "paymentMode": "string",
            "paymentDate": "2019-08-24T14:15:22Z"
        }
    ]
}'

返回响应

🟢200成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

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

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

`createFulfillmentOrder`操作的响应模式。

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服务器故障