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

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

使用计划：

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

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

请求参数

Body 参数application/json必填

示例

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢202成功

application/json

成功。

Headers

Bodyapplication/json

示例

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

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障