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.03 of IATI Standard Reference View another version

transaction

iati-activities/iati-activity/transaction

This is the reference page for the XML element transaction.

Definition

Transactions recording committed or actual funds flowing in or out of an aid activity.

Rules

This element may occur any number of times.

Attributes

@ref

An internal reference linking this transaction back to the publisher’s financial management system.

This value must be of type xsd:string.

@humanitarian

A process flag to indicate that this transaction relates entirely or partially to humanitarian aid. If the entire activity relates to humanitarian aid this should be reported using iati-activity/@humanitarian, rather than for each transaction.

This value must be of type xsd:boolean.

Example Usage

Example transaction in an iati-activity.

This element is a parent for other child elements.

An example @ref of 1234 is declared.

<transaction ref="1234">
....
</transaction>

An example which would denote this as a humanitarian transaction i.e. with the @humanitarian element set to ‘1’.

<transaction ref="1234">
....
</transaction>

Full example with all child elements:

  <transaction ref="1234" humanitarian="1">
   <transaction-type code="1" />
   <transaction-date iso-date="2012-01-01" />
   <value currency="EUR" value-date="2012-01-01">1000</value>
   <description>
    <narrative>Transaction description text</narrative>
   </description>
   <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>
   <disbursement-channel code="1" />
   <sector vocabulary="2" code="111" />
   <!--Note: only a recipient-region OR a recipient-country is expected-->
   <recipient-country code="TM" />
   <recipient-region code="616" vocabulary="1" />
   <flow-type code="10" />
   <finance-type code="110" />
   <aid-type code="A01" vocabulary="1" />
   <aid-type code="1" vocabulary="2" />
   <tied-status code="3" />
  </transaction>

The transaction element can be repeated in any iati-activity.

Changelog

2.02

The humanitarian attribute was added.

Developer tools

Find the source of this documentation on github:

Subelements