LastMile 配送と返品:証明・追跡・引取
最終更新 2026-10-14
POD(署名・写真・バーコード・OTP)付き LMD- 配送、公開追跡リンク、失敗時の再配車、LRT- 返品。
配送(LMD-)は「この荷物をこの人に届ける」タスク、返品(LRT-)は逆の「顧客先へ行き商品を引き取る」タスクです。日々の配達は配送、拒否・返品の引取は返品を使います。

配送の一生#
- 配送を作成:受取人・住所・電話・数量・荷姿。種別は通常 delivery、返品引取は pickup_delivery。
- ルートまたはドライバーに割当(pending → assigned)。ドライバーはモバイルで出発時に in_transit、到着時に arrived(イベント記録のみ、ステータス不変)。
- 玄関で POD を取得 → delivered に。到達時刻とイベントを記録。
POD:配達の証明#
POD とは「配達証明」です。署名(スマホに署名)、写真、バーコード、OTP(配送に保存されたコードと一致必須)の 4 方式。モバイルで「配達完了」時は署名・写真・バーコードのいずれかが必須です。
顧客自身で追跡#
各配送に 128 ビットの追跡トークン(推測不能)が付きます。リンクを顧客に共有すればログイン不要で確認可能。表示は非機密情報のみ:配送番号・ステータス・受取人・ETA・イベント履歴。電話番号・詳細住所は表示されません。
配達失敗と返品#
- 配達失敗(in_transit → failed):理由必須。再配車可能(failed → assigned)。イベント履歴に全記録、キャンセルは note イベントで記録。
- 返品(LRT-)を作成:配送または集荷への紐付けと理由が必須。「引取要」にチェックすると集荷タスク(または pickup_delivery)を自動作成し、pickup_scheduled へ。
- ドライバーが引取(picked_up)→ ハブ到着(received_at_hub)→ 返金(refunded)で完了。pending / cancelled の返品は削除可能です。
顧客通知(SMS/メール)は P1 から実際に送信されます:SMS はテナントの Twilio、メールは Resend 経由。送信前にプレビューで文面を確認;送信(成功/失敗)はすべて通知ログに記録されます。
ドライバーアプリは例外報告・GPS 自動送信も行います(ダッシュボードで可視化)。他人のタスクは操作不可(403 NOT_YOUR_TASK)。