Rapid Scan Stock Incrementer Documentation

    Overview

    Documentation for WebMe Rapid Scan Stock Incrementer.

    User Documentation: WebMe Rapid Scan Stock Incrementer

    Table of Contents

    1. Installation
    2. Setup
    3. Workflows
    4. Troubleshooting
    5. FAQ

    Installation

    1. Install and activate WooCommerce.
    2. Install and activate WebMe Rapid Scan Stock Incrementer.
    3. In wp-admin, open WooCommerce > Rapid Scan Settings.
    4. Confirm lookup sources, default increment, scan mode, and quantity presets.
    5. Open WooCommerce > Rapid Scan Stock to begin receiving.

    Setup

    Settings

    • Default increment: starting quantity loaded into the scan screen
    • Scan mode
      • Scan and apply: each scan applies immediately
      • Scan, then confirm quantity: operator confirms quantity before apply
      • Count repeated scans before apply: repeated scans of same code build quantity
    • Quantity presets: comma-separated positive integers, capped to six unique values
    • Enable SKU lookup: matches exact WooCommerce SKU
    • Enable barcode meta lookup: matches exact _webme_rssi_barcode meta
    • Enable sound feedback: plays short success/error tones in supported browsers

    Before First Session

    • Make sure receiving users have manage_woocommerce
    • Confirm products manage stock in WooCommerce
    • If barcode lookup is needed, populate _webme_rssi_barcode product meta with exact values

    Workflows

    Start a Receiving Session

    1. Open WooCommerce > Rapid Scan Stock.
    2. Enter a session name.
    3. Optionally enter a supplier or receiving note.
    4. Click Start Session.

    Receive Stock by Scan

    1. Scan or type the SKU/barcode into the code field.
    2. Set quantity or use a preset button.
    3. Choose the scan mode if needed.
    4. Press Enter or click Apply.
    5. Review the success message and updated recent log.

    Undo the Last Adjustment

    1. Keep the current receiving session active.
    2. Click Undo Last.
    3. The plugin will undo only when current live stock still equals the expected post-scan quantity.
    4. If stock changed after the original scan, the undo is blocked and logged.

    Export a Session

    1. Finish a session or keep it active.
    2. Click the export button from the active session card or completed session history.
    3. Download the CSV with session details and adjustment rows.

    Troubleshooting

    • “Start a receiving session before scanning.” Start a session first; scan actions require an active session.
    • “Resolved product is not stock-managed.” Enable stock management on the matched WooCommerce product.
    • “duplicate_match” style error message: the scanned code resolved to more than one product; fix duplicate SKU/barcode data.
    • Undo blocked: another stock change happened after the original scan, so the plugin prevents reverting stale values.
    • No barcode matches: confirm _webme_rssi_barcode meta exists and barcode lookup remains enabled.

    FAQ

    Scale & Performance

    • Q: Will this scan every product on each request?

    • A: No full catalog scan is implemented. Lookups call WC_Product_Query for exact SKU and exact _webme_rssi_barcode matches, then return IDs only.

    • Q: Is this built for large warehouse batch jobs?

    • A: Current design is an interactive wp-admin workflow. There is no queue, batch processor, or offline sync layer.

    Data & Footprint

    • Q: What data does the plugin store?

    • A: It stores settings, one active/completed session structure, and up to 200 recent adjustments in WordPress options.

    • Q: Does it create custom tables?

    • A: No. Current version uses the standard options table only.

    Lifecycle & Uninstallation

    • Q: What happens if I uninstall the plugin?
    • A: No uninstall.php or cleanup routine is present, so settings, sessions, and adjustment history are expected to remain in the database until removed manually.

    Compatibility & Conflicts

    • Q: Does this work without WooCommerce?

    • A: No. The plugin shows an admin notice and does not boot its receiving features without WooCommerce.

    • Q: Does it support barcode plugins automatically?

    • A: Only if another process writes exact values into _webme_rssi_barcode. No connector layer or alias mapping exists in current code.

    Best Practices

    • Use unique SKU/barcode data to avoid blocked duplicate matches.
    • Keep one receiving session per shipment or PO for cleaner exports.
    • Train staff to use undo immediately when they catch a mistake; later stock changes intentionally block reversal.
    • Review quantity presets so common carton sizes stay one click away.