Taxes

Haven gives you first-class tools to collect, itemize, and report the lodging, sales, and occupancy taxes you owe — so direct bookings on your own site stay just as compliant as anything you sell on a major OTA, and your accountant has everything they need at filing time.

This article covers what Haven does for you, what you're responsible for, and how to use the AI Tax Assistant, the per-jurisdiction breakdown on every booking, and Payouts (Tax rules to configure, Tax obligations to report).

How Haven Handles Taxes — At a Glance

Configure unlimited tax lines per property — typically state + county + city, plus any tourism, lodging, or occupancy district that applies to your property. Each tax has its own rate, jurisdiction, and what it applies to (nightly only, nightly + fees, etc.).
Snapshotted at booking time — every reservation locks in the exact taxes that were active when the guest booked. Changing your rates later never alters past bookings.
Itemized for guests — guests see a clean total at checkout, with a one-click expand to view each jurisdiction (e.g. "Colorado State Sales Tax — 2.90%", "Eagle County Lodging — 1.90%"). This builds trust and removes the "junk fee" feeling.
Itemized in Stripe — every tax line becomes its own line item on the Stripe payment with the correct tax code, so Stripe's tax reports break down cleanly by jurisdiction. Your CPA can use these directly.
Itemized in Tax obligations — Haven aggregates tax collected by jurisdiction, by property, and by period (monthly / quarterly / annual) with one-click CSV exports and per-jurisdiction filing summaries.
AI Tax Assistant — optional. Suggests likely tax rates for your property's address with citations to official sources, so you can research faster. You always confirm each rate yourself before it's applied.

What Haven Does NOT Do

So there's no ambiguity:

Haven does not file or remit taxes on your behalf. You are the seller of the stay (the rental contract is between you and your guest); you remit your own lodging, sales, occupancy, and income tax to the relevant authorities.
Haven does not provide tax or legal advice. The AI Tax Assistant, the rate suggestions, the filing summaries, and any other guidance in the product are convenience tools, not professional advice. Confirm rates and filing obligations with your accountant or local tax authority.
Haven does not auto-detect tax law changes. When a jurisdiction changes its rate or adds a new tax, you update the rule and Haven applies it to new bookings going forward.

What Haven gives you is the infrastructure to collect the right amount, prove what you collected, and hand a clean filing summary to your accountant — without spreadsheets.

Configuring Taxes

Tax settings live in Host Dashboard → Payouts → Tax rules. That is the editor for every property and group. Edit Listing → Pricing still has a Taxes card, but it only links here — you add and edit rules on the Payouts tab, not in the listing editor.

Adding a Tax Rule

Open your Host Dashboard.
Go to Payouts.
Open the Tax rules subtab.
Find the property (or group) and click Manage.
Click Add tax rule.
Fill in:
- Display name — what guests see on their receipt (e.g. "Eagle County Lodging Tax").
- Jurisdiction — State, County, City, District, or Other.
- Rate — a percentage (e.g. 2.90%) or a flat per-night amount (e.g. $1.50 per night for some city occupancy taxes).
- Applies to — Nightly only, Nightly + fees, or Total pre-tax. (Most state sales taxes apply to "Nightly + fees" in lodging contexts; many county lodging taxes apply to "Nightly only". When in doubt, your CPA or the AI Tax Assistant can help.)
Save. The new line is active immediately for any new booking.

You can also search the host dashboard for "tax" — it opens this same Tax rules subtab.

You can have as many tax lines as your jurisdiction requires. Most US hosts end up with two to four (state + county, sometimes plus city, sometimes plus a tourism or lodging district).

Multi-Unit Site Inheritance

If your property belongs to a Multi-Unit Site, you can choose to inherit that site's tax setup or customize at the property level — the same pattern Haven uses for rental agreements and guest verification:

Inherit from site (default) — the property uses the multi-unit site's tax rules. Updates to the site propagate to every member property.
Customize for this property — flips the property to its own rule set. When you flip the toggle, Haven copies the inherited rules onto the property as a starting point, so you don't lose your work — you just edit a fork.

This keeps multi-property managers fast (one edit, many properties) and still lets a single property in a different city override safely.

AI Tax Assistant — How It Works

The AI Tax Assistant is opt-in. Click AI suggest rates in the tax-rules editor to use it.

You give it: your property's address.

It returns: a list of suggested tax rules with rates, jurisdictions, applies-to bases, and a citation link to the official source it pulled from (state Department of Revenue, county lodging authority, city ordinance, etc.). Each suggestion shows the source label (e.g. "CO Dept. of Revenue — Sales Tax Rate Lookup, retrieved May 18 2026") so you can verify before applying.

Important guardrails — these matter:

Suggestions are never auto-applied. You click ✓ on each line you want to add. You can edit any field before saving.
The AI proposes rates and citations only. Haven maps the jurisdiction code and the Stripe tax code from a curated internal registry — those are never invented by the model.
If the AI can't confidently identify a jurisdiction, the suggestion shows "unknown jurisdiction — manual entry required" and refuses to auto-create the rule. You'll see this rarely, mostly for newer occupancy districts or unincorporated areas.
Re-check rates yearly. Many jurisdictions change rates on January 1 or July 1. Haven flags rules that haven't been reviewed in a while in your Tax Setup Health card.

The Tax Assistant saves you the "what do I even Google" research time — it doesn't replace your accountant.

How Taxes Show Up to Guests

On the booking summary and confirmation, taxes appear as a single "Taxes" line by default with the total amount, and a chevron to expand the breakdown. Expanded view shows each tax line — name + amount — so a guest who wants to see "$28 Colorado State Sales Tax + $19 Eagle County Lodging" can. On mobile the breakdown is collapsed by default; on desktop and on the post-booking receipt page it's auto-expanded.

This itemization is also reflected on the Stripe receipt the guest receives by email, with each jurisdiction as its own line item.

How Taxes Show Up on Reservations (Hosts)

When you open a reservation in your dashboard, the price summary auto-expands the full tax breakdown. You'll see:

Each jurisdiction (name and rate or flat amount)
The taxable base it applied to
The amount collected
A link through to the corresponding Stripe line item

Past reservations always show what was collected at the time the guest booked — even if you've since updated your tax rules. That's the snapshot model: reservations are immutable.

Snapshot Behavior — What "Locked at Booking" Means

When a booking is created, Haven freezes:

The taxes that were active for that property on the check-in date.
Their rates, applies-to bases, names, and Stripe tax codes.
The taxable base components (how much of the night price, fees, etc. each tax applied to).

A few important consequences:

Rate changes don't break past bookings. If Eagle County raises its rate on July 1, a booking made June 1 for a December stay uses the rate that was active on the check-in date (December), per the legal standard for most lodging jurisdictions.
Refunds prorate proportionally. If you refund a guest, each tax line is refunded in proportion to the refunded base. The refund is emitted to Stripe with the same tax codes so reports reconcile.
Currency is locked at booking time. V1 supports USD; the snapshot records the currency for future-proofing.

Tax Obligations — Your Tax Reporting Hub

The Payouts tab on the host dashboard — specifically the Tax obligations subtab (alongside Payouts, Stats, and Tax rules) — is where Haven turns the tax data into something you can hand to your accountant or use to file directly.

Sections:

Tax obligations by jurisdiction — a card per jurisdiction (e.g. one card for Colorado state sales tax, one for each county) showing tax collected in the period, number of bookings and properties contributing, the typical filing cadence (monthly / quarterly / annual), and a one-click Generate filing summary PDF plus Export CSV.
Tax collected by property × jurisdiction — a matrix view that shows, at a glance, which of your properties contribute to which jurisdictions. Properties with zero tax collected anywhere are dimmed (a quiet nudge to review setup).
Per-booking ledger — full audit trail. Every booking with its gross, discounts, each tax line, Stripe fee, Haven fee, net to host, and a deep link to Stripe.
Payouts & deposits — reconciles tax collected against tax actually deposited to your bank, so you always know the cash position.
Tax documents & profile — your business name, mailing address, tax ID (encrypted at rest), and W-9 upload. Required before you can generate filing PDFs.
Filing deadlines — projects upcoming filings 12 months out from each rule's cadence. Subscribe to the calendar feed (.ics) to see "File CO state sales tax — Apr 20" alongside your regular calendar.

Everything aggregates across all your properties and uses each property's local time zone, so a booking that crosses midnight UTC never lands in the wrong calendar quarter.

Multi-Location Hosts

If you have properties in different cities, counties, or states, Tax obligations handles this seamlessly:

Every jurisdiction is a separate card. A host with a property in Colorado and one in Florida sees both jurisdictions side by side, each with its own cadence.
The matrix view shows which property contributes to which jurisdiction.
Each filing summary PDF is per jurisdiction + period, so you generate one PDF per filing, never a tangle of mixed totals.

Marketplace Facilitator States

A small number of US states (and a growing list internationally) require the platform — not the host — to collect and remit certain taxes directly. If you have a property in one of these jurisdictions, the relevant card on Tax obligations will show a "Remitted by Haven" badge instead of a filing button. Haven handles the remittance for that specific tax; you remain the seller of the stay for everything else.

This is a narrow exception, and it only applies where the law actually requires it. The default everywhere else is: you collect, you remit.

Tax Setup Health Warnings

Haven flags common configuration gaps so you don't discover them at filing time:

No tax rules configured — error.
Imported from legacy single tax rate — review setup — warning. Shown after a backfill from the older single-rate setting until you split it into the actual jurisdictions.
No state-level rule for a US property — warning.
Stale rates — last reviewed over a year ago — info.
Too many rules (>15) — warning, likely a misconfiguration.

Warnings appear on Tax rules, on Tax obligations, and in the calendar's compact Taxes summary card.

What Stripe Receipts Cover (and Don't)

The Stripe-hosted receipt the guest receives is a payment confirmation, with each tax as its own line item — useful for an auditor and good enough for a US guest in most cases.

It is not a jurisdictionally-compliant tax invoice in the EU VAT or AU GST sense (sequential invoice numbers, full seller business information, mandatory tax invoice headings). International compliant invoicing is on Haven's roadmap; if you need it today, work with your accountant to issue the formal invoice separately.

Frequently Asked

Does Haven file my taxes for me? No — except in the few marketplace facilitator jurisdictions where the law requires the platform to. Everywhere else, you remit. Haven gives you the data and the filing PDFs to do it cleanly.

Does Haven calculate taxes automatically based on my address? No. Automatic calculation services exist (Stripe Tax, Avalara) but they have inconsistent coverage for short-term rental occupancy and tourism taxes — accuracy isn't reliable enough to trust silently. Haven's approach is the opposite: you (or your accountant, or the AI Assistant) configure each tax explicitly, with citations, and Haven enforces it deterministically from then on.

What if my tax rate changes? Update the rule. New bookings use the new rate. Past bookings keep the rate that was active on their check-in date.

What if I have a property in a state where Haven is the merchant of record for tax? Tax obligations shows "Remitted by Haven" for that jurisdiction, and you'll see the amount Haven remitted on your behalf. You don't file for that specific tax.

Can I issue a refund and have the tax refunded? Yes. Refunds prorate the tax automatically and emit refund line items to Stripe with matching tax codes, so your reports stay clean.

How do I get my tax data into QuickBooks / Xero / my accountant's spreadsheet? Use the CSV export on Tax obligations — per-jurisdiction or per-booking. Both are accountant-friendly.

Does the AI Tax Assistant know my exact local rates? It looks up rates from official sources (state DOR, county lodging authorities, city ordinances) and shows you the citation. You confirm each one. Treat it as a research accelerator, not a tax engine.

Haven does not provide tax or legal advice. Configure your taxes based on guidance from your accountant or local tax authority, and use Haven's tools to collect, itemize, and report what you owe.