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
| Parameter | Type | Mandatory/Optional | Maximum character length/limit | Description |
|---|---|---|---|---|
| Matrikkel | int | Mandatory | Not Relevant | Matrikkel values of the plant |
| shareNumber | int | Mandatory/Optional | Not Relevant | The number uniquely identifying a particular share of a housing cooperative. This is not part of the Matrikkel |
| unitNumber | string | Mandatory/Optional | Not Relevant | Unit number of the property/apartment |
| applicationName | string | Mandatory | Should 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
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 Code | Description |
|---|---|
| 104 | Infoland is not available |
| 109 | Given Matrikkel does not exist in the system |
| 117 | Snr provided is invalid |
| 118 | Snr is not provided with the input Matrikkel for a sectioned property |
| 119 | Snr is provided with the input Matrikkel for a non-sectioned property |
| 123 | An exception occurred while processing your request |
| 138 | applicationName length has exceeded the maximum character limit allowed (10) |
| 146 | The applicationName is not set |
| 167 | You 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. |