Skip to main content

​
Frequently Asked Questions

​
Setup & Connection

The property isn’t fully configured. Go to Properties, select the property, and complete all four required fields:
  • Default Receipts Contact — a customer account in Elorus
  • Invoices Series — a document numbering series for invoices
  • Category — for the Climate Resilience Fee
  • Organization — which Elorus organization issues the documents
After clicking Save, bookings change from NEEDS_SETUP to READY on the next sync (within ~30 minutes).
Go to Settings → Integrations. Find the Hosthub connection and update the API key. Sync resumes normally without any data loss.
Yes. Go to Settings → Integrations → “New Connection” to add a new Elorus API key. Each property can then be independently assigned to a different Organization — useful if you manage properties under different tax IDs.

​
Failed Sends

The Default Receipts Contact configured for the property doesn’t exist or is inactive in Elorus. Check Elorus → Contacts to confirm the contact is active, then re-select it from Properties.
The Invoice and Receipt were issued successfully, but the Climate Resilience Fee document failed. Check:
  1. Whether the Category is correctly configured in Properties
  2. Whether the tax rules in Elorus are up to date
Contact support at support@etherly.app if the issue persists.
Document cancellation is done directly in your invoicing platform (e.g. Elorus). After cancelling there, the booking in Etherly Sync remains in SENT status. Contact support if you need the status reset for re-issuing.
The document remains valid — cancelling the booking does not automatically reverse it. The process is:
  1. Create a credit note in Elorus for the accommodation invoice
  2. If a Climate Resilience Fee document was also issued, cancel that separately — it is not reversed automatically
  3. The booking in Etherly Sync remains in SENT status — contact support if you need the status reset for re-issuing
For the correct credit note type and myDATA obligations, consult your accountant.
In order:
  1. Elorus API key — verify it’s still valid in Settings → Integrations
  2. Invoices Series — confirm the series is active in Elorus
  3. Organization — ensure the organization allows the document type
  4. Subscription — check your balance under Subscription
If none of the above resolves it, contact support with the error message.

​
Sync

Possible causes:
  • Hosthub API key expired or invalid — check Settings → Integrations
  • New bookings without a checkout date — they won’t appear until a checkout date is set in Hosthub
  • Hosthub API timeout — the system retries automatically, but contact support if it persists
Try a manual sync by clicking “Sync from Hosthub” in Bookings.
Cancellations are detected on the next sync (within ~30 minutes). Once detected, the booking is marked cancelled and removed from the invoicing queue. If it still shows as active after 15 minutes, click “Sync from Hosthub”.
No. Sync is one-directional — Etherly Sync fetches bookings from Hosthub but never deletes data due to a connection error. Bookings already synced remain safe.If sync fails temporarily:
  • The system retries automatically
  • New bookings created in the meantime are retrieved on the next successful sync
  • Booking changes (cancellations, date updates) are detected on the next sync
To trigger an immediate sync, click “Sync from Hosthub” on the Bookings page.

​
Climate Resilience Fee

If a booking crosses between the winter season (Nov 1 – Mar 31) and summer season (Apr 1 – Oct 31), the system:
  1. Calculates the nights per season
  2. Applies the correct rate for each season
  3. Creates separate fee documents — one per season
This happens automatically with no action required from you.
Fee amounts are set in the TCA Rules per organization, under Settings → Organizations. These correspond to tax codes you have created in Elorus. If the law changes, update both the tax codes in Elorus and the TCA Rules under Settings → Organizations.
Categories come from the tax codes you’ve set up in Elorus. If the right Category doesn’t appear, make sure you’ve created the corresponding tax code in Elorus. If you’re unsure which category applies, consult your accountant.

​
Auto-Invoicing

Possible causes:
  • No bookings were in READY status at the Execution time
  • Credits ran out — check Subscription
  • The account’s Grace Period had expired
  • A rare technical issue — contact support
Yes, anytime. Settings → Automatic invoicing → change the Execution time → Save. The change takes effect from the next execution.

​
Billing & Credits

The Free Trial Period lasts 30 days from account creation. The exact expiry date is shown under Subscription.
The Grace Period activates automatically — invoicing continues normally even with 0 credits. Once the Grace Period ends, new sends are blocked until you purchase credits under Subscription → “Buy Credits”.
Go to Subscription → Auto Top-up section → “Enable Auto Top-up”. Set the Top-up Threshold (e.g. 10 credits) and choose which package to purchase automatically. A saved card is required via “Add Card”.

​
Special Cases

Etherly Sync does not issue documents for zero-amount bookings. The send will fail or produce an empty document.If a document is needed for a complimentary stay:
  • Create it manually directly in Elorus
  • Whether a document is required and which type depends on your tax situation — consult your accountant
To keep the booking out of the invoicing queue, use Pause on the Bookings page.
General rule:
  • Private individual from abroad → Retail receipt (no tax ID required)
  • Company from abroad → Invoice (VAT Number or local tax ID required)
The document type is set per property under Properties → Document Type. For special cases (intra-EU B2B, specific tax exemptions, etc.), consult your accountant.

​
General

Contact us at support@etherly.app. We typically respond within 1-2 business days. In your message, include:
  • The property or booking experiencing the issue
  • The error message (if any)
  • The date you first noticed the problem