Brazil: SageOne Nota Fiscal - Connection Guide


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.

  • 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:

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 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 15 days are free for a trial account, so they can use these 15 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 Kelly Martins - 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 hire a package that includes the security certificate or one 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 these cities before hiring 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 certifier 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. 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 Sage 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. Clicl 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, remember? If you are using the Unique Code, you may ignore the LC116 field now.
  2. 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 these 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 also have the option to disconnect the app

You're done!

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