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.

Example

<?xml version="1.0"?>
<CarBenefitPayInstruction xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <StartDate>2021-01-14</StartDate>
  <EndDate>2021-01-14</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>2021-01-14</BenefitEndDate>
  <MakeModel>string</MakeModel>
  <Co2>123</Co2>
  <ZeroEmissionsMileage>123</ZeroEmissionsMileage>
  <FuelType>NotSet</FuelType>
  <Registration>string</Registration>
  <DateRegistered>2021-01-14</DateRegistered>
  <EmployeeContributionPrivateUse>123.99</EmployeeContributionPrivateUse>
  <FuelProvidedFrom>2021-01-14</FuelProvidedFrom>
  <FuelWithdrawn>2021-01-14</FuelWithdrawn>
  <FuelReinstated>2021-01-14</FuelReinstated>
</CarBenefitPayInstruction>

{
  "CarBenefitPayInstruction": {
    "StartDate": "2021-01-14",
    "EndDate": "2021-01-14",
    "Description": "string",
    "PayLineTag": "string",
    "Code": "string",
    "TotalCost": "123.99",
    "EmployeeContribution": "123.99",
    "CashEquivalent": "123.99",
    "AccountingMethod": "P11D",
    "BenefitEndDate": "2021-01-14",
    "MakeModel": "string",
    "Co2": "123",
    "ZeroEmissionsMileage": "123",
    "FuelType": "NotSet",
    "Registration": "string",
    "DateRegistered": "2021-01-14",
    "EmployeeContributionPrivateUse": "123.99",
    "FuelProvidedFrom": "2021-01-14",
    "FuelWithdrawn": "2021-01-14",
    "FuelReinstated": "2021-01-14"
  }
}