# Registrations API を使用して、納税登録を管理する

有効な納税登録を追加、スケジュール設定、確認する方法をご紹介します。

ビジネスは、納税義務のある地域で税金徴収の登録を行う必要があります。[Tax Registration API](https://docs.stripe.com/api/tax/registrations.md) を使用すると、ダッシュボードを使用せずに、API を使用して納税登録を取得して設定することができます。Stripe に納税登録を追加することで、Stripe での取引に対する税金の計算と徴収が有効になります。

ビジネスが税金を徴収するために登録する必要があるタイミングと方法に関する規則は、地域によって異なります。[Stripe を使用して登録](https://docs.stripe.com/tax/use-stripe-to-register.md)することもできます。[地域ごとの税金徴収について、詳細をご覧ください](https://docs.stripe.com/tax/supported-countries.md)。

- **Connect プラットフォーム**: プラットフォームでは、この API を使用して、連結アカウントの登録を管理したり、アカウントの有効な登録を確認できます。
- **直接の使用**: この API を使用して、ご自身の登録を管理したり確認できます。

# Connect プラットフォーム

> This is a Connect プラットフォーム for when tax-integration is connect-platform. View the full page at https://docs.stripe.com/tax/registrations-api?tax-integration=connect-platform.

## 連結アカウントのすべての税務登録をリストする

連結アカウントの税務登録のリストを取得するには、[list registrations (登録のリスト)](https://docs.stripe.com/api/tax/registrations/all.md) コールを実行します。`status` パラメーターを `active`、`expired`、または `scheduled` に設定することで、レスポンスを絞り込むことができます。

```curl
curl -G https://api.stripe.com/v1/tax/registrations \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d status=active \
  -d limit=3
```

連結アカウントが Stripe ダッシュボードにアクセスできない場合は、税務登録を管理するための UI をプラットフォームが提供できます。登録エンドポイントはその機能の実装をサポートします。

## 連結アカウントの税務登録を追加する

連結アカウントの税務登録ステータスがわかっている場合は、 [create Registration](https://docs.stripe.com/api/tax/registrations/create.md) を呼び出し、連結アカウント ID を `Stripe-Account` ヘッダーとして指定することで、Stripe に登録を追加できます。

```curl
curl https://api.stripe.com/v1/tax/registrations \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d country=IE \
  -d "country_options[ie][type]=oss_union" \
  -d active_from=now
```

この状況では連結アカウントに `tax.registration` オブジェクトが作成されます。

```json
{
  "object": "tax.registration",
  "active_from": 1669249440,
  "country": "IE",
  "country_options": {
    "ie": {
      "type": "oss_union"
    }
  },
  "livemode": false,
  "status": "active",
  ...
}
```

また、連結アカウントが Stripe ダッシュボードにアクセスできる場合は (Standard アカウントなど)、[Stripe Tax を設定する](https://docs.stripe.com/tax/set-up.md)ように指示することもできます。この設定には納税登録の追加も含まれます。

### 本社の住所の要件

税務登録を追加するには、連結アカウントはまず本社の住所を設定する必要があります。本社の住所が定義されていない場合、`invalid_request_error` がトリガーされ、本社の住所の設定に関するメッセージが示されます。

[tax settings API](https://docs.stripe.com/tax/settings-api.md) を使用して、プラットフォームとして本社の住所を追加します:

```curl
curl https://api.stripe.com/v1/tax/settings \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d "head_office[address][country]=DE"
```

場所に固有の検証とエラーが発生することがあります。詳細については、Stripe の[税金設定ガイド](https://docs.stripe.com/tax/settings-api.md?tax-integration=connect-platform#validations-and-errors)でご確認いただけます。

## 連結アカウントの税務登録の更新・有効期限切れを設定する

Stripe Tax で連結アカウントの税務登録を削除することはできません。連結アカウントが地方税務当局への登録を解除し、その場所で税金の徴収を停止する必要がある場合は、登録を期限切れにします。連結アカウントの税務登録を期限切れにするには、 [update Registration](https://docs.stripe.com/api/tax/registrations/update.md#tax_registration_update-expires_at) を呼び出し、連結アカウント ID を `Stripe-Account` ヘッダーとして指定して、 `expires_at` タイムスタンプを設定します。

```curl
curl https://api.stripe.com/v1/tax/registrations/taxreg_NkyGPRPytKq66j \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d expires_at=now
```

この状況では、登録が即座に期限切れになります。`expires_at` 以降に連結アカウントのために実行される[税金計算](https://docs.stripe.com/api/tax/calculations.md)では、この登録は使用されません。

```json
{
  "object": "tax.registration",
  "active_from": 1669248000,
  "created": 1669219200,"expires_at": 1669334400,
  "livemode": false,
  "status": "active",
  ...
}
```

## Optional: 小売配送手数料の税務登録を追加する [サーバー側]

連結アカウントの小売配送手数料を計算するには、アメリカのコロラド州またはミネソタ州で、登録タイプが `state_retail_delivery_fee` の税務登録を追加する必要があります。この登録を連結アカウントに追加する必要があります。

```curl
curl https://api.stripe.com/v1/tax/registrations \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d country=US \
  -d "country_options[us][state]=CO" \
  -d "country_options[us][type]=state_retail_delivery_fee" \
  -d active_from=now
```

税務登録を追加した後、販売された商品がさまざまな州の要件を満たしている場合は、小売配送手数料が税金計算に適用されます。この手数料は、ミネソタ州では、たとえば 100 USD を超える注文に適用されます。

ドキュメントを参照して、小売配送手数料が適用されるかどうかを確認してください。

- [小売配送手数料 — コロラド州](https://docs.stripe.com/tax/supported-countries/united-states/collect-tax.md?tax-jurisdiction-united-states=colorado#other-taxes)
- [小売配送手数料 — ミネソタ州](https://docs.stripe.com/tax/supported-countries/united-states/collect-tax.md?tax-jurisdiction-united-states=minnesota#other-taxes)

## See also

- [Settings API を使用して Stripe Tax を設定する](https://docs.stripe.com/tax/settings-api.md)
- [Connect で Stripe Tax を使用する](https://docs.stripe.com/tax/connect.md)


# 直接の使用

> This is a 直接の使用 for when tax-integration is direct. View the full page at https://docs.stripe.com/tax/registrations-api?tax-integration=direct.

## 納税登録を追加する

課税対象地域の税務当局に登録したら、 [create Registration](https://docs.stripe.com/api/tax/registrations/create.md) を呼び出して、その登録を Stripe Tax に追加します。

```curl
curl https://api.stripe.com/v1/tax/registrations \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d country=IE \
  -d "country_options[ie][type]=oss_union" \
  -d active_from=now
```

この状況では、Stripe は `tax.registration` オブジェクトを作成します。

```json
{
  "object": "tax.registration",
  "active_from": 1669249440,
  "country": "IE",
  "country_options": {
    "ie": {
      "type": "oss_union"
    }
  },
  "livemode": false,
  "status": "active",
  ...
}
```

### 本社の住所の要件

税務登録を追加するには、まず本社の住所を設定する必要があります。本社の住所が定義されていない場合、`invalid_request_error` がトリガーされ、本社の住所の設定に関するメッセージが示されます。

[tax settings API](https://docs.stripe.com/tax/settings-api.md) を使用して、本社の住所を追加します:

```curl
curl https://api.stripe.com/v1/tax/settings \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "head_office[address][country]=DE"
```

場所に固有の検証とエラーが発生することがあります。詳細については、Stripe の[税金設定ガイド](https://docs.stripe.com/tax/settings-api.md?tax-integration=direct#validations-and-errors)でご確認いただけます。

## 納税登録の更新と期限切れの設定

Stripe Tax の税務登録は削除できません。地方税務当局への登録を解除し、その場所で税金の徴収を停止する必要がある場合は、登録を期限切れにします。税務登録を期限切れにするには、 [update Registration](https://docs.stripe.com/api/tax/registrations/update.md#tax_registration_update-expires_at) を呼び出して `expires_at` タイムスタンプを設定します。

```curl
curl https://api.stripe.com/v1/tax/registrations/taxreg_NkyGPRPytKq66j \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d expires_at=now
```

この状況では、登録が即座に期限切れになります。`expires_at` 以降に実行される[税金計算](https://docs.stripe.com/api/tax/calculations.md)では、この登録は使用されません。

```json
{
  "object": "tax.registration",
  "active_from": 1669248000,
  "created": 1669219200,"expires_at": 1669334400,
  "livemode": false,
  "status": "active",
  ...
}
```

## すべての納税登録を一覧表示する

[list registrations (登録のリスト)](https://docs.stripe.com/api/tax/registrations.md) コールを実行すると、納税登録をすべて表示することができます。`status` パラメーターを使用すると、`active`、`expired`、または `scheduled` の納税登録のみに絞り込むことができます。

```curl
curl -G https://api.stripe.com/v1/tax/registrations \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d status=active \
  -d limit=3
```

## Optional: 小売配送手数料の税務登録を追加する [サーバー側]

小売配送手数料を計算するには、アメリカのコロラド州またはミネソタ州で、登録タイプが `state_retail_delivery_fee` の税務登録を追加する必要があります。

```curl
curl https://api.stripe.com/v1/tax/registrations \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d country=US \
  -d "country_options[us][state]=CO" \
  -d "country_options[us][type]=state_retail_delivery_fee" \
  -d active_from=now
```

税務登録を追加した後、販売された商品がさまざまな州の要件を満たしている場合は、小売配送手数料が税金計算に適用されます。この手数料は、ミネソタ州では、たとえば 100 USD を超える注文に適用されます。

ドキュメントを参照して、小売配送手数料が適用されるかどうかを確認してください。

- [小売配送手数料 — コロラド州](https://docs.stripe.com/tax/supported-countries/united-states/collect-tax.md?tax-jurisdiction-united-states=colorado#other-taxes)
- [小売配送手数料 — ミネソタ州](https://docs.stripe.com/tax/supported-countries/united-states/collect-tax.md?tax-jurisdiction-united-states=minnesota#other-taxes)

## See also

- [Settings API を使用して Stripe Tax を設定する](https://docs.stripe.com/tax/settings-api.md)
- [Stripe を使用して登録](https://docs.stripe.com/tax/use-stripe-to-register.md)