Eldy at 18:26, 22 October 2026

2026-10-22T18:26:48Z

← Older revision		Revision as of 18:26, 22 October 2026
Line 1:		Line 1:
	~~{{#lang: en}}~~

	==Overview==		==Overview==

Sgrumpelt: edit the Version number of my current release

2026-10-21T10:28:21Z

edit the Version number of my current release

Show changes

Sgrumpelt: Create PackScan and Inventur documentation with setup instructions, demos and source code links

2026-10-21T10:26:56Z

Create PackScan and Inventur documentation with setup instructions, demos and source code links

New page

{{#lang: en}}

== Overview ==

'''PackScan and Inventur''' are two free, open-source mobile web applications for Dolibarr. They support barcode-based order picking, packing verification, stock counting and storage location management.

The applications are developed by Stefan Grumpelt, gRoods.de, and are used daily in his own warehouse.

They run in the smartphone browser and communicate directly with an existing Dolibarr installation through its REST API. No additional application backend or database is required.

== Project information ==

{| class="wikitable"
! Item !! Information
|-
| Applications || PackScan and Inventur (Inventory)
|-
| Author || Stefan Grumpelt, gRoods.de
|-
| Version documented || 1.1.0
|-
| License || GNU General Public License v3.0 or later
|-
| Price || Free download; optional paid setup and support
|-
| Dolibarr compatibility || Developed and used with Dolibarr 24
|-
| Platforms || Safari on iPhone from iOS 16; Chrome on Android
|-
| Interface languages || 24 languages, including English, German, French, Italian and Spanish
|-
| Website || [https://groods.de/packscan/ Project website]
|-
| Source code || [https://github.com/groods-apps/packscan/ GitHub repository]
|-
| Documentation || [https://groods.de/packscan/anleitung-en.html English] / [https://groods.de/packscan/anleitung.html German]
|-
| Contact || info@groods.de
|}

== Features ==

=== PackScan: order picking ===

* Combine open orders into a picking list sorted by storage location.
* Group identical products across multiple orders.
* Display product images, quantities and prominent barcode end digits.
* Display storage locations in a visual wall or shelf grid.
* Scan products or enter quantities manually.
* Allocate picked quantities to the oldest orders first.
* Release complete orders while leaving incomplete orders pending.
* Exclude postage and other non-pickable products through the settings.

=== PackScan: packing verification ===

* Scan a shipment label to open the matching Dolibarr shipment.
* Verify products by barcode before packing them.
* Receive visual and audible feedback for correct and incorrect items.
* View packing progress for each shipment.
* Validate shipments and close orders according to the application settings.

Shipment lookup supports DHL labels and the Data Matrix code of Deutsche Post Internetmarke labels. The shipment number must already be recorded in the corresponding Dolibarr shipment.

=== Inventur: stock counting ===

* Find products using their standard barcode or an additional GTIN field.
* Display product information, images and stock by warehouse.
* Assign or update storage locations.
* Suggest the next storage column when placing products sequentially.
* Adjust stock quantities by warehouse.
* Record the date and time of the last count.
* Warn if a product has already been counted on the same day.

'''Scanning a product does not change stock.''' Selecting Save immediately posts the stock difference as a Dolibarr stock movement with an INV-prefixed reference. Current stock is reloaded before posting.

=== Mobile operation ===

* Camera scanning for EAN, Code 128, QR and Data Matrix.
* Torch control on supported devices and browsers.
* Audible feedback and visual confirmation.
* Protection against repeatedly counting a barcode that remains in view.
* Support for Bluetooth scanners that act as a keyboard.
* Home-screen icons for direct access to each application.

== Requirements ==

* An existing Dolibarr installation accessible over HTTPS.
* Access to the Dolibarr REST API.
* A dedicated API user with appropriate permissions.
* Configured product barcodes and extra fields.
* Products, stock/warehouses, customer orders and shipments enabled for the complete workflow.
* A reliable connection between the smartphone and Dolibarr.

Developed and used with Dolibarr 24. Older versions require separate compatibility testing.

The documented shipping workflow uses DHL and Deutsche Post shipping methods. Shipping-method codes can be adjusted in the application settings.

== Installation ==

These applications are standalone REST API clients, rather than conventional modules installed through the Dolibarr external-module installer.

# Download and extract the application package.
# Create the directory <code>htdocs/custom/lager/</code> in the Dolibarr installation.
# Copy the contents of the package's <code>lager-apps</code> directory into this directory.
# Keep the HTML files, icons and manifest files together.
# Configure the required Dolibarr modules, extra fields and API permissions.
# Open <code>https://your-dolibarr.example/custom/lager/</code> on the smartphone.
# Select an application and open its settings.
# Enter the Dolibarr API address and API token.
# Disable demo mode if enabled and test the connection.
# Review warehouse and stock-movement settings before using live data.

The applications can optionally be added to the smartphone home screen.

Detailed instructions:

* [https://groods.de/packscan/anleitung-en.html English setup guide]
* [https://groods.de/packscan/anleitung.html German setup guide]

=== Extra fields ===

{| class="wikitable"
! Default code !! Object !! Type !! Purpose
|-
| lagerplatz || Product || Text || Storage location, picking order and grid display
|-
| gtin || Product || Text, optional || Additional product barcode
|-
| letzte_inventur || Product || Date and time || Last stock count
|-
| gepickt || Customer order || Date and time || Release after picking
|}

Relevant field codes can be adjusted in the application settings.

The optional server-side shipping automation additionally uses the order field <code>umgebucht</code> to track stock transfers.

=== API permissions ===

Use a dedicated API user and grant only the permissions required for the selected workflow.

The complete workflow requires permissions to:

* Read and update products.
* Read warehouses and create stock movements.
* Read, update and close customer orders.
* Read, create and validate shipments.
* Read third parties.

For initial tests with live data, use a read-only API user where possible.

=== Stock configuration ===

Review Dolibarr's stock-movement settings before completing shipments.

If stock is already deducted when an order or invoice is validated, shipment validation must not deduct it a second time. Configure the stock trigger to match the actual warehouse workflow.

== Storage locations ==

Storage locations are stored as text in a product extra field.

For example, <code>2.LW1.3.12</code> identifies room 2, wall LW1, row 3 and column 12.

The final two parts identify the row and column. Preceding parts describe the room, wall, shelf or other storage structure.

PackScan uses these locations to sort the picking list and display a visual storage grid.

== Optional integrations ==

The free applications do not include:

* Marketplace or webshop order imports.
* Purchasing postage or generating shipping labels.
* Sending tracking information back to marketplaces.
* Server-side shipping automation.

These workflows require separate integrations.

Without shipping automation, labels are created in an external shipping tool and the corresponding shipments are prepared in Dolibarr.

== Limitations ==

=== Connectivity ===

Loading lists, looking up products and saving changes require a connection to Dolibarr.

Local picking and packing progress is stored on the device and retained after a connection interruption. This is not a fully offline workflow.

=== Multiple users ===

* Picking progress is device-local. Use one picker per picking run.
* Multiple people can pack simultaneously when working on different shipments.
* Coordinate stock counts to avoid concurrent updates to the same product and warehouse. Reloading stock before saving does not constitute a reservation or lock.

=== Partial shipments ===

Create genuine partial shipments in Dolibarr.

Finishing packing with missing items does not automatically reduce the quantities recorded in the shipment.

=== Sets and variants ===

* Sets are handled as individual products with their own barcode.
* Components of Dolibarr kits are not expanded.
* Product variants are handled as separate products with their own barcode.

=== Inventory scope ===

* Stock corrections involving lots or serial numbers must be performed in Dolibarr.
* Inventur does not currently provide a separate count sheet or an expected-versus-counted export.
* Inventory movements can be reviewed and exported in Dolibarr.
* The last-count field can be used to identify products that have not yet been counted.

Products without a barcode can be counted manually using the quantity controls.

== Data storage and access ==

Business records are stored in the user's Dolibarr installation.

The browser stores the API address, API token, settings and local workflow progress. Camera images are processed locally and are not uploaded by the applications.

Use a dedicated API user with permissions appropriate to the workflow.

If a device is lost, its access can be revoked by renewing the relevant API user's token in Dolibarr. Other devices using the same token will then need the new token.

== Languages ==

Version 1.1.0 supports 24 interface languages:

Bulgarian, Croatian, Czech, Danish, Dutch, English, Estonian, Finnish, French, German, Greek, Hungarian, Italian, Latvian, Lithuanian, Norwegian, Polish, Portuguese, Romanian, Slovak, Slovenian, Spanish, Swedish and Ukrainian.

The applications follow the browser language by default and fall back to English for unsupported languages. A language can also be selected manually in the settings.

== Updates ==

Replace the application files on the server while keeping the same application URLs. Browser-stored settings remain on the individual devices.

The installed version is displayed in the application settings.

See the [https://groods.de/packscan/#versionen project version history] for release information.

== Demonstrations and download ==

* [https://groods.de/demo/packscan/ PackScan demonstration]
* [https://groods.de/demo/inventur/ Inventur demonstration]
* [https://github.com/groods-apps/packscan/ Source code on GitHub]
* [https://groods.de/packscan/download/lager-apps.zip Download application package]
* [https://groods.de/packscan/anleitung-en.html English setup guide]
* [https://groods.de/packscan/anleitung.html German setup guide]

The demonstrations use example data and require no registration.

When testing with an existing Dolibarr installation, self-hosting the application files on the same origin is the most reliable option. Cross-origin connections from the public demonstration may be blocked by the server, proxy or security configuration.

== Support and contributions ==

Documentation and demonstrations are available online.

Individual support is not included in the free download. Optional paid setup, training and assistance are available by arrangement.

Bugs and feature requests can be submitted through the [https://github.com/groods-apps/packscan/ GitHub repository].

Reports should include the application version, Dolibarr version, browser, device and steps to reproduce the issue.

Do not publish API tokens, credentials or customer data.

Contact: info@groods.de

== License and third-party components ==

Copyright 2026 Stefan Grumpelt, gRoods.de.

PackScan and Inventur are distributed under the '''GNU General Public License v3.0 or later'''.

SPDX-License-Identifier: <code>GPL-3.0-or-later</code>

The software is provided without warranty as described in the license.

Barcode recognition uses ZXing-C++ (Apache-2.0) through zxing-wasm (MIT). Internetmarke Data Matrix decoding follows the approach used by BinaryEye (MIT).

Third-party components retain their respective licenses and notices.

Dolibarr, eBay, DHL and Deutsche Post are trademarks of their respective owners. This is an independent project and is not an official product of those providers.

[[Category:Complementary modules]]

Inventur and PackScan - Revision history

Eldy at 18:26, 22 October 2026

Sgrumpelt: edit the Version number of my current release

Sgrumpelt: Create PackScan and Inventur documentation with setup instructions, demos and source code links