This version is DEPRECATED, v2.03 is the latest version
value
iati-activities/iati-activity/transaction/value
This is the reference page for the XML element value
.
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">
<valuecurrency="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">
<valuecurrency="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: