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

# Inventory Trust

> How Hoard separates what it can see from what only you can see — and how to tell when a listing might be a ghost.

Hoard's job is to read your inventory, reconcile what it sees against the sales it can match, and tell you when something doesn't add up. Hoard doesn't claim to know what's physically on your shelf. You do.

This page explains how that boundary works in practice, what the dashboard shows you, and what to look at when you think a listing might be wrong.

## The principle

* **Hoard reads.** Every sync captures the state TCGplayer reports.
* **Hoard reconciles.** When a quantity drops, Hoard tries to match it to a sale you actually made.
* **Hoard reports.** The dashboard shows you what's confirmed, what's still settling, and what looks suspicious.
* **You own the physical truth.** Hoard never claims a listing reflects what's in your bins. Only a physical count tells you that.

Price changes get pushed back to TCGplayer through your agent. Inventory changes (delisting, quantity edits) stay between you and TCGplayer. Hoard observes them; Hoard does not initiate them.

## The three states of a card

Every card in your inventory sits in one of three states. The cards table shows them implicitly — the Audit filter and the confirmed-quantity column are how you tell them apart.

### Confirmed

Two back-to-back syncs reported the same quantity. Hoard is reasonably sure this is real. Most of your inventory should be here in steady state.

### In flux

The quantity changed since the last sync. Hoard doesn't yet know whether the new value is real or a TCGplayer reporting hiccup — TCGplayer's seller portal occasionally lags between systems, and a single sync can show a number that corrects itself on the next pull. Cards stay in-flux until two consecutive syncs agree on the same quantity, then they promote to confirmed.

You don't need to do anything about in-flux cards. They settle on their own.

### Audit candidate

Hoard saw a quantity drop, but it couldn't find a matching sale to explain it. That's the signal that something might not be physically present in your bins — a ghost listing, a cancelled order that didn't decrement properly, an item that was pulled but not delisted, or a sync drift that Hoard can't reason about on its own.

These are the cards worth pulling up and eyeballing against your shelves.

## The Audit view

In the cards table toolbar, click **Audit**. The table filters to cards that are currently listed (quantity > 0) and have at least one unexplained decrement in their history.

If you do a quarterly physical audit, this is where you start — Hoard's already done the math on which listings are most likely to be ghosts.

For each card in the audit view:

1. Check your physical inventory.
2. If the card is actually there: click the amber audit dot and categorize it as acknowledged or a listing fix, so it leaves the Audit view.
3. If the card is NOT there: delist it on TCGplayer or fix the quantity. Hoard will pick up the change on the next sync.

Rows with unresolved drops show a small amber dot. Click it to categorize the drop as sold on another platform, manually removed, listing fix / SKU correction, or "don't know — just acknowledge." Saving the category resolves the actionable decrement for that card, removes the dot, and keeps the Audit filter from showing it again for the same event.

Manual categories are permanent. If a late TCGplayer order sync later explains the same quantity drop, Hoard keeps your manual classification because you already checked the shelf and supplied the missing context.

## What "explained" means

When Hoard sees a card's quantity go down by N, it looks for an `order_item` in the same time window with the same SKU and at least N units sold. If it finds one, the decrement is **explained** — Hoard ties the sync delta to a sale you actually made.

If no matching order can be found, the decrement is **unexplained** and the card joins the audit candidate pool. Common reasons for unexplained decrements:

* The sale hasn't synced to Hoard yet (order pull runs on a separate cadence from inventory sync).
* The order is on TCGplayer but Hoard's sync was paused or failed during the window.
* The listing was edited manually on TCGplayer (you adjusted the quantity yourself).
* The listing was delisted without a sale.
* The card was returned and re-shelved but the listing wasn't reactivated.
* Something is missing physically and the listing is a ghost.

Hoard cannot tell these apart by itself. That's what the audit view is for — it surfaces the candidates so you can apply the one piece of context Hoard doesn't have: what's on your shelf.

## What Hoard never does

Hoard is read-by-default for inventory. Specifically:

* Hoard never delists a card on TCGplayer on your behalf.
* Hoard never adjusts your TCGplayer inventory quantities.
* Hoard never creates new listings on TCGplayer without your explicit Quick Add publish action.
* Price changes only flow back to TCGplayer when the export CSV is pulled by your agent — which only happens after you've consented to the write path.

When a discrepancy surfaces, Hoard's role is to flag it. The fix runs through the same TCGplayer tools you already use.

## What about sales Hoard doesn't see?

If you sell on a channel other than TCGplayer, those sales won't appear in `order_items` and Hoard will mark the corresponding decrement as unexplained. This is the right behavior — Hoard doesn't have the data to know it was a real sale. The audit view is honest about the gap.

If multi-channel sales become common for you, ping support and we'll work through how to feed those sales into Hoard so the reconciliation accounts for them.

## Frequently asked

### What if Audit shows a card I know is in my bin?

That's normal. The most common cause is reconciliation lag — the sale was real but Hoard's order sync hadn't picked it up yet when the inventory sync ran. Re-run a sync (Sync Now from the dashboard) and the explained / unexplained split usually corrects itself within a cycle or two.

### Does the audit view catch ghosts I don't sell often?

The view shows cards with at least one unexplained decrement. A card that's been listed for months and never decremented at all won't show up here — that's a different kind of ghost (listed but never moves), and it's not what this view targets. We're working on coverage for that case in a future release.

### Can I export the audit view?

The cards table export honors filters. Click **Audit**, then export — you'll get a CSV of just the audit candidates.

### Will the audit be wrong sometimes?

Yes, often. Treat it as a starting point, not a verdict. A card flagged here might be perfectly fine — Hoard just can't prove it without you checking the shelf. The point is to narrow your audit work from "every listing" to "the listings most likely to be wrong."
