# 請求書をカスタマイズする

請求書の内容とブランディングをカスタマイズする方法をご紹介します。

*請求書* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice)のコンテンツは、次の方法でカスタマイズできます。

- API を使用
- 請求書エディターを使用
- サブスクリプションエディターを使用
- [請求書テンプレート](https://docs.stripe.com/invoicing/invoice-rendering-template.md)を使用
- アカウントの[請求書の設定](https://dashboard.stripe.com/settings/billing/invoice)から

顧客の優先言語を設定し、[アカウントの詳細](https://dashboard.stripe.com/settings/account/?support_details=true)に公開情報を含めることもできます。Stripe よりも顧客とビジネスについてよく知っているため、請求書には必要な情報がすべて記載されていることを確認してください。請求書は正確で、適切なTaxを支払い、お客様の地域に適用されるすべての法律および規制に準拠する必要があります。

> #### Accounts v2 API を使用した顧客の表現
> 
> Accounts v2 API では、Connect ユーザーには一般提供され、その他の Stripe ユーザーには公開プレビューで提供されます。Accounts v2 プレビューの一部である場合は、コードで[プレビューバージョン](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning)を指定する必要があります。
> 
> Accounts v2 プレビューへのアクセスをリクエストするには、
> 
> For most use cases, we recommend [modeling your customers as customer-configured Account objects](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md) instead of using [Customer](https://docs.stripe.com/api/customers.md) objects.

## ブランディング

Stripe では、[ブランディング設定](https://dashboard.stripe.com/account/branding)でメール領収書、オンライン請求書、請求書の PDF などをカスタマイズ (およびプレビュー) することができます。

アイコンやロゴは、形式が JPG または PNG、サイズが 512kb 未満、ピクセルが 128px x 128px 以上である必要があります。

- **アイコン**: デジタルで使用しやすい、四角のアイコンまたはロゴ。
- **ロゴ**: アイコンの一部を上書きする、四角以外のロゴ。
- **ブランドカラー**: 領収書、請求書、カスタマーポータルで使用されます。
- **アクセント**: メールやページの背景に使用されます。

### ブランド設定を適用する

ブランド設定はアカウント全体に適用され、さまざまな場所で有効になります。

| 設定          | メール       | Checkout と Payment Links | カスタマーポータル | オンライン請求書ページ | 請求書 PDF |
| ----------- | --------- | ------------------------ | --------- | ----------- | ------- |
| **アイコン**    | はい        | はい                       | はい        | はい          | はい      |
| **ロゴ**      | いいえ       | はい                       | いいえ       | いいえ         | はい      |
| **ブランドカラー** | はい        | いいえ                      | はい        | はい          | はい      |
| **アクセント**   | はい (背景の色) | はい                       | はい        | はい          | いいえ     |

## 請求書のナンバリング

Stripe は、自動的に請求書番号を生成して、請求書の追跡と消し込みに利用します。請求書番号には、`586A2E-0139` や `MYSHOP-1203` のように、プレフィックスとサフィックスがあります (いずれのスキームでも、請求書番号は全アカウントで常に一意になります)。Stripe は 2 とおりの請求書の番号付けスキームをサポートしています。

- **顧客ごとに連番 (顧客レベル)**: 顧客ごとに一意のプレフィックスを使用して、その顧客の請求書に連続した番号を割り当てます。
- **アカウント全体で連番 (アカウントレベル)**: すべての顧客に同じプレフィックスを使用して、そのアカウントのすべての請求書の番号を順番に割り当てます。

Stripe は、ユーザーの Stripe アカウントが所在する国に基づいてデフォルトの動作を選択します。[欧州連合](https://ec.europa.eu/taxation_customs/business/vat/eu-vat-rules-topic/vat-invoicing-rules_en)加盟国および[イギリス](https://www.gov.uk/invoicing-and-taking-payment-from-customers/invoices-what-they-must-include)では通常、アカウントレベルで連続番号を割り当てる必要があります。他の国はすべて、請求書の合計数が公開されてないため、デフォルトでは顧客レベルで連続番号が割り当てられます。スキームを切り替えたり、プレフィックスを更新したりする場合、新しい設定はそれ以降の請求書のみに使用されます。既存の請求書には適用されません。

> 請求書要件は管轄区域によって異なります。個別のユースケースについては、専門家にご相談ください。発行する請求書が地域の税務要件を満たしているかを確認することはお客様の責任になります。

### 顧客レベルのプレフィックス

請求書に顧客レベルの番号付けを使用するように設定すると、各請求書番号の先頭に顧客に一意の請求書プレフィックスが設定されます。

たとえば、ある顧客のビジネス名が Typographic の場合、プレフィックスを`TYPGRA` などに設定できます。この場合、Typographic の最初の請求書は、`TYPGRA-0001`、2 番目の請求書は `TYPGRA-0002` のようになります。

プレフィックスは 3 ～ 12 文字で、現在使用されていないものを含め、他の顧客プレフィックスと重複することはできません。

プレフィックスは、ダッシュボードの [Customers ページ](https://dashboard.stripe.com/customers)または API を使用して設定できます。顧客を顧客設定の `Account` オブジェクトとしてモデル化する場合は、[configuration.customer.billing.invoice.prefix](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer-billing-invoice-prefix) パラメータを使用します。顧客を `Customer` オブジェクトとしてモデル化する場合は、[invoice_prefix](https://docs.stripe.com/api/customers/create.md#create_customer-invoice_prefix) パラメータを使用します。

### アカウントレベルのプレフィックス

請求書にアカウントレベルの番号付けを使用するように設定すると、各請求書番号は共通のプレフィックスで始まり、そこに続けて連続番号が設定されます。

たとえば、お客様のビジネス名が Rocket Rides の場合、プレフィックスを `RKTRIDE` などに設定できます。この場合、最初の請求書は、`RKTRIDE-0001`、別の顧客への 2 番目の請求書は `RKTRIDE-0002`、そして最初の顧客への別の請求書は `RKTRIDE-0003` のようになります。

Stripe はアカウント全体のプレフィックスを自動的に割り当てますが、請求書がお客様からのものであることを分かりやすくするために上書きできます。アカウントのプレフィックスは、[請求書の設定](https://dashboard.stripe.com/settings/billing/invoice)で変更できます。この際、アカウントのデフォルト API バージョンは最低でも [2020-03-02](https://docs.stripe.com/upgrades.md#2020-03-02).である必要があります。プレフィックスは 3 ～ 12 文字で、他の顧客のプレフィックス (未使用となったプレフィックスを含む) と同じものを使用することはできません。

### 連結アカウントのプレフィックス

`on_behalf_of` パラメーターを使用して請求書を作成する場合、Stripe は連結アカウントをマーチャントオブレコードとして使用します。各登録マーチャントは、独自の個別の請求書番号シーケンスを維持します。つまり、

- 各連結アカウントには、`0001` で始まる独自の請求書番号付けシーケンスがあります。
- 異なる連結アカウント (`on_behalf_of` を使用して指定) での同じ顧客の請求書には、同じ請求書番号のプレフィックスとサフィックスを付けることができます。
- マーチャントオブレコードは、プラットフォームアカウントではなく、どの請求書シーケンスを使用するかを決定します。

### 開始請求書番号の設定

デフォルトでは、請求書番号は `0001` から開始されますが、請求書に別の開始番号を使用する必要がある場合は変更することができます。たとえば、あるユーザーが既存の顧客を Stripe Invoicing に移行する場合に、従前のシステムにある番号の次の番号から請求書番号を継続したいとします。以前のシステムで最後の請求書番号が `123` だった場合は、Stripe では請求書番号 `124` で再開できます。

顧客レベルのプレフィックスを使用する場合は、ダッシュボードの **Customer details** ページまたは API を使用して開始番号を設定できます。顧客を顧客設定の `Account` オブジェクトとしてモデル化する場合は、[configuration.customer.billing.invoice.next_sequence](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer-billing-invoice-next_sequence) パラメータを使用します。顧客を `Customer` オブジェクトとしてモデル化する場合は、[next_invoice_sequence](https://docs.stripe.com/api/customers/create.md#create_customer-next_invoice_sequence) パラメータを使用します。

アカウントレベルのプレフィックスを使用する場合は、ダッシュボードの [Invoice settings](https://dashboard.stripe.com/settings/billing/invoice) ページにある **Next invoice sequence** フィールドで開始番号を設定できます。

次の請求書番号を設定する際には、請求書にそれまでに使用されている番号よりも大きな番号を使用する必要があります。どの設定方法を使用しても、使用できる最大の請求書番号は 1,000,000,000 です。この上限に達しないようにするため、できる限り小さい番号を使用してください。

## 請求書のフィールド

メモ、フッター、カスタムフィールドなど、さまざまな請求書フィールドの詳細を確認します。[請求書テンプレート](https://docs.stripe.com/invoicing/invoice-rendering-template.md)を使用して、顧客のグループに対してこれらのフィールドに同じ値を設定できます。

### デフォルトのメモ

メモは、請求書 PDF、請求書メール、[オンライン請求書ページ](https://docs.stripe.com/invoicing/hosted-invoice-page.md)に含まれます。メモは一般的にメモセクションとして使用され、請求先の顧客に感謝の意を示したり、請求書に関する詳細情報 (顧客に接客した営業担当者からのメモなど) を追加することができます。

アカウントのデフォルトのメモフィールドは、[請求書の設定](https://dashboard.stripe.com/settings/billing/invoice)で設定できます。新しい請求書はすべてこの値を使用します。[請求書テンプレート](https://docs.stripe.com/invoicing/invoice-rendering-template.md)でメモを指定することもできます。これは、テンプレートを使用して請求書でデフォルトのメモを置き換えます。

ダッシュボードで請求書を作成または更新するときに、特定の請求書に別のメモを指定できます。[請求書の更新](https://docs.stripe.com/api/invoices/update.md#update_invoice-description)を呼び出して、`description` パラメーターを含めることで、 API を使用してメモを指定することもできます。

### デフォルトのフッター

請求書の PDF には、フッターにオプションのテキストブロックを含めることができます。このフッターフィールドは多くの場合、契約上または法律上必要なテキストの表示に使用されます。一般的なユースケースは、イギリスの Companies House 登記番号など、法的に必要とされる会社登録情報を表示するものです。

メモフィールド同様に、[請求書の設定](https://dashboard.stripe.com/settings/billing/invoice)でデフォルトのフッター値を設定することができ、[請求書テンプレート](https://docs.stripe.com/invoicing/invoice-rendering-template.md)でフッターを指定することができます。[請求書の更新](https://docs.stripe.com/api/invoices/update.md#update_invoice-footer)を呼び出すことで API を使用して、またはダッシュボードで請求書の下書きを作成または更新するときに、特定の請求書の下書きに別のフッターを指定できます。請求書が[確定](https://docs.stripe.com/invoicing/integration/workflow-transitions.md#finalized)されると、そのフッターフィールドを更新することはできなくなります。

### デフォルトのアイテムの価格

内税が含まれないラインアイテムの価格で請求書を発行できます。税抜き価格は請求書の PDF にのみ表示されます。そのため、内税を使用する場合、オンライン請求書ページと請求書メールには税込み価格が表示されます。ダッシュボードまたは API で正味価格の設定を定義できます。

- **内税を含む**: 請求書の PDF には、内税を含むラインアイテムの価格が表示されます (これがデフォルトです)。
- **税抜き**: 請求書の PDF には、税抜きのラインアイテムの価格が表示されます。

> #### 注文の優先順位
> 
> ラインアイテムの価格のデフォルトを顧客レベルで設定する場合は、アカウントレベルの設定よりも優先されます。

### カスタムフィールド

カスタムフィールドを追加すると、請求書の PDF ドキュメントが具体化され、ビジネス慣行や税務報告義務をより遵守しやすくなります。カスタムフィールドには、請求書のヘッダーに表示するキーと値のペアを最大 4 つまで指定できます。[請求書エディター](https://dashboard.stripe.com/invoices/create)、[Invoices API](https://docs.stripe.com/api/invoices/create.md#create_invoice-custom_fields)、または[請求書テンプレート](https://docs.stripe.com/invoicing/invoice-rendering-template.md)で、最大 4 つまでカスタムフィールドのキーと値のペアを設定できます。

以下は、一般的なカスタムフィールドの使用方法です。

- 注文 (PO) 番号
- 請負業者番号
- 税金コンプライアンス

#### カスタムフィールドの継承

顧客を表すために使用するオブジェクトには、カスタムの請求書フィールドを設定できます。顧客レベルで設定するカスタムフィールドは、当該顧客向けに作成する請求書の下書きすべてに適用されます。これらのカスタムフィールドは、請求書が下書きの状態であればいつでも変更できます。請求書が確定されると、カスタムフィールドの変更はできなくなります。

## 納税番号

請求書 PDF とメール領収書に表示する納税者番号を追加します。1 つ以上の納税者番号をデフォルトとして設定して、すべての請求書に自動的に含めることも、個別の請求書を作成するときに異なる納税者番号を選択することもできます。

納税者番号を管理するには、**設定** > **Billing** > [請求書](https://dashboard.stripe.com/settings/billing/invoices/general) に移動し、請求書の税務情報セクションまでスクロールします。

納税者番号を追加した後は、その番号や種類を変更できません。納税者番号を更新するには、納税者番号を削除してから新しい番号を追加してください。

## PDF ページサイズ

確定済みの請求書を含む請求書 PDF のページサイズを、A4 (8.27 x 11.69 インチ) またはレター (8.5 x 11 インチ) に設定できます。

#### ダッシュボード

ダッシュボードを使用してページサイズを設定するには、[請求書エディター](https://dashboard.stripe.com/invoices/create)に移動し、**詳細設定**セクションを見つけます。その後、**PDF ページサイズ**サブセクションで **A4** または**レター**を選択します。

#### API

API を使用してページサイズを設定するには、請求書を[作成](https://docs.stripe.com/api/invoices/create.md#create_invoice-rendering-pdf)または[更新](https://docs.stripe.com/api/invoices/update.md#update_invoice-rendering-pdf)し、`rendering["pdf"]["page_size"]` パラメーターに希望するページサイズを設定します。

デフォルトの PDF ページサイズは、日本語ロケールを使用するお客様の場合は A4、その他のロケールを使用するお客様の場合はレターです。`rendering["pdf"]["page_size"]` パラメーターを `auto` に戻すと、このデフォルトの動作を有効にできます。

これは PDF ページサイズに A4 を指定して請求書を作成する例です。

#### Accounts v2

```curl
curl https://api.stripe.com/v1/invoices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "customer_account={{CUSTOMERACCOUNT_ID}}" \
  -d "rendering[pdf][page_size]=a4"
```

#### Customers v1

```curl
curl https://api.stripe.com/v1/invoices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "customer={{CUSTOMER_ID}}" \
  -d "rendering[pdf][page_size]=a4"
```

## ラインアイテムをグループ化する

請求書 (PDF、オンライン請求書ページ、請求書メールなど) を顧客に理解しやすくするには、請求書のラインアイテムを分類してグループごとに表示します。また、ラインアイテムのグループを非表示にすることもできます。細かすぎるラインアイテムは、グループレベルの小計のみが顧客に表示されるように構成できます。

## デフォルトの支払い条件

[請求書設定](https://dashboard.stripe.com/settings/billing/invoice)の **デフォルトの決済条件** で、請求書を送信してから決済期日とするかを選択できます。また、請求書のメールに決済ページへのリンクを含めるかどうかも選択できます。顧客はこのリンクを使用して、請求書の決済、ダウンロード、ステータスの確認を行うことができます。さらには、受け付ける決済手段もこのセクションで管理できます。

## 顧客が希望する言語

顧客を作成するときは、**Language** ドロップダウンを使用して優先言語を追加できます。(優先言語は、ダッシュボードで請求の詳細を編集するときや、請求書の作成時に追加または編集することもできます。) Stripe はこの優先言語を使用して、請求書メールと PDF、領収書メールと PDF、クレジットノート PDF をローカライズします。

API を使用して顧客の優先言語を更新するには、顧客設定の `Account` オブジェクトには [defaults.locales](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-defaults-locales)、`Customer` オブジェクトには [preferred_locales](https://docs.stripe.com/api/customers/object.md#customer_object-preferred_locales) を設定します。どちらのプロパティも配列で、優先順に複数のロケールを追加できます。

Stripe Invoicing は、以下の言語に対応しています。

- ブルガリア語
- 中国語 (香港)
- 簡体字中国語
- 中国語 (台湾)
- クロアチア語
- チェコ語
- デンマーク語
- オランダ語
- 英語 (イギリス)
- 英語 (アメリカ)
- エストニア語
- フィリピノ語
- フィンランド語
- フランス語 (カナダ)
- フランス語 (フランス)
- ドイツ語
- ギリシャ語
- ハンガリー語
- インドネシア語
- イタリア語
- 日本語
- 韓国語
- ラトビア語
- リトアニア語
- マレー語 (マレーシア)
- マラヤーラム語
- マルタ語
- ノルウェー語
- ポーランド語
- ポルトガル語 (ブラジル)
- ポルトガル語 (ポルトガル)
- ルーマニア語
- ロシア語
- スロバキア語
- スロベニア語
- スペイン語 (中南米)
- スペイン語 (スペイン)
- スウェーデン語
- タイ語
- トルコ語
- ベトナム語

## 請求先住所と配送先住所

### 請求先住所

Stripe は、請求書 PDF の請求先住所として、顧客設定の `Account` オブジェクトでは [identity.individual.address](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-identity-individual-address)、`Customer` オブジェクトでは [address](https://docs.stripe.com/api/customers/object.md#customer_object-address) を使用します。その住所を明示的に設定しない場合、Stripe は PDF の請求先住所として配送先住所を表示します。

ダッシュボードの **Customer details** ページで、顧客の請求先住所を追加または編集することもできます。

### 配送先住所

請求書 PDF に配送先の詳細を表示するには、[shipping_details](https://docs.stripe.com/api/invoices/create.md#create_invoice-shipping_details) プロパティを設定します。請求書の `shipping_details` プロパティを設定しない場合、Stripe は顧客が設定した [Account](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-configuration-customer-shipping) オブジェクトまたは [Customer](https://docs.stripe.com/api/customers/object.md#customer_object-shipping) オブジェクトの配送先住所を使用して、PDF に配送先住所を表示します。

## 公開サポート情報

請求書には、サポートのメールアドレスやビジネスのウェブサイトなど、[公開ビジネス情報](https://dashboard.stripe.com/settings/public)で指定された公開情報が含まれます。これらの設定を使用すると、請求書の PDF やメールなどの顧客向けドキュメントにサポートの電話番号を含めるか、デフォルトでビジネスの住所を含めるかを選択することもできます。

## See also

- [ダッシュボードを使用する](https://docs.stripe.com/invoicing/dashboard.md)
- [オンライン請求書ページ](https://docs.stripe.com/invoicing/hosted-invoice-page.md)
- [顧客にメールを送信する](https://docs.stripe.com/invoicing/send-email.md)