--- title: "Edit the details of a fiscal company car record" method: PUT path: "/v2/providers/employers/employees/employments/fiscalcompanycars/{fiscalCompanyCarId}" tags: ["Fiscal company car"] --- # Edit the details of a fiscal company car record `PUT /v2/providers/employers/employees/employments/fiscalcompanycars/{fiscalCompanyCarId}` ## Request - Base URL: `https://api.loket.nl` - URL: `https://api.loket.nl/v2/providers/employers/employees/employments/fiscalcompanycars/{fiscalCompanyCarId}` - Auth: none required __Activity name:__ PutFiscalCompanyCarByFiscalCompanyCarId Edit the details for a fiscal company car record. 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 __Metadata :__ Possible options for fields of the type 'metadata' can be acquired (GET) by adding `/metadata` to the PUT URL. ## Path parameters - `fiscalCompanyCarId` string, uuid, required ## Headers - `Authorization` string, required - `Accept` string, required ## Request body - FiscalCompanyCar112027, nullable - `id` string, uuid: The unique identifier of an object (GUID/UUID) - `startDate` string, date: The start date of the entity. A (broken chain)[./#section/Data/Date-chains] is maintained within this resource. - `endDate` string, date, nullable: The end date of the entity. The date is up to and including. - `licensePlateNumber` string, nullable: Vehicle registration number (license plate) of the fiscal company car. The number should be provided with or without any hyphens (-). - `dateOfFirstAdmission` string, 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. - `valueForTaxPurposes` number, 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. - `additionalTaxLiabilityGroup` object: Indication for what additional tax liability percentage (bijtelling) should be used for calculating the tax liabiltiy in the payroll process. It is possible to acquire a value for this field based on the RDW-registration of the vehicle registration number (license plate) by calling that supplementary endpoint. - `key` integer - `value` string - `reasonForNoAdditionalTaxLiability` object, nullable: In case the employment does have a fiscal company car but no additional tax liability should be applied, then the reason should be provided for the payroll tax return. - `key` integer - `value` string - `deviatingAdditionalTaxLiability` number, 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. - `taxableBenefitForPrivateUse` number, 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. - `fossilFuel` boolean: Indicates whether the fiscal company car uses fossil fuel. ## Response `200` OK - object: a warning indacateds that the given payload is valide, however take notice of the warning this might ifluence behavour. - `version` Version - `obsoleteDate` string, date, nullable: The date (can be null) on which the `resourceVersion` is no longer supported/available - `resourceVersion` string, date: The resource version of the object in the response - `messages` object[] - `type` string: Indication of the type of message. See [the general documentation for more information](./#section/Response/Messages) - `description` string: Describes the message - `id` string, uuid, nullable: In some cases when the message may relate to a specific entity, or specific group of entities, this field provides the identifier of that entity - `code` integer: Identifying code for the message - `properties` string[]: An array that can contain additional information - `content` FiscalCompanyCar112027, nullable - `id` string, uuid: The unique identifier of an object (GUID/UUID) - `startDate` string, date: The start date of the entity. A (broken chain)[./#section/Data/Date-chains] is maintained within this resource. - `endDate` string, date, nullable: The end date of the entity. The date is up to and including. - `licensePlateNumber` string, nullable: Vehicle registration number (license plate) of the fiscal company car. The number should be provided with or without any hyphens (-). - `dateOfFirstAdmission` string, 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. - `valueForTaxPurposes` number, 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. - `additionalTaxLiabilityGroup` object: Indication for what additional tax liability percentage (bijtelling) should be used for calculating the tax liabiltiy in the payroll process. It is possible to acquire a value for this field based on the RDW-registration of the vehicle registration number (license plate) by calling that supplementary endpoint. - `key` integer - `value` string - `reasonForNoAdditionalTaxLiability` object, nullable: In case the employment does have a fiscal company car but no additional tax liability should be applied, then the reason should be provided for the payroll tax return. - `key` integer - `value` string - `deviatingAdditionalTaxLiability` number, 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. - `taxableBenefitForPrivateUse` number, 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. - `fossilFuel` boolean: Indicates whether the fiscal company car uses fossil fuel. ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `404`: Not Found - `409`: Conflict - `500`: Internal Server Error ## Changes - **2026-09-07** `d6f5bd87bd9d`: 2 info - added the media type `application/json;version=2027-01-01` to the request body - added the media type `application/json;version=2027-01-01` for the response with the status `200` [Operation history](https://skmtc.dev/loket/apis/loket-api/changes/v2/providers/employers/employees/employments/fiscalcompanycars/:fiscalCompanyCarId/put.md) --- [API](https://skmtc.dev/loket/apis/loket-api.md) - [All operations](https://skmtc.dev/loket/apis/loket-api/llms.txt) - [OpenAPI document](https://skmtc.dev/loket/apis/loket-api/revisions/32170564148f?raw)