Car Benefit Pay Instruction
CarBenefitPayInstruction [Schema]
Name | Type | Required | Description |
---|---|---|---|
MakeModel | xsd:string
(
min: 1
max: 35)
Pattern: [A-Za-z0-9 \(\)\-\./]* |
yes | The make and model of the company car. |
Co2 | xsd:integer ( min: 0 max: 999) | yes | The published Co2 emmisions of the company car. |
FuelType | xsd:string (enumeration)
|
yes | The fuel type of the company car. |
Registration | xsd:string
(
min: 1
max: 10)
Pattern: [A-Za-z0-9 ]* |
yes | A unique identifier for the company car, the registration number is recommended. |
DateRegistered | xsd:date ( min: 1998-01-01) | no | The date the vehicle was first registered. Calculations are only supported for vechicles registered after 1 Jan 1998. |
EmployeeContributionPrivateUse | Money | no | The amount the employee contributes towards usage of the car for private use. |
FuelProvidedFrom | xsd:date | no | The date from which the employer provides free fuel to the employee for private use. |
FuelWithdrawn | xsd:date | no | The date from which the employer ceases to provide free fuel to the employee for private use. |
FuelReinstated | xsd:date | no | The date from which the employer reinstates providing free fuel to the employee for private use. |
Interits from: BenefitPayInstruction[Schema]
Name | Type | Required | Description |
---|---|---|---|
BenefitPayInstruction | BenefitPayInstruction | no | |
Code | SystemCode | yes | The code that represents the benefit type and it' treatment. |
TotalCost | Money | yes | The total cost (or value) of the benefit for the remainder of the financial year. |
EmployeeContribution | Money | yes | The amount the employee contributes towards the benefit for the rest of the financial year. |
CashEquivalent | Money | no | The per period cash equivalent value of the benefit. [Optional] used to override the calculated cash equivilent value. |
AccountingMethod | BenefitAccountingMethod | yes | The accounting method used to report the benefit to HMRC. |
BenefitEndDate | xsd:date | no | The date benefit ceases, this is different to end date of the instruction. |
Interits from: PayInstruction [Schema]
See Understanding Pay Instructions for more information on how pay instructions can be used.
Name | Type | Required | Description" |
---|---|---|---|
StartDate | xsd:date | yes | The date the instruction will come into effect. |
EndDate | xsd:date | no | The date the instruction will end, open ended instructions will run forever. |
Description | xsd:string ( max: 200) | no | The pay line descripton override; this description will override the default description from the pay code. See Customising the Payslip for more information on customising the payslip output and using runtime variables. |
PayLineTag | xsd:string ( max: 100) | no | If specified, the PayLineTag value is used to decorate all child pay lines generated by the instruction. |
Example
<?xml version="1.0"?>
<CarBenefitPayInstruction xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<StartDate>2019-12-05</StartDate>
<EndDate>2019-12-05</EndDate>
<Description>string</Description>
<PayLineTag>string</PayLineTag>
<Code>string</Code>
<TotalCost>123.99</TotalCost>
<EmployeeContribution>123.99</EmployeeContribution>
<CashEquivalent>123.99</CashEquivalent>
<AccountingMethod>P11D</AccountingMethod>
<BenefitEndDate>2019-12-05</BenefitEndDate>
<MakeModel>string</MakeModel>
<Co2>123</Co2>
<FuelType>NotSet</FuelType>
<Registration>string</Registration>
<DateRegistered>2019-12-05</DateRegistered>
<EmployeeContributionPrivateUse>123.99</EmployeeContributionPrivateUse>
<FuelProvidedFrom>2019-12-05</FuelProvidedFrom>
<FuelWithdrawn>2019-12-05</FuelWithdrawn>
<FuelReinstated>2019-12-05</FuelReinstated>
</CarBenefitPayInstruction>
{
"CarBenefitPayInstruction": {
"StartDate": "2019-12-05",
"EndDate": "2019-12-05",
"Description": "string",
"PayLineTag": "string",
"Code": "string",
"TotalCost": "123.99",
"EmployeeContribution": "123.99",
"CashEquivalent": "123.99",
"AccountingMethod": "P11D",
"BenefitEndDate": "2019-12-05",
"MakeModel": "string",
"Co2": "123",
"FuelType": "NotSet",
"Registration": "string",
"DateRegistered": "2019-12-05",
"EmployeeContributionPrivateUse": "123.99",
"FuelProvidedFrom": "2019-12-05",
"FuelWithdrawn": "2019-12-05",
"FuelReinstated": "2019-12-05"
}
}