> ## Documentation Index
> Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 精算レポートとエクスポート

> Waffo が精算レポートの各金額をどのように計算するか、各列にどの丸めルールが適用されるか、Settlement History・Settlement Batch・Customized Export の使い方、精算ファイルが存在しない、または空になる理由を説明します。

このページでは、**精算レポートの数値がどのように作られるか**と、Merchant Portal からデータを取り出す方法を説明します。フィールドの定義、CSV のレイアウト、SFTP のパスは[照合レポート](/docs/ja/developer-docs/tools-and-references/references/reconciliation-reports)にあります。

## 各金額はどのように計算されますか？手数料が 1 セントずれるのはなぜですか？

各明細行は取引ごとに、精算通貨で計算されます。

| 取引の種類 | 精算金額 |
| - | - |
| `PAYMENT` | 注文金額（精算通貨） − 手数料 − 税 |
| `REFUND` | −注文金額（精算通貨） − 手数料 − 税（契約に定めがあれば + 返還手数料） |
| `CHARGEBACK` | −チャージバック金額（精算通貨） − チャージバック手数料 |

1 セントのずれは丸めルールに由来し、ルールは列によって異なります。

| ルール | 意味 | 適用対象 |
| - | - | - |
| `ROUND2` | 四捨五入、小数 2 桁 | 精算通貨への金額換算と、サマリーの `TOTAL` |
| `ROUNDUP2` | **切り上げ**、小数 2 桁 | 手数料の金額、税の金額 |
| `ROUNDDOWN2` | **切り捨て**、小数 2 桁 | 返金行の返還手数料 |

小数 2 桁のアカウントでは手数料と税が切り上げられるため、通常の四捨五入で計算した値がレポートより 1 セント低くなることがあります。**小数 6 桁**のアカウントでは、手数料は代わりに**小数 6 桁で四捨五入**されます。[精算計算の解説](/docs/ja/support/settlement-calculation-explained)を参照してください。チャージバック手数料はそのケースについて報告された値をそのまま用い、貴社の手数料率から再計算されることはないため、率×金額の式には決して一致しません。サマリーの `TOTAL` は明細行を合計し、最後に一度だけ丸めたものです：`TOTAL = ROUND2(Σ detail Settlement Amount)`。

## 返金すると、元の決済手数料は戻ってきますか？

契約に返還手数料が含まれている場合、返金行はそれをその行の精算金額の**プラス**の構成要素として戻します。金額は元の取引に対して按分されます。

```
Returned fee = ROUNDDOWN2( refund amount / original order amount × original fee amount )
```

精算通貨での数値も同じ方法で、`ROUND2` を用いて按分されます。一部返金では対応する分だけが戻り、全額返金ではすべてが戻ります。契約に返還手数料がない場合、その行にこの構成要素はありません。

## 注文通貨と精算通貨が一致しているのに Forex Currency Pair に値があるのはなぜですか？

手数料と税は第三の通貨で請求されることがあります。ペアは優先順位で解決され、最初に一致した条件が採用されます。

| 評価の順序 | 条件 | ペア |
| - | - | - |
| 1 | 精算通貨 ≠ 注文通貨 | `Settlement/Order` |
| 2 | 精算通貨 ≠ 手数料通貨 | `Settlement/Fee` |
| 3 | 精算通貨 ≠ 税通貨 | `Settlement/Tax` |
| — | いずれにも該当しない | 空（FX なし） |

`Forex Currency Pair` が空のときは `Forex Rate` も空です。

## Settlement History と Settlement Batch のどちらを使うべきですか？

| メニュー | 単位 | デフォルトの期間 | 用途 |
| - | - | - | - |
| **Settlement History** | 1 件の精算指示 | 直近 90 日（UTC+8） | ステータス（`Succeeded` / `Failed` / `Unsettled`）と、再試行を含む実行のタイムライン |
| **Settlement Batch** | 加盟店 + 実際の精算日 + 精算通貨 | 直近 30 日 | 精算口座に着金したものの照合と、バッチの取引明細のダウンロード |

初期状態のままの指示は一覧に表示されません。バッチは**精算通貨**でパッキングされるため、1 つのバッチと 1 組のファイルがその中のすべての注文通貨をカバーし、為替レートは取引ごとに表示されます。日付フィールドには `(UTC+8)` のラベルが付きます。`Settlement Original Amount` は**注文通貨**で合計した純額、`Settlement Target Amount` は同じ資金を**換算した後**の金額です。両方の通貨が一致する場合は同一で、換算が完了するまでは空ですが、それはデータの欠落ではありません。

## Customized Export で何が得られますか？どこでダウンロードしますか？

| オプション | 選択肢 |
| - | - |
| 時間の軸 | Payment Date または Settlement Date |
| 通貨 | 単一の通貨、またはすべての通貨 — 日次サマリーでは注文通貨、他の 2 種類では精算通貨 |
| エクスポートの種類 | *Transaction Settlement Detail*、*Daily Settlement Summary*、*Selected Period Summary* |
| Report Language | 明細と期間サマリーでは English、中文、にほんご。日次サマリーは英語のみ |

選択した種類のすべての列が出力され、列ごとの選択はできません。日次サマリーでは、`Order Amount` は決済の総額ではなく**決済 − 返金 − チャージバック**です。取引通貨と手数料通貨が一致する場合、1 日は 1 行になります。異なる場合、または複数の手数料通貨がある場合、その日は手数料通貨ごとに 1 行へ分割され、税通貨は手数料通貨に折り込まれます。集計には単一の精算通貨が必要なため、複数が関わる場合、エクスポートは別々のファイルに分割されます。

明細のエクスポートはファイルあたり **60,000 行**でページングされ、非同期で実行されます。エクスポートを開始し、**Reports** モジュールからファイルを回収してください。オプションの全体、期間の上限、列のレイアウトは[精算レポートモジュール](/docs/ja/support/settlement-reports-export-faq)にあります。

## バッチの取引明細ファイルには何が入っていますか？

バッチからダウンロードし、精算口座の記録に対して取引単位で照合してください。ファイル名は `SETTLEMENT_{MID}_{settlement success date YYYYMMDD}_{SETTLEMENT_REFERENCE_ID}.csv` です。その列は貴社自身の記録と結合できるように作られています。精算のリファレンスと日付、貴社自身の注文 / 決済リクエスト / 返金注文の識別子、Waffo の注文と返金の識別子、取引の種類（決済または返金）、取引の成功時刻、そして注文・手数料・税・精算の金額と通貨の組です。正確な列ヘッダーとその形式については、このページから名前をハードコードするのではなく、常に[照合レポート](/docs/ja/developer-docs/tools-and-references/references/reconciliation-reports)と[精算ファイル仕様](/docs/ja/support/settlement-file-specification-faq)を参照してください。

## 今日の精算ファイルがありません。精算が失敗したのですか、それともファイル生成が失敗したのですか？

既定では、精算がなければファイルもありません。`GENERATE_ON_VALID_SETTLEMENT` は、有効な精算が発生した場合にのみ明細ファイルとサマリーファイルを生成します。「精算対象なし」と「ファイル生成の問題」を混同しないように常にファイルを受け取りたい場合は、サポートに依頼してアカウントを `GENERATE_ALWAYS` に切り替えてください。その場合、繰り延べられた日も含め、**予定されたすべての精算日にヘッダーのみのファイル**が届きます。ファイル名にはすべてゼロのバッチ ID のプレースホルダーが入ります。

```
settlement_details_{merchant id}_S000...000_{settlement date}_{settlement currency}.csv
settlement_summary_{merchant id}_S000...000_{settlement date}_{settlement currency}.csv
```

これらのプレースホルダーは配信のシグナルにすぎません。Merchant Portal に Settlement Batch のレコードは作成されず、それが実際の精算との見分け方になります。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.