Stock Verification Module

Part of the Library Koha Suite — quickly compare two barcode lists and find items missing from your shelf-check against the catalogue, then export or print the results.

Secure, login-only access CSV based Instant comparison

On this page

Overview

The Stock Verification Module helps library staff perform physical stock-taking (shelf verification) by comparing a full inventory export against a list of barcodes that were actually scanned during the stock check. Any barcode present in the inventory but not found in the scanned list is flagged as a missing record — meaning that item could not be located on the shelf.

The tool runs entirely in the browser via a simple upload form: no data is stored permanently, results are calculated on the fly, and you can preview, print, or download them as a CSV file.

Key Features

Dual CSV Upload

Upload two CSV files — your master inventory list and your scanned-barcode list — directly from your computer.

Automatic Comparison

Instantly identifies every barcode from the inventory file that is missing from the scanned file.

Numbered Results Table

Missing items are listed with a running serial number and all original columns (Title, Author, Price, etc.).

Automatic Price Total

Automatically sums the price column of all missing items so you know the total value unaccounted for.

One-Click CSV Export

Download the missing-items list as a timestamped CSV file, ready to file or share.

Print-Friendly Results

Print the results table directly from the browser for physical record-keeping.

Login-Protected Access

Only authenticated Koha Suite users can access the tool; the current user and login time are always shown.

Responsive Design

The layout adapts cleanly to tablets and phones, so stock checks can be reviewed on any device.

File Requirements

The comparison relies on two CSV files, each with a specific column layout:

File 1 — Master Inventory List

ColumnFieldNotes
1BarcodeUnique identifier used for matching
2TitleItem title
3AuthorItem author
4PriceUsed to calculate the total value of missing items
The first row of File 1 must be a header row — its column names are reused in the results table and CSV export.

File 2 — Scanned Barcodes

A single-column CSV containing only the barcodes that were physically scanned/found during the stock check. The first row is treated as a header and skipped.

Both files should be saved in plain CSV format (comma-separated). Export directly from your spreadsheet application using "Save As → CSV".

Step-by-Step Guide

  1. Open the Stock Verification tool from the Koha Suite home page.
  2. Under Upload File 1, choose your master inventory CSV (Barcode, Title, Author, Price).
  3. Under Upload File 2, choose your scanned-barcodes CSV.
  4. Click Compare and Preview to see the missing records on screen.
  5. Review the results table — check the count of missing records and the total price at the bottom.
  6. Click Export Missing Barcodes to download a CSV copy, or use Print Results to print directly.

Understanding the Results

If every barcode in File 1 is found in File 2, the tool displays a "No Missing Records Found" confirmation instead of a table.

Export & Print

Exported files are named automatically using the pattern missing_barcodes_YYYY-MM-DD_HH-MM-SS.csv so every export is uniquely timestamped and easy to file alongside your stock-take records. The exported CSV always includes the S.No column, the original headers from File 1, and the total price row.

Use the Print Results button to send the current results table straight to your browser's print dialog — useful for physical sign-off sheets.

Troubleshooting & FAQ

Nothing happens when I click "Compare and Preview"

Make sure both files are selected before submitting — both uploads are required.

My totals look wrong

Confirm that the Price column is the 4th column in File 1 and contains plain numbers (no currency symbols or thousands separators).

A barcode I know is missing didn't show up

Barcode matching is exact and case-sensitive — check for extra spaces, leading zeros, or formatting differences between the two files.

Can I upload Excel (.xlsx) files?

No — files must be saved as CSV first. Most spreadsheet programs offer "Save As → CSV (Comma delimited)".

Very large CSV files may take longer to process. If a comparison seems slow, try splitting large inventories into smaller batches.

Access & Security