> ## 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 のレポートファイルがお手元に届く 4 つの方法 — Portal からのダウンロード、Waffo の SFTP、ご自身の SFTP、またはメール — に加えて、精算レポートのメール配信登録をご自身で管理する方法：スケジュール、宛先、本文の言語、送信履歴、配信変更が反映されるタイミング。

[精算レポートとエクスポート](/docs/ja/support/settlement-reports-faq)では、数値がどのように算出されるか、レポートをオンデマンドで取得する方法を説明しています。本ページではもう半分、**レポートファイルが定期的にどのように届くか**、そして精算レポートのメール配信登録をご自身で管理する方法を扱います。ファイルのレイアウトと SFTP のパスは[対帳レポート](/docs/ja/developer-docs/tools-and-references/references/reconciliation-reports)に記載されています。

## レポートファイルはどこに配信できますか？

定期レポートファイルは 4 つの配信先に対応しています。レポートファミリーごとに**ちょうど 1 つ**が有効で、どれを選んでも Portal からのダウンロードは常に利用できます。

| 配信先 | 動作 | 選ぶべき場面 |
| - | - | - |
| **Portal のみ** | プッシュなし — ファイルが生成され、Portal 内で待機します | 手作業で照合する場合 |
| **Waffo SFTP** | Waffo が発行する SFTP アカウント上の、ドキュメント記載のパスに配置されます | 自前のインフラなしにプル型のフィードが欲しい場合 |
| **ご自身の SFTP** | Waffo がお客様の SFTP ホストに接続し、そこにファイルを書き込みます | 財務システムが既に SFTP エンドポイントを監視している場合 |
| **メール** | 設定した宛先へ**メールの添付ファイル**として送信されます | ファイルを利用するのがシステムではなく人である場合 |

配信先は**レポートファミリーごと**に設定されます — 取引明細、精算、ステートメント、Invoice、および一覧エクスポートは個別に設定されます — そのため、精算ファイルは SFTP で取得しつつ、ステートメントはメールボックスに送るといったことが可能です。あるファミリーをメールまたはご自身の SFTP に向けると、そのファミリーの Waffo SFTP アカウントへのプッシュは停止します。

これらの配信先は Portal の画面からではなく、サポートと調整して設定します。**Waffo SFTP** にはアカウント情報を受け取るメールボックスと、接続元のパブリック IP または IP 範囲が必要です。**ご自身の SFTP** にはホスト、ポート、ユーザー名、パスワード、ベースディレクトリが必要です。**メール**には宛先と CC のアドレスが必要です。どちらの SFTP 配信先でも、ファイルはベースディレクトリ配下に元のファイル名のまま、同じ `/{report family}/{date}/` のサブパスで配置されるため、1 つのスクリプトがどちらに対しても動作します。Waffo SFTP アカウント上のファイルは限られた期間のみ保持されます — Portal 上のコピーは残ります。

## 配信先を変更しました。いつから反映されますか？

**次回のエクスポートサイクル**からです。既に実行中のジョブは開始時の設定で完了するため、現在実行中のサイクルは引き続き旧配信先に届きます — 新しい配信先に最初のファイルが届いたことを確認するまで、旧 SFTP パスまたはメールボックスに到達できる状態を維持してください。

## サポートに依頼せずに、精算レポートをスケジュールでメール送信できますか？

はい — **Settlements → Settlement Reports → Email Subscription** です。1 つの配信登録が 1 つの定期メールに対応します。レポートの組み合わせ、日付基準、スケジュール、宛先、本文の言語で構成されます。このタブは権限で制御されています — そのページ上にタブが見えていれば、この機能はお客様のアカウントで利用可能です。そこでできることは次のとおりです。

| 操作 | 内容 |
| - | - |
| **配信登録一覧** | お客様の配信登録。ページ分割され、ステータスと最終送信を表示します |
| **追加 / 編集** | 配信登録を作成する、または既存の配信登録のレポート、スケジュール、宛先、言語を変更する |
| **一時停止 / 再開 / 削除** | 配信登録を `ACTIVE` と `SUSPENDED` の間で切り替える、または削除する |
| **送信履歴** | 1 つの配信登録の送信試行 |
| **プレビュー** | フォームの横に表示されるメール本文のリアルタイム描画 |

## どのレポートを、どの日付基準で送れますか？

**Report Type** は複数選択で、少なくとも 1 つが必須です。*Transaction Settlement Detail*（デフォルト）、*Daily Settlement Summary*、*Selected Period Summary* — Customized Export が提供するものと同じ 3 種類です。**Time Dimension** は、データ期間を区切る日付を設定します。

| Time Dimension | 意味 |
| - | - |
| `PAYMENT_DATE`（デフォルト） | 取引の決済日で区切ります。完了済みでまだ精算待ちの取引の**見込み**データを含みます |
| `SETTLEMENT_DATE` | 実際の精算日で区切るため、すべての行が精算済みの数値になります |

受信者がこのメールを最終的な会計情報として扱う場合は、`SETTLEMENT_DATE` を選択してください。

## スケジュールはどう設定しますか？タイムゾーンは何ですか？

| Schedule Type | Schedule Detail |
| - | - |
| `DAILY` | 時刻のみ |
| `WEEKLY` | 曜日（月曜〜日曜）+ 時刻。デフォルト：月曜 09:00 |
| `MONTHLY` | 日付 1〜31 + 時刻。**31 は月末を意味する**ため、2 月でも送信されます |

時刻は `00:00`〜`23:00` の正時で、**(UTC+8)** と表記されます — 精算の他のすべての箇所で使われるものと同じ日次締めです。分単位の設定はありません。

## 宛先は何件まで、件名は何、言語はどれですか？

| フィールド | ルール |
| - | - |
| **宛先 (To)** | ちょうど **1 件**のアドレス。他の方には CC を使用してください |
| **CC** | 最大 **10 件**のアドレス。カンマ、スペース、またはセミコロンで区切って貼り付けます |
| **メール件名** | 必須、最大 200 文字。`WAFFO-Settlement Report-{your MID}-{your merchant name}` があらかじめ入力されています |

配信登録を保存する前に、すべてのアドレスが検証されます。**To** には配布リストを入れ、CC は個人用にしてください。

**メール本文の言語**は配信登録ごとに設定します — English、中文、または にほんご — Portal の利用言語とは独立しているため、2 つの配信登録で地域チームと現地チームそれぞれに各自の言語で提供できます。本文の**リアルタイムプレビュー**がフォームの横に表示され、言語、Time Dimension、スケジュール、件名を変更すると再描画されます。

## 配信登録が停止した、または送信が失敗しました。どこを見ればよいですか？

配信登録は `ACTIVE` または `SUSPENDED` です。**一時停止**は送信を止めますが設定は保持し、**再開**で元に戻し、**削除**で完全に取り除きます。**最終送信**列は、静かに停止した配信登録を見つける最も早い方法です。次に**送信履歴**が各試行を一覧します。

| 列 | 分かること |
| - | - |
| **ステータス** | 送信処理中は `Pending`、その後 `Success` または `Failed` |
| **トリガー時刻** | スケジュールが発火した時刻 |
| **データ期間** | レポートが実際にカバーした期間の開始と終了 |
| **宛先 (To)** | その試行で使用されたアドレス。当時の設定どおり |
| **結果** | 成功時は送信タイムスタンプ、失敗した試行では失敗理由 |

失敗した試行にはそれぞれ理由が付き、最も多いのは受信者側がメッセージを拒否したケースです。配信登録を編集して修正してください。次回のスケジュール実行では新しい値が使われます。各行はその試行時点で有効だった宛先を保持するため、古い行には古いアドレスが表示されます。

***

レポートファミリーを新しい配信先に向ける必要がありますか？ファミリーと配信先を添えて[サポートにお問い合わせください](mailto:support@waffo.com)。


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