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

# Notas fiscais dos clientes

> Conecte o NFE.io, configure o serviço e o imposto e emita a nota fiscal (NFS-e) dos extratos pagos.

## Para que serve

Aqui a agência emite a nota fiscal de serviço (NFS-e) dos clientes. As notas saem em nome da sua agência, pela sua conta no NFE.io. O STChat só pede a emissão ao NFE.io com a sua chave e não guarda a nota em seu nome.

## Quem pode

Só o Dono configura as notas fiscais. Emitir e cancelar seguem com o Admin.

## Onde clicar

No portal, abra **Notas fiscais** (`/notas`). O botão **Configurar** leva a **Configurar notas fiscais** (`/notas/configurar`).

## Passo a passo: configurar

**1. Conecte a conta NFE.io**

Em **Conta NFE.io**, cole a **Chave da API** (no NFE.io, em Conta, Chaves de acesso) e o **ID da empresa no NFE.io**. Clique em **Testar conexão**.

**2. Informe o serviço e o imposto**

Preencha **Código de serviço (LC 116)**, **Alíquota do ISS (%)** (de 0 a 5), a **Descrição na nota** e, se for o caso, **ISS retido pelo cliente**.

**3. Escolha quando emitir**

**Automática ao pagar**: a nota sai quando a Stripe confirma o pagamento do extrato. **Manual**: você emite em Notas fiscais, no botão **Emitir nota**.

**4. Copie o endereço de aviso**

Em **Endereço de aviso do NFE.io**, copie o endereço e cole no painel do NFE.io. Assim a resposta da prefeitura volta para o STChat.

**5. Salve**

Clique em **Salvar e ligar notas**. Depois disso o botão passa a ser **Salvar**.

## Passo a passo: emitir e acompanhar

**1. Clique em Emitir nota**

Em **Escolha o cliente**, marque os extratos do mês. O extrato precisa estar pago.

**2. Acompanhe a situação**

Use os filtros **Todas**, **Emitidas**, **Processando**, **Com erro** e **Canceladas**. Cada nota tem **PDF** e **XML**.

**3. Corrija uma nota com erro**

Se a prefeitura recusar, corrija o documento na ficha da organização (**Abrir organização**) e clique em **Emitir de novo**.

Para desfazer uma nota, use **Cancelar nota**. O cancelamento é pedido ao NFE.io e a prefeitura confirma em instantes.

## O que acontece depois

A nota passa de **Processando** para **Emitida**. Se desconectar o NFE.io, novas notas deixam de ser emitidas, e as já emitidas continuam no NFE.io.

## Erros comuns

* "Este extrato ainda não pode gerar nota (precisa estar pago)."
* "Cole a chave da API do NFE.io."
* "Informe a empresa, o código de serviço e um ISS de 0 a 5%."
* "O NFE.io não aceitou esta chave."
* "Não achamos esta empresa na sua conta do NFE.io."
* "A empresa existe no NFE.io, mas não tem cadastro municipal (inscrição municipal) para NFS-e."
* "O NFE.io não respondeu. Tente de novo em instantes."

## Próximo passo

* [Extratos dos clientes](https://docs.stchat.app/agencias/extratos.md)
* [Receber dos clientes pela Stripe](https://docs.stchat.app/agencias/receber-dos-clientes-pela-stripe.md)
* [Organizações](https://docs.stchat.app/agencias/organizacoes.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.