Atualizar nota fiscal

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.

Path Params
string
required
Body Params
string
string
string
number
number
date
boolean
taxes
object
Responses

404

Not found

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json