Sign in

v1

latestOpenAPI 3.0.32026-08-0645108163.2 KB
Company

Update the editable fields of an existing company

Updates the editable fields of a company. This is a partial update: only the fields present in the request are changed; omitted fields are left untouched.

Identity fields (chamber of commerce number, VAT number and statutory name) are sourced from the chamber of commerce and cannot be updated through this endpoint.

Updated provisions take effect from the moment of the update onwards: they are applied to new orders and placements created after this call. Existing orders and placements keep the provisions that were in effect when they were created and are not updated retroactively.

post/public/company/v1/update-company

Request body

companyIdstring uuid required
tradeNamestring

The trade name (handelsnaam / display name) of the company. Not the statutory name.

ibanstring

The IBAN of the company.

collectiveLabourAgreementNumberinteger

The unique number of the collective labour agreement, as returned from the /get-collective-labour-agreements endpoint. Note: the CLA can only be changed while the company is not yet active and has no orders on its current CLA.

Example request

{
  "iban": "NL24RABO0648620387",
  "provisions": {
    "fixedCostPriceFactor": 1.95,
    "percentage": 18.2,
    "minimumAmount": 18.21
  }
}

Response

Successfully updated the company. Returns the full, current company data.

companyIdstring uuid required
chamberOfCommerceNumberstring required

Read-only. Sourced from the chamber of commerce and cannot be updated.

vatNumberstring

Read-only. Sourced from the chamber of commerce and cannot be updated.

statutoryNamestring

Read-only. The statutory (legal) name, sourced from the chamber of commerce and cannot be updated.

tradeNamestring required

The trade name (handelsnaam / display name) of the company.

collectiveLabourAgreementNumberinteger

The unique number of the collective labour agreement currently applied to the company.

ibanstring

Example response

{
  "chamberOfCommerceNumber": "69831955",
  "vatNumber": "NL290284636B95",
  "iban": "NL24RABO0648620387",
  "provisions": {
    "fixedCostPriceFactor": 1.95,
    "percentage": 18.2,
    "minimumAmount": 18.21
  }
}