Car Benefit YTD Pay Instruction



CarBenefitYtdPayInstruction [Schema]

Name Type Required Description
TaxableVehicle Money yes The taxable amount of due on the benefit for the vehicle.
TaxableFuel Money yes The taxable amount of due on the benefit for fuel provided by the employer for private use.
VehicleRegistration xsd:string ( max: 10)
Pattern: [A-Za-z0-9 ]*
no A unique identifier for the vehicle, typically the registration, for which the benefit applies.
CashEquivalentVehicle Money no The annualised calculated cash equivalent benefit of the vehicle.
CashEquivalentFuel Money no The annualised calculated cash equivalent benefit of the fuel provided by the employer.
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.
FuelType FuelType no The fuel type of the company car.
ZeroEmissionsMileage xsd:integer ( min: 0 max: 9999) no The published range of zero emission miles.

Interits from: BenefitYtdPayInstruction[Schema]

Name Type Required Description
BenefitYtdPayInstruction BenefitYtdPayInstruction no
Code SystemCode yes
Value Money yes
TaxableAmount Money yes
AccountingMethod BenefitAccountingMethod yes
IsAdjustment xsd:boolean yes Indicates if the instruction is an adjustment. Pay lines generated from adjustment YTD instructions appear on the employee pay slip.

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"?>
<CarBenefitYtdPayInstruction xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <StartDate>2021-09-26</StartDate>
  <EndDate>2021-09-26</EndDate>
  <Description>string</Description>
  <PayLineTag>string</PayLineTag>
  <Code>string</Code>
  <Value>123.99</Value>
  <TaxableAmount>123.99</TaxableAmount>
  <AccountingMethod>P11D</AccountingMethod>
  <IsAdjustment>true</IsAdjustment>
  <TaxableVehicle>123.99</TaxableVehicle>
  <TaxableFuel>123.99</TaxableFuel>
  <VehicleRegistration>string</VehicleRegistration>
  <CashEquivalentVehicle>123.99</CashEquivalentVehicle>
  <CashEquivalentFuel>123.99</CashEquivalentFuel>
  <DateRegistered>2021-09-26</DateRegistered>
  <FuelType>NotSet</FuelType>
  <ZeroEmissionsMileage>123</ZeroEmissionsMileage>
</CarBenefitYtdPayInstruction>
{
  "CarBenefitYtdPayInstruction": {
    "StartDate": "2021-09-26",
    "EndDate": "2021-09-26",
    "Description": "string",
    "PayLineTag": "string",
    "Code": "string",
    "Value": "123.99",
    "TaxableAmount": "123.99",
    "AccountingMethod": "P11D",
    "IsAdjustment": "true",
    "TaxableVehicle": "123.99",
    "TaxableFuel": "123.99",
    "VehicleRegistration": "string",
    "CashEquivalentVehicle": "123.99",
    "CashEquivalentFuel": "123.99",
    "DateRegistered": "2021-09-26",
    "FuelType": "NotSet",
    "ZeroEmissionsMileage": "123"
  }
}