---
updatedAt: 2026-08-31T20:05:14.000Z
agentTools:
  projectIndex: https://docs.asaas.com/llms.txt
---

# Notas fiscais

Use esta seção para integrar a emissão de Notas Fiscais de Serviço (NFS-e) ao Asaas.

Você pode configurar os dados fiscais da empresa, emitir notas vinculadas a cobranças ou parcelamentos, criar notas avulsas e acompanhar o processamento por Webhooks.

## Por onde começar

Escolha o conteúdo conforme a etapa da sua integração:

| Necessidade                                         | Continue em                                                                                                                                                                                  |
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Entender o fluxo completo de emissão                | [Introdução - Notas Fiscais](https://docs.asaas.com/docs/notas-fiscais)                                                                                                                      |
| Configurar os dados fiscais exigidos pelo município | [Configurar informações fiscais](https://docs.asaas.com/docs/configurar-informacoes-fiscais)                                                                                                 |
| Agendar e emitir uma NFS-e                          | [Emitindo notas fiscais de serviço](https://docs.asaas.com/docs/emitindo-notas-fiscais-de-servico)                                                                                           |
| Adequar a integração aos campos de IBS/CBS          | [Adequando sua integração à Reforma Tributária](https://docs.asaas.com/docs/adequando-sua-integra%C3%A7%C3%A3o-%C3%A0-reforma-tribut%C3%A1ria)                                               |
| Configurar PIS/COFINS para os cenários aplicáveis   | [Configurações de retenção e situação tributária de PIS/COFINS](https://docs.asaas.com/docs/configura%C3%A7%C3%B5es-de-reten%C3%A7%C3%A3o-e-situa%C3%A7%C3%A3o-tribut%C3%A1ria-de-piscofins) |
| Acompanhar emissão, cancelamento ou falhas          | [Eventos para notas fiscais](https://docs.asaas.com/docs/webhook-para-notas-fiscais)                                                                                                         |

## Antes de emitir

Configure primeiro as informações fiscais da conta.

Os dados exigidos podem variar conforme o município. Consulte as configurações municipais para identificar os campos necessários antes de salvar a configuração fiscal.

Depois da configuração, identifique o serviço prestado e agende a nota fiscal.

A nota pode ser:

| Origem                      | Identificador |
| --------------------------- | ------------- |
| Vinculada a uma cobrança    | `payment`     |
| Vinculada a um parcelamento | `installment` |
| Avulsa para um cliente      | `customer`    |

Ao agendar a nota, informe pelo menos uma dessas origens.

## Acompanhe a emissão por Webhooks

A emissão da nota fiscal possui processamento assíncrono.

Depois de agendar a nota, utilize [Eventos para notas fiscais](https://docs.asaas.com/docs/webhook-para-notas-fiscais) para acompanhar autorização, cancelamento e erros, em vez de consultar o status repetidamente pela API.

Quando a nota for autorizada, o evento pode disponibilizar dados como `pdfUrl`, `xmlUrl`, `number` e `validationCode`.

## Exemplos práticos

Use os Recipes quando precisar de um exemplo executável para uma operação específica:

* [Fluxo completo para emissão de Nota Fiscal via API](https://docs.asaas.com/recipes/fluxo-completo-para-emissão-de-nota-fiscal-via-api)
* [Configurar informações fiscais para emissão de Nota Fiscal](https://docs.asaas.com/recipes/configurar-informações-fiscais-para-emissão-de-nota-fiscal)
* [Agendar uma Nota Fiscal vinculada a uma cobrança](https://docs.asaas.com/recipes/agendar-uma-nota-fiscal-vinculada-a-uma-cobrança)
* [Adequar a emissão de Nota Fiscal à Reforma Tributária (IBS/CBS)](https://docs.asaas.com/recipes/adequar-a-emissão-de-nota-fiscal-à-reforma-tributária-ibscbs)

## Referência da API

Consulte a API Reference para os contratos completos dos endpoints:

* [Listar configurações municipais](https://docs.asaas.com/reference/listar-configuracoes-municipais)
* [Criar e atualizar informações fiscais](https://docs.asaas.com/reference/criar-e-atualizar-informacoes-fiscais)
* [Listar serviços municipais](https://docs.asaas.com/reference/listar-servicos-municipais)
* [Agendar nota fiscal](https://docs.asaas.com/reference/agendar-nota-fiscal)

## Próximos passos

* [Entenda o fluxo de Notas Fiscais](https://docs.asaas.com/docs/notas-fiscais)
* [Configure as informações fiscais](https://docs.asaas.com/docs/configurar-informacoes-fiscais)
* [Emita Notas Fiscais de Serviço](https://docs.asaas.com/docs/emitindo-notas-fiscais-de-servico)
* [Acompanhe os eventos de Notas Fiscais](https://docs.asaas.com/docs/webhook-para-notas-fiscais)

# Sub pages

* [Introdução - Notas Fiscais](https://docs.asaas.com/docs/notas-fiscais.md)
* [Configurar informações fiscais](https://docs.asaas.com/docs/configurar-informacoes-fiscais.md)
* [Emitindo notas fiscais de serviço](https://docs.asaas.com/docs/emitindo-notas-fiscais-de-servico.md)
* [Adequando sua integração à Reforma Tributária](https://docs.asaas.com/docs/adequando-sua-integração-à-reforma-tributária.md)
* [Configurações de retenção e situação tributária de PIS/COFINS](https://docs.asaas.com/docs/configurações-de-retenção-e-situação-tributária-de-piscofins.md)
* [FAQ de Notas Fiscais](https://docs.asaas.com/docs/faq-de-notas-fiscais.md)

# Sibling pages

* [Comece aqui](https://docs.asaas.com/docs/comece-aqui.md)
* [Segurança](https://docs.asaas.com/docs/segurança.md)
* [MCP Server (IA)](https://docs.asaas.com/docs/mcp-1.md)
* [Sandbox](https://docs.asaas.com/docs/sandbox.md)
* [Cobranças](https://docs.asaas.com/docs/cobranças-1.md)
* [Pix](https://docs.asaas.com/docs/pix-3.md)
* [Pix Automático](https://docs.asaas.com/docs/pix-automatico.md)
* [Assinaturas (recorrência)](https://docs.asaas.com/docs/assinaturas-recorrência.md)
* [Link de pagamento](https://docs.asaas.com/docs/link-de-pagamento.md)
* [Asaas Checkout](https://docs.asaas.com/docs/checkout-asaas.md)
* [Split de pagamento](https://docs.asaas.com/docs/split-de-pagamento.md)
* [Antecipações](https://docs.asaas.com/docs/guia-antecipacoes.md)
* [Notificações](https://docs.asaas.com/docs/notificações-1.md)
* [Transferências](https://docs.asaas.com/docs/transferências-1.md)
* [Webhooks](https://docs.asaas.com/docs/webhooks-2.md)
* [Subcontas](https://docs.asaas.com/docs/subcontas.md)
* [Pague Contas](https://docs.asaas.com/docs/pague-contas.md)
* [Conta Escrow](https://docs.asaas.com/docs/conta-escrow-1.md)
* [Plugins/Módulos/Parceiros](https://docs.asaas.com/docs/pluginsmódulos.md)
* [Flapp Store](https://docs.asaas.com/docs/flappstore.md)
* [SDK](https://docs.asaas.com/docs/sdks.md)
* [Biblioteca de Erros](https://docs.asaas.com/docs/biblioteca-de-erros.md)