為替レートAPIで多通貨請求を構築する方法（2026年ガイド）

多通貨請求は解決済みの問題のように聞こえます。通貨を選び、為替レートを掛けて、合計を印字するだけ、と。しかし実際には、あらゆる請求システムの中で最も間違いが起きやすい領域の一つであり、その間違いは高くつきます。売掛金、税務申告、そして顧客の受信トレイに現れるからです。SaaS製品、フリーランサー向けツール、代理店プラットフォーム、あるいはB2Bマーケットプレイスに多通貨請求を組み込む開発者にとって、難しいのは掛け算ではありません。難しいのは、どの為替レートを使うか、いつそれを固定するか、そして3月に発行した請求書が7月に支払われたときにも正しく照合できるようどのように保存するかを決めることです。

このガイドでは、重要となるエンジニアリング上の判断を、為替レートAPIを使ってレートを取得・固定・保存する実行可能なコードとともに解説します。焦点はとりわけ外国為替（FX）レイヤー、つまりほとんどの請求チュートリアルが飛ばす部分に当てています。

多通貨請求が単なる通貨換算以上である理由

単一通貨の請求書はスナップショットです。数量×価格に税を足すだけ。多通貨の請求書はある時点に関する契約です。帳簿をUSDで付けながら顧客にEURで請求する場合、あなたは発行した日にUSD価値が固定される売掛金を記録しているのです。顧客が実際に支払うまで市場レートは動き続けるにもかかわらず。

このギャップは、単純な換算が見落とす3つの具体的な問題を生みます。

1. どのレートが適用されるか。 請求日、支払日、それとも「今日」のレート？ これらはほぼ一致せず、会計基準（GAAPもIFRSも）は答えを明確に定めています。
2. 監査可能性。 数か月後に、どのレートを使い、それがどこから来たのかを正確に証明できる必要があります。数字を再現できなければ「APIから取得した」だけでは不十分です。
3. 為替差損益。 請求日価値と支払日価値の差は実際の損益であり、総勘定元帳のどこかに計上しなければなりません。

これらを正しく行えば、多通貨請求は最良の意味で退屈になります。誤れば、財務チームは四半期末の最後の一週間を端数の追跡に費やすことになります。

黄金律：請求日で為替レートを固定する

多通貨請求で最も重要な原則はこれです。請求書が発行された瞬間に為替レートを凍結し、決して再計算しないこと。

GAAPもIFRSも、外貨建て取引を取引日に有効な直物レートで記録することを求めています。請求書の場合、取引日とは発行日です。7月1日に顧客へ請求し、システムが処理するのが7月5日であっても、使うのは7月1日のレートです。これはFinexlyの規則でも好みでもありません。売掛金の機能（自国）通貨での価値が法的に確定される仕組みなのです。

よくあるアンチパターンは、顧客が請求書を更新するたびに変わる「ライブ」換算合計を表示することです。決してそうしないでください。請求書は特定金額に対する確定した請求です。顧客は請求通貨で金額を負い、あなたの帳簿は固定レートでの仕訳を負います。その後、市場は好きなように動いてかまいません。

実務上の結論は次のとおりです。請求のための通貨換算は一回限りの書き込み操作です。 レートを一度取得し、請求書とともに保存し、その文書の存続期間中は不変として扱います。

請求向けの為替レートAPIを選ぶ

すべてのFXデータソースが請求に適しているわけではありません。請求には次が必要です。

• 請求するすべての通貨のカバレッジ（Finexlyは170以上の通貨をカバー）。
• どの気配値を使ったか証明できるよう、各レートに付く信頼できる「時点」タイムスタンプ。
• 日付別の過去レート。遡及請求や訂正請求は避けられないため。
• 請求量の急増で請求処理が壊れないよう、予測可能なレート制限と料金。決済経路に依存関係を組み込む前に料金プランを確認してください。

基本的な最新レートのリクエストはこのようになります。

curl "https://api.finexly.com/v1/latest?base=USD&symbols=EUR&access_key=YOUR_API_KEY"

レスポンスは、レートと、その隣に保存するタイムスタンプを返します。

{
  "success": true,
  "base": "USD",
  "timestamp": 1753660800,
  "rates": {
    "EUR": 0.9213
  }
}

何かを組み込む前に対話的にレートを調べたい場合、通貨コンバーターが手早い確認になります。Finexlyが他のプロバイダーとどう比較されるかをより広く見るには、通貨APIを比較するを参照してください。

請求レートを取得して固定する

以下は、請求書のレートを取得し、永続化に必要なすべて（レート、ソースのタイムスタンプ、換算合計）を返す小さなPythonヘルパーです。単なる数値ではなく、レートとメタデータを返している点に注目してください。

import os
import time
import requests
from decimal import Decimal, ROUND_HALF_UP

API_KEY = os.environ["FINEXLY_API_KEY"]
BASE_URL = "https://api.finexly.com/v1/latest"

def lock_invoice_rate(home_currency, invoice_currency):
    """Fetch and lock the FX rate to convert an invoice total
    (in invoice_currency) back into home_currency for the books."""
    resp = requests.get(BASE_URL, params={
        "base": invoice_currency,
        "symbols": home_currency,
        "access_key": API_KEY,
    }, timeout=10)
    resp.raise_for_status()
    data = resp.json()
    if not data.get("success"):
        raise RuntimeError("Rate lookup failed")

    rate = Decimal(str(data["rates"][home_currency]))
    return {
        "rate": rate,                       # invoice_currency -> home_currency
        "rate_base": invoice_currency,
        "rate_quote": home_currency,
        "source": "finexly",
        "as_of": data["timestamp"],         # store the source timestamp
        "locked_at": int(time.time()),      # when WE locked it
    }

def home_value(amount_invoice_ccy, rate):
    """Convert an invoice-currency amount into home currency."""
    return (Decimal(str(amount_invoice_ccy)) * rate).quantize(
        Decimal("0.01"), rounding=ROUND_HALF_UP
    )

重要な点は、lock_invoice_rateが請求書作成時に一度だけ実行され、その出力が請求書レコードに書き込まれることです。キャッシュ、リトライ、429応答の適切な処理といった本番の課題については、キャッシュとエラー処理のガイドのパターンに従ってください。一時的なAPIの不調が請求書発行を妨げてはなりません。

為替レートを請求書とともに保存する

レートは請求書ごとに不変なので、上書きしてしまうかもしれない共有の「現在レート」テーブルではなく、請求書上に保存してください。最小限のスキーマは次のようになります。

CREATE TABLE invoices (
  id              BIGSERIAL PRIMARY KEY,
  issue_date      DATE        NOT NULL,
  invoice_ccy     CHAR(3)     NOT NULL,   -- what the customer is billed in
  home_ccy        CHAR(3)     NOT NULL,   -- your functional currency
  total_invoice   NUMERIC(18,2) NOT NULL, -- total in invoice_ccy
  fx_rate         NUMERIC(18,8) NOT NULL, -- invoice_ccy -> home_ccy, LOCKED
  fx_source       TEXT        NOT NULL,   -- e.g. 'finexly'
  fx_as_of        TIMESTAMPTZ NOT NULL,   -- the rate's source timestamp
  total_home      NUMERIC(18,2) NOT NULL  -- total_invoice * fx_rate, at issue
);

このスキーマを監査に適したものにしている点は3つあります。第一に、fx_rateは小数点以下8桁を使います。為替レートは金額の小数2桁よりはるかに高い精度を必要とし、早期に切り捨てると丸めのずれが生じます。第二に、fx_as_ofは数字の出所と時点を記録するため、どの監査人も過去データと照合して再現できます。第三に、total_homeは発行時に計算・保存されるため、6か月後に実行するレポートが推測する必要はありません。

顧客への透明性のため、固定レートを請求書自体に印字してください。支払金額、通貨、使用レート、適用日を記します。これは広く推奨されるベストプラクティスであり、まさに支払いが異なるレートで届いたときのあいまいさを取り除くからです。

遡及請求：今日ではなく過去レートを使う

遅かれ早かれ、過去の日付の請求書を発行することになります。訂正、遅延計上、あるいは以前の発効日を定める契約などです。3月の請求書に今日のレートを使うのは端的に誤りで、監査に通りません。代わりに、請求書の実際の日付のレートを過去エンドポイントから取得してください。

def lock_historical_rate(home_currency, invoice_currency, invoice_date):
    """invoice_date as 'YYYY-MM-DD'. Returns the locked rate for a
    backdated or corrected invoice."""
    resp = requests.get("https://api.finexly.com/v1/historical", params={
        "date": invoice_date,
        "base": invoice_currency,
        "symbols": home_currency,
        "access_key": API_KEY,
    }, timeout=10)
    resp.raise_for_status()
    data = resp.json()
    rate = Decimal(str(data["rates"][home_currency]))
    return {"rate": rate, "as_of": invoice_date, "source": "finexly"}

規則はライブの場合と同一です。一度固定し、永久に保存する。ただし照会する日付は請求書の発行日であって当日ではありません。日付付きレートの扱いをより深く扱った内容は、過去為替レートAPIガイドを参照してください。

丸めと精度を正しく行う

お金のバグはほぼ常に丸めのバグです。2つの規則がトラブルを防ぎます。

お金に浮動小数点を決して使わないこと。 浮動小数点演算では0.1 + 0.2は0.3にならず、その微小な誤差が請求明細をまたいで積み重なります。小数型を使ってください。PythonのDecimal、JavaのBigDecimal、C#のdecimal、あるいはJavaScriptでは整数のセント表現です。

どこで丸めるかを決めること。 レートは完全な精度（8桁以上）に丸めますが、金額はその通貨の最小単位に丸めます。USDやEURは小数2桁、JPYやKRWは0桁、一部は3桁です。よくある誤りは小数2桁をハードコードして¥1,234.56という請求書を発行することですが、これは有効な円建て金額ではありません。ISO 4217の最小単位データを使い、通貨から小数桁数を導いてください。

明細行のある請求書では、各行を丸めてから合計し、印字された明細の合計が印字された合計と一致するよう丸め後の合計と照合するのが望ましいです。どの方式を選んでも、請求・支払・レポートの全体で一貫して適用してください。

支払時に為替差損益を認識する

ここで固定レートが効いてきます。顧客が支払うと、実際に銀行口座に着金した金額を支払日のレートで自国通貨に換算し直します。それと請求日の自国通貨価値との差が、実現した為替差損益です。

// Amounts kept as Decimal-like strings; use a money library in production.
function realizedFxGainLoss(invoice, paymentRate) {
  // invoice.totalInvoice: amount billed, in the invoice currency
  // invoice.fxRate:       LOCKED rate at issue (invoice_ccy -> home_ccy)
  // paymentRate:          rate on the day the payment settled

  const homeAtIssue   = invoice.totalInvoice * invoice.fxRate;
  const homeAtPayment = invoice.totalInvoice * paymentRate;

  const gainLoss = homeAtPayment - homeAtIssue;
  return {
    homeAtIssue:   round2(homeAtIssue),
    homeAtPayment: round2(homeAtPayment),
    fxGainLoss:    round2(gainLoss),        // > 0 gain, < 0 loss
  };
}

function round2(n) { return Math.round(n * 100) / 100; }

paymentRateは請求レートを固定したのと同じ方法で取得します。決済日にはlatest呼び出し、事後照合にはhistorical呼び出しです。fxGainLossは専用の「為替差損益」勘定に計上します。この一つの仕訳こそが、発行から支払までの間に市場が動いても帳簿の均衡を保つものであり、手作業の多通貨請求が誤るのはまさにこの照合作業です。これを自動化パイプラインに組み込む企業は、多通貨SaaS請求ガイドで説明したのと同じレート基盤に依拠できます。

クレジットノート、返金、定期請求

3つのエッジケースが完全なシステムを仕上げます。

• クレジットノートと返金は、元の請求書を元の固定レートで取り消さなければなりません。現在レートではありません。返金は当初取引の巻き戻しなので、貸方処理する請求書のfx_rateを再利用します。実際の返金日での残差は、もう一つの小さな為替差損益仕訳になります。
• 定期請求はそれぞれ、自身の発行日に自身の固定レートを取得します。毎月請求される12か月のサブスクリプションは、12のレートを持つ12枚の請求書を生みます。契約で明示的に固定されていない限り、1年分を単一レートで固定しないでください。
• 契約で固定されたレートが時に市場を上書きします。一部の法人契約は一定期間の固定レートを定めます。手動オーバーライド用のフィールドを用意しつつ、再現可能であり続けるよう同じ監査メタデータとともに保存してください。

よくある質問

請求書にはどの為替レートを使うべきですか？ 請求書の発行日に有効な直物レートを使い、それを固定します。GAAPもIFRSも外貨建て取引を取引日レートで記録することを求めており、請求日がその日付です。顧客が請求書を閲覧・支払う際に再計算してはいけません。

為替レートを保存すべきですか、それとも換算後の金額だけでよいですか？ 両方保存してください。加えてレートのソースとタイムスタンプも。換算後の合計だけを保存すると、後から監査したり為替差損益を正しく計算したりできなくなります。レート、「時点」タイムスタンプ、ソースが揃って初めて、誰でも数字を再現できます。

過去の日付の請求書はどう扱えばよいですか？ 今日のレートを使うのではなく、実際の発行日の過去為替レートを照会します。一度固定して永久に保存するという規則は同じで、照会する日付が変わるだけです。

請求書の為替差損益は何が原因ですか？ 請求日と支払日の間の市場の動きです。帳簿は請求日レートで売掛金を記録しましたが、現金は支払日レートで評価されて着金します。その差が実現為替差損益であり、専用の元帳勘定に計上されます。

多通貨請求を構築するのに有料の通貨APIは必要ですか？ 無料プランから始められます。Finexlyの無料為替レートAPIは初期段階の量に対してライブおよび過去レートをカバーし、請求スループットの増加に応じてのみアップグレードします。

はじめよう

多通貨請求は一つの規律に集約されます。請求日でレートを固定し、完全な監査メタデータとともに保存し、支払時に差額を照合すること。それができれば、国際請求は四半期末の火消し作業ではなくなります。

構築の準備はできましたか？ Finexlyの無料APIキーを取得。クレジットカードは不要です。無料プランで170以上の通貨のライブおよび過去レートから始め、請求量の増加に応じてスケールしてください。