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 emissions of the company car.
ZeroEmissionsMileage xsd:integer ( min: 0 max: 9999) no The published range of zero emission miles.
FuelType xsd:string (enumeration)
  • DieselNonRde2
  • Electric
  • Hybrid
  • AllOther
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 vehicles registered after 1 Jan 1998. Required field from 2020/21 tax year onwards.
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.


<?xml version="1.0"?>
<CarBenefitPayInstruction xmlns:xsi="" xmlns:xsd="">
  "CarBenefitPayInstruction": {
    "StartDate": "2020-05-28",
    "EndDate": "2020-05-28",
    "Description": "string",
    "PayLineTag": "string",
    "Code": "string",
    "TotalCost": "123.99",
    "EmployeeContribution": "123.99",
    "CashEquivalent": "123.99",
    "AccountingMethod": "P11D",
    "BenefitEndDate": "2020-05-28",
    "MakeModel": "string",
    "Co2": "123",
    "ZeroEmissionsMileage": "123",
    "FuelType": "NotSet",
    "Registration": "string",
    "DateRegistered": "2020-05-28",
    "EmployeeContributionPrivateUse": "123.99",
    "FuelProvidedFrom": "2020-05-28",
    "FuelWithdrawn": "2020-05-28",
    "FuelReinstated": "2020-05-28"