Items and receiving

Receive serialized items, record evidence and publish listings.

Receive an item

/dashboard/platform/items/receive calls receiveCollectibleItem against an existing product variant. It creates the catalog entry, specimen, condition observation, inventory unit and receipt movement, and can publish a listing in the same call.

FieldNotes
code, title, categoryRequired. Errors: Item code is invalid, Item title is required
conditionRequired
variantSkuMust already exist (Create the product variant with SKU <sku> first)
priceMinorNon-negative whole minor units
publishPublish a listing immediately
catalogItemHandleAttach to an imported card printing
gradecompany, grade, label, certificate, sample
consignmentconsignor and commission basis points

If the variant already has an item the call fails with Product variant <sku> already has an item.

Item record

/dashboard/platform/items/[id] shows lifecycle and an evidence timeline. Add an identifier, condition, grade, provenance, custody, valuation or media. Evidence lists are append-only and each has a publiclyVisible flag.

Specimen.lifecycleStatus (intake, review, available, reserved, sold, returned, withdrawn) moves only through system commands.

Listings

manageCollectibleListing publishes, edits and withdraws. Listing price must match the variant's price in the store currency (Listing price must match the <currency> price of <sku>).

Custody

/dashboard/platform/collectible-inventory shows units, holds and movements. These are system-written and read-only.

On this page