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-10-19</StartDate>
  <EndDate>2021-10-19</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-10-19</DateRegistered>
  <FuelType>NotSet</FuelType>
  <ZeroEmissionsMileage>123</ZeroEmissionsMileage>
</CarBenefitYtdPayInstruction>

{
  "CarBenefitYtdPayInstruction": {
    "StartDate": "2021-10-19",
    "EndDate": "2021-10-19",
    "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-10-19",
    "FuelType": "NotSet",
    "ZeroEmissionsMileage": "123"
  }
}