Documentation Index
Fetch the complete documentation index at: https://docs.etherly.app/llms.txt
Use this file to discover all available pages before exploring further.
Frequently Asked Questions
Setup & Connection
My bookings show NEEDS_SETUP status. What do I do?
My bookings show NEEDS_SETUP status. What do I do?
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
NEEDS_SETUP to READY on the next sync (within 5 minutes).My Hosthub API key has changed. How do I update it?
My Hosthub API key has changed. How do I update it?
Go to Settings → Integrations. Find the Hosthub connection and update the API key. Sync resumes normally without any data loss.
Can I have multiple Elorus organizations under the same account?
Can I have multiple Elorus organizations under the same account?
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 send fails with a contact error. What does that mean?
The send fails with a contact error. What does that mean?
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.
A booking shows SENT_WITH_ERRORS. What happened?
A booking shows SENT_WITH_ERRORS. What happened?
The Invoice and Receipt were issued successfully, but the Climate Resilience Fee document failed. Check:
- Whether the Category is correctly configured in Properties
- Whether the tax rules in Elorus are up to date
Can I cancel a document that was issued by mistake?
Can I cancel a document that was issued by mistake?
Document cancellation is done directly in Elorus — it’s not available through Etherly Sync. After cancelling in Elorus, the booking in Etherly Sync remains in
SENT status. Contact support if you need the status reset for re-issuing.A send keeps failing repeatedly. What should I check?
A send keeps failing repeatedly. What should I check?
In order:
- Elorus API key — verify it’s still valid in Settings → Integrations
- Invoices Series — confirm the series is active in Elorus
- Organization — ensure the organization allows the document type
- Credits — check your balance under Credits
Sync
Why aren't new bookings syncing?
Why aren't new bookings syncing?
Possible causes:
- Hosthub API key expired or invalid — check Settings → Integrations
- New bookings without a checkout date — they won’t appear until a date is set in Hosthub
- Hosthub API timeout — the system retries automatically, but contact support if it persists
A booking was cancelled in Hosthub but still shows as active. Why?
A booking was cancelled in Hosthub but still shows as active. Why?
Cancellations are detected on the next sync (within 5 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”.
Climate Resilience Fee
How does the fee calculation work for bookings spanning two seasons?
How does the fee calculation work for bookings spanning two seasons?
If a booking crosses between the winter season (Nov 1 – Mar 31) and summer season (Apr 1 – Oct 31), the system:
- Calculates the nights per season
- Applies the correct rate for each season
- Creates separate fee documents — one per season
What happens if the fee amounts change by law?
What happens if the fee amounts change by law?
Fee amounts are pulled from the tax codes in Elorus — they’re not hardcoded in Etherly Sync. If the law changes, simply update the amounts in Elorus and Etherly Sync retrieves them automatically on the next send.
I can't find the right Category for my property. What do I do?
I can't find the right Category for my property. What do I do?
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
Auto-invoicing didn't run last night. Why?
Auto-invoicing didn't run last night. Why?
Possible causes:
- No bookings were in
READYstatus at the Execution time - Credits ran out — check Credits
- The account’s Grace Period had expired
- A rare technical issue — contact support
Can I change the auto-invoicing execution time?
Can I change the auto-invoicing execution time?
Yes, anytime. Settings → Automatic invoicing → change the Execution time → Save. The change takes effect from the next execution.
Billing & Credits
When does my Free Trial Period end?
When does my Free Trial Period end?
The Free Trial Period lasts 30 days from account creation. The exact expiry date is shown under Credits.
What happens when my credits run out?
What happens when my credits run out?
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 Credits → “Buy Credits”.
How do I set up Auto Top-up so I never run out of credits?
How do I set up Auto Top-up so I never run out of credits?
Go to Credits → 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”.
General
I need help that's not covered here.
I need help that's not covered here.
Contact us at support@etherly.app. We respond within 1 business day. In your message, include:
- The property or booking experiencing the issue
- The error message (if any)
- The date you first noticed the problem