---
title: "How to issue NFS-e invoices automatically with Asaas"
description: "Turn on automatic NFS-e issuing under Integrations › Asaas › Invoices. For every paid ticket order or fan-club charge, Asaas issues the invoice on behalf of your company and sends it to the buyer."
url: "https://vaidebaila.app/en-us/help/organizer/integrations/issue-invoices-with-asaas"
lang: "en-US"
updated: "2026-11-13"
---

# How to issue NFS-e invoices automatically with Asaas

Turn on automatic NFS-e issuing under Integrations › Asaas › Invoices. For every paid ticket order or fan-club charge, Asaas issues the invoice on behalf of your company and sends it to the buyer.

> [!NOTE]
> **This is done in the organizer dashboard**
>
> Open the dashboard at [dashboard.vaidebaila.app](https://dashboard.vaidebaila.app). The vaidebaila.app website is where the public buys tickets; managing your events happens in the dashboard. When a step happens somewhere else, such as the check-in app, the article says where.



























If you sell through your own Asaas account (the BYOG model) and you have a company, Baila can ask Asaas for an **NFS-e** (the Brazilian electronic service invoice) for every paid sale, with no work on your side. **Asaas** issues the invoice on behalf of your company on the **National NFS-e Portal** (`Portal Nacional da NFS-e`). The buyer gets the invoice by e-mail, and you follow every invoice in the event's order list.

Invoices are **optional** and stay off until you turn them on. They never block a sale: if an invoice fails, the ticket is still issued and the sale is still paid.

## Watch the video

[![Video: turning on automatic invoices in Baila with Asaas (1 min 27 s, in Portuguese)](https://vaidebaila.app/help/asaas/nfse-video.webp)](https://www.youtube.com/watch?v=rZDN2SfPAYM)

The whole setup in a minute and a half, on Baila's YouTube channel (in Portuguese): [watch on YouTube](https://www.youtube.com/watch?v=rZDN2SfPAYM).

## Before you start

* **A company (CNPJ) Asaas account**, already connected to Baila. Asaas only issues NFS-e from company accounts. If your key belongs to a personal account, the section shows **Your Asaas account can't issue invoices**. If Asaas is not connected yet, see [How to connect my Asaas payment gateway](https://vaidebaila.app/en-us/help/organizer/getting-started/connect-asaas-gateway).
* **Your tax details filled in at Asaas.** At Asaas, under `Notas Fiscais › Configurações` (Invoices › Settings), you pick the National Portal and fill in your municipal registration, tax regime and National Portal access (A1 certificate or login). You do this once, at Asaas: see [Get Asaas ready to issue invoices](#get-asaas-ready-to-issue-invoices). Baila never sees your certificate or your city hall password.
* **Permission to manage payments.** Without it, the section is read-only.
* **A chat with your accountant.** You will need your service's national tax code and the ISS (municipal service tax) rate.

Asaas charges **R$ 0.49 per invoice** issued. Baila charges nothing extra.

> [!NOTE]
> Issuing works in cities that use the **National NFS-e Portal**, such as Manaus. If your city does not issue through the National Portal, check with Asaas before you turn invoices on.

## Get Asaas ready to issue invoices

You do this once, in the Asaas panel, and it is what lets Asaas issue invoices on behalf of your company. The Asaas panel is in Portuguese, so the labels below are in Portuguese, with a translation; the numbers in the screenshots show the order of the clicks. If you are unsure what to fill in, ask your accountant.

1. **Pick the National Portal.** In the Asaas side menu, open `Notas Fiscais › Configurações` (Invoices › Settings) (1). On the `Portal emissor` (issuing portal) tab (2), select `Portal nacional` (3).

   ![The Asaas panel, in Portuguese, on the invoice settings page: 1, the settings item in the side menu; 2, the issuing portal tab; 3, the National Portal option selected](https://vaidebaila.app/help/asaas/asaas-panel-fiscal-portal.webp)

2. **Fill in your company details.** On the `Informações da empresa` (company details) tab (1), click `Editar` (Edit) (2) and fill in the `Inscrição Municipal` (municipal registration) (3) and whether the company is `Optante pelo simples nacional` (on the Simples Nacional tax regime) (4). Save.

   ![The company details tab at Asaas, in Portuguese, with the company name, CNPJ and e-mail blurred: 1, the tab; 2, the Edit button; 3, the municipal registration field; 4, the Simples Nacional field](https://vaidebaila.app/help/asaas/asaas-panel-fiscal-company.webp)

3. **Give Asaas access to the National Portal.** On the `Dados de Acesso` (access details) tab (1), click `Editar` (Edit) (2) and upload your A1 `Certificado Digital` (digital certificate) with its password (3), the way Asaas recommends, or enter the **username and password** you use on the National Portal website (4). Save.

   ![The access details tab at Asaas, in Portuguese: 1, the tab; 2, the Edit button; 3, the digital certificate upload; 4, the National Portal username and password login](https://vaidebaila.app/help/asaas/asaas-panel-fiscal-access.webp)

Once this is done, Baila finds your tax details when you open the **Invoices** section in the steps below.

## Step by step

The screenshots below show the dashboard in Portuguese; in English the labels are the ones in bold.

1. **Open the Invoices section.** In the side menu, under **Settings**, open **Integrations** and click **Configure** on the **Asaas** card. Below **Ready to sell**, in the **Optional · not needed to sell** group, click **Invoices**. It also shows up as optional step 4 right after you finish connecting Asaas; to do it later, click **Not now**.

   Baila checks your tax details at Asaas. If something is missing, the section says what, with an **Open Asaas** button: fill it in there and click **Check again**.

2. **Choose which sales get an invoice.** Under **Issue invoices for**, leave **Tickets** on (one invoice per paid order), **Fan club** on (one invoice per paid membership charge), or both.

3. **Choose the ticket invoice amount.** **Ticket price only** is selected by default: the invoice leaves out the service fee and the installment interest. **Everything the buyer paid** uses the same amount as the Asaas charge. Ask your accountant which to use. The choice applies to future invoices.

4. **Fill in the code and the ISS rate.** In **National tax code**, enter your service's code on the National Portal, as `00.00.00`. In **ISS**, enter the rate in %, from 0 to 5. Your accountant sets both: for example, `12.13.01` is the code for producing events, shows and dance, but check with your accountant that it fits your case.

   ![The Invoices section in the Asaas window, shown in Portuguese: Tickets and Fan club switched on, the ticket invoice amount set to Ticket price only, national tax code 12.13.01 and ISS 2%](https://vaidebaila.app/help/asaas/nfse-form-en-us.webp)

5. **Description (optional).** In **Service description**, write the text printed on the invoice. `{event}` becomes the event name and `{date}` the date, for each sale. Leave it empty to use the default text.

6. **Turn it on.** Click **Turn on invoices**. The section now reads **On**, with what you chose (for example, **On · tickets and fan club**). From then on, your next paid sales get an invoice. Sales paid before you turned it on do not.

To change something later, open the same section, adjust it and click **Save**. To stop issuing, click **Turn off invoices**.

## Recommended: the invoice events on the webhook

Once invoices are on, the section shows **Tick the invoice events on the webhook**. With them, Asaas tells Baila as soon as an invoice is authorized, and the status reaches the order in seconds. Without them, Baila checks your invoices at Asaas every 15 minutes.

![The Recommended notice, shown in Portuguese: Tick the invoice events on the webhook, with INVOICE\_AUTHORIZED, INVOICE\_ERROR, INVOICE\_CANCELED and INVOICE\_CANCELLATION\_DENIED, the Copy button and the Done, check again link](https://vaidebaila.app/help/asaas/nfse-webhook-events-en-us.webp)

You do not create another webhook: the invoice events go on the same Baila webhook you created when you connected Asaas.

1. **Open Asaas's integrations.** At Asaas, click your profile icon in the top-right corner (1), then `Integrações` (Integrations) (2).

   ![The Asaas profile menu, in Portuguese, with the e-mail and bank details hidden: 1, the profile icon; 2, the Integrations item](https://vaidebaila.app/help/asaas/asaas-panel-user-menu.webp)

2. **Edit Baila's webhook.** Open the `Webhooks` tab (1) and click the pencil on Baila's webhook (2). In the form, click `Editar` (Edit) at the top. Do not change its URL or token.

   ![The Webhooks tab at Asaas, in Portuguese: 1, the Webhooks tab; 2, the pencil that edits Baila's webhook](https://vaidebaila.app/help/asaas/asaas-panel-webhooks-edit.webp)

3. **Tick the invoice events.** Scroll down to the `Notas fiscais` (invoices) group and tick `INVOICE_AUTHORIZED`, `INVOICE_ERROR`, `INVOICE_CANCELED` and `INVOICE_CANCELLATION_DENIED`. The **Copy** button in Baila's notice copies all four names. Leave the `Cobranças` (charges) events as they are.

   ![The invoices group of the webhook at Asaas, in Portuguese, with the four events ticked and highlighted: INVOICE\_AUTHORIZED, INVOICE\_CANCELED, INVOICE\_CANCELLATION\_DENIED and INVOICE\_ERROR](https://vaidebaila.app/help/asaas/asaas-panel-webhook-invoice-events.webp)

4. **Save and check.** Click `Salvar` (Save) at the top of the Asaas form. Back on Baila, click **Done, check again**. Once Baila finds the four events, the notice goes away.

## What changes at checkout

With invoices on, checkout for your events asks the buyer for the **ZIP code** (the Brazilian CEP) and the street **Number**, with a **No number** option and the hint **For your purchase's invoice.** The CPF is asked for as before. Organizers without invoices see no change at checkout.

![Checkout with Pix, shown in Portuguese: the CPF (blurred), ZIP code, Number, the No number option and the invoice hint](https://vaidebaila.app/help/asaas/nfse-checkout-en-us.webp)

> [!WARNING]
> Buyers on an older version of the Baila app do not see these fields. Their sale goes through as usual, but it gets no invoice.

## Follow invoices in your orders

When the payment lands, Asaas issues the invoice and e-mails the buyer the PDF and the XML. In the event, on the **Attendees** tab, the **Orders** list shows each sale's invoice status:

| Status                           | What it means                                                                               |
| -------------------------------- | ------------------------------------------------------------------------------------------- |
| **Issuing invoice**              | Asaas is issuing the invoice.                                                               |
| **Invoice issued · no.**         | The invoice was authorized. The **PDF** and **XML** links open the files.                   |
| **Invoice not issued**           | Asaas did not issue the invoice. The reason shows right below, with a **Try again** button. |
| **Cancelling invoice**           | The sale was refunded and Asaas is cancelling the invoice.                                  |
| **Invoice cancelled**            | Asaas cancelled the invoice.                                                                |
| **Invoice cancellation refused** | Asaas could not cancel the invoice. The reason shows right below.                           |

![The Orders list, shown in Portuguese, with each sale's invoice status: not issued with the reason and Try again, issued with the number and the PDF and XML links, and cancelled on a refunded sale](https://vaidebaila.app/help/asaas/nfse-orders-en-us.webp)

At Asaas, the same invoices show up under `Notas Fiscais › Todas` (Invoices › All), with each one's number, amount, issue date and status (`Emitida`, issued, or `Cancelada`, cancelled, for example).

![The list of all invoices at Asaas, in Portuguese, with the customer names blurred and the issued status highlighted on the latest invoice](https://vaidebaila.app/help/asaas/asaas-panel-invoices-list.webp)

## Refunds and cancellation

When you refund a sale that has an invoice, Asaas cancels the invoice. While Asaas processes the cancellation, the order shows **Cancelling invoice**; once it is done, **Invoice cancelled**. If Asaas cannot cancel it (for example, because of a city hall rule), the order shows **Invoice cancellation refused** with the reason: check the invoice at Asaas and, if needed, talk to your accountant.

For a Pix refund, Asaas may ask you to authorize the refund in your Asaas account. Until you do, the order stays at **Refund pending** and the invoice stays issued. The request shows at the top of the Asaas panel, under `Criação de reembolso de crédito Pix` (Pix refund creation) (1): click `Enviar código` (Send code) (2) and type the code Asaas texts you.

![The pending critical actions notice at the top of the Asaas panel, in Portuguese: 1, the Pix refund request; 2, the Send code button](https://vaidebaila.app/help/asaas/asaas-panel-pix-refund.webp)

## When an invoice fails

If Asaas refuses an invoice, the order shows **Invoice not issued** and the reason. You also get an e-mail from Baila with the reason Asaas gave, a link to Asaas and a link back to the **Invoices** section. We send this alert **at most once a day**, even if more invoices fail: every failed one shows up in your orders.

1. At Asaas, check `Notas Fiscais › Configurações` (see [Get Asaas ready to issue invoices](#get-asaas-ready-to-issue-invoices)), and check your tax code and ISS rate with your accountant.
2. Fix what is needed at Asaas or in Baila's **Invoices** section.
3. Go back to the order and click **Try again**. The new attempt uses your current settings.

## Frequently asked questions

* **Does Baila issue the invoice?** No. Asaas issues it on behalf of your company. Baila only asks for the invoice on each paid sale and shows the result. The tax side of your sales is still your responsibility: agree on the code, the ISS rate and the invoice amount with your accountant.
* **What about the Baila 3% fee?** The automatic invoice is for your sales to your buyers. It does not cover the Baila fee.
* **Does it work for past sales?** No. Only sales paid after you click **Turn on invoices** get an invoice.
* **Do I need it to sell?** No. Without invoices, you sell as usual.
* **Do I need another webhook at Asaas for invoices?** No. Tick the invoice events on the same Baila webhook, under `Integrações › Webhooks` (see [the invoice events on the webhook](#recommended-the-invoice-events-on-the-webhook)).
* **Where do I see the invoices at Asaas?** Under `Notas Fiscais › Todas` (Invoices › All). Every invoice Baila asks for shows up there, with its status.
* **Where does the digital certificate go?** At Asaas, under `Notas Fiscais › Configurações › Dados de Acesso`. It stays at Asaas only: Baila never receives the certificate or its password.

## Related articles

* [How to connect my Asaas payment gateway](https://vaidebaila.app/en-us/help/organizer/getting-started/connect-asaas-gateway)
* [How to refund a buyer from the dashboard](https://vaidebaila.app/en-us/help/organizer/finance-and-refunds/refund-buyer-from-dashboard)
* [What the Baila 3% fee is and when it is charged](https://vaidebaila.app/en-us/help/organizer/finance-and-refunds/vaidebaila-3-percent-fee)
* [How plugins work in Integrations](https://vaidebaila.app/en-us/help/organizer/integrations/plugin-marketplace)

*Updated on 11/13/2026*
