Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[16.0][IMP] stock_barcodes #668

Open
wants to merge 9 commits into
base: 16.0
Choose a base branch
from
223 changes: 212 additions & 11 deletions stock_barcodes/README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ Stock Barcodes
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:57d26158322c09cb66f30397e6644567bf9240ecc415f7fd48ec7bc6e6406ec9
!! source digest: sha256:e7ccaa03134ef9bad1cb0e83f96ba7617e6ff97f7b09ded6510b4c5a74404a79
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
Expand Down Expand Up @@ -36,6 +36,10 @@ other modules.
This module also makes use of this wizard for providing barcode support for
doing inventories and picking operations.

This module provides configuring barcodes for barcode actions.



**Table of contents**

.. contents::
Expand All @@ -47,13 +51,74 @@ Usage
Barcode interface for inventory operations
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

To use the barcode interface on inventory:
Option 1: To use the barcode interface on inventory

#. Go to *Inventory > operations > Inventory Adjustments*.
#. Create new inventory with "Select products manually" option.
#. Start inventory.
#. Click to "Scan barcodes" smart button.
#. Start reading barcodes.

Option 2: Use the barcode interface inventory directly from the Barcodes application
#. Go to *Barcodes*.
#. Select the *Inventory* option.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/inventory_barcode_action.png
:height: 100
:width: 200
:alt: Inventory barcode action

#. Start scanning barcodes.

Actions
# Press the *+ Product* button to display the form for the new item.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/add_product.png
:height: 100
:width: 200
:alt: Add product

# When you select a product, a numeric field is displayed to add the quantity.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/form_add_product_quantity.png
:height: 100
:width: 200
:alt: Add quantity product

# When you press the button with the trash can icon, the values of the form are reset (except for the location) without closing it.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/form_add_product_reset.png
:height: 100
:width: 200
:alt: Reset data form

# When you press the *Clean values* button, all fields are reset and the form is closed.
# When you press the *Confirm* button, the new item is added and the form is closed.
# When the eye icon is closed, the created items greater than zero are displayed, and if not, those less than or equal to zero.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/list_items.png
:height: 100
:width: 200
:alt: Reset data form

# In the list, the trash can icon allows you to reset the quantity to zero and the edit icon allows you to change the item values.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/list_action_items.png
:height: 100
:width: 200
:alt: Reset data form

# The *Apply* button is only displayed if there are items with quantities greater than zero, regardless of whether they were scanned or entered manually; If you press all the defined quantities will be processed after defining the reason for the inventory adjustment and then the main barcode menu will be displayed.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/apply_inventory.png
:height: 100
:width: 200
:alt: Apply inventory
.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/apply_inventory_reason.png
:height: 100
:width: 200
:alt: Apply inventory reason

#. Go to *Inventory > operations > Inventory Adjustments*.
#. Create new inventory with "Select products manually" option.
#. Start inventory.
#. Click to "Scan barcodes" smart button.
#. Start reading barcodes.

Barcode interface for picking operations
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Expand All @@ -67,11 +132,109 @@ To use the barcode interface on picking operations:
#. Click on scanner button on any operation type.
#. Start reading barcodes.

To use the barcode interface on a picking:
Option 1: To use the barcode interface on a picking:

#. Go to *Inventory > Transfers*.
#. Click to "Scan barcodes" smart button.
#. Start reading barcodes.
#. Go to *Inventory > Transfers*.
#. Click to "Scan barcodes" smart button.
#. Start reading barcodes.

Option 2: Use the barcode interface picking directly from the Barcodes application
#. Go to *Barcodes*.
#. Select the option *OPERATIONS*.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/inventory_barcode_action.png
:height: 100
:width: 200
:alt: Operation barcode action

# Select the type of picking.
# The pickings in ready status are displayed, select the one you want to start scanning.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/list_picking.png
:height: 100
:width: 200
:alt: List picking

#. Start scanning barcodes.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/barcode_interface_picking.png
:height: 100
:width: 200
:alt: List picking

Actions
# All the items that have been configured for the selected picking are listed.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/list_items_picking.png
:height: 100
:width: 200
:alt: List picking

# The edit icon in the list allows you to modify the data.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/list_items_picking_edit.png
:height: 100
:width: 200
:alt: Edit picking

# The button that contains a *+120* (in this case), allows you to define all the
remaining quantities. Once defined, this button disappears and if you want to change the
quantities, press the edit button.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/list_items_picking_quantity.png
:height: 100
:width: 200
:alt: Quantity picking

# If there is at least one item with a quantity already defined, an eye icon is displayed,
which if closed shows the items and their quantities already scanned.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/list_items_picking_scanned.png
:height: 100
:width: 200
:alt: Picking scanned

# When you press the *Validate* button, a wizard will be displayed to confirm the action.
If everything is correct, it is validated and you return to the picking list mentioned above.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/confirm_items_picking.png
:height: 100
:width: 200
:alt: Picking scanned

# If there is an item whose quantity is zero, a wizard will be displayed after the one mentioned
above, to confirm if you want to process all the quantities. If positive, you will proceed
and be directed to the list mentioned above in the previous point.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/confirm_all_quantity_items_picking.png
:height: 100
:width: 200
:alt: Picking scanned

# Press the *+ Product* button to display the form for the new item.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/add_product.png
:height: 100
:width: 200
:alt: Add product

# When you select a product, a numeric field is displayed to add the quantity.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/form_add_product_quantity.png
:height: 100
:width: 200
:alt: Add quantity product

# When you press the button with the trash can icon, the values of the form are reset (except for the location) without closing it.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/form_add_product_reset.png
:height: 100
:width: 200
:alt: Reset data form

# When you press the *Clean values* button, all fields are reset and the form is closed.
# When you press the *Confirm* button, the new item is added and the form is closed.
# When adding the new item all the quantities are assigned to it, if you want to modify it, press the edit icon.

The barcode scanner interface has two operation modes. In both of them user
can scan:
Expand Down Expand Up @@ -124,6 +287,28 @@ this log is show to user other reads with the same product and location done
by other users.
User can remove the last read scan.

Barcode interface for barcode actions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
To use the barcode interface for actions:

#. Go to *Inventory > Configuration > Barcode Actions*.
#. Create a new barcode action and configure the barcode.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/create_barcode_action.png
:height: 100
:width: 200
:alt: Print barcodes

#. Select the barcode actions you want to use, a button (PRINT BARCODES) will appear that allows you to print the configured barcodes to PDF.

.. image:: https://raw.githubusercontent.com/stock_barcodes/static/src/img/print_barcodes.png
:height: 100
:width: 200
:alt: Print barcodes

#. Go to *Barcodes*.
#. Start scanning barcodes from actions.

Known issues / Roadmap
======================

Expand Down Expand Up @@ -153,6 +338,18 @@ Changelog
* [ADD] New feature.
Add security for users.

16.0.1.0.0 (2025-01-23)
~~~~~~~~~~~~~~~~~~~~~~~
* [IMP]
Improved views to optimize navigation and functionality.
Intuitive and mobile-friendly views.
Visual improvement of the main view accessed from the Barcodes menu.

* [ADD] New feature.
Barcode reading to barcode actions.
Generate PDF document for the barcodes of the selected barcode actions.


Bug Tracker
===========

Expand Down Expand Up @@ -196,6 +393,10 @@ Contributors

* Enric Tobella

* `Binhex Cloud <https://www.binhex.cloud/>`_:

* Edilio Escalona Almira

Maintainers
~~~~~~~~~~~

Expand Down
1 change: 1 addition & 0 deletions stock_barcodes/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,5 @@

from . import models
from . import wizard
from . import reports
from .hooks import pre_init_hook
9 changes: 7 additions & 2 deletions stock_barcodes/__manifest__.py
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
"website": "https://github.com/OCA/stock-logistics-barcode",
"license": "AGPL-3",
"category": "Extra Tools",
"depends": ["barcodes", "stock", "web_widget_numeric_step"],
"depends": ["barcodes", "stock", "web_widget_numeric_step", "web", "mail"],
"data": [
"security/ir.model.access.csv",
"views/stock_barcodes_action_view.xml",
Expand All @@ -24,6 +24,9 @@
"data/stock_barcodes_action.xml",
"data/stock_barcodes_option.xml",
"views/stock_barcodes_menu.xml",
# Reports
"reports/barcode_actions_report.xml",
"reports/reports.xml",
],
"assets": {
"web.assets_backend": [
Expand All @@ -33,8 +36,10 @@
"/web_widget_numeric_step/static/src/numeric_step.xml",
"/stock_barcodes/static/src/widgets/numeric_step.xml",
),
"/stock_barcodes/static/src/views/kanban/stock_barcodes_kanban.xml",
"/stock_barcodes/static/src/widgets/view_button.xml",
"/stock_barcodes/static/src/css/stock.scss",
"/stock_barcodes/static/src/views/actions/stock_barcode_main_menu.xml",
"/stock_barcodes/static/src/**/*.scss",
],
},
"installable": True,
Expand Down
8 changes: 8 additions & 0 deletions stock_barcodes/data/stock_barcodes_action.xml
Original file line number Diff line number Diff line change
Expand Up @@ -39,4 +39,12 @@
<field name="key_char_shortcut">8</field>
<field name="context">{'inventory_mode': True}</field>
</record>

<record id="stock_barcodes_action_barcode_operations" model="stock.barcodes.action">
<field name="name">Operations</field>
<field name="sequence">40</field>
<field name="action_window_id" ref="stock.stock_picking_type_action" />
<field name="key_char_shortcut">9</field>
<field name="context">{'operations_mode': True}</field>
</record>
</odoo>
Loading
Loading