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.

period-start/@iso-date must be before or the same as period-end/@iso-date

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: