Skip to content

[ADD] barcode: serial numbers and lots #13363

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

Open
wants to merge 1 commit into
base: 18.0
Choose a base branch
from

Conversation

slinkous
Copy link
Contributor

  • Coverage for printing and managing barcoders for product serial numbers and lot numbers

@robodoo
Copy link
Collaborator

robodoo commented May 14, 2025

Pull request status dashboard

@C3POdoo C3POdoo requested a review from a team May 14, 2025 01:27
@slinkous slinkous requested review from Felicious and removed request for a team May 14, 2025 01:27
@slinkous slinkous self-assigned this May 14, 2025
@slinkous slinkous added the 5 label May 14, 2025
Copy link
Contributor Author

@slinkous slinkous left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Felicious this is going to fail CI checks because it's not in the tree, but both my current PR's will go to the same place, so I just need to figure out which one of them gets approved first.

Copy link
Contributor

@Felicious Felicious left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fantastic work with this doc, @slinkous!

It's a very comprehensive doc that covers a variety of use cases and considers many tedious tasks a warehouse user might face, including getting blocked when a shipping label is damaged during transit! That's something I would've never thought of! I can tell you did a lot of research from the master class and watching BE's OXP videos from the previous 2-3 years 😊

I just had some minor nitpicks on wording in this review, and it's ready to go to the next stage after looking through them!

In the case where there are merge conflicts (one will occur in setup.rst), we write in the PR description which one is meant to be merged first. After we merge the first PR, we'll rebase the second PR, resolve the merge conflicts, push the second PR back up, wait for the tests to finish, then merge the second!

After addressing my comments, let's just add the serial_numbers_lots.rst file to setup.rst, so the checks pass for the next reviewer (:

the line for the product, and click the :icon:`fa-list` :guilabel:`(list)` icon. In the
:guilabel:`Open: Stock move` pop-up menu, click :guilabel:`Generate Serials/Lots`.

.. image:: serial_numbers_lots/serial-number-generate.png
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we no longer use markup on images! is the blue rectangle something you added yourself, or something that shows up in the UI if you do something? o:

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Okay, so I didn't add it, but it's weird to reproduce how it happened... it appears sometimes after I have hovered the button...

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

okie let's just leave the image alone! maybe it's a UI thing. I dont want to make you reproduce the image for a small thing, esp since it can technically happen

Comment on lines 14 to 21
To use serial numbers or lots, they must be enabled in the database and tracking by lot or serial
number must be selected for each product. See the :doc:`serial numbers documentation
<../../inventory/product_management/product_tracking/serial_numbers>` and :doc:`lots documentation
<../../inventory/product_management/product_tracking/lots>` to learn how to start using this
feature.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Again a nitpick, and just a suggestion, but im wondering if this would be better a numbered list

Suggested change
To use serial numbers or lots, they must be enabled in the database and tracking by lot or serial
number must be selected for each product. See the :doc:`serial numbers documentation
<../../inventory/product_management/product_tracking/serial_numbers>` and :doc:`lots documentation
<../../inventory/product_management/product_tracking/lots>` to learn how to start using this
feature.
To use lots or serial numbers:
#. They must be enabled in the database.
#. Tracking by lot or serial number must be selected for each product.
See the :doc:`serial numbers documentation
<../../inventory/product_management/product_tracking/serial_numbers>` and :doc:`lots documentation
<../../inventory/product_management/product_tracking/lots>` to learn how to start using this
feature.


To print a barcode for one or multiple product serial numbers and lots, go to
:menuselection:`Inventory app --> Products --> Lots / Serial Numbers`. In the list view, tick the
box for all the products to print, click the :icon:`fa-print` :guilabel:`Print` button, and select
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
box for all the products to print, click the :icon:`fa-print` :guilabel:`Print` button, and select
checkbox for each the product to print, click the :icon:`fa-print` :guilabel:`Print` button, and select

Operations
==========

For any product that is tracked by serial number, performing an operation with barcode can be done
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is it just serial numbers, or are lots included as well?

"Performing an operation with barcode" --> "Barcode"?

Comment on lines 52 to 54
To make it mandatory to scan a barcode for serial numbers and lots, go to :menuselection:`Inventory
app --> Configuration --> Operations Types` and select the operation type where barcodes should be
required for serial numbers. Then, click the :guilabel:`Barcode App` tab and in the
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unlike the GS1 configuration one, I think the instructions should go above the image (:

Copy link
Contributor

@Felicious Felicious left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @slinkous ! Due to the changes to final review, I'd like to take a quick review on this PR after you address my comments, then we'll pass it to sam for technical review (: sound good? :D

Copy link
Contributor Author

@slinkous slinkous left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

was there a particular reason why the instructions below are about enabling mandatory scan, but the image has optional scan highlighted? For consistency, it might be better for the image to match the instructions and the heading of the section

The instructions are about selecting the appropriate setting, it's just that the UI calls this Mandatory Scan. Renaming section to clairfy.

Copy link
Contributor Author

@slinkous slinkous left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

was there a particular reason why the instructions below are about enabling mandatory scan, but the image has optional scan highlighted? For consistency, it might be better for the image to match the instructions and the heading of the section

The instructions are about selecting the appropriate setting, it's just that the UI calls this Mandatory Scan. Renaming section to clairfy.

@slinkous slinkous force-pushed the 18.0-barcode-serials-lots-stul branch 2 times, most recently from 1f1d734 to 6aa08e9 Compare May 16, 2025 18:07
@slinkous slinkous force-pushed the 18.0-barcode-serials-lots-stul branch from 6aa08e9 to 9187b25 Compare May 16, 2025 18:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants