LOloket
Fiscal company car

Create a fiscal company car record for an employment

Changed on

Activity name: <a href="https://developer.loket.nl/Activities/PostFiscalCompanyCarByEmploymentId" target="_blank">PostFiscalCompanyCarByEmploymentId</a><br> <br><br>Create a fiscal company cars record for an employment.<br><br>Please note this resource is related for the registration of the company car for tax purposes and will be included in the salary calculations. This is NOT directly related to the registration of the company car(s) related to the HRM-module Verstrekking<br><br>Metadata : Possible options for fields of the type 'metadata' can be acquired (GET) by adding /metadata to the POST URL.<br><br>Defaults : Default values for a new object can be acquired by adding `/defaults' to the POST URL.<br>

post/v2/providers/employers/employees/employments/{employmentId}/fiscalcompanycars

Request

  • Base URL
    https://api.loket.nl
  • URL
    https://api.loket.nl/v2/providers/employers/employees/employments/{employmentId}/fiscalcompanycars
  • Auth
    none required

Path parameters

employmentIdstring uuid required

The unique identifier of the employment

Headers

Authorizationstring required
Example:Bearer <TOKEN>

A valid Bearer token for authorizing the request.

Acceptstring required
Example:application/json;version=2018-01-01

The accept header is used to influence what type of output is returned and in most cases the version of the output

Request body

idstring uuid

The unique identifier of an object (GUID/UUID)

startDatestring date

The start date of the entity.

A (broken chain)[./#section/Data/Date-chains] is maintained within this resource.

endDatestring date nullable

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

licensePlateNumberstring nullable

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

dateOfFirstAdmissionstring date nullable

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.

valueForTaxPurposesnumber double nullable

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.

deviatingAdditionalTaxLiabilitynumber double nullable

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.

taxableBenefitForPrivateUsenumber double nullable

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.

fossilFuelboolean

Indicates whether the fiscal company car uses fossil fuel.

Example request

{
  "id": "b14acd0d-75d7-4fc8-8b22-4a3924585cab",
  "startDate": "2021-01-01",
  "endDate": "2023-10-23",
  "licensePlateNumber": "GP586D",
  "dateOfFirstAdmission": "2018-01-01",
  "valueForTaxPurposes": 20000,
  "additionalTaxLiabilityGroup": {
    "key": 1,
    "value": "Standaard tarief (25% tot 2017)"
  },
  "reasonForNoAdditionalTaxLiability": {
    "key": 1,
    "value": "(2) Werknemer heeft beschikking belastingdienst"
  },
  "deviatingAdditionalTaxLiability": 20000,
  "taxableBenefitForPrivateUse": 2000
}

Response

Created

Example response

{
  "version": {
    "resourceVersion": "2018-12-31"
  },
  "messages": [
    {
      "type": "Warning",
      "description": "<some warning>",
      "id": "904d6856-6034-4624-bcbc-886188c115c5",
      "code": 12
    }
  ],
  "content": {
    "id": "b14acd0d-75d7-4fc8-8b22-4a3924585cab",
    "startDate": "2021-01-01",
    "endDate": "2023-10-23",
    "licensePlateNumber": "GP586D",
    "dateOfFirstAdmission": "2018-01-01",
    "valueForTaxPurposes": 20000,
    "additionalTaxLiabilityGroup": {
      "key": 1,
      "value": "Standaard tarief (25% tot 2017)"
    },
    "reasonForNoAdditionalTaxLiability": {
      "key": 1,
      "value": "(2) Werknemer heeft beschikking belastingdienst"
    },
    "deviatingAdditionalTaxLiability": 20000,
    "taxableBenefitForPrivateUse": 2000
  }
}

Changes

  • d6f5bd87bd9dRevision changes
    • info

      added the media type application/json;version=2027-01-01 to the request body

    • info

      added the media type application/json;version=2027-01-01 for the response with the status