What is the Buylist System?

The Buylist System allows customers to submit cards they want to sell to your store. Store owners can review, approve, modify, and manage these orders through a comprehensive interface. Once orders are completed, they can be automatically sent to inventory with proper cost tracking and SKU matching.

• Customer Portal: Public-facing interface where customers search for cards, build cart, and submit orders
• Store Management: Authenticated interface for store owners to manage orders, update statuses, modify items, and communicate
• Pricing Engine: Sophisticated pricing calculation with multiple modifiers (hotlist, darklist, stock limitations, availability delays)
• Order Lifecycle: Orders progress through statuses: pending_approval → approved → pending_drop_in/pending_delivery → received → reviewing → complete
• Inventory Integration: Completed orders can be sent to inventory with automatic SKU matching and cost tracking
• Budget Management: Optional cash and credit budgets with automatic validation and adjustment
• Messaging: Built-in communication system between customers and store owners

Key Concepts

• Orders: Each order contains customer information, selected cards, totals, status tracking, and communication messages
• Cart Items: Individual cards in an order including card details, condition, language, printing, quantity, and payment preferences
• Payment Types: Customers can choose Cash payment, Store Credit, or Split payment (combination of both)
• Store Configuration: Your store settings control pricing rules, supported games, budgets, priority cards, and email preferences
• Status Tracking: Complete history of all order status changes with timestamps for full transparency
• Messaging System: Built-in communication between you and customers with automatic notifications

Order Types

• Customer Orders: Submitted through the customer portal. Orders go through budget validation and can be auto-approved based on your store settings
• POS Buy Orders: Created directly from POS Buy Mode for in-person transactions. These orders are automatically approved
• Drop-In Orders: Customer brings cards to your physical store location
• Delivery Orders: Customer ships cards via mail to your store address

Pricing Data Sources

• US Prices: TCGPlayer pricing data with multiple price points (Direct Low, Low, Mid, Market, High) per card printing
• EU Prices: European pricing data available when enabled in store configuration
• Currency Conversion: Automatic exchange rate conversion updated hourly for accurate international pricing
• Store Currency: Set your preferred currency (USD, EUR, CAD, etc.) and prices convert automatically
• Game-Specific Pricing: Configure different pricing rules for each game category
• Video Games: Special pricing system for video games with condition-specific pricing

Key Features

• Customer Portal: Public interface where customers can search for cards, build orders, and submit buylist requests
• Store Management: Secure dashboard to manage orders, update status, modify items, and communicate with customers
• Pricing Lookup: Quick price checking for single cards or bulk uploads via CSV
• Order Tracking: Customers can view their order status and history using a unique order link
• Messaging: Built-in communication system between customers and store owners
• Inventory Integration: Send completed orders directly to your inventory system

Typical Workflow Summary

1. Customer Submits Order: Customer searches for cards, adds them to cart, selects payment preferences, and submits the order
2. Order Created: System validates the order, checks budget availability, and creates the order with initial status (Pending Approval or Approved if auto-approve is enabled)
3. Emails Sent: You receive an email with order details and CSV attachment. Customer receives confirmation email (if email notifications are enabled)
4. Store Owner Reviews: View and manage the order in your dashboard. You can modify items, update status, and communicate with the customer
5. Order Approved: When you approve the order, the customer receives a notification email with your store address
6. Cards Received: Update status to "Received" when cards arrive, then "Reviewing" while inspecting the cards
7. Order Completed: Mark the order as "Complete" and final totals are calculated and saved
8. Sent to Inventory: Click "Send to Inventory" to automatically add cards to your inventory system
9. Inventory Sync: Cards automatically sync with your connected platforms (Shopify, CardTrader, ManaPool)