店舗向け

在庫API

保管場所ごとの在庫数を取得し、入出庫を記録します。棚卸しや補充の判断に使います。

api/v1/inventory ดูในเอกสารอ้างอิง API

รายการเอนด์พอยต์

เมธอด พาธ คำอธิบาย การตอบกลับ
GET /api/v1/inventory 在庫を一覧取得
保管場所・商品で在庫数を取得します。
 200
GET /api/v1/inventory/locations 保管場所を一覧取得
倉庫・バックヤードなど在庫を持つ場所を返します。
 200
GET /api/v1/inventory/{locationId}/{productId} 在庫数を取得
指定の場所・商品の在庫数を返します。
 200 404
POST /api/v1/inventory/adjust 在庫を調整
入庫・出庫・棚卸し差異を記録し、在庫数を更新します。
 200 400
GET /api/v1/inventory/movements 入出庫履歴を取得
いつ・どこで・いくつ動いたかを新しい順に返します。
 200

รายละเอียดเอนด์พอยต์

保管場所・商品で在庫数を取得します。

พาธแบบเต็ม: GET /api/v1/inventory
รหัสการตอบกลับ: 200

倉庫・バックヤードなど在庫を持つ場所を返します。

พาธแบบเต็ม: GET /api/v1/inventory/locations
รหัสการตอบกลับ: 200

指定の場所・商品の在庫数を返します。

พาธแบบเต็ม: GET /api/v1/inventory/{locationId}/{productId}
รหัสการตอบกลับ: 200 404

入庫・出庫・棚卸し差異を記録し、在庫数を更新します。

พาธแบบเต็ม: POST /api/v1/inventory/adjust
รหัสการตอบกลับ: 200 400

いつ・どこで・いくつ動いたかを新しい順に返します。

พาธแบบเต็ม: GET /api/v1/inventory/movements
รหัสการตอบกลับ: 200

ตัวอย่างคำขอ

คำขอ 
POST /api/v1/inventory/adjust
Authorization: Bearer {access_token}

{
  "locationId": "loc-001",
  "productId": "prd-001",
  "quantityDelta": 24,
  "reason": "restock"
}
การตอบกลับ 
{
  "locationId": "loc-001",
  "productId": "prd-001",
  "quantity": 124
}
เกี่ยวกับการยืนยันตัวตน

การใช้ API นี้ต้องมีเฮดเดอร์ Authorization: Bearer {access_token} โปรดดูวิธีขอ token ได้ที่คู่มือการยืนยันตัวตน

ดู API การยืนยันตัวตนและการเข้าถึง
ไปที่เอกสารอ้างอิง API