コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン

注

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

Stripe Tax に移行する

既存のサブスクリプションを Stripe Tax に移行する方法をご紹介します。

ページをコピー

Stripe Tax を使用すると、取引で徴収する税金を計算できます。税額は商品および顧客の所在地に基づいて、自動的に計算され、支払いに追加されます。

When you integrate with Stripe Tax, you need to update existing subscriptions to make sure that tax is automatically calculated going forward. Stripe provides tooling to help you update your subscriptions. You can also manually update subscriptions where you want more control over certain options.

Update existing subscriptions using automated tooling

First, you need to activate Stripe Tax. To learn how, read the setup guide.

To use the tooling, follow these steps:

  1. Go to the Dashboard.
  2. Review the subscriptions you need to update.
  3. Review the recommended actions.
  4. Make any necessary manual updates.

Stripe removes manual tax rates from the subscriptions, which can take up to 5 business days. When the process is complete, we notify you by email.

注

We don’t prorate the tax changes. The updates take effect at the start of the next billing cycle.

You can use the tooling to update subscriptions that meet the following criteria:

  • Are active
  • Don’t automatically collect tax
  • Have sufficient address information to calculate tax

You need to update the following types of subscriptions:

Update existing subscriptions manually

顧客の地域を確認する

To correctly calculate tax, we need to know the customer’s tax location status. You can check it in the Dashboard or in exported data, or get the information using the API.

To check a customer’s tax location status through the Dashboard, go to the Customers page, select the customer, and expand their details. The tax location status (automatic_tax) has four possible values:

ステータス説明想定されるアクション
有効 (supported)税金の自動計算が完全にサポートされています。これ以上のアクションは必要ありません。
認識されていない場所 (unrecognized_location)この住所は納税場所の判断には有効ではありません。顧客に住所の更新を依頼し、customer.address に新しい値を設定します。顧客の詳細を編集することで、API またはダッシュボードから値を更新できます。
未登録 (not_collecting)住所が認識され、場所が判別されましたが、徴収場所として設定されていない場所でした。必要なアクションは、お客様の納税義務によって異なります。続行しても、Stripe Tax は税金を評価しません。Stripe Tax で税金を評価するには、顧客が在住する管轄区域の有効な登録を追加してください。
failedStripe のサーバーでエラーが発生しました。これはまれなケースです。再度リクエストをお試しください。問題が解決しない場合は、Stripe サポートにご連絡ください。

status=unrecognized_location の場合は、Stripe Taxが使用できる住所 を使用して顧客の所在地を更新する必要があります。ダッシュボードで顧客に移動し、顧客を選択し、詳細で請求先住所や配送先住所を変更できます。

Check tax location status through exports

To check the tax location status of your customers through Dashboard exports, go to the Customers page, click Export, and select All columns.

CSV ファイルには、Tax Location Recognizedという名前のブール列が含まれています。これを使用して、顧客に有効な住所があるかどうかを判別できます。

有効な顧客の住所、その使用方法、エラーの対処方法については、顧客の住所を収集するで詳細をご覧ください。

商品と価格を更新する

商品と価格には、Stripe Tax を有効にしたときに割り当てたデフォルトの税金処理が使用されます。税金を別途計算するために有効な商品と価格を更新する場合は、tax_code と tax_behavior を設定します。詳細については、すべての使用可能な税コードのリストと、税コードおよび税金処理の設定のガイドをご覧ください。価格を内税にするか外税にするかの決定方法など、商品と価格についての詳細は、Tax の設定に関してよくある質問をご覧ください。

商品を更新する

まず、tax_code で既存の商品を更新します。商品の tax_code が明示的に定義されていない場合、Stripe Tax は、設定されている事前設定の商品の税コードを使用します。

ダッシュボードで tax_code を指定して Product を更新するには、商品ページに移動して、編集する商品を選択し、商品情報ページでドロップダウンメニューから税コードを選択します。

価格を更新する

次に、価格の税金処理を更新します。

よくある間違い

tax_behavior は、一度 exclusive または inclusive のいずれかに設定すると、後から変更することはできません。価格の税金処理を変更するには、必要な税金処理で新しい価格を作成し、古い価格をアーカイブする必要があります。

ダッシュボードを使用して価格を更新する:

  1. 商品ページに移動します。
  2. 価格を更新する商品を選択します。
  3. 価格情報セクションで追加オプションを選択します。
  4. 価格に税金を含めるドロップダウンメニューで、価格に関連付ける処理を選択します。

サブスクリプションを更新する

顧客、商品、価格を更新すると、既存のサブスクリプションを更新する準備が整います。

Get the list of subscriptions that need to be updated from the subscriptions page in the Dashboard. To display only subscriptions that don’t have automatic tax enabled, click Filter, check Automatic tax, and select Disabled. Alternatively, you can export all filtered subscriptions to view them as a CSV file. To do this, click Export and select All as the Date range.

ステータスに応じてサブスクリプションを更新する方法:

  • サブスクリプションに既存の税率がない場合は、税金の自動計算を有効にするだけで済みます。
  • サブスクリプションのサブスクリプションまたはラインアイテムのレベルに既存の税率がある場合は、既存の税率を消去し、税金の自動計算を有効化する必要があります。比例配分が適用されたアイテムの作成を避けるには、この更新のスケジュールを作成することができます。
  • サブスクリプションにサブスクリプションスケジュールがある場合、サブスクリプションスケジュールプランで automatic_tax[enabled]=false のインスタンスを削除する必要があります。

既存の税率がないサブスクリプションを更新する

ダッシュボードで既存の税率のないサブスクリプションを更新するには、サブスクリプションを更新して税金を自動計算オプションをオンにします。

既存の税率でサブスクリプションを更新する

To update subscriptions with tax rates through the Dashboard, edit the subscription, then enable the calculate tax automatically option. The Dashboard removes any existing tax rates and automatically calculates tax going forward. If you haven’t updated your prices to set tax_behavior, the Dashboard prompts you to update any missing details before you can update the subscription.

サブスクリプションのスケジュールを使用してサブスクリプションを更新する

If you need to collect tax, and any of your subscriptions include a subscription schedule that sets automatic_tax[enabled]=false, you must remove that parameter. To do so, update all phases of the subscription’s schedule by removing automatic_tax[enabled]=false and setting default_settings[automatic_tax][enabled]=true.

サブスクリプションのスケジュールを更新する際には、現在および以降のフェーズをすべて渡す必要があります。このためには、設定されているパラメーターを確認してから、サブスクリプションのスケジュールで Stripe Tax を有効にします。

Command Line
curl https://api.stripe.com/v1/subscription_schedules/
{{SUBSCRIPTION_SCHEDULE_ID}}
 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

サブスクリプションのスケジュールを取得後に更新するには、automatic_tax[enabled]=falseパラメーターを削除し、他のフェーズとパラメーターを渡します。

Command Line
curl https://api.stripe.com/v1/subscription_schedules/
{{SUBSCRIPTION_SCHEDULE_ID}}
 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "phases[0][items][0][price]"=price_1GqNdGAJVYItwOKqEHb \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][start_date]"=1577865600 \
  -d "phases[0][end_date]"=1578038400 \
  -d "phases[1][items][0][price]"=price_1GqNdGAJVYItwOKqEHb \
  -d "phases[1][items][0][quantity]"=2 \
  -d "phases[1][start_date]"=1578038400 \
  -d "phases[1][end_date]"=1580544000 \
  -d "default_settings[automatic_tax][enabled]"=true

更新をスケジュールする

比例配分アイテムが作成されないようにするには、次のサイクルの開始時に更新するようにスケジュールできます。

現在、サブスクリプションの更新をスケジュールするには、API を使用する必要があります。

server.rb
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'


subscription = Stripe::Subscription.retrieve(
  '{{SUBSCRIPTION_ID}}',
)
schedule = Stripe::SubscriptionSchedule.create({
  from_subscription: subscription.id
})
Stripe::SubscriptionSchedule.update(
  schedule.id,
  {
    end_behavior: 'release',
    phases: [
      # The first phase contains items for the
      # latest subscription invoice
      {
        items: [
          # Prices and tax_rates for each item
          {
            price: '{{PRICE_ID}}',
            tax_rates: [
              '{{TAX_RATE_ID}}'
            ]
          }
        ],
        default_tax_rates: ['{{TAX_RATE_ID}}'],
        start_date: subscription.current_period_start,
        end_date: subscription.current_period_end
      },
      # The second phase removes manual tax rates and enables
      # automatic tax calculation
      {
        items: [
          # Prices for each item with tax_rates: ''
          {
            price: '{{PRICE_ID}}',
            tax_rates: ''
          }
        ],
        default_tax_rates: '',
        automatic_tax: {enabled: true},
        iterations: 1
      }
    ]
  }
)

更新を確認する

To confirm that you’ve properly updated your subscriptions, create a preview invoice for each subscription and inspect the results of its tax calculation.

You can retrieve the tax amounts from the tax and total_tax_amounts fields on the preview invoice, and from the per-line-item tax_amounts fields. The invoice has an automatic_tax field showing the status of the calculation, with one of three possible statuses:

ステータス説明想定されるアクション
completeStripe Tax は支払いに対する税金の評価を完了しました。税額は、最新の請求書の tax および total_tax_amounts フィールドから、または各ラインアイテムの tax_amounts フィールドから取得できます。
requires_location_inputsStripe Tax was unable to assess taxes because it didn’t have enough information to determine the customer’s location.顧客から詳細な情報 (番地までの詳細など) を収集し、customer.address フィールドを更新します。
failedStripe の内部エラー。再度リクエストをお試しください。問題が解決しない場合は、Stripe サポートにご連絡ください。

参照情報

このページはお役に立ちましたか。
はいいいえ
お困りのことがございましたら 、サポートにお問い合わせください。
早期アクセスプログラムにご参加ください。
変更ログをご覧ください。
ご不明な点がございましたら、お問い合わせください。
LLM ですか？llms.txt を読んでください。
Powered by Markdoc