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>