Versions Compared

Key

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

UTKAST/Draft

Forutsetningsbrev

Available in Etinglysing 51.69.0 (end of May 2024).

History

Etinglysing has for a long time had the webservice generatePrerequisite that generate a prerequisite letter to the broker. This first version (generatePrerequisite) had several free text input field for the bank’s conditions/requirements. Since then, DSVE has defined a second version of this letter that has a set of standardized texts requirements so that it will be easier for the broker to understand and interpret. This new webservice, generateForutsetningsbrev, will generate a document to the broker according to the news specification. The term Forutsetningsbrev has been agreed upon, som the new webservice is named using this common name instead of prerequisite V2.

...

Example generateForutsetningsbrev:

Code Block
languagexml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dok="http://dokument.ws7.etinglysing.no/">
   <soapenv:Header/>
   <soapenv:Body>
      <dok:generateForutsetningsbrev>
         <pantedokumentId>?</pantedokumentId>
         <forutsetningsbrev>
            <prioritet>
               <foersteprioritet>?</foersteprioritet>
               <!--Optional: only if NOT first priority-->
               <prioritetsangivelser>
                  <!--1 or more repetitions:-->
                  <prioritetsangivelse>
                     <!-- PRIORITET_ETTER or PRIORITET_LIKESTILT_MED -->
                     <rekkefoelge>?</rekkefoelge>
                     <panthaver>
                 
      <!--Optional:-->                         <offisiellId>?</offisiellId>
                        <!--Optional:-->
                        <navn>?</navn>
                     </panthaver>
                     <beloep valuta="?" verdi="?"/>
                     <!--Optional: textual description of expected priority-->
 
                   <prioritetsbeskrivelse>?</prioritetsbeskrivelse>
                  </prioritetsangivelse>
               </prioritetsangivelser>
            </prioritet>
            <overfoerselsdetaljer>
               <dato>?</dato>
               <beloepTilMegler>?</beloepTilMegler>
               <kontonummer>?</kontonummer>
               <!--Optional:-->
               <kid>?</kid>
            </overfoerselsdetaljer>
            <avsender>
               <!--Optional:-->
               <navn>?</navn>
               <!--Optional:-->
               <epost>?</epost>
               <!--Optional:-->
               <telefonDirekte>?</telefonDirekte>
               <!--Optional:-->
               <telefon>?</telefon>
               <!--Optional:-->
               <saksnummer>?</saksnummer>
            </avsender>
            <megler>
               <navn>?</navn>
               <organinsasjonsnummer>?</organinsasjonsnummer>
               <!--Optional:-->
               <saksnummer>?</saksnummer>
            </megler>
         </forutsetningsbrev>
      </dok:generateForutsetningsbrev>
   </soapenv:Body>
</soapenv:Envelope>

Data fields in input

Field name

Description

Example

overfoerselsdetaljer.dato

This is the date (in the future) when the bank will transfer the money to the broker.

<dato>2024-11-31</dato>

avsender.saksnummer

A reference or other value that identifies the bank’s loan case. The bank should (if possible) use the same reference for requesting purchase contract, sending the bank’s intention, when creating the mortgage (pantedokument) and creating the forutsetningsbrev.

megler.saksnummer

The reference or other value that identifies the broker’s assignment/case number. In the generatePrerequsite this is the same as meglerSaksnummer inside the overfoerselDetaljer element.

How to fill out priority when forstePrioritet is false

The element <foersteprioritet> is a mandatory field.
When this element has the value true: <foersteprioritet>true</foersteprioritet>, then you do not fill out <prioritet>.
But when the value is false: <foersteprioritet>false</foersteprioritet>, you have to fill out priority.
Here is an example of how the priority can be filled out. The element <rekkefoelge> needs to have one of two possible values PRIORITET_ETTER or PRIORITET_LIKESTILT_MED.

Note that for panthaver you must specify at least one of offisiellId or name, both cannot be empty.

Code Block
<forstePrioritet>false</forstePrioritet>
<prioritet>
  <prioritetsangivelser>
    <prioritetsangivelse>
      <rekkefoelge>PRIORITET_ETTER</rekkefoelge>
      <panthaver>
        <offisiellId>987412548</offisiellId>
        <navn>Husbanken</navn>
      </panthaver>
      <beloep valuta="NOK" verdi="1000000"/>
    </prioritetsangivelse>
    <prioritetsangivelse>
      <rekkefoelge>PRIORITET_LIKESTILT_MED</rekkefoelge>
      <panthaver>
        <offisiellId>921345687</offisiellId>
        <navn>Sparebanken Vest</navn>
      </panthaver>
      <beloep valuta="NOK" verdi="2000000"/>
    </prioritetsangivelse>
  </prioritetsangivelser>
</prioritet>