> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 税金を含む価格設定

> 最終的な税金を含む価格を事前に表示します。Dodoは、顧客の所在地に基づいて税金を計算し、チェックアウトおよび請求書で明確に分けます。

## 税金を含む価格設定とは？

税金を含む価格設定では、表示される製品価格に適用される税金を直接埋め込むことができます。顧客は、より透明でコンバージョンに優しい体験のために、事前に最終的な金額を1つ表示されます。チェックアウト時に、Dodoは表示された価格に基づいて顧客の所在地から税金を除いた部分と税金の金額を計算し、請求書に明確に分けて表示します。

<Info>
  最終的な税額は顧客の所在地や税区分によって変わります。チェックアウトと請求書には、表示価格から導かれた計算済みの税額部分が表示されます。
</Info>

## 主な利点

* **顧客に対する明確さ**: 事前に表示される最終価格
* **地域ごとのコンプライアンス**: 所在地ごとに税金が計算され、分けられます
* **正確な請求書**: 請求書には価格から導出されたネット金額と税金が表示されます
* **コンバージョンに優しい**: チェックアウト時の驚きを減少させます

## 製品設定

ダッシュボードで製品を作成または編集し、価格設定の設定で税金を含む価格設定を有効にします。

#### 価格設定

* **価格** (必須): 顧客に表示される基本価格。
* **税金を含む価格設定**: 表示された価格を税金を含むものとして扱うためにトグルをオンにします。Dodoは、顧客の所在地と税金のカテゴリに基づいて、チェックアウト時にネット（税金前）金額と税金部分を計算します。

<Warning>
  今後の購入のみが更新された税込設定を反映します。既存の購入や有効なサブスクリプションには遡って変更を加えません。
</Warning>

<Tip>
  「Tax inclusive」のような一貫した製品文言を使用して、顧客が合計をひと目で理解できるようにしましょう。
</Tip>

## API管理

<AccordionGroup>
  <Accordion title="Create products (tax inclusive)">
    `POST /products` を使って、`tax_inclusive` を `true` に設定した製品を作成します。

    <Card title="API Reference" icon="code" href="/api-reference/products/post-products">
      API を通じて製品を作成する
    </Card>
  </Accordion>

  <Accordion title="Update products">
    既存製品で `tax_inclusive` を切り替えるには `PATCH /products/{id}` を使用します。

    <Card title="API Reference" icon="code" href="/api-reference/products/patch-products">
      API で製品を更新する
    </Card>
  </Accordion>

  <Accordion title="Checkout Sessions">
    税込みとしてマークされた製品を販売するには、`POST /checkouts` を使用します。表示価格は同じままで、チェックアウト時に正味金額と税額が算出されます。

    <Card title="API Reference" icon="code" href="/api-reference/checkout-sessions/create">
      チェックアウトセッションを作成する
    </Card>
  </Accordion>

  <Accordion title="Refunds (tax handling)">
    払い戻しを発行するには `POST /refunds` を使用します。必要に応じて `tax_inclusive` フラグを使って払い戻しが税込かどうかを指定できます。

    <Card title="API Reference" icon="code" href="/api-reference/refunds/post-refunds">
      払い戻しを作成する
    </Card>
  </Accordion>
</AccordionGroup>

## 統合例

### 税金を含む価格設定で製品を作成

```typescript theme={null}
const product = await client.products.create({
  name: 'Pro Plan',
  description: 'All features included',
  tax_category: 'saas',
  price: {
    type: 'one_time_price',
    currency: 'USD',
    price: 10000,
    discount: 0,
    purchasing_power_parity: false,
    tax_inclusive: true
  }
});
```

### 既存の製品を更新して税金を含むに切り替え

```typescript theme={null}
await client.products.update(product.id, {
  price: {
    tax_inclusive: true
  }
});
```

## ベストプラクティス

* **正しい税金カテゴリを選択**して、地域ごとの正確な計算を確保します。
* **合計を明確に伝える**ために、製品コピーに「税金を含む」ラベルを使用します。
* **サンドボックスでテスト**して検証します。

## 関連

<CardGroup cols={2}>
  <Card title="Products" icon="dollar-sign" href="/features/products">
    製品全体の価格オプションを管理します。
  </Card>

  <Card title="Subscriptions" icon="repeat" href="/features/subscription">
    高度な設定で定期製品を構成します。
  </Card>

  <Card title="Discount Codes" icon="percent" href="/features/discount-codes">
    請求書の明確さを保ちながらプロモーションを提供します。
  </Card>
</CardGroup>
