Publishing a card to eBay

This is the moment everything else has been preparing for. Once a card is identified, priced, photographed, and assigned a Marketplace Template, publishing is a single click.

The publish flow

From any card detail page or batch view, click List on eBay. Internally the vault does the following:

1. Resolve the template — pulls the active Marketplace Template (per-card override, then batch default, then your account default).
2. Resolve the Listing Template — fills placeholders in title + description from the card row.
3. Assemble the inventory item — title, description, brand, MPN, condition, aspects, image URLs. Images go through our HMAC-signed CDN so eBay's reviewers can fetch them.
4. Create or update the offer — assigns marketplace, format (FixedPrice / Auction), price, quantity, category, and the three Business Policies.
5. Publish the offer — eBay returns a listing ID, which the vault stores against the card and exposes in the listings tables.

The card's workflow status moves to listed, and the listing appears in Listings → Active within seconds.

Validation before submit

The vault runs a quick local validation before calling eBay:

• Title is 1-80 characters
• Asking price is greater than zero
• A Marketplace Template is selected
• At least one image is attached
• Category is a leaf category (eBay rejects parent-only categories)

If anything fails you get a specific error inline — no spinning loaders, no opaque "something went wrong."

Common errors from eBay

• "Specified category does not allow this item condition" — most graded categories require Condition: Used or Graded. Update your Marketplace Template.
• "Item specifics required: <Brand / Year / Player>" — eBay periodically adds required aspects to categories. Identify the card more fully (set, year, player) and republish.
• "Image too small" — eBay's minimum is 500px on the longest side. Re-upload the card photo at a larger size.
• "Out of stock" — your quantity dropped to zero. Set it back to at least 1 in the card row.

The full eBay error message is always shown so you can search eBay's developer docs if it's something exotic.

End or revise

Once a listing is live, the listings table at Listings → Active offers per-row Revise and End buttons. Revising republishes with new title/price/quantity. Ending closes the listing without selling.

The vault tracks the full state machine — pending → active → sold | ended | error — so you always see why a listing is where it is.