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

提交一个或多个采购订单的确认。

使用计划：

速率（每秒请求数）	突发
10	10

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

请求参数

Body 参数application/json

`submitAcknowledgment` 操作的请求架构。

acknowledgements

array[object (OrderAcknowledgement) {4}]

可选

要提交的一系列订单确认。

purchaseOrderNumber

string

必需

采购订单号。格式说明：8位字母数字代码。

sellingParty

object (PartyIdentification)

必需

一方的名称、地址和税务详情。

acknowledgementDate

string <date-time>

必需

采购订单被确认的日期和时间，采用ISO 8601日期/时间格式。

items

array[object (OrderAcknowledgementItem) {8}]

必需

一份被确认的项目列表及相关细节。

示例

{
    "acknowledgements": [
        {
            "purchaseOrderNumber": "string",
            "sellingParty": {
                "partyId": "string",
                "address": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "st",
                    "phone": "string"
                },
                "taxInfo": {
                    "taxRegistrationType": "VAT",
                    "taxRegistrationNumber": "string"
                }
            },
            "acknowledgementDate": "2019-08-24T14:15:22Z",
            "items": [
                {
                    "itemSequenceNumber": "string",
                    "amazonProductIdentifier": "string",
                    "vendorProductIdentifier": "string",
                    "orderedQuantity": {
                        "amount": 0,
                        "unitOfMeasure": "Cases",
                        "unitSize": 0
                    },
                    "netCost": {
                        "currencyCode": "str",
                        "amount": "string"
                    },
                    "listPrice": {
                        "currencyCode": "str",
                        "amount": "string"
                    },
                    "discountMultiplier": "string",
                    "itemAcknowledgements": [
                        {
                            "acknowledgementCode": "Accepted",
                            "acknowledgedQuantity": {
                                "amount": 0,
                                "unitOfMeasure": "Cases",
                                "unitSize": 0
                            },
                            "scheduledShipDate": "2019-08-24T14:15:22Z",
                            "scheduledDeliveryDate": "2019-08-24T14:15:22Z",
                            "rejectionReason": "TemporarilyUnavailable"
                        }
                    ]
                }
            ]
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/vendor/orders/v1/acknowledgements' \
--header 'Content-Type: application/json' \
--data-raw '{
    "acknowledgements": [
        {
            "purchaseOrderNumber": "string",
            "sellingParty": {
                "partyId": "string",
                "address": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "st",
                    "phone": "string"
                },
                "taxInfo": {
                    "taxRegistrationType": "VAT",
                    "taxRegistrationNumber": "string"
                }
            },
            "acknowledgementDate": "2019-08-24T14:15:22Z",
            "items": [
                {
                    "itemSequenceNumber": "string",
                    "amazonProductIdentifier": "string",
                    "vendorProductIdentifier": "string",
                    "orderedQuantity": {
                        "amount": 0,
                        "unitOfMeasure": "Cases",
                        "unitSize": 0
                    },
                    "netCost": {
                        "currencyCode": "str",
                        "amount": "string"
                    },
                    "listPrice": {
                        "currencyCode": "str",
                        "amount": "string"
                    },
                    "discountMultiplier": "string",
                    "itemAcknowledgements": [
                        {
                            "acknowledgementCode": "Accepted",
                            "acknowledgedQuantity": {
                                "amount": 0,
                                "unitOfMeasure": "Cases",
                                "unitSize": 0
                            },
                            "scheduledShipDate": "2019-08-24T14:15:22Z",
                            "scheduledDeliveryDate": "2019-08-24T14:15:22Z",
                            "rejectionReason": "TemporarilyUnavailable"
                        }
                    ]
                }
            ]
        }
    ]
}'

返回响应

🟢202成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

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

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

`submitAcknowledgement`操作的响应模式

payload

object (TransactionId)

可选

包含交易ID的响应。

transactionId

string

可选

亚马逊分配给此交易以识别的 GUID。此值可以与交易状态 API 一起使用，以返回此交易的状态。

errors

array[object (Error) {3}]

可选

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

code

string

必需

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

message

string

必需

描述错误状态的消息。

details

string

可选

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

示例

{
    "payload": {
        "transactionId": "20190827182357-8725bde9-c61c-49f9-86ac-46efd82d4da5"
    }
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障