222
edits
Mikrosha2000 (talk | contribs) (Created documentation page for Warehouse Scanner Pro 1.0.6) Tag: 2017 source edit |
Mikrosha2000 (talk | contribs) (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: | ||
[[File:Warehouse_Scanner_Pro_1.1.0_Cover.png|center|900px|Warehouse Scanner Pro 1.1.0]] | |||
'''Warehouse Scanner Pro''' is a professional mobile-friendly warehouse scanning and order preparation module for [[Dolibarr ERP CRM]]. | |||
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. | |||
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. | |||
== | ==Main features== | ||
Inventory sessions | *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 | |||
==Dashboard== | |||
Warehouse Scanner Pro provides a centralized dashboard for the main warehouse workflows: | |||
*Scanner | |||
*Customer Order Pick & Pack | |||
*Saved Inventories | |||
*Product Labels | |||
*Scan Log | |||
*Quick Stock | |||
*Supplier Order Check | |||
*Supplier Stock Receipt | |||
[[File:Warehouse_Scanner_Pro_1.1.0_Dashboard.png|center|900px|Warehouse Scanner Pro 1.1.0 dashboard]] | |||
== | ==Mobile warehouse scanner== | ||
The main scanner workflow is designed for fast warehouse operations on both desktop and mobile devices. | |||
The standard workflow is organized into clear steps: | |||
#Select the operation | |||
#Scan or enter the product | |||
#Select the warehouse | |||
#Select the destination warehouse when required | |||
#Enter the quantity | |||
#Validate and apply the movement | |||
Supported operations include: | |||
*Receive stock | |||
*Remove / ship stock | |||
*Transfer stock | |||
*Inventory / count | |||
[[File:Warehouse_Scanner_Pro_1.1.0_Mobile_Scanner.png|center|450px|Warehouse Scanner Pro mobile scanner workflow]] | |||
The second part of the mobile workflow provides warehouse selection, quantity controls and movement actions. | |||
The module | [[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 | *Compare ordered and received quantities | ||
* | *Record stock receipts | ||
* Synchronize | *Process partial receipts | ||
*Synchronize supplier order reception status | |||
* Export | *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 | *Barcode | ||
* Lot | *QR code | ||
* Expiry date | *Lot | ||
*Expiry date | |||
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" | ||
! | !Warehouse Scanner Pro | ||
! Dolibarr | !Dolibarr | ||
! PHP | !PHP | ||
|- | |- | ||
| 1.0 | |'''1.1.0''' | ||
| 23.x | |'''23.x – 24.x''' | ||
| 8.0 | |'''8.0+''' | ||
|} | |} | ||
The module | 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. | |||
== | ==Upgrade== | ||
To upgrade from an earlier Warehouse Scanner Pro version: | |||
#Back up the Dolibarr database and the existing module directory. | |||
#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. | |||
For normal 1.x updates, disabling and re-enabling the module is not normally required unless specifically stated in the release notes. | |||
Existing Warehouse Scanner Pro data is preserved during the update. | |||
==What's new in version 1.1.0== | |||
Warehouse Scanner Pro 1.1.0 is a major functional update. | |||
Main improvements include: | |||
*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 | |||
==Use cases== | |||
Warehouse Scanner Pro can be used for: | |||
*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 | |||
It is suitable for distributors, wholesalers, laboratories, pharmaceutical and manufacturing companies, service organizations and other Dolibarr users who need structured barcode-based warehouse workflows. | |||
==DoliStore== | |||
Warehouse Scanner Pro is available on DoliStore: | |||
https://www.dolistore.com/product.php?id=3262&title=warehouse-scanner-pro&l=en | |||
==Support== | |||
Product support: | |||
'''PanciucSoft''' | |||
Email: '''support@panciucsoft.com''' | |||
Website: https://panciucsoft.com/ | |||
== Author == | ==Author== | ||
'''Vasile Panciuc''' | '''Vasile Panciuc / PanciucSoft''' | ||
[[Category:Complementary modules]] | [[Category:Complementary modules]] | ||
[[Category:Stock]] | |||
[[Category:Warehouse]] | |||
edits