Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

UTKAST/Draft

WSDL file available in beta: https://beta.etinglysing.no/ws/v7/dokument?wsdl

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.

About the Forutsetningsbrev

Forutsetningsbrev (en: prerequisite letter) is a document sent from the bank to the real estate broker with terms and conditions for the mortgage document (pantedokument). It is the broker’s responsibility to make sure that the conditions can be met before sending it to registration (tinglysing). It can specify:

  • The bank's required priority for the Pantedokument.

  • Payment details.

  • The broker’s name and organization number.

  • Bank’s contact information.

Work flow

When generateForutsetningsbrev is invoked, the document ID from the generatePantedokumentcall is required, hence the Pantedokument must be generated before the Forutsetningsbrev.

Rules for when you can generate forutsetningsbrev for a pantedokument

Forutsetningsbrev only makes sense when pantedokument will be sent to a broker (the pantedokument has document flow DOKUMENT_TIL_OPPGJOER.

Format of the generated Forutsetningsbrev

Ambita will generate a forutsetningsbrev formatted according to the DSVE standard (version 2). For more information about the standardization process and format, including an XSLT for presentation, can be found on the official DSVE github account: https://github.com/bitsnorge.

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:

<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>
                        <offisiellId>?</offisiellId>
                        <navn>?</navn>
                     </panthaver>
                     <beloep valuta="?" verdi="?"/>
                  </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>

  • No labels