Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Description

CreateBuildingPlant web This method is used to create a plant for a building by providing the building information and Matrikkel.

Notes:

 

 

Request

ParameterTypeMandatory/Optional
Comments
Maximum character length/limitDescription
buildingBuildingInputMandatory
Building number
Not RelevantBuildingNumber and iteration (løpenr).
Building number
BuildingNumber is mandatory
. Iteration can be zero
.
matrikkel
MatrikkelMatrikkelMandatory
Optional
Not RelevantMatrikkel of the building.
Must be provided when trying to create a plant for a building which is not yet registered in Boligmappa systemplantNamestringOptionalPreferred name for the plant. If not provided default plant name (BuildingNumber / Iteration) will be setcustomerName
applicationNamestringMandatory
Name of customer for the plant. (Length of the CustomerName must
Should be less than or equal to
100)applicationNamestringMandatoryName of customer for the plant. (Length of the CustomerName must be less than or equal to 100)

 

Response

PropertyTypeDescriptionPlant
10 charactersThe name of the integration partner

Request - input sample

Image Added


NOTE: The building iteration (løpenr) will be obsolete in the future. 

Response

The CreateBuildingPlant method creates the plant in the system, and returns the following properties for the created plant.

TypeDescription
BuildingPlantBuilding and plant
info
information associated with the newly created plant

 

Response - output sample

Image Added

Exceptions

Error CodeDescription
105The Plant already exists in the system
123An exception occurred while processing your request
138applicationName length has exceeded the maximum character limit allowed (10) 
146The applicationName is not set
167You are not authorized to use this web method
187BuildingNumber is not provided
188Matrikkel is not provided
189No buildings are connected to the given Matrikkel and BuildingNumber
200The given BuildingNumber is not connected to the given Matrikkel. Please check your input.
280There are no buildings available for the given BuildingNumber, Matrikkel and Iteration