在庫を同期する

在庫数量を取得し、外部システムに反映する流れをまとめます。

​

概要

在庫一覧を定期取得し、必要に応じて作成APIで Upsert します。

​

同期の設計

• 同期対象のロケーション・倉庫を決める
• 更新頻度を決める（例: 15分ごと / 1時間ごと）

​

在庫一覧を取得する

curl -X GET "https://api.sanka.com/v1/public/inventories" \
  -H "Authorization: Bearer <access_token>"

レスポンス例:

{
  "data": [
    {
      "id": "inv_456",
      "name": "りんご（通常在庫）",
      "available": 120,
      "committed": 20,
      "total_inventory": 140,
      "updated_at": "2026-01-20T12:00:00Z"
    }
  ]
}

​

在庫を反映する

• available を基本在庫として扱う
• 予約在庫が必要なら committed を利用
• 変更を送るときは 在庫作成 を使い、external_id でUpsertする