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.

Availability: Cloudbeds is enabled per account. If you don't see the Cloudbeds card on the New Integration page, contact FiscoBridge support to have it enabled for your account.

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.

Removing the Integration

1. Go to Integrations → Integrations

2. Click Remove next to the Cloudbeds integration

3. Confirm the removal

Removing the integration stops the sync. Previously fiscalized invoices are not affected.

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

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