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 aid activity’s budget for each financial quarter or year over the lifetime of the activity. The total budget for an activity should be reported as a commitment in the transaction element. 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. While it is useful for the sum of budgets to match the sum of commitments this is not necessarily the case, 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

2.02

The status attribute was added.

Developer tools

Find the source of this documentation on github:

Subelements

Last updated on 2016-09-08