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

# Notas Fiscais (NFS-e)

> Emita notas fiscais de serviço automaticamente via SalesOS Pay.

# Notas Fiscais (NFS-e)

O SalesOS Pay emite Notas Fiscais de Serviço Eletrônicas (NFS-e) diretamente da plataforma, sem necessidade de login separado em ERP.

## Como funciona

<Steps>
  <Step title="Configuração inicial">
    O administrador habilita o módulo NFS-e nas configurações do tenant durante o onboarding.
  </Step>

  <Step title="Cadastro de cliente">
    Ao fechar um deal, o cliente é cadastrado automaticamente (se ainda não existir).
  </Step>

  <Step title="Emissão da NFS-e">
    A nota fiscal é emitida automaticamente ou sob demanda, com os dados do deal e do cliente.
  </Step>

  <Step title="Acompanhamento">
    Acompanhe o status da nota fiscal diretamente no SalesOS: emitida, autorizada, cancelada.
  </Step>
</Steps>

## Status da NFS-e

| Status      | Descrição                      |
| ----------- | ------------------------------ |
| Pendente    | NFS-e aguardando emissão       |
| Processando | Em processamento na prefeitura |
| Autorizada  | NFS-e autorizada e válida      |
| Cancelada   | NFS-e cancelada                |
| Erro        | Falha na emissão — requer ação |

## Funcionalidades

<CardGroup cols={2}>
  <Card title="Emissão automática" icon="wand-magic-sparkles">
    Configure para emitir NFS-e automaticamente ao fechar um deal ou ao confirmar pagamento de uma cobrança via API.
  </Card>

  <Card title="Consulta de status" icon="magnifying-glass">
    Verifique o status de qualquer NFS-e emitida em tempo real.
  </Card>

  <Card title="Cancelamento" icon="ban">
    Cancele notas fiscais emitidas por engano diretamente pela plataforma, dentro da janela permitida pelo município.
  </Card>

  <Card title="Histórico completo" icon="clock-rotate-left">
    Acesse o histórico de todas as notas fiscais com filtros por período, status e cliente.
  </Card>
</CardGroup>

## Configuração

<Steps>
  <Step title="Habilite o módulo NFS-e">
    Em **Configurações > Faturamento > NFS-e**, ative o módulo para o seu tenant.
  </Step>

  <Step title="Configure os códigos de serviço">
    Defina os códigos de serviço municipais (ex: 01.05 para consultoria em SP) usados na emissão.
  </Step>

  <Step title="Configure as alíquotas">
    Defina as alíquotas de ISS e os tributos federais aplicáveis ao seu regime tributário.
  </Step>

  <Step title="Teste a integração">
    Emita uma NFS-e de teste para validar que a configuração está correta.
  </Step>
</Steps>

<Warning>
  Ambiente de produção emite NFS-e reais junto à prefeitura. Use o ambiente de staging para testes; em staging as emissões são simuladas.
</Warning>

<Note>
  A taxa aplicada na NFS-e é obtida da configuração de billing do tenant. Verifique se os valores estão corretos antes de emitir.
</Note>

## Próximos passos

<CardGroup cols={2}>
  <Card title="API de Pagamentos" icon="plug" href="/pt/api/integrations/payments">
    Emita cobranças e anexe NFS-e via API.
  </Card>

  <Card title="Faturas" icon="file-invoice" href="/pt/admin/billing/invoices">
    Gerencie faturas e pagamentos.
  </Card>
</CardGroup>