---
title: "Configuração fiscal"
description: "Com a conexão ativa, defina como as notas serão emitidas. A maior parte dos dados vem automaticamente da fatura do Stripe; aqui você configura o que o Stripe não conhece - principalmente o código de serviço municipal."
source_url: https://nfe.io/docs/integracoes/plugins/stripe/configuracao-fiscal
last_updated: 2026-07-22
---

Com a [conexão ativa](/integracoes/plugins/stripe/conexao-nfeio), defina como as notas serão emitidas. A maior parte dos dados vem automaticamente da fatura do Stripe; aqui você configura o que o Stripe não conhece - principalmente o **código de serviço municipal**.

## Código de serviço municipal (obrigatório)

O **código de serviço municipal** identifica o serviço prestado para a sua prefeitura e determina a tributação. Ele **não vem do Stripe** - você o define uma vez, por conexão.

- Informe o código de serviço da sua atividade.
- Em caso de dúvida, confirme com a sua **contabilidade** ou com a **prefeitura** - um código errado gera nota incorreta ou rejeitada.

![campo de código de serviço municipal na página de configuração do app](https://nfe.io/docs/../assets/img/stripe-config-01-codigo-servico.png)

## Descrição da nota

Defina a **descrição padrão** do serviço que aparecerá na NFS-e. Você pode usar uma descrição fixa ou derivada da fatura do Stripe (itens/plano).

## Modo de tributação

- **Automático (recomendado):** a NFE.io calcula os impostos a partir do código de serviço. É o modo padrão e atende à maioria dos casos.
- **Manual (avançado):** você controla alíquota de ISS, retenções e demais parâmetros. Use apenas se a sua operação exige tributação específica.

## Gatilho de emissão

Por padrão, a nota é emitida quando a **fatura é paga** no Stripe.

## Dados do tomador (cliente)

A NFS-e exige do tomador: **CPF ou CNPJ**, **nome/razão social** e, na maioria das prefeituras, **endereço**. O app busca esses dados na fatura e no cliente do Stripe, nesta ordem:

| Dado da NFS-e | De onde o app lê no Stripe |
| --- | --- |
| CPF/CNPJ | 1) **Tax ID** do cliente (`br_cnpj` / `br_cpf`) → 2) `metadata` (ex.: `cpf_cnpj`) |
| Nome / Razão social | Nome do cliente (`customer.name`) |
| E-mail | E-mail do cliente |
| Endereço | Endereço do cliente (`customer.address`) |

> **Dica:** cadastre o **CPF/CNPJ do cliente como Tax ID** no Stripe (tipo `br_cnpj` ou `br_cpf`). É a forma nativa e mais confiável. Alternativamente, use um campo em `metadata` (ex.: `cpf_cnpj`).

### Bairro e número

O Stripe não tem campos separados para **bairro** e **número**. O app resolve nesta ordem de precedência:

- **Bairro:** `metadata.district` (ou `bairro`) → campo personalizado do Checkout → segunda linha do endereço (`line2`).
- **Número:** `metadata.numero` (ou `number`) → campo personalizado do Checkout.

Para coletar o **bairro do próprio pagador**, adicione um campo personalizado ao criar a Checkout Session:

```js
custom_fields: [
  { key: "district", label: { type: "custom", custom: "Bairro" }, type: "text", optional: true },
]
```

> O **bairro é best-effort**: a maioria das prefeituras aceita em branco e ele **não bloqueia** a emissão. Já o **código da cidade (IBGE)** é obrigatório e é derivado do endereço/CEP.

## Quando faltar o documento do tomador

Se uma fatura for paga **sem CPF/CNPJ** identificável, o comportamento padrão desta integração é **emitir a nota como "cliente não identificado"** (quando a prefeitura e a legislação permitem) - útil para vendas B2C de baixo valor, evitando travar a emissão.

> Se a sua operação exige **sempre** identificar o tomador, oriente o cadastro do CPF/CNPJ como Tax ID no Stripe. Notas emitidas como "não identificado" seguem as regras da sua prefeitura.

## Validação automática

Antes de emitir, o app valida e completa dados quando possível (CNPJ, CPF e CEP) usando as consultas da NFE.io, reduzindo rejeições da prefeitura.

➡️ Configuração pronta. Veja como acompanhar as emissões em [Uso no dia a dia](/integracoes/plugins/stripe/uso-no-dia-a-dia).