Annual forward planning budgets for recipient countries
Definitions
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 the next three to five 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.
| country-code | The code for the recipient country |
| country-name-language | The language in which the name of the country is reported. |
| country-name | The name of the country |
| period-start-date | Start date of the reporting period. |
| period-start-text | A free text description of the period start. |
| period-end-date | End date of the reporting period. |
| period-end-text | A free text description of the period end. |
| currency | The currency in which the project is denominated. |
| value-date | Date of value for currency conversions. |
| value | The total budget for the specified period in the specified or default currency. |
Example Usage
The example below shows full reporting for two countries for two consecutive years.
..
Ivory Coast
2012/13
2012/13
250000000
Ivory Coast
2013/14
2013/14
300000000
République Démocratique du Congo
2012/13
2012/13
250000000
République Démocratique du Congo
2013/14
2013/14
300000000
..
Stripped to essentials it is:
..
250000000
300000000
250000000
300000000
..
Structure
| Item | Format | XML | Occurs |
|---|---|---|---|
| recipient-country-budget | recipient-country-budget | 0..* | |
| recipient-country | recipient-country-budget/recipient-country | 1..1 | |
| country-code | Country Code | recipient-country-budget/recipient-country/@code | 1..1 |
| country-name-language | Language Code | recipient-country-budget/recipient-country/@xml:lang | 0..1 |
| country-name | Text | recipient-country-budget/recipient-country/text() | 0..1 |
| period-start | recipient-country-budget/period-start | 1..1 | |
| period-start-date | Date | recipient-country-budget/period-start/@iso-date | 1..1 |
| period-start-text | Text | recipient-country-budget/period-start/text() | 0..1 |
| period-end | recipient-country-budget/period-end | 1..1 | |
| period-end-date | Date | recipient-country-budget/period-end/@iso-date | 1..1 |
| period-end-text | Text | recipient-country-budget/period-end/text() | 0..1 |
| value | recipient-country-budget/value | 1..1 | |
| currency | Currency Code | recipient-country-budget/value/@currency | 0..1 |
| value-date | Date | recipient-country-budget/value/@value-date | 1..1 |
| value-amount | Integer | recipient-country-budget/value/text() | 1..1 |
Usage & Compliance
The recipient-country-budget element is not mandatory, but is recommended for full compliance. An instance of the element should be used for each country budget-period reported. There is no limit to the number of instances.
For every occurrence of the recipient-country-budget element:
- The recipient-country element is mandatory.
- The country-code is mandatory.
- If the country-name is present in a language other than the default-language specified in the Record Header (or the default-language specified in the Record Header is omitted), country-name-language is mandatory.
- The period-start element is mandatory.
- The period-start-date is mandatory.
- The period-start-date must be in a valid ISO date format.
- The period-end element is mandatory.
- The period-end-date is mandatory.
- The period-end-date must be in a valid ISO date format.
- The value element is mandatory.
- If the default-currency has not been specified in the Record Header, currency is mandatory.
- If currency is present it must be a valid code from the codelist.
- The period-end-date must be in a valid ISO date format.
- The value-date is mandatory.
- The value-date must be in a valid ISO date format.
- The value is mandatory.
- The value must be a positive integer.