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

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

使用计划：

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

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

请求参数

Body 参数application/json

提交确认操作的请求模式。

orderAcknowledgements

array[object (OrderAcknowledgementItem) {7}]

可选

一个或多个采购订单的列表。

purchaseOrderNumber

string

必需

该订单的采购订单编号。格式说明：字母数字代码。

vendorOrderNumber

string

必需

此订单的供应商订单号。

acknowledgementDate

string <date-time>

必需

订单确认的日期和时间，采用ISO-8601日期/时间格式。例如：2018-07-16T23:00:00Z / 2018-07-16T23:00:00-05:00 / 2018-07-16T23:00:00-08:00。

acknowledgementStatus

object (AcknowledgementStatus)

确认状态。

必需

sellingParty

object (PartyIdentification)

必需

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

shipFromParty

object (PartyIdentification)

必需

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

itemAcknowledgements

array[object (OrderItemAcknowledgement) {4}]

必需

物品详情，包括确认数量。

示例

{
    "orderAcknowledgements": [
        {
            "purchaseOrderNumber": "string",
            "vendorOrderNumber": "string",
            "acknowledgementDate": "2019-08-24T14:15:22Z",
            "acknowledgementStatus": {
                "code": "string",
                "description": "string"
            },
            "sellingParty": {
                "partyId": "string",
                "address": {
                    "name": "string",
                    "attention": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "taxInfo": {
                    "taxRegistrationType": "VAT",
                    "taxRegistrationNumber": "string",
                    "taxRegistrationAddress": {
                        "name": "string",
                        "attention": "string",
                        "addressLine1": "string",
                        "addressLine2": "string",
                        "addressLine3": "string",
                        "city": "string",
                        "county": "string",
                        "district": "string",
                        "stateOrRegion": "string",
                        "postalCode": "string",
                        "countryCode": "string",
                        "phone": "string"
                    },
                    "taxRegistrationMessages": "string"
                }
            },
            "shipFromParty": {
                "partyId": "string",
                "address": {
                    "name": "string",
                    "attention": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "taxInfo": {
                    "taxRegistrationType": "VAT",
                    "taxRegistrationNumber": "string",
                    "taxRegistrationAddress": {
                        "name": "string",
                        "attention": "string",
                        "addressLine1": "string",
                        "addressLine2": "string",
                        "addressLine3": "string",
                        "city": "string",
                        "county": "string",
                        "district": "string",
                        "stateOrRegion": "string",
                        "postalCode": "string",
                        "countryCode": "string",
                        "phone": "string"
                    },
                    "taxRegistrationMessages": "string"
                }
            },
            "itemAcknowledgements": [
                {
                    "itemSequenceNumber": "string",
                    "buyerProductIdentifier": "string",
                    "vendorProductIdentifier": "string",
                    "acknowledgedQuantity": {
                        "amount": 0,
                        "unitOfMeasure": "Each"
                    }
                }
            ]
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/orders/2021-12-28/acknowledgements' \
--header 'Content-Type: application/json' \
--data-raw '{
    "orderAcknowledgements": [
        {
            "purchaseOrderNumber": "string",
            "vendorOrderNumber": "string",
            "acknowledgementDate": "2019-08-24T14:15:22Z",
            "acknowledgementStatus": {
                "code": "string",
                "description": "string"
            },
            "sellingParty": {
                "partyId": "string",
                "address": {
                    "name": "string",
                    "attention": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "taxInfo": {
                    "taxRegistrationType": "VAT",
                    "taxRegistrationNumber": "string",
                    "taxRegistrationAddress": {
                        "name": "string",
                        "attention": "string",
                        "addressLine1": "string",
                        "addressLine2": "string",
                        "addressLine3": "string",
                        "city": "string",
                        "county": "string",
                        "district": "string",
                        "stateOrRegion": "string",
                        "postalCode": "string",
                        "countryCode": "string",
                        "phone": "string"
                    },
                    "taxRegistrationMessages": "string"
                }
            },
            "shipFromParty": {
                "partyId": "string",
                "address": {
                    "name": "string",
                    "attention": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "taxInfo": {
                    "taxRegistrationType": "VAT",
                    "taxRegistrationNumber": "string",
                    "taxRegistrationAddress": {
                        "name": "string",
                        "attention": "string",
                        "addressLine1": "string",
                        "addressLine2": "string",
                        "addressLine3": "string",
                        "city": "string",
                        "county": "string",
                        "district": "string",
                        "stateOrRegion": "string",
                        "postalCode": "string",
                        "countryCode": "string",
                        "phone": "string"
                    },
                    "taxRegistrationMessages": "string"
                }
            },
            "itemAcknowledgements": [
                {
                    "itemSequenceNumber": "string",
                    "buyerProductIdentifier": "string",
                    "vendorProductIdentifier": "string",
                    "acknowledgedQuantity": {
                        "amount": 0,
                        "unitOfMeasure": "Each"
                    }
                }
            ]
        }
    ]
}'

返回响应

🟢202成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

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

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

包含交易ID的响应。

transactionId

string

可选

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

示例

{
    "transactionId": "string"
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障