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

納税登録を追加する

課税対象地域の税務当局に登録したら、 create Registration を呼び出して、その登録を Stripe Tax に追加します。

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

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

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

本社の住所の要件

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

tax settings API を使用して、本社の住所を追加します:

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

場所に固有の検証とエラーが発生することがあります。詳細については、Stripe の税金設定ガイドでご確認いただけます。

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

Stripe Tax の税務登録は削除できません。地方税務当局への登録を解除し、その場所で税金の徴収を停止する必要がある場合は、登録を期限切れにします。税務登録を期限切れにするには、 update Registration を呼び出して expires_at タイムスタンプを設定します。

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

この状況では、登録が即座に期限切れになります。expires_at 以降に実行される税金計算では、この登録は使用されません。

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

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

list registrations (登録のリスト) コールを実行すると、納税登録をすべて表示することができます。status パラメーターを使用すると、active、expired、または scheduled の納税登録のみに絞り込むことができます。

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

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