SKU 在庫を検索
Enterprise-only. Returns warehouse-scoped SKU inventory rows for the authenticated account, using cursor-based pagination. Each row carries the total quantity and the availableQuantity for one SKU in one warehouse; the same SKU held in different warehouses appears as separate rows. Omitting both warehouseIdList and skuList returns rows across every warehouse owned by the account.
quantity と availableQuantity の両方を報告します。
行は倉庫と SKU をキーとする
同じ SKU が複数の倉庫に存在する場合は、別々の行として返されます(倉庫ごとに 1 行)。レスポンスの 1 行はwarehouseId + sku の組み合わせで一意に識別され、searchTotalCount は相異なる SKU 値の数ではなく「倉庫-SKU」行数を数えます。単一の倉庫のみを見るには warehouseIdList を渡してください。
ページネーション
このエンドポイントはカーソルベースのページネーションを使用します。各レスポンスにはnextCursor と previousCursor が含まれます。
nextCursorは次のページのカーソルです。最後のページに達した場合はnullになります。previousCursorは前のページのカーソルです。最初のページではnullになります。
nextCursor の値を cursor クエリパラメータとして渡し、isForward=true を指定します。1 つのページネーションシーケンス内では、同じ pageSize(および任意の warehouseIdList / skuList フィルタ)を維持してください。
availableQuantity は事前の可用性チェックのためのサマリー値であり、予約ではありません。投影の遅延によりリアルタイムの返品在庫と一時的に異なることがあり、保留中の VAS を持ち実際には resend 対象外のレコードを数える場合もあります。SKU で Resend を作成が、リクエスト時に MySQL に対して権威的かつロックされた割り当てを行います。関連
- SKU 在庫の件数を取得 — 同じフィルタに一致する「倉庫-SKU」行の総数。
- SKU で Resend を作成 — 返品在庫 ID ではなく SKU 数量で resend を作成します。
承認
Your API key
Your API token — keep this private
クエリパラメータ
Number of warehouse-SKU rows to return per page. Required. Minimum 1, maximum 1000.
1 <= x <= 1000Opaque, versioned cursor token encoding cursor version, warehouse ID, and SKU. Pass the nextCursor (or previousCursor) from a previous response to fetch the adjacent page. Omit to fetch the first page. Cursors issued by the previous (pre-redesign) version of this endpoint are rejected — restart pagination without a cursor.
Pagination direction. Set true to page forward through results using the returned nextCursor. Defaults to false when omitted. Optional.
Comma-separated list of warehouse IDs to filter by (e.g. 1001,1002). When provided, each value must be a positive integer, the list must contain no duplicates, the number of entries must not exceed 100, and every warehouse must be owned by the authenticated account. Omit to return rows across all owned warehouses. Optional.
Comma-separated list of SKUs to filter by (e.g. SKU-006,SKU-001). When provided, the number of entries must not exceed 100 and each SKU must match the SKU pattern (alphanumerics plus #, -, _; maximum 32 characters). SKUs are matched after trim and uppercase normalization. Omit to return all SKUs. Optional.
レスポンス
Success
Cursor-paginated list of SKU inventory records. The business payload (nextCursor, previousCursor, data) is returned as top-level fields alongside the standard correlationId and meta envelope.
Cursor token for the next page, or null when there is no next page. Pass it back as cursor with isForward=true to page forward.
Cursor token for the previous page, or null when there is no previous page.
SKU inventory records for the current page