value

iati-organisations/iati-organisation/recipient-country-budget/value

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

Definition

The total value of the money budgeted to be disbursed to the specified country during this time period. This element is required.

Attributes

@currency

A three letter ISO 4217 code for the original currency of the amount. This is required for all currency amounts unless the iati-activity/@default-currency (or iati-organisation/@default-currency for an organisation file) attribute is specified.

Currency codes are listed at http://iatistandard.org/codelists/currency

This value must be of type xsd:string.

This value must be on the Currency codelist.

@value-date

The date that this value was set (to allow historical currency conversion). The date must be in ISO 8601 format (YYYY-MM-DD).

This value must be of type xsd:date.

Example Usage

Example usage of value in context of recipient-country-budget element.

A value-date for currency conversions must be provided in ISO 8601 format (YYYY-MM-DD).

The ISO 4217 code for the currency in which the recipient-country-budget is denominated should be declared using the Currency codelist, but only if different to default-currency in the iati-organisation element.

  <recipient-country-budget>
   <recipient-country code="AA">Country Name</recipient-country>
   <period-start iso-date="2014-01-01" />
   <period-end iso-date="2014-12-31" />
   <value currency="USD" value-date="2014-01-01">25000000</value>
  </recipient-country-budget>
  <recipient-country-budget>
   <recipient-country code="AA">Country Name</recipient-country>
   <period-start iso-date="2015-01-01" />
   <period-end iso-date="2015-12-31" />
   <value currency="USD" value-date="2014-01-01">30000000</value>
  </recipient-country-budget>
  <recipient-country-budget>
   <recipient-country code="AA">Country Name</recipient-country>
   <period-start iso-date="2016-01-01" />
   <period-end iso-date="2016-12-31" />
   <value currency="USD" value-date="2014-01-01">35000000</value>
  </recipient-country-budget>

Changelog

1.03

Currency values are now allowed to be declared as decimals instead of integers.

Developer tools

Find the source of this documentation on github:

Last updated on 2015-10-16