Pular para o conteúdo principal
Ver como MarkdownDocs para agentes

Configuração fiscal

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.

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

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-eDe onde o app lê no Stripe
CPF/CNPJ1) Tax ID do cliente (br_cnpj / br_cpf) → 2) metadata (ex.: cpf_cnpj)
Nome / Razão socialNome do cliente (customer.name)
E-mailE-mail do cliente
EndereçoEndereç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:

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.

NFE.io

A NFE.io é uma empresa de tecnologia que fornece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas. Com suas ferramentas, as empresas podem economizar tempo e reduzir erros, aumentando a eficiência e precisão do processo de emissão de notas fiscais.

Um dos principais cases de sucesso da NFE.io é a implementação da solução na empresa de transporte Rodonaves. Com a automatização da emissão e gestão de notas fiscais eletrônicas, a Rodonaves conseguiu reduzir em até 80% o tempo gasto nesse processo, o que se traduziu em uma significativa melhoria na eficiência operacional. Além disso, a empresa também conseguiu eliminar erros e atrasos na emissão de notas fiscais, o que melhorou a relação com seus clientes e aumentou a confiança dos órgãos fiscais.

Outro exemplo é a implementação da NFE.io na empresa de comércio eletrônico, a Loja Integrada. Com a automatização da emissão de notas fiscais, a Loja Integrada conseguiu aumentar a velocidade de emissão de notas em até 10 vezes, o que permitiu que a empresa atendesse a uma maior quantidade de clientes e, consequentemente, aumentar as suas vendas.

Além desses exemplos, a NFE.io também tem outros cases de sucesso com empresas de setores como indústria, construção, varejo e serviços, mostrando a versatilidade e eficácia da sua solução.

Em resumo, a NFE.io é uma empresa de tecnologia que oferece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas, ajudando as empresas a economizar tempo e reduzir erros, melhorando a eficiência e precisão do processo. Com cases de sucesso em diferentes setores, a NFE.io tem se destacado como uma empresa líder em automação fiscal.