SaveMtdDividendsIncomeRequest
Saves the year's foreign and special dividends at HMRC.
A full replacement: everything that should survive must be present, because
what is absent is cleared. Clearing the year is a delete, not an empty save — an all-empty
request is refused rather than silently wiping what HMRC hold.
Who is sending it is taken from the authenticated user, never from the request — the stamp is
evidence of who filed, so it cannot be something a caller supplies.
Properties
| Name | Type | Description |
|---|---|---|
| foreignDividend | array of ForeignDividendItem | Dividends from foreign companies. Each item needs a country code and taxable amount. |
Dividends from foreign companies. Each item needs a country code and taxable amount. | ||
| dividendIncomeReceivedWhilstAbroad | array of ForeignDividendItem | Dividend income received whilst abroad. |
Dividend income received whilst abroad. | ||
| stockDividend | DividendGross | |
| redeemableShares | DividendGross | |
| bonusIssuesOfSecurities | DividendGross | |
| closeCompanyLoansWrittenOff | DividendGross | |
JSON Example
{
"foreignDividend": [
{
"countryCode": "...",
"amountBeforeTax": "...",
"taxTakenOff": "...",
"specialWithholdingTax": "...",
"foreignTaxCreditRelief": "..."
}
],
"dividendIncomeReceivedWhilstAbroad": [
{
"countryCode": "...",
"amountBeforeTax": "...",
"taxTakenOff": "...",
"specialWithholdingTax": "...",
"foreignTaxCreditRelief": "..."
}
],
"stockDividend": {
"customerReference": "string",
"grossAmount": 0
},
"redeemableShares": {
"customerReference": "string",
"grossAmount": 0
},
"bonusIssuesOfSecurities": {
"customerReference": "string",
"grossAmount": 0
}
}