Kartverket changes receipts from tinglysing Authumn 2021

Description of the change

When a document is tinglyst, a signed grunnboksutskrift (SDO format) is returned as a “proof” of tinglysing. From October 30th 2021 Kartverket will only return a link to 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.

How this impacts Etinglysing’s Dokument webservices version 7

For documents tinglyst after the end of October, the getArtifacts service will not be able to return signed grunnboksutskrift. The current scope GRUNNBOKSUTSKRIFT (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 is available in beta environment now and will be deployed to production September 20th.

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.

Artifact Scope	Description

Artifact Scope	Description
ALLE	All artifacts. Default if no scope is given.
DOKUMENT	Returns the signed document.
PANTEATTEST	Deprecated. Will be removed 31.12.2021
GRUNNBOKSUTSKRIFT	Deprecated. will be removed 31.12.2021. The signed grunnboksutskrift in SDO format. Will not returned the link. For documents tinglyst after end of October 2021 this scope will not return data as Kartverket no longer returns a signed grunnboksutskrift.
GRUNNBOKSUTSKRIFT_ALLE	Upcoming. Will return grunnboksutskrift in all available formats (SDO and/or LINK). Available in beta late June 2021. For documents tinglyst after October 2021 only the link will be returned
OMSLAG	Deprecated. Will be removed 31.12.2021
RECEIPT	Deprecated. Will be removed 31.12.2021
PREREQUISITE	Returns the prerequisite letter in all formats available (XML, XSLT, PDF).

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.

Artifact Type	Description

Artifact Type	Description
DOKUMENT	The signed document or the signed følgebrev.
PANTEATTEST	Deprecated. Will be removed 31.12.2021
GRUNNBOKSUTSKRIFT	Signed grunnboksutskrift. Not available for douments tinglyst after end of October 2021.
GRUNNBOKSUTSKRIFT_LENKE	Upcoming. Link to unsigned grunnboksutskrift at Kartverket. Available in beta late June 2021.
OMSLAG	Deprecated. Will be removed 31.12.2021
PREREQUISITE	Prerequisite letter. There can be multiple occurrences of this type. Can be the XML letter, the XSLT to transform the XML to HTML or a rendered PDF depending on the format.

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.ws7.etinglysing.no/">
         <ns2:return dokumentId="15757668">
            <artifacts type="DOKUMENT" format="SDO" base64content=" .. "/>
            <!-- bekreftet utskrift -->
            <artifacts type="GRUNNBOKSUTSKRIFT" format="SDO" base64content=" .. "/>
            <!-- lenke til ubekreftet utskrift hos Kartverket -->
            <artifacts type="GRUNNBOKSUTSKRIFT_LENKE" format="TEXT" base64content=" ... "/>
         </ns2:return>
      </ns2:getArtifactsResponse>
   </soap:Body>
</soap:Envelope>

Documentation

Get Artifacts