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

# 精算ファイル仕様

> 3 種類の対帳レポートファイルと、精算ステートメントおよびInvoice PDF の列ごとのリファレンス：各フィールドの意味、小数精度、空になる条件、ファイル命名規則、ファイルの配信先、日付範囲の一括ダウンロード方法。

[精算レポートとエクスポート](/docs/ja/support/settlement-reports-faq)では、金額がどのように計算されるか、レポートをオンデマンドで取得する方法を説明しています。[レポートの配信とメール配信登録](/docs/ja/support/report-delivery-and-subscription-faq)では、ファイルがスケジュールに沿ってどのように届くかを扱っています。**本ページはフィールドレベルの契約です**：各列の意味、小数の桁数、正当に空になる条件、各ファイルの命名方法を記載します。

## どのレポートファイルが提供され、それぞれいつ生成されますか？

| レポート | 対象 | 生成タイミング |
| - | - | - |
| **Transaction Details** | 取引日 T のすべての取引。精算の有無を問わない | T+1 |
| **Settlement Details** | 1 つの精算期間内の取引ごとに 1 行 | 精算の銀行入金確認を受領した翌日 |
| **Settlement Summary** | 1 つの精算期間における、1 つの精算通貨の取引タイプごとの合計 | 精算の銀行入金確認を受領した翌日 |

3 つはすべて **CSV、UTF-8 エンコード**です。2 つの精算レポートは精算バッチに紐付き、取引レポートは取引日に紐付いており、精算サイクルとは独立しています。

この区分から 2 つの動作が生じ、「ファイルが見つからない」という問い合わせの大半の原因になっています。

* **取引のない日でも Transaction Details ファイルは生成されます** — ヘッダー行のみを含みます。
* **ネット精算のない精算日には精算ファイルはまったく生成されません**。精算バッチが存在しないためです。代わりにすべての予定日にプレースホルダーが必要な場合は、加盟店ごとの設定になります — [精算レポートとエクスポート](/docs/ja/support/settlement-reports-faq)を参照してください。

## 正確なファイル名は何ですか？

| ファイル | 名前 |
| - | - |
| Transaction Details | `transaction_details_{merchant id}_{transaction date}.csv` |
| Settlement Details | `settlement_details_{merchant id}_{settlement batch id}_{settlement date}_{settlement currency}.csv` |
| Settlement Summary | `settlement_summary_{merchant id}_{settlement batch id}_{settlement date}_{settlement currency}.csv` |
| Settlement Statement (PDF) | `settlement_statement_{merchant id}_{currency}_{date}.pdf` |
| Withdrawal Statement (PDF) | `{merchant id}-{withdraw order id}_{account type}.pdf` — ステートメントが再生成されるとタイムスタンプが付加されます。**Withdrawal History** からいつでも再ダウンロードできます |
| Invoice (PDF) | `invoice_{currency}_{date1}_{date2}.pdf` |

* `transaction date` と `settlement date` は **UTC+8** の `YYYYMMDD` です。PDF の日付は `YYYYMMDD` です。
* `settlement currency` が精算ファイル名に含まれるのは、バッチが精算通貨ごとにまとめられるからです。1 つの精算日に 2 つの精算通貨がある場合は**2 セットのファイル**を受け取り、この最後の要素で区別できます。
* 再生成が必要なファイルは**上書きされません**。新しいバージョンサフィックスで再度書き出されます（`..._v1.0_1.csv` の次は `..._v2.0_1.csv`）。そのため、既に取得したダウンロードが知らないうちに変わることはありません。

## ファイルはどこに配信され、どれくらいの期間保持されますか？

ファイルは加盟店 Portal で利用でき、SFTP 配信を使用している場合はドキュメント記載の取引および精算ディレクトリ配下にも置かれます — 正確なパスは[対帳レポート](/docs/ja/developer-docs/tools-and-references/references/reconciliation-reports)を参照してください。

**対帳レポートは SFTP サーバー上では限られた期間のみ保持されます。加盟店 Portal からは引き続きダウンロードできます。** プルジョブがしばらくオフラインだった場合は、SFTP ではなく Portal から欠落分を回復してください。

SFTP アクセスは、**ユーザー名とパスワード**または**鍵認証**の 2 つのログイン方法に対応しています。鍵認証が推奨される方法です。

## Transaction Details — フィールド辞書

| 列 | 意味 | 形式 / 精度 | 空になる条件 |
| - | - | - | - |
| `Merchant Id` | Waffo がお客様に割り当てる識別子 | 文字列、最大 64 | なし |
| `Sub Merchant Id` | 商品やサービスを直接提供する二次加盟店に Waffo が割り当てる識別子 | 文字列、最大 64 | サブ加盟店を使用していない場合 |
| `Order Id` | Waffo の取引識別子 — `Transaction Type` に応じて決済 ID、返金 ID、またはチャージバック ID | 文字列、最大 32 | なし |
| `Merchant Order Id` | お客様自身の取引識別子 | 文字列、最大 32 | 送信しなかった場合 |
| `Payment Request Id` | お客様自身の決済リクエスト識別子 | 文字列、最大 32 | 送信しなかった場合 |
| `Original Order Id` | 元の決済取引 ID | 文字列、最大 32 | **`Transaction Type` が `PAYMENT` の場合は常に空**。`REFUND` と `CHARGEBACK` では値が入ります |
| `Order Amount` | 注文通貨での取引金額 | 注文通貨の小数桁 | なし |
| `Order Currency` | `Order Amount` の通貨 | ISO 4217 3 文字コード | なし |
| `Transaction Type` | `PAYMENT`、`REFUND`、または `CHARGEBACK` | 列挙値 | なし |
| `Payment Method` | 使用された決済手段 | 文字列、最大 32。API と同じ値 | なし |
| `Payment Option` | 決済手段配下のサブ手段 — 例えば紐付けカードではなくウォレット残高からの支払い | 文字列、最大 32 | 決済手段にサブ手段がない場合 |
| `Payment Request Datetime` | Waffo がお客様から決済リクエストを受信した日時 | `YYYY-MM-DD hh:mm:ss`、UTC+8 | なし |
| `Payment Date` | 取引が成功に到達した日付 | `YYYY-MM-DD`、UTC+8 | なし |
| `Payment Time` | 取引が成功に到達した時刻 | `hh:mm:ss`、UTC+8 | なし |
| `Order Description` | お客様による取引の説明 | 文字列、最大 128 | 送信しなかった場合 |
| `Product Name` | 契約済みの決済商品、例：`ONE_TIME_PAYMENT` | 列挙値 | なし |
| `Merchant User Id` | お客様自身のエンドユーザー識別子 | 文字列、最大 64 | 送信しなかった場合 |

`Payment Date` と `Payment Time` は意図的に 2 つの別々の列になっています。日付列は取引がどの取引日 — したがってどの精算 — に属するかを決めるものであるため、タイムスタンプを解析せずにグループ化キーとして使用できます。

## Settlement Details — フィールド辞書

Transaction Details と同じ行粒度に、各取引の精算結果が加わります。

| 列 | 意味 | 形式 / 精度 | 空になる条件 |
| - | - | - | - |
| `Merchant Id` | お客様の加盟店識別子 | 文字列、最大 64 | なし |
| `Sub Merchant Id` | サブ加盟店識別子 | 文字列、最大 64 | サブ加盟店を使用していない場合 |
| `Settlement Batch Id` | 期間内のこの精算に対する Waffo の識別子 | 文字列、最大 64 | なし（すべてゼロの値はプレースホルダーファイルを示します — 下記参照） |
| `Settlement Date` | 精算ファイルが生成された日付 | `YYYY-MM-DD`、UTC+8 | なし |
| `Order Id` | `Transaction Type` に応じた決済、返金、またはチャージバック ID | 文字列、最大 32 | なし |
| `Merchant Order Id` | お客様自身の取引識別子 | 文字列、最大 32 | 送信しなかった場合 |
| `Payment Request Id` | お客様自身の決済リクエスト識別子 | 文字列、最大 32 | **`Transaction Type` が `CHARGEBACK` の場合は常に空**。また送信しなかった場合 |
| `Original Order Id` | 元の決済取引 ID | 文字列、最大 32 | **`PAYMENT` では常に空**。`REFUND` と `CHARGEBACK` では値が入ります |
| `Order Amount` | 注文通貨での取引金額 | 注文通貨の小数桁 | なし |
| `Order Amount (Settlement Currency)` | 同じ金額を精算通貨に換算したもの | お客様の精算小数桁 — 2 または 6、ゼロ埋め | なし |
| `Order Currency` | `Order Amount` の通貨 | ISO 4217 | なし |
| `Transaction Type` | `PAYMENT`、`REFUND`、`CHARGEBACK`、または `CHARGEBACK_ALERT` | 列挙値 | なし |
| `Event Type` | `PAY_SUCCESS`、または失敗試行行における課金対象の失敗ステージ — [失敗したカード取引の課金](/docs/ja/support/failed-transaction-billing-faq)を参照 | 列挙値 | なし |
| `Payment Method Type` | 決済手段のカテゴリ | 文字列、最大 32 | なし |
| `Payment Method` | 使用された決済手段 | 文字列、最大 32 | なし |
| `Payment Option` | 決済手段配下のサブ手段 | 文字列、最大 32 | 決済手段にサブ手段がない場合 |
| `Payment Request Datetime` | Waffo がお客様の決済リクエストを受信した日時 | `YYYY-MM-DD hh:mm:ss`、UTC+8 | なし |
| `Payment Date` | 取引が成功した日付 | `YYYY-MM-DD`、UTC+8 | なし |
| `Payment Time` | 取引が成功した時刻 | `hh:mm:ss`、UTC+8 | なし |
| `Product Name` | 契約済みの決済商品 | 列挙値 | なし |
| `Forex Currency Pair` | この行の為替ステップで使用された通貨ペア。`AAA/BBB` 形式 | ISO 4217 コード、スラッシュ区切り | 為替が関与しなかった場合 — 下記の優先順位表を参照 |
| `Forex Rate` | `Forex Currency Pair` のレート。外国為替パートナーが提供 | 小数 8 桁、ゼロ埋め | `Forex Currency Pair` が空のとき常に |
| `Fee Amount` | Waffo の処理手数料。手数料通貨建て | 小数 6 桁、ゼロ埋め | なし |
| `Fee Amount (Settlement Currency)` | 同じ手数料を精算通貨に換算したもの | 精算小数桁、ゼロ埋め | なし |
| `Fee Currency` | `Fee Amount` の通貨 | ISO 4217 | なし |
| `Tax Amount` | この取引の取引税（VAT および／または源泉徴収税）。税通貨建て | 小数 6 桁、ゼロ埋め | お客様に取引税が適用されない場合 |
| `Tax Amount (Settlement Currency)` | 同じ税額を精算通貨に換算したもの | 精算小数桁 | 取引税が適用されない場合 |
| `Tax Currency` | `Tax Amount` の通貨 | ISO 4217 | 取引税が適用されない場合 |
| `Settlement Amount` | この行のネット精算額 | 精算小数桁、ゼロ埋め。**`REFUND` と `CHARGEBACK` では負の値** | なし |
| `Settlement Currency` | `Settlement Amount` の通貨 | ISO 4217 | なし |
| `Comments` | 返金Reserve精算に属する行のマーカー | 文字列 | 通常の精算の場合 |

税はどの税であっても単一の `Tax Amount` 列として報告されます。VAT や源泉徴収税の個別の列はありません — [手数料と税の取り扱い](/docs/ja/support/fee-and-tax-treatment-faq)を参照してください。

## Settlement Summary — フィールド辞書

単一の精算通貨について、取引タイプごとに 1 行、加えて `TOTAL` 行があります。

| 列 | 意味 | 形式 / 精度 | 空になる条件 |
| - | - | - | - |
| `Merchant Id` | お客様の加盟店識別子 | 文字列、最大 64 | なし |
| `Settlement Batch Id` | この精算の識別子 | 文字列、最大 64 | なし |
| `Settlement Date` | ファイルが生成された日付 | `YYYY-MM-DD`、UTC+8 | なし |
| `Transaction Type` | `TOTAL`（全取引）、`PAYMENT`、`REFUND`、`CHARGEBACK`、`CHARGEBACK_ALERT` | 列挙値 | なし |
| `Transaction Count` | そのタイプの取引件数 | 整数 | なし |
| `Fee Amount (Settlement Currency)` | そのタイプの処理手数料。精算通貨建て | 精算小数桁 | そのタイプに手数料がなかった場合 |
| `Tax Amount (Settlement Currency)` | そのタイプの取引税。精算通貨建て | 精算小数桁 | 取引税が適用されない場合 |
| `Settlement Amount` | そのタイプのネット精算合計 | 精算小数桁。`REFUND` と `CHARGEBACK` では負の値 | なし |
| `Settlement Currency` | 金額の通貨 | ISO 4217 | なし |
| `Comments` | 返金Reserve精算のマーカー | 文字列 | 通常の精算の場合 |

**サマリーには `Order Amount` 列はありません**。すべての金額列は既に精算通貨で表されており、それによって行同士を加算できます — 異なる注文通貨、手数料通貨、税通貨の金額が元の通貨のまま合計されることは決してありません。

## 通貨は小数 2 桁なのに、ファイルには 6 桁表示されるのはなぜですか？

精算精度が加盟店ごとの設定だからです。お客様のアカウントは**小数 2 桁または 6 桁**のいずれかに設定され、一度設定されると固定されます。6 桁のアカウントでは、精算通貨の金額は小数 6 桁で書き出され、その幅まで**ゼロ埋め**されるため、整数は `99.000000` と表示されます。*元の*注文通貨での `Order Amount` はその通貨固有の小数桁を保持し、埋められません。

固定幅で、値が短い場合は常にゼロ埋めされます。

| 値 | 小数桁 |
| - | - |
| 為替レート | 8 |
| 手数料および税額 | 6 |
| 精算通貨の金額 | お客様の精算小数桁（2 または 6） |

6 桁のアカウントでは、これにより明細行がバッチと正確に一致します。明細の `Settlement Amount` の合計が、端数なしでバッチ金額と等しくなります。

## Forex Currency Pair はいつ値を持ち、どのペアになりますか？

手数料と税は注文通貨でも精算通貨でもない通貨で課金されることがあるため、ペアは優先順位で決定されます — **最初に一致した条件が採用されます**。

| 評価順 | 条件 | ペア |
| - | - | - |
| 1 | 精算通貨 ≠ 注文通貨 | `Settlement/Order` |
| 2 | 精算通貨 ≠ 手数料通貨 | `Settlement/Fee` |
| 3 | 精算通貨 ≠ 税通貨 | `Settlement/Tax` |
| — | 上記のいずれにも該当しない | 空 — 為替は関与していません |

注文金額を持たない行 — 課金対象の失敗試行、またはチャージバックアラート — は手数料通貨のみを評価します。勝訴したチャージバックは注文通貨のみを評価します。

そのため、注文通貨が既に精算通貨と同じであっても、行にペアが入ることがあります。その行の為替ステップは注文ではなく手数料または税に対するものです。`Forex Rate` はペアが空のときに限り空になります。

## バッチ ID がすべてゼロの精算ファイルを受け取りました。これは何ですか？

それは**プレースホルダー**で、精算が発生したときだけでなくすべての予定精算日にファイルを生成するようアカウントが設定されている場合にのみ生成されます。

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

ヘッダー行のみを含み、それ以外は何もありません。すべてゼロのバッチ ID は意図的なものです — 精算バッチが存在しないため入れるべき実際の ID がなく、**加盟店 Portal に Settlement Batch レコードは表示されません**。「精算するものがなかった」と「ファイルが届かなかった」を区別する配信のハートビートとして扱い、精算イベントとしては扱わないでください。

## 1 か月分の精算明細を一括でダウンロードできますか？

はい。Settlement Batch 一覧から行います。**Actual Settlement Date** の範囲を選択し、バッチをまとめてダウンロードします。

| ルール | 値 |
| - | - |
| 1 リクエストあたりの最大期間 | **1 か月** — それより長い選択はタスク作成前に拒否されます |
| 行の順序 | 精算日の**昇順** |
| 1 ファイルあたりの行数 | ヘッダーを除き **60,000** データ行 |
| ファイルが 1 つの場合の結果 | `settlement_details_{merchant id}_{min settlement date}_{max settlement date}.csv`。連番サフィックスなし、直接ダウンロード |
| ファイルが複数の場合の結果 | `settlement_details_{merchant id}_{min settlement date}_{max settlement date}.zip`。`..._001.csv`、`..._002.csv`、… を含む |

`min settlement date` と `max settlement date` は選択範囲内の最も早い精算日と最も遅い精算日で、`YYYYMMDD` UTC+8 です。リクエストは非同期で実行されます — [エクスポートとレポートのダウンロード](/docs/ja/support/export-center-faq)の説明どおり、Reports モジュールから結果を取得してください。

異なる切り方をしたい範囲 — 決済日別、注文通貨別、または取引ごとではなく日次サマリー — には、代わりに Customized Export を使用してください。そのオプションは[精算レポートとエクスポート](/docs/ja/support/settlement-reports-faq)に一覧されています。

## PDF ドキュメントはどのような書式規則に従いますか？

精算ステートメント、出金ステートメント、Invoiceは 1 つのレイアウトと 1 組の規則を共有しているため、値の意味は 3 つすべてで同じです。

| 規則 | ルール |
| - | - |
| 金額 | 桁区切り、**小数 2 桁** |
| 通貨の位置 | 金額の**前**：`{Currency} {Amount}` |
| 国／地域 | **ISO 3166-1 alpha-3** — `USA`、`CHN`、`HKG` |
| ラベル | 各単語の先頭を大文字 |
| 合計 | `Total` はテーブル内の行では**なく**、テーブルの下に別途記載 |
| レート列の名前 | 常に **`Forex Rate`** — `Fx` は使わない |
| 換算のないレート | `--` と表示。列は削除せず保持 |

ページの順序も固定です。発行元 Waffo エンティティの名称と住所、次にドキュメントブロック（日付と番号）、次にお客様の会社名と住所、そして業務明細テーブルです。

## 精算ステートメントには何が含まれ、そのレートはどう計算されますか？

列は **Country/Region、Transaction Amount、Fee Amount、Tax Amount、Avg. Forex Rate、Settlement Amount** で、合計はテーブルの下に記載されます。`Tax Amount` は他のすべての金額と同様に `{Tax Currency} {Tax Amount}` の形式です。

`Avg. Forex Rate` は**単純平均ではなく加重平均**です。各構成レートはそれ自身の精算金額で加重されます。

```
Avg. Forex Rate = Σ (settlement amount ᵢ × forex rate ᵢ) / Σ (settlement amount ᵢ)
```

小数 8 桁まで保持されます。元金額の合計を精算金額の合計で割るとわずかに異なる数値になるため、その方法で再計算してもステートメントは再現できません。

## Invoiceには何が含まれ、なぜ複数の添付ファイルがあるのですか？

Invoiceは**手数料**を対象とし、手数料通貨ごとにグループ化されます。

| フィールド | ルール |
| - | - |
| `Invoice No` | お客様の Merchant ID + 対象セット内の最新の実際の精算時刻 + 手数料通貨 |
| `Invoice Date` | 対象となる精算のうち**最新の実際の精算日** |
| `Commission` | 手数料額とその通貨 |
| 複数の手数料通貨 | **手数料通貨ごとに 1 つの添付ファイル** — 金額が通貨をまたいで統合されることはありません |

ステートメントとInvoiceのメールは Waffo の財務メールボックスから送信されます。内容についてご質問がある場合は、送信者ではなく[サポート](mailto:support@waffo.com)に返信してください。

**IOF はInvoiceに含まれません。** 取引に IOF が適用される場合、Waffo はそれに対するInvoiceを発行できないため、Invoiceドキュメントから除外されます。精算計算には引き続き含まれます。

***

特定のファイルを照合していて、どうしても一致しませんか？ファイル名を添えて[サポートにお問い合わせください](mailto:support@waffo.com) — その中の精算バッチ ID と精算通貨だけで精算を特定できます。


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