Skip to main content

Receiving against a delivery

When goods arrive, the receiver scans each item or carton. Green means "this was ordered, recorded"; red means "this isn't on this delivery" before it disappears into the shelves.

How it works#

  1. Your system knows what the expected delivery contains (a purchase order or a delivery note).
  2. The receiver scans the delivery note first, so your API knows which delivery this device is working on.
  3. Then the receiver scans the items. For each one, your API checks it against the delivery and records it.

What your API checks#

  • The first scan is a delivery note: remember it for this deviceId.
  • Each item is on that delivery, and not more of it than was ordered.
  • When a quantity is needed, answer "status": "missingData" with a form; the app asks and sends the scan again with the answer.

Example answers#

{ "status": "ok", "title": "Recorded", "message": "Coffee beans 1 kg · 6 of 12" }
{ "status": "failed", "title": "Not on this delivery", "message": "Delivery note DL-2291 has no item 8591234567890" }

Asking for the quantity only when it's needed:

{  "status": "missingData",  "settings": {    "formData": {      "schema": {        "quantity": {"title": "How many cartons?", "type": "integer", "enum": [1, 2, 5, 10, 20]}      },      "showOnce": true    }  }}

Settings#

Retail EAN codes on the goods, Code 128 on the delivery note.

{  "app": "scan2check.com",  "settings": {    "apiUrl": "https://api.example.com/receiving/scan",    "symbols": [      "ean13",      "ean8",      "code128"    ]  }}

Open in configurator — loads these settings so you can put in your own API URL and generate the QR code.

Watch out for#

  • It isn't a stock count. Counting a whole store means hundreds of scans, each waiting on the network, with no running total on the phone. Scan2Check fits checking one delivery against what was expected.
  • Quantities are choices, not typed numbers. Offer the pack sizes that actually occur. If you need exact counts, scan each carton instead.
  • Forgotten delivery note. If an item comes before any delivery note on this device, answer red with "Scan the delivery note first".