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. Even though this is an optional field, it is required to provide this when the PropertyPlant is a housing cooperative share.

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
)
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<

PropertyPlant

Plant>

List
of PropertyPlants
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

120121Lnr is not provided with the input matrikkel. But given is a housing corporative share 122 

Lnr is provided with the input matrikkel. But given is not a housing corporative share 

Provided Lnr is not valid 
123An exception
occured
occurred while processing your
request 131This type of property is not supported 
request 
138
ApplicationName
applicationName length
is
has exceeded the maximum
allowed
character limit allowed (10)
146The
application name is not set
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 222Invalid matrikkel

share.