Versions Compared

Key

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

...

If retinglysing is attempted after the expiry of the original document, this registration process will fail, priority is lost, and potential a new document must be registered.

Explanations

Field

Explaination

embetenummer

The office number from Grunnboken

dokumentaar

The year of the registered document to be deleted

dokumentnummer

The document number from Grunnboken

rettsstiftelsesnummer

Index of entry within a document, indexed from 1

rettsstiftelsestype

The type of entry within a document, for example “OB_PDB”

referanse

The reference for the document

There are two possible ways to generate such a document; either by providing the document number og the individual entries within a document (rettstiftelse))

Request

Example with a document reference:

Code Block
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dok="http://dokument.ws7.etinglysing.no/">
   <soapenv:Header/>
   <soapenv:Body>
      <dok:generateRetinglysing>
         <retinglysing referanse="Demo-Retinglysing">
            <paategner>
               <dokument embetenummer="200" dokumentaar="2019" dokumentnummer="123456"/>
            </paategner>
         </retinglysing>
      </dok:generateRetinglysing>
   </soapenv:Body>
</soapenv:Envelope>

In this scenario, etinglysing will fetch all entries, rettsstiftelser, relevant from the registry to generate the signing payload.

Example with a list of entries/rettsstiftelsesreferanse:

Code Block
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dok="http://dokument.ws7.etinglysing.no/">
   <soapenv:Header/>
   <soapenv:Body>
      <dok:generateRetinglysing>
         <retinglysing referanse="DemoWithRettsstiftelseList">
            <paategner>
               <rettsstiftelser>
                  <rettsstiftelsesreferanse embetenummer="200" dokumentaar="2019" dokumentnummer="123456" rettsstiftelsesnummer="1" rettsstiftelsestype="TV_UTL"/>
                  <rettsstiftelsesreferanse embetenummer="200" dokumentaar="2019" dokumentnummer="123456" rettsstiftelsesnummer="2" rettsstiftelsestype="TV_UTL"/>
               </rettsstiftelser>
            </paategner>
         </retinglysing>
      </dok:generateRetinglysing>
   </soapenv:Body>
</soapenv:Envelope>

...

When called the service wil validate the consistency of the document and filter out irrelevant rettsstiftelser not applicable for this type of operation (retinglysing). Each retinglysing document can only point to one document in grunnboken.

Signature Requirements

Licensee of the original document (panthaver/saksøker/prosessfullmektig) must sign the retinglysing document. The signature typically will be from a corporate certificate (virksomhetssignatur)

Response

The response is equal to other generate calls. If validation fails, a list of errors are returned.

...