LookupPropertyByMatrikkel

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/OptionalMaximum character length/limitDescription
MatrikkelintMandatoryNot RelevantMatrikkel values of the plant
shareNumberint Mandatory/OptionalNot Relevant

The number uniquely identifying a particular share of a housing cooperative. This is not part of the Matrikkel

unitNumber string Mandatory/OptionalNot RelevantUnit number of the property/apartment 
applicationNamestring MandatoryShould be less than or equal to 10 charactersThe 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

 

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 Boligmappa, the boligmappaNumber is set to "Null".

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 Snr provided is invalid
118Snr is not provided with the input Matrikkel for a sectioned property
119

Snr is provided with the input Matrikkel for a non-sectioned property

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
188 Matrikkel is not provided 
221

Both the shareNumber and unitNumber are not provided with the input Matrikkel even though it is a housing corporative share.