> ## Documentation Index
> Fetch the complete documentation index at: https://www.bloxs.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Update an initial cost for concept commercial rent contract
> Update an initial cost for concept commercial rent contract.
## OpenAPI
````json PUT /api/v1/contracts/conceptcommercialrent/initialcosts
{
"openapi": "3.0.4",
"info": {
"title": "Concept SalesContracts V1",
"description": "Welcome to BETA version of the new Sales Concept Contracts API - intended for client public testing before the launch of the final version. During this BETA phase, we'll be improving the API based on specific client's feedbacks.",
"version": "v1"
},
"security": [
{}
],
"tags": [
{
"name": "CommercialRentContracts"
},
{
"name": "Concept CommercialRent"
},
{
"name": "Concept PrivateRent"
},
{
"name": "GeneralSalesContracts"
},
{
"name": "Metadata"
},
{
"name": "PrivateRentContracts"
},
{
"name": "SupplierContracts"
}
],
"paths": {
"/api/v1/contracts/conceptcommercialrent/initialcosts": {
"put": {
"tags": [
"Concept CommercialRent"
],
"summary": "Update an initial cost for concept commercial rent contract",
"description": "Update an initial cost for concept commercial rent contract.",
"operationId": "UpdateInitialCostForConceptCommercialRentContracts",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ContractInitialCostUpdateModel"
}
}
}
},
"responses": {
"200": {
"description": "An initial cost for concept commercial rent contract was updated",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ContractInitialCostModel"
}
}
}
},
"400": {
"description": "The initial cost data for concept commercial rent contract data has validation issues",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorMessageModel"
}
}
}
}
},
"x-d360-narrative-url": "Update an initial cost for concept commercial rent contract
This endpoint updates an existing initial cost on a concept commercial lease contract.
The initial cost to update is identified by the combination of the contract, the linked real estate object and the item name, so a caller can adjust the amount of a one-off cost such as a key deposit or nameplates already registered on the draft contract.
Request Fields
Field | Type | Required | Description |
|---|
contractExternalIdentifier | string | Yes | The identifier assigned to the contract by the calling system. This identifier is not generated by Bloxs. Minimum length 1. |
objectReference | string | Yes | The reference of the real estate object linked to the initial cost to update. Must match a reference already registered as a real estate object on this contract. Minimum length 1. |
initialCostsItemName | string | Yes | The name of the initial cost item to update, for example a key deposit or nameplates. Maximum length 256 characters. |
amountExcl | number (double) | Yes | The updated amount of the initial cost, excluding VAT. Decimals use a period as separator. |
Response Fields
Field | Type | Required | Description |
|---|
contractExternalIdentifier | string | Yes | The identifier assigned to the contract by the calling system. Minimum length 1. |
objectReference | string | No | The reference of the real estate object linked to the initial cost. |
initialCostsItemName | string | Yes | The name of the initial cost item. Maximum length 256 characters. |
amountExcl | number (double) | No | Amount of the initial cost, excluding VAT. Decimals use a period as separator. |
amountVAT | number (double) | No | VAT amount of the initial cost. Decimals use a period as separator. |
amountIncl | number (double) | No | Amount of the initial cost, including VAT. Decimals use a period as separator. |