どのレポートファイルが提供され、それぞれいつ生成されますか？
3 つはすべて CSV、UTF-8 エンコードです。2 つの精算レポートは精算バッチに紐付き、取引レポートは取引日に紐付いており、精算サイクルとは独立しています。
この区分から 2 つの動作が生じ、「ファイルが見つからない」という問い合わせの大半の原因になっています。
- 取引のない日でも Transaction Details ファイルは生成されます — ヘッダー行のみを含みます。
- ネット精算のない精算日には精算ファイルはまったく生成されません。精算バッチが存在しないためです。代わりにすべての予定日にプレースホルダーが必要な場合は、加盟店ごとの設定になります — 精算レポートとエクスポートを参照してください。
正確なファイル名は何ですか？
transaction dateとsettlement dateは UTC+8 のYYYYMMDDです。PDF の日付はYYYYMMDDです。settlement currencyが精算ファイル名に含まれるのは、バッチが精算通貨ごとにまとめられるからです。1 つの精算日に 2 つの精算通貨がある場合は2 セットのファイルを受け取り、この最後の要素で区別できます。- 再生成が必要なファイルは上書きされません。新しいバージョンサフィックスで再度書き出されます（
..._v1.0_1.csvの次は..._v2.0_1.csv）。そのため、既に取得したダウンロードが知らないうちに変わることはありません。
ファイルはどこに配信され、どれくらいの期間保持されますか？
ファイルは加盟店 Portal で利用でき、SFTP 配信を使用している場合はドキュメント記載の取引および精算ディレクトリ配下にも置かれます — 正確なパスは対帳レポートを参照してください。 対帳レポートは SFTP サーバー上では限られた期間のみ保持されます。加盟店 Portal からは引き続きダウンロードできます。 プルジョブがしばらくオフラインだった場合は、SFTP ではなく Portal から欠落分を回復してください。 SFTP アクセスは、ユーザー名とパスワードまたは鍵認証の 2 つのログイン方法に対応しています。鍵認証が推奨される方法です。Transaction Details — フィールド辞書
Payment Date と Payment Time は意図的に 2 つの別々の列になっています。日付列は取引がどの取引日 — したがってどの精算 — に属するかを決めるものであるため、タイムスタンプを解析せずにグループ化キーとして使用できます。
Settlement Details — フィールド辞書
Transaction Details と同じ行粒度に、各取引の精算結果が加わります。
税はどの税であっても単一の
Tax Amount 列として報告されます。VAT や源泉徴収税の個別の列はありません — 手数料と税の取り扱いを参照してください。
Settlement Summary — フィールド辞書
単一の精算通貨について、取引タイプごとに 1 行、加えてTOTAL 行があります。
サマリーには
Order Amount 列はありません。すべての金額列は既に精算通貨で表されており、それによって行同士を加算できます — 異なる注文通貨、手数料通貨、税通貨の金額が元の通貨のまま合計されることは決してありません。
通貨は小数 2 桁なのに、ファイルには 6 桁表示されるのはなぜですか？
精算精度が加盟店ごとの設定だからです。お客様のアカウントは小数 2 桁または 6 桁のいずれかに設定され、一度設定されると固定されます。6 桁のアカウントでは、精算通貨の金額は小数 6 桁で書き出され、その幅までゼロ埋めされるため、整数は99.000000 と表示されます。元の注文通貨での Order Amount はその通貨固有の小数桁を保持し、埋められません。
固定幅で、値が短い場合は常にゼロ埋めされます。
6 桁のアカウントでは、これにより明細行がバッチと正確に一致します。明細の
Settlement Amount の合計が、端数なしでバッチ金額と等しくなります。
Forex Currency Pair はいつ値を持ち、どのペアになりますか？
手数料と税は注文通貨でも精算通貨でもない通貨で課金されることがあるため、ペアは優先順位で決定されます — 最初に一致した条件が採用されます。
注文金額を持たない行 — 課金対象の失敗試行、またはチャージバックアラート — は手数料通貨のみを評価します。勝訴したチャージバックは注文通貨のみを評価します。
そのため、注文通貨が既に精算通貨と同じであっても、行にペアが入ることがあります。その行の為替ステップは注文ではなく手数料または税に対するものです。
Forex Rate はペアが空のときに限り空になります。
バッチ ID がすべてゼロの精算ファイルを受け取りました。これは何ですか？
それはプレースホルダーで、精算が発生したときだけでなくすべての予定精算日にファイルを生成するようアカウントが設定されている場合にのみ生成されます。1 か月分の精算明細を一括でダウンロードできますか？
はい。Settlement Batch 一覧から行います。Actual Settlement Date の範囲を選択し、バッチをまとめてダウンロードします。min settlement date と max settlement date は選択範囲内の最も早い精算日と最も遅い精算日で、YYYYMMDD UTC+8 です。リクエストは非同期で実行されます — エクスポートとレポートのダウンロードの説明どおり、Reports モジュールから結果を取得してください。
異なる切り方をしたい範囲 — 決済日別、注文通貨別、または取引ごとではなく日次サマリー — には、代わりに Customized Export を使用してください。そのオプションは精算レポートとエクスポートに一覧されています。
PDF ドキュメントはどのような書式規則に従いますか？
精算ステートメント、出金ステートメント、Invoiceは 1 つのレイアウトと 1 組の規則を共有しているため、値の意味は 3 つすべてで同じです。
ページの順序も固定です。発行元 Waffo エンティティの名称と住所、次にドキュメントブロック（日付と番号）、次にお客様の会社名と住所、そして業務明細テーブルです。
精算ステートメントには何が含まれ、そのレートはどう計算されますか？
列は Country/Region、Transaction Amount、Fee Amount、Tax Amount、Avg. Forex Rate、Settlement Amount で、合計はテーブルの下に記載されます。Tax Amount は他のすべての金額と同様に {Tax Currency} {Tax Amount} の形式です。
Avg. Forex Rate は単純平均ではなく加重平均です。各構成レートはそれ自身の精算金額で加重されます。
Invoiceには何が含まれ、なぜ複数の添付ファイルがあるのですか？
Invoiceは手数料を対象とし、手数料通貨ごとにグループ化されます。
ステートメントとInvoiceのメールは Waffo の財務メールボックスから送信されます。内容についてご質問がある場合は、送信者ではなくサポートに返信してください。
IOF はInvoiceに含まれません。 取引に IOF が適用される場合、Waffo はそれに対するInvoiceを発行できないため、Invoiceドキュメントから除外されます。精算計算には引き続き含まれます。
特定のファイルを照合していて、どうしても一致しませんか？ファイル名を添えてサポートにお問い合わせください — その中の精算バッチ ID と精算通貨だけで精算を特定できます。