What This Module Does

Stop building approval logic one module at a time. Define your approval chains in the UI, and let the engine handle submission, routing, stage progression, notifications, escalation, and approval history automatically.

Document State Lifecycle

Every document moves through a clear approval lifecycle, from initial submission to final decision.

Three Ways to Define Approvers

Built for Every Team

Developer Integration Guide

Any model can join the approval engine by inheriting the mixin, adding the dependency, exposing the approval fields in the form, and creating an approval workflow configuration.

1. Add the mixin to your model

from odoo import _, api, fields, models
from odoo.exceptions import UserError

class MyModel(models.Model):
    _name = "my.model"
    _description = "My Model"
    _inherit = [
        "approval.mixin",
        "mail.thread",
        "mail.activity.mixin",
    ]

2. Add the dependency in the manifest

{
    "name": "My Module",
    "version": "18.0.1.0.0",
    "depends": [
        "dynamic_approval_workflow",
        "mail",
    ],
}

3. Add the submit button and status badge in the form view

<button name="action_submit_for_approval"
        type="object"
        string="Submit for Approval"
        class="btn-secondary"
        invisible="state != 'draft' or approval_state not in ('draft', 'returned')"/>

<field name="approval_state"
       readonly="1"
       widget="badge"/>

4. Gate the final confirmation action

def action_confirm(self):
    for record in self:
        config = record._get_approval_config()
        if not config:
            continue
        if record.approval_state == "approved":
            continue
        if record.approval_state in ("draft", "returned"):
            raise UserError(_("Submit \"%s\" for approval before confirming.") % record.display_name)
        if record.approval_state == "pending_approval":
            raise UserError(_("\"%s\" is still awaiting approval.") % record.display_name)
        if record.approval_state == "rejected":
            raise UserError(_("\"%s\" was rejected. Return to draft and resubmit.") % record.display_name)
    return super().action_confirm()

Dynamic Approval Workflow v18.0.1.0.0 | LGPL-3 | Built by Abdalrahman Shahrour