DiscordStatus
Guias / Guides

Emitir notas fiscais automaticamente para assinaturas

Ao criar uma configuração de emissão automática de notas fiscais para uma assinatura, o Asaas passará a gerar automaticamente as notas fiscais das cobranças pertencentes àquela assinatura, utilizando as regras definidas nessa configuração.

POST /v3/subscriptions/{id}/invoiceSettings
Confira a referência completa deste endpoint.

A configuração é aplicada às cobranças da assinatura conforme as regras de emissão definidas e permite automatizar todo o processo de emissão de notas fiscais recorrentes.

Quando utilizar

Esta funcionalidade é recomendada quando sua integração precisa:

  • emitir automaticamente notas fiscais para cobranças recorrentes;
  • automatizar processos fiscais de assinaturas;
  • reduzir intervenções manuais na emissão de notas;
  • manter o faturamento sincronizado com as cobranças da assinatura.

Como funciona

Após criar a configuração:

  1. a assinatura permanece ativa normalmente;
  2. novas cobranças continuam sendo geradas conforme a recorrência;
  3. as notas fiscais passam a ser emitidas automaticamente de acordo com o período configurado.

Fluxo simplificado:

Criar assinatura
        ↓
Configurar emissão automática
        ↓
Gerar cobrança
        ↓
Emitir nota fiscal
automaticamente

Caso a assinatura já possua cobranças criadas, somente aquelas compatíveis com a configuração serão consideradas para emissão.

Períodos disponíveis

Os períodos de emissão disponíveis são:

  • ON_PAYMENT_CONFIRMATION — emissão somente após a confirmação do pagamento da cobrança.
  • ON_PAYMENT_DUE_DATE — emissão na data de vencimento da cobrança.
  • BEFORE_PAYMENT_DUE_DATE — emissão 5, 10, 15, 30 ou 60 dias antes do vencimento.
  • ON_DUE_DATE_MONTH — emissão no primeiro dia do mês do vencimento.
  • ON_NEXT_MONTH — emissão no primeiro dia do mês seguinte ao vencimento.

Serviço municipal

A configuração pode utilizar:

  • municipalServiceId, quando o município disponibiliza os serviços cadastrados na API;
  • municipalServiceCode, quando o código precisa ser informado manualmente.

O identificador do serviço pode ser obtido através da API de Serviços Municipais.

Caso o município não disponibilize essa listagem, utilize o código informado pela própria prefeitura.

Exemplo de configuração

Um cenário comum consiste em configurar uma assinatura para emitir automaticamente a nota fiscal sempre após a confirmação do pagamento.

Fluxo:

Criar assinatura
        ↓
Criar configuração
de emissão automática
        ↓
Cobrança paga
        ↓
Nota fiscal emitida
automaticamente

Esse comportamento elimina a necessidade de solicitar manualmente a emissão da nota a cada cobrança da assinatura.

Regras importantes

🚧

Atenção

  • Caso seja utilizado BEFORE_PAYMENT_DUE_DATE, o campo daysBeforeDueDate torna-se obrigatório.
  • Os valores aceitos para daysBeforeDueDate são apenas: 5, 10, 15, 30 ou 60.
  • O campo receivedOnly é utilizado apenas quando effectiveDatePeriod for ON_NEXT_MONTH.
  • Caso receivedOnly não seja informado, será considerado false.

Boas práticas

📘

Recomendado

  • Valide previamente se a conta possui emissão de notas fiscais habilitada.
  • Utilize o serviço municipal correto para evitar recusas na emissão.
  • Revise a configuração antes de alterar uma assinatura já em operação.
  • Acompanhe os Webhooks e o status das notas fiscais para identificar eventuais falhas.
  • Em caso de alteração da regra de emissão, valide se as cobranças existentes serão afetadas conforme esperado.

Possíveis dificuldades

Caso a nota fiscal não seja emitida conforme esperado, verifique:

  • se a assinatura possui configuração de emissão cadastrada;
  • se o período de emissão foi configurado corretamente;
  • se o serviço municipal informado é válido;
  • se os parâmetros obrigatórios foram enviados;
  • se a conta possui emissão de notas habilitada.

Impactos operacionais

A configuração passa a automatizar a emissão das notas fiscais das cobranças da assinatura conforme o período escolhido.

Por esse motivo, integrações que realizam:

  • conciliação fiscal;
  • acompanhamento de notas emitidas;
  • integração com ERPs;
  • processamento de Webhooks;

devem considerar que novas notas fiscais poderão ser geradas automaticamente sempre que novas cobranças forem criadas ou atingirem o momento definido para emissão.

Próximos passos

Após configurar a emissão automática de notas fiscais para assinaturas, recomendamos consultar:

  • Criar assinatura.
  • Atualizar assinatura.
  • Listar cobranças da assinatura.
  • Serviços Municipais.
  • Emissão de Notas Fiscais.
  • Webhooks de Nota Fiscal.