Endpoint used to update an invoice that has not yet been issued.
Updates are only allowed when the invoice has one of the following statuses:
SCHEDULEDERROR
Path parameter
id- Unique identifier of the invoice in Asaas.
ImportantOnly invoices that have not yet been issued can be updated.
- Invoices with statuses different from
SCHEDULEDorERRORcannot be modified.- After the invoice is definitively issued, its data becomes non-editable.
Fields that can be updated
-
serviceDescription- Description of the services. -
observations- Additional observations. -
externalReference- Invoice identifier in your system. -
value- Total invoice amount. -
deductions- Deduction amount. -
effectiveDate- Expected issuance date. -
updatePayment- Indicates whether the linked payment should be updated with the deducted taxes. -
taxes- Object containing the invoice taxes.
Use cases
This endpoint is useful for:
- correcting data before final issuance
- adjusting values or deductions
- changing descriptions and observations
- updating tax information before processing
Retention and tax situations
The attributes
taxes.pisCofinsRetentionTypeandtaxes.pisCofinsTaxStatusare mandatory only for companies not enrolled in the Simples Nacional regime that issue invoices through the National Portal.For more details about the accepted retention types and tax situations, access the documentation for Retention and tax situation settings.
Not found