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

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

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

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

ダウンロード可能なファイルがあるのは 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 つの検証が実行され、それぞれ固有のメッセージがあります。 処理中チェックはアカウント単位ではなくレポートタイプ単位です。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)をプレフィックスとして使用します。

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

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

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

Subscriptions の Reports タブは、いずれかの行が Pending Export または Retry Needed の間はポーリングを行い、 すべての行が終了状態になると停止します。Transactions と Payout の Reports タブはポーリングを行わないため、 日付フィルターを再適用するか、タブを再度開いて最新のステータスを取得してください。
ファイルがまだ見つかりませんか? モジュール名、エクスポート日、Reports の行に表示されているファイル名を添えて サポートにお問い合わせください。