value

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

This is the reference page for the XML element value.

Definition

The total value of the money budgeted to be disbursed to the specified recipient organisation during this time period.

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 attribute is required.

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: