> ## 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.

# Settlement Reports モジュール

> 加盟店 Portal の Settlement Reports モジュールの仕組み：決済日と精算日のディメンションの選択、エクスポートタイプとその日付範囲の上限、どの通貨セレクターが適用されるか、サマリーにおける Order Amount と Fee Amount の定義、エクスポートが zip に分割されるタイミング、エクスポートタスク一覧の読み方について説明します。

[精算レポートとエクスポート](/docs/ja/support/settlement-reports-faq) では金額の計算方法を説明しています。[精算ファイル仕様](/docs/ja/support/settlement-file-specification-faq) は、配信されるファイルの列ごとの契約です。**本ページはモジュールそのものについて**説明します。どこにあるか、どのオプションを提供しているか、そしてどの上限がエクスポートを開始前に止めるかです。同じレポートの定期メール配信については、
[レポート配信とメール購読](/docs/ja/support/report-delivery-and-subscription-faq)
をご覧ください。

## 精算レポートはどこで生成できますか？

**Settlement → Settlement Reports** です。1 つのページに作業の両方の側面が含まれています。

| ページ上の要素 | 機能 |
| - | - |
| **Customized Export** ボタン | エクスポートフォームを開きます：ディメンション、日付範囲、エクスポートタイプ、通貨、言語 |
| その下の一覧 | 貴社が開始したすべてのエクスポートタスク。ステータスとダウンロードリンク付き |
| **Email Subscription** タブ | 同じレポートの定期メール配信。アカウントで有効化されている場合 |

起点となる精算バッチは必要ありません。バッチごとのダウンロードは各 Settlement Batch 詳細ページに引き続き存在し、取引一覧にも固有のエクスポートがあります。Settlement Reports モジュールは、照合期間が単一のバッチと一致しない場合に使用するものです。

## Payment Date と Settlement Date のどちらでエクスポートすべきですか？

これはフォーム上で最も影響の大きい選択であり、**どの取引がそもそも表示され得るか**を決定します。

| ディメンション | 範囲 | 使用する場面 |
| - | - | - |
| **Payment Date** | 決済された日付による取引。**まだ精算されていない取引を含む** | 暦上の期間を締め、精算済みかどうかを問わずその期間に取引されたすべてが必要な場合 |
| **Settlement Date** | 実際に精算されたもののみ。精算された日付による | 精算アカウントに受領した資金と照合する場合 |

Payment Date を選択すると、フォームにその旨が明示されます：*Includes estimated data for completed
transactions pending settlement.*

これは、典型的な月末問題に対する答えです。T+N の精算サイクルでは、月の最後の数日の取引は 1 日に帳簿を締める時点でまだ精算されていません。**Settlement Date** でエクスポートすると、それらは正当に表示されません。**Payment Date** でエクスポートすると表示されます。

## どのエクスポートタイプがあり、それぞれの日付範囲の上限はいくつですか？

| エクスポートタイプ | 粒度 | 最大範囲 |
| - | - | - |
| **Daily Settlement Summary** | 日付と取引通貨ごとに 1 行 | **31 日** |
| **Transaction Settlement Detail** | 注文ごとに 1 行。精算済みデータと精算待ちデータを併記 | **3 か月** |
| **Selected Period Summary** | 選択した範囲全体の合計 | **12 か月** |

より長い範囲を選択すると、送信時に、タスクが作成される前に拒否されます。したがって、拒否されたエクスポートは失敗したエクスポートではなく、再試行するものもありません。範囲を短くして再度送信してください。将来の日付はまったく選択できません。

## エクスポートはどの通貨でフィルターされますか？

エクスポートタイプによって異なり、フィールドのラベルがどちらかを示します。

| エクスポートタイプ | フィールドラベル | 意味 |
| - | - | - |
| Daily Settlement Summary | **Order Currency** | 顧客が支払った通貨でフィルター |
| Transaction Settlement Detail / Selected Period Summary | **Settlement Currency** | 貴社が精算を受けた通貨でフィルター |

どちらの場合も **All Currencies** のままにしておくことは有効です。エクスポートタイプを変更すると、選択肢の一覧が別のものになるため、選択していた内容はクリアされます。

## レポートのヘッダーはどの言語ですか？

エクスポートフォームには **Report Language**（`English`、`中文`、`にほんご`）があり、インターフェース言語に翻訳されるのではなく、各言語固有の表記で表示されます。これは Portal ではなく生成するレポートに適用され、貴社が使用するインターフェース言語とは独立しています。

| エクスポートタイプ | ヘッダーの言語 |
| - | - |
| **Transaction Settlement Detail** | 選択した Report Language |
| **Selected Period Summary** | 選択した Report Language |
| **Daily Settlement Summary** | 英語。このタイプではセレクターは表示されません |

列の**値**（通貨コード、ステータス値、識別子）はどの言語でも同じで、変わるのはヘッダー行とセクションラベルのみです。ヘッダー名でファイルを解析する場合は、翻訳されたテキストで照合するのではなく、購読またはエクスポートで言語を固定してください。

## Transaction Settlement Detail レポートには何が含まれますか？

取引イベントごとに 1 行で、**精算済みと未精算が一緒に**含まれ、`Settlement
Status` 列（下記参照）をキーとします。2 種類の行では、値が入る列が異なります。

| 行の種類 | 値が入る列 | 空欄となる列 |
| - | - | - |
| `SETTLED` | `Settlement Batch Id`、`Settlement Date`、`Forex Rate`、`Fee Amount`、`Tax Amount`、`Settlement Amount` とそれらの `(Settlement Currency)` 版 | すべての `Est …` 列 |
| `UNSETTLED` | `Est Settlement Date`、`Est Forex Rate`、`Est Order Amount (Settlement Currency)`、`Est Fee Amount`、`Est Tax Amount`、`Est Settlement Amount` とそれらの `(Settlement Currency)` 版 | 実際の精算列 |

識別子、注文、決済手段、タイムスタンプの各列（`Order Id`、`Merchant Order Id`、
`Payment Request Id`、`Original Order Id`、`Order Amount`、`Order Currency`、`Transaction Type`、
`Event Type`、`Payment Method Type`、`Payment Method`、`Payment Option`、`Payment Request Datetime`、
`Payment Date`、`Payment Time`、`Product Name`）および通貨列（`Fee Currency`、
`Tax Currency`、`Settlement Currency`）は共通で、いずれの場合も `Est` プレフィックスは付きません。`Comments` 列は返金 Reserve の精算行を示します。したがって、1 つのファイルで「何が支払われたか」と「何がまだ未払いか」の両方に答えることができ、2 回のエクスポートの間に `Est` の数値が実際の数値に変わるのは精算が実行されたためであり、データの変更ではありません。

## サマリーにおいて、Order Amount と Fee Amount はどのように定義されていますか？

これら 2 つの定義は、どちらも総額ではないため、他のどの項目よりも多くの照合上の争いを引き起こします。

```
Order Amount = payment − refund − chargeback

Fee Amount   = payment fee (successful and failed transactions)
             + refund fee
             + chargeback fee
             + chargeback alert fee
```

明示しておく価値のある結果は次のとおりです。

* \*\*`Order Amount` は純額です。\*\*返金とチャージバックはすでに差し引かれています。貴社自身の総売上高と比較すると、常に返金とチャージバックの分だけ正確に差が出ます。
* 契約で失敗した試行に料金が設定されている場合、\*\*`Fee Amount` には成功しなかった取引の手数料が含まれることがあります。\*\*そのような行には注文金額なしで手数料が付きますが、これはデータエラーではなく正しい動作です。
* 決済はプラス、返金・チャージバック・チャージバックアラートはマイナスです。

## Daily Settlement Summary にはどの列がありますか？

10 列で、順序は次のとおりです。

| # | 列 |
| - | - |
| 1 | `Payment Date` |
| 2 | `Currency` |
| 3 | `Order Amount` |
| 4 | `Fee Amount` |
| 5 | `Tax Amount` |
| 6 | `Order Amount (Settlement Currency)` |
| 7 | `Fee Amount (Settlement Currency)` |
| 8 | `Tax Amount (Settlement Currency)` |
| 9 | `Settlement Currency` |
| 10 | `Settlement Amount` |

元通貨の各列には対応する精算通貨の列がペアになっており、税はどの税であっても 1 列です。VAT や源泉徴収税の個別の列はありません。行をまたいで加算できるのは精算通貨の列のみです。注文、手数料、税の通貨が異なる金額を元の通貨のまま合計することは決してありません。

## 日次サマリーで 1 つの日付が複数の行になるのはなぜですか？

1 日が 1 行になるのは、取引通貨と手数料通貨が同じ場合のみだからです。両者が異なる場合、またはその日に複数の手数料通貨が関わった場合、その日は**手数料通貨ごとに 1 行**に分割されます。VAT と源泉徴収税の通貨は、行をさらに分割するのではなく、手数料通貨に統合されます。

したがって、注文は 1 通貨だが手数料が 2 通貨で請求された日は、その日付について 2 行が生成され、それらの精算通貨列の合計がその日の合計になります。

## エクスポートが zip で返ってきたのはなぜですか？

独立した 2 つの理由があり、いずれか一方だけでも十分です。

| トリガー | 結果 |
| - | - |
| 結果が**複数の精算通貨**にわたる | 精算通貨ごとに 1 ファイルとなり、zip にまとめられます。サマリーには単一の精算通貨が必要なため、同じファイルを共有できません |
| 結果が **60,000 データ行**を超える | 連番付きのファイル（`_001`、`_002`、…）に分割され、zip にまとめられます |

行数上限未満の単一通貨の結果は、zip も連番サフィックスもなしで 1 ファイルとしてダウンロードされます。

## エクスポートタスクのステータスは何を意味しますか？

| ステータス | 意味 |
| - | - |
| **Pending** | タスクがキューに入っているか、ファイルがまだ作成中です |
| **Success** | 準備完了。Report 列がダウンロードリンクになります |
| **Failed** | 生成が完了しませんでした。エクスポートを再度開始してください |

エクスポートは設計上非同期です。開始してページを離れ、後でファイルを取得します。一覧にはエクスポート日、ステータス、エクスポートタイプ、ファイルが表示されます。リンクの有効期限を含むエクスポートキューの一般的な動作は、
[エクスポートとレポートのダウンロード](/docs/ja/support/export-center-faq)
で説明しています。

## エクスポートの Settlement Status 列は何を意味しますか？

エクスポート時点で特定の取引が精算済みだったかどうかを示し、**4 つ**の値があります。2 つではありません。

| 値 | 意味 |
| - | - |
| `SETTLED` | 取引は精算済みです。実際の精算数値が入ります |
| `UNSETTLED` | 取引はまだ精算されていません |
| `UNDEFINED` | 取引が処理途中（たとえば進行中の返金）で、どちらの答えもまだ意味を持ちません |
| `NOT_APPLICABLE` | 精算が該当しません：注文がクローズされた、返金が失敗した、またはレコードが顧客の異議申し立てである |

`UNDEFINED` や `NOT_APPLICABLE` を「未精算」と読むと、貴社への未払い額を過大に見積もることになります。「`SETTLED` 以外」ではなく、明示的に `UNSETTLED` でフィルターしてください。

## Settlement Estimation メニューがまだ表示されています。どちらを使うべきですか？

アカウントにまだ表示されている場合、Settlement Estimation は精算前の見積もりを単独で表示し、固有の 31 日間のエクスポートを持ちます。実務上は **Payment Date ディメンションでの Settlement Reports からのエクスポート**に置き換えられており、こちらは精算済みと未精算の取引を 1 つのファイルで返すため、2 回エクスポートして結合する必要がありません。

どのメニューがアカウントに表示されるかは加盟店ごとに設定されます。単一の統合エクスポートで作業したい場合は、アカウントマネージャーにご相談ください。

***

同じ期間の 2 回のエクスポートで数値が一致しませんか？
両方のエクスポート日と選択したディメンションを添えて [サポートにお問い合わせください](mailto:support@waffo.com)。
Payment Date と Settlement Date の違いでほとんどが説明できます。


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