Versions Compared

Key

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

Description 

...

Description 

This method is used to return a list of the PropertyPlant details which consists of the address, Matrikkel, basic building details and property owners. The property information is retrieved from Infoland service and combined with details like the boligmappaNumber if the property is already registered in Boligmappa.

Request

ParameterTypeMandatory/Optional
Comments
Maximum character length/limitDescription
MatrikkelintMandatoryNot RelevantMatrikkel values of the plant
shareNumberint 
Optional 
Mandatory/OptionalNot Relevant

The number uniquely identifying a particular share of a housing cooperative

and this

. This is not

a

part of the

matrikkel.

Matrikkel

unitNumber string 
Optional 
Mandatory/OptionalNot RelevantUnit number of the property/apartment 
applicationName
int
string 
OptionalUnique identifier (of your choice) to identify the client application which consumes the Boligmappa API. (length
MandatoryShould be less than or equal to 10 characters
)
Note : 

...

The name of the integration partner

NOTE: It is mandatory to provide either the shareNumber or the unitNumber optional fields when the PropertyPlant is a housing cooperative share.

Request - input sample

<LookupPropertyByMatrikkel>
  <MethodParameters>
    <UserAuthentication>
      <UserName>username</UserName>
      <Password>password</Password>
      <AnyAttr attr0="XmlAttributeArray" isNull="false">
        <XmlAttributeArray0>System.Xml.XmlAttribute</XmlAttributeArray0>
      </AnyAttr>
    </UserAuthentication>
    <matrikkel>
      <Knr>418</Knr>
      <Gnr>33</Gnr>
      <Bnr>16</Bnr>
      <Fnr>0</Fnr>
      <Snr>0</Snr>
    </matrikkel>
    <shareNumber>0</shareNumber>
    <unitNumber isNull="false" />
    <applicationName>test</applicationName>
  </MethodParameters>
</LookupPropertyByMatrikkel>


Response

TypeDescription

List<Plant>

List of Plants

 

Notes:

...

NOTE:

  • It is mandatory to provide either the shareNumber or the unitNumber optional fields when the PropertyPlant is a housing cooperative share.
  • If the property is not registered in the Boligmappa, results will be served from the Infoland service. Boligmappa Number the boligmappaNumber is set to "Null" in this case.".

Response- output sample

<LookupPropertyByMatrikkel>
  <MethodParameters>
    <PlantArray>
      <PlantArray0 actualtype="BuildingPlant" basetype="Plant">
        <BuildingId>6380</BuildingId>
        <BoligmappaNumber>KAG3807</BoligmappaNumber>
        <BuildingNumber>7268165</BuildingNumber>
        <Iteration>0</Iteration>
        <BuildingTypeCode>241</BuildingTypeCode>
        <BuildingType>HUS FOR DYR/LANDBR.LAGER/SILO</BuildingType>
        <BuildingStatus>TATT I BRUK</BuildingStatus>
        <Matrikkel>
          <Knr>418</Knr>
          <Gnr>33</Gnr>
          <Bnr>16</Bnr>
          <Fnr>0</Fnr>
          <Snr>0</Snr>
        </Matrikkel>
        <FloorCount>1</FloorCount>
        <PropertyCount>0</PropertyCount>
        <TotalBuildingArea>180.0</TotalBuildingArea>
        <UtilizedBuildingArea>0.0</UtilizedBuildingArea>
        <UsedFrom>1985</UsedFrom>
        <Properties isNull="true" />
        <PlantId>6637</PlantId>
        <PlantName>Nord-Odalsvegen, 2120 SAGSTUA - 7268165</PlantName>
        <CreatedTime>5/25/2017 3:16:25 PM</CreatedTime>
      </PlantArray0>
      <PlantArray1 actualtype="BuildingPlant" basetype="Plant">
        <BuildingId>6379</BuildingId>
        <BoligmappaNumber>KAG3791</BoligmappaNumber>
        <BuildingNumber>117717887</BuildingNumber>
        <Iteration>0</Iteration>
        <BuildingTypeCode>111</BuildingTypeCode>
        <BuildingType>ENEBOLIG</BuildingType>
        <BuildingStatus>TATT I BRUK</BuildingStatus>
        <Matrikkel>
          <Knr>418</Knr>
          <Gnr>33</Gnr>
          <Bnr>16</Bnr>
          <Fnr>0</Fnr>
          <Snr>0</Snr>
        </Matrikkel>
        <FloorCount>3</FloorCount>
        <PropertyCount>1</PropertyCount>
        <TotalBuildingArea>386.0</TotalBuildingArea>
        <UtilizedBuildingArea>386.0</UtilizedBuildingArea>
        <UsedFrom>0</UsedFrom>
        <Properties attr0="PropertyPlantArray" isNull="false">
          <PropertyPlantArray0>
            <PropertyCategory>R</PropertyCategory>
            <Matrikkel>
              <Knr>418</Knr>
              <Gnr>33</Gnr>
              <Bnr>16</Bnr>
              <Fnr>0</Fnr>
              <Snr>0</Snr>
            </Matrikkel>
            <ShareNumber>0</ShareNumber>
            <StreetAddress>Nord-Odalsvegen 2022, 2120 SAGSTUA</StreetAddress>
            <Address>
              <StreetName>Nord-Odalsvegen</StreetName>
              <HouseNumber>2022</HouseNumber>
              <HouseLetter isNull="true" />
              <ZipCode>2120</ZipCode>
              <City>SAGSTUA</City>
            </Address>
            <BoligmappaNumber>AAF5109</BoligmappaNumber>
            <UnitNumber>H0101</UnitNumber>
            <PropertyType>ENEBOLIG</PropertyType>
            <Latitude>60.4084203627843</Latitude>
            <Longitude>11.5159601888557</Longitude>
            <MainBuildingNumber>117717887</MainBuildingNumber>
            <MainBuildingIteration>0</MainBuildingIteration>
            <PropertyOwners attr0="PropertyOwnerArray" isNull="false">
              <PropertyOwnerArray0>
                <FirstName>Arne</FirstName>
                <LastName>Dagfinrud</LastName>
                <DefaultAddress>Nord-Odalsvegen 2022, 2120 SAGSTUA</DefaultAddress>
                <OrganizationNumber>0</OrganizationNumber>
              </PropertyOwnerArray0>
            </PropertyOwners>
            <PlantId>6799</PlantId>
            <PlantName>Nord-Odalsvegen 2022, 2120 SAGSTUA</PlantName>
            <CreatedTime>8/15/2017 4:45:20 PM</CreatedTime>
          </PropertyPlantArray0>
        </Properties>
        <PlantId>6636</PlantId>
        <PlantName>Nord-Odalsvegen, 2120 SAGSTUA - 117717887</PlantName>
        <CreatedTime>5/25/2017 3:16:21 PM</CreatedTime>
      </PlantArray1>
      <PlantArray2 actualtype="BuildingPlant" basetype="Plant">
        <BuildingId>6382</BuildingId>
        <BoligmappaNumber>KAG3821</BoligmappaNumber>
        <BuildingNumber>140147532</BuildingNumber>
        <Iteration>0</Iteration>
        <BuildingTypeCode>249</BuildingTypeCode>
        <BuildingType>ANNEN LANDBRUKSBYGNING</BuildingType>
        <BuildingStatus>TATT I BRUK</BuildingStatus>
        <Matrikkel>
          <Knr>418</Knr>
          <Gnr>33</Gnr>
          <Bnr>16</Bnr>
          <Fnr>0</Fnr>
          <Snr>0</Snr>
        </Matrikkel>
        <FloorCount>0</FloorCount>
        <PropertyCount>0</PropertyCount>
        <TotalBuildingArea>0.0</TotalBuildingArea>
        <UtilizedBuildingArea>0.0</UtilizedBuildingArea>
        <UsedFrom>0</UsedFrom>
        <Properties isNull="true" />
        <PlantId>6639</PlantId>
        <PlantName>Nord-Odalsvegen, 2120 SAGSTUA - 140147532</PlantName>
        <CreatedTime>5/25/2017 3:16:32 PM</CreatedTime>
      </PlantArray2>
      <PlantArray3 actualtype="BuildingPlant" basetype="Plant">
        <BuildingId>6381</BuildingId>
        <BoligmappaNumber>KAG3814</BoligmappaNumber>
        <BuildingNumber>300283686</BuildingNumber>
        <Iteration>0</Iteration>
        <BuildingTypeCode>181</BuildingTypeCode>
        <BuildingType>GARASJEUTHUS ANNEKS TIL BOLIG</BuildingType>
        <BuildingStatus>TATT I BRUK</BuildingStatus>
        <Matrikkel>
          <Knr>418</Knr>
          <Gnr>33</Gnr>
          <Bnr>16</Bnr>
          <Fnr>0</Fnr>
          <Snr>0</Snr>
        </Matrikkel>
        <FloorCount>1</FloorCount>
        <PropertyCount>0</PropertyCount>
        <TotalBuildingArea>35.0</TotalBuildingArea>
        <UtilizedBuildingArea>0.0</UtilizedBuildingArea>
        <UsedFrom>2017</UsedFrom>
        <Properties attr0="PropertyPlantArray" isNull="false">
          <PropertyPlantArray0>
            <PropertyCategory>R</PropertyCategory>
            <Matrikkel>
              <Knr>418</Knr>
              <Gnr>33</Gnr>
              <Bnr>16</Bnr>
              <Fnr>0</Fnr>
              <Snr>0</Snr>
            </Matrikkel>
            <ShareNumber>0</ShareNumber>
            <StreetAddress>Nord-Odalsvegen 2022, 2120 SAGSTUA</StreetAddress>
            <Address>
              <StreetName>Nord-Odalsvegen</StreetName>
              <HouseNumber>2022</HouseNumber>
              <HouseLetter isNull="true" />
              <ZipCode>2120</ZipCode>
              <City>SAGSTUA</City>
            </Address>
            <BoligmappaNumber>AAF2696</BoligmappaNumber>
            <UnitNumber isNull="true" />
            <PropertyType>GARASJEUTHUS ANNEKS TIL BOLIG</PropertyType>
            <Latitude>60.4084203627843</Latitude>
            <Longitude>11.5159601888557</Longitude>
            <MainBuildingNumber>300283686</MainBuildingNumber>
            <MainBuildingIteration>0</MainBuildingIteration>
            <PropertyOwners attr0="PropertyOwnerArray" isNull="false">
              <PropertyOwnerArray0>
                <FirstName>Arne</FirstName>
                <LastName>Dagfinrud</LastName>
                <DefaultAddress>Nord-Odalsvegen 2022, 2120 SAGSTUA</DefaultAddress>
                <OrganizationNumber>0</OrganizationNumber>
              </PropertyOwnerArray0>
            </PropertyOwners>
            <PlantId>6638</PlantId>
            <PlantName>Nord-Odalsvegen 2022, 2120 SAGSTUA</PlantName>
            <CreatedTime>5/25/2017 3:16:31 PM</CreatedTime>
          </PropertyPlantArray0>
        </Properties>
        <PlantId>0</PlantId>
        <PlantName isNull="true" />
        <CreatedTime isNull="true" />
      </PlantArray3>
    </PlantArray>
  </MethodParameters>
</LookupPropertyByMatrikkel>

Exceptions

Error CodeDescription
104Infoland is not available
109Given Matrikkel does not exist in the system
117 Provided Snr provided is not valid invalid
118Snr is not provided with the input matrikkel. But given is Matrikkel for a sectioned property
119

Snr is provided with the input matrikkel. But given is not a Matrikkel for a non-sectioned property

120Provided Lnr is not valid 
123An exception occured occurred while processing your request 
131This type of property is not supported 
request 
138ApplicationName applicationName length is has exceeded the maximum allowed character limit allowed (10)
146The application name is applicationName is not set
167You are not authorized to use this web method
188 Matrikkel is not provided 
221

Both Lnr the shareNumber and unit number unitNumber are not provided with the input matrikkel. But given Matrikkel even though it is a housing corporative share share.