> ## Documentation Index
> Fetch the complete documentation index at: https://hostledger.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Posting to QuickBooks

> How Host Ledger posts payouts to QuickBooks Online.

## How posting works

When you click **Post to QuickBooks**, Host Ledger sends a fully categorized, split deposit directly to QuickBooks Online via the QBO API. Each deposit contains one line item per payout category — accommodation, cleaning, host service fee, occupancy tax, and so on — all mapped to the correct accounts in your chart of accounts.

If you've assigned QuickBooks classes to your properties, each line item is tagged automatically for per-property P\&L tracking.

The deposit is designed to match against the corresponding bank deposit that QuickBooks pulls in from your bank feed — so reconciliation is a one-click match, not a manual exercise.

***

## How to post

From the Home screen, click **Post to QuickBooks** to send all payouts in the Ready to Post bucket to QuickBooks at once. You can also post individual payouts from the payout detail page.

Your full payout history — posted, pending, and rejected — is always available on the **Payouts** page.

***

## Matching in QuickBooks

Once a payout is posted, head to QuickBooks to complete the match:

<Steps>
  <Step title="Open Banking">
    In QuickBooks, go to **Banking** to open your bank feed.
  </Step>

  <Step title="Find the deposit">
    Locate the bank deposit from your OTA payout.
  </Step>

  <Step title="Review the deposit">
    QuickBooks will surface a **Match** suggestion pointing to the deposit Host Ledger just posted. Before confirming, open the deposit and review the line items — verify the amounts, accounts, and categories look correct. It's always worth a quick check before anything hits your books.
  </Step>

  <Step title="Confirm">
    Click **Match** — done. The deposit is reconciled with the full category breakdown intact.
  </Step>
</Steps>

<Warning>
  Host Ledger automates the categorization and posting, but always review the deposit details before completing the match in QuickBooks.
</Warning>

***

## If you need to undo a post

If you posted something incorrectly, you can remove it from QuickBooks directly from Host Ledger:

1. Go to the **Payouts** tab
2. Find the payout you want to undo
3. Click **View Details**
4. Click **Unpost** — this removes the deposit from QuickBooks

Once unposted, make your corrections and post again.

Host Ledger stores the QuickBooks transaction ID and a direct link to every posted deposit so you can always find it later.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Post failed: QuickBooks connection expired">
    Your OAuth token expired. Go to **Settings → QuickBooks** and reconnect.
  </Accordion>

  <Accordion title="Post failed: Missing account mapping">
    A payout category doesn't have a QuickBooks account mapped. Go to the payout detail page, follow the link in the flag message to **Settings → Account Mappings**, add the missing mapping, and reinterpret.
  </Accordion>

  <Accordion title="Post failed: Missing vendor mapping">
    QuickBooks deposits require a "Received From" vendor. Go to **Settings → Vendor Mappings** and map the OTA to a QuickBooks vendor, then reinterpret.
  </Accordion>

  <Accordion title="The deposit isn't showing as a match in QuickBooks">
    Make sure your bank account in QuickBooks matches the Payout Bank Account you've configured in **Settings → Account Mappings**. If they're pointing to different accounts, the match won't surface.
  </Accordion>
</AccordionGroup>