Get status

You can get the current document status by calling the getStatus webservice method and supplying the documentId for your document.

An integrator should not poll for document statuses but use the hendelse webservice (see Monitoring events) in order to be notified about relevand status changes.

Example request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
                  xmlns:dok="http://dokument.ws7.etinglysing.no/">
   <soapenv:Header/>
   <soapenv:Body>
      <dok:getStatus>
         <documentId>1234567</documentId>
      </dok:getStatus>
   </soapenv:Body>
</soapenv:Envelope>

Example response:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:getStatusResponse xmlns:ns2="http://dokument.ws7.etinglysing.no/">
         <ns2:return>
            <status>
               <created>2018-08-02T14:00:09.205+02:00</created>
               <documentStatusTinglysing/>
               <id>45721524</id>
               <statusCode>SIGNERT</statusCode>
            </status>
            <type>PANTEDOKUMENT</type>
            <documentVersion>KARTVERKET</documentVersion>
         </ns2:return>
      </ns2:getStatusResponse>
   </soap:Body>
</soap:Envelope>

Field	Required	Description

Field	Required	Description
status.created	true	Ducument created timestamp
status.documentStatusTinglysing	false	Only for documents that are tinglyst. See example below.
status.id	true	Document id
status.statusCode	true	Current document status
status.parentDocumentId	false	Id of slip (følgebrev) or package (dokumentpakke)
status.description	false	Document description
status.reference	false	Document reference
type	true	Document type
documentVersion	false	Deprecated, will be removed
documentMessages	false	Relevant messages, eg. when tinglysing failed.

Example response failed tinglysing

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:getStatusResponse xmlns:ns2="http://dokument.ws7.etinglysing.no/">
         <return>
            <status>
               <created>2017-02-28T17:03:30.638+01:00</created>
               <documentStatusTinglysing>
                  <system>EIENDOM</system>
               </documentStatusTinglysing>
               <id>15712773</id>
               <statusCode>TINGLYSING_FEILET</statusCode>
               <parentDocumentId>15713868</parentDocumentId>
               <description>Pant - 1201/21/1614// [G]</description>
               <reference>sdv</reference>
            </status>
            <type>PANTEDOKUMENT</type>
            <documentVersion>KARTVERKET</documentVersion>
            <documentMessages>
               <documentMessage>
                  <detail>1508Mangler signatur for person: 040376 37772</detail>
                  <errorGroup>VALIDERINGSFEIL</errorGroup>
                  <message>Kartverket rapporterer</message>
                  <errorCode>9014</errorCode>
               </documentMessage>
               <documentMessage>
                  <detail>1128Mangler erklæring om sivilstand for rettighetshaver: 040376 37772</detail>
                  <errorGroup>VALIDERINGSFEIL</errorGroup>
                  <message>Kartverket rapporterer</message>
                  <errorCode>9014</errorCode>
               </documentMessage>
            </documentMessages>
         </return>
      </ns2:getStatusResponse>
   </soap:Body>
</soap:Envelope>

example tinglyst document:

Get status of an assignment (oppdrag)

The integrator initiates the process by requesting www.etinglysing.no with the oppdrag’s unique ID in etinglysing as input. The response will be:

oppdragsNr: unique String
oppdragsId: unique ID in etinglysing (same as input)
epsSettlementId: unique EPS ID if exists
documentStatusList: list of document statuses for all documents that exists on this oppdrag

Figure 8 Example of response from getOppdragStatus operation

Documentation

Get status

Get status of an assignment (oppdrag)

Related pages