query_inbound_shipments
FBA INBOUND SHIPMENTS — the app's Inventory › Inbound shipments panel, the same service the page calls (POST /v2/shipments): every shipment of the last 18 months at its CURRENT state, one record per shipment with its SKU lines (quantity shipped and received per SKU). Answers: what is on its way to Amazon, what Amazon has received so far, which closed shipments came up short (the reconciliation list), which SKU or ASIN has units in transit. category is the panel's own split: planned (WORKING / READY_TO_SHIP — units still with the seller, NOT inbound yet), in_progress (SHIPPED / IN_TRANSIT / DELIVERED / CHECKED_IN / RECEIVING with units still to receive), closed_incomplete (CLOSED and received < shipped), closed_complete (CLOSED and received >= shipped — Amazon sometimes receives more than declared). With sku or asin the category is judged on THAT product's lines, not on the whole shipment. ⚠️ Three things Amazon does not give, so neither does this tool: NO DATES (the inbound API exposes no shipped-at / received-at; fetchedAt is when Nova last read the shipment, nightly at 01:30 UTC, never a business date — within a category rows come in lifecycle order, and by missing units for closed_incomplete); marketplaceId is the marketplace Nova asked Amazon for, not where the shipment lives (the API ignores it) — read stockLocation / fcCountry, derived from the destination FC code; NO SHIPMENT COST anywhere (the inbound fees are query_metrics' fee keys, per SKU and day). isFromAwd flags an AWD → FBA replenishment leaving Amazon's own warehouse, not the seller's. Not a metrics tool: no period, no aggregation — read the counts off the records, or ask query_inventory for totalFbaIncoming / inboundUnits per SKU. SUMMARY (summary=true, 2026-10-22): the counters behind the Inventory page's « N shipments » pill, per product × stock location (POST /v2/shipments/summary), for the skus and / or asins given (a SKU on its own lines, an ASIN over all its SKUs), in stockLocation or in every location: openCount (shipments on their way: they left the seller and units are still to receive), awdCount (of them, the AWD → FBA replenishments), plannedCount (WORKING / READY_TO_SHIP, nothing left yet), incompleteCount (CLOSED with fewer units received than shipped), inboundUnits (the product's units still expected on the open ones) and missingUnits (its units never received on the closed ones); a product × location with none of these has no entry. At most 400 product × location pairs a call. On the list, dateFrom / dateTo bound fetchedAt and sortBy / sortOrder rank the shipments by one of the panel's columns.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sku | No | Only shipments carrying this SKU; the category is judged on its lines. | |
| asin | No | Only shipments carrying this ASIN; the category is judged on its lines. | |
| skus | No | With summary=true: the SKUs to count, each on its own lines. | |
| asins | No | With summary=true: the ASINs to count, over all their SKUs. | |
| limit | No | ||
| dateTo | No | Keep the shipments Nova last read (fetchedAt) on or before this day, the whole day (YYYY-MM-DD, UTC). | |
| offset | No | Row offset for pagination (default 0). | |
| reason | No | One sentence, ALWAYS IN ENGLISH (regardless of the conversation language), on WHY you are making this call — the user question or your analytical goal. Recorded so the seller can see how their data is used. | |
| sortBy | No | Rank the shipments by this column of the panel instead of each category's own order (lifecycle; missing units first for closed_incomplete). | |
| summary | No | true = the per product × stock location counters of the page's shipment pill (SUMMARY above) instead of the shipments: needs `skus` and / or `asins`; `stockLocation` keeps one location (a stock region such as 'EU_FBA' is read as its location), omit it for every location. | |
| accounts | No | Restrict to a subset of your own seller account IDs (from list_accounts). Omit to include all your accounts. A brand/account name is accepted and resolved to its id when it matches one of your accounts unambiguously; a label that carries the id ("Brand (A1B2C3D4E5F6G)") resolves to that id. | |
| category | No | The panel's bucket: planned | in_progress (on the way) | closed_incomplete | closed_complete. Omit for every tracked shipment. | |
| dateFrom | No | Keep the shipments Nova last read (fetchedAt) on or after this day (YYYY-MM-DD, UTC). fetchedAt is never a business date. | |
| statuses | No | Amazon statuses to keep (WORKING, READY_TO_SHIP, SHIPPED, IN_TRANSIT, DELIVERED, CHECKED_IN, RECEIVING, CLOSED). Prefer `category`. | |
| sortOrder | No | With sortBy: desc (default) = highest first; asc = lowest first. | |
| searchText | No | Free text over the shipment id, its name and the destination FC code. | |
| shipmentId | No | One FBA shipment id (FBA…). | |
| stockLocation | No | Destination stock pool, from the FC code: USA, Canada, Mexico, Brazil, UK, Pan-EU, India, Japan, Australia, UAE, Singapore, Egypt. With summary=true, omit it to count every location. |