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

# エクスポートとレポートのダウンロード

> Portal の一覧エクスポートは即時ダウンロードではなくバックグラウンドタスクです：完成したファイルがどこに表示されるか、4 つのタスクステータスの意味、Failed Count が行の欠落を意味しない理由、ダウンロードリンクの有効期限、エクスポート開始前にブロックされる日付範囲と行数の上限。

Portal の一覧エクスポートのほとんどは、ブラウザーにファイルを直接ストリーミング**しません**。**Export** を押すと
バックグラウンドタスクがキューに入り、完成したファイルは後で同じモジュール内の **Reports** 一覧から取得します。
エクスポートされるファイルの列定義は
[Reconciliation reports](/docs/ja/developer-docs/tools-and-references/references/reconciliation-reports) に記載されています。

## Export をクリックしましたが何もダウンロードされません。ファイルはどこにありますか？

確認ダイアログには、レポートは*エクスポート中*であり、Reports タブに戻って確認するよう表示されます。
タスクとそのファイルはそのタブにあります。

| エクスポート元 | ファイルの取得先 |
| - | - |
| Transactions → **Payments** | Transactions → **Reports**（ファイルタイプ `Payments`） |
| Transactions → **Refunds** | Transactions → **Reports**（ファイルタイプ `Refunds`） |
| Subscriptions 一覧 | Subscriptions → **Reports**（ファイルタイプ `Subscriptions`） |
| Payout → History → **Single Payouts** | Payout → History → **Reports**（`Single Payouts`） |
| Payout → History → **Batch Payouts** | Payout → History → **Reports**（`Batch Payouts`） |

Reports 一覧の初期表示は**エクスポート日の過去 1 か月**（UTC+8）であるため、それより古いタスクは日付フィルターを
広げる必要があります。各行には Export Date、Status、File Type、Create Time、Success Time、ファイル名が表示され、
Transactions の行にはさらに **Failed Count** が表示されます。お使いの Portal に Reports タブが表示されているモジュールでは、
そのモジュールからのエクスポートが利用できます。タブと Export ボタンはセットで提供されます。

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

| ステータス | 意味 | 終了状態？ | 対応 |
| - | - | - | - |
| **Pending Export** | タスクは受け付けられたが、ファイルはまだ生成されていない | いいえ | 待つ |
| **Retry Needed** | 試行が失敗し、タスクは再実行のためキューに入っている | いいえ | 何もしない — 下記参照 |
| **Exported** | ファイルが生成され、準備完了 | はい | ファイル名をクリックする |
| **Export Failed** | 自動再試行が成功せず、このタスクからファイルは生成されない | はい | フィルターを絞り込んで再度エクスポートする |

ダウンロード可能なファイルがあるのは **Exported** の行のみです。Payout の Reports タブでは、`Exported` 以外の行は
ファイル名の代わりに `-` が表示されます。

## ステータスが Retry Needed になっています。何かする必要がありますか？

いいえ。**Retry Needed** は自動的な状態であり、指示ではありません。タスクには送信したフィルターが保存されており、
短いクールダウンの後にバックグラウンドジョブがその行を再度取り上げ、まったく同じフィルターで再実行します。
これは **Exported** または **Export Failed** に到達するまで繰り返されます。

行が **Retry Needed** の状態のまま同じモジュールで再度 **Export** を押すと、2 つ目のタスクが作成されるのではなく
*その同じタスクが再開*されるため、重複ファイルが生成されることはありません。

## Failed Count が 0 ではありません。エクスポートしたデータは不完全ですか？

いいえ。**Failed Count** は*そのタスクの生成試行の失敗回数*を数えるもので、スキップされたり欠落した行の数ではありません。
ステータスが **Exported** で `Failed Count = 2` の行は、後の試行でファイルが生成されたことを意味し、送信したフィルターに対して
完全なデータです。完了できなかった実行は、代わりに行を **Retry Needed** または **Export Failed** のままにします。
**Exported** の下に部分的なデータが公開されることは決してありません。

## ダウンロードリンクは期限切れになりますか？

はい。これは意図的な設計です。行にはリンクが保存されていません。ファイル名をクリックすると、その時点で有効期間の短い
新しいリンクが発行されて開きます。以前にコピーしたリンクが
使えなくなった場合は、Reports の行に戻ってファイル名を再度クリックしてください。タスクの行は一覧に残るため、
ファイルは後からでも再取得できます。

## タスクが作成される前にエクスポートが拒否されたのはなぜですか？

送信時に 4 つの検証が実行され、それぞれ固有のメッセージがあります。

| メッセージ | 原因 | 対処 |
| - | - | - |
| *The current query data is empty* | 一致するレコードが 0 件 — タスクは作成されない（Subscriptions） | フィルターを調整する |
| *The previous export is still in progress* | そのレポートタイプに **Pending Export** の行がすでに存在する | 完了を待つ |
| *Too many records to export* | 結果件数が 1 回のエクスポートのレコード上限を超えている | 日付範囲またはフィルターを絞り込む |
| *Time frame should not exceed one month* | Settlement Estimation エクスポートの期間 | より短い範囲に分割する |

処理中チェックはアカウント単位ではなく**レポートタイプ単位**です。Payments のエクスポートが進行中でも Refunds のエクスポートは
ブロックされず、逆も同様です。

Payments と Refunds では、結果が空でもヘッダーのみのファイルが生成されるため、「一致する取引がない」ことと
エクスポートの失敗を区別できます。事前に拒否するのは Subscriptions のエクスポートのみです。

## エクスポートの期間とサイズの上限はどのくらいですか？

* **日付範囲：31 日。** Payments、Refunds、Payout 履歴のエクスポートでは日付ピッカーとサーバー側の両方で強制されるため、
  手動で組み立てたより広い範囲も拒否されます。Settlement Estimation のエクスポートは 1 か月が上限です。
* **1 ファイルあたりの行数：60,000。** 上限内であれば `.csv` が 1 つ生成されます。上限を超えると、タスクは番号付きのファイル
  （`..._001.csv`、`..._002.csv`、…）に分割され、単一の `.zip` として提供されます。Reports の行は 1 つ、ダウンロードは 1 回、
  中に複数のファイルが入ります。
* **ファイル命名規則：** `{report type}_{MID}_{from}_{to}.csv`。両方の日付は **UTC+8** の `YYYYMMDD` です。
  例：`payments_{MID}_20260801_20260827.csv`。Payout のファイルはレポートのラベル
  （`Single Payouts`、`Batch Payouts`）をプレフィックスとして使用します。

## どのエクスポートが非同期で、どれが即時ダウンロードですか？

| エクスポート | 方式 |
| - | - |
| Payments、Refunds、Subscriptions、Payout の単件および一括履歴 | バックグラウンドタスク → モジュールの **Reports** タブ |
| Settlement のバッチ詳細、Customized Export、Estimation | バックグラウンドタスク → Settlements → Reports → エクスポート履歴 |
| Batch Refunds 一覧、精算カレンダー | ブラウザーで直接ダウンロード |
| Payout → **Report** | オンデマンドではない — 定期生成されたファイルがダウンロード用に一覧表示される |

Settlement のエクスポートは、上記の 4 状態ではなく **3** 状態の履歴（`Pending` / `Success` / `Failed`）で一覧表示されます。
そこには Retry Needed も Failed Count もありません。

## Reports 一覧は自動で更新されますか？

Subscriptions の Reports タブは、いずれかの行が **Pending Export** または **Retry Needed** の間はポーリングを行い、
すべての行が終了状態になると停止します。Transactions と Payout の Reports タブはポーリングを行わないため、
日付フィルターを再適用するか、タブを再度開いて最新のステータスを取得してください。

***

ファイルがまだ見つかりませんか？ モジュール名、エクスポート日、Reports の行に表示されているファイル名を添えて
[サポートにお問い合わせください](mailto:support@waffo.com)。


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