What is a Collection Code?

A collection code is a 6-character alphanumeric code (e.g., "A3B9X2") generated when a customer completes checkout at the kiosk. The customer shows this code at the counter so staff can retrieve their reserved order and process payment.

• Unique: Each code maps to one reserved order
• One-Time: Code is associated with a specific reserved cart
• Display: Shown prominently in the success dialog after checkout
• Save It: Customer should screenshot or write down the code

Stock Reservation (FIFO)

When checkout completes, inventory is immediately reserved:

• FIFO Deduction: Stock is deducted using First In, First Out – oldest inventory first
• Matching: By SKU, condition, printing, and language
• Partial Quantities: Can consume from multiple stock entries if needed
• Deduction Logs: Audit trail created for each deduction
• Transaction Safety: MongoDB transactions ensure consistency
• Real-Time: Stock removed immediately from kiosk view

Reserved Cart & POS

A reserved cart document is created for POS integration. Staff lookup the order in the POS using the collection code. The reserved cart contains:

• Collection Code: For lookup
• Items: Products, quantities, variants, prices
• Customer Info: Name or phone from checkout
• Totals: Pre-calculated for payment

POS staff process payment (cash, card, etc.) and complete the sale. Inventory has already been deducted, so the order is ready for pickup.

Inventory Sync

After reservation, inventory changes propagate to connected platforms:

• Shopify: Product quantities updated
• CardTrader: Stock synced
• ManaPool: Inventory updated
• Others: Per platform integration settings

Order Summary Email

If the customer provides an email at checkout, an order summary can be sent. This includes the collection code, items, and totals so they have a record for pickup.