- APPS
- Maintenance - MRP 19.0
| Lines of Code | 952 |
| Technical name | viin_mrp_maintenance |
| License | OPL-1 |
| Website | https://viindoo.com/apps/modules/19.0/viin_mrp_maintenance |
| Read description for | 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) Maintenance (maintenance) |
| Extensions | Shop Floor Control - Maintenance |
Every breakdown tied to the machine and the order it stopped
For manufacturers whose production and maintenance teams share the same machines
Tie maintenance requests to the work center, work order and manufacturing order they concern, report a breakdown by picking a reason, and track MTBF and MTTR for each machine.
Odoo 19.0 · Community Edition, Viindoo Cloud · OPL-1
What changes for your team
A breakdown reported from the order, without typing
A stuck job is reported by phone or in a free-text request that names neither the order nor the machine.
→ Maintenance Request on the work order or manufacturing order opens a request already linked to it. Pick a reason and the title is written for you; the machine list offers the machines of that work center.
The work center runs again when the repair is done
Whether a machine may restart is decided by word of mouth, sometimes after it was written off.
→ A request holding a work center stop releases it when closed at Repaired. Closed at Scrap, the work center stays stopped, and the request notes either outcome.
Reliability of each machine, where production looks
Failure history lives apart from the work centers and is rebuilt by hand.
→ Each machine is linked to its work center, which lists its machines with technician, MTBF, MTTR, latest failure and estimated next failure.
Ready on day one
Breakdown reasons
Machine Jammed, Overheating, Unusual Noise and Broken Part, each booked as an Equipment Failure loss.
Closing rules
Repaired returns the machine to service; Scrap keeps it stopped.
Installs by itself
It is added as soon as Manufacturing and Maintenance are both installed.
Set up first
Turn on Work Orders in Manufacturing, then link each machine to its work center.
What is included
Requests raised from orders and work centers, breakdown reasons, closing rules and per-machine MTBF and MTTR, on the standard Manufacturing and Maintenance apps.
Optional extensions
Shop Floor Control - Maintenance
Operators report a breakdown on the Shop Floor tablet: one tap stops the work center and raises the request that later releases it.
Before you decide
Where does a work center stop come from?
From a breakdown reported on the Shop Floor tablet with Shop Floor Control - Maintenance. Requests raised from the desktop carry no stop, so closing them leaves every work center as it is.
Who sees which requests?
Whoever raises a request keeps access to it. Manufacturing users see the machines linked to work centers; Manufacturing administrators read the requests of work orders and work center machines. Moving a request between stages follows the standard Maintenance access rights.
Can we use our own reasons and stages?
Yes. Managers edit the reason list and the loss each reason books, and decide for each closing stage whether it returns the machine to service.
How are MTBF and MTTR calculated?
From the done corrective requests of each machine, in days: MTTR is the average time from request to close, MTBF the time from the machine's effective date to its latest failure, divided by its failures.
Where does the data go?
Into the standard maintenance requests, machines and work centers of your own database. The module calls no outside service.
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_maintenance
- Required modules: Manufacturing, Maintenance
- License: OPL-1
- Languages: English, Vietnamese
Maintenance - MRP
Maintenance - MRP connects the Maintenance app to Manufacturing. Every machine is tied to the work center it serves, every maintenance request can point to the manufacturing order and the work order it concerns, a breakdown is reported by picking a reason, and a stopped work center runs again only when the repair is really finished.
This guide is for the people who use the module day to day: the administrator who sets it up, the production planner, the maintenance technician, the shift lead and the maintenance manager.
Overview
A breakdown goes through three steps:
- Report. The production planner, or any operator, raises a request from the work order that is stuck, or from the Maintenance app, and picks a reason. The title is composed from the reason and the machine, so nothing is typed.
- Repair. The technician named in Responsible works on the request and moves it along the status bar.
- Close. The technician closes the request at Repaired, and the work center stopped by the breakdown runs again. At Scrap the machine cannot be repaired and the work center stays stopped.
Along the way the maintenance manager keeps the list of machines per work center, the reasons and the closing stages, and reads the MTBF (mean time between failures) and the MTTR (mean time to repair) of each machine.
| Role | What they do | Access right to assign |
|---|---|---|
| Administrator | Turns on Work Orders and gives each person their access right | Administrator |
| Production planner | Raises a request from a work order or a manufacturing order, reports a breakdown, and opens the requests of a work center | Manufacturing / User |
| Maintenance technician | Repairs the machines assigned to them and closes the request at Repaired or Scrap | Internal user |
| Shift lead | Follows the stops of the work centers, reads their requests and manages the reasons from Manufacturing | Manufacturing / Administrator |
| Maintenance manager | Keeps the machines per work center, the reasons and the closing stages, and reads MTBF and MTTR | Maintenance / Equipment Manager |
Setup (for the Administrator)
Installation
The module installs itself as soon as both Manufacturing and Maintenance are installed. If it is not installed yet:
- Open the Apps menu.
- Search for Maintenance - MRP (technical name viin_mrp_maintenance).
- Click Install.
The apps Manufacturing and Maintenance are required. Odoo installs them for you when they are missing.
Turn on Work Orders
Work centers, and the Work Centers entry of the Maintenance app, are available when the Work Orders setting is on.
- Open Manufacturing ‣ Configuration ‣ Settings.
- In the Operations block, tick Work Orders.
- Click Save.
Give people the right access
Open the Users screen of the Settings app, open each user and give the access right of the role:
- the maintenance manager: Maintenance / Equipment Manager;
- the production planner: Manufacturing / User;
- the shift lead: Manufacturing / Administrator;
- the technician: an internal user is enough. Every internal user opens the Maintenance app, and the technician is named in the Responsible field of a request.
Check the ready-made reasons and stages
Four breakdown reasons are ready to use: Machine Jammed, Overheating, Unusual Noise and Broken Part. The stages of a request are New Request, In Progress, Repaired and Scrap. Closing a request at Repaired puts the work center back in service, closing it at Scrap does not. The maintenance manager can change both lists, see "Add a breakdown reason" and "Choose which closing stages put the machine back in service" below.
Production planner: raise and follow requests
Raise a maintenance request from a work order
Open Manufacturing ‣ Operations ‣ Work Orders.
Open the work order that is stuck.
Click Maintenance Request at the top of the work order.
A new request opens, already linked to the manufacturing order and to the work order. The title is already filled in with Maintenance request - followed by the name of the work order.
In Reason, pick what happened, for example Machine Jammed. You can only pick a reason from the list.
Click Equipment. Only the machines of the work center of this work order are offered, plus the machines that are tied to no work center.
Click the save icon.
The title now reads <reason> - <machine>: while you have not typed a title of your own, it follows the reason and the machine you pick. When the machine has a technician, that person becomes the Responsible of the request. You can type another title at any time and it is kept.
Back on the work order, the Maintenance Request counter at the top shows how many requests were filed for it. Click it to open them: a single request opens directly, several open as a list.
Note
Manufacturing orders have the same Maintenance Request button and a Maintenance counter, in Manufacturing ‣ Operations ‣ Manufacturing Orders.
Report a breakdown by picking a reason
Any operator can report a breakdown without a work order.
Open Maintenance ‣ Maintenance ‣ Maintenance Requests.
Click New.
In Reason, pick one reason, for example Overheating. Leave the title empty: the Request field fills itself with the name of the reason.
Click the save icon.
Whoever creates a request keeps access to it, so the requests you raised stay open to you.
Open the requests of a work center
The Work Centers Overview shows one card per work center. Its menu has a Maintenance link. Open the overview from the Overview menu of the Manufacturing app when your installation provides it, or go to the page whose address ends in /odoo/work-centers.
Click the menu at the top right of the card of the work center.
Click Maintenance.
The requests of that work center open: the requests on its machines and the requests raised from its work orders. Click New to raise a request from there. The Equipment list offers the machines of the work center and the machines tied to no work center, and when the work center has exactly one machine, it is already filled in.
Maintenance technician: repair and close
Close a breakdown request at Repaired
When a work center is stopped because of a breakdown, the request raised for that stop shows a read-only Work Center Stop field. It links the request to the stop and shows its reason, for example Equipment Failure. The work center card shows a red dot while the work center is stopped.
Open Maintenance ‣ Maintenance ‣ Maintenance Requests.
Open the request assigned to you.
Click Repaired in the status bar.
The request gets a Close Date. The chatter notes that the work center is back in service, and only the stop linked to this request ends: any other stop of the same work center is left untouched.
On the Work Centers Overview, the card of the work center no longer shows the red dot.
Scrap a machine: the request closes but the work center stays stopped
When the machine cannot be repaired, close the request at Scrap.
- Open Maintenance ‣ Maintenance ‣ Maintenance Requests.
- Open the request assigned to you.
- Click Scrap in the status bar.
The request is closed, and the chatter notes that the work center stays stopped because this stage does not return the machine to service.
The work center card keeps its red dot. Moving the request later to Repaired ends the stop and returns the work center to service.
Shift lead: follow the stops of the work centers
The shift lead holds Manufacturing / Administrator, which includes everything of the production planner (see "Raise and follow requests" above). On top of it:
- The shift lead reads the requests raised from a work order and the requests on the machines of a work center, whoever created them. To change one of them, follow it: the follower of a request can edit it.
- The shift lead manages the breakdown reasons from Manufacturing ‣ Configuration ‣ Request Reasons, the same list as in the Maintenance app (see "Add a breakdown reason").
- The Work Centers Overview shows which work centers are stopped, and the Maintenance link of each card opens their requests (see "Open the requests of a work center").
Maintenance manager: machines, reasons and figures
Link a machine to the work center it serves
Open Maintenance ‣ Equipment ‣ Machines & Tools.
Open a machine, or click New and type its name.
In Work Center, pick the work center where the machine runs.
In Technician, pick the person who repairs this machine.
Click the save icon.
To check the result, open Maintenance ‣ Equipment ‣ Work Centers and open the work center. The Equipment tab lists every machine tied to it, with its technician, its category, its MTBF, its MTTR, its latest failure and its estimated next failure.
On that tab, Add a line links an existing machine to the work center and the cross at the end of a line detaches a machine without deleting it. The tab is read-only for users who are not maintenance managers.
Note
The same Equipment tab is on the work center form under Manufacturing ‣ Configuration ‣ Work Centers.
Add a breakdown reason
The reasons are the choices that operators pick instead of typing.
- Open Maintenance ‣ Configuration ‣ Request Reasons. Managers of Manufacturing open the same list in Manufacturing ‣ Configuration ‣ Request Reasons.
- Click New. A line is added at the top of the list.
- In Name, type the label that operators will see, for example Belt Slipping.
- In Loss, pick the stop reason that goes with this breakdown reason. When it is empty, Equipment Failure is used. Only manual stop reasons that are not a productive or a performance loss are offered.
- Click Save.
The new reason is offered in the Reason field of every new request. Drag the handle at the start of a line to change the order of the reasons.
Choose which closing stages put the machine back in service
This list is shown in developer mode only.
Activate the developer mode: open Settings, scroll down to Developer Tools and click Activate the developer mode.
Open Maintenance ‣ Configuration ‣ Maintenance Stages.
The list has the columns Name, Folded in Maintenance Pipe, Request Done and Returns Machine to Service. Returns Machine to Service is ticked for Repaired and not ticked for Scrap.
To add a closing stage that does not free the machine, click New.
In Name, type the stage name, for example Cannot Repair.
Tick Request Done: a request counts as closed in this stage.
Untick Returns Machine to Service.
Click Save.
A breakdown request moved to such a stage is closed and leaves its work center stopped, exactly as for Scrap. Returns Machine to Service only matters for stages where Request Done is ticked. The order of the list is the order of the status bar of a request: drag a stage to the place you want.
Read the MTBF and the MTTR of a machine
MTBF is the mean time between failures and MTTR is the mean time to repair. Both are computed from the requests of type Corrective that are closed, and are shown in days with two decimals.
- Close the corrective request of the machine at Repaired.
- Open Maintenance ‣ Equipment ‣ Machines & Tools and open the machine.
- Open the Maintenance tab.
In this example the machine has an Effective Date (tab Product Information) 90 days in the past and one closed corrective request:
- Mean Time Between Failure is 90.00 days: the days between the effective date and the latest failure, divided by the number of closed corrective requests.
- Mean Time To Repair is 0.00 days: the request was raised and closed the same day. The figure is the mean number of whole days between the request date and the close date.
- Latest Failure is the request date of the latest closed corrective request.
- Estimated Next Failure is the latest failure plus the MTBF.
The same figures are listed as MTBF, MTTR and the estimated next failure on the Equipment tab of the work center.
Troubleshooting
- I cannot find Work Centers in the Equipment menu.
- Work orders are not enabled. Follow "Turn on Work Orders" in the Setup section.
- The equipment list of a request is empty or too short.
- For a request raised from a work order, or from the card of a work center, only the machines of that work center and the machines tied to no work center are offered, and only the ones you may read. Ask the maintenance manager to link the machine to its work center (see "Link a machine to the work center it serves").
- I closed the request, but the work center is still stopped.
- Check, in this order: the request shows a Work Center Stop field, which is the link to the stop it was raised for; the stage you used has Request Done and Returns Machine to Service ticked (Scrap does not free the machine); no other stop is open on the same work center, because other stops are never released by this request.
- The title did not follow the reason I picked.
- The title follows the reason and the machine only while you have not typed a title of your own. Type the title you want in the Request field.
- I cannot see a request that a colleague raised.
- You see the requests you created, the ones you follow and the ones you are responsible for. A maintenance manager sees every request, and a shift lead reads the requests raised from work orders or on the machines of a work center.
- I cannot find the Maintenance link of a work center.
- It is in the menu of the cards of the Work Centers Overview, not in the list of work centers.
FAQ
- Do I have to type a title?
- No. Pick a reason, or open the request from a work order or a manufacturing order: the title is composed for you.
- Can I add my own reasons?
- Yes. A maintenance manager adds them in Maintenance ‣ Configuration ‣ Request Reasons.
- What is the Loss of a reason?
- It is the stop reason that goes with the breakdown reason. When it is empty, Equipment Failure is used.
- Who releases a work center after Scrap?
- Moving the request to a stage that returns the machine to service, such as Repaired, ends the stop.
- Does closing a request free every stop of the work center?
- No. Only the stop linked to that request is ended. Other stops of the same work center stay as they are.
- Where do I find the machines of a work center?
- On the Equipment tab of the work center, in Maintenance ‣ Equipment ‣ Work Centers or in Manufacturing ‣ Configuration ‣ Work Centers.
- How do I find the requests of a manufacturing order, a work order or a work center stop?
- In Maintenance ‣ Maintenance ‣ Maintenance Requests, type the name in the search box and pick the Manufacturing Order, Work Order or Work Center Stop line of the suggestions. Users with Manufacturing / User see these three lines.
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.