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.
...
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:
| 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> <!--Optional:-->
PRIORITET_ETTER or PRIORITET_LIKESTILT_MED -->
<kid>1234567890</kid> <rekkefoelge>?</rekkefoelge>
<!--Optional:--> <kreditorSaksnummer>Bank's<panthaver>
reference </kreditorSaksnummer> <!--Optional:--> <offisiellId>?</offisiellId>
<meglerSaksnummer>Brokers assignment number or reference</meglerSaksnummer> <navn>?</navn>
<!--Optional:--> <beloepGjelder>Description if no KID<</beloepGjelder>panthaver>
<produsertDato>2024-05-01T07:01:24.066+01:00</produsertDato> <beloep valuta="?" verdi="?"/>
</overfoerseldetaljer> <avsender></prioritetsangivelse>
<!--Optional:-->/prioritetsangivelser>
<navn>Bank's case handler</navn></prioritet>
<overfoerselsdetaljer>
<!--Optional:--> <epost>ola@bank.no</epost><dato>?</dato>
<!--Optional:--><beloepTilMegler>?</beloepTilMegler>
<telefonDirekte>98765432<<kontonummer>?</telefonDirekte>kontonummer>
<!--Optional:-->
<telefon>55225522<<kid>?</telefon>kid>
</avsender>overfoerselsdetaljer>
<megler><avsender>
<navn>PRIVATMEGLEREN AS</navn><!--Optional:-->
<organinsasjonsnummer>986386661</organinsasjonsnummer>
</megler>
<navn>?</navn>
</forutsetningsbrev> </dok:generateForutsetningsbrev>!--Optional:-->
</soapenv:Body> </soapenv:Envelope> |
How to fill out priority when forstePrioritet is false
The element <forstePrioritet> is a mandatory field.
When 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> <PrioritetsAngivelser> <rekkefolge>PRIORITET_ETTER</rekkefolge><epost>?</epost> <panthaver> <offisiellId>987412548</offisiellId><!--Optional:--> <navn>Husbanken</navn> <telefonDirekte>?</panthaver> <beloep valuta="NOK" verdi="1000000"/>telefonDirekte> <prioritetsBeskrivelse>Some text describing the priority</prioritetsBeskrivelse> </PrioritetsAngivelser><!--Optional:--> <PrioritetsAngivelser> <rekkefolge>PRIORITET_LIKESTILT_MED</rekkefolge> <panthaver> <offisiellId>921345687</offisiellId><telefon>?</telefon> <navn>Sparebanken Vest</navn> </panthaver> <beloep valuta="NOK" verdi="2000000"/!--Optional:--> <prioritetsBeskrivelse>Some text describing the priority</prioritetsBeskrivelse> </PrioritetsAngivelser> </prioritetsAngivelser> </prioritet> |
Example: minimum prerequisite if first priority
| Code Block |
|---|
<dok:generatePrerequisite> <pantedokumentId>15882704</pantedokumentId> <prerequisite> <pantedokumentDetaljer> <saksnummer>?</saksnummer> <forstePrioritet>true</forstePrioritet> </pantedokumentDetaljer>avsender> <overfoerselDetaljer> <megler> <beloep valuta="NOK" verdi="100"/> <beloepOverfortDato>2024-01-31</beloepOverfortDato><navn>?</navn> <totalBeloep>100</totalBeloep> <organinsasjonsnummer>?</organinsasjonsnummer> <tilKontoNummer>34561212345</tilKontoNummer> <produsertDato>2024<!-01-23T10:15:23.2962746+01:00</produsertDato>Optional:--> </overfoerselDetaljer> <returneresTil> <saksnummer>?</returneresTil>saksnummer> <avsender> </avsender>megler> <mottaker> <navn>PRIVATMEGLEREN AS</navn></forutsetningsbrev> <organinsasjonsnummer>986386661</organinsasjonsnummer> </mottaker> </dok:generateForutsetningsbrev> </prerequisite>soapenv:Body> </dok:generatePrerequisite> |
Example generatePrerequisite response
For ease of use, the generated Prerequisite document (XML) is returned in the generatePrerequisiteResponse.
| Code Block | ||
|---|---|---|
| ||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:generatePrerequisiteResponse xmlns:ns2="http://dokument.ws7.etinglysing.no/"> <return> <id>1</id>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. |
|
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 | |
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> <documentHolder> <offisiellId>987412548</offisiellId> <content>BASE64_ENCODED</content><navn>Husbanken</navn> <format>XML</format></panthaver> <beloep <type>PREREQUISITE</type> valuta="NOK" verdi="1000000"/> </documentHolder>prioritetsangivelse> <prioritetsangivelse> <documentHolder> <content>BASE64_ENCODED</content><rekkefoelge>PRIORITET_LIKESTILT_MED</rekkefoelge> <panthaver> <format>XSLT<<offisiellId>921345687</format>offisiellId> <type>PREREQUISITE</type> <navn>Sparebanken Vest</navn> </documentHolder>panthaver> <beloep </return> valuta="NOK" verdi="2000000"/> </ns2:generatePrerequisiteResponse>prioritetsangivelse> </soap:Body>prioritetsangivelser> </soap:Envelope>prioritet> |