Barcode Scan and Order Status Automation

BizPrint allows you to update WooCommerce order statuses by scanning a barcode printed on receipts or documents. This is commonly used to mark orders as completed during fulfillment, pickup, or packing workflows.

Barcode scanning works by printing a unique barcode per order and sending scan events to BizPrint through a secure REST endpoint.

Step 0 Install the Order Status Triggers add on

Barcode scanning requires the Order Status Triggers add on.

  1. Download the add on from the BizPrint Marketplace
    https://getbizprint.com/product/order-status-triggers/
  2. Install and activate the add on on your site

Once activated, barcode printing and scan based order updates will be available in Print Manager.

Step 1 Enable barcode printing on a printer

Barcode printing is configured per printer.

  1. Go to Print Manager > Printers
  2. Edit the printer you want to use
  3. Enable barcode printing
  4. Configure the barcode position, size, and optional label
  5. Save the printer settings

Once enabled, any template printed to this printer will include a scannable barcode.

Step 2 Enable barcode scanning globally

  1. Go to Print Manager > Barcode Scan
  2. Enable Barcode Scanning

This allows scanned barcodes to update order statuses using the REST API.

Step 3 Configure scan behavior

Target Status

Select the order status that orders should be updated to when their barcode is scanned.

Example
Completed

When a barcode is scanned, the order will be updated to this status.

Allowed From Statuses Optional

Choose which order statuses are allowed to be updated by scanning.

Only orders currently in these statuses will be accepted.
Leave this field empty to allow all statuses.

Single Use Barcode

When enabled, each barcode can only be scanned once.

Additional scans of the same barcode will be rejected.

This is recommended for pickup or fulfillment workflows where each order should only be completed one time.

Step 4 API authentication

Scan API Key

The Scan API Key is required for external applications to submit scan requests.

Include this key in the request header
X-BizPrint-Scan-Key

You can generate a new key at any time.

REST Endpoint

Scan requests are sent to the following endpoint

https://your-site-url/wp-json/bizprint/v1/scan

Requests must be sent using POST and include

  • barcode_value
  • station_id optional

Step 5 Connect external scanners or apps

If you are using Order Board or another scanning interface

  1. Copy the Scan API Key
  2. Paste it into Order Board > Settings > Barcode Scan Settings
  3. Save settings

You can now scan barcodes using Order Board or any scanner integrated with the REST API.

How barcode scanning works

  1. An order is printed with a unique barcode
  2. The barcode is scanned
  3. BizPrint identifies the order
  4. The order status is updated
  5. The scan is logged in the order notes

This creates a fast and auditable workflow from print to completion.