AddRoom

Description

This method is used to create rooms for a given property. It returns the id of the created room. 

Note

  • Rooms can only be created for properties. Not for buildings
  • A user can only create rooms for properties with a plant 

Request

ParameterTypeMandatory/OptionalMaximum character length/limitDescription
plantIdlongMandatoryNot relevant

Id of the plant which connects the particular property and company. Here the property is the one to which the room is added

roomTypeIdintMandatory Not relevantType of room to be added. All room types are listed in the Room model.
roomNamestring Mandatory Should be less than or equal to 50 characters

Name of the room added

applictionName string Mandatory Should be less than or equal to 10 characters

The name of the integration partner


Request - sample input

<AddRoom>
  <MethodParameters>
    <UserAuthentication>
      <UserName>username</UserName>
      <Password>password</Password>
      <AnyAttr attr0="XmlAttributeArray" isNull="false">
        <XmlAttributeArray0>System.Xml.XmlAttribute</XmlAttributeArray0>
      </AnyAttr>
    </UserAuthentication>
    <plantId>6731</plantId>
    <roomTypeId>2</roomTypeId>
    <roomName>Bedroom</roomName>
    <applicationName>test</applicationName>
  </MethodParameters>
</AddRoom>


Response

PropertyTypeDescription
roomIdlong Id of the room added 


Request - sample output

<AddRoom>
  <MethodParameters>
    <Int64>40641</Int64>
  </MethodParameters>
</AddRoom>

Exceptions

Error CodeDescription
123 

An exception occurred while processing your request  

132

plantId does not exist

138 

applicationName length has exceeded the maximum character limit allowed (10) 

146 

The applicationName is not set

152 

No property is connected to the given plantId

157

plantId is required

167You are not authorized to use this method
281

Room already exists

283

roomName is not provided

284

You are not authorized to add a room to this property or your license does not authorize you to access this property

286Invalid roomType
296Do not insert a comma in the roomName
301Room description length has exceeded the maximum character limit allowed (250)