Contents x
    [PREVIEW] Update an initial cost for concept commercial rent contract
    • 24 Dec 2024
    • 2 Minutes to read
    • Print
    • Dark
      Light
    Contents

    [PREVIEW] Update an initial cost for concept commercial rent contract

    • Updated on 24 Dec 2024
    • 2 Minutes to read
    • Print
    • Dark
      Light
    Article summary

    Put
    /api/v1/contracts/conceptcommercialrent/initialcosts

    [PREVIEW] Update an initial cost for concept commercial rent contract.

    Description

    Update the list with initial costs currently known in the Bloxs database for concept commercial rent contracts. This refers to the initial contract costs (e.g., nameplates for an apartment complex or keys).

    Either ObjectReference or ContractExternalIdentifier must have a value. Please note that if both identifiers are given, both must match; otherwise, an error message will be generated. It is recommended that the user utilizes only one identifier, with a preference for the ObjectReference.

    Commercial rent contracts pertains to contracts concerning stores, offices, and commercial spaces (commercial real estate). It is generated for each prospect, with the remaining details to be filled in in the Bloxs application. The draft contract can (optionally) be signed digitally. Once signed, the first invoice can be issued immediately. Please note that the concept contract is not a template; it is a draft with only one mandatory field.

    Use Case

    This operation enables the user to update a list of initial costs currently recorded in the Bloxs database. For instance, the user can add a new initial cost to the list.

    FieldDescription
    contractExternalIdentifierThe unique identifier for the contract within the system of the requesting party. This identifier is not generated by the Bloxs system.
    ObjectReferenceThe reference of the existing object that should be linked to this contract line. The reference should be identical to the reference such as registered in the Bloxs application. Only real estate object references that have also been entered as 'RealEstateObjects' for this specific contract can be used here.
    InitialCostItemName
    		The description (name) of the initial cost component (e.g., key deposit, nameplates).
    amountExclAmount of the invoice line item, excluding VAT. Decimals are separated with a period (.)

    Response fields

    The response contains the fields in the request with the aditional fields belowtable below. 

    FieldDescription
    amountVATVAT amount of the invoice line item. Decimals are separated with a period (.)
    amountInclAmount of the invoice line item, including VAT. Decimals are separated with a period (.)
    Security
    HTTP
    Type Bearer

    Please enter a valid token

    Body parameters
    object
    contractExternalIdentifier
    string Required
    Min length1
    objectReference
    string Required
    Min length1
    initialCostsItemName
    string Required
    Min length0
    Max length256
    amountExcl
    number (double) Required
    Responses
    200

    An initial cost for concept commercial rent contract was updated

    object
    contractExternalIdentifier
    string
    Min length1
    objectReference
    string | null
    initialCostsItemName
    string
    Min length0
    Max length256
    amountExcl
    number (double)
    amountVAT
    number (double)
    amountIncl
    number (double)
    400

    The initial cost data for concept commercial rent contract data has validation issues

    Expand All
    object
    type
    string | null
    title
    string | null
    traceId
    string | null
    status
    integer (int32)
    errors
    object | null
    property*
    Array of string | null additionalProperties
    string
    What's Next