Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

This page describes status codes, information and error messages for all etinglysing SOAP services.

Http status codes for etinglysing soap web service

HTTP Status code

Meaning

200

Successful request and response. (200 OK) For the generate<TYPE> operations, may be accompanied by information messages that may be important. See Generate document or below for more information.

401

Authentication failed. (401 Unauthorized) Occurs if username/password is wrong/deactivated or the authentication token (bearer) is invalid or expired.

500

Soap fault response. (500 Internal Server Error) The response body contain a SOAP Fault message. The fault message includes a description of the the specific error condition. Se below for more information about error conditions. 

Successful request and response(200)

Successful request and response means that the operation was successful. For an explanation about the responses for the various operations in the api, see the one of

Note that even if the response is a successful one, it might contain information that could be important that may be important later in the process.(documentMessages with errorGroup INFOMELDING)
For example for Post Processing operations.
See the errorGroup explanation for information about INFOMELDING.

<<Vi trenger kanskje et eksempel med infomelding her>>

Soap fault response(500)

Elements in the of the soap fault response, inside the <soap:Body><soap:SoapFault> element. See examples

Element

Description

faultcode

Values:

  • soap:Server - conveys the fault is on the server side and there exists a detail element with more information

  • soap:Client - The xml message is incorrectly formed or contains incorrect information. The faultstring is the only source of more information.

faultstring

ErrorGroup explanation

ErrorGroup

Explanation

Action

INTERNFEIL

Internal error - There is a state in data, environment or configuration that we couldn't recover from.

Try again. Another server might handle this request

VALIDERINGSFEIL

Validation error - the request does not validate. These are business / professional / legal reasons why the request did not validate. Validation rules for this error involves verifying request data with grunnboken. In the last validation rule, we actually validates the complete document using Statens Kartverk validation service.

Verify and correct the data and try again.

<<trenger vi eksempler her?>>

EKSTERNFEIL

External error - This means that one of the external services we depend on to complete the request does not respond or is faulty.

Try again later. The external services we use are seldom faulty for a longer period.

UKJENT_FEIL

Unknown error - A flaw in the code or it may also be that the server which processed the request had a problem

Please try again, if the problem persists contact support

INPUTFEIL

Bad request - The xml did validate, but there were some errors that is valid according to input

<<trenger vi eksempler her?>>

INFOMELDING

Example soap fault messages

 Validation error example
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <soap:Fault>
      <faultcode>soap:Server</faultcode>
      <faultstring>
        Kartverket rapporterer: Mangler signatur for organisasjon: 321 654 987
      </faultstring>
      <detail>
        <ns2:FellesDokumentException xmlns:ns2="http://dokument.ws7.etinglysing.no/">
          <exceptionId>1625040509848</exceptionId>
          <documentMessages>
            <documentMessage>
              <detail>Mangler signatur for organisasjon: 321 654 987</detail>
              <errorGroup>VALIDERINGSFEIL</errorGroup>
              <message>Kartverket rapporterer</message>
              <errorCode>9014</errorCode>
            </documentMessage>
          </documentMessages>
        </ns2:FellesDokumentException>
      </detail>
    </soap:Fault>
  </soap:Body>
</soap:Envelope>

  • No labels