- APPS
- MRP Barcode 19.0
| Lines of Code | 964 |
| Technical name | viin_mrp_barcode |
| License | OPL-1 |
| Website | https://viindoo.com/apps/modules/19.0/viin_mrp_barcode |
| Read description for | v 10.0 v 11.0 v 12.0 v 13.0 v 14.0 v 15.0 v 16.0 v 17.0 v 18.0 |
| Required Apps | Manufacturing (mrp) Discuss (mail) Inventory (stock) Employees (hr) |
| Included Dependencies | Shop Floor Control Stock Barcode Viindoo Manufacturing Web Gantt |
Operators scan the label instead of typing what they made
For manufacturers that run work orders at the machine on a tablet or a phone
Add barcode scanning support to manufacturing
Odoo 19.0 · Community Edition, Viindoo Cloud · OPL-1
Extends Shop Floor Control and Stock Barcode - see their documentation.
What changes for your team
The label records the output
Today: operators type quantities and lot numbers on a small screen, and typos reach the stock.
→ A scanned product, lot, serial number or GS1 label records the output of the open work order, with the same entries and the same Undo as a tap.
A printed sheet presses the buttons
Today: gloved hands hunt for the right button, and every new operator needs a tour of the screens.
→ One sheet per screen lists each action beside its code: start, pause, record output, finish, stop the machine, close the order, and the buttons of the manufacturing order. Print it once; it works for every order.
A wrong scan changes nothing
Today: a label from another job is entered and found at the stock count.
→ A scan stays on the work order it was read for. Another product, a lot of another product, a unit that does not convert or several labels at once are refused with the reason, and nothing is recorded.
Ready on day one
Active on install
Scanning works on the Shop Floor and on the manufacturing order as soon as the module is installed; there is nothing to switch on.
Demo labels to try
On a database with demo data, the demo barcode sheet gains a lot-tracked and a serial-tracked order to scan end to end.
Set first
A barcode on each product you make, the GS1 barcode nomenclature if your labels are GS1, and the command sheets printed next to the machines.
What is included
Scanning of product, lot, serial and GS1 labels on the open work order, with quantities converted to the unit of the order; command codes for the Shop Floor screens and for the manufacturing order; the printable command sheets; and demo data to try every flow.
Before you decide
Do we need special scanners?
No. Any scanner that types the code like a keyboard and ends with Enter works, on a tablet, a phone or a desktop.
Who can scan, and does it bypass our rules?
Every Manufacturing user; no extra access group. A code acts as the matching tap on the open screen, with the user's own rights, so every manufacturing rule still applies; a code whose action is not available there does nothing. Restarting a stopped station still asks for a deliberate tap.
Do GS1 labels work?
Yes, when the company uses the GS1 barcode nomenclature: the product, the lot and a weight or count are read in one scan and rounded to the precision of the unit of measure. Under that nomenclature a product barcode that itself starts like a GS1 element (for example 10) is read as that element, so give products barcodes of another shape.
Where does a scan go?
Only to your own database: the code is checked against the open work order and recorded there. If the connection drops, nothing is recorded and the operator scans again.
Which editions and languages?
Community Edition and Viindoo Cloud. The module ships in English and Vietnamese.
Try it, then ask us
The Documentation tab holds the user guide by role. Live demo: https://v19demo-int.viindoo.com
Pre-sales & partnership
https://viindoo.com/contactusTechnical support
https://viindoo.com/ticketTechnical requirements
- Odoo version: 19.0
- Editions: Community Edition, Viindoo Cloud
- Required modules: Shop Floor Control, Stock Barcode
- License: OPL-1
- Languages: English, Vietnamese
MRP Barcode
Who this guide is for. Machine operators and shift leads who work on a tablet or a phone with a scanner, production planners who print the command sheets, and the administrator who installs the module.
Note
Extends Shop Floor Control - see its documentation.
Note
Extends Stock Barcode - see its documentation.
Overview
On the shop floor, hands are busy and screens are small. MRP Barcode lets operators run a manufacturing order and its work orders by scanning instead of tapping and typing. A scanned product, lot, serial number or GS1 label records the output of the work order that is open on the screen. A scanned command code presses a button for you: start, pause, record output, finish, produce and more.
This guide builds on the Shop Floor app described in the documentation of Shop Floor Control (job board, Record output screen, Undo). It does not repeat that guide: it only explains what changes when a scanner is in your hand. Barcodes of products, lots and GS1 labels are explained in the documentation of Stock Barcode.
The business process, and who acts at each stage:
- Draft - the Machine Operator confirms the manufacturing order with the Confirm button. This module adds no command code for it.
- Confirmed - the Machine Operator starts the work order, by tapping or by scanning the Start code.
- In Progress - the Machine Operator scans the label of what has just been made to record the output, then scans the Finish code when the operation is done.
- To Close - the Machine Operator scans the Confirm closing the order code on the closing screen, or the Produce code on the manufacturing order.
- Done - nothing is left to scan.
Who uses this module:
| Role | What they do | Access right to assign |
|---|---|---|
| System Administrator | Installs the module and gives each person the right access | Administration / Settings |
| Machine Operator | Works the jobs on the shop floor and the manufacturing orders by scanning labels and command codes, and prints the command sheets | Manufacturing / User |
| Shift Lead | Oversees the shop floor. The module adds nothing that needs more than the operator's access right | Manufacturing / Administrator |
Setup (for the System Administrator)
Installation
- Open Apps.
- Search for MRP Barcode.
- Click Install.
The required apps are installed with it: Shop Floor Control (the Shop Floor app) and Stock Barcode. When all three are installed, the module is active at once; there is nothing else to switch on.
Configuration
- Give each operator the access right Manufacturing / User (open Settings ‣ Users & Companies ‣ Users, open the user, tab Access Rights). The menu Manufacturing ‣ Operations ‣ Barcode Command Sheets and the scanning on the Shop Floor are available to them. Give shift leads Manufacturing / Administrator.
- Put the barcode on the products you make: open the product and fill in its Barcode. For products tracked by lot or serial number, the lots and serial numbers themselves are scanned by their name.
- If your company labels its goods with GS1 barcodes, the company must use the GS1 barcode nomenclature (see the Stock Barcode guide; ask your implementation partner to select it). Without it, a GS1 label is refused on the Shop Floor and nothing is recorded.
- Check the unit of measure of weighed products (for example kg): the quantity read from a weight label is rounded to the number of decimals of that unit of measure.
- Print the command sheets and keep them next to the machines (see "Print the command sheets" below).
- On a database with demo data, the module works with the demo products and orders and adds only what they lack: the barcodes and one lot-tracked order. The product Drawer is tracked by lot (barcode 2009461000015): its confirmed order of 3 Units runs on the work center Assembly 1, operation Assemble the drawer, and the lot to scan is 0000000000030. The product Table Top is tracked by serial number (barcode 2009461000022): its confirmed order of 1 Unit runs on Assembly 1, operation Manual Assembly. The demo barcode sheet of Stock Barcode gains two printable sections with the codes of these two orders.
Machine Operator: scan labels and command codes
Print the command sheets
A command code is a barcode that begins with OBT followed by the name of an action, for example OBTSTART. Scanning it presses the matching button of the screen that is open. The sheets are the same for every order, so you print them once.
Open Manufacturing ‣ Operations ‣ Barcode Command Sheets.
In the window, choose which Sheet to print: Manufacturing Order, Work Order or Both (the default). Then click Print.
Print the PDF. Each screen has its own page, because a code only presses a button on the screen where that button lives. The Manufacturing Order page lists Produce, Plan, Unplan, Start, Check availability, Unreserve and Cancel.
The Work Order page lists Start / Resume, Pause, Record output, Finish, Stop the machine (report an incident), Restart the station, Generate a lot/serial number, Confirm the quantity and Confirm closing the order.
Note
The manufacturing order page only lists the buttons your access right lets you see. A code whose button is not shown at that moment does nothing and says nothing: this is normal. For example Start does nothing on an order that is already started. Some codes of the work order page act without a button you can see on the screen, for example Finish on the Record output screen when nothing waits for confirmation.
Run a manufacturing order with command codes
Open the manufacturing order (Manufacturing ‣ Operations ‣ Manufacturing Orders). Its buttons are in the header, above the order.
Scan the code of the button you need, for example OBTASSIGN for Check availability or OBTPRODUCE for Produce. The button is pressed as if you had clicked it. The one Produce code presses whichever of Produce or Produce All is shown.
Warning
OBTCANCEL presses Cancel on the open order. Keep the printed sheets away from casual scanning.
Find your job on the shop floor
Scanning works on the screen of an open work order (the operation screen and Record output). On the job board, a scan does nothing.
Open Shop Floor from the home menu and choose your work center, here Assembly 1.
Tap the card of your job, or its Open & start button. Tapping the card opens the job; the work order starts when you scan the Start code or tap Start.
For the other tasks of the job board, see the Shop Floor Control guide.
Start, pause and finish a work order by scanning
With the work order open, scan OBTSTART (Start / Resume). The state becomes Running and the timer counts.
To take a break, scan OBTPAUSE (Pause). Scan OBTSTART again to resume.
To report that the machine stopped, scan OBTSTOP (Stop the machine (report an incident)). It presses Stop machine, as a tap on the button does.
To put a stopped station back to work, scan OBTUNBLOCK (Restart the station). Any Manufacturing user can do it. The code only does the first step: the question "Restart this station?" stays a deliberate tap, because confirming it releases the station for everyone. See the Shop Floor Control guide.
Record the output by scanning its label
Scan the label on what you have just made. What happens depends on what the label says and on the product.
| You scan | What happens |
|---|---|
| The product barcode, product not tracked | One unit (or the quantity printed on the label) is recorded at once. |
| The barcode of a unit of the product (for example a pack of 6) | That unit is recorded, converted into the unit of the order. |
| The product barcode, product tracked by lot or serial number, no finished lot yet | Record output opens so that you choose or generate the lot or serial number. Nothing is recorded yet. |
| The product barcode, finished lot already chosen for the order | One unit is recorded under that lot (or the quantity printed on the label). |
| A lot name | Record output opens with that lot ready under Lot to record. Enter the quantity and confirm. |
| A serial number | That unit is recorded at once. |
| A GS1 label with product and lot | The quantity of the label (one unit when it states none) is recorded under its lot at once. |
Open the work order and start it. Scan the barcode of the finished product, for example 2009461000015 (Drawer). The drawer is tracked by lot and has no lot yet, so Record output opens and asks for the Finished lot.
Scan the lot, for example 0000000000030. The lot appears under Lot to record. Tap 1 on the number pad, then scan OBTCONFIRM (Confirm the quantity), or tap Confirm output. The command OBTGENLOT presses Auto-generate lot when the operation type lets you create new lots.
Record the output with a GS1 label
A GS1 label carries the product and the lot in one scan. It is read when your company uses the GS1 barcode nomenclature (see Setup). The demo barcode sheet carries one for the Drawer: (01)02009461000015(10)0000000000030, the drawer of lot 0000000000030. One scan of a label with a product and a lot records one unit of that lot. A label that also carries a weight or a count records that quantity, converted to the unit of the order.
Open the work order and start it.
Scan the GS1 label. One unit is recorded at once, under the lot of the label: the Output panel shows 1.00 / 3.00 Units and the Finished lot.
The quantity of a label that carries a weight or a count is converted into the unit of the order (a label in grams for an order in kilograms, for example) and rounded to the precision of that unit of measure. The parts of a label that a work order does not use, such as a location or a package, are ignored and listed in a warning: Not applied from the scanned label.
A GS1 label is a code that holds a GTIN element at its start or after a separator. The separators the app knows are #, Alt029 and the invisible GS character; a different separator configured on the barcode nomenclature is not recognised. A code that has the structure of a GS1 label but that the company's barcode nomenclature does not read is refused as a whole: it never becomes the name of a lot or serial number. See the Stock Barcode guide for the rules and for the one exception under the GS1 nomenclature.
Check a scan and undo it
A scan is recorded exactly like a tap on Record output. To see it, tap Record output on the operation screen. The screen reads "Recorded 1.00 / 3.00 Units".
Under Undo the last recording, tap Undo. It takes back exactly the latest recording.
For who may undo and until when, see the Shop Floor Control guide.
Record a serial-numbered product
A product tracked by serial number is made one unit at a time, one serial number per unit. The demo product Table Top is one example; the pictures show another demo product tracked by serial number, the Table.
Open its work order and scan OBTSTART.
Scan the barcode of the product. Record output opens and asks for the serial number under Next serial number.
Scan OBTGENLOT (Generate a lot/serial number), or scan an existing serial number. The serial number appears under Next serial number.
Scan OBTCONFIRM (Confirm the quantity). The quantity is always one unit, so no digit has to be tapped. The screen reads "All serial numbers of the order are recorded" and shows Finish; it stays disabled, with the reason written below it, while materials still need a recorded quantity.
When a scan is refused
A scan always stays on the work order it was read for, and nothing is recorded when it is refused. The red message tells you why.
Scan the barcode of another product, for example 2009460000016 (Cabinet with Doors) while the drawer order is open. The message says that the code is for the cabinet with doors, that the order makes the drawer and that nothing was recorded.
Scan a GS1 label while the company uses the default barcode nomenclature. The message says that the nomenclature does not read the label, that nothing was applied and what to do.
The scan is also refused when:
- the lot or serial number belongs to another product;
- the label states a quantity in a unit that cannot be converted into the unit of the order (for example a length for an order in kilograms);
- one scan holds several labels at once - scan one label at a time;
- the code is not a barcode of the product or of one of its lots, so there is nothing to record.
If you switched to another work order while the scan was being checked, nothing is recorded and a yellow warning says that the scan was for another work order. Scan the label again on the right order.
Finish the operation and close the order
- When the quantity is recorded, scan OBTFINISH (Finish), on the operation screen or on Record output. When it is the last operation of the order, the closing screen of the order follows. If materials still need a recorded quantity, the screen says so and Finish is disabled; see the Shop Floor Control guide.
- Scan OBTVALIDATE (Confirm closing the order) to close it. If the materials differ from the bill of materials, follow the Shop Floor Control guide.
- On the manufacturing order, OBTPRODUCE (Produce) closes it in the same way.
Troubleshooting
- Nothing happens when I scan. Scanning works on an open work order (operation screen or Record output) and on the manufacturing order form. On the job board, in a text field such as a search box, or while a dialog is open, the scan is left alone. Open the order first.
- A command code does nothing. The button it presses is not shown now: for example Start on an order already running. This is expected and no message appears.
- "The scanned code ... is a GS1 label that the barcode nomenclature of ... does not read." The company does not use the GS1 barcode nomenclature, or the label is damaged or badly printed. Scan the product barcode or an existing lot instead, or ask your administrator to check the company's barcode nomenclature (see Setup). When the code is in fact the name of a new lot or serial number, create it in the company of the order first, then scan it again.
- A product barcode is taken for a lot. Under the GS1 nomenclature a code is read by the GS1 rules: a product barcode that starts with a GS1 identifier, for example 10 followed by digits, is read as that element (here a lot) and not as the product barcode. Give products barcodes of another shape.
- "The scanned code ... is for ..., but ... makes ...". You scanned another product. Scan the label of the product of this order.
- "The scanned code ... holds several labels. Scan one label at a time." Scan each label on its own.
- "The scan could not be checked: the connection to the server was lost." Nothing was recorded. Scan the label again when the connection is back.
- The quantity of my weight label shows fewer decimals than the label. The quantity follows the decimals of the unit of measure of the product. Ask your administrator if you need more.
- The Confirm code does nothing on a lot-tracked product. The quantity has not been entered yet. Tap the quantity first.
FAQ
Do I need a special scanner?
No. Any scanner that types the barcode characters and ends with Enter works, because it acts like a keyboard.
Does scanning replace the Shop Floor screens?
No. The screens stay as they are. Scanning only gives you a faster way to press the same buttons and to record the same output, with the same entries and the same Undo.
Can one printed sheet be used for every order?
Yes. The codes press buttons, they do not name an order. The order is the one open on the screen.
Why are there two sheets?
A code only presses a button on the screen where that button lives. The manufacturing order sheet is for the order form, the work order sheet for the shop floor.
Is this supported on Odoo Enterprise?
It is not supported on Odoo Enterprise.
This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file).
You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one).
It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software.
The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.