Connecting Cloudbeds

Cloudbeds is a hotel and hospitality PMS. FiscoBridge connects to it through OAuth — you sign in securely to Cloudbeds and we never see your password. Once connected, guest folios from your Cloudbeds property are automatically fiscalized: signed with your fiscal certificate and reported to the tax authority.

Before you start: you need a FiscoBridge account with an active integration license, a PFX fiscal certificate issued by your tax authority, and Cloudbeds enabled on your account. If the Cloudbeds card isn't on the New Integration page, email contact@fiscobridge.com and we'll enable it.

Signing Up for FiscoBridge

1. Go to fiscobridge.com and click Login, then Register — an email address, your name and a password are all that's needed. See Creating an Account.

2. Choose an Integrations plan and complete checkout. Plans are sized by invoices per month, and displayed prices include VAT/sales tax. See Buying a License.

3. Request your fiscal certificate from your tax authority — you upload it during integration setup. See Requesting a Digital Certificate.

4. Sign in to the Client Portal at client.fiscobridge.com and follow the steps below.

To try the connection before it affects anything, set it up with Training mode on — folios are then fiscalized as training invoices rather than real ones. Live fiscalization requires a paid plan.

Setting Up the Connection

1. Go to Integrations → Integrations in the sidebar

2. Click Create Integration

3. On the New Integration page, select the Cloudbeds card

4. An Upload Certificate dialog opens — select your PFX certificate file and enter its password, then click Upload

5. After the certificate is uploaded, the Connect Cloudbeds dialog opens. Choose:

   • Fiscalize invoice — when folios from Cloudbeds should be fiscalized (see Fiscalization Trigger below)

   • Training mode (test invoices) — leave off for live use (see Training Mode below)

6. Click Connect

7. You'll be redirected to Cloudbeds — log in and authorize FiscoBridge

8. You'll be redirected back to the Client Portal

Once authorized, the Cloudbeds integration appears in your integrations list with status Active.

Note: Your property is detected automatically from the Cloudbeds account you authorize with — there is no property selection step. Each connection covers one property. To fiscalize for several properties, create a separate integration (with its own certificate) and authorize each one with a Cloudbeds account belonging to that property.

Fiscalization Trigger

When you connect Cloudbeds, you decide at what point each folio should be fiscalized. There are two options:

When the guest checks out (default)

The folio is fiscalized once the reservation is checked out — or its balance reaches zero, whichever comes first.

• Best for the standard hotel flow: the fiscal receipt reflects the completed stay

• Folios of in-house guests are left alone until checkout

When the folio is created

The folio is fiscalized as soon as FiscoBridge is notified about it, without waiting for checkout.

• Best when you need the fiscal receipt issued upfront

• Changes made to the folio after fiscalization are not re-fiscalized automatically

Note: To change the trigger later, reconnect the Cloudbeds integration and pick the other option in the Connect Cloudbeds dialog.

Training Mode

With Training mode on, folios are fiscalized as Training invoices instead of Normal ones. Training invoices are marked "NOT A FISCAL INVOICE" and are ideal for testing the connection before going live. Turn it off (by reconnecting with the toggle off) once you're ready for real fiscalization.

Important: Training invoices still count toward your plan's monthly invoice limit. See Invoice Limits and Usage.

What Gets Synced

For each fiscalized folio:

• Room charges become line items — the room or room-type name, number of nights as the quantity, and the room rate as the unit price

• The guest's tax ID (if present on the reservation) is carried as the buyer ID on the fiscal receipt

• The payment is recorded as a single payment of type Other for the folio total

• The issue date is the checkout date

Tax Labels

Every invoice FiscoBridge fiscalizes is reported to the tax authority system, which recognises a fixed set of tax labels — single letters such as A, E, F — and ties each one to a rate (for example Fiji's A · 9% VAT, Samoa's A · 15% VAGST, or Vanuatu's V · 15% VAT). Those labels are the only tax categories the tax authority will accept on a fiscal receipt.

When a folio comes from Cloudbeds, FiscoBridge maps each charge's Cloudbeds tax onto one of those tax labels. It does this by name — so your Cloudbeds taxes have to carry names that match the tax labels exactly.

Tax labels by country

The labels and rates depend on the country your certificate was issued for:

Fiji

Samoa

Vanuatu

Setting it up in Cloudbeds

1. In Cloudbeds, go to your property's Taxes & Fees settings

2. For each tax label you use, open or create a tax

3. Set its name to the tax label letter, exactly: A, E, V, …

4. Set the rate to the rate the tax authority uses for that label (e.g. 9% for Fiji's A · 9% VAT)

5. Make sure every room rate and charge has a tax assigned

Matching is case-insensitive, but otherwise the name must be the label and nothing else — A matches, VAT A or Standard (A) does not.

Match the rate, not just the name. The label letter is what links the charge to the tax authority's category, but you should also set the tax rate to match the tax authority's rate for that label. If the names line up but the percentages differ, your Cloudbeds totals will no longer reconcile with the fiscal receipt.

What happens if a label doesn't match

If any charge on a folio uses a tax that doesn't map to a tax label — or has no tax assigned at all — the whole folio is not fiscalized. It is not sent to the tax authority, and FiscoBridge posts a note on the Cloudbeds reservation explaining which taxes couldn't be mapped, so you can rename them and have the folio processed again.

The Integrations page in the Client Portal also flags any active Cloudbeds integration whose taxes don't match, with a Tax labels warning and a Re-check button.

What FiscoBridge Writes Back

After a folio is fiscalized, FiscoBridge writes the result back to the Cloudbeds reservation:

• A reservation note with the fiscal invoice number, total, and the tax authority verification link

• A PDF document attached to the reservation containing the fiscal journal (the receipt) with the verification QR code

If fiscalization fails, a reservation note explains the reason instead. See Troubleshooting Failed Integration Invoices.

Sync Timing

Cloudbeds notifies FiscoBridge about reservations in near real-time. As a safety net, FiscoBridge also checks your property every 15 minutes for newly checked-out reservations, so a folio is never missed even if a notification doesn't arrive.

Note: With the trigger set to When the folio is created, fiscalization relies on real-time notifications only.

Limitations

• One property per connection. The property is taken from the Cloudbeds account you authorize with. A group account is supported by creating one integration per property, each with its own certificate — a single connection cannot cover several properties.

• Cloudbeds taxes must be named as tax labels. If any charge on a folio uses a tax that doesn't map to a label, the whole folio is not fiscalized. See Tax Labels.

• Changes after fiscalization are not re-sent. Once a folio has a fiscal receipt, editing it in Cloudbeds does not produce a new one.

• Monthly invoice limits apply. Reaching your plan's limit blocks further fiscalization until you upgrade — there is no overage billing, so size your plan for your busiest month. Training invoices count toward the limit as well.

Disconnecting

You can end the connection from either side. Either way, syncing stops and invoices already fiscalized stay in your history and with the tax authority — disconnecting never withdraws a fiscal receipt.

From FiscoBridge

1. Go to Integrations → Integrations

2. Click Remove next to the Cloudbeds integration

3. Confirm the removal

FiscoBridge discards the stored Cloudbeds authorization and stops checking your property, so no further folios are fiscalized.

From Cloudbeds

1. In Cloudbeds, open the Account Menu → Apps & Marketplace → Connected Apps

2. Find FiscoBridge in the list, click Disconnect and confirm

Cloudbeds' own instructions: How to disconnect an app from Cloudbeds PMS.

Disconnecting in Cloudbeds revokes FiscoBridge's access to the property. Reservation notifications stop, FiscoBridge can no longer read your folios, and nothing further is fiscalized. Also click Remove on the integration in the Client Portal so it stops counting against your connection allowance. To start again later, create the integration and authorize it again. FiscoBridge then resumes from where it left off, so folios that checked out while you were disconnected can still be fiscalized on the next check.

Troubleshooting

Folios not being fiscalized?

• Check that the integration status is Active

• Look for a Tax labels warning on the Integrations page — unmapped taxes block fiscalization

• Check the Cloudbeds reservation's notes — FiscoBridge posts the failure reason there

• Ensure your integration license is active and within its invoice limit

Wrong property connected?

• Remove the integration and create a new one, authorizing with a Cloudbeds user that belongs to the correct property

Getting Support

• Email — contact@fiscobridge.com. Include your Cloudbeds property name, the reservation ID, and the integration UID from the Integrations page so we can trace the folio.

• Help centre — help.fiscobridge.com has guides for every FiscoBridge product.

• Check the reservation first — when a folio fails, FiscoBridge writes the reason as a note on the Cloudbeds reservation. Troubleshooting Failed Integration Invoices explains what each note means.

Next Steps

• Troubleshooting failed invoices — What error notes mean and how to fix them

• Invoice limits and usage — How monthly invoice limits work

• Manage integrations — View and manage all your connections

• Integrations Overview — Learn about other supported platforms