> ## 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 で設定できること、設定変更が過去の取引に影響するかどうか、領収書の URL、貴社の設定が及ばない取引について説明します。

このページでは、書類としての領収書を扱います。顧客がダウンロードするときに何を見るか、そしてその内容について貴社が何を制御できるかです。取引から領収書を表示・メール送信することと、そのメールの配信ステータスは、Receipts: View, Send & Configure のページで扱っています。

## 顧客は領収書をダウンロードするとき何を選びますか？

どの入口から来ても、同じ領収書ページに到達し、同じダイアログが表示されます。

| 選択項目 | 挙動 |
| - | - |
| **言語** | 英語は常に提供され、あらかじめ選択されています。注文自身の言語が英語でない場合、それが 2 つ目の選択肢として提供され、こちらもあらかじめ選択されています。少なくとも 1 つの言語は選択されたままである必要があります |
| **会社名** | 選択した言語ごとの任意の自由記述。領収書に表示すべき名称で、通常は経費精算のためのものです |

両方の言語を選択すると、1 回の操作で**両方の領収書**がダウンロードされます。会社名は言語ごとに入力します。会社の法人名は英語と現地語で通常同じ文字列にならないためです。

会社名のフィールドは、そのブロックを持つ領収書にのみ表示されます。顧客に表示されない場合、その取引の領収書は対応していません。

## 顧客が入力した会社名を修正できないのはなぜですか？

会社名は**言語ごとに、一度送信すると固定される**ためです。これは意図的なものです。領収書は会計上の書類であり、同じ取引から宛名の異なる 2 通の領収書が生まれることは、領収書が取り除くべき曖昧さそのものだからです。

ルールの全体は次のとおりです。

| 操作 | 結果 |
| - | - |
| ある言語での最初の送信 | 受け付けられ、保存されます |
| 同じ言語で**同じ**値を再送信 | 成功し、何も変わりません。再試行しても安全です |
| 同じ言語で**異なる**値 | 拒否：`008001B115` — 「Receipt company name has already been submitted and cannot be changed. Please download the receipt with the submitted name.」 |
| **別の**言語で初めて | 受け付けられます。言語同士は独立しています |

ある言語に名称が保存されると、その言語では入力欄は表示されなくなり、ダウンロードは保存された値をそのまま使用します。

名称は**その注文とその言語**に紐づきます。新しい注文はまっさらな状態から始まり、同じ顧客の以前の購入から引き継がれるものはありません。したがって、名称の修正が必要な顧客には、新しいダウンロードではなく新しい取引が必要です。

値の検証：

| ルール | 制限 |
| - | - |
| 最大長 | **200 文字** |
| 前後の空白 | 保存前にトリムされます |
| 禁止文字 | `<` と `>`、および制御文字 |

## 顧客が持っている領収書のリンクが開きません。有効なリンクの形はどれですか？

2 つの形があり、どちらも有効です。

| 形 | 何か |
| - | - |
| `/receipts/form?orderKey=…&locale=…` | 中間の領収書ページ。言語と会社名のダイアログを経てダウンロードします |
| `/receipts/{orderKey}.pdf?locale=…&tz=…` | 領収書の書類そのもの |

中間ページが開かないケースは 3 つあり、メッセージがどれかを示します。注文キーがない、注文が成功状態でない、または取引に領収書がない場合です。`008001B116` —「Receipt link expired」— はリンクが有効期間を過ぎたことを意味します。Portal または注文照会のレスポンスから新しいものを発行してください。

## 領収書の内容について何を設定できますか？

Merchant Portal で **Settings → Receipt Configuration** を開いてください。設定できるブロックは次のとおりです。

| ブロック | フィールド |
| - | - |
| **Receipt header** | 書類のタイトル、マーチャント表示名、マーチャントのロゴ |
| **Billed to（顧客情報）** | 顧客名の表示（オン/オフ）、顧客メールアドレスの表示（オン/オフ）— 値そのものは取引に由来し、編集できません |
| **From（サービス提供事業者）** | 事業者名、税務番号、住所 |
| **Footer & support** | サポートの文言、サポートの Web サイト |

フィールドのルール：

| フィールド | ルール |
| - | - |
| 書類のタイトル | 最大 **50 文字**。`<` と `>` は拒否されます。空の場合は `Receipt` にフォールバックします。`Tax Invoice`、`Invoice`、`Order Confirmation` などにしたい場合はここを使います |
| その他のすべてのテキストフィールド | 最大 **128 文字**。空のフィールドは領収書上で空白として描画されるのではなく**非表示**になります |
| サポートの Web サイト | サポートの文言の `{website}` プレースホルダーに挿入されます |
| マーチャントのロゴ | 空にするとロゴが非表示になります |
| **Receipt Enabled** | テンプレートごと：そのテンプレートを使う取引がそもそも領収書を生成するかどうか |

手数料の行とサブスクリプション情報は、その取引に該当する場合にシステムが描画します。追加も抑制もできません。

編集では、単一フィールドの **Reset** と、テンプレート全体の **Restore all defaults** に対応しています。どちらも有効にするには **Save** が必要です。

## 設定を変更すると、過去の取引の領収書も変わりますか？

**はい。そして保存する前に理解しておくべき唯一のことがこれです。** 取引ごとの設定のスナップショットはありません。Portal は 2 か所でこれを明示しており、確認ダイアログにも明記されています。変更は即座に有効になり、**過去と今後のすべての取引**の領収書表示に影響します。

実際には、先月領収書をダウンロードした顧客が変更後に再度ダウンロードすると、新しいタイトル、事業者情報、ロゴの書類が得られます。過去の領収書を発行時のまま保持しなければならない場合は、貴社自身で控えを保管する必要があります。Waffo はバージョン管理を行いません。

## 領収書のレイアウトを複数持てますか？

はい。**テンプレート**として持てます。

| ルール | 詳細 |
| - | - |
| 複数のテンプレート | それぞれが独自のタブとして表示され、`Template 1`、`Template 2`、… と名付けられます |
| デフォルトはちょうど 1 つ | デフォルトにはタグが付き、**削除できません** |
| テンプレートの追加 | **Add Template** で現在のデフォルトをそっくりコピーし、そのコピーを編集します |
| デフォルトの変更 | 確認を経て行います。特定のテンプレートを持たない取引はデフォルトを使用します |
| テンプレートの削除 | 確認を経て行います。それを使っていた取引は**デフォルト**テンプレートにフォールバックします |
| 注文ごとの選択 | 注文作成時に `paymentInfo.receiptTemplateId` を渡します |

デフォルトを編集しても他のテンプレートには**伝播しません**。それらは参照ではなくコピーだからです。

何も設定したことがない場合、ページは領収書がまだ有効でない、あらかじめ値の入った 1 つのテンプレートで開きます。

## 領収書の設定に Waffo の審査は必要ですか？

いいえ。セルフサービスで、保存時に有効になり、承認のステップはありません。保存を妨げるものが 2 つあります。

| 拒否 | 意味 |
| - | - |
| バージョン競合（`008001B126`） | 編集中に他の誰かが同じ設定を保存しました。更新して再度適用してください。後からの保存は黙って上書きするのではなく拒否されます |
| タイトルのエラー（`008001B129` / `008001B130`） | タイトルが長すぎる、または禁止文字を含んでいます |
| `008001B128` | デフォルトテンプレートを削除しようとしました |
| `008001B127` | テンプレートがもう存在しません |

すべての変更は記録されます。ページの **Change history** には、テンプレートごとに誰が何をいつ変更したかが新しい順に表示され、作成 / 更新 / デフォルト設定 / 削除のイベントが含まれます。フォームの上のカードには最後の操作者と日時が表示されます。

## 設定で変更できないものはありますか？

はい。これは設定ではなく、明確な境界線です。

Waffo 自身のルールのもとですでに領収書が生成される取引、つまりコンプライアンス上の理由で発行される領収書や、Waffo が決済の記録上の当事者であるために発行される領収書は、**常に**そのルールに従います。貴社の設定は適用されず、**Receipt Enabled** のトグルでそれらの領収書をオフにすることもできません。Portal は設定ページ上でこのことを明記しています。

貴社の設定が支配するのは逆方向、つまり本来であれば領収書を生成しない取引です。テンプレートを有効にするとはそういうことです。

## 取引に領収書がまったくないのはなぜですか？

領収書が存在できるのは、次のすべてが成り立つ場合のみです。決済が**成功**の状態に達し、Waffo のチェックアウトセッションを経由しており、その取引に領収書が適用されること（Waffo 自身のルールによるか、貴社がテンプレートを有効にしたことによるか）。いずれも成り立たない場合、取引詳細ページは領収書ブロックを完全に非表示にし、その注文に対するメール送信リクエストは `RECEIPT_NOT_ENABLED` で拒否されます。

## 領収書の書類は何語で作られますか？

領収書ページは常に**英語**を提供し、注文自身の言語が英語でない場合はそれも提供します。その言語は注文からシステムが決定するもので、貴社が設定するものではなく、提供された選択肢から選ぶ以上にダウンロードごとに選べるものでもありません。現在サポートされている領収書の言語：English、Português、Español、繁體中文、简体中文、Tiếng Việt、ไทย、Bahasa Indonesia、日本語、한국어、Bahasa Melayu、Polski、Türkçe。

## 顧客は 3 点購入したのに、領収書の数量が 1 になっています。なぜですか？

領収書が実際の数量を表示するのは、注文が 1 より大きい数量を明示的に持っている場合のみだからです。注文が数量を持たない、パースできない値を持つ、または 1 以下を持つ場合、領収書には **1** が表示されます。

領収書で数量が重要な場合は、注文に数量を送ってください。後から設定する方法はなく、そのための設定項目もありません。

## ある領収書がどのテンプレートで生成されたか分かりますか？

はい。注文とサブスクリプションの決済情報が、適用された設定を `receiptTemplateId` として報告し、設定ページでは各タブにテンプレート ID が表示されます。領収書が想定どおりに見えない場合に引用すべきなのがこの組み合わせです。取引が想定したテンプレートを使ったのか、デフォルトにフォールバックしたのかが分かります。

## 保存する前に領収書をプレビューできますか？

はい。設定ページはフォームの横にライブの A4 プレビューを描画します。固定のサンプル取引データで動作し、プロダクトの種類（ワンタイム / サブスクリプション）、手数料の行の有無、カードかそれ以外の決済手段かを切り替えられます。プレビューはサンプルデータのみであり、設定が有効になったことを意味せず、メールを送ることもありません。

***

すべての取引ではなく特定の 1 件の取引で領収書の内容が誤っていますか？注文 ID と設定タブに表示されているテンプレート ID を添えて[サポートにお問い合わせください](mailto:support@waffo.com)。


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