POST approve_adjustment¶

Approve a Consolidation Adjustment that is in "Pending Approval" status.

Endpoint¶

POST /api/method/konsol.api.approve_adjustment

Authentication: Required (Frappe session cookie)

Parameters¶

Parameter	Type	Required	Description
`name`	string	Yes	Document name (e.g., `CADJ-IC001-0001`)

What Happens¶

Validates the adjustment is in "Pending Approval" status
Sets status to "Approved"
Records approved_by (current user) and approved_at (timestamp)
Saves and syncs to ClickHouse (epm_staging.consolidation_adjustments)
dbt model gold_consolidation_adjustments will include this entry (filters status IN ('Approved', 'Reversed'))

Response¶

{
  "message": {
    "status": "Approved",
    "approved_by": "admin@example.com",
    "approved_at": "2025-06-09 14:30:00"
  }
}

Error Responses¶

Wrong status¶

{
  "exc_type": "ValidationError",
  "_server_messages": "[\"Cannot approve: current status is 'Draft', expected 'Pending Approval'\"]"
}

Workflow Context¶

Draft ──[Submit for Approval]──→ Pending Approval ──[Approve]──→ Approved ──[Reverse]──→ Reversed
                                        │
                                        └──[Reject]──→ Draft