Module Warehouse Scanner Pro: Difference between revisions

Jump to navigation Jump to search
pdated Warehouse Scanner Pro documentation for version 1.1.0: redesigned Scanner UI, FEFO lot/expiry management, Customer Order Pick & Pack, backorders, partial shipments, packing list, shipping label and EN/RO/DE/FR/ES support.
(Created documentation page for Warehouse Scanner Pro 1.0.6)
Tag: 2017 source edit
 
(pdated Warehouse Scanner Pro documentation for version 1.1.0: redesigned Scanner UI, FEFO lot/expiry management, Customer Order Pick & Pack, backorders, partial shipments, packing list, shipping label and EN/RO/DE/FR/ES support.)
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
'''Warehouse Scanner Pro''' is a mobile-friendly warehouse management module for Dolibarr. It allows warehouse operators to scan barcodes and QR codes, manage stock movements, perform saved inventory counts, receive supplier orders and print product labels.
[[File:Warehouse_Scanner_Pro_1.1.0_Cover.png|center|900px|Warehouse Scanner Pro 1.1.0]]


The module can be used with a mobile phone camera, a USB barcode scanner or manual product reference input.
'''Warehouse Scanner Pro''' is a professional mobile-friendly warehouse scanning and order preparation module for [[Dolibarr ERP CRM]].


== Main features ==
It allows warehouse operators to use a smartphone camera, USB barcode scanner or manual barcode/reference input to manage stock movements, inventories, lot and expiry tracking, supplier receipts and customer order Pick & Pack directly inside Dolibarr.


* Mobile barcode and QR code scanning
Version '''1.1.0''' introduces a redesigned scanner workflow, FEFO lot selection, multilingual support and a complete Customer Order Pick & Pack workflow with backorders, partial shipments, packing lists and shipping labels.
* Manual product reference and barcode input
* USB barcode scanner support
* Stock reception and stock removal
* Warehouse-to-warehouse stock transfers
* Saved and resumable inventory sessions
* Inventory continuation from another phone or computer
* Cumulative scanning of the same product
* Edit or delete counted quantities before finalization
* Automatic calculation of theoretical stock, counted stock and differences
* Transactional application of all inventory differences
* Detection of stock changes during an inventory
* Inventory counting by lot or batch
* Separate inventory lines for different lots of the same product
* Lot number and expiry-date tracking
* Mixed inventories with products managed with and without lots
* Supplier purchase order receipt workflow
* Partial and complete supplier order reception
* Supplier order status synchronization
* Recent scanner operation history
* Controlled cancellation of scanner-created stock movements
* CSV and XLSX reports
* Barcode and QR product labels
* Labels containing product reference, lot and expiry date
* Granular user permissions and quick permission profiles
* Mobile-friendly user interface


== Saved inventories ==
==Main features==


Inventory sessions are saved in the Dolibarr database.
*Mobile barcode and QR code scanning
*Manual barcode or product reference input
*USB barcode scanner support
*Stock reception
*Stock removal / shipment preparation
*Warehouse-to-warehouse stock transfers
*Inventory counting and stock adjustment
*Undo of scanner-created stock movements
*Saved and resumable inventory sessions
*Stock display by warehouse
*Lot / batch and expiry-date management
*FEFO lot selection
*Supplier purchase order checking and receiving
*Product label generation
*Customer Order Pick & Pack
*Backorder management
*Partial shipment creation
*Packing workflow
*Dolibarr shipment creation and validation
*Packing List generation
*Shipping Label generation
*Complete scan and movement history
*Granular user permissions
*Responsive desktop and mobile interface


A user can:
==Dashboard==


# Create an inventory for a selected warehouse.
Warehouse Scanner Pro provides a centralized dashboard for the main warehouse workflows:
# Scan products or enter their references manually.
# Count the same product several times.
# Save the inventory and continue it later.
# Resume the inventory from another device.
# Edit or remove counted lines before finalization.
# Compare theoretical stock with physically counted stock.
# Apply all differences together after final confirmation.


The stock is not modified while the inventory is being counted.
*Scanner
*Customer Order Pick & Pack
*Saved Inventories
*Product Labels
*Scan Log
*Quick Stock
*Supplier Order Check
*Supplier Stock Receipt


If the stock of a counted product changes before finalization, the module can block the operation to prevent an incorrect adjustment.
[[File:Warehouse_Scanner_Pro_1.1.0_Dashboard.png|center|900px|Warehouse Scanner Pro 1.1.0 dashboard]]


== Lot and expiry management ==
==Mobile warehouse scanner==


Warehouse Scanner Pro supports products managed by lot or batch.
The main scanner workflow is designed for fast warehouse operations on both desktop and mobile devices.


For each lot, the module displays:
The standard workflow is organized into clear steps:


* Lot or serial number
#Select the operation
* Expiry date
#Scan or enter the product
* Current theoretical quantity
#Select the warehouse
* Physically counted quantity
#Select the destination warehouse when required
* Inventory difference
#Enter the quantity
#Validate and apply the movement


Several lots of the same product can be counted in one inventory. Each lot is stored and adjusted separately.
Supported operations include:


The module also supports inventories containing both:
*Receive stock
*Remove / ship stock
*Transfer stock
*Inventory / count


* Products without lot management
[[File:Warehouse_Scanner_Pro_1.1.0_Mobile_Scanner.png|center|450px|Warehouse Scanner Pro mobile scanner workflow]]
* Products with lot and expiry management


== Supplier order reception ==
The second part of the mobile workflow provides warehouse selection, quantity controls and movement actions.


The module provides a mobile-friendly supplier order receipt workflow.
[[File:Warehouse_Scanner_Pro_1.1.0_Mobile_Quantity_Actions.png|center|450px|Warehouse Scanner Pro mobile quantity and stock movement controls]]
 
Advanced options such as accepted barcode types, scan stability, continuous scanning and sound/vibration feedback are available under '''Customize scanner''', keeping the normal operational screen simple.
 
==Lot, batch and expiry management==
 
Warehouse Scanner Pro supports Dolibarr products managed by lot or batch.
 
For lot-controlled products, the module can:
 
*Detect automatically that lot information is required
*Require a lot / serial number before applying a movement
*Require an expiry date when configured in Dolibarr
*Display available lots from the selected warehouse
*Display stock available for each lot
*Display expiry dates
*Sort lots using FEFO
*Automatically select the only available lot when applicable
*Receive stock into an existing or new lot
*Remove stock from a selected lot
*Transfer lot-controlled stock between warehouses
*Perform inventory adjustments by lot
 
[[File:Warehouse_Scanner_Pro_1.1.0_Lot_Expiry_FEFO.png|center|900px|Lot expiry and FEFO management in Warehouse Scanner Pro]]
 
For stock removal and transfers, available lots can be displayed in FEFO order so operators can select the stock with the earliest expiry date first.
 
==Customer Order Pick & Pack==
 
Version 1.1.0 introduces a complete '''Customer Order Pick & Pack''' workflow integrated with Dolibarr customer orders.
 
Operators can:
 
*Open an active customer order
*Select the source warehouse
*View the customer and order reference
*View the expected product
*View the product barcode
*View required quantity
*View available warehouse stock
*Scan products one unit at a time
*Prevent incorrect product scans
*Prevent over-picking
*Track picking progress for each line
*Automatically move to the next order line
*Resume a persistent Pick & Pack session
 
[[File:Warehouse_Scanner_Pro_1.1.0_Customer_Order_Pick_Pack.png|center|900px|Customer Order Pick and Pack workflow]]
 
===Wrong product protection===
 
If an operator scans a product that does not match the expected order line, Warehouse Scanner Pro rejects the scan and keeps the picking progress unchanged.
 
This helps reduce warehouse picking errors.
 
===Backorders and partial shipments===
 
When the available stock is lower than the ordered quantity, Warehouse Scanner Pro can:
 
*Detect the stock shortage
*Allow the available quantity to be picked
*Mark the remaining quantity as backorder
*Keep picked and backordered quantities separate
*Continue the workflow without falsely marking missing products as scanned
*Create a partial Dolibarr shipment containing only the picked quantity
 
[[File:Warehouse_Scanner_Pro_1.1.0_Backorder_Partial_Shipment.png|center|900px|Backorder and partial shipment handling]]
 
Example:
 
*Ordered: 5
*Picked: 2
*Backorder: 3
 
Only the 2 picked units are included in the current shipment. The remaining 3 units stay available for a later shipment.
 
==Packing and shipment workflow==
 
After picking is complete, Warehouse Scanner Pro provides a structured packing workflow.
 
The workflow can progress through:
 
#Picking
#Picked
#Packing
#Packed
#Shipment created
#Shipment validated
#Shipment processed
 
The module uses Dolibarr's native shipment functionality and respects the configured Dolibarr stock management rules.
 
Depending on the Dolibarr configuration, stock may decrease when the shipment is validated or when the shipment is closed/processed.
 
Warehouse Scanner Pro detects the shipment status and displays the appropriate next action.
 
[[File:Warehouse_Scanner_Pro_1.1.0_Packing_Shipment_Completed.png|center|900px|Completed packing and shipment workflow]]
 
==Packing List==
 
Warehouse Scanner Pro can generate a printable Packing List containing:
 
*Shipment reference
*Customer order reference
*Warehouse
*Ship-from information
*Ship-to information
*Product reference
*Product description
*Barcode
*Packed quantity
*Backorder quantity
*Packing summary
*Packed-by / checked-by fields
*Signature field
 
[[File:Warehouse_Scanner_Pro_1.1.0_Packing_List.png|center|900px|Warehouse Scanner Pro Packing List]]
 
==Shipping Label==
 
A printable shipping label can also be generated directly from the Pick & Pack workflow.
 
The label can include:
 
*Ship-from information
*Ship-to information
*Shipment reference
*Customer order reference
*Scannable shipment barcode
 
[[File:Warehouse_Scanner_Pro_1.1.0_Shipping_Label.png|center|650px|Warehouse Scanner Pro Shipping Label]]
 
==Saved inventories==
 
Warehouse Scanner Pro supports persistent inventory sessions stored in the Dolibarr database.
 
An inventory can be:
 
*Created for a selected warehouse
*Saved and resumed later
*Continued from another device
*Updated with repeated scans of the same product
*Used with products managed with or without lots
*Used with multiple lots of the same product
 
For each inventory line, the module can display:
 
*Theoretical stock
*Counted stock
*Difference
*Lot
*Expiry date
 
Stock is modified only after the inventory is finalized.
 
Inventory differences are applied together after confirmation.
 
==Supplier order receiving==
 
The module includes workflows for supplier purchase orders.


Warehouse operators can:
Warehouse operators can:


* Open a supplier purchase order
*Open a supplier purchase order
* Scan received products
*Check ordered products
* Compare ordered and received quantities
*Scan received products
* Record partial receptions
*Compare ordered and received quantities
* Complete the reception
*Record stock receipts
* Synchronize the supplier order status
*Process partial receipts
* Cancel recent scanner-created receptions when permission allows it
*Synchronize supplier order reception status
* Export reception reports
*Export receipt information


== Product labels ==
==Product labels==


Warehouse Scanner Pro can generate printable labels containing:
Warehouse Scanner Pro can generate printable product labels containing information such as:


* Product reference
*Product reference
* Barcode or QR code
*Barcode
* Lot number
*QR code
* Expiry date
*Lot
*Expiry date


Different label formats can be used for products, packages and warehouse shelves.
Labels can be used for products, boxes and warehouse operations.


== Compatibility ==
==Scan history and auditability==
 
Scanner-created operations remain traceable.
 
The module can record information such as:
 
*Date and time
*Dolibarr user
*Product
*Warehouse
*Quantity
*Lot
*Expiry date
*Stock before movement
*Stock after movement
*Operation type
 
The '''Undo last movement''' function creates a compensating stock movement instead of deleting the original movement, preserving the audit history.
 
==Multilingual support==
 
Warehouse Scanner Pro 1.1.0 includes the following languages:
 
*English
*Romanian
*German
*French
*Spanish
 
==Permissions==
 
Warehouse Scanner Pro provides granular permissions for warehouse users.
 
Permissions can be configured for operations such as:
 
*Module access
*Stock reception
*Stock removal
*Stock transfer
*Inventory counting
*Saved inventories
*Supplier order checking
*Supplier order receiving
*Product labels
*Scan history
*Customer Order Pick & Pack
 
Users do not need administrator permissions to perform their assigned warehouse operations.
 
==Requirements==
 
The following Dolibarr modules should be enabled as required by the workflow:
 
*Products / Services
*Stock / Warehouses
*Customer Orders for Pick & Pack
*Shipments for shipment creation
*Supplier Orders for supplier receiving workflows
*Lots / Batches for lot-controlled products
 
HTTPS is recommended when using the smartphone camera because modern browsers normally require a secure connection for camera access.
 
==Compatibility==


{| class="wikitable"
{| class="wikitable"
! Module version
!Warehouse Scanner Pro
! Dolibarr
!Dolibarr
! PHP
!PHP
|-
|-
| 1.0.6
|'''1.1.0'''
| 23.x to 24.x
|'''23.x – 24.x'''
| 8.0 or newer
|'''8.0+'''
|}
|}


The module was tested with Dolibarr 23.0.3.
The module has been tested with Dolibarr 23.x and 24.x environments.
 
==Installation==
 
#Download the Warehouse Scanner Pro ZIP package.
#Deploy the package into the Dolibarr custom modules directory.
#Verify that the module directory is named <code>warehousescannerpro</code>.
#Open '''Home → Setup → Modules/Applications'''.
#Enable '''Warehouse Scanner Pro'''.
#Configure the required user permissions.
#Open the Warehouse Scanner Pro menu.


== Requirements ==
==Upgrade==


The following Dolibarr modules must be enabled:
To upgrade from an earlier Warehouse Scanner Pro version:


* Products/Services
#Back up the Dolibarr database and the existing module directory.
* Stock/Warehouse
#Replace the existing <code>warehousescannerpro</code> files with the new version.
#Reload Dolibarr.
#Clear the browser cache if necessary.
#Verify the module version and configuration.


HTTPS is recommended when scanning with a mobile phone camera because browsers generally require a secure connection for camera access.
For normal 1.x updates, disabling and re-enabling the module is not normally required unless specifically stated in the release notes.


== Installation ==
Existing Warehouse Scanner Pro data is preserved during the update.


# Download the module ZIP package.
==What's new in version 1.1.0==
# Copy or deploy the package into the Dolibarr custom modules directory.
# Verify that the module directory is named <code>warehousescannerpro</code>.
# Open Dolibarr module configuration.
# Enable '''Warehouse Scanner Pro'''.
# Configure permissions for the users who will operate the scanner.
# Open the Warehouse Scanner Pro menu and select the required operation.


Existing inventory database tables are preserved during an upgrade.
Warehouse Scanner Pro 1.1.0 is a major functional update.


== Upgrade ==
Main improvements include:


To upgrade from an earlier version:
*Redesigned warehouse Scanner interface
*Improved mobile usability
*Clear workflow: Operation → Product → Warehouse → Quantity
*Dynamic destination warehouse for transfers
*Dynamic lot and expiry fields
*Available-lot selector
*FEFO lot ordering
*Automatic lot selection when only one lot is available
*Improved lot and expiry validation
*Customer Order Pick & Pack
*Wrong-product scan protection
*Picking progress by order line
*Persistent picking sessions
*Stock shortage detection
*Skip / Backorder workflow
*Partial shipment creation
*Packing workflow
*Dolibarr shipment creation and validation
*Intelligent shipment closing according to Dolibarr stock rules
*Packing List
*Shipping Label with shipment barcode
*German language
*French language
*Spanish language
*Improved English and Romanian translations
*Improved dashboard and mobile interface


# Back up the Dolibarr database and the existing module directory.
==Use cases==
# Replace the existing <code>warehousescannerpro</code> directory with the new version.
# Reload the Dolibarr page and clear the browser cache if necessary.
# Verify the module version and settings.


Disabling and re-enabling the module is normally not required for a minor upgrade unless specifically indicated in the release notes.
Warehouse Scanner Pro can be used for:


== Version 1.0.6 ==
*Warehouse receiving
*Stock removal
*Internal stock transfers
*Physical inventory counting
*Lot and expiry management
*FEFO warehouse operations
*Supplier order receiving
*Customer order picking
*Packing
*Partial shipment management
*Backorder management
*Product labeling
*Mobile warehouse operations


Version 1.0.6 includes:
It is suitable for distributors, wholesalers, laboratories, pharmaceutical and manufacturing companies, service organizations and other Dolibarr users who need structured barcode-based warehouse workflows.


* Official Dolibarr barcode or product reference displayed consistently
==DoliStore==
* Case-insensitive product search
* Unicode support for inventory names and notes
* Saved and resumable inventories
* Lot-aware inventory counting
* Mixed inventories with products with and without lots
* Correct handling of long numeric barcodes in CSV exports
* Improved Romanian and English translations
* Improved mobile inventory interface
* Safer transactional stock adjustment


== Use cases ==
Warehouse Scanner Pro is available on DoliStore:


Warehouse Scanner Pro can be used for:
https://www.dolistore.com/product.php?id=3262&title=warehouse-scanner-pro&l=en


* Receiving products into stock
==Support==
* Removing products from stock
* Moving products between warehouses
* Physical stock counting
* Batch and expiry-date verification
* Supplier purchase order reception
* Internal barcode and QR label printing
* Mobile warehouse operations


== Support ==
Product support:


Support contact:
'''PanciucSoft'''


<code>mikrosha2000@gmail.com</code>
Email: '''support@panciucsoft.com'''


The commercial product page is available through DoliStore after approval of the current version.
Website: https://panciucsoft.com/


== Author ==
==Author==


'''Vasile Panciuc'''
'''Vasile Panciuc / PanciucSoft'''


[[Category:Complementary modules]]
[[Category:Complementary modules]]
[[Category:Stock]]
[[Category:Warehouse]]
222

edits

Navigation menu