Versions Compared

Version Old Version 2 New Version 3
Changes made by

Bjørn Hamre

Bjørn Hamre

Saved on

Key

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

...

This version is pretty much the same as version one (generatePrerequisite) but the free text fields and return information is removed. Some XML elements are renamed slightly to improve the Norwegian spelling.

Example generateForutsetningsbrev

...

:

The most common scenario is where the bank requires their pantedokument to have the first priority (after the property is sold) in the Land registry. In this case the only details about priority needed is foersteprioritet set to true, as in the XML below.

Code Block
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dok="http://dokument.ws7.etinglysing.no/">
   <soapenv:Header/>
   <soapenv:Body>
      <dok:generateForutsetningsbrev>
         <pantedokumentId>15763270<<pantedokumentId>?</pantedokumentId>
         <forutsetningsbrev>
            <pantedokumentdetaljer><prioritet>
               <foersteprioritet>true<<foersteprioritet>?</foersteprioritet>
            </pantedokumentdetaljer>   <!--Optional: only if NOT first priority-->
    <overfoerseldetaljer>           <prioritetsangivelser>
    <beloep valuta="NOK" verdi="1000"/>            <!--1 or more  <beloepOverfoeresDato>2024repetitions:-05-17T07:01:24.066+01:00</beloepOverfoeresDato>->
                <totalBeloep>1000</totalBeloep>  <prioritetsangivelse>
             <tilKontonummer>11115588888</tilKontonummer>        <!-- PRIORITET_ETTER or PRIORITET_LIKESTILT_MED -->
   <kid>1234567890</kid>                <kreditorSaksnummer>Bank's reference <rekkefoelge>?</kreditorSaksnummer>rekkefoelge>
               <meglerSaksnummer>Brokers assignment number or reference</meglerSaksnummer>  <panthaver>
             <beloepGjelder>Description if no KID</beloepGjelder>                <produsertDato>2024-05-01T07:01:24.066+01:00</produsertDato><!--Optional:-->
            </overfoerseldetaljer>            <offisiellId>?</offisiellId>
<avsender>                <navn>Bank's case handler</navn>      <!--Optional:-->
         <epost>ola@bank.no</epost>                <telefonDirekte>98765432</telefonDirekte><navn>?</navn>
               <telefon>55225522</telefon>
            </avsender>panthaver>
            <megler>         <beloep valuta="?" verdi="?"/>
    <navn>PRIVATMEGLEREN AS</navn>                <organinsasjonsnummer>986386661</organinsasjonsnummer>
    <!--Optional: textual description of expected priority-->
       </megler>          </forutsetningsbrev>       <prioritetsbeskrivelse>?</dok:generateForutsetningsbrev>
   </soapenv:Body>
</soapenv:Envelope>

How to fill out priority when foersteprioritet is false

When the pantedokument should yield for or have a similar priority as another, foersteprioritet is set to false and this element has the value true: <forstePrioritet>true</forstePrioritet>, then you do not fill out <prioritet>.
But when the value is false: <forstePrioritet>false</forstePrioritet>, you have to fill out priority.
Here is an example of how the priority can be filled out. The element <rekkefolge> needs to have one of two possible values PRIORITET_ETTER or PRIORITET_LIKESTILT_MED. The element <prioritetsBeskrivelse> is a freetext field, here you describe the priority in a textual manner.

Code Block
<forstePrioritet>false</forstePrioritet>
<prioritet>
  <prioritetsAngivelser>prioritetsbeskrivelse>
           <PrioritetsAngivelser>       <rekkefolge>PRIORITET_ETTER<</rekkefolge>prioritetsangivelse>
      <panthaver>         <offisiellId>987412548<</offisiellId>prioritetsangivelser>
        <navn>Husbanken</navn>       </panthaver>prioritet>
      <beloep valuta="NOK" verdi="1000000"/>    <overfoerselsdetaljer>
  <prioritetsBeskrivelse>Some text describing the priority</prioritetsBeskrivelse>     </PrioritetsAngivelser>     <PrioritetsAngivelser>
      <rekkefolge>PRIORITET_LIKESTILT_MED</rekkefolge><dato>?</dato>
      <panthaver>         <offisiellId>921345687<<beloepTilMegler>?</offisiellId>beloepTilMegler>
        <navn>Sparebanken Vest</navn>       <kontonummer>?</panthaver>kontonummer>
      <beloep valuta="NOK" verdi="2000000"/>
      <prioritetsBeskrivelse>Some text describing the priority</prioritetsBeskrivelse>     </PrioritetsAngivelser>
  </prioritetsAngivelser>
</prioritet>

Example: minimum prerequisite if first priority

Code Block
<dok:generatePrerequisite><!--Optional:-->
    <pantedokumentId>15882704</pantedokumentId>     <prerequisite>       <pantedokumentDetaljer>
  <kid>?</kid>
       <forstePrioritet>true</forstePrioritet>       </pantedokumentDetaljer>
overfoerselsdetaljer>
     <overfoerselDetaljer>       <avsender>
   <beloep valuta="NOK" verdi="100"/>           <beloepOverfortDato>2024-01-31</beloepOverfortDato><!--Optional:-->
          <totalBeloep>100</totalBeloep>     <navn>?</navn>
     <tilKontoNummer>34561212345</tilKontoNummer>           <produsertDato>2024<!-01-23T10:15:23.2962746+01:00</produsertDato>
 Optional:-->
    </overfoerselDetaljer>       <returneresTil>       <epost>?</returneresTil>epost>
      <avsender>       </avsender>  <!--Optional:-->
    <mottaker>           <navn>PRIVATMEGLEREN AS</navn><telefonDirekte>?</telefonDirekte>
          <organinsasjonsnummer>986386661</organinsasjonsnummer>       </mottaker>
    </prerequisite>
</dok:generatePrerequisite>

Example generatePrerequisite response

For ease of use, the generated Prerequisite document (XML) is returned in the generatePrerequisiteResponse.

Code Block
languagexml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"<!--Optional:-->
   <soap:Body>       <ns2:generatePrerequisiteResponse xmlns:ns2="http://dokument.ws7.etinglysing.no/">    <telefon>?</telefon>
     <return>          <!--Optional:-->
  <id>1</id>             <documentHolder>
               <content>BASE64_ENCODED</content><saksnummer>?</saksnummer>
               <format>XML</format></avsender>
            <megler>
  <type>PREREQUISITE</type>             <navn>?</documentHolder>navn>
            <documentHolder>                <content>BASE64_ENCODED</content><organinsasjonsnummer>?</organinsasjonsnummer>
               <format>XSLT</format><!--Optional:-->
               <type>PREREQUISITE<<saksnummer>?</type>saksnummer>
            </documentHolder>megler>
         </return>forutsetningsbrev>
      </ns2dok:generatePrerequisiteResponse>generateForutsetningsbrev>
   </soapsoapenv:Body>
</soapsoapenv:Envelope>