Approvals

The Approvals module is the execution layer for every approval workflow in XBuddy. Any entity that requires human sign-off — invoices, purchase orders, leave requests, contracts, expense claims — flows through this system. Approvals provides a unified inbox, delegation management, automation policies, and an immutable audit trail.

Automation → My Tasks shows all pending approvals assigned to you across every module in one view. On mobile, approvals arrive as push notifications.


Key Entities

EntityDescriptionPath in App
Approval RequestA single approval instance for a record (invoice, PO, leave, etc.)Automation → My Tasks
Approval WorkflowThe configured chain of steps that approval requests followAutomation → Workflow Builder
Approval StepOne node in a workflow: approver, condition, auto-action, or notifyWorkflow Builder → Step editor
Delegation RuleRoutes approvals to a substitute when the primary approver is unavailableAutomation → Delegation
Automation PolicyCondition-based rule that auto-approves, auto-rejects, or re-routes requestsAutomation → Policies
EscalationAutomatic re-routing when an approver exceeds their SLAConfigured per workflow step
Audit TrailImmutable log of every approval action, comment, delegation, and escalationApprovals → History

Approval Request Lifecycle

Submitted → Pending Approval → [Approved | Rejected | Returned for Revision] → Closed

            Escalated (SLA breach)

            Delegated (approver unavailable)

Key Features

  • Visual Workflow Builder — drag-and-drop steps: single approval, parallel approval, AI decision, condition branch, auto-action, notify-only
  • 28+ pre-built templates — covering Finance, Procurement, HR, CRM, Manufacturing, Quality, OKR, and more
  • Automation Policies — rule-based conditions that auto-approve, auto-reject, or route to AI without human intervention
  • Delegation Management — 25 system delegation templates; rules activate automatically based on date ranges
  • Escalation Engine — SLA-based escalation to skip-level manager if approver doesn’t act within configured time
  • Parallel & Serial Chains — mix serial (A → B → C) and parallel (A AND B must approve) steps
  • AI Decision Step — route to AI scoring engine; auto-decide based on configured score threshold
  • Mobile Approvals — approve, reject, or request changes from any device via push notification
  • Comments & Attachments — every action supports an optional comment; reviewers can request additional documents
  • Bulk Actions — bulk approve/reject multiple pending requests at once

Workflow Step Types

Step TypeDescriptionUse When
ApprovalSingle approver must decideStandard one-person sign-off
Parallel ApprovalMultiple approvers simultaneously; all must approveBoard sign-off, dual control
ConditionBranch based on record valuesRoute by amount, department, or risk score
AI DecisionAI scores the request; decides based on thresholdHigh-volume, low-risk routing
Auto ActionExecutes automatically — update field, send email, create taskPost-approval side effects
Notify OnlyInforms recipients without blocking the workflowFYI notifications

Automation Policies

Policies are evaluated before any human approval step. If a policy matches, the workflow acts accordingly.

ActionExample
Auto-ApproveExpense < 500,000 VND by trusted employee
Auto-RejectRequest from blacklisted vendor
Route to AIHigh-value invoice from new supplier
Notify OnlySmall internal purchase, no approval needed
EscalateBudget overrun > 20% → skip to CFO

Setup: Automation → Policies → New Policy → select Subject Type → define conditions → choose action → activate.


Delegation

Delegation automatically routes approvals to a substitute when the primary approver is unavailable.

How It Works

  1. Admin or manager creates a Delegation Rule: delegator, delegate, validity period, subject types
  2. When a workflow reaches an approval step, the engine checks for active delegation
  3. If matched, the request routes to the delegate; delegator receives a notification
  4. Delegation expires automatically at the configured end date

System Templates (25 templates)

CategoryExamples
Leave / AbsenceAnnual Leave Coverage (14 days), Sick Leave Emergency
TravelBusiness Travel (7 days), International Conference
Finance DomainFinance Manager Absence, CFO Delegation
HR DomainHR Manager Absence, Recruitment Delegation
OperationsWarehouse Manager Coverage, Operations Manager Absence

AI Agents

AgentTriggerWhat it does
Approval Auto ClassifierEvent-drivenRoutes approval requests to the correct approver based on configured rules
Approval Rejection AnalyzerScheduled (weekly)Analyzes rejection patterns across all workflows; recommends policy changes
Approval SLA EnforcerScheduled (hourly)Escalates approvals that have breached their configured SLA
Approver Availability OptimizerEvent-drivenRe-routes approvals when the primary approver is detected as unavailable
Delegation OptimizerScheduled (daily)Suggests optimal delegation setup for approvers with upcoming leave

Pre-built Approval Templates

Finance & Procurement

TemplateSteps
Invoice ApprovalFinance Manager → CFO (>10M VND)
Budget ApprovalDept Head → Finance → CFO
Purchase Order ApprovalDept Head → Procurement Manager
Vendor Payment ApprovalFinance Manager
RFQ ApprovalProcurement Manager
Vendor OnboardingProcurement → Legal

HR & People

TemplateSteps
Leave ApprovalDirect Manager
Overtime RequestDirect Manager
Salary AdjustmentHR Director → CEO
Recruitment RequisitionHR Manager → Dept Head
Payroll RunFinance Manager

Operations & Compliance

TemplateSteps
Contract ApprovalAccount Manager → Legal → Executive
Asset PurchaseFinance Manager
Quality CAPAQuality Manager
Project BudgetProject Manager → Finance

Permissions

PermissionDescription
approvals:readView approval requests and history
approvals:manageConfigure workflows, templates, and policies
approvals:delegateCreate and manage delegation rules
approvals:auditExport full audit trail

Integration Points

ModuleIntegration
FinanceInvoice, bill, expense, credit note, budget approvals
ProcurementPO, RFQ, vendor onboarding approvals
HRLeave, overtime, recruitment, payroll run approvals
CRMQuote, large sales order approvals
Contract ManagementContract approval before signature
ManufacturingWork order release, rework, deviation waiver
QualityNCR, CAPA, inspection waiver
OKR / PerformanceObjective, IDP, PIP approvals

FAQ

How do I see all approvals pending my action?
Go to Automation → My Tasks. All pending requests across every module appear in one list, sorted by SLA urgency.

Can I approve from my phone?
Yes. Push notifications are sent for every new approval request. Tap the notification to approve, reject, or request changes directly from the mobile app.

What happens if I don’t act before the SLA expires?
The Approval SLA Enforcer agent (hourly) detects the breach and escalates to your skip-level manager. You’ll also receive an overdue notification.

Can I add a comment when rejecting?
Yes. The comment field is available on every approval action (approve, reject, return for revision). Comments are stored in the audit trail and visible to the submitter.

Can I test a workflow without sending real notifications?
Yes. Use Test Mode in the Workflow Builder to simulate a run with a test record. No real notifications or actions are created.