recipient-country¶
iati-activities/iati-activity/transaction/recipient-country
This is the reference page for the XML element recipient-country.
Definition¶
A country that will benefit from this transaction. If a specific country is not known the recipient-region element should be used instead.
If transaction/recipient-country AND/OR transaction/recipient-region are used THEN ALL transaction elements MUST contain a recipient-country or recipient-region element AND (iati-activity/recipient-country AND iati-activity/recipient-region MUST NOT be used)
Rules¶
This element must occur no more than once (within each parent element).
transaction/recipient-country must not be present alongisde recipient-region and recipient-country.
Attributes¶
- @code
ISO 3166-1 alpha-2 code for the country.
This attribute is required.
This value must be of type xsd:string.
This value should be on the Country codelist.
Example Usage¶
Example recipient-country of transaction in an iati-activity.
@code attribute declares a valid code (AF) from the Country codelist.<recipient-country code="AF" />
Full example:
<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>