> ## 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. # 精算データは実際にどこまで取得でき、どこで手に入りますか？ > 「このフィールドを追加できますか / これ用の API はありますか」という照合の質問に答えます：取引エクスポート、精算レポート、資金移動 API にどの識別子と切り口が存在するか、まったく存在しないものは何か、同じ月の 3 つのエクスポートが一致しない理由、どの書類が誰に発行されるか。 [精算ファイル仕様](/docs/ja/support/settlement-file-specification-faq)は、3 つのレポートファイルの列ごとの仕様です。 [精算レポートとエクスポート](/docs/ja/support/settlement-reports-export-faq)は、レポートを必要に応じて取得する方法を扱います。 **このページはその 1 つ手前の問いに答えます**。すなわち、ある特定のデータ — カードネットワークの参照番号、顧客の国、 精算通貨での精算金額 — がそもそも存在するのか、存在するならどの経路で取得できるのか、です。 サポートに列の追加を依頼する前にお読みください。最も要望の多いフィールドのいくつかは「エクスポートで利用できない」のではなく、 マーチャントから見える形でどこにも保持されていません。 ## 精算データを取得する 3 つの方法とは何ですか？ | 経路 | 得られるもの | 形式 | | - | - | - | | **照合レポートファイル** | Transaction Details、Settlement Details、Settlement Summary | CSV、UTF-8、日ごとまたは精算バッチごと | | **Merchant Portal のエクスポート** | 取引一覧、課金対象取引一覧、精算レポート、出金一覧、残高履歴 | バックグラウンドのエクスポートタスク、zip 内の CSV | | **API** | 注文 / 返金 / チャージバックの照会、残高照会、取引履歴、出金の事前確認・作成・照会 | JSON、リクエスト / レスポンス | **照合レポートや精算バッチを返す API はありません。** 精算レベルのデータはファイル（Portal からのダウンロードまたは SFTP 配信）として届き、API のレスポンスとして届くことはありません。財務システムが精算データをプログラムで必要とする場合、 連携点はエンドポイントではなくファイルです。 ## 資金移動の記録を受け取るために使える API はありますか？ **残高と口座の動き**についてはあります。精算レポートについてはありません。マーチャント向けのエンドポイントは 5 つです。 | エンドポイント | 目的 | | - | - | | `/api/v1/account/balance/inquiry` | 通貨ごと・口座ごとの現在の残高 | | `/api/v1/account/history/inquiry` | 口座の移動明細（Balance History の API 版） | | `/api/v1/withdraw/consult` | 出金の事前確認：手数料、受取金額、レート | | `/api/v1/withdraw/create` | 出金の作成 | | `/api/v1/withdraw/inquiry` | 出金のステータスと結果 | リクエストとレスポンスの仕様、および照会期間の制限は [出金・残高 API](/docs/ja/support/withdrawal-and-balance-api-faq)を参照してください。 したがって実務上の切り分けは、**口座の動き → API、精算の構成 → ファイル**です。 ## 精算ファイルで RRN（Retrieval Reference Number、フィールド 37）を取得できますか？ いいえ。3 つの照合レポートのいずれにも `RRN` の列はなく、Portal の取引エクスポートにもありません。 カード取引について、マーチャントから見える参照番号は次のとおりです。 | 識別子 | 取得場所 | 識別対象 | | - | - | - | | `Order Id` | レポート、エクスポート、注文照会 | その取引に対する Waffo の識別子 | | `Merchant Order Id` | レポート、エクスポート、注文照会 | 貴社自身の識別子 | | `payMethodRefId` | 注文照会の `payMethodResponse` 内 | 顧客が自身の決済手段の明細やアプリで目にする参照番号 | | `schemeTransactionId` | 注文照会の `payMethodResponse` 内 | 保存済み認証情報の一連の取引を連結するために使われる、カードスキームの取引識別子 | `payMethodResponse` は注文照会のレスポンス上の JSON 文字列で、返されるオブジェクトは**固定のキー一式**を持ちます。 決済手段の参照番号、スキーム取引 ID、トークン ID、マスクされたカード情報、カードのメタデータ、顧客が実際に支払った金額と通貨、 決済手段が使用したレートです。ネットワークの retrieval reference はその中に含まれないため、このフィールドを解析しても 取得できません。 銀行やイシュアと特定の取引を追跡しようとしている場合は、`Order Id` と決済日を添えてサポートに起票してください。 それが Waffo が端から端まで追跡できる識別子です。 ## レポートに列を追加してもらえますか — 自社の返金 ID、顧客の国、追加の参照番号など？ エクスポートされる列の一式はレポートの種類ごとに固定されています。すべてのマーチャントで同じであり、アカウントごとに 拡張されることはありません。制御できるのは次の点です。 | 制御項目 | 場所 | 効果 | | - | - | - | | 受け取るレポートの種類 | レポート配信の設定 | ファイル単位で追加・削除 | | **Customized Export** に含めるフィールド | Portal でエクスポートを構成するとき | 利用可能なフィールド一覧から選択 | | ファイルの配置先 | レポート配信の設定 | Portal のみ / Waffo の SFTP / 貴社の SFTP / メール | [レポート配信とメール配信登録](/docs/ja/support/report-delivery-and-subscription-faq)を参照してください。 探しているフィールドが別の名前ですでに存在する場合があります。依頼する前に [精算ファイル仕様](/docs/ja/support/settlement-file-specification-faq)を確認してください。 * 決済における貴社自身の参照番号は `Merchant Order Id` で、返金では `Merchant Original Order Id` が返金対象の決済を識別します * 返金やチャージバックが属する決済は `Original Order Id` です * 注文作成時に送信した貴社自身のユーザー識別子は `Merchant User Id` です ## 顧客の国別にレポートを出すにはどうすればよいですか？ レポートには通貨しかありません。 **消費者の国の列はありません。** 存在する国の切り口は**決済手段**の国であり、支払う人の所在地ではありません。 | 列 | 存在する場所 | 意味 | | - | - | - | | `Pay Method Country/Region` | Portal の取引エクスポート | その決済手段が属する国・地域 | | `Order Currency` | すべてのレポートとエクスポート | 請求した通貨 | | `cardIssueCountryCode` | カード決済について、注文照会の `payMethodResponse` 内 | カードイシュアの国（ISO 3166-1 alpha-3） | 明示しておく価値のある 2 つの帰結： * 取引エクスポートを `Pay Method Country/Region` でグループ化すると、**決済手段の市場別の売上**が得られます。これが 利用可能な最も近い代替であり、多くのマーチャントが最終的に使うものです。顧客の居住地と同じではありません。顧客は どこにいてもよく、ある市場で登録された決済手段を使えます。 * 特にカードの取引高については、注文照会の `cardIssueCountryCode` が取引ごとのイシュア国を示します。これはレポートの 列ではなく API 経由でのみ利用できるため、イシュア国別の内訳を作るには、事後ではなく決済時に貴社自身の記録を 拡充しておく必要があります。 Portal の分析機能も決済手段の切り口で取引高を国別に分解します。 [Portal 分析](/docs/ja/support/portal-analytics-faq)を参照してください。手早く答えが欲しいだけなら、エクスポートは 不要かもしれません。 ## 注文が USD 以外の通貨です。精算通貨での金額はどこにありますか？ 取引エクスポートにはありません。そのファイルには精算関連の列がまったくありません。取引はその翌日にエクスポートされ、 その時点では精算がまだ存在しない可能性があるためです。 | 探しているもの | 確認先 | | - | - | | 精算通貨に換算された注文金額 | Settlement Details および精算レポートのエクスポートの `Order Amount (Settlement Currency)` | | 使用されたレート | Settlement Details の `Forex Rate` / `Forex Currency Pair` | | 取引タイプごとの純額 | Settlement Summary | | 精算が存在する前の見積もり | 精算見積のエクスポート。`Est Forex Rate` と `Est Order Amount (Settlement Currency)` を含みます | 換算そのもの、およびどの通貨ペアとどの丸めルールが適用されるかは [精算計算の解説](/docs/ja/support/settlement-calculation-explained)にあります。 ## 精算通貨での精算金額を返す API はありますか？ いいえ。これは前の質問の最も多く尋ねられる変形であり、答えはファイルです。`Order Id` をキーとした Settlement Details の `Order Amount (Settlement Currency)` が、貴社の台帳に結合する行です。 ダウンロードではなくフィードとして必要な場合は、貴社自身の SFTP への配信を設定し、ファイルがプッシュされてジョブが 取得するようにしてください。 [レポート配信とメール配信登録](/docs/ja/support/report-delivery-and-subscription-faq)を参照してください。 ## 1 つの口座残高ではなく、チャネル別の資金内訳を見られますか？ いいえ。資金はチャネルごとのポジションではなく、**口座**として提示されます。 | 見えるもの | 場所 | | - | - | | 精算待ち残高、精算口座残高、Reserve残高、出金可能額 | Portal → Account → Balance、および `/api/v1/account/balance/inquiry` | | それらの残高を変化させたすべての動き | Portal → Balance History、および `/api/v1/account/history/inquiry` | Merchant Portal にチャネル別の資金画面はなく、残高 API にもチャネル別の内訳はありません。見つからないのは権限の 問題ではなく、その切り口がマーチャント側に存在しないのです。各残高の意味は [残高と取引履歴](/docs/ja/support/balance-and-account-history-faq)を、1 つの通貨で複数の口座が表示されうる理由は [精算口座の構造](/docs/ja/support/settlement-account-structure-faq)を参照してください。 ## 同じ月の 3 つのエクスポートが一致しません。どれが正式ですか？ 3 つは異なる問いに答えているため一致しません。どれも間違っていません。 | エクスポート | 行の基準 | 日付の基準 | 用途 | | - | - | - | - | | 取引一覧のエクスポート | ステータスを問わずすべての取引 | 決済日 | 運用上の取引量、注文レベルの検索 | | 課金対象取引のエクスポート | **失敗したもの**を含め、手数料が発生した取引 | 決済日 | 想定外の手数料の説明 | | 精算レポートのエクスポート | 精算バッチに含まれる取引 | 精算日 | Waffo が実際に支払った金額 | 「いくら支払われたか」については**精算レポート**が正式です。資金移動が構築された元と同じデータだからです。 「何を売ったか」については取引一覧が正式です。 典型的な不一致の原因は 1 つです。月末数日に発生した取引は翌月に精算されるため、ある月の取引エクスポートと、 翌月の精算レポートに現れます。 [決済日と精算日のどちらでエクスポートすべきか](/docs/ja/support/settlement-reports-export-faq)と [精算サイクル](/docs/ja/support/settlement-cycle-faq)を参照してください。 ## 先月の精算レポートにある注文が、その月の取引一覧で見つからないのはなぜですか？ 取引一覧をその月の**決済日**でフィルターしており、その注文の決済日は前の月にあるからです。11 月の精算日をカバーする 精算レポートには、10 月に支払われた取引が日常的に含まれます。 見つけるには、月で絞り込むのではなく、日付フィルターなしで `Order Id` により取引一覧を検索してください。 ## 取引一覧を「決済成功」でフィルターすれば、その月の売上になりますか？ いいえ。理由は 3 つあり、影響の大きい順に並べます。 1. **グロスであってネットではありません。** 手数料、税、Reserveの保留は取引時点ではなく精算時に適用されます。 [精算計算の解説](/docs/ja/support/settlement-calculation-explained)を参照してください。 2. **返金とチャージバックは独自の日付を持つ別の行です。** 同じ月に成功して同じ月に返金された決済は、それぞれ 1 回ずつ カウントされます。 3. **成功は精算済みを意味しません。** それらの取引の一部はまだ精算バッチに入っていません。 売上の数値は精算レポートから始めてください。発生主義の数値には、精算見積のエクスポートが、見積であることを示す `Est` 列とともに未精算の部分を提供します。 ## Settlement Status 列は何を意味しますか？ UNSETTLED の注文は今月の売上に入りますか？ 精算レポートのエクスポートの `Settlement Status` は、その取引が精算バッチに入ったかどうかを示します。 | 値 | 意味 | | - | - | | `SETTLED` | 取引は精算バッチに入っており、その精算金額は確定しています | | `UNSETTLED` | 取引はバッチに入っておらず、表示される精算金額はすべて見積もりです | `UNSETTLED` の取引が今月の売上に属するかどうかは Waffo ではなく**会計方針の問題**です。現金主義では属さず、 発生主義では属し、見積の列が計上の対象になります。Waffo はそれらの行が精算された後に月次を修正することはしません。 単に後のレポートで `SETTLED` として現れます。 この列とエクスポートのフィルターについての詳細は [精算レポートとエクスポート](/docs/ja/support/settlement-reports-export-faq)にあります。 ## Settlements → Transaction と Transactions ページの違いは何ですか？ 似て見えますが、異なる問いに答えています。 | 画面 | 1 行が表すもの | 資金の見え方 | | - | - | - | | **Transactions** | 貴社または顧客が作成した決済、返金、チャージバック | 何が起きたか | | **Settlements → Transaction** | 精算に入った時点の取引。手数料、レート、精算金額を伴う | それが貴社にとっていくらだったか | 取引は Transactions には直ちに現れ、Settlements → Transaction には精算が処理した後にのみ現れます。課金されたが 注文金額を持たない取引、すなわち手数料が発生した失敗取引は、精算側に現れ、取引側では奇妙に見えます。そのケースは [失敗した取引への課金](/docs/ja/support/failed-transaction-billing-faq)で扱っています。 ## 精算バッチの明細は今どこからダウンロードしますか？ Portal → Settlements → Reports です。バッチレベルの明細、Customized Export、精算見積のエクスポートはいずれも **バックグラウンドタスク**です。リクエストすると生成され、同じ画面のエクスポート履歴にダウンロード可能なファイルとして 現れます。ブラウザにストリーミングされることはありません。 作成できるエクスポートの種類が限られている場合、利用できるエクスポートの種類は貴社アカウントのレポート設定に依存します。 種類の完全な一覧と各期間の上限は [精算レポートとエクスポート](/docs/ja/support/settlement-reports-export-faq)に、タスクのステータスとダウンロードリンクの 有効期間は[エクスポートセンター](/docs/ja/support/export-center-faq)にあります。 ## レポートの行と銀行に着金した資金を結び付ける識別子はどれですか？ どちら側から始めるかによります。 | 手元にあるもの | 結合キー | | - | - | | 精算レポートの行 | `Settlement Batch Id` — 1 つのバッチ内のすべての行は 1 回の資金移動として支払われます | | 銀行明細上の入金 | その精算日・精算通貨の精算バッチ。バッチごとに Settlement Statement の PDF が存在します | | 銀行明細上の出金 | 出金の注文 ID と、出金照会の `bankRefId` | | 個々の取引 | `Order Id`。取引レポートと精算レポートの両方に現れます | 1 つの精算日が複数のバッチを生むことがあります。 [精算バッチとカレンダー](/docs/ja/support/settlement-batch-and-calendar-faq)を参照してください。 ## Portal から自社の顧客にInvoiceを発行できますか？ いいえ。Waffo が作成する 2 つの書類には決まった方向があります。 | 書類 | 発行者 | 宛先 | 対象 | | - | - | - | - | | **Invoice** | Waffo | 貴社 | Waffo の手数料。手数料通貨ごとにまとめられます | | **Settlement Statement** | Waffo | 貴社 | 1 つの精算バッチ | | **Receipt** | 貴社（Waffo 経由） | 貴社の顧客 | 1 件の取引 | したがって、Portal にある Invoice は手数料に関する Waffo の**貴社宛て**のInvoiceです。顧客に渡せる書類ではなく、 マーチャントがエンドカスタマーにInvoiceを発行する機能はありません。顧客向けの書類は取引の **Receipt** です。内容、設定、 配信は [領収書の設定とダウンロード](/docs/ja/support/receipt-configuration-and-download-faq)と [Portal の領収書](/docs/ja/support/portal-receipt-faq)にあります。 Invoiceの採番、複数の添付が同時に届く理由、Invoiceから除外されるものは [精算ファイル仕様](/docs/ja/support/settlement-file-specification-faq)にあります。 ## 返金された取引や、まだ精算されていない取引のInvoiceを取得できますか？ Invoice は**精算済み取引の手数料**を対象とし、その日付は対象範囲内の最新の実際の精算日から導出されます。精算されていない 取引は、まだどのInvoiceにも手数料を寄与していないため、Invoiceには載りません。その取引は、精算が行われた期間を対象とする Invoiceに現れます。 *** 特定のフィールドでまだ行き詰まっていますか？ レポートのファイル名と探している列を添えて [サポートにお問い合わせください](mailto:support@waffo.com)。ファイル名を伝えることで、そのフィールドが別の名前で 存在するのか、まったく存在しないのかをサポートが回答できます。 This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.