# 納税登録

連結アカウントが Stripe Tax における納税登録を管理できるようにする方法をご紹介します。

納税登録コンポーネントは、連結アカウントが税務コンプライアンスを管理できるようにします。連結アカウントは、納税登録をプラットフォームで直接管理することで、このコンポーネントと相互作用します。このコンポーネントは[ソフトウェアプラットフォーム](https://docs.stripe.com/tax/tax-for-platforms.md) に適しているため、連結アカウントが税金を徴収する義務を負います。

Stripe Taxを組み込むプラットフォームの場合、該当する管轄区域の連結アカウントの[税務当局への登録](https://docs.stripe.com/tax/registering.md)に関する情報を収集する必要があります。連結アカウントは、税務登録をプラットフォームに追加する前に、税務当局に登録する必要があります。プラットフォームの税金を正確に計算して徴収するには、連結アカウントの納税登録情報を収集する必要があります。

Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production.

納税登録コンポーネントは、[納税登録 API](https://docs.stripe.com/tax/registrations-api.md) を使用して、税務登録の一覧を連結アカウントに表示します。連結アカウントは、特定の場所で支払いにかかる税金を計算するうえで、納税登録コンポーネントで納税登録を追加する必要があります。連結アカウントが特定の地域における税計算の取りやめを希望する場合は、コンポーネントで納税登録を終了できます。

## 要件

- 組み込みは、[Connect での Tax](https://docs.stripe.com/tax/connect.md) の[ソフトウェアプラットフォームのガイド](https://docs.stripe.com/tax/tax-for-platforms.md)に従う必要があります。これは、連結アカウントには税金を徴収する義務があるためです。
- まだの場合は、[税金設定コンポーネント](https://docs.stripe.com/connect/supported-embedded-components/tax-settings.md)をレンダリングします。連結アカウントが税務コンプライアンスについて管理できるようにするには、税金設定コンポーネントと納税登録コンポーネントの両方が必要です。

## 納税登録コンポーネントを組み込む

[アカウントセッションを作成する](https://docs.stripe.com/api/account_sessions/create.md)ときに、`components` パラメーターに `tax_registrations` を指定して税務登録を有効にします。

```curl
curl https://api.stripe.com/v1/account_sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "account={{CONNECTEDACCOUNT_ID}}" \
  -d "components[tax_registrations][enabled]=true"
```

アカウントセッションを作成し、[ConnectJS を初期化](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions)すると、フロントエンドに税務登録コンポーネントを表示できます。

#### React

```jsx
// Include this React component
import {
  ConnectTaxRegistrations,
  ConnectComponentsProvider,
} from "@stripe/react-connect-js";

return (
  <ConnectComponentsProvider connectInstance={stripeConnectInstance}>
    <div>
      <h2>Tax Registrations</h2>
      <ConnectTaxRegistrations
        // Optional
        // displayCountries={["US", "CA", "DE"]}
        // onAfterTaxRegistrationAdded={({id: registrationId}) => console.log({registrationId})}
        // onAfterTaxRegistrationExpired={({id: registrationId}) => console.log({registrationId})}
       />
    </div>
  </ConnectComponentsProvider>
);
```

#### HTML + JS

| 方式                                 | タイプ                      | 説明                                                                                                                                                                                           | デフォルト                |
| ---------------------------------- | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- |
| `setDisplayCountries`              | `string[]`               | 連結アカウントが[新しい税務登録のために指定](https://docs.stripe.com/api/tax/registrations/object.md#tax_registration_object-country_options)する [2 文字の国コード](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)の配列。 | 未定義 (すべての国が許可されます)   |
| `setOnAfterTaxRegistrationAdded`   | `({id: string}) => void` | 新しく追加された税務登録 ID を含むオブジェクトで実行されるコールバック                                                                                                                                                        | 未定義 (必須のメソッドではありません) |
| `setOnAfterTaxRegistrationExpired` | `({id: string}) => void` | ユーザーが終了した税務登録 ID を含むオブジェクトで実行されるコールバック                                                                                                                                                       | 未定義 (必須のメソッドではありません) |

#### React

| React プロパティ                     | タイプ                      | 説明                                                                                                                                                                                           | デフォルト                | 必須または任意 |
| ------------------------------- | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | ------- |
| `displayCountries`              | `string[]`               | 連結アカウントが[新しい税務登録のために指定](https://docs.stripe.com/api/tax/registrations/object.md#tax_registration_object-country_options)する [2 文字の国コード](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)の配列。 | 未定義 (すべての国が許可されます)   | 任意      |
| `onAfterTaxRegistrationAdded`   | `({id: string}) => void` | 新しく追加された税務登録 ID で実行されるコールバック                                                                                                                                                                 | 未定義 (必須のメソッドではありません) | 任意      |
| `onAfterTaxRegistrationExpired` | `({id: string}) => void` | ユーザーが終了した税務登録 ID を含むオブジェクトで実行されるコールバック                                                                                                                                                       | 未定義 (必須のメソッドではありません) | 任意      |

## 制限事項

次の機能はダッシュボードと API で使用できますが、現在、税務登録コンポーネントではサポートされていません。

- 登録の開始日または終了日をスケジュール設定します。登録は、直ちに作成または終了することしかできません。
- 税務登録の作成時にアメリカの州売上税の選択を指定します。

## See also

- [Connect での Tax](https://docs.stripe.com/tax/connect.md)
- [ソフトウェアプラットフォームのための TAX](https://docs.stripe.com/tax/tax-for-platforms.md)
- [税金設定コンポーネント](https://docs.stripe.com/connect/supported-embedded-components/tax-settings.md)