Important notice:
Organisations involved in addressing the COVID-19 pandemic are encouraged to publish data on their spending and activities using the IATI Standard. See COVID-19 IATI publishing guidance.

Discover how to access data by reading Guidance: Accessing and Using IATI COVID-19 Data

You are viewing VERSION 2.02 of IATI Standard Reference View another version

period-start

iati-activities/iati-activity/planned-disbursement/period-start

This is the reference page for the XML element period-start.

Definition

The exact date of the planned disbursement OR the starting date of the period in which this specific disbursement will be made.

Rules

This element must occur once and only 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-start 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>

Changelog

2.02

The definition of this element was amended for clarity.

Developer tools

Find the source of this documentation on github: