- APPS
- Shop Floor Control - Maintenance 19.0
| Lines of Code | 1120 |
| Technical name | viin_mrp_workorder_maintenance |
| License | OPL-1 |
| Website | https://viindoo.com/apps/modules/19.0/viin_mrp_workorder_maintenance |
| Read description for | v 18.0 |
| Required Apps | Manufacturing (mrp) Discuss (mail) Employees (hr) Inventory (stock) Maintenance (maintenance) |
| Included Dependencies | Shop Floor Control Maintenance - MRP Viindoo Manufacturing Web Gantt |
Machine down: the line stops and a technician is called in the same tap
For manufacturers who run their work orders on a tablet at the work center
Report a machine breakdown from the Shop Floor tablet: one tap stops the work center and calls a technician, with no typing.
Odoo 19.0 · Community Edition, Viindoo Cloud · OPL-1
Extends Shop Floor Control, the tablet screen operators work on.
Extends Maintenance - MRP, the requests, machines and breakdown reasons it uses.
What changes for your team
A breakdown reported at the machine, in two taps
The operator stops the job, then finds someone or a desktop to report the failure. The request arrives late, without the order or the exact machine.
→ Under Stop machine, the operator taps Equipment failure - call maintenance, then what is wrong. The work center stops and the request is created at that moment, titled from the reason and the machine, with the order attached. A photo of the fault can follow.
One call per breakdown, seen by everyone at the station
A second operator, unsure whether help is coming, raises a second request for the same failure.
→ A second tap, or a second tablet at the same station, joins the open request. The tablet shows who called the technician, when, and for which request, until maintenance closes it.
Restart decided at the station, and on the record
Whether a machine may run again is settled by word of mouth, and nobody knows who restarted it.
→ When maintenance closes the request without a repair, the tablet says so. Any Manufacturing user restarts the station after one question, the restart is listed in Shop Floor Entries and, while the request is open, leaves a note on it.
Ready on day one
Installs by itself
It is added as soon as Shop Floor Control and Maintenance - MRP are both installed. It has no menu or settings of its own.
Breakdown reasons
Machine Jammed, Overheating, Unusual Noise and Broken Part are ready to tap; the maintenance manager edits the list.
A call without stopping
Call maintenance (machine keeps running) sends a request for a machine that only needs servicing, while the job runs on.
Set up first
Link each machine to its work center and technician, and keep a maintenance team for the company.
What is included
Breakdown reports and maintenance calls from the Shop Floor tablet, the hold on the work center until the request is closed, the restart with its note, and every report, call and restart in Shop Floor Entries. A request raised from the desktop holds no work center stop; the stop comes from the tablet.
Before you decide
What if the work center was already stopped for another reason?
It stays stopped and its stop reason becomes the breakdown, so the downtime is neither split nor lost.
What if the connection drops during a report?
The operator taps again once it is back. A retried report is applied once and never raises a second request.
Who sees what?
Operators with the Manufacturing / User right report, follow their calls and restart a station, and see the Shop Floor Entries they recorded. Manufacturing administrators see all of them. The technician is the one named on the machine.
Can a failure be logged without calling a technician?
No. The breakdown reasons are kept off the plain stop list, so a failure always comes with a maintenance request.
Where does the data go, and in which languages?
Into the standard maintenance requests and work center records of your own database; the module calls no outside service. It ships in English and Vietnamese.
Try it, then ask us
The Documentation tab covers setup and daily use role by role, and the Live Preview of this listing lets you try it first.
Pre-sales & partnership
viindoo.com/contactusTechnical support
viindoo.com/ticketTechnical requirements
- Odoo version: 19.0
- Editions: Community Edition, Viindoo Cloud
- Technical name: viin_mrp_workorder_maintenance
- Required modules: Shop Floor Control, Maintenance - MRP
- License: OPL-1
- Languages: English, Vietnamese
Shop Floor Control - Maintenance
Who this guide is for. Machine operators and shift leads who work on the Shop Floor tablet (access rights Manufacturing / User and Manufacturing / Administrator), maintenance technicians who close the requests, and the administrator who gives people their access rights.
Note
Extends viin_mrp_workorder - see its documentation.
Note
Extends viin_mrp_maintenance - see its documentation.
Shop Floor Control - Maintenance lets a machine operator report a breakdown on the tablet, at the machine, instead of walking to a desktop. One tap stops the work center and calls a technician. Nothing has to be typed: the machine and the problem are picked from tap lists, the title of the request is written for you, and a photo of the fault can be added from the tablet camera. The downtime is timed from that tap.
The screenshots show the demo company. Marc Demo is the machine operator. Mitchell Admin is the second person at the station, the technician who closes the requests and the shift lead. The work center Assembly 1 has two machines, Crosscut Saw: 8 ppi. and Scrub Plane. Drill 1 has one machine, Drill Machine.
Overview
A breakdown goes through three stages.
- Report. The operator taps Stop machine, then Equipment failure - call maintenance, picks the machine and what is wrong. The work center stops and a maintenance request is created at the same moment. The request is handed to the technician.
- Repair and close. The technician repairs the machine and closes the request in a stage. A closing stage that returns the machine to service puts the work center back to work. Any other closing stage, such as Scrap, leaves it stopped.
- Back to work. After Scrap, someone at the station restarts the work center once production may run again. The restart is recorded and the request receives a note.
| Role | What they do | Access right to assign |
|---|---|---|
| Machine operator | Reports a breakdown, calls maintenance for a machine that keeps running, follows the call and restarts the station when the machine was not repaired. | Manufacturing / User |
| Maintenance technician | Repairs the machine and closes the request in the stage Repaired or Scrap. | Internal user, named in Responsible of the request |
| Shift lead | Checks every breakdown and call in Shop Floor Entries. | Manufacturing / Administrator |
| Administrator | Gives each person their access right. The module installs itself. | Role / Administrator |
Setup (for the Administrator)
Installation
The module installs itself as soon as both Shop Floor Control and Maintenance - MRP are installed. If it is not installed yet:
- Open Apps.
- Search for Shop Floor Control - Maintenance.
- Click Install.
The module adds no menu of its own. Everything happens on the Shop Floor screen, in the Maintenance Requests list and in Shop Floor Entries.
Access rights
- Give each operator the access right Manufacturing / User. Operators see the Shop Floor app, report breakdowns, follow their calls and restart a stopped station.
- Give each shift lead the access right Manufacturing / Administrator. Shift leads see every line of Shop Floor Entries. An operator sees the lines they recorded.
- The technician is any internal user. A request names the technician in Responsible, taken from the Technician of the machine.
- Link the user of each operator to an employee: on the employee, open the Settings tab and fill User. Without this link the tablet refuses to start a job. See the Shop Floor Control guide.
Machines, reasons and closing stages
These are set in the Maintenance - MRP guide, which describes them in detail.
- Each machine names the work center it belongs to, its Technician and its Maintenance Team: Maintenance ‣ Equipment ‣ Machines & Tools. With one machine on the work center the tablet skips the question Which machine?. With no machine, the request is sent without one and the technician finds the machine on arrival.
- At least one maintenance team must work for the company of the work order, otherwise the tablet refuses the report before anything is stopped.
- The choices under What is wrong? are the request reasons: Maintenance ‣ Configuration ‣ Request Reasons. Four are ready to use: Machine Jammed, Overheating, Unusual Noise and Broken Part. Each one stops the work center for the stop reason Equipment Failure.
- Equipment Failure is not offered among the plain reasons of the stop screen, so nobody can stop a machine for a failure without calling a technician.
- The option Returns Machine to Service of a maintenance stage decides which closing stage puts the work center back to work. Repaired does, Scrap does not: Maintenance ‣ Configuration ‣ Maintenance Stages.
Usage
Machine operator: report a breakdown and follow the call
Report a breakdown
On the home menu, tap Shop Floor, choose your work center and tap Open job board. Tap Continue operation on the card of your job. The card shows Running while the job is on the clock.
The operation screen opens. Tap Stop machine.
The screen asks "What's happening?". The plain reasons for a stop are under Other reason. Below them, the red button Equipment failure - call maintenance reads "Machine broken? This stops the work center and calls a technician."
Tap Equipment failure - call maintenance. If the work center has several machines, the question Which machine? appears. Tap the machine that broke, for example Crosscut Saw: 8 ppi.. With a single machine the tablet skips this question and tells you which machine is attached to the request.
Under What is wrong?, tap the problem, for example Machine Jammed. This tap is the report: there is no confirmation step and nothing to type. Tap Cancel instead if you tapped by mistake.
The panel Waiting for maintenance confirms "Breakdown reported - the work center is stopped and a technician has been called." and shows the title of the request, written from the reason and the machine. The bottom of the screen reads Station stopped: Equipment Failure, next to the button Restart station.
Optional: tap Take photo, photograph the fault with the tablet camera and confirm. The tablet says "Photo added to the request." and the technician sees the photo in the request. If the photo cannot be added, the tablet tells you and the report itself is kept.
Tap Back to return to the operation screen. The band Station stopped: Equipment Failure names who called the technician, at what time and for which request. The button Stop machine then reads Station stopped - view details.
While the work center is stopped, the operation cannot be paused or finished and no output can be recorded until the work center is back at work.
Follow the call and join a colleague's call
One call is enough for a work center. When a technician has already been called, a second tap does not create a second request.
Open your job on the stopped work center and tap Station stopped - view details. The panel Waiting for maintenance names who called the technician, at what time and for which request. The time is shown in your own time zone.
A colleague at the same station sees the same panel on their own tablet. If their tablet was already on the stop screen when the first operator reported, Equipment failure - call maintenance is still shown. Tapping it, the machine and the problem joins the call that is already open: the panel names the first caller, no new request is created and no Take photo button is offered, because the request was not created by this tablet.
A tap that is repeated after a lost connection never creates a second request either. If the work center was already stopped for another reason, the breakdown takes over: the work center stays stopped, its stop reason becomes Equipment Failure and the downtime from the first stop is kept.
The screen shows what it knew when you opened it. Tap Refresh on the job board to see the latest state of every job.
Call maintenance for a machine that keeps running
Use this when the machine still works but needs servicing, for example it rattles. Production does not stop.
Open your job. While the work center is running, the operation screen offers Call maintenance (machine keeps running). Tap it. If the work center has several machines, tap the machine first.
A green message replaces the button: "Maintenance request sent - the technician will service the machine without stopping production." The job keeps running and the work center is not stopped. If the work center has no machine, the message adds "No machine is declared for this work center - the request was created with no machine attached."
Optional: tap Take photo. The tablet says "Photo added to the request."
The technician finds the request in Maintenance ‣ Maintenance ‣ Maintenance Requests, titled automatically (here Maintenance request - Drill Machine/SP/224/00000000) with the manufacturing order and the work order filled in. It does not hold the work center.
Restart the station after the machine was scrapped
When the technician closes the request in the stage Scrap, the work center stays stopped. Any Manufacturing user at the station decides when production may run again.
Open the job of the stopped work center. On the job board, the jobs of the work center show Station stopped; the job that was running offers Open to handle incident. Tap Station stopped - view details.
The red notice Machine not repaired - request closed says "Maintenance closed request ... at stage Scrap without repairing the machine. Restart the station with Restart station once production may run again."
Decide what to do with the machine, then tap Restart station. The question "Restart this station?" appears because the restart releases the work center for everyone. Keep it stopped leaves things as they were.
Tap Yes, restart. The work center runs again and the stopped band disappears. The jobs show Operation paused: each operator taps Resume operation to continue.
The request receives an internal note: "Work center Assembly 1 was restarted from the shop floor before this request returned the machine to service." It notifies nobody; the technician sees that production ran again. A restart while the request is still open leaves the same note.
Maintenance technician: repair and close the request
Close the request: the work center runs again
Open Maintenance ‣ Maintenance ‣ Maintenance Requests and switch to the list. The requests that name you in Responsible are yours; a Maintenance / Equipment Manager opens every request.
Open the breakdown request, here Machine Jammed - Crosscut Saw: 8 ppi./SP/222/00000000. The form shows the machine, the team, Responsible, the Manufacturing Order, the Work Order, the Reason and the Work Center Stop. The photo of the operator is in the chatter below.
Repair the machine, then click Repaired in the status bar. The chatter logs "Work center Assembly 1 is back in service." The downtime of the work center ends at that moment.
On the tablets the red band is gone once the screen is refreshed. The jobs show Operation paused: each operator taps Resume operation to carry on.
If the machine cannot be repaired, close the request in the stage Scrap instead. The chatter says "Work center Assembly 1 stays stopped: this stage does not return the machine to service." The work center then stays stopped until someone restarts it, as described in "Restart the station after the machine was scrapped".
Shift lead: check every call
Check every breakdown and call
Every breakdown tap, every maintenance call and every restart is recorded in Manufacturing ‣ Reporting ‣ Shop Floor Entries, with the kind Breakdown, Maintenance Request or Restart, the work order and who recorded it. A tap that returned the call already made by a colleague is listed too, so you can see who tapped. A shift lead sees every line; an operator sees their own.
Troubleshooting
- I do not see "Equipment failure - call maintenance". The reason of a breakdown is not a plain stop reason. Tap Stop machine on the operation screen. If you still do not see the button, a request already holds the work center: you see Waiting for maintenance instead.
- "No breakdown reasons are configured yet. Ask the maintenance manager to set them up." There is no active request reason. A maintenance manager adds them in Maintenance ‣ Configuration ‣ Request Reasons.
- "No maintenance team works for company ..., so the maintenance request cannot be sent." Ask the maintenance manager to create a maintenance team for the company, then tap again. Nothing was stopped.
- I do not see "Call maintenance (machine keeps running)". It is offered only while the work center is running. When the work center is stopped, use the call that is already open.
- The request was created without a machine. The work center has no machine. Link the machines to the work center, see "Machines, reasons and closing stages".
- "Your user is not linked to an employee." Ask a manager to link your user to an employee before you start or resume a job from the tablet.
- Maintenance closed the request but the station is still stopped. The request was closed in a stage that does not return the machine to service, for example Scrap. Restart the station, see "Restart the station after the machine was scrapped".
- The station is repaired but my job still looks stopped. Tap Refresh on the job board, then tap Resume operation.
- My connection dropped while I was reporting. Tap again when the connection is back. A report that is retried is applied once, never twice.
FAQ
Do operators need to type?
No. The machine and the problem are tiles, and the title of the request is written automatically. Only a free description of a stop uses the keyboard, and it is optional.
Can I stop a machine for a failure without calling a technician?
No. Equipment Failure is not offered among the plain stop reasons.
What if the work center was already stopped for another reason?
The breakdown takes over: the work center stays stopped, its stop reason becomes Equipment Failure and the downtime is not lost.
Does a second tap create a second request?
No. The second tap shows who called the technician and when.
Who can restart a stopped work center?
Any Manufacturing user. Every restart is recorded in Shop Floor Entries and leaves a note on the request that was holding the station.
Where do I see who reported what?
In Manufacturing ‣ Reporting ‣ Shop Floor Entries.
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.