You are viewing VERSION 2.02 of IATI Standard Reference View another version
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
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 attribute is required.
This value must be of type xsd:date.
11.2.2: The transaction 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.
<transactionref="1234"humanitarian="1">
<transaction-typecode="1"/>
<transaction-dateiso-date="2012-01-01"/>
<valuecurrency="EUR"value-date="2012-01-01">1000</value>
<description>
<narrative>Transactiondescriptiontext</narrative>
</description>
<provider-orgprovider-activity-id="BB-BBB-123456789-1234AA"type="10"ref="BB-BBB-123456789">
<narrative>AgencyB</narrative>
</provider-org>
<receiver-orgreceiver-activity-id="AA-AAA-123456789-1234"type="23"ref="AA-AAA-123456789">
<narrative>AgencyA</narrative>
</receiver-org>
<disbursement-channelcode="1"/>
<sectorvocabulary="2"code="111"/>
<!--Note: only a recipient-region OR a recipient-country is expected-->
<recipient-countrycode="TM"/>
<recipient-regioncode="616"vocabulary="1"/>
<flow-typecode="10"/>
<finance-typecode="110"/>
<aid-typecode="A01"/>
<tied-statuscode="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: