reporting-org

iati-organisations/iati-organisation/reporting-org

This is the reference page for the XML element reporting-org. See also the relevant overview page: Type of Organisations

Definition

The organisation issuing the report. May be a primary source (reporting on its own activity as donor, implementing agency, etc) or a secondary source (reporting on the activities of another organisation).

Specifying the @ref attribute is mandatory. May contain the organisation name as content.

All activities in an activity xml file must contain the same @ref AND this @ref must be the same as the iati-identifier recorded in the registry publisher record of the account under which this file is published.

Rules

This element must occur once and only once (within each parent element).

The time between recipient-country-budget/period-start/@iso-date and recipient-country-budget/period-end/@iso-date must not be over a year

The time between recipient-org-budget/period-start/@iso-date and recipient-org-budget/period-end/@iso-date must not be over a year

@xml-lang must exist, otherwise all lang must exist.

@default-currency must exist, otherwise all currency must exist.

Attributes

@ref

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}

This attribute is required.

This value must be of type xsd:string.

The time between recipient-country-budget/period-start/@iso-date and recipient-country-budget/period-end/@iso-date must not be over a year

The time between recipient-org-budget/period-start/@iso-date and recipient-org-budget/period-end/@iso-date must not be over a year

reporting-org/@ref should match the regex [^\/\&\|\?]+

@xml-lang must exist, otherwise all lang must exist.

@default-currency must exist, otherwise all currency must exist.

@type

The type of organisation issuing the report. See IATI codelist for values.

This attribute is required.

This value must be of type xsd:string.

This value must be on the OrganisationType codelist.

The time between recipient-country-budget/period-start/@iso-date and recipient-country-budget/period-end/@iso-date must not be over a year

The time between recipient-org-budget/period-start/@iso-date and recipient-org-budget/period-end/@iso-date must not be over a year

@xml-lang must exist, otherwise all lang must exist.

@default-currency must exist, otherwise all currency must exist.

@secondary-reporter

A flag indicating that the reporting organisation is a secondary publisher: publishing data for which it is not directly responsible. This flag must not be reported by primary source publishers

This value must be of type xsd:boolean.

The time between recipient-country-budget/period-start/@iso-date and recipient-country-budget/period-end/@iso-date must not be over a year

The time between recipient-org-budget/period-start/@iso-date and recipient-org-budget/period-end/@iso-date must not be over a year

@xml-lang must exist, otherwise all lang must exist.

@default-currency must exist, otherwise all currency must exist.

Example Usage

Example reporting-org for an iati-organisation.

An example organisation @ref of AA-AAA-123456789 is declared.
The @type attribute declares a valid code (40) from the OrganisationType codelist.
The optional @secondary-publisher boolean is included, for illustration.
  <reporting-org ref="AA-AAA-123456789" type="40" secondary-reporter="0">
	  <narrative>Organisation name</narrative>
	  <narrative xml:lang="fr">Nom de l'organisme</narrative>	  
  </reporting-org>

Changelog

2.01

Freetext is no longer allowed with this element. It should now be declared with the new child narrative element.

1.04

The @secondary-publisher attribute was introduced in 1.04.

Developer tools

Find the source of this documentation on github:

Subelements