Update configuration for issuing invoices

Updates the automatic NFS-e issuance configuration linked to a subscription.

The new rules apply to upcoming payments and to payments that do not yet have an invoice created. Invoices that have already been issued are not modified.

When effectiveDatePeriod is BEFORE_PAYMENT_DUE_DATE, provide daysBeforeDueDate with one of the allowed values: 5, 10, 15, 30, or 60.

For ON_NEXT_MONTH, receivedOnly can restrict issuance to paid payments. When not provided, its default value is false.

⚠️

Updating the taxes object

The taxes object has full replacement semantics.

When you send it, provide the complete desired state of the taxes. Fields omitted within taxes are set to their default value, usually null, and the previous configuration is no longer preserved.

If you need to change only some of the taxes and keep the other values, first retrieve the current configuration and send the complete taxes object.

⚠️

PIS and COFINS

For accounts under the Regime Normal (standard tax regime) that issue NFS-e through the Portal Nacional, provide taxes.pisCofinsTaxStatus, taxes.operationPis, and taxes.operationCofins according to the applicable tax status.

Do not send taxes.pisCofinsRetentionType. The value is calculated automatically by Asaas.

Simples Nacional customers have no payload changes related to NT-007.

See the PIS/COFINS withholding and tax status settings.

If the subscription does not yet have an automatic issuance configuration registered, use Create configuration for issuance of invoices.

Related content

Guides

Path Params
string
required

Unique subscription identifier in Asaas

Body Params
number

Deductions. Deductions do not change the total value of the invoice, but they do change the ISS calculation basis.

string
enum

When the invoice will be issued

Allowed:
boolean

Issue only for paid charges

int32

Number of days before billing due date

string

Additional notes on the invoice

taxes
object
required

Invoice taxes

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