value

iati-activities/iati-activity/transaction/value

This is the reference page for the XML element value.

Definition

The amount of the contribution.

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.

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" humanitarian="1">
   <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" type="10" ref="BB-BBB-123456789">
    <narrative>Agency B</narrative>
   </provider-org>
   <receiver-org receiver-activity-id="AA-AAA-123456789-1234" type="23" 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="TM" />
   <recipient-region code="616" vocabulary="1" />
   <flow-type code="10" />
   <finance-type code="110" />
   <aid-type code="A01" vocabulary="1" />
   <aid-type code="1" vocabulary="2" />
   <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: