Add a contract line with the amount for concept commercial rent contracts

Prev Next
Post
/api/v1/contracts/conceptcommercialrent/contractlines

Add a contract line with the amount for concept commercial rent contracts.

Add a contract line for concept commercial rent contracts

This endpoint adds a new contract line to an existing concept commercial lease contract.

A contract line represents an individual term of the agreement, such as rent, furniture or a rent discount, expressed as an amount excluding VAT.

A developer calls this endpoint after the draft contract exists, to build up its theoretical rent line by line before the contract is signed.


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 contract line. Must match a reference already registered as a real estate object on this contract. Minimum length 1.

lineItemName

string

Yes

The name of the contract line item, for example rent, furniture or a discount. Maximum length 256 characters.

description

string

No

Free-text description of the contract line, printed on the invoice.

amountExcl

number (double)

Yes

Amount of the contract line, excluding VAT. Decimals use a period as separator.

startDate

string (date)

No

Start date of the contract line. ISO 8601 date format.

endDate

string (date)

No

End date of the contract line. ISO 8601 date format.


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 contract line.

lineItemName

string

Yes

The name of the contract line item. Maximum length 256 characters.

description

string

No

Free-text description of the contract line, printed on the invoice. Maximum length 512 characters.

amountExcl

number (double)

No

Amount of the contract line, excluding VAT. Decimals use a period as separator.

amountVAT

number (double)

No

VAT amount of the contract line. Decimals use a period as separator.

amountIncl

number (double)

No

Amount of the contract line, including VAT. Decimals use a period as separator.

startDate

string (date)

No

Start date of the contract line. ISO 8601 date format.

endDate

string (date)

No

End date of the contract line. ISO 8601 date format.

Security
Body parameters
object
contractExternalIdentifier
string Required
Min length1
objectReference
string Required
Min length1
lineItemName
string Required
Min length0
Max length256
description
string | null
amountExcl
number (double) Required
startDate
string (date) | null
endDate
string (date) | null
Responses
200

OK

object
contractExternalIdentifier
string
Min length1
objectReference
string | null
lineItemName
string
Min length0
Max length256
description
string | null
Min length0
Max length512
amountExcl
number (double)
amountVAT
number (double)
amountIncl
number (double)
startDate
string (date) | null
endDate
string (date) | null