...

Kartverket changes receipts from tinglysing Authumn 2021

Description of the change

When a document is tinglyst today, a signed grunnboksutskrift (SDO format) is returned as a “proof” of tinglysing. From October 30th 2021 Kartverket will only return a link to an unsigned grunnboksutskrift (PDF format)a grunnboksutskrift. In a transition period starting May 20th 2021, Kartverket will return both a signed grunnboksutskrift and a link.

How this impacts Etinglysing’s Dokument webservices version 5

This change will not be implemented in version 5 of the DokumentWs webservice. From October 30th

How this impacts Etinglysing’s Dokument webservices version 7

For documents tinglyst after the end of October, the getArtifacts service will no longer return the not be able to return signed grunnboksutskrift. The current scope GRUNNBOKSUTSKRIFT (SDO)see documentation below) will only return the SDO as today. Clients will have to use scope ALLE or GRUNNBOKSUTSKRIFT_ALLE in order to retrieve the new link.

Changes in DokumentWs 7 webservice

Changes in the getArtifacts webservice

...

As a service to Etinglysing’s customers, Etinglysing will download the unsigned grunnboksutskrift as PDF and return together with the link and, until October 30th, the signed SDO. This will save you from doing a separate call to Kartverket to download the file yourself. In order to implement this we will add two new document formats in the artifact response, se below.

New formats on artifact type GRUNNBOKSUTSKRIFT: PDF and URL

Today the format of the grunnboksutskrift is always SDO. The link will be returned as format URL, and will be base64 encoded as the other documents. The unsigned grunnboksutskrift will be returned as format PDF. In the transition phase a call to getArtifacts can return three artifacts of type GRUNNBOKSUTSKRIFT where the format (SDO, PDF or URL) describes which type it is.

will be available in beta environment by the end of June 2021. Exact date will be given when we get closer to implementation.

New scope GRUNNBOKSUTSKRIFT_ALLE

In order to not brake existing integrations, the current scope GRUNNBOKSUTSKRIFT and RECEIPT (which are used by most integrators) will only return the signed grunnboksutskrift (SDO) as today. This is done to be “backward compatible”. When you and your client code are ready to accept the link, change to use the new scope GRUNNBOKSUTSKRIFT_ALLE.

New artifact type

We introduce a new artefact type:

• GRUNNBOKSUTSKRIFT_LENKE - the link to the grunnboksutskrift at Kartverket.

These new artifact types will only be returned for scope ALLEand GRUNNBOKSUTSKRIFT_ALLE.

Request data

When requesting artifacts, the documentId is a required parameter. If you do not want to retrieve all artifacts for a document, an optional artifactscope can be used.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dok="http://dokument.ws7.etinglysing.no/">
   <soapenv:Header/>
   <soapenv:Body>
      <dok:getArtifacts>
         <documentId>10000100</documentId>
         <!--Optional:-->
         <artifaktscope>valid_artifactscope</artifaktscope>
      </dok:getArtifacts>
   </soapenv:Body>
</soapenv:Envelope>

The upcoming change, where Kartverket returns a link to the unsigned grunnboksutskrift, will not be implemented for scope GRUNNBOKSUTSKRIFT. Clients using scope GRUNNBOKSUTSKRIFT or RECEIPTmust change their implementation to use GRUNNBOKSUTSKRIFT_ALLE in order to get the new artifact type.

Response data

Response data will be a list of artifacts depending on your scope in the request. All artifacts are defined by their type and format. Note that some artifact types can have several formats. The artifact content is always base64 encoded.

Example of a response with both the signed document and the three types of grunnboksutskrift:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:getArtifactsResponse xmlns:ns2="http://dokument.ws5.etinglysing.no/">
         <ns2:return dokumentId="15757668">
            <artifacts type="DOKUMENT" format="SDO" base64content=" .. "/>
            <!-- ubekreftet utskrift -->
            <artifacts type="GRUNNBOKSUTSKRIFT" format="PDF" base64content=" .. "/>
            <!-- bekreftet utskrift -->
            <artifacts type="GRUNNBOKSUTSKRIFT" format="SDO" base64content=" .. "/>
            <!-- lenke til ubekreftet utskrift hos Kartverket -->
            <artifacts type="GRUNNBOKSUTSKRIFT_LENKE" format="URL" base64content=" ... "/>
         </ns2:return>
      </ns2:getArtifactsResponse>
   </soap:Body>
</soap:Envelope>

For documents tinglyst after October 30th an SDO will not be available.

getArtifactService

...

The artifacts are available at different stages. The different stages and artifacts available, are listed in the table below.

...

Document status

...

Artifact

...

PART_SIGNERT

SIGNERT

UNDER_TINGLYSING

TINGLYSING_FEILET

FJERNET_FRA_TINGLYSING

...

ALLE, DOKUMENT

...

TINGLYST

...

All these types

...