お金を扱うシステム設計の、
金額が合わない原因は、計算ミスだけではありません。どの数字を基準にし、どの順番で計算し、どの時点で丸め、何を取引記録として残すのか。会員システムやECサイトの金額仕様で「決めるべきこと」を、12の設計判断に整理しました。
ECサイトや会員システムでは、商品価格、割引、送料、ポイント、税金、返品、返金など、さまざまな金額を扱います。一つひとつの計算式は、それほど難しくありません。それでも実際のシステムでは、次のような問題が起こります。
原因は、算数の間違いとは限りません。多くの場合に問題になるのは、どの数字を基準にし、どの順番で計算し、どの時点で丸め、何を取引記録として残すのか——これが決まっていないことです。
このチェックリストは、会員システムやECサイトの金額仕様について、決めるべきことを12の設計判断に整理したものです。要件定義や既存システムの改修、リニューアル、決済サービスの変更、ポイント制度の導入などの前に、各項目を決まっている / 一部だけ決まっている / 決まっていないの三段階で確認してください。通常の注文では動いていても、返品や併用など例外時の扱いが定まっていなければ、その項目は要整理です。各項目を三段階で評価すると、下のスコアと要整理の項目数が自動で更新されます。
「決まっている・一部・未定」を選ぶと、要整理の項目が自動で集計されます。
どこで計算し、どこで丸めるのか。同じ15％引きでも、商品1点ごとか、明細単位か、注文全体かで最終金額が変わることがあります。
カートの合計と明細を足した金額が1円違い、お客様から「計算が間違っている」と問い合わせが入ります。
商品を15％引きにして、合計を出す。
割引後価格は商品1点単位で確定する。税込単価へ85％を乗じ、1円未満を切り捨てた後、確定した割引後単価へ数量を乗じる。注文合計に対して割引額を再計算しない。
どう丸めるのか。四捨五入・切り捨て・切り上げのどれを使うかだけでなく、何桁目で処理し、どの桁まで残すかまで決める必要があります。
同じ商品なのに、画面や端末によって表示金額が1円違い、現場でどちらが正しいか判断できなくなります。
商品を15％引きにする。端数は切り捨てる。
例として15％引きの場合、商品1点ごとに税込単価へ85％を乗じ、1円未満を切り捨てて割引後単価を確定する。その後、割引後単価へ数量を乗じ、注文明細金額を算出する。
逆算した数字は、元の数字と同じなのか。税込から税抜を求めても、登録時の税抜価格と同じとは限りません。計算値と確定値を区別します。
再計算するたびに金額が変わり、元の取引を再現できなくなります。
税込価格から税抜価格を求めて保存する。
税込価格から算出した税抜価格は、登録時の税抜価格を復元した値ではなく、計算によって求めた派生値として扱う。取引時に確定した税込価格、適用税率、税額および税抜相当額は、それぞれ別項目として保存する。
誰に約束した金額を正本にするのか。税込と税抜のどちらを基準にするかは、消費者向けか事業者向けかによって、守るべき金額が変わります。
「税込500円引き」のつもりでも、税抜を経由して計算する設計では、最終的に501円引きになることがあります。
税込価格と税抜価格を登録する。
消費者向けの商品価格は税込価格を基準価格とする。画面表示、注文確定、請求および返金には、取引時に確定した税込価格を使用する。税抜価格および税額は、税込価格と適用税率から算出する。
両方持っても、両方から計算しない。税込と税抜を両方保存できますが、両方を独立した正解にすると、不一致のとき、どちらを直すべきか分からなくなります。
商品マスタの税込価格と税抜価格が食い違い、どちらが正式な価格なのか誰も断言できなくなります。
税込価格と税抜価格の両方を保存しておく。
税込価格と税抜価格を保存するが、税込価格を正本とする。税抜価格は税込価格と税率から自動算出し、直接編集できないものとする。取引確定後は再計算せず、確定時の両価格を保存する。
送料無料は、いつの金額で判定するのか。「税込5,000円以上で送料無料」と書くだけでは、クーポン前か後か、ポイント前か後かで送料が変わります。
カート画面では送料無料だったのに、決済画面で送料が追加されることがあります。
税込5,000円以上の注文は送料無料とする。
送料無料判定は、クーポンおよびポイント利用前の商品税込合計を対象とする。送料、決済手数料および送料無料対象外商品は判定金額に含めない。判定金額が5,000円以上の場合、通常送料を0円とする。ただし、地域別追加送料および大型商品送料は対象外とする。
注文全体の割引を、商品へどう分けるのか。500円のクーポンを比率で配分すると、端数と余りが生まれます。
500円引きのはずが明細合計では498円引きとなり、残りの2円をどの商品へ置くのか判断できなくなります。
500円のクーポンを商品金額に応じて配分する。
注文割引額は、各注文明細の税込金額比率により按分する。各明細の配分額は1円未満を切り捨てる。配分後の残額は、小数部の大きい明細から1円ずつ加算する。小数部が同値の場合は、明細番号の小さい順に加算する。
唯一の正解を選ぶことではありません。重要なのは——
同じ注文であれば、誰が処理しても同じ配分を再現できること。
返品金額は、その場で計算し直さない。現在の商品価格ではなく、購入時に確定した価格・割引・税額をたどります。
担当者や処理日によって返金額が変わり、購入時の実負担額を超えて返金することがあります。
返品された商品の代金を返金する。
返品金額は、購入時に確定した注文明細の支払金額を基準とし、現在の商品価格から再計算しない。注文全体に適用された割引は、購入時に各明細へ配分された割引額を使用する。クーポン条件を再判定する場合は、次のルールも必要です。
返品後の商品合計がクーポン適用条件を下回る場合は、クーポン適用を取り消し、その差額を返金額から控除する。
元注文を直すのか、取消と再注文にするのか。確定後の変更を、書き換えるか、新しい取引として残すか。
最終的な支払額は合っていても、売上、返品、送料、ポイント、注文件数の記録が担当者ごとに変わります。
→ 実際の事例：第13回「25円を、14日間さがした」
商品を変更する場合は、必要に応じて注文を修正する。
注文確定後の商品変更は、元注文の明細を直接更新せず、対象明細の取消処理と新規注文明細の登録によって行う。取消取引および新規取引には、元注文を識別できる関連番号を保存する。
最終金額が同じでも、会社の数字は同じではない。支払額が2,000円で同じでも、処理方法によって売上・値引き・取消・返金・件数は変わります。
差引金額は合っているのに、売上、値引き、返金、注文件数、月次実績が合わなくなります。
結果から元の数字を戻そうとしない。入金額だけを見て売上や手数料を逆算しても、元の取引情報と完全には一致しない場合があります。
後から売上を復元しようとしても、端数処理や手数料率の違いによって元の取引と一致しません。
計算し直せるから、保存しなくてよいとは限りません。
計算条件は変わります。取引時に確定した数字は、その時点の記録として残す必要があります。
すべてに対応することが、優れた設計ではない。クーポン・ランク割引・定期割引・送料・ポイントを自由に組み合わせると、処理パターンは急増します。
一つの機能追加が、返品、送料、ポイント、決済、集計など、想定外の場所へ影響します。
設計とは、すべての可能性を実装することではありません。
必要な組み合わせを選び、不要な組み合わせには境界を引くこと。
決定度（%）は、決めるべきことがどれだけ言語化できているかの目安です。各項目のチェックを「決まっている＝2点／一部＝1点／未定＝0点」で数え、全項目の満点に対する割合で自動計算します。数字の高さそのものより、どのチェックが0点のまま残っているかに注目してください。
要整理の項目数が、点検の中心です。一つの項目に一つでも「一部だけ決まっている」または「決まっていない」があれば、その項目を「要整理」として数えます。要整理が何項目あるかで、次のように読みます。
金額仕様の基本的な骨格は整理されています。ただし、外部決済、複数税率、返品、ポイント、キャンペーン併用など、例外時の動作も確認してください。
通常の購入処理では動いていても、返品、変更、割引の併用、月をまたぐ処理などで矛盾が生じる可能性があります。改修や新機能追加の前に、該当する項目のルールを仕様として整理する必要があります。
金額処理の多くが、明文化された仕様ではなく、現在のプログラムや担当者の判断に依存している可能性があります。部分的な機能追加より先に、現在の計算・記録・集計方法を棚卸しすることを推奨します。
金額仕様では、次の三つを分けて考える必要があります。システムへ「正しい答え」を考えさせるのではありません。人がルールを決め、システムがそのルールで同じように計算し、後から同じ取引を説明できるように記録を残します。
人がルールを決め、システムが同じように計算し、後から同じ取引を説明できるように記録を残す。
要整理が2項目以上あった場合、それは担当者の能力の問題ではなく、まだ決められていないルールがある、ということです。
PayAI NEXT（ハートランドITイノベーション）では、会員管理・継続課金・決済・ポイント・返品を、単独の機能ではなく取引全体の流れとして整理する設計支援を行っています。この12の設計判断の点検結果を持ち込んでいただければ、どの項目から整理すべきかを一緒に見立てます。
各項目の背景は、連載「大人の算数・国語・論理的思考」で一つずつ掘り下げています。