Brazil: SageOne Nota Fiscal - Everything you Need to know


Cloudbeds now has an integration with Sage One’s Brazilian Notas Fiscais software. This allows properties to easily issue Notas Fiscais to their guests directly from within Cloudbeds on a reservation’s details page. It is an online service, so there’s no need to install anything on a computer.

Integration Details

  • Region Supported: Brazil
  • 'Nota Fiscal' is an official invoice in Brazil. It goes through government servers for validation.
  • Nota Fiscal Type: Only service Nota Fiscals are currently supported.
  • This is not an integration with Sage’s accounting software, payment gateways, or other software.

Sage One is integrated with the city government servers of more than 400 cities in Brazil, which makes this service usable for most subscribers with properties based in Brazil. The list of supported cities is here:

Connecting SageOne to myfrontdesk

Step 1 - Activation Process


In order to activate this service, you will have to:

  1. Activate the Nota Fiscal feature by contacting one of our Cloudbeds Market Managers. A fee (pricing being defined) will be added to your monthly subscription.
  2. Subscribe to Sage One separately, since they are a third-party service. The first 7 days are free for a trial account, so they can use these 7 days to complete an integration.
  3. Obtain a Security Certificate if they do not already have one. For service Notas Fiscais, it will need to be a type A1 to be compatible with Cloudbeds. Sage offers A1 certificates in a discount package only available to current Cloudbeds subscribers.
  4. Access the new Sage One account and fill out Company Info and Nota Fiscal Details
  5. Access our system’s Sage One Nota Fiscal integrations page and connect to Sage One account. Also, configure additional default information on this page.

Please, check all the details below

1.1. Activate the Feature

Contact your Cloudbeds Market Manager and request the Nota Fiscal Connection through Sage One. The corresponding fee will be added to your Cloudbeds monthly subscription. Our Customer Service team will then activate the feature and it will appear under your account’s settings menu.

If you do not have your Market Manager contact, please send an email to and our support team will help you.

1.2. Sign Up With Sage One

1 - Access this page: and create your new Sage One account.

You will have to fill your account information and accept the terms of usage. Sage One offers a 7 days free-trial.

Sage One is a service provided by a third-party. For help with setting up a Sage One account, please contact their support team.

2 - Next, send an email to Alessandra Quirino - to request more details about a full account. If (and only if) you mention you are a Cloudbeds customer at this moment, you will get access to special prices.

You can purchase a package that includes the security certificate or without it. If you get the package with the certificate, Sage will instruct you on how to proceed with documentation and validation (sometimes it requires a face-to-face visit to the certifier’s closest office).

If you live in a remote location, you may want to ask about those cities before purchasing the service or selecting the certifier.

1.3. Upload Certificate

Under your Sage One account, navigate to Settings (Configurações) > Certificado Digital (1). You will need the certificate file and its password.
After uploading the certificate (2), you will need to type the password and save (3).

You can get your certificate included in your package with Sage, or you can purchase from an independent certifier such as Certisign, Serasa, Valid, etc. 

Note: In order to get a certificate you will need to provide your company’s documentation and sometimes require a visit to their offices. The certifying company typically charges a yearly fee.

We recommend that those who don’t have a certificate, purchase the Sage One package that includes it since it has a very competitive price.

1.4. Configure your Sage One account

You can see more details about Sage One’s setup process in this video:

  1. Under Settings (Configurações), navigate to My Company (Minha Empresa), and fill out your company information.
  2. For Service Nota Fiscal (the case with our connection), you don’t need to fill out fields for NFC-e token and taxpayer code.
  3. If your company does not have a State Tax Code (Inscrição Estadual), you can leave it empty and it will register as exempt.

If your company allows issuing Notas Fiscais for products, Sage One allows that through their platform. Cloudbeds does not currently support nota fiscals for products, only service Notas Fiscais.

If your company is registered in a city that requests username and password for this type of connection (in addition to the certificate), please navigate to Settings (Configurações) > Nota Fiscal de Serviços and fill out that information.

On this page, you may also fill out tax information when needed (test it out, most cities have your tax settings registered with them so no need to fill these out manually here).

We recommend creating a preconfigured Service. This will allow you to set default information for your most common services, so you won’t need to fill out details all the time.

Navigate to Cadastros > Serviços > Create Service (Criar Serviço).

  1. Under Code (Código) field, define a number as a reference. You may start with 1 if you don’t have any service configured.
  2. Fill out the LC116 code (your accountant should be able to inform you that number). That number is only used in some cities. Usually, that number is ignored by cities that have their own service codes, which is our next field.
  3. Under City Service Code (Código Municipal do Serviço), you should fill out the code of the service in your city. If you’re used to issuing Notas Fiscais directly from the city portal, you probably have to select that from a drop-down every time you issue a Nota Fiscal. Usually, it also appears in the Nota Fiscal.
  4. Select any specific kind of taxation or exemption you have
  5. Set the default unit to “un”.
  6. The description is a reference for you when browsing through pre-defined services.

Now you are ready to use Sage One services. First, test out issuing a couple of Notas Fiscais directly at Sage.


After testing, make sure you Enable your Sage One account to Production, meaning that you are not in test mode anymore, so the real connection to the city government servers is activated. Please, contact SageOne support team for further information.

Step 2 - Connect your Cloudbeds account to your SageOne account

Follow the steps below to connect your SageOne account with myfrontdesk by Cloudbeds account. Go ahead and open another tab in your browser to start:

  1. Navigate to your Cloudbeds’ account settings menu
  2. Click on 'Nota Fiscal (Sage One)' page under Integrations section
  3. Click on “Connect Your Property With Sage One”.
  4. Sage One will request your permission to connect myfrontdesk to it. Click “Allow”

Wait a few seconds and your account should refresh, showing that the connection is active. 

You should now be able to see your Sage One account information (that you have just filled out in Sage One), and your default Nota Fiscal fields:

  1. “Unique Code” is the code you gave to your preset Service. If you are using the Unique Code, you may ignore the LC116 field now.
  2. The service description is just used internally for the pre-configured service as a reference name.
  3. Tax details can be filled if your city requests these and do not automatically fill them out (you will need to test to be sure).

These fields on this page are just default settings that will make your life easier by pre-populating the Nota Fiscal fields later. So, these are optional.

Set whether to generate Nota Fiscals as one of the following:

  • Live (Green): Process full Nota Fiscals through Sage. Recommended.
  • Draft (Grey): Save all Nota Fiscals inside Sage One and manually process them later.

You're done!

If needed, you also have the option to disconnect the app

Issuing Nota Fiscal

You can issue a Nota Fiscal at any moment for any reservation, be it before, during or after the guest’s stay, for any amount.
Navigate to an existing reservation:

  1. At the top right-hand corner, click on "Actions"
  2. Select “Generate Nota Fiscal” under Integrations section
  • You will then see a form with some fields already filled out - Guest information is filled out with Guest Name, email and address, if available.
  • If issuing the Nota Fiscal for a company, just type the CNPJ and the form will present additional fields specific to companies.
  • At this moment, you can modify the total amount, apply deductions (if you want them listed in the Nota Fiscal) and the description of the services, as they should appear in the Nota Fiscal.
  • You can modify the default tax definitions, LC116 code, and City Service Code. However, the easiest way to issue the Nota Fiscal here is to use one of the pre-configured services you already have. So, list the Service Unique Code in the Unique Code Field. Verify the amount and other information, then hit “Issue Nota Fiscal”.
  • The system might take a few seconds to reload the page since at this moment the information is being securely processed by Sage One and the city government’s portal. If any error occurs, the page will reload with the pre-filled data, so if you believe any information is incorrect, now is the time to fix it and try again.

If you navigate away from the Nota Fiscal form, the next time you try to issue a Nota Fiscal, the form will again be filled with only the available and default information - This tip is especially useful if you are issuing the Nota Fiscal in front of your guest who’s checking out. Make sure it goes through before closing the window, otherwise you may need to ask for his tax information all over.

Viewing Notas Fiscais
  1. All Notas Fiscais issued to a specific reservation can be viewed by clicking on the Documents tab, under the respective reservation
  2. By clicking on the document link, you will be taken to the Nota Fiscal details page at the Sage One portal. There, you can view and print the Danfe as needed.

3.    You may also navigate to your Cloudbeds account settings page for Nota Fiscal, and click on the History tab. There, you can see a complete list of all Notas Fiscais issued.

You may also check all issued Notas Fiscais from within your Sage One account.

Cancelling Notas Fiscais

Notas Fiscais need to be cancelled from directly inside of the Sage One portal.

  1. Log in to your Sage One account at and navigate to the main screen.
  2. On the right side of this page, you will see all Notas Fiscais issued. If you click on an authorized Nota Fiscal you will be taken to the details page.
  3. At the top, you will see a Cancel (Cancelar) button.
  4. Select the reason for cancellation if required by your city government and confirm.
  5. You may click on Check Cancellation (Checar Cancelamento) button to verify with city servers if the cancellation was successful.
  6. The tab on the right-hand corner of the details page should turn red and show that it was cancelled.

If you need additional help about pages within Sage One system, also check their tutorial videos and their automated support chat.

Contact Info

Please note that for any questions or issues regarding your Sage One account should be addressed to Sage’s support service:

Phone: +55 11 3004 3303 and accessing options 1,1 and 1 in the voice menu.

Alternatively, there are other support channels listed on this page:

Have more questions? Contact Support


Powered by Zendesk