Measure budgeting

A measure budgeting.

Freeze measure budgeting effects

Freeze budgeting effects for a measure.

SecurityJWT
Request
path Parameters
measure
required
string or integer

The id/hash of the measure.

Request Body schema: application/json

A JSON object containing measure budgeting information.

start_time
required
string <date>

The start time of the budgeting periods for the measure budgeting effects that will be locked.

The date must be before or equal to the end time. All budgeting periods that start on or after this date will be locked. It must match one of the following formats:

  • Y-m-d
  • Y/m/d
  • d.m.Y
  • m/d/Y

end_time
string or null <date>

The end time of the budgeting periods for the measure budgeting effects that will be locked.

If the date is set it must be after or equal to the start time. All budgeting periods that end on or before this date will be locked. If no date is set the request will freeze all effects starting from the start time. It must match one of the following formats:

  • Y-m-d
  • Y/m/d
  • d.m.Y
  • m/d/Y

locked
boolean
Default: true

The locked flag for the measure budgeting effects.

budgeting_item
string or integer or null

The budgeting item for which the effects should be locked.

If no budgeting item is set, the effects are locked for all budgeting items.

Responses
200

Successful operation

404

Not Found

422

Unprocessable Content

put/measurebudgeting/{measure}/freeze
Request samples
application/json
{
  • "start_time": "2022-06-01",
  • "budgeting_item": 4
}
Response samples
application/json
{
  • "success": true,
  • "hash": "8739602554c7f3241958e3cc9b57fdecb474d508",
  • "data": { },
  • "timestamp": 1660228556329
}

Set actual measure budgeting effects

Set the actual values with the plan values of the budgeting effects for the measure.

SecurityJWT
Request
path Parameters
measure
required
string or integer

The id/hash of the measure.

Request Body schema: application/json

A JSON object containing measure budgeting information.

overwrite
boolean
Default: false

The overwrite flag for the budgeting effects of the measure.

With this flag set, the actual effect values which are not null will be overwritten as well.

past
boolean
Default: false

The past flag for the budgeting effects of the measure.

With this flag set, the actual effect values from the past will be set as well.

Responses
200

Successful operation

404

Not Found

422

Unprocessable Content

put/measurebudgeting/{measure}/actual
Request samples
application/json
{
  • "overwrite": true,
  • "past": false
}
Response samples
application/json
{
  • "success": true,
  • "hash": "8739602554c7f3241958e3cc9b57fdecb474d508",
  • "data": { },
  • "timestamp": 1660230088104
}

Set plan measure budgeting effects

Set the plan values with the actual values of the budgeting effects for the measure.

SecurityJWT
Request
path Parameters
measure
required
string or integer

The id/hash of the measure.

Request Body schema: application/json

A JSON object containing measure budgeting information.

overwrite
boolean
Default: false

The overwrite flag for the budgeting effects of the measure.

With this flag set, the plan effect values which are not null will be overwritten as well.

past
boolean
Default: false

The past flag for the budgeting effects of the measure.

With this flag set, the plan effect values from the past will be set as well.

Responses
200

Successful operation

404

Not Found

422

Unprocessable Content

put/measurebudgeting/{measure}/plan
Request samples
application/json
{
  • "overwrite": true,
  • "past": false
}
Response samples
application/json
{
  • "success": true,
  • "hash": "8739602554c7f3241958e3cc9b57fdecb474d508",
  • "data": { },
  • "timestamp": 1660230430587
}

Reset measure budgeting effects

Remove all budgeting effects and all budgeting revisions for a measure.

SecurityJWT
Request
path Parameters
measure
required
string or integer

The id/hash of the measure.

Responses
200

Successful operation

404

Not Found

put/measurebudgeting/{measure}/reset
Request samples 
Response samples 
application/json
{
  • "success": true,
  • "hash": "8739602554c7f3241958e3cc9b57fdecb474d508",
  • "data": { },
  • "timestamp": 1660739332694
}
➔ Next to Measure budgeting effect