# Scanning

**Inventory → Scan.** Pick a mode: **Look up**, **Reorder**, **Receive**,
**Issue**, **Sell** (when the inventory is for resale) or **Adjust**.

**Adjust** is for counting: scan an item, enter how many you have now
(the box starts at the current quantity on hand) and press **Set count**.
The difference is recorded as an adjust movement.

The **Date** box above the scanner starts at today. Change it to record
something that happened earlier, like a delivery that came in yesterday:
every receive, issue, sale or count you confirm is dated that day (at the
current time of day) until you change it back. Future dates are refused.

## Four ways to scan

- **Phone or laptop camera**: *Start Scanning* and hold the barcode or QR in
  the frame. Sobocoo uses the browser's barcode detector where available
  (Chrome, Safari 17+) and falls back to an in-page decoder. No app to
  install.
- **Hardware scanner** (USB or Bluetooth, any device): it types into the code
  box and presses Enter. The box is focused when the page opens.
- **Keyboard**: type a SKU, UPC or Sobocoo code and press Enter.
- **Pick from the list**: every item at the site is listed under the code
  box; click a name and Sobocoo treats it as if you had scanned it. Typing
  in the code box narrows the list to items whose name, SKU, UPC, location
  or description contains every word you type.

## What it reads

- Sobocoo QR labels and Sobocoo codes.
- UPC-A, EAN-13 and EAN-8 product barcodes; the check digit is verified.
- Anything else is matched against your SKUs.
- Carrier tracking barcodes on UPS, FedEx, USPS and DHL shipping labels,
  when the code is not one of your items (see below).

## Receiving a delivery by its shipping label

When boxes arrive, scan the tracking barcode on the shipping label (camera
or hardware scanner) in **Receive** or **Look up** mode. If the tracking
number is on one of your [purchase orders](/docs/ordering#tracking-numbers),
Sobocoo opens that order's **Record a delivery** form with what is still
expected filled in (paid and free units), **Received** set to the current
quarter hour and the tracking number shown. Check the counts, change what
did not arrive, and press **Record delivery**. Nothing is received until
you do. The tracking number is then marked received on the order.

Sobocoo reads the number out of the whole label barcode: the USPS barcode
with its `420` and ZIP code in front, the long FedEx barcode, UPS `1Z`
numbers and DHL waybills. In the other modes a label scan shows the order
with a button to record the delivery.

Items always come first: if one of your items has the scanned code (as a
UPC, SKU or Sobocoo code), the scan is that item, even when the same
digits are also a valid tracking number. Other messages:

- **No order has tracking number ... yet**: add the number to its order
  (on the order page, under **Tracking**) and scan again.
- **Already received**: that box was recorded before; the message names
  the date and the order. A fully received or closed order says so, and
  administrators get a link to **Edit order** to correct it.
- Without access to record deliveries, the scan names the order and links
  to it instead.

## After a scan

Every scan beeps: a short high beep when the code matches an item (or an order's tracking number), a low
buzz when it does not (phones also vibrate). Confirming a receive, issue,
sale or reorder plays a two-note chime once it is saved. The barcode buttons on the
item form beep when a code lands in the box. Turn the volume up if you
hear nothing; a phone on silent may not play it.

A hit shows the item, a quantity stepper and a confirm button for the mode.
Receive, Issue and Sell record a [movement](/docs/stock-movements); Reorder
adds the item to the [order list](/docs/ordering). In Receive mode, tick
**Free (comp)** for samples, promos or donations: enter the **Value per
unit** (it starts at the item's cost) and an optional **Source**, such as
"Sample from Acme rep". The units come in at no cost as a
[comp receipt](/docs/stock-movements#free-comp-receipts). The box and the
source stay set for the next item you scan, so a batch of samples takes
one tick. An unknown UPC offers *Add
it as a new item* with the barcode filled in.

Scanning a Sobocoo QR label with the phone's ordinary camera app opens the
item page directly, after sign-in.
