Budget

To create a Budget

Note

When creating a budget against a cost center, you must provide the value of the cost center
When creating a budget against a project, you must provide the value of the project
To get a list of cost centers, use the Cost Center list API
To get a list of projects, use the Project list API

Endpoint: {SERVER_URL}/api/method/eclectics.api.Budget.create
Method: POST
Payload:

{
    "action_if_accumulated_monthly_budget_exceeded": "Warn",
    "action_if_accumulated_monthly_budget_exceeded_on_mr": "",
    "action_if_accumulated_monthly_budget_exceeded_on_po": "",
    "action_if_annual_budget_exceeded": "Stop",
    "action_if_annual_budget_exceeded_on_mr": "",
    "action_if_annual_budget_exceeded_on_po": "",
    "applicable_on_booking_actual_expenses": true,
    "applicable_on_material_request": false,
    "applicable_on_purchase_order": false,
    "budget_against": "Cost Center",
    "cost_center": "Main - DCLD",
    "fiscal_year": "2025",
    "monthly_distribution": null,
    "project": null,
    "accounts": [{
            "account": "5201",
            "budget_amount": 50000
        },
        {
            "account": "5214",
            "budget_amount": 150000
        },
        {
            "account": "4120",
            "budget_amount": 2000000
        }
    ]
}

Headers:

{
    "Authorization": "token <YOUR_TOKEN>"
}

Get list of Budgets

Endpoint: {SERVER_URL}/api/method/eclectics.api.budget.list
Method: GET
Payload:

{
    "fields": ["fiscal_year", "cost_center", "project"],
    "filters": [["fiscal_year", "=", "2025"]],
    "start": 0,
    "page_length": 0,
    "order_by": "creation desc"
}

Headers:

{
    "Authorization": "token <YOUR_TOKEN>"
}

Refer to Document List API Parameters for guidance on the payload

Get a single Budget

Endpoint: {SERVER_URL}/api/method/eclectics.api.budget.get
Method: GET
Payload:

{
    "doc_id": "Main - DCLD/2025/001"
}

Headers:

{
    "Authorization": "token <YOUR_TOKEN>"
}

Delete a Budget

Endpoint: {SERVER_URL}/api/method/eclectics.api.budget.delete
Method: DELETE
Payload:

{
    "doc_id": "Main - DCLD/2025/001"
}