batchInventory

北美(North America）

https://sellingpartnerapi-na.amazon.com

POST

/externalFulfillment/inventory/2024-09-11/inventories

最多提交10个库存请求。响应包含与请求对应的回复集。每个成功请求的响应都包括所提供的sku和locationId对的库存数量。

请求参数

Body 参数application/json必填

示例

{
    "requests": [
        {
            "method": "POST",
            "uri": "/inventory/update?locationId=EXSB&skuId=efptestsku1",
            "body": {
                "quantity": 15,
                "clientSequenceNumber": 12345678,
                "marketplaceAttributes": {
                    "marketplaceId": "AXJDDKDFDKDF",
                    "channelName": "FBA"
                }
            }
        },
        {
            "method": "POST",
            "uri": "/inventory/fetch?locationId=EXSB&skuId=efptestsku2",
            "body": {
                "marketplaceAttributes": {
                    "marketplaceId": "AXJDDKDFDKDF",
                    "channelName": "FBA"
                }
            }
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://sellingpartnerapi-na.amazon.com/externalFulfillment/inventory/2024-09-11/inventories' \
--header 'Content-Type: application/json' \
--data '{
    "requests": [
        {
            "method": "POST",
            "uri": "/inventory/update?locationId=EXSB&skuId=efptestsku1",
            "body": {
                "quantity": 15,
                "clientSequenceNumber": 12345678,
                "marketplaceAttributes": {
                    "marketplaceId": "AXJDDKDFDKDF",
                    "channelName": "FBA"
                }
            }
        },
        {
            "method": "POST",
            "uri": "/inventory/fetch?locationId=EXSB&skuId=efptestsku2",
            "body": {
                "marketplaceAttributes": {
                    "marketplaceId": "AXJDDKDFDKDF",
                    "channelName": "FBA"
                }
            }
        }
    ]
}'

返回响应

🟢207

application/json

包含多个资源信息的多状态响应。

Headers

Bodyapplication/json

示例

{
    "responses": [
        {
            "status": {
                "statusCode": 200,
                "reasonPhrase": "Success"
            },
            "body": {
                "locationId": "EXSB",
                "sellableQuantity": 20,
                "reservedQuantity": 5,
                "clientSequenceNumber": 12345678,
                "marketplaceAttributes": {
                    "marketplaceId": "AXJDDKDFDKDF",
                    "channelName": "FBA"
                },
                "skuId": "efptestsku1",
                "actionableErrors": []
            }
        },
        {
            "status": {
                "statusCode": 400,
                "reasonPhrase": "Invalid Input"
            },
            "body": {
                "skuId": "efptestsku2",
                "locationId": "EXSB",
                "actionableErrors": [
                    {
                        "errorType": "INVALID_SKU",
                        "errorSubType": "The requested Sku does not exist for the seller in requested marketplace."
                    }
                ]
            }
        }
    ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠413

🟠415

🟠429

🔴500服务器错误

🔴503服务器故障

修改于 2026-08-27 14:13:47

getInvoiceStatus

listReturns