value
iati-activities/iati-activity/planned-disbursement/value
This is the reference page for the XML element value
.
Definition
The amount that is planned to be disbursed in the specified currency.
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.
Example Usage
Example usage of value
in context of planned-disbursement
element.
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.
<planned-disbursement type="1">
<period-start iso-date="2014-01-01" />
<period-end iso-date="2014-12-31" />
<value currency="EUR" value-date="2014-01-01">3000</value>
<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>
</planned-disbursement>
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: