Inventories

class sp_api.api.Inventories(marketplace: Marketplaces = Marketplaces.US, *, refresh_token=None, account='default', credentials=None, restricted_data_token=None, proxies=None, verify=True, timeout=None, version=None, credential_providers=None)
Link:

https://github.com/amzn/selling-partner-api-docs/blob/main/references/fba-inventory-api/fbaInventory.md#getinventorysummaries

get_inventory_summary_marketplace(self, **kwargs) GetInventorySummariesResponse

Returns a list of inventory summaries. The summaries returned depend on the presence or absence of the startDateTime and sellerSkus parameters:

  • All inventory summaries with available details are returned when the startDateTime and sellerSkus parameters are omitted.

  • When startDateTime is provided, the operation returns inventory summaries that have had changes after the date and time specified. The sellerSkus parameter is ignored.

  • When the sellerSkus parameter is provided, the operation returns inventory summaries for only the specified sellerSkus.

Usage Plan:

Rate (requests per second)

Burst

2

2

For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.

All inventory summaries with available details are returned when the startDateTime and sellerSkus parameters are omitted. When startDateTime is provided, the operation returns inventory summaries that have had changes after the date and time specified. The sellerSkus parameter is ignored. When the sellerSkus parameter is provided, the operation returns inventory summaries for only the specified sellerSkus. Usage Plan:

Examples

literal blocks:

Inventories().get_inventory_summary_marketplace(**{
        "details": True,
        "marketplaceIds": ["ATVPDKIKX0DER"]
    })
Parameters:
  • details (key) – bool | true to return inventory summaries with additional summarized inventory details and quantities. Otherwise, returns inventory summaries only (default value). boolean “false”

  • granularityType (key) – Granularity Type | The granularity type for the inventory aggregation level. enum (GranularityType) -

  • granularityId (key) – str The granularity ID for the inventory aggregation level. string -

  • startDateTime (key) – datetime | A start date and time in ISO8601 format. If specified, all inventory summaries that have changed since then are returned. You must specify a date and time that is no earlier than 18 months prior to the date and time when you call the API. Note: Changes in inboundWorkingQuantity, inboundShippedQuantity and inboundReceivingQuantity are not detected. string (date-time) -

  • sellerSkus (key) – [str] | A list of seller SKUs for which to return inventory summaries. You may specify up to 50 SKUs.

  • nextToken (key) – str | String token returned in the response of your previous request. string -

  • marketplaceIds (key) – str | The marketplace ID for the marketplace for which to return inventory summaries.

Return type:

GetInventorySummariesResponse