budget

iati-activities/iati-activity/budget

This is the reference page for the XML element budget. See also the relevant overview page: Budgets

Definition

The value of the activity’s budget for each financial quarter or year over the lifetime of the activity. The purpose of this element is to provide predictability for recipient planning on an annual basis. The status explains whether the budget being reported is indicative or has been formally committed. The value should appear within the BudgetStatus codelist. If the @status attribute is not present, the budget is assumed to be indicative. The sum of budgets may or may not match the sum of commitments, depending on a publisher’s business model and legal frameworks.

Rules

This element may occur any number of times.

Attributes

@type

Whether this is the original budget (prepared when the original commitment was made) or has subsequently been revised

This value must be of type xsd:string.

This value must be on the BudgetType codelist.

@status

The status explains whether the budget being reported is indicative or has been formally committed. The value should appear within the BudgetStatus codelist. If the @status attribute is not present, the budget is assumed to be indicative.

This value must be of type xsd:string.

This value must be on the BudgetStatus codelist.

Example Usage

Example budget for an iati-activity.

This element is a parent for other child elements.
The @type attribute declares a valid code (1) from the BudgetType codelist.
The @status attribute declares a valid code (1) from the BudgetStatus codelist.
<budget type="1" status="1">
...
</budget>
Note: If the @type attribute is omitted, then BudgetType code 1 (Original) is assumed.
Similarly, if the @status attribute is omitted, then BudgetStatus code 1 (Indicative) is assumed.
Full example with all child elements:
  <budget type="1" status="1">
   <period-start iso-date="2014-01-01" />
   <period-end iso-date="2014-12-31" />
   <value currency="EUR" value-date="2014-01-01">3000</value>
  </budget>
The budget element can be repeated in any iati-activity.

Changelog

27/02/2018

The budget definition was updated as a bug fix.

2.02

The status attribute was added.

Developer tools

Find the source of this documentation on github:

Subelements

Last updated on 2018-07-04