The integrator initiates the process by sending a data structure (as described in the WSDL) to the web service. Etinglysing will return an object containing the document itself, a reference to the document in etinglysing and some key information about it.
...
| Drawio | ||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Normal flow
Example request:
| Code Block |
|---|
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:dok="http://dokument.ws7.etinglysing.no/">
<soapenv:Header/>
<soapenv:Body>
<dok:generatePantedokument>
<pantedokument referanse="Example">
<panteobjekter>
<panteobjekt>
<matrikkel
kommunenummer="1234"
gaardsnummer="1"
bruksnummer="1"
festenummer="0"
seksjonsnummer="0"
eiendomsnivaa="G"/>
<hjemmelshavere>
<hjemmelshaver>
<organisasjon id="123456789">
<navn>Organization name</navn>
<!--Optional, not needed for production-->
<!--Will be validated towards Enhetsregisteret if present-->
<signaturberettigede>
<signaturberettigede id="12345678901">
<fornavn>First Name</fornavn>
<etternavn>Surname</etternavn>
<epost>person@example.com</epost>
</signaturberettigede>
</signaturberettigede>
</organisasjon>
<broek teller="1" nevner="1"/>
</hjemmelshaver>
</hjemmelshavere>
</panteobjekt>
</panteobjekter>
<pantebeloeper>
<pantebeloep valuta="NOK" verdi="100000"/>
</pantebeloeper>
<panthavere>
<panthaverId>123456789</panthaverId>
</panthavere>
<dokumentflyt>DOKUMENT_TIL_TINGLYSING</dokumentflyt>
<refinansiering>false</refinansiering>
</pantedokument>
<options>
<returnPdf>false</returnPdf>
</options>
</dok:generatePantedokument>
</soapenv:Body>
</soapenv:Envelope>
|
...
| Code Block |
|---|
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:generatePantedokumentResponse xmlns:ns2="http://dokument.ws7.etinglysing.no/">
<return>
<status>
<created>2018-09-06T14:09:34.710+02:00</created>
<id>15742141</id>
<statusCode>OPPRETTET</statusCode>
</status>
<documentHolder>
<content>PEJhbmtJRFhNT...</content>
<format>BIDXML</format>
<type>PANTEDOKUMENT</type>
</documentHolder>
<documentVersion>KARTVERKET</documentVersion>
</return>
</ns2:generatePantedokumentResponse>
</soap:Body>
</soap:Envelope>
|
Validation & error handling
...
</ns2:generatePantedokumentResponse>
</soap:Body>
</soap:Envelope>
|
| Drawio | ||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Validation and error handling
Example response:
| Code Block |
|---|
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<soap:Fault>
<faultcode>soap:Server</faultcode>
<faultstring>Ugyldig personnr eller organisasjonsnr: 123456789</faultstring>
<detail>
<ns2:FellesDokumentException xmlns:ns2="http://dokument.ws7.etinglysing.no/">
<exceptionId>1536235901863</exceptionId>
<documentMessages>
<documentMessage>
<errorGroup>VALIDERINGSFEIL</errorGroup>
<message>Ugyldig personnr eller organisasjonsnr: 123456789</message>
<errorCode>9014</errorCode>
</documentMessage>
</documentMessages>
</ns2:FellesDokumentException>
</detail>
</soap:Fault>
</soap:Body>
</soap:Envelope>
|
...
This feature enables the integrator to generate documents on behalf of another organization. Once added into the request, the document will be generated accordingly unless the validation fails to validate that the respective organisation is defined as rekvirent or panthaver (dokumenteier) in the user profile.
...
Figure 5Example 5 Example rekvirent & panthaver