WMS 入庫 API
最終更新 2026-10-13
入庫伝票の作成・照会、受領行の確定、ワンクリック受領、受領タスク。
入庫伝票の作成#
POST /api/wms/inbound-receipts
{
"warehouse_id": "<uuid>", // required
"source_type": "purchase", // required: purchase|manual|portal|drayage|return
"source_id": "<purchase-order-uuid>", // required when source_type=purchase
"merchant_id": "<uuid>", // optional (auto-filled in standard edition)
"container_no": "MSKU1234567",
"seal_no": "S98765",
"vendor_id": "<uuid>",
"expected_date": "2026-10-20",
"title": "货权标识（缺省为 merchant 名）",
"lines": [
{ "item_id": "<uuid>", "expected_qty": 100, "uom": "CTN", "lot_no": "LOT-001" }
]
}- source_type は purchase / manual / portal / drayage / return のいずれか。
- 生成された伝票番号 receipt_no（RCPT-YYYYMMDD-XXXX）が data に返されます。
- 権限：wms.inbound.create。
入庫伝票の照会#
GET /api/wms/inbound-receipts?q=MSKU1234567&status=receiving&warehouse_id=<uuid>&page=1&page_size=20
GET /api/wms/inbound-receipts/<id> // lines + receiving progress + item names受領行の確定#
POST /api/wms/inbound-receipts/<receipt-id>/receive-line
{
"receipt_line_id": "<uuid>", // required
"received_qty": 98, // required, >= 0
"damaged_qty": 2,
"rejected_qty": 0,
"location_id": "<uuid>", // required (may be empty for cross-dock)
"lot_no": "LOT-001",
"manufacture_date": "2026-09-01",
"expiry_date": "2027-09-01",
"serial_nos": ["SN-001", "SN-002"],
"is_cross_dock": false,
"condition": "good", // good | damaged
"allow_over_receive": false,
"note": "外箱轻微破损"
}- ロット／有効期限／シリアル番号は厳密に検証されます（v2）。
- デスクトップのワンクリック受領：POST /api/wms/inbound-receipts/[id]/receive-all、Body は { lines: [{ line_id, received_qty, location_id }] }。
- 受領完了：POST /api/wms/inbound-receipts/[id]/complete-receive；伝票クローズ：POST /api/wms/inbound-receipts/[id]/close（received → closed、以後変更不可）。
受領タスク#
POST /api/wms/receiving-tasks
{
"receipt_id": "<uuid>", // required
"assignee_id": "<uuid>", // optional
"receiving_method": "decide" // palletized | direct | decide (default decide)
}
// idempotent: an existing open task for the receipt returns meta.existing=true
GET /api/wms/tasks?task_type=receive&status=in_progress&warehouse_id=<uuid>&with_progress=1伝票ステータス：imported / new → receiving → received → closed。受領行 API は new / imported / receiving が必要です（checked_in は旧データ互換）。受領タスク作成後、その伝票のデスクトップ直接受領はロックされます。