農家への支払単価はなぜ再計算されないのか：集荷デポ向けソフトウェアの価格スナップショットとFIFO

集荷デポの運営者なら、このやり取りに覚えがあるはずです。納品から数週間後、農家が1キロあたりの単価に疑問を持って戻ってくる。運営者は別の数字を覚えている。その日にいくらを提示したかを固定した記録がなく、議論は「声の大きい方が勝つ」で終わります。

人の問題に見えますが、実はデータモデルの問題です。simpliDepotは、この議論に根拠が残らないように作られています。

基本ルール：受入時の単価は「参照」ではなく「複写」する

simpliDepotは、品種と等級ごとに、有効日付き価格カタログを持ちます。ロットを計量して等級付けする受入時に、その日に有効だった単価がロットに複写され、永続的に残ります。再計算は行われません。

分かりやすい代替案は、価格表の行への参照を保持し、必要になるたびに価格を引く方法です。価格表が変わるまでは機能します。行が編集される、新しい有効日が追加される、その瞬間に、過去のロットがすべて別の数字を指します。誰もロットに触れていないのに、支払記録が変わってしまいます。

複写ならそれを避けられます。ロットは、果実を計量した時点で適用された価格を保持し、今の価格表が何を示していても影響を受けません。

flowchart TD
    A["農家が果実を搬入"] --> B["計量担当が等級別に重量を記録"]
    B --> C["受入日の価格を検索"]
    C -->|"価格が未設定"| X["受入をブロック"]
    C --> D["キロ単価をロットに複写"]
    D --> E["ロットが在庫に入る"]
    E --> F["販売注文は最も古いロットから引き当て"]
    F --> G["買い手への請求書と農家への支払"]

関連する安全策がもう1つあります。その品種・等級に価格が設定されていなければ、受入そのものがブロックされます。価格の欠落が、黙ってゼロになったり、後で誰かが辻褄を合わせる推測値になったりすることはありません。

浮動小数点ではなく、正確な金額計算

単価と支払額は、浮動小数点ではなく正確な十進演算で計算され、丸めのルールはスナップショット時に一貫して適用されます。地味な話ですが、何千ロットにわたって農家への支払額と買い手への請求額が最後の1サタンまで一致するために必要なことです。浮動小数点の小さな誤差は、月末の照合作業を大騒ぎにする典型的な原因です。

衝突しない番号

収穫期には、複数の計量所と複数のレジ担当が同時に作業します。重要な性質は2つです。

• ロット番号は連番で、複数の計量所が同時に送信しても安全です。
• 請求書番号は欠番のない連番で、複数のレジ担当が同時に発行しても崩れません。

手入力の請求書番号は重複したり飛んだりしがちです。同時実行制御のもとでシステムが発行する番号は、そうなりません。

FIFO引き当て：古いロットから、不足は正直に

買い手が注文すると、simpliDepotは最も古いロットから自動で在庫を引き当てます。聞こえる以上に重要な点が2つあります。

• 部分引き当ては行単位で記録され、黙って落とされることはありません。満たせない行があれば、注文上で分かります。
• ロットの状態は自動で遷移します。等級付け済み、一部販売、完売へと、在庫が減るにつれて変わります。

販売注文の各行は、FIFO引き当ての完全な履歴を保持します。これが、事後のトレーサビリティの問い、つまりどの農家のロットがどの買い手のトラックに載ったのかに答える根拠になります。

在庫とレポートはずれない

在庫数量とレポートは、同じ受入・販売・請求の記録に対する読み取り専用のビューです。照合すべき別の在庫台帳がないので、ずれようがありません。各段階が自分のデータを持ち、次の段階へ渡し、ビューは読むだけです。

システムが単独ではしないこと：オフライン受入

計画に影響するため、正直な制約を述べます。simpliDepotはホスト型のWebプラットフォームなので、受入と販売の記録には接続が必要です。通信が不安定な拠点については、現地ネットワーク構成やオフラインバッファを、ヒアリングの段階で範囲を決めて対応します。標準機能として前提にすることはできません。計量所が電波の弱い場所にある場合は、最初の打ち合わせで伝えてください。

ドリアンだけではありません

simpliDepotはまずドリアン向けに作られましたが、品種、等級、価格は設定であり、コードに固定されていません。同じロット・等級・FIFOのモデルは、マンゴー、ゴム、パーム果実など、等級付けして重量で販売する他の産品にも適用でき、カタログはお客様の等級体系に合わせて設定します。

過去の2本の記事がこの流れを追っています。From Durian Depot to Recycle Depot（英語）は、同じパイプラインを資源回収事業に当てはめ、拡張が必要な箇所も示しています。EUDR Is Coming for Thai Rubber and Palm Oil（英語）は、受入時の圃場位置情報の取得など、現時点でプラットフォームが対応していない点を率直に述べています。

関連記事

• The Modern Durian Depot: Stop Counting Stock on Paper, Start Running a Real Business（英語）
• Idempotency in Payment APIs（英語）：支払が二重に記録されないようにするのと同じ考え方です。
• FarmScript: Designing a Programming Language for Chanthaburi Durian Farmers（英語）

よくある質問

価格をめぐる争いは、実際にどう防ぐのですか。
受入日に有効だった単価は、等級付けの時点でロットに固定され、後から価格表が変わっても再計算されません。そのスナップショットが、支払に関するあらゆる問い合わせの記録になります。

まだ誰も価格を設定していない場合は。
その品種・等級に価格が存在するまで、受入はブロックされます。

複数の計量所とレジ担当が同時に作業できますか。
できます。ロット番号と請求書番号は、同時に送信されても衝突しないよう発行されます。

会計ソフトと連携できますか。
ProfessionalおよびPlatformプランのアドオンとして対応します。導入時に、お使いの会計システムが必要とするエクスポートまたはAPIの形式に合わせて範囲を決めます。

実物を試す

実環境が、サンプルの農家、買い手、ロットとともに稼働しています。デモ用の役割（計量担当、レジ、マネージャー、管理者）のいずれかでログインし、受入から請求書までの流れをご自身で確かめられます：simpliDepotのライブデモ。パッケージと導入の流れを載せた製品ページはsimpliDepotです。

ご自身のデポについてご相談の場合は、産品、拠点数、希望時期をhello@simplico.netまでお知らせください。48時間以内に範囲を定めた提案をお送りします。