value

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

This is the reference page for the XML element value.

Definition

Data type for an element containing a currency value.

Rules

This element must occur once and only once (within each parent element).

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-organisation/@default-currency attribute is specified.

This value must be of type xsd:string.

This value must be on the Currency codelist.

@value-date

The date to be used for determining the exchange rate for currency conversions.

This value must be of type xsd:date.

Example Usage

Example value of recipient-org-budget for an iati-organisation.

An example date is declared in the @value-date attribute.
This example date format conform to the xsd:date standard - for most cases YYYY-MM-DD is sufficient.
This example declares a Currency code USD, using the @currency attribute.
Note: A Currency code should only be declared if different to @default-currency in the iati-organisation element.
  <recipient-org-budget status="2">
   <recipient-org ref="AA-ABC-1234567">
    <narrative>Org Name</narrative>
   </recipient-org>
   <period-start iso-date="2014-01-01" />
   <period-end iso-date="2014-12-31" />
   <value currency="USD" value-date="2014-01-01">2500000</value>
   <budget-line ref="1234">
    <value currency="USD" value-date="2014-01-01">2000000</value>
     <narrative>Budget Line</narrative>
   </budget-line>
  </recipient-org-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: