入荷：入庫伝票から格納完了まで

入庫伝票の作成、入荷モードの選択、パレット別・直接入荷——差異確認とラベル印刷を含む一連の流れ。

ステップ1：入庫伝票の作成#

WMS → Inbound Receipts（入庫伝票）で手動作成またはインポート作成します。手動作成では顧客/荷主（merchant一覧から選択、Titleはmerchantが既定で手入力不要）、PO番号、運送会社、コンテナ/トレーラー番号、BOL、シール番号、予定明細（SKU＋予定数量＋単位）を入力。インポートはCSVテンプレート方式：テンプレート取得→アップロード→検証→確認→確定。伝票番号は自動採番です。トラックにドック枠が必要な場合は WMS → Appointments で予約を作成（新規/一覧/編集/設定）；入荷自体に予約は必須ではありません。

ステップ2：入荷モードの選択#

入荷モードは倉庫単位の3択スイッチ（receiving_mode、既定 both）で、マスターデータ→倉庫編集で設定します：desktop（デスクトップ入荷のみ）、mobile（モバイル入荷のみ）、both（両方）。同一伝票を両側から同時操作しないようUI層で排他します。

デスクトップ入荷：Receiveドロップダウン#

1. パレット別入荷：Receive → Palletized を開きます。Summaryに製品ごとの行（SKU/品名、予定数量＋単位、組立済数量、残数）を表示。Buildで残数>0の明細を1件以上選び、1パレット数量とパレット数N（既定1）でN個の同一パレットを一括生成、Condition（Good/Damaged、パレット単位、既定Good）とstorageロケーション（必須、storage種別のみ）を指定。Build→Pallet欄に反映、Receive→差異確認（予定vs組立済を行ごとに確認）→確定で各パレットのstorageロケーションに在庫を一括計上（格納は統合済み、独立手順なし）→ received。その後パレットにチェックしてラベル印刷。
2. 直接入荷：モーダルに明細ごとの行を表示——実績数量（既定は残数）、ロケーション（必須、picking種別のみ、前後両端で検証）、Condition（Good/Damaged、既定Good）、Lot#、有効期限。Splitボタンで行を分割して別ロケーションに配置可能。Receive→差異確認→receive-batch APIで在庫計上。

• 差異ルール（デスクトップ＋モバイル共通）：過剰/不足の入荷はどちらも可。差異がある場合は確認ダイアログが予定vs実績を行ごとに表示（過剰は赤、不足は橙）し、明示的確認後にのみ確定します。
• Conditionは在庫ステータスに対応：Good → available、Damaged → damaged。
• ロケーション種別の制限：パレット組立はstorage種別のみ、直接入荷はpicking種別のみ。

モバイル入荷：Create Receive Task#

1. デスクトップの伝票詳細で Create Receive Task を押します（mobile/bothモードで表示）。ダイアログは担当者（組織メンバーのドロップダウン）と入荷方式の3択：パレット別（モバイルはパレット流のみ）/ 直接（直接流のみ）/ 実行時に決定（作業者が開始時に選択、既定）。送信でタスク生成（task_type=receive）。
2. モバイルでタスク詳細を開きます。固定モードは方式タグと開始ボタンを表示し直接そのフローへ、decideモードは2つの大きなカード（パレット別/直接）を表示→タップ→確認→タスクに反映。初回の入荷送信後に方式がロックされ、それまでは戻って選び直せます。
3. モバイルのパレット組立は4ステップ：①集計——製品カード（SKU/品名、予定、組立済、残数）；②組立——行選択＋1パレット数量、パレット数N、Condition、storageロケーション（スキャン/手入力/選択、storage種別のみ）→[組立]、繰り返し可；原廠ラベルモード：「原廠ラベル使用」にチェック後、パレットごとに原廠ラベルコードを入力（スキャン/手入力、バッチ内重複排除）、lpn=原廠コード・label_source=factoryでLPN採番と新規印刷をスキップ；③パレット——一覧、空パレットは削除可（確認あり）；④確認——差異確認→送信→成功ページにLPN一覧。ラベル印刷はモバイルでは行わず、成功ページに「ラベル生成済み、デスクトップで印刷」と表示（原廠モードは「原廠ラベル、印刷不要」）。
4. モバイル直接入荷（1画面カード）：明細ごとのカードに実績数量（既定は残数）、pickingロケーション（スキャン/選択、必須）、Condition、Lot#/有効期限（任意）、Splitボタンを配置。[入荷送信]で一括送信→差異確認→receive-batch。複数回送信が可能で、大口伝票は分割して入荷でき、全部入りで自動的にreceivedへ遷移します。
5. 完了時はタスクを閉じます：receive-completeが全数入荷を検証→伝票をreceivedへ＋購買数量を全量再計算。残数があればクローズはブロック（WMS_STATE_001）され、スーパーバイザーに対応を依頼します（拒否/伝票クローズ）。

入庫伝票の状態#

• new / imported → receiving（初回入荷操作で自動遷移）→ received（全数入荷）。
• 完了条件：全明細で received_qty + damaged_qty + rejected_qty ≥ expected_qty（デスクトップ/モバイル/タスククローズ共通）。
• 不足分はremainingとして残り（伝票はreceivingのまま）、またはスーパーバイザーがrejectedとして伝票をクローズします。