Endpoint utilizado para alterar uma nota fiscal que ainda não foi emitida.

A atualização só é permitida quando a nota está com status:

• SCHEDULED
• ERROR

Parâmetro de rota

• id - Identificador único da nota fiscal no Asaas.

🚧

Importante

Apenas notas fiscais ainda não emitidas podem ser atualizadas.

• Notas com status diferentes de SCHEDULED ou ERROR não permitem alteração.
• Após a emissão definitiva da nota fiscal, os dados deixam de ser editáveis.

Campos que podem ser atualizados

• serviceDescription - Descrição dos serviços.

• observations - Observações adicionais.

• externalReference - Identificador da nota no seu sistema.

• value - Valor total da nota.

• deductions - Valor das deduções.

• effectiveDate - Data prevista para emissão.

• updatePayment - Indica se a cobrança vinculada deve ser atualizada com os impostos descontados.

• taxes - Objeto com os impostos da nota fiscal.

Casos de uso

Esse endpoint é útil para:

• corrigir dados antes da emissão definitiva
• ajustar valores ou deduções
• alterar descrições e observações
• atualizar informações tributárias antes do processamento

📘

Retenção e situações tributárias

Os atributos taxes.pisCofinsRetentionType e taxes.pisCofinsTaxStatus são obrigatórios apenas para clientes não optantes pelo Simples Nacional que emitem via Portal Nacional.

Para mais detalhes sobre os tipos de retenção e situações tributárias aceitas, acesse a documentação de Configurações de retenção e situação tributária.

⚠️

Breaking Change: Novas regras de PIS/COFINS a partir de 30/06/2026 (NT-007)

A partir de 30/06/2026, as novas regras de PIS/COFINS serão aplicadas automaticamente nas emissões de NFS-e para clientes do Regime Normal (Simples Nacional não é impactado).
Para antecipar a mudança, utilize useTaxSystemReformNT007: true.

Veja o comunicado completo aqui.