value

iati-activities/iati-activity/transaction/value

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

Definition

The amount of the contribution (or its value, if in kind).

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.

value/@value-date must not be in the future.

Example Usage

Example usage of value in context of transaction 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 transaction is denominated should be declared using the Currency codelist, but only if different to default-currency in the iati-activity element.

  <transaction ref="1234">
   <value currency="EUR" value-date="2012-01-01">1000</value>  
   <description>Transaction description text</description>
   <transaction-type code="IF" />
   <provider-org provider-activity-id="BB-BBB-123456789-1234AA" ref="BB-BBB-123456789">Agency B</provider-org>
   <receiver-org receiver-activity-id="AA-AAA-123456789-1234" ref="AA-AAA-123456789">Agency A</receiver-org>
   <transaction-date iso-date="2012-01-01" />
   <disbursement-channel code="1" />
  </transaction>

Full example with additional elements which can override the default value set in iati-activity:

  <transaction ref="1234">
   <value currency="EUR" value-date="2012-01-01">1000</value>   
   <description>Transaction description text</description>
   <transaction-type code="IF" />
   <provider-org provider-activity-id="BB-BBB-123456789-1234AA" ref="BB-BBB-123456789">Agency B</provider-org>
   <receiver-org receiver-activity-id="AA-AAA-123456789-1234" ref="AA-AAA-123456789">Agency A</receiver-org>
   <transaction-date iso-date="2012-01-01" />
   <flow-type code="20" />
   <finance-type code="111" />
   <aid-type code="A02" />   
   <tied-status code="5" />
   <disbursement-channel code="1" />
  </transaction>

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: