period-end
iati-activities/iati-activity/planned-disbursement/period-end
This is the reference page for the XML element period-end
.
Definition
The ending date for the period in which this specific disbursement will be made.
Rules
This element must occur no more than once (within each parent element).
Attributes
@iso-date
This attribute is required.
This value must be of type xsd:date.
8.6.3: The start of the period must be before the end of the period.
Usage in practice
The period start
should define when the actual transfer of funds will take place, if a specific date is known. If the specific payment date is not known, the period in which the transfer is due to take place should be described by using both period-start
and period-end
dates.
The timeframe between period-start
and period-end
should not normally exceed 3 calendar months.
Example Usage
Example usage of period-end
of planned-disbursement
for an iati-activity
.
An example date is declared in the @iso-date
attribute.
This example date format conform to the xsd:date standard - for most cases YYYY-MM-DD is sufficient.
<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>
In some instances, it may not be feasible to declare an period-end
date. In such cases, the element is not included:
<planned-disbursement type="1">
<period-start iso-date="2014-01-01" />
<value currency="EUR" value-date="2014-01-01">3000</value>
</planned-disbursement>
Changelog
2.02
The definition of this element was amended for clarity.
Developer tools
Find the source of this documentation on github: