Measure package budgeting

A measure package budgeting.

Freeze measure package budgeting effects

Freeze measure budgeting effects for a measure package.

SecurityJWT
Request
path Parameters
measurepackage
required
string or integer

The id/hash of the measure package.

Request Body schema: application/json

A JSON object containing measure package budgeting information.

start_time
required
string <date>

The start time of the budgeting periods for the measure budgeting effects in the measure package 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 in the measure package 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 in the measure package.

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/measurepackagebudgeting/{measurepackage}/freeze
Request samples
application/json
{
  • "start_time": "2022-06-01",
  • "budgeting_item": 4
}
Response samples
application/json
{
  • "success": true,
  • "hash": "8739602554c7f3241958e3cc9b57fdecb474d508",
  • "data": { },
  • "timestamp": 1660575624319
}

Set actual measure package budgeting effects

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

SecurityJWT
Request
path Parameters
measurepackage
required
string or integer

The id/hash of the measure package.

Request Body schema: application/json

A JSON object containing measure package budgeting information.

overwrite
boolean
Default: false

The overwrite flag for the budgeting effects of the measures in the measure package.

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 measures in the measure package.

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/measurepackagebudgeting/{measurepackage}/actual
Request samples
application/json
{
  • "overwrite": true,
  • "past": false
}
Response samples
application/json
{
  • "success": true,
  • "hash": "8739602554c7f3241958e3cc9b57fdecb474d508",
  • "data": { },
  • "timestamp": 1660576042711
}

Set plan measure package budgeting effects

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

SecurityJWT
Request
path Parameters
measurepackage
required
string or integer

The id/hash of the measure package.

Request Body schema: application/json

A JSON object containing measure package budgeting information.

overwrite
boolean
Default: false

The overwrite flag for the budgeting effects of the measures in the measure package.

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 measures in the measure package.

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/measurepackagebudgeting/{measurepackage}/plan
Request samples
application/json
{
  • "overwrite": true,
  • "past": false
}
Response samples
application/json
{
  • "success": true,
  • "hash": "8739602554c7f3241958e3cc9b57fdecb474d508",
  • "data": { },
  • "timestamp": 1660576507106
}

Reset measure package budgeting effects

Reset measure budgeting effects for a measure package.

SecurityJWT
Request
path Parameters
measurepackage
required
string or integer

The id/hash of the measure package.

Responses
200

Successful operation

404

Not Found

put/measurepackagebudgeting/{measurepackage}/reset
Request samples 
Response samples 
application/json
{
  • "success": true,
  • "hash": "8739602554c7f3241958e3cc9b57fdecb474d508",
  • "data": { },
  • "timestamp": 1660739369145
}
➔ Next to Measure package budgeting effect