International Aid Transparency Initiative: Organisation-Information Schema
Release 2.01, 2014-10-21
NOTE: the xml.xsd and iati-common.xsd schemas must be in the
same directory as this one.
This W3C XML Schema defines an XML document type for information
about an aid organisation, following the standard published at
http://iatistandard.org
This document type may be extended with additional elements and
attributes, but they must belong to an explicit XML namespace.
Top-level list of one or more IATI organisation records.
A number indicating the IATI specification version in use.
This is mandatory and must be a valid version.
A date/time stamp for when this file was generated. This
is not necessarily the last-updated date for the
individual activity records in it. Use of this attribute
is highly recommended, to allow recipients to know when a
file has been updated.
Top-level element for a single IATI organisation report.
Machine-readable identification string for the
organisation issuing the report. Must be in the format
{RegistrationAgency}-{RegistrationNumber} where
{RegistrationAgency} is a valid code in the
RegistrationAgency code list and {RegistrationNumber }
is a valid identifier issued by the {RegistrationAgency}
The last date/time that the data for this specific
organisation was updated. This date must change whenever
the value of any field changes.
ISO 639-1 code specifying the default language used in
narrative elements throughout the activity. If this is not
declared then the xml:lang attribute MUST be specified for
each narrative element.
Default ISO 4217 currency code for all financial values in
this activity report. If this is not declared then the
currency attribute MUST be specified for all monetary
values.
The human-readable name of the organisation.
The total-budget element allows for the reporting of the organisation's
own budget. The recommendation is that, where and when possible, the
organisation's total annual planned budget for each of the next three
years is reported.
The start of the budget period.
The end of the period (which must not be greater than one year)
The total value of the organisation's aid budget for
this period.
A breakdown of the total budget into sub-totals. The
breakdown is determined by the reporting organisation
and described in the narrative. The period covered is
the same as that covered by the parent total-budget
element. The sum of budget-line values does not have to
equal the value given in the parent element.
The budget sub-total. The definition of the
sub-division is determined by
iati-organisation/total-budget/budget-line/narrative
An internal reference for this budget line taken
from the reporting organisation's own system.
Optional.
The recipient-org-budget element allows for the reporting of
forward looking budgets for each institution which receives
core funding from the reporting organisation. The
recommendation is that, where and when possible, annual
planned budgets for each recipient institution for each of the
next three financial years are reported. This is primarily
applicable to donors but any provider of core funding is
expected to use it. Earmarked budgets should be reported at
activity-level through the Activity Standard.
The organisation that will receive the funds.
The name of the organisation. This can be repeated in multiple languages.
Machine-readable identification string for the
organisation. Must be in the format {Registration Agency}
- (Registration Number} where {Registration Agency} is a
valid code in the Registration Agency code list and
{Registration Number } is a valid identifier issued by the
{Registration Agency}. If this is not present then the
narrative MUST contain the name of the organisation.
The start of the budget period.
The end of the period (which must not be greater than one year)
The total value of the money budgeted to be disbursed to
the specified recipient organisation during this time
period.
A breakdown of the recipient organisation's budget into
sub-totals. The breakdown is determined by the
reporting organisation and described in the narrative.
The period covered is the same as that covered by the
parent recipient-org-budget element. The sum of
budget-line values does not have to equal the value
given in the parent element.
The budget sub-total. The definition of the
sub-division is determined by
iati-organisation/recipient-org-budget/budget-line/narrative
An internal reference for this budget line taken
from the reporting organisation's own system.
Optional.
The recipient-country-budget element allows for the reporting of
forward looking budgets for each country in which the organisation
operates. The recommendation is that, where and when possible, the
organisation's total annual planned budget for each of the next
three financial years is reported for each recipient country.
It is strongly recommended that the start and end of the reported
financial years match those of the recipient country's
budgetary/planning cycle.
The recipient country.
ISO 3166-1 alpha-2 code for the country.
The start of the budget period.
The end of the period (which must not be greater than one year)
The total value of the money budgeted to be disbursed to
the specified country during this time period. This
element is required.
A breakdown of the recipient country's budget into
sub-totals. The breakdown is determined by the
reporting organisation and described in the narrative.
The period covered is the same as that covered by the
parent recipient-country-budget element. The sum of
budget-line values does not have to equal the value
given in the parent element.
The budget sub-total. The definition of the
sub-division is determined by
iati-organisation/recipient-country-budget/budget-line/narrative
An internal reference for this budget line taken
from the reporting organisation's own system.
Optional.
A link to an online, publicly accessible web page or
document.
IATI Document Category Code
An IATI code defining the category of the document.
The ISO 639-1 language code in which target document is
written, e.g. "en". Can be repeated to describe
multi-lingual documents.
ISO 639-1 language code
The recipient country that is the focus of the document.
May be repeated for multiple countries.
ISO 3166-1 alpha-2 code for the country.
The target URL of the external document, e.g. "http://www.example.org/doc.odt".
An IANA code for the MIME type of the document being
referenced, e.g. "application/pdf".
Data type for an element containing a currency value.
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.