Stripe Tax に移行する

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.

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
• Have the tax behavior set on the price

You need to update the following types of subscriptions:

• Subscriptions with schedules. To learn more, see the Update Subscriptions with subscription schedules section.
• Subscriptions that use the charge types destination charges or separate charges and transfers.

The automated tool might not be able to update some subscriptions. This is usually due to not having a valid customer address.

After using the automated tool, you have to wait a few days before you can run it again. During that time, check and fix the subscriptions that failed in the first attempt.

• Review customer locations and make any required updates.
• Update products and prices with tax codes and tax behaviors.
• サブスクリプションを更新し、以降のインボイスで税金を自動的に計算します。
• サブスクリプションを適切に更新したことを確認します。

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.

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

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

商品を更新する

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

価格を更新する

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

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

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 のインスタンスを削除する必要があります。

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

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

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

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 を有効にします。

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

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

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 を使用する必要があります。

# 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.items.data[0].current_period_start,
        end_date: subscription.items.data[0].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: