Please enable JavaScript to view this site.

Navigation: Schema: FiscalCompanyCar > Tables

FiscalCompanyCarsByEmploymentId

List of fiscal company cars for an employment__Activity name:__ GetFiscalCompanyCarsByEmploymentIdGet the list of fiscal company cars for an employment. Please note this resource is related for the registration of the company car for tax purposes. This is NOT directly related to the registration of the company car(s) related to the HRM-module 'Verstrekking'

Catalog: LoketNlRest

Schema: FiscalCompanyCar

Retrieve: true

Insert: true

Update: false

Delete: false

Select loket.nl (REST) API URL: /providers/employers/employees/employments/{employmentId}/fiscalcompanycars

Insert loket.nl (REST) API URL: /providers/employers/employees/employments/{employmentId}/fiscalcompanycars

Update loket.nl (REST) API URL: /providers/employers/employees/employments/{employmentId}/fiscalcompanycars

Delete loket.nl (REST) API URL: /providers/employers/employees/employments/{employmentId}/fiscalcompanycars

Field Selection Method: NotRequired

Base Path: _embedded[*]

Select loket.nl (REST) API Operation: get /providers/employers/employees/employments/{employmentId}/fiscalcompanycars

Insert loket.nl (REST) API Operation: post /providers/employers/employees/employments/{employmentId}/fiscalcompanycars

Table Function Parameters

The following parameters can be used to control the behaviour of the table function FiscalCompanyCarsByEmploymentId. A value must be provided at all times for required parameters, but optional parameters in general do not need to have a value and the execution will default to a pre-defined behaviour. Values can be specified by position and by name. In both cases, all parameters not specified will be treated using their default values.

Value specification by position is done by listing all values from the first to the last needed value. For example with `select * from table(value1, value2, value3)` on a table with four parameters will use the default value for the fourth parameter and the specified values for the first three.

Value specification by name is done by listing all values that require a value. For example with `select * from table(name1 => value1, name3 => value3)` on the same table will use the default values for the second and fourth parameters and the specified values for the first and third.

Name

Data Type

Required

Default Value

Documentation

employmentId

guid

 

The unique identifier of the employment

 

Table Function Columns

The columns of the table function FiscalCompanyCarsByEmploymentId are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert.

Name

Data Type

Label

Required

Documentation

additionalTaxLiabilityGroup_key

int32

 

 

additionalTaxLiabilityGroup_value

string(100)

 

 

dateOfFirstAdmission

datetime

 

First day of admission for the vehicle (datum eerste toelating). It is possible to acquire a value for this field based on the RDW-registration by calling that supplementary endpoint.

deviatingAdditionalTaxLiability

double

 

Normally Loket will calculate the applicable tax liability based on the value and tax liability group of the car. However this field may OVERRIDE any other values, and in that case this amount will be applied as the applicable tax liability amount.

endDate

datetime

 

The end date of the entity. The date is up to and including.

id

guid

 

The unique identifier of an object (GUID/UUID)

licensePlateNumber

string(15)

 

Vehicle registration number (license plate) of the fiscal company car. The number should be provided with or without any hyphens (-).

reasonForNoAdditionalTaxLiability_key

int32

 

 

reasonForNoAdditionalTaxLiability_value

string(50)

 

 

startDate

datetime

 

The start date of the entity.A (broken chain)[./#section/Data/Date-chains] is maintained within this resource.

taxableBenefitForPrivateUse

double

 

Taxable benefit for private use (eigen bijdrage van de werknemer) may be entered here, this will lower the tax liability to be paid in the payrolling process.

valueForTaxPurposes

double

 

The value of the car for tax purposes. This field may only be NULL if a reason for no additional tax liability (reden voor geen bijtelling) is provided.It is possible to acquire a value for this field based on the RDW-registration by calling that supplementary endpoint.

 

25-05-2022 14:15 Version 22.1.46-BETA+3385