post
https://api-sandbox.asaas.com/v3/fiscalInfo/nationalPortal
Endpoint used to enable or disable the use of the National Portal as the invoice issuer.
Request parameters
-
enabled- Defines whether the National Portal will be used for issuance.- When
true, the account starts using the National Portal. - When
false, the account returns to the previous flow, according to the municipality availability and fiscal configuration.
- When
Impacts of this change
When changing the issuing portal, part of the fiscal configuration may be removed and need to be filled in again, including:
- access data, such as login, password, or digital certificate
- service information used during issuance
AttentionWhen the account uses the National Portal, the municipal services list is no longer available through the API.
- In this scenario, the service code must be manually informed when scheduling the invoice using the
municipalServiceCodefield.- Changing the issuing portal may require a new fiscal configuration for the account.
- It is recommended to validate all fiscal information after changing the issuing portal.
Importance of the configuration
This endpoint is important to adapt the integration to the issuance model used by the account.
Attention
- When changing your invoice issuing portal, some of your Fiscal Information settings will be removed so they can be filled in again according to the new issuing portal. The Login and Password or Digital Certificate in the Access Data section, as well as the Service Code in Services, will also be removed and must be provided again. Learn more.
- If you use the National Portal for Service Invoice issuance, it will no longer be possible to retrieve the municipal services list through the API. In this case, it is necessary to directly provide the service code when scheduling the invoice. Access our guide for more details.
