Skip to main content
POST
Change an approved proposal's row on the consolidated capex plan.

Headers

Prefer
enum<string>

Preference

Available options:
params=single-object

Body

Change an approved proposal's row on the consolidated capex plan. Needs finance.capex_consolidation.edit.

Send every field the row holds: one left out is saved empty. p_item_description, p_quantity (more than zero, at most 99,999), p_capex_nature_id, p_justification (at most 3,000 characters), p_gst_rate_id and p_asset_block_id are required: p_gst_rate_id a value of your organisation's GST Rate Master list that has its rate (see capex_gst_rates), and p_asset_block_id a value of its Asset Block Master list (see capex_asset_blocks). The row's depreciation_rate_percent is not sent: it is the block's rate, written when the block is chosen and kept while the row keeps it, and taken from the block at the next save where the block had none. On a carry forward p_carryover_cashflow_cy is required, p_py1_fresh_outflow refused, and p_fresh_sanction_amount refused unless it is empty or zero; on fresh money p_carryover_cashflow_cy, p_carryover_order_reference and p_py1_carryover_outflow are refused, and p_approved_carryover_amount unless it is empty or zero. p_carryover_order_reference is up to ten digits. Every amount is from zero up to 9,999,999,999. p_py1_month01 to p_py1_month12 are the planned year's cash flow, month by month from its first month. A GST rate, asset block or nature of investment no longer offered is kept on a row that already names it and refused for one that does not.

What your organisation sets on this form in the Form Studio applies too. A field it insists on is refused empty with MISSING_FIELD wherever this row is asked it, and refused emptied with REQUIRED_FIELD_CLEARED; a field whose writing it keeps to some roles is refused with FIELD_NOT_PERMITTED to anybody without one of them who changes it, and may be sent back unchanged by anybody.

While the row is with its approvers, only the approver it is waiting on may change it, and they need not hold finance.capex_consolidation.edit; what they change is recorded against their step, for the levels after them to see. Otherwise it needs finance.capex_consolidation.edit. Refused with PLANNING_DECIDED once the plan for the proposal has been approved or rejected, and with PLANNING_WITH_APPROVERS while it is with approvers to anybody it is not waiting on. Nothing the proposal itself decided is changed. Returns the row's id.

p_asset_block_id
string<uuid>
required
p_capex_nature_id
string<uuid>
required
p_gst_rate_id
string<uuid>
required
p_id
string<uuid>
required
p_item_description
string<text>
required
p_justification
string<text>
required
p_quantity
number<numeric>
required
p_approved_carryover_amount
number<numeric>
p_carryover_cashflow_cy
number<numeric>
p_carryover_order_reference
string<text>
p_coordinator_user_id
string<uuid>
p_fresh_sanction_amount
number<numeric>
p_py1_carryover_outflow
number<numeric>
p_py1_fresh_outflow
number<numeric>
p_py1_month01
number<numeric>
p_py1_month02
number<numeric>
p_py1_month03
number<numeric>
p_py1_month04
number<numeric>
p_py1_month05
number<numeric>
p_py1_month06
number<numeric>
p_py1_month07
number<numeric>
p_py1_month08
number<numeric>
p_py1_month09
number<numeric>
p_py1_month10
number<numeric>
p_py1_month11
number<numeric>
p_py1_month12
number<numeric>
p_py2_outflow
number<numeric>
p_py3_outflow
number<numeric>
p_py4_outflow
number<numeric>
p_py5_outflow
number<numeric>

Response

200

OK