Creates or updates the account's tax information used to issue Service Invoices (NFS-e).
Use this operation after checking the municipality's requirements in List municipal configurations. The required data and credentials vary according to the city hall linked to the account's CNPJ.
Conditional fieldsSend only the credentials corresponding to the
authenticationTypereturned for the municipality.When
usesSpecialTaxRegimesindicates that a special tax regime is required, providespecialTaxRegimeusing a value available inspecialTaxRegimesList. WhenusesServiceListItemindicates this requirement, provideserviceListItem.
Invoice series
Provide the issuing series in rpsSerie. In Campinas/SP, Campo Grande/MS, João Pessoa/PB, Sorocaba/SP and Teresina/PI, the city hall requires a series between 10001 and 49999. Invoices issued with a series outside this range are rejected.
Default municipality of service provision
Use serviceProvisionCityDefaultType to define which city will be used by default when issuing NFS-e. The field is optional, so integrations that do not send it continue to work without changes.
| Value | City used |
|---|---|
MY_ACCOUNT_CITY | City of the Asaas account, corresponding to the service provider |
CUSTOMER_CITY | City of the customer, corresponding to the service recipient |
CUSTOMER_CITY_WHEN_ISS_IS_RETAINED | City of the customer when ISS is withheld. Otherwise, uses the city of the Asaas account |
When updating the tax information, if serviceProvisionCityDefaultType is not sent in the payload, the value already registered is kept.
An invalid value rejects the entire requestThe field accepts only the values defined in the enum. Invalid values, including an empty string or values with different uppercase/lowercase letters, such as
my_account_city, returnHTTP 400.In this case, the entire request is rejected and no field in the payload is saved, including other valid fields sent in the same request.
Example response for an invalid value:
{
"errors": [
{
"code": "parse_error",
"description": "O campo 'serviceProvisionCityDefaultType' informado é inválido."
}
]
}After saving the configuration, use Retrieve tax information to view the tax data currently registered in the account.