SendNoteToPlant

Description

This method is used to generate a PDF document with the given information and associate it to the specified plant.

Request

ParameterTypeMandatory/OptionalMaximum character length/limitDescription
plantIdlongMandatory

Not Relevant

Id of the plant to which the note should be associated
jobDescriptionstringMandatory

Should be less than or equal to 500 characters

A brief description about the job
jobStartDateDateTimeMandatory 

Not Relevant

Start date of the job
jobEndDateDateTimeMandatory

Not Relevant

End date of the job
fileNamestringOptional

Not Relevant

Name of the generated file. Default name is 'Melding om utført arbeid ' *
orderNumberstringOptional

Not Relevant

The job order number the document is associated with
showInBoligmappa booleanMandatory

Not Relevant

Set the visibility of this document in boligmappa.no. Default is false 
propertyOwnerEmailstringOptional

Not Relevant

A notification is sent to the given email address when a document is uploaded to the property
applicationNamestringMandatoryShould be less than or equal to 10 characters

The name of the integration partner


Note:

You can either use the default file name “Melding om utført arbeid” or set a preferred file name in your application.  

Request - input sample

<SendNoteToPlant>
  <MethodParameters>
    <UserAuthentication>
      <UserName>username</UserName>
      <Password>password</Password>
      <AnyAttr attr0="XmlAttributeArray" isNull="false">
        <XmlAttributeArray0>System.Xml.XmlAttribute</XmlAttributeArray0>
      </AnyAttr>
    </UserAuthentication>
    <plantId>6820</plantId>
    <jobDescription>Send note</jobDescription>
    <jobStartDate>11/16/2017 11:30:28 AM</jobStartDate>
    <jobEndDate>11/16/2017 11:30:28 AM</jobEndDate>
    <fileName isNull="false" />
    <orderNumber isNull="false" />
    <showInBoligmappa>True</showInBoligmappa>
    <propertyOwnerEmail isNull="false" />
    <applicationName>test</applicationName>
  </MethodParameters>
</SendNoteToPlant>

Response

TypeDescription
NoteNote created


Response - output sample

  <SendNoteToPlant>
  <MethodParameters>
    <Note>
      <BoligmappaDocId>57487</BoligmappaDocId>
      <Url>http://172.20.1.183:8080/Document/DownloadDocumentWebService/DownloadDocWithSessionKey?sessionKey=rl%2fL3WDK6Fs%2bCIaABAaVXwm6knB2nVySYMOnChm4HzP2lcmkQA%2bPM6nCXiQKa9ZS</Url>
      <FileName>Melding om utført arbeid</FileName>
    </Note>
  </MethodParameters>
</SendNoteToPlant>

Exceptions

Error CodeDescription
111plantId does not exist for your company or your license does not authorize you to access this plantId
113One or more mandatory fields have not been provided 
123An exception occurred while processing your request
138applicationName length has exceeded the maximum character limit allowed (10)
146The applicationName is not set
161Job description length has exceeded the maximum character limit allowed (500)
167You are not authorized to use this web method
175The jobEndDate needs to be later than the jobStartDate
217An error occurred while sending the notification mail to the user
218The propertyOwnerEmail provided is invalid