# Settings API を使用して Stripe Tax を設定する 税金設定を行い、アカウントで税金を計算する準備が整っているかを確認する方法をご紹介します。 [Stripe Tax Settings API](https://docs.stripe.com/api/tax/settings.md) では、[Stripe ダッシュボード](https://docs.stripe.com/tax/set-up.md)を使用せずに、税金の計算に必要な設定を取得して構成できます。 - **Connect プラットフォーム**: プラットフォームでは、この API を使用して、連結アカウントが Stripe Tax を使用するように設定したり、アカウントが適切に設定されているかどうかを確認できます。 - **直接の使用**: この API を使用して Stripe Tax を設定したり、適切に設定されているかどうかを確認することができます。 # Connect プラットフォーム > This is a Connect プラットフォーム for when tax-integration is connect-platform. View the full page at https://docs.stripe.com/tax/settings-api?tax-integration=connect-platform. ## 連結アカウントで Stripe Tax を使用する準備が整っているかを確認します Standard アカウントが Stripe ダッシュボードから Stripe Tax を設定した際、 Stripe Tax を有効化できるかプラットフォームによる評価が必要な場合、この確認を完了してください。 Stripe の公式ライブラリを使用して、アプリケーションから Stripe API にアクセスします。連結アカウントの Stripe Tax の設定を確認するには、連結アカウントの ID の値を指定した `Stripe-Account` ヘッダーを使用して、[`tax.settings` オブジェクトを取得](https://docs.stripe.com/api/tax/settings/retrieve.md)します。 ```curl curl https://api.stripe.com/v1/tax/settings \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" ``` アカウントが税金設定を更新するか、新しい必須の税金設定が導入されたときにトリガーされる [tax.settings.updated](https://docs.stripe.com/api/events/types.md#event_types-tax.settings.updated) Webhook イベントをリッスンすることもできます。[Webhook を本番環境に移行する](https://docs.stripe.com/webhooks.md#register-webhook)で Webhook エンドポイントの追加方法を確認し、ダッシュボードで**連結アカウントでイベントをリッスンする**を必ず選択してください。 API または Webhook イベントが取得したレスポンスの `tax.settings` オブジェクトで `status` として `"active"` が返された場合は、アカウントで Stripe Tax を使用する準備ができています。`defaults.tax_code` と `defaults.tax_behavior` の設定は、各 API コールの商品または価格で指定されていない場合にのみ必要です。 ```json { "object": "tax.settings", "defaults": { "tax_code": null, "tax_behavior": null }, "head_office": { "address": { "country": "DE" } }, "livemode": false,"status": "active", "status_details": { "active": {} } } ``` レスポンスの `tax.settings` オブジェクトの `status` で `"pending"` が返される場合、アカウントは Stripe Tax を使用する準備ができていません。[status_details[pending][missing_fields]](https://docs.stripe.com/api/tax/settings/object.md#tax_settings_object-status_details-pending-missing_fields) には、未入力の必須フィールドがすべて一覧化されています。 ```json { "object": "tax.settings", "defaults": { "tax_code": null, "tax_behavior": null }, "head_office": null, "livemode": false,"status": "pending", "status_details": { "pending": { "missing_fields": ["head_office"] } } } ``` ## 連結アカウントの設定を構成する Stripe Tax の設定がすべてプラットフォームのインターフェイスで管理されている場合、このステップを完了してください。 [設定の更新](https://docs.stripe.com/api/tax/settings/update.md)の呼び出しを通じて連結アカウントの設定を変更できます。連結アカウントの ID の値を指定した `Stripe-Account` ヘッダーを使用することで、本社所在地、事前設定の税コード、税金処理を指定して呼び出しを実行できます。 ```curl curl https://api.stripe.com/v1/tax/settings \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "defaults[tax_code]"=txcd_10000000 \ -d "defaults[tax_behavior]"=inclusive \ -d "head_office[address][country]"=DE ``` 更新後の `tax.settings` オブジェクトには本社、事前設定の税コード、デフォルトの税金処理が含まれるため、この連結アカウントで Stripe Tax を有効にできます。 ```json { "object": "tax.settings","defaults": { "tax_code": "txcd_10000000", "tax_behavior": "inclusive" }, "head_office": { "address": { "country": "DE" } }, "livemode": false, "status": "active", "status_details": { "active": {} } } ``` ### 検証とエラー 税コードは、[使用できる税コード](https://docs.stripe.com/tax/tax-codes.md)を示している必要があり、[税金処理](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#tax-behavior)は `inclusive`、`exclusive`、または `inferred_by_currency` に設定されている必要があります (設定した後は null に設定できません)。`head_office` には、サポート対象の住所が含まれている必要があります。 `head_office[address]` には、`line1`、`line2`、`city`、`state`、`postal_code`、`country` のフィールドがあります。以下の表は、サポートされる住所の形式を説明したものです。 #### アメリカ | 住所のサンプル | 説明 | サポート対象 | | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------- | | - `line1`: 27 Fredrick Ave - `city`: Brothers - `state`: OR - `postal_code`: 97712 - `country`: US | **完全な住所** 完全な住所には最低でも line1 (番地または私書箱)、市区町村、郵便番号、国が含まれます。 この住所は、アメリカ郵政公社の住所データベースで最も近い住所または街区と照合されます。一致するものが見つからない場合は、5 桁の郵便番号の地理的な中央位置 (住所の平均的な場所) がフォールバックとして使用されます。 | ✓ サポート対象 | | 9 桁の郵便番号: - `postal_code`: 97712-4918 - `country`: US 5 桁の郵便番号: - `postal_code`: 97712 - `country`: US | **国と郵便番号** 5 桁または 9 桁の郵便番号を指定すると、Stripe のシステムでは最初の 5 桁のみが税金の計算に使用されます。税金は地理的な中央位置で計算され、5 桁の郵便番号区域内の住所の平均的な場所が反映されます。これが[お客様の事業に適している](https://docs.stripe.com/tax/customer-locations.md#us-postal-codes)かどうかをご確認ください。 | ✓ サポート対象 | | - `state`: OR - `country`: US | **国と州** Stripe は、ISO [国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)と[州コード](https://en.wikipedia.org/wiki/ISO_3166-2)のみを使用してアメリカの顧客の税金を計算することはできません。 | ✗ サポート対象外 | | - `country`: US | **国** Stripe は、ISO [国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)のみを使用してアメリカの顧客の税金を計算することはできません。 | ✗ サポート対象外 | #### カナダ | 住所のサンプル | 説明 | サポート対象 | | ------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | | - `line1`: 1 Rocky Road - `city`: Vancouver - `province`: BC - `postal_code`: V1X 1X1 - `country`: CA | **完全な住所** 完全な住所には最低でも line1 (番地)、都市名、州、国が含まれます。 Stripe では、[ISO 国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)および州から税金を計算します。その他のフィールドは、税金の計算には使用されません。 | ✓ サポート対象 | | 6 桁の郵便番号: - `postal_code`: V1X 1X1 - `country`: CA | **国と郵便番号** Stripe では、[ISO 国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)、および郵便番号から判断できる州を基に税金を計算します。 | ✓ サポート対象 | | - `province`: BC - `country`: CA | **国と州** Stripe は [ISO 国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)および州から、カナダの顧客に対する税金を計算します。 | ✓ サポート対象 | | - `country`: CA | **国** Stripe は、ISO [国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)のみを使用してカナダの顧客の税金を計算することはできません。 | ✗ サポート対象外 | #### インド | 住所のサンプル | 説明 | サポート対象 | | ------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | | - `line1`:Rafi Marg, 118 - `city`:デリー - `province`:デリー首都直轄地域 (NCT) (連邦直轄領) - `postal_code`:110001 - `country`:IN | **完全な住所** 完全な住所には最低でも line1 (番地)、都市名、州、国が含まれます。 Stripe では、[ISO 国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)と、郵便番号または州名から税金を計算します。 | ✓ サポート対象 | | 6 桁の郵便番号: - `postal_code`:110001 - `country`:IN | **国と郵便番号** Stripe では、[ISO 国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)と、郵便番号または州名から税金を計算します。 | ✓ サポート対象 | | - `province`:デリー首都直轄地域 (NCT) (連邦直轄領) - `country`:IN | **国と州** Stripe では、[ISO 国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)と、郵便番号または州名から税金を計算します。 | ✓ サポート対象 | | - `country`:IN | **国** インドの顧客の税金は、[ISO 国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)のみでは計算できません。 | ✗ サポート対象外 | #### その他の場所 | 住所のサンプル | 説明 | サポート対象 | | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | | - `line1`: 1 Grand Canal St - `city`: Dublin - `postal_code`: D02 H210 - `country`: IE | **完全な住所** 完全な住所に含まれるフィールドは国によって異なりますが、通常は line1 (番地)、市区町村、郵便番号、国が含まれます。 Stripe では、ISO [国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)と、[州コード](https://en.wikipedia.org/wiki/ISO_3166-2)または郵便番号 (提供された場合) から税金を計算します。その他のフィールドは、税金の計算には使用されません。 | ✓ サポート対象 | | - `postal_code`: 51001 - `country`: ES | **国と郵便番号** Stripe では、ISO [国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)から税金を計算し、郵便番号を使用して顧客が[適用除外地域](https://docs.stripe.com/tax/customer-locations.md#europe-excluded-territories)に所在するかどうかを判断します。 | ✓ サポート対象 | | - `state`: CE - `country`: ES | **国と州** Stripe では、ISO [国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)と[州コード](https://en.wikipedia.org/wiki/ISO_3166-2)から税金を計算します。Stripe では、州コードを使用して顧客が[適用除外地域](https://docs.stripe.com/tax/customer-locations.md#europe-excluded-territories)にいるかどうかを判断します。 | ✓ サポート対象 | | - `country`: ES | **国** Stripe では、ISO [国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)から税金を計算します。顧客が[適用除外地域](https://docs.stripe.com/tax/customer-locations.md#europe-excluded-territories)にいる場合には、国の税率を支払います。 | ✓ サポート対象 | 上記のいずれかの住所形式を使用して、連結アカウントの本社所在地が一貫して認識されるようにしてください。国のフィールドは常に有効な [ISO 国コード](https://en.wikipedia.org/wiki/ISO_3166-1)である必要があります。 > ここに掲載されている検証とエラーは、設定フェーズに含まれています。[構築済みの Stripe システムで API を呼び出す](https://docs.stripe.com/tax/set-up.md#integrate)際には、その他のエラーが表示されることもあります。 ## See also - [Registrations API を使用して、納税登録を管理する](https://docs.stripe.com/tax/registrations-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/settings-api?tax-integration=direct. ## Stripe Tax を使用する準備が整っているかを確認する Stripe Tax を有効にできるかどうかを評価する必要がある場合は、この確認を実行します。Stripe の公式ライブラリを使用して、Stripe API にアクセスします。[`tax.settings` オブジェクトを取得](https://docs.stripe.com/api/tax/settings/retrieve.md)します。 ```curl curl https://api.stripe.com/v1/tax/settings \ -u "<>:" ``` Stripe ダッシュボードを使用して税金設定を更新したとき、または新しい必須の税金設定が導入されたときにトリガーされる [tax.settings.updated](https://docs.stripe.com/api/events/types.md#event_types-tax.settings.updated) Webhook イベントをリッスンすることも可能です。Webhook エンドポイントを追加する方法については、[Webhook を本番環境に移行する](https://docs.stripe.com/webhooks.md#register-webhook)をご覧ください。 API または Webhook イベントが取得したレスポンスの `tax.settings` オブジェクトで `status` として `"active"` が返された場合は、Stripe Tax を使用する準備ができています。`defaults.tax_code` と `defaults.tax_behavior` の設定は、各 API コールの商品または価格で指定されていない場合にのみ必要です。 ```json { "object": "tax.settings", "defaults": { "tax_code": null, "tax_behavior": null }, "head_office": { "address": { "country": "DE" } }, "livemode": false,"status": "active", "status_details": { "active": {} } } ``` レスポンスの `tax.settings` オブジェクトの `status` で `"pending"` が返される場合は、Stripe Tax を使用する準備ができていません。[status_details[pending][missing_fields]](https://docs.stripe.com/api/tax/settings/object.md#tax_settings_object-status_details-pending-missing_fields) には、未入力の必須フィールドの一覧が含まれます。 ```json { "object": "tax.settings", "defaults": { "tax_code": null, "tax_behavior": null }, "head_office": null, "livemode": false,"status": "pending", "status_details": { "pending": { "missing_fields": ["head_office"] } } } ``` ## 設定を構成する Stripe Tax の設定がすべて自社のインターフェイスで管理されている場合、このステップを完了してください。 [設定の更新](https://docs.stripe.com/api/tax/settings/update.md)の呼び出しを通じて設定を変更できます。本社所在地、事前設定の税コード、税金処理を指定して呼び出しを実行します。 ```curl curl https://api.stripe.com/v1/tax/settings \ -u "<>:" \ -d "defaults[tax_code]"=txcd_10000000 \ -d "defaults[tax_behavior]"=inclusive \ -d "head_office[address][country]"=DE ``` 更新後の `tax.settings` オブジェクトには本社、事前設定の税コード、デフォルトの税金処理が含まれるため、Stripe Tax を有効にできます。 ```json { "object": "tax.settings","defaults": { "tax_code": "txcd_10000000", "tax_behavior": "inclusive" }, "head_office": { "address": { "country": "DE" } }, "livemode": false, "status": "active", "status_details": { "active": {} } } ``` ### 検証とエラー 税コードは、[使用できる税コード](https://docs.stripe.com/tax/tax-codes.md)を示している必要があり、[税金処理](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#tax-behavior)は `inclusive`、`exclusive`、または `inferred_by_currency` に設定されている必要があります (設定した後は null に設定できません)。`head_office` には、サポート対象の住所が含まれている必要があります。 `head_office[address]` には、`line1`、`line2`、`city`、`state`、`postal_code`、`country` のフィールドがあります。以下の表は、サポートされる住所の形式を説明したものです。 #### アメリカ | 住所のサンプル | 説明 | サポート対象 | | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------- | | - `line1`: 27 Fredrick Ave - `city`: Brothers - `state`: OR - `postal_code`: 97712 - `country`: US | **完全な住所** 完全な住所には最低でも line1 (番地または私書箱)、市区町村、郵便番号、国が含まれます。 この住所は、アメリカ郵政公社の住所データベースで最も近い住所または街区と照合されます。一致するものが見つからない場合は、5 桁の郵便番号の地理的な中央位置 (住所の平均的な場所) がフォールバックとして使用されます。 | ✓ サポート対象 | | 9 桁の郵便番号: - `postal_code`: 97712-4918 - `country`: US 5 桁の郵便番号: - `postal_code`: 97712 - `country`: US | **国と郵便番号** 5 桁または 9 桁の郵便番号を指定すると、Stripe のシステムでは最初の 5 桁のみが税金の計算に使用されます。税金は地理的な中央位置で計算され、5 桁の郵便番号区域内の住所の平均的な場所が反映されます。これが[お客様の事業に適している](https://docs.stripe.com/tax/customer-locations.md#us-postal-codes)かどうかをご確認ください。 | ✓ サポート対象 | | - `state`: OR - `country`: US | **国と州** Stripe は、ISO [国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)と[州コード](https://en.wikipedia.org/wiki/ISO_3166-2)のみを使用してアメリカの顧客の税金を計算することはできません。 | ✗ サポート対象外 | | - `country`: US | **国** Stripe は、ISO [国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)のみを使用してアメリカの顧客の税金を計算することはできません。 | ✗ サポート対象外 | #### カナダ | 住所のサンプル | 説明 | サポート対象 | | ------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | | - `line1`: 1 Rocky Road - `city`: Vancouver - `province`: BC - `postal_code`: V1X 1X1 - `country`: CA | **完全な住所** 完全な住所には最低でも line1 (番地)、都市名、州、国が含まれます。 Stripe では、[ISO 国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)および州から税金を計算します。その他のフィールドは、税金の計算には使用されません。 | ✓ サポート対象 | | 6 桁の郵便番号: - `postal_code`: V1X 1X1 - `country`: CA | **国と郵便番号** Stripe では、[ISO 国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)、および郵便番号から判断できる州を基に税金を計算します。 | ✓ サポート対象 | | - `province`: BC - `country`: CA | **国と州** Stripe は [ISO 国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)および州から、カナダの顧客に対する税金を計算します。 | ✓ サポート対象 | | - `country`: CA | **国** Stripe は、ISO [国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)のみを使用してカナダの顧客の税金を計算することはできません。 | ✗ サポート対象外 | #### インド | 住所のサンプル | 説明 | サポート対象 | | ------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | | - `line1`:Rafi Marg, 118 - `city`:デリー - `province`:デリー首都直轄地域 (NCT) (連邦直轄領) - `postal_code`:110001 - `country`:IN | **完全な住所** 完全な住所には最低でも line1 (番地)、都市名、州、国が含まれます。 Stripe では、[ISO 国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)と、郵便番号または州名から税金を計算します。 | ✓ サポート対象 | | 6 桁の郵便番号: - `postal_code`:110001 - `country`:IN | **国と郵便番号** Stripe では、[ISO 国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)と、郵便番号または州名から税金を計算します。 | ✓ サポート対象 | | - `province`:デリー首都直轄地域 (NCT) (連邦直轄領) - `country`:IN | **国と州** Stripe では、[ISO 国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)と、郵便番号または州名から税金を計算します。 | ✓ サポート対象 | | - `country`:IN | **国** インドの顧客の税金は、[ISO 国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)のみでは計算できません。 | ✗ サポート対象外 | #### その他の場所 | 住所のサンプル | 説明 | サポート対象 | | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | | - `line1`: 1 Grand Canal St - `city`: Dublin - `postal_code`: D02 H210 - `country`: IE | **完全な住所** 完全な住所に含まれるフィールドは国によって異なりますが、通常は line1 (番地)、市区町村、郵便番号、国が含まれます。 Stripe では、ISO [国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)と、[州コード](https://en.wikipedia.org/wiki/ISO_3166-2)または郵便番号 (提供された場合) から税金を計算します。その他のフィールドは、税金の計算には使用されません。 | ✓ サポート対象 | | - `postal_code`: 51001 - `country`: ES | **国と郵便番号** Stripe では、ISO [国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)から税金を計算し、郵便番号を使用して顧客が[適用除外地域](https://docs.stripe.com/tax/customer-locations.md#europe-excluded-territories)に所在するかどうかを判断します。 | ✓ サポート対象 | | - `state`: CE - `country`: ES | **国と州** Stripe では、ISO [国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)と[州コード](https://en.wikipedia.org/wiki/ISO_3166-2)から税金を計算します。Stripe では、州コードを使用して顧客が[適用除外地域](https://docs.stripe.com/tax/customer-locations.md#europe-excluded-territories)にいるかどうかを判断します。 | ✓ サポート対象 | | - `country`: ES | **国** Stripe では、ISO [国コード](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)から税金を計算します。顧客が[適用除外地域](https://docs.stripe.com/tax/customer-locations.md#europe-excluded-territories)にいる場合には、国の税率を支払います。 | ✓ サポート対象 | 上記のいずれかの住所形式を使用して、本社所在地が一貫して認識されるようにしてください。国のフィールドは常に有効な [ISO 国コード](https://en.wikipedia.org/wiki/ISO_3166-1)である必要があります。 > ここに掲載されている検証とエラーは、設定フェーズに含まれています。[構築済みの Stripe システムで API を呼び出す](https://docs.stripe.com/tax/set-up.md#integrate)際には、その他のエラーが表示されることもあります。 ## See also - [Registrations API を使用して、納税登録を管理する](https://docs.stripe.com/tax/registrations-api.md)