Guia de Assinaturas

Confira o guia de assinaturas para mais informações.

Endpoint responsável por remover a configuração de emissão automática de notas fiscais de uma assinatura.

Após a remoção, novas cobranças geradas por essa assinatura deixarão de possuir emissão automática de notas fiscais até que uma nova configuração seja criada.

Além disso, todas as notas fiscais que ainda estiverem apenas agendadas para emissão serão canceladas automaticamente.

Quando utilizar

Utilize este endpoint quando sua integração precisar:

• interromper a emissão automática de notas fiscais de uma assinatura;
• remover uma configuração fiscal que não será mais utilizada;
• alterar completamente a estratégia de emissão, criando posteriormente uma nova configuração;
• impedir que futuras cobranças da assinatura gerem notas fiscais automaticamente.

Caso o objetivo seja apenas alterar parâmetros da configuração atual, utilize o endpoint Atualizar configuração para emissão de Notas Fiscais.

Parâmetro importante

Este endpoint possui apenas um parâmetro obrigatório:

• id — identificador único da assinatura cuja configuração de emissão será removida.

Como funciona

Após localizar a assinatura informada, o Asaas remove a configuração de emissão automática vinculada à recorrência.

Fluxo simplificado:

Assinatura
        ↓
Remover configuração
        ↓
Cancelar notas agendadas
        ↓
Interromper emissões futuras

Comportamentos importantes

Ao remover a configuração:

• todas as notas fiscais que ainda estiverem apenas agendadas serão canceladas;
• notas fiscais já emitidas não são alteradas;
• novas cobranças continuarão sendo criadas normalmente pela assinatura;
• apenas a emissão automática das notas fiscais será interrompida;
• para voltar a emitir notas automaticamente será necessário criar uma nova configuração.

Exemplo de uso

Remover a configuração de emissão automática:

DELETE /v3/subscriptions/{id}/invoiceSettings

Fluxo típico:

Assinatura ativa
        ↓
Remover configuração
        ↓
Novas cobranças continuam sendo geradas
        ↓
Nenhuma nova nota fiscal será emitida automaticamente

Boas práticas

Erros comuns

400 Bad Request

Pode ocorrer quando o identificador informado é inválido.

401 Unauthorized

Ocorre quando a API Key é inválida ou pertence ao ambiente incorreto.

404 Not Found

Ocorre quando a assinatura não existe, não pertence à conta autenticada ou não possui configuração de emissão cadastrada.

Impactos operacionais

A remoção da configuração não altera a assinatura nem as cobranças já existentes.

Entretanto:

• notas fiscais futuras deixarão de ser emitidas automaticamente;
• notas fiscais agendadas serão canceladas;
• caso a empresa continue obrigada a emitir NFS-e, uma nova configuração deverá ser criada antes da geração das próximas cobranças.

Conteúdos relacionados

• Criar configuração para emissão de Notas Fiscais
• Recuperar configuração para emissão de notas fiscais
• Atualizar configuração para emissão de Notas Fiscais
• Listar notas fiscais das cobranças de uma assinatura
• Guia de Assinaturas