> ## 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.

# Preços com Impostos Inclusos

> Mostre preços finais, com impostos inclusos, de forma clara. O Dodo calcula impostos por localização e os detalha claramente no checkout e nas faturas.

## O Que É Preço com Impostos Inclusos?

O Preço com Impostos Inclusos permite que você incorpore os impostos aplicáveis diretamente no preço do produto exibido. Os clientes veem um valor final único de forma antecipada, proporcionando uma experiência mais transparente e amigável para conversões. No checkout, o Dodo calcula a parte do preço sem impostos e o valor do imposto com base na localização do cliente, e os detalha claramente na fatura.

<Info>
  O imposto final ainda varia de acordo com a localização do cliente e a categoria fiscal. O checkout e as faturas mostram a parte do imposto calculado a partir do preço exibido.
</Info>

## Principais Benefícios

* **Clareza para os clientes**: Um preço final exibido de forma antecipada
* **Conformidade por região**: O imposto é calculado por localização e detalhado
* **Faturamento preciso**: As faturas mostram o valor líquido e o imposto derivado do preço
* **Amigável para conversões**: Redução de surpresas no checkout

## Configuração do Produto

Crie ou edite um produto no seu painel, depois ative o preço com impostos inclusos nas configurações de preços.

#### Preços

* **Preço** (obrigatório): Preço base que é exibido para o cliente.
* **Preço com Impostos Inclusos**: Ative para tratar o preço exibido como incluindo impostos. O Dodo calculará o valor líquido (antes dos impostos) e a parte do imposto no checkout com base na localização do cliente e na categoria de imposto.

<Warning>
  Somente compras futuras refletem as configurações atualizadas com imposto incluso. Compras existentes e assinaturas ativas não são alteradas retroativamente.
</Warning>

<Tip>
  Use textos consistentes do produto, como "Tax inclusive", para que os clientes entendam os totais rapidamente.
</Tip>

## Gerenciamento da API

<AccordionGroup>
  <Accordion title="Create products (tax inclusive)">
    Use `POST /products` para criar produtos com `tax_inclusive` definido como `true`.

    <Card title="API Reference" icon="code" href="/api-reference/products/post-products">
      Crie produto via API
    </Card>
  </Accordion>

  <Accordion title="Update products">
    Use `PATCH /products/{id}` para alternar `tax_inclusive` em produtos existentes.

    <Card title="API Reference" icon="code" href="/api-reference/products/patch-products">
      Atualize produto via API
    </Card>
  </Accordion>

  <Accordion title="Checkout Sessions">
    Use `POST /checkouts` para vender produtos marcados como inclusivos de impostos. O preço exibido permanece o mesmo; o checkout calcula o valor líquido e o imposto.

    <Card title="API Reference" icon="code" href="/api-reference/checkout-sessions/create">
      Crie sessão de checkout
    </Card>
  </Accordion>

  <Accordion title="Refunds (tax handling)">
    Use `POST /refunds` para emitir reembolsos. Você pode especificar se o reembolso inclui imposto usando a flag `tax_inclusive` quando aplicável.

    <Card title="API Reference" icon="code" href="/api-reference/refunds/post-refunds">
      Crie um reembolso
    </Card>
  </Accordion>
</AccordionGroup>

## Exemplos de Integração

### Criar um produto com preços com impostos inclusos

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

### Atualizar um produto existente para ativar impostos inclusos

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

## Melhores Práticas

* **Escolha a categoria de imposto correta** para garantir o cálculo correto por região.
* **Comunique os totais** de forma clara com rótulos "Impostos Inclusos" na cópia do produto.
* **Teste no sandbox** para validar.

## Relacionados

<CardGroup cols={2}>
  <Card title="Products" icon="dollar-sign" href="/features/products">
    Gerencie opções de preços entre produtos.
  </Card>

  <Card title="Subscriptions" icon="repeat" href="/features/subscription">
    Configure produtos recorrentes com configurações avançadas.
  </Card>

  <Card title="Discount Codes" icon="percent" href="/features/discount-codes">
    Ofereça promoções mantendo a clareza nas faturas.
  </Card>
</CardGroup>