Back to all guides
Barcode billing guide

Complete Barcode Billing and Scanner Setup Guide for Small Shops

Build a clean product-barcode catalog, scan items with an Android camera, handle Windows entry correctly and turn each successful scan into faster, more accurate billing.

30 July 202621 min readAndroid camera + Windows entry
DukaanAdda barcode billing and scanner setup guide

Quick answer

First save a unique barcode on every active inventory product. On Android, open Fast Bill and tap the scanner icon, allow camera access and align the product code inside the frame. DukaanAdda finds the exact stored barcode and adds the product to the bill. On Windows, the same action currently opens manual barcode entry.

A scanner cannot repair weak product data

Barcode speed depends on a clean catalog. Wrong prices, duplicate products, missing stock or an incorrectly stored code will make a technically successful scan produce the wrong counter result.

Core workflow

Understand how barcode billing works in DukaanAdda

A product barcode is an identifier, not the product record itself. DukaanAdda stores the code with the inventory item. During billing, the scanner returns a raw value and the app looks for one active, non-deleted product whose stored barcode exactly matches that value.

01

Store

Save the code once.

02

Read

Camera or manual input.

03

Match

Exact active-product lookup.

04

Add

Product enters the bill.

The matched product supplies its saved name, unit, selling price, tax configuration, version and inventory identity to the bill. This is why scanning should be treated as a shortcut to trusted inventory data—not a replacement for maintaining it.

Catalog setup

Prepare products before using barcode billing

  • Product name is clear and not duplicated unnecessarily.
  • Barcode is saved exactly as printed, including leading zeroes.
  • Selling price and unit are correct before counter use.
  • GST applicability and rate are configured for GST billing.
  • Current stock and minimum-stock alert are maintained.
  • The product remains active and available for billing.

Barcode is optional on the product form, so you can start with products that already carry a manufacturer code and add the rest later. Do not invent a value casually. If your shop uses internal codes, follow one documented pattern and avoid reusing a code after a product is discontinued.

DukaanAdda also supports product search by name, SKU, barcode and brand. This remains an important fallback when a label is damaged or a product does not have a barcode.

Product setup

Assign or scan a barcode on the product form

  1. 1

    Open Add Product

    Go to Inventory and create a product. Complete the name, category, unit, purchase price, selling price, stock and tax fields that your billing workflow needs.
  2. 2

    Open the barcode scanner

    In the optional Barcode field, use the scanner action. On Android, allow camera permission and point at the code. You can switch the camera, enable the torch or move to manual entry.
  3. 3

    Confirm the captured value

    Compare the saved value with the human-readable code printed below the bars. Preserve leading zeroes and do not add spaces before or after the code.
  4. 4

    Save online

    Creating and updating products currently requires internet access. At save time, DukaanAdda checks whether another active product already uses the same barcode.

Existing barcode protection

When scanning while creating a new product, DukaanAdda checks whether that barcode already belongs to a product. If it finds one, the app opens the existing product instead of encouraging a duplicate record.

Data quality

Follow five barcode rules that prevent lookup failures

1

Store the exact value

Barcode lookup is exact. An extra digit, missing leading zero, different letter case or invisible copied space can prevent a match.

2

Keep each active barcode unique

One code should identify one active product. DukaanAdda blocks an online save when another active product already owns that barcode.

3

Treat the code as text

Do not convert it to a number in spreadsheets or notes. Numeric conversion can remove leading zeroes and change a valid identifier.

4

Use no more than 64 characters

The current barcode field and manual scanner entry enforce a maximum length of 64 characters.

5

Test the physical label

A code saved by typing may still be hard for a camera to read if the print is tiny, glossy, curved, faded or damaged.

Camera setup

Set up barcode scanning on an Android phone

  1. 1

    Clean the camera and label

    Wipe the camera lens and flatten the product label when possible. Use even light without a sharp reflection across the bars.
  2. 2

    Allow camera permission

    DukaanAdda requests camera access when the scanner opens. If permission is permanently denied, use Open Settings and enable Camera for the app.
  3. 3

    Align one code in the frame

    Hold the phone steady and place the entire barcode inside the scanning frame. Avoid showing a nearby payment QR or a second product label at the same time.
  4. 4

    Use the scanner controls

    Turn on the torch in low light or switch between available cameras. If the camera still struggles, choose Enter Barcode Manually and type the printed code.

The scanner accepts the first non-empty detected raw value and closes. This makes the flow fast, but it also means the operator should keep only the intended code inside the frame.

Counter workflow

Scan products into Fast Bill

Fast Bill is designed for quick counter entry. The empty state offers search, barcode scan and manual-item options. On Android, tap the barcode/scan icon near the Fast Bill heading, scan the product and wait for it to appear before moving to the next item.

DukaanAdda Fast Bill screen with scanner shortcut

Fast Bill

Scan, verify, then continue

A successful scan adds the matched inventory product. Check its name, price, quantity and stock warning before scanning the next label. Use Save & Print only after payment mode and bill totals are correct.

If no product matches, Fast Bill shows “Product not found for this barcode.” Search by name or SKU to confirm whether the product exists, then correct or add its barcode from Inventory.

Full invoice

Scan a product into a detailed invoice

The full Create Invoice screen uses the same product-barcode lookup. Depending on the screen layout, its scanner button is labelled Scan QR, but the action opens the shared product barcode scanner and passes the result to product lookup.

Do not confuse product and payment QR codes

This scanner action is adding an inventory item. If a payment QR is scanned, the app will search for an active product whose barcode exactly equals that QR payload; normally it will return Product not found.

Use the detailed invoice workflow when you need fuller customer, delivery, payment, tax or invoice information. Barcode scanning only changes how the product is selected; the rest of the invoice still needs review.

Quantity behaviour

Know what happens when the same barcode is scanned again

DukaanAdda identifies an existing bill line by product ID. When the scanned product is already present, another scan increases its quantity by one. It does not create a second row for the same inventory product.

First scan

Adds a new product line at quantity one.

Next scan

Increases the existing line quantity by one.

Current limit

Up to 50 units per line and 50 unique products.

For multiple identical units, repeated scanning can be convenient. For a large quantity, use the quantity control and verify available stock instead of scanning dozens of times.

Desktop behaviour

Use barcode entry on Windows and understand handheld scanners

The current shared scanner flow uses live camera scanning on Android and iOS targets. On Windows, pressing the Scan action opens a manual-entry dialog with a focused barcode field. Type or paste the value and submit it for exact product lookup.

Current reliable method

Open the scanner action, enter the code in Manual Entry and submit. Product search can also find partial barcode, SKU, brand or name text.

Handheld scanner limitation

There is no dedicated global USB/Bluetooth scanner listener that automatically adds a product from anywhere in Fast Bill.

A keyboard-wedge scanner behaves like a keyboard and may type into the focused manual field. If it appends Enter, the dialog may submit through the field's done action. This is device-dependent behaviour, not a guaranteed dedicated integration. Test the exact scanner before designing a busy Windows counter around it.

Connectivity

Understand offline barcode lookup

When the device is offline, the inventory repository searches locally cached products and returns a product only when its stored barcode exactly equals the scanned value. This can keep familiar products discoverable when connectivity drops.

Can work offline

Exact lookup for an active product already available in the device's product cache.

May fail offline

A new or changed product that has never been cached on that device. Product create/update also requires internet.

Before a high-volume offline period, open and sync the relevant inventory while online. Reconnect and sync after billing so product, stock and sales records can be reconciled.

Billing accuracy

Connect barcode scans with stock, price and tax

Scanning selects the product record; it does not freeze or invent commercial values. Fast Bill takes the saved selling price and unit. In GST mode it applies the product's tax applicability and configured rate, using the business default where the product is taxable but its rate is zero.

DataWhere it comes fromCounter check
ProductExact barcode matchCorrect item name
PriceSaved selling priceMatches shelf price
UnitSaved product unitPiece, kg, box, etc.
GSTBill type + product tax setupCorrect rate
StockTracked inventory productEnough quantity

Fast Bill prevents final save when one or more tracked items do not have sufficient stock. It can also surface a low-stock warning. Correct the quantity or stock record instead of bypassing the product with a manual item, because manual items are not stock-tracked.

Problem solving

Fix common barcode scanning and billing problems

1

Camera permission denied

Open Android Settings → Apps → DukaanAdda → Permissions and allow Camera, then reopen the scanner.

2

Camera cannot focus

Increase distance slightly, hold steady, clean the lens, flatten the label and use the torch without creating glare.

3

Scanner reads the wrong code

Keep only one label inside the frame and move payment QRs or nearby products away from the camera view.

4

Product not found

Search inventory by name, SKU or barcode, confirm the product is active and compare the stored value character by character.

5

Leading zero disappeared

Re-enter the barcode as text exactly as printed. Avoid spreadsheets or numeric fields that convert identifiers to numbers.

6

Duplicate-barcode error

Find the existing product using that code. Update the correct record rather than creating another active product.

7

Wrong product is added

Inspect duplicate legacy records and the saved barcode. One active barcode should belong to one product only.

8

Same scan increases quantity

This is expected when the product is already on the bill. Use minus or quantity controls if the extra scan was accidental.

9

Product is unavailable

Deleted or inactive products cannot be added. Reactivate or replace the inventory record intentionally.

10

Barcode works online but not offline

The product may not exist in local cache. Reconnect, load/sync inventory and test the device again before going offline.

11

Windows camera does not open

Current Windows behaviour is manual barcode entry. Use the focused field or product search instead of expecting the mobile camera dialog.

12

Handheld scanner does nothing

Open Manual Entry first and test whether the scanner types as a keyboard. Dedicated global hardware-scanner capture is not currently implemented.

Daily operations

Build a reliable barcode-billing counter routine

Before opening

  • Sync product catalog
  • Test three different labels
  • Check price and stock

During billing

  • Scan one product at a time
  • Verify item and quantity
  • Use search as fallback

At closing

  • Review Product not found cases
  • Fix duplicate or damaged labels
  • Sync completed records

Keep a small exception list at the counter: unlabelled products, damaged labels, new products and codes that failed lookup. Correct those records after the rush instead of repeatedly typing the same product every day.

Current product scope

Understand the current barcode-feature limitations

No dedicated barcode-label generator

The audited workflow stores and reads barcode values. It does not currently provide a verified batch barcode-label design and printing tool.

No global hardware-scanner listener

Windows uses manual entry in the shared scanner flow. Keyboard-wedge input may work in a focused field, but there is no dedicated always-on handheld scanner integration.

Exact lookup is intentional

Partial barcode text can help in product search, but direct barcode billing looks for the exact stored value to avoid silently choosing the wrong product.

These boundaries matter when choosing counter hardware. For an Android-first shop, the built-in camera scanner and manual fallback are the verified path. For a Windows counter that depends on rapid handheld scanning, test the exact keyboard behaviour before purchase or submit a feature request for a dedicated scanner workflow.

FAQ

Frequently asked questions about barcode billing

How does barcode billing work in DukaanAdda?

A product stores an optional barcode. During billing, DukaanAdda reads or accepts a code, performs an exact lookup for an active product, and adds that product to the bill using its saved name, unit, price and tax settings.

Can I scan product barcodes with an Android phone camera?

Yes. The Android flow requests camera permission and opens a live scanner with a scan frame, torch control, camera switch and manual-entry option. The first detected raw code is returned for product lookup.

Does barcode camera scanning work on the Windows app?

The current Windows scan action opens a manual barcode-entry dialog instead of a camera scanner. You can type or paste the code. A keyboard-wedge handheld scanner may enter data into the focused field, but DukaanAdda does not currently provide a dedicated hardware-scanner capture service.

Can two active products use the same barcode?

No. When a product is saved online, DukaanAdda checks active, non-deleted products and returns a duplicate-barcode error if another product already uses the same stored code.

What happens when I scan the same product twice?

If the product is already on the bill, another scan increases that line quantity by one instead of creating a duplicate line. The current bill validator allows up to 50 units per product line.

Why does a valid-looking barcode show Product not found?

Barcode billing uses an exact stored-code lookup. Confirm the product is active, the same code was saved without missing characters or spaces, letter case matches for alphanumeric codes, and leading zeroes were preserved.

Can I enter a barcode manually?

Yes. The scanner includes Enter Barcode Manually, and non-camera platforms open manual entry directly. The field accepts a non-empty code up to 64 characters.

Can barcode lookup work without internet?

It can match an exact barcode against products already available in the local cache. A product that has never been cached on that device may not be found offline, and creating or updating products currently requires internet access.

Does DukaanAdda generate or print barcode labels?

The verified current workflow stores, scans and searches product barcode values. It does not include a dedicated barcode-label design and batch-printing workflow in the audited feature set.

Does scanning automatically reduce stock?

Scanning adds the saved product to the bill. Stock is affected through the completed sale workflow, not merely by opening the scanner. Fast Bill checks for insufficient stock before final save.

Can I use a QR code as a product code?

The camera library can return a raw detected code, but product billing only succeeds when that exact value is stored in an active product's barcode field. A payment QR or unrelated QR will normally return Product not found.

Faster counter billing

Scan trusted product data—not just printed bars

Maintain accurate products, scan one code at a time, verify the bill and let DukaanAdda connect barcode selection with stock, price, GST and thermal printing.

Download DukaanAdda