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

根据您指定的运输标准，返回履行订单预览的列表。

使用计划：

速率（每秒请求次数）	突发
2	30

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

请求参数

Body 参数application/json

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

marketplaceId

string

可选

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

address

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

可选

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

items

array[object (GetFulfillmentPreviewItem) {4}]

必需

一组履行预览项目信息。

sellerSku

string

必需

该商品的卖家SKU。

<= 50 字符

quantity

integer <int32>

物品数量。

必需

perUnitDeclaredValue

object (Money)

可选

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

sellerFulfillmentOrderItemId

string

必需

卖方创建的用于在履行预览中跟踪商品的履行订单项目标识符。

<= 50 字符

shippingSpeedCategories

array[string]

运输速度类别列表

可选

枚举值:

StandardExpeditedPriorityScheduledDelivery

includeCODFulfillmentPreview

boolean

可选

当为真时，返回所有的履行订单预览，无论是货到付款还是非货到付款。否则，仅返回非货到付款的履行订单预览。

includeDeliveryWindows

boolean

可选

如果为真，返回 ScheduledDeliveryInfo 响应对象，其中包含计划交付的可用交付时间窗口。ScheduledDeliveryInfo 响应对象仅能用于 ShippingSpeedCategories = ScheduledDelivery 的履行订单预览。

featureConstraints

array[object (FeatureSettings) {2}]

可选

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

featureName

string

功能的名称。

可选

featureFulfillmentPolicy

enum<string>

可选

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

枚举值:

RequiredNotRequired

示例

{
  "marketplaceId": "string",
  "address": {
    "name": "string",
    "addressLine1": "string",
    "addressLine2": "string",
    "addressLine3": "string",
    "city": "string",
    "districtOrCounty": "string",
    "stateOrRegion": "string",
    "postalCode": "string",
    "countryCode": "string",
    "phone": "string"
  },
  "items": [
    {
      "sellerSku": "string",
      "quantity": 0,
      "perUnitDeclaredValue": {
        "currencyCode": "string",
        "value": "string"
      },
      "sellerFulfillmentOrderItemId": "string"
    }
  ],
  "shippingSpeedCategories": [
    "Standard"
  ],
  "includeCODFulfillmentPreview": true,
  "includeDeliveryWindows": true,
  "featureConstraints": [
    {
      "featureName": "string",
      "featureFulfillmentPolicy": "Required"
    }
  ]
}

示例代码

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

`getFulfillmentPreview` 操作的响应模式。

payload

object (GetFulfillmentPreviewResult)

可选

履行订单预览列表，包括预计运输重量、预计运输费用、预计发货日期和预计到达日期。

fulfillmentPreviews

array[object (FulfillmentPreview) {11}]

一组履行预览信息。

可选

errors

array[object (Error) {3}]

可选

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

code

string

必需

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

message

string

必需

描述错误状态的消息。

details

string

可选

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

示例

{
  "payload": {
    "fulfillmentPreviews": [
      {
        "shippingSpeedCategory": "Standard",
        "scheduledDeliveryInfo": {
          "deliveryTimeZone": "string",
          "deliveryWindows": [
            {
              "startDate": "2019-08-24T14:15:22Z",
              "endDate": "2019-08-24T14:15:22Z"
            }
          ]
        },
        "isFulfillable": true,
        "isCODCapable": true,
        "estimatedShippingWeight": {
          "unit": "KG",
          "value": "string"
        },
        "estimatedFees": [
          {
            "name": "FBAPerUnitFulfillmentFee",
            "amount": {
              "currencyCode": "string",
              "value": "string"
            }
          }
        ],
        "fulfillmentPreviewShipments": [
          {
            "earliestShipDate": "2019-08-24T14:15:22Z",
            "latestShipDate": "2019-08-24T14:15:22Z",
            "earliestArrivalDate": "2019-08-24T14:15:22Z",
            "latestArrivalDate": "2019-08-24T14:15:22Z",
            "shippingNotes": [
              "string"
            ],
            "fulfillmentPreviewItems": [
              {
                "sellerSku": "string",
                "quantity": 0,
                "sellerFulfillmentOrderItemId": "string",
                "estimatedShippingWeight": {
                  "unit": "KG",
                  "value": "string"
                },
                "shippingWeightCalculationMethod": "Package"
              }
            ]
          }
        ],
        "unfulfillablePreviewItems": [
          {
            "sellerSku": "string",
            "quantity": 0,
            "sellerFulfillmentOrderItemId": "string",
            "itemUnfulfillableReasons": [
              "string"
            ]
          }
        ],
        "orderUnfulfillableReasons": [
          "string"
        ],
        "marketplaceId": "string",
        "featureConstraints": [
          {
            "featureName": "string",
            "featureFulfillmentPolicy": "Required"
          }
        ]
      }
    ]
  },
  "errors": [
    {
      "code": "string",
      "message": "string",
      "details": "string"
    }
  ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障