The Selling Partner API for External Fulfillment Inventory Management (2024-09-11)

Download OpenAPI specification:Download

URL: https://sellercentral.amazon.com/gp/mws/contactus.html License: Amazon Software License

This section provides APIs for selling partners to work with External Fulfillment inventory services.

Usage Plan:

Rate (requests per second)	Burst
50	100

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may observe higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API

batchInventory

Returns the set of responses that correspond to the batched list of up to 10 requests defined in the request body. The response for each successful (HTTP status code 200) request in the set includes the inventory count for provided sku and locationId pair

Request Body schema: application/json

The batch of batchInventoryRequest. Using the same API user can perform update inventory operation as well as get inventory operation.

Array of objects (BatchInventoryRequestList) [ 1 .. 10 ] items

A batched list of Batch Inventory requests.

Responses

Request samples

Payload

Content type

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"
}
}
}
]
}

Response samples

Content type

application/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."
}
]
}
}
]
}