getOrder

返回您指定的订单。

使用计划：

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

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

返回响应

🟢200成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

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

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

`getOrder` 操作的响应模式。

payload

object (Order)

订单信息。

可选

AmazonOrderId

string

必需

亚马逊定义的订单标识符，格式为3-7-7。

SellerOrderId

string

可选

卖方定义的订单标识符。

PurchaseDate

string

订单创建的日期。

必需

LastUpdateDate

string

必需

订单最后更新的日期。

注意：对于在2009年4月1日之前最后更新的订单，LastUpdateDate返回的是错误的日期。

OrderStatus

enum<string>

当前订单状态。

必需

枚举值:

PendingUnshippedPartiallyShippedShippedCanceledUnfulfillableInvoiceUnconfirmedPendingAvailability

FulfillmentChannel

enum<string>

可选

订单是由亚马逊（AFN）履行还是由卖家（MFN）履行。

枚举值:

MFNAFN

SalesChannel

string

可选

订单中第一项商品的销售渠道。

OrderChannel

string

可选

订单中第一项的订单渠道。

ShipServiceLevel

string

可选

订单的发货服务级别。

OrderTotal

object (Money)

订单的货币价值。

可选

NumberOfItemsShipped

integer

发货商品的数量。

可选

NumberOfItemsUnshipped

integer

未发货的商品数量。

可选

PaymentExecutionDetail

array[object (PaymentExecutionDetailItem) {2}]

可选

付款执行详细项目清单。

PaymentMethod

enum<string>

可选

订单的支付方式。此属性仅限于货到付款（COD）和便利店（CVS）支付方式。除非您需要PaymentExecutionDetailItem对象提供的特定COD支付信息，否则我们建议使用PaymentMethodDetails属性来获取支付方式信息。

枚举值:

CODCVSOther

PaymentMethodDetails

array[string]

可选

支付方式详细项列表。

MarketplaceId

string

可选

订单所在市场的标识符。

ShipmentServiceLevelCategory

string

可选

订单的运输服务级别类别。

可能的值：加急, 免费经济, 次日, 优先, 当天, 第二天, 定期, 标准.

EasyShipShipmentStatus

enum<string>

可选

亚马逊易送订单的状态。此属性仅适用于亚马逊易送订单。

枚举值:

PendingSchedulePendingPickUpPendingDropOffLabelCanceledPickedUpDroppedOffAtOriginFCAtDestinationFCDeliveredRejectedByBuyerUndeliverableReturningToSellerReturnedToSellerLostOutForDeliveryDamaged

CbaDisplayableShippingLabel

string

可选

亚马逊结账定制货运标签 (CBA)。

OrderType

enum<string>

订单的类型。

可选

枚举值:

StandardOrderLongLeadTimeOrderPreorderBackOrderSourcingOnDemandOrder

EarliestShipDate

string

可选

您承诺发货订单的时间段的开始。在 ISO 8601 日期时间格式中。仅适用于卖家履行的订单。

注意：对于 2013 年 2 月 1 日之前下的订单，可能不会返回 EarliestShipDate。

LatestShipDate

string

可选

您承诺发货订单的时间期限结束。在ISO 8601日期时间格式中。仅对卖家履行的订单返回。

注意：对于在2013年2月1日之前下的订单，可能不会返回LatestShipDate。

EarliestDeliveryDate

string

可选

您承诺履行订单的时间段开始。采用ISO 8601日期时间格式。仅针对卖家履行的订单返回。

LatestDeliveryDate

string

可选

您承诺履行订单的时间段结束。在ISO 8601日期时间格式中返回。仅针对没有“待定可用性”、待处理或已取消状态的卖家履行订单。

IsBusinessOrder

boolean

可选

当为真时，该订单为亚马逊商业订单。亚马逊商业订单是指买方为经过验证的商业买家下的订单。

IsPrime

boolean

可选

当为真时，此订单为卖方履行的亚马逊Prime订单。

IsPremiumOrder

boolean

可选

当为真时，该订单具有优先配送服务级别协议。有关优先配送订单的更多信息，请参阅您所在市场的卖家中心帮助中的“优先配送选项”。

IsGlobalExpressEnabled

boolean

可选

当为真时，该订单为全球快递订单。

ReplacedOrderId

string

可选

被替换订单的订单 ID 值。仅在 IsReplacementOrder = true 时返回。

IsReplacementOrder

boolean

可选

当为真时，这是一个替换订单。

PromiseResponseDueDate

string

可选

指示卖方必须在此日期之前回复买方，并提供预计发货日期。仅适用于按需采购订单。

IsEstimatedShipDateSet

boolean

可选

当为真时，订单的预计发货日期被指定。仅适用于按需采购订单。

IsSoldByAB

boolean

可选

当为真时，此订单中的商品由亚马逊商业欧盟有限责任公司（ABEU）购买并转售。通过购买并即时转售您的商品，ABEU成为记录中的卖方，使您的库存能够出售给那些无意向从第三方卖家购买的客户。

IsIBA

boolean

可选

DefaultShipFromLocationAddress

object (Address)

订单的配送地址。

可选

BuyerInvoicePreference

enum<string>

可选

买方的发票偏好。卖家可以使用这些数据为土耳其的订单开具电子发票。

注：此属性仅在土耳其市场可用。

枚举值:

INDIVIDUALBUSINESS

BuyerTaxInformation

object (BuyerTaxInformation)

可选

包含商业发票税务信息。仅在TR市场可用。

FulfillmentInstruction

object (FulfillmentInstruction)

可选

包含关于履行的说明，例如应从哪里履行。

IsISPU

boolean

可选

当为真时，该订单标记为从店内取货，而不是送货。

IsAccessPointOrder

boolean

可选

当为真时，此订单被标记为送往取件点。访问位置由客户选择。取件点包括亚马逊自提柜、亚马逊自提服务台和由承运商运营的提货点。

MarketplaceTaxInfo

object (MarketplaceTaxInfo)

市场的税务信息。

可选

SellerDisplayName

string

可选

卖家在进行销售的市场中注册的友好名称。卖家可以使用这些数据为在巴西的订单开具电子发票。

注意：此属性仅在巴西市场适用于状态为“待处理”或“未发货”的订单。

ShippingAddress

object (Address)

订单的配送地址。

可选

BuyerInfo

object (BuyerInfo)

买方信息。

可选

AutomatedShippingSettings

object (AutomatedShippingSettings)

可选

包含有关运输设置自动化程序的信息，例如订单的运输设置是否是自动生成的，以及这些设置是什么。

HasRegulatedItems

boolean

可选

该订单是否包含可能需要额外批准步骤才能完成的受管制物品。

ElectronicInvoiceStatus

enum<string>

可选

电子发票的状态。仅适用于Easy Ship订单和BR市场中的订单。

枚举值:

NotRequiredNotFoundProcessingErroredAccepted

errors

array[object (Error) {3}]

可选

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

code

string

必需

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

message

string

必需

描述错误状态的消息。

details

string

可选

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

示例

{
    "payload": {
        "AmazonOrderId": "902-3159896-1390916",
        "PurchaseDate": "2017-01-20T19:49:35Z",
        "LastUpdateDate": "2017-01-20T19:49:35Z",
        "OrderStatus": "Pending",
        "FulfillmentChannel": "SellerFulfilled",
        "NumberOfItemsShipped": 0,
        "NumberOfItemsUnshipped": 0,
        "PaymentMethod": "Other",
        "PaymentMethodDetails": [
            "CreditCard",
            "GiftCerificate"
        ],
        "MarketplaceId": "ATVPDKIKX0DER",
        "ShipmentServiceLevelCategory": "Standard",
        "OrderType": "StandardOrder",
        "EarliestShipDate": "2017-01-20T19:51:16Z",
        "LatestShipDate": "2017-01-25T19:49:35Z",
        "IsBusinessOrder": false,
        "IsPrime": false,
        "IsGlobalExpressEnabled": false,
        "IsPremiumOrder": false,
        "IsSoldByAB": false,
        "IsIBA": false,
        "DefaultShipFromLocationAddress": {
            "Name": "MFNIntegrationTestMerchant",
            "AddressLine1": "2201 WESTLAKE AVE",
            "City": "SEATTLE",
            "StateOrRegion": "WA",
            "PostalCode": "98121-2778",
            "CountryCode": "US",
            "Phone": "+1 480-386-0930 ext. 73824",
            "AddressType": "Commercial"
        },
        "FulfillmentInstruction": {
            "FulfillmentSupplySourceId": "sampleSupplySourceId"
        },
        "IsISPU": false,
        "IsAccessPointOrder": false,
        "ShippingAddress": {
            "Name": "Michigan address",
            "AddressLine1": "1 Cross St.",
            "City": "Canton",
            "StateOrRegion": "MI",
            "PostalCode": "48817",
            "CountryCode": "US"
        },
        "BuyerInfo": {
            "BuyerEmail": "user@example.com",
            "BuyerName": "John Doe",
            "BuyerTaxInfo": {
                "CompanyLegalName": "A Company Name"
            },
            "PurchaseOrderNumber": "1234567890123"
        },
        "AutomatedShippingSettings": {
            "HasAutomatedShippingSettings": false
        }
    }
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障

请求参数

示例代码

返回响应