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 |
| Configurar os dados fiscais exigidos pelo município | Configurar informações fiscais |
| Agendar e emitir uma NFS-e | Emitindo notas fiscais de serviço |
| Adequar a integração aos campos de IBS/CBS | Adequando sua integração à Reforma Tributária |
| Configurar PIS/COFINS para os cenários aplicáveis | Configurações de retenção e situação tributária de PIS/COFINS |
| Acompanhar emissão, cancelamento ou falhas | Eventos 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 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
- Configurar informações fiscais para emissão de Nota Fiscal
- Agendar uma Nota Fiscal vinculada a uma cobrança
- Adequar a emissão de Nota Fiscal à Reforma Tributária (IBS/CBS)
Referência da API
Consulte a API Reference para os contratos completos dos endpoints:
- Listar configurações municipais
- Criar e atualizar informações fiscais
- Listar serviços municipais
- Agendar nota fiscal
Próximos passos
Updated 16 days ago