SortSwift keeps inventory data organized in a predictable structure so pricing, staging, platform sync, and channel exports work consistently for every product.

Core Document Fields

Each inventory document is tied to a single product and contains:

productId: Unique identifier for the product in your catalog.
skuId: Specific SKU (variant) identifier (e.g., NM English Normal).
game: Game or category (Magic, Pokémon, etc.).
set: Set or expansion name.
collector number: Collector number within the set.

Stock Items Array

Each document holds an array of stock items. Each item includes:

condition: NM, LP, MP, HP, or DM.
language: Language code (e.g., English, Japanese).
printing type: Normal, Foil, Etched, etc.
quantity: Available quantity.
price: List or sell price.
cost: Acquisition cost.
location: Bin, shelf, or staging area.
manual price override: Flag to skip autopricing updates.
preorder status: Supports preorder tracking.
remarks: Internal notes for location or batch info.

Platform IDs per Stock Item

For platform sync, each stock item stores external listing IDs:

shopifyId: Shopify product/variant ID.
cardtraderId: CardTrader listing ID.
manapoolId: ManaPool listing ID.
ebayListingId: eBay listing ID.

Platform IDs let SortSwift update existing listings instead of creating duplicates. Keep these intact when editing items.

Staff & Audit Tracking

SortSwift records who modified inventory:

Added by: Staff account that added the stock.
Modified by: Staff account that last edited the item.
Timestamps: Creation and last modification dates.
Remarks: Optional audit notes.

Keep custom tags and remarks short and consistent. Store-wide naming conventions make it easy to filter inventory, build automations, and report on specific subsets.