宅配管理

1. システム概要

梨屋さんシステムズの農産物宅配管理システムは、農園・直売所・地域出荷事業者向けに、受注から配送、請求、入金までの一連業務を一体管理するWebアプリケーションです。

日々の受注入力や配送手配だけでなく、請求処理、回収状況の可視化、商品・送料マスタの保守、統計分析までを単一システムで実現します。

システムのコンセプト

• 現場業務の分断をなくし、同一データを受注・配送・請求で再利用
• 属人化しやすい送料判定・単価運用・請求作成を標準化
• 月次報告や経営判断に必要な売上・配送・回収データを即時参照

2. 対象ユーザー

• 農園・果樹園の事務担当
• 直売所や出荷センターの受注担当
• 配送・請求・入金管理を兼務するバックオフィス担当
• 管理者（システム設定・監査・分析担当）

3. 解決する課題

従来運用で起きやすい課題

• 注文台帳、配送台帳、請求台帳が別管理で転記ミスが発生
• 商品規格や送料条件が複雑で、担当者依存の判断になる
• 得意先別価格の運用履歴が追いづらく、単価誤設定が起きる
• 請求漏れ・入金消込漏れを月末まで検知しにくい
• 売れ筋分析や顧客傾向分析が手作業集計に依存

本システムでの改善

• 注文データを起点に配送・請求へ連携し、重複入力を削減
• 商品マスタと送料マスタを連動させ、入力時の整合性を担保
• 得意先別価格を有効期間付きで管理し、履歴・状態を明確化
• 請求・入金の状態を可視化して、未回収残高を継続監視
• 管理者向け統計画面で、時系列・ランキング分析を即実行

4. 業務機能（コア機能）

4.1 注文管理

• 送り主・配送先・商品明細を一体で管理
• 商品は販売単位ベースで選択
• 得意先価格は送り主を基準に適用
• 得意先価格が適用された明細は注文カード上で星アイコン表示
• 保存時に送料計算ロジックを実行し、注文金額へ反映
• 配送進捗（発送/持ち帰り等）を管理

4.2 請求・入金管理

• 確定済み注文から請求書を作成
• 請求書の明細内訳（商品・送料・税・調整額）を確認可能
• 入金登録による回収状況更新
• 未回収残高の把握と追跡

4.3 顧客管理

• 得意先情報と送付先情報を管理
• 検索・編集を実務向けUIで提供
• 顧客マスタは注文・請求で共通利用

4.4 商品設定（商品構造管理）

• 農産物
• 品種
• 商品内容（単品/詰め合わせ）
• 販売単位（規格・単位・基準価格・税区分）
• 得意先価格（顧客別・販売単位別・期間付き）

得意先価格機能の特長

• 顧客別に特別単価を設定可能
• 有効期間（開始日・終了日）と有効/無効状態を管理
• 利用中ルールの削除制御（安全性担保）
• 一覧UIで本来価格との差額・差率を可視化（負値は △ 表示）
• 販売単位ラベルは商品名と規格・単位を分けて表示し、視認性を向上

4.5 送料設定

• 配送業者、地域、配送規格、温度帯、料金テーブルを管理
• 対象販売単位を条件にした配送規格の絞り込み対応
• 条件競合時はルールに基づき最適料金を探索

4.6 帳票・運用

• 送り状印字レイアウト調整
• 請求書設定（振込先・事業者情報等）
• 税率マスタ管理
• 操作履歴（監査ログ）閲覧
• 運用ガイド/問い合わせページを内蔵

5. 統計・分析機能（管理者向け）

分析カテゴリ

• 売上統計
• 配送/物流統計
• 請求・入金統計
• 顧客分析

主な分析観点

• 売上数量・売上金額の推移
• 品目/品種/販売単位別ランキング
• 配送件数・送料構成・配送条件別の傾向
• 請求額・入金額・未回収の推移
• 顧客別売上、リピート傾向

出力

各統計APIはCSV出力に対応し、会議資料や外部報告へ転用可能です。

6. 権限・認可モデル

権限ベースで利用範囲を制御します。

認証後に権限判定し、画面とAPIの双方で権限チェックを行う二重防御を採用しています。

7. データモデルの特徴

販売単位中心モデル

• 商品は「3kg箱」「5kg箱」などの販売単位ごとに基準となる価格を持たせています
• 注文時はこの販売単位をもとに金額を計算するため、担当者が変わっても同じ計算結果になります
• これまでの運用データも使えるようにしており、新しい仕組みに無理なく移行できます

顧客別価格ルール

• お客様ごとに、商品の規格ごとに特別価格を設定できます
• 同じ期間に価格設定が重ならないようにし、価格の混乱や設定ミスを防止します
• すでに使われている価格設定は簡単に消せないようにし、運用中のトラブルを防止します

監査ログ

• 主要操作を監査ログへ記録
• 履歴上限を設け、運用コストを抑制しつつ追跡性を確保

8. 代表的な業務フロー

初期導入フロー

1. 事業者情報を登録
2. 顧客を登録
3. 商品体系（農産物→品種→商品内容→販売単位）を整備
4. 送料設定（業者→地域→配送規格→料金）を整備

日次運用フロー

1. 注文登録・確認
2. 配送条件と送料の確認
3. 請求作成
4. 入金登録
5. 未回収確認

月次・経営確認フロー

1. 売上/配送/請求/顧客統計を同一期間で確認
2. CSVを出力して報告資料に反映
3. 課題販売単位・未回収顧客・高コスト配送条件を特定

9. 技術構成

• Next.js 16（App Router）
• TypeScript（strict）
• React Bootstrap / react-select / Recharts
• Next.js Route Handler（API）
• Prisma ORM
• PostgreSQL
• Zod（入力バリデーション）
• NextAuth v5（Google OAuth連携）

10. セキュリティ・運用設計

• 環境変数で秘密情報を管理（認証情報・接続情報）
• 権限別アクセス制御
• API単位の入力検証（Zod）
• 監査ログによる重要操作追跡
• 利用中データの削除抑止による運用事故防止
• 販売単位は注文明細で使用中の場合に削除禁止

11. 導入効果（期待値）

業務効率

• 転記作業と照合作業の削減
• 送料・単価判定の標準化
• 請求処理のリードタイム短縮

品質向上

• マスタ連動による入力ミス低減
• 価格ルール・期間管理の可視化
• 請求漏れ/回収漏れの早期発見

経営可視化

• 売上/物流/回収を一貫したデータで分析
• 施策判断の迅速化

12. 代表的な画面・API（抜粋）

画面

• ホーム: /
• 注文管理: /orders
• 請求・入金管理: /billing
• 顧客管理: /customers
• 商品設定: /master/product-structure
• 送料設定: /master/shipping-rates
• 送り状設定: /master/waybill-layouts
• 請求書設定: /master/invoice-settings
• 税率設定: /master/tax-rates
• 事業者情報: /company
• ユーザー管理: /users
• 操作履歴: /reports/audit

API

• 注文: GET/POST /api/orders, GET/PATCH/DELETE /api/orders/:id
• 請求: GET/POST /api/invoices, GET/PATCH/DELETE /api/invoices/:id
• 入金: GET/POST /api/payments, GET/PATCH/DELETE /api/payments/:id
• 顧客: GET/POST /api/customers, GET/PATCH/DELETE /api/customers/:id
• 得意先価格: GET/POST /api/master/customer-sku-price-rules, PATCH/DELETE /api/master/customer-sku-price-rules/:id
• 統計: /api/analytics/*（売上・配送・請求・顧客）

13. まとめ

梨屋さんシステムズの農産物宅配管理システムは、受注・配送・請求・入金を一体化した業務基盤です。

商品体系と送料ロジックをマスタで標準化し、得意先別価格や請求・回収までを正確に運用できます。さらに管理者向け統計機能により、売上・配送コスト・未回収状況を可視化し、現場改善と経営判断を支援します。