API Overview
Understand authentication, rate limits, and core resources in the LollipopWMS API.
Documentation
Receiving Flow Configuration
Configure receiving stations, inspection prompts, and discrepancy handling.
Receiving workflow overview
LollipopWMS supports multiple receiving modes: **PO-based receiving**: Match inbound shipments to purchase orders for expected quantities. **ASN receiving**: Scan advance ship notice barcodes for pre-populated receipts. **Blind receiving**: Receive without a PO when shipments arrive unexpectedly. The standard flow: Identify shipment → Scan/enter items → Verify quantities → Print labels → Stage for putaway. Configure the default mode and allow overrides per receiving station.
Station configuration
Create receiving stations from Settings > Locations > Stations. Each station needs: Name (e.g., 'Dock Door 1'), Type (Receiving), Assigned printer for labels, Default receiving mode. Configure station-specific rules: require photos for damage, auto-print labels after each receipt, QC sampling percentage. Assign users to stations to track productivity. Stations can be physical (dock door) or virtual (mobile device). Set up at least one backup station in case of hardware failure.
PO matching and blind receiving
**PO matching**: Receiver scans PO barcode or searches by PO number. System displays expected items and quantities. Receiver scans each item and enters quantity received. Variances (over, under, wrong item) are flagged for review. **Blind receiving**: Use when no PO exists or can't be found. Receiver scans item barcode, enters quantity, and system creates a receipt. Blind receipts require supervisor approval before inventory is available. Enable 'Allow blind receiving' in station settings if needed.
Inspection and QC holds
Configure inspection rules from Settings > Quality > Receiving Inspection. Options: **No inspection**: Items go directly to available inventory. **Sample inspection**: Random percentage of receipts require QC. **Full inspection**: All items must pass QC before availability. **Conditional**: Specific products, vendors, or PO types trigger inspection. Items in QC hold are visible but not available for allocation. Inspectors access the QC queue to approve, reject, or request more information. Rejected items route to returns or disposal workflows.
Discrepancy handling
When received quantities don't match expected: **Under-receive**: Mark PO line as short, notify purchasing, keep PO open for remaining quantity or close with variance. **Over-receive**: Accept overage (common for supplier-shipped quantities), reject and return, or hold for investigation. **Wrong item**: Reject, photograph, and initiate return process. **Damaged goods**: Photograph, route to QC hold, determine disposition (return, salvage, scrap). All discrepancies create exception records for reporting. Configure auto-notifications to purchasing and vendors for significant variances.
Frequently asked questions
Can we receive partial POs?
Yes. Receive available quantities and the PO remains open for remaining items. Set auto-close rules if you don't expect backorders.
How do we handle mixed pallets?
Receive each SKU separately within the same receipt. The system tracks totals per item. Consider breaking down pallets at receiving for single-SKU putaway.
What if the barcode won't scan?
Manual entry is available for damaged barcodes. Search by SKU, UPC, or description. Log unreadable barcodes to identify systemic issues with supplier labels.