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.

Rules

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

Attributes

@currency

The ISO 4217 alphabetic currency code of the value reported. This is required unless the iati-activity/@default-currency is present and applies.

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.

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

Example Usage

Example usage of value of a transaction in an iati-activity.

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 EUR, using the @currency attribute.
Note: A Currency code should only be declared if different to @default-currency in the iati-activity element.
  <transaction ref="1234">
   <transaction-type code="1" />
   <transaction-date iso-date="2012-01-01" />
   <value currency="EUR" value-date="2012-01-01">1000</value>   
   <description>
	<narrative>Transaction description text</narrative>
   </description>
   <provider-org provider-activity-id="BB-BBB-123456789-1234AA" ref="BB-BBB-123456789">
	<narrative>Agency B</narrative>
   </provider-org>
   <receiver-org receiver-activity-id="AA-AAA-123456789-1234" ref="AA-AAA-123456789">
	<narrative>Agency A</narrative>
   </receiver-org>
   <disbursement-channel code="1" />
   <sector vocabulary="2" code="111" />
   <!--Note: only a recipient-region OR a recipient-country is expected-->
   <recipient-country code="AF" />
   <recipient-region code="456" vocabulary="1" />   
   <flow-type code="10" />
   <finance-type code="110" />
   <aid-type code="A01" />   
   <tied-status code="3" />
  </transaction>

Changelog

1.03

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

Developer tools

Find the source of this documentation on github: