{"type":"doc","content":[{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example request:","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","content":[{"text":"\n \n \n \n \n \n \n \n \n \n \n Organization name\n \n \n \n \n First Name\n Surname\n person@example.com\n \n \n \n \n \n \n \n \n \n \n \n \n 123456789\n \n DOKUMENT_TIL_TINGLYSING\n false\n \n \n false\n \n \n \n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Example response:","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","content":[{"text":"\n \n \n \n \n 2018-09-06T14:09:34.710+02:00\n 15742141\n OPPRETTET\n \n \n PEJhbmtJRFhNT...\n BIDXML\n PANTEDOKUMENT\n \n KARTVERKET\n \n \n \n\n","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"drawio","parameters":{"macroParams":{"zoom":{"value":"1"},"simple":{"value":"0"},"inComment":{"value":"0"},"custContentId":{"value":"1446281352"},"pageId":{"value":"1202192544"},"lbox":{"value":"1"},"diagramDisplayName":{"value":"Diagram uten navn.drawio"},"contentVer":{"value":"1"},"revision":{"value":"1"},"baseUrl":{"value":"https://ambita.atlassian.net/wiki"},"diagramName":{"value":"Diagram uten navn.drawio"},"pCenter":{"value":"0"},"width":{"value":"501"},"links":{"value":""},"tbstyle":{"value":""},"height":{"value":"331"}},"macroMetadata":{"macroId":{"value":"577fc4dd-7023-4c1b-9820-38d404d26e5b"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"https://ac.draw.io/connectImage?zoom=1&simple=0&inComment=0&custContentId=1446281352&pageId=1202192544&lbox=1&diagramDisplayName=Diagram+uten+navn.drawio&contentVer=1&revision=1&baseUrl=https%3A%2F%2Fambita.atlassian.net%2Fwiki&diagramName=Diagram+uten+navn.drawio&pCenter=0&width=501&links=&tbstyle=&height=331"}}],"title":"draw.io Diagram"}},"localId":"572352fe-e978-475e-beb2-dba2c7bb8587"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Validation and error handling","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"Example response:","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","content":[{"text":"\n \n \n soap:Server\n Ugyldig personnr eller organisasjonsnr: 123456789\n \n \n 1536235901863\n \n \n VALIDERINGSFEIL\n Ugyldig personnr eller organisasjonsnr: 123456789\n 9014\n \n \n \n \n \n \n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"If an error is detected, the document is not produced and an error response is returned to with detailed information. The integrator can correct the error and try again.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Information messages","type":"text"}]},{"type":"paragraph","content":[{"text":"In some cases informational messages are returned alongside the document. These messages do not prevent the document from being generated, but imply that the integrator need to ensure/think of how to process the document further.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"How to set document flow","type":"text"}]},{"type":"paragraph","content":[{"text":"When generating a mortgage you may have two scenarios:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Send the document to the Land Registry","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Send the document to a broker","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"This you can control by setting the flow. The possible flows are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DOKUMENT_TIL_TINGLYSING","type":"text"},{"type":"hardBreak"},{"text":"Document to be sent directly to LR","type":"text"},{"type":"hardBreak"},{"text":"This is equivalent to eiendomsoverdragelse=false.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DOKUMENT_TIL_OPPGJOER","type":"text"},{"type":"hardBreak"},{"text":"Document to be sent to broker.","type":"text"},{"type":"hardBreak"},{"text":"This is equivalent to `eiendomsoverdragelse=true and would produce a document even if there is no electronic settlement matching the document. This flow should be used to send to brokers, through any channel.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DOKUMENT_TIL_EKSISTERENDE_OPPGJOER","type":"text","marks":[{"type":"strike"}]},{"type":"hardBreak"},{"text":"Document to be sent to broker through the Ambita service; Electronic Property Settlement (EPS). This flow prevents the document from being generated if there is no relevant settlement in the service. ","type":"text","marks":[{"type":"strike"}]},{"text":" This flow is deprecated. From version 51.38 of Etinglysing, DOKUMENT_TIL_OPPGJOER should always be used regardless of it being an Ambita broker or not.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"How to migrating to version 7","type":"text"}]},{"type":"paragraph","content":[{"text":"Compared to V5/V6 there has been some small changes to tidy the model and remove a known bug. In previous, when a organization was the owner, the signaturberettigede had to be populated to make it work. This was unintentional and is fixed in V7.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"How to set the property","type":"text"}]},{"type":"paragraph","content":[{"text":"Previously each property was modelled ","type":"text"},{"text":"as","type":"text","marks":[{"type":"em"}]},{"text":" either borett or matrikkel:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"From V7 the property ","type":"text"},{"text":"contains","type":"text","marks":[{"type":"em"}]},{"text":" a matrikkel or borett","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n \n\n\n\n \n \n \n \n \n \n \n \n \n \n Organization name\n \n \n \n \n First Name\n Surname\n person@example.com\n \n \n \n \n \n \n \n \n \n \n \n \n 123456789\n \n DOKUMENT_TIL_TINGLYSING\n false\n \n \n false\n \n \n \n\n","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"How to set total fraction","type":"text"}]},{"type":"paragraph","content":[{"text":"Previously total fraction was modelled ","type":"text"},{"text":"as","type":"text","marks":[{"type":"em"}]},{"text":" attributes on the matrikkel element (totalnevner and totalteller):","type":"text"}]},{"type":"codeBlock","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"From V7 the attributes have been replaced by an element on the ","type":"text"},{"text":"panteobjekt","type":"text","marks":[{"type":"code"}]},{"text":" element.","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n ...\n \n \n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"totalBroek","type":"text","marks":[{"type":"code"}]},{"text":" is specified for a pantedokument with ","type":"text"},{"text":"dokumentflyt = DOKUMENT_TIL_TINGLYSING","type":"text","marks":[{"type":"code"}]},{"text":" the hjemmmelshaver broek will be validated and superseded according to grunnboken. ","type":"text"},{"text":"totalBroek","type":"text","marks":[{"type":"code"}]},{"text":" must be equal to sum broek for hjemmelshavere. ","type":"text"}]},{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"totalBroek","type":"text","marks":[{"type":"code"}]},{"text":" is specified for a pantedokument with ","type":"text"},{"text":"dokumentflyt = DOKUMENT_TIL_OPPGJOER","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"dokumentflyt = DOKUMENT_TIL_EKSISTERENDE_OPPGJOER","type":"text","marks":[{"type":"code"}]},{"text":", the hjemmelshaver broek will NOT be validated. Hjemmelshavere are the new owners and at the time of writing, it is not possible to validate. ","type":"text"},{"type":"hardBreak"},{"text":"If ","type":"text"},{"text":"totalBroek","type":"text","marks":[{"type":"code"}]},{"text":" is 1/1, the fractions for hjemmelshavere will be disregarded. Because there is no requirement for fraction in a pantedokument includes the entire property.","type":"text"},{"type":"hardBreak"},{"text":"If ","type":"text"},{"text":"totalBroek","type":"text","marks":[{"type":"code"}]},{"text":" is less than 1/1, sum ","type":"text"},{"text":"broek","type":"text","marks":[{"type":"code"}]},{"text":" for hjemmelshavere must be equal to ","type":"text"},{"text":"totalBroek","type":"text","marks":[{"type":"code"}]},{"text":", and hjemmelshaver ","type":"text"},{"text":"broek","type":"text","marks":[{"type":"code"}]},{"text":" must be correct according to the buyer contract. ","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"How to handle additional signatures","type":"text"}]},{"type":"paragraph","content":[{"text":"For some cases it is not enough that the owners sign the document. This typically means that there are “rettighetshavere” that needs to be taken into account. If not taken into account the service will respond with validation errors on generate (and that could be valuable and correct). If the case is, however, that you intend to get these signatures, the signature role must be applied. This tells the service that “I’ve got it!”.","type":"text"}]},{"type":"paragraph","content":[{"text":"There are four types of roles:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"a666b8cb-373d-488f-b85a-987aa7f2ef85"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#777777","rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Role","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#777777","rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"BORTFESTER","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"The land owner that lease out land","type":"text"},{"type":"hardBreak"},{"text":"(feste)). Only relevant for deeds.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"RETTIGHETSHAVER_I_URAADIGHET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"A legal person is blocking registration","type":"text"},{"type":"hardBreak"},{"text":"unless his consent is given (signature on the document)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"UTSTEDER","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"The seller is not the land owner","type":"text"},{"type":"hardBreak"},{"text":"(only relevant for deeds)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"PANTSETTER","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"The legal person if not equal to the land owner","type":"text"},{"type":"hardBreak"},{"text":"(hjemmelshaver)","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"In V7 this is put outside the property, hence yields the whole document (across all properties)","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n \n \n \n \n \n ?\n \n \n \n \n ?\n ?\n \n ?\n \n \n \n \n ?\n ?\n \n ?\n \n \n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"How to handle fractions","type":"text"}]},{"type":"paragraph","content":[{"text":"If you do not have the individual fraction owned by each person (“idell andel”) you may set the total fraction per property instead..","type":"text"}]},{"type":"paragraph","content":[{"text":"We have added two optional attributes to the WSDL on the Eiendom node (Matrikkel or Borett).","type":"text"},{"type":"hardBreak"},{"text":"There are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Totalteller (Total nominator)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Totalnevner (Total denominator)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Once these are given, the teller and nevner applied to the individual hjemmelshaver are ignored and correct values are loaded from Grunnboken. ","type":"text"}]},{"type":"paragraph","content":[{"text":"But there is an important thing to mention regarding this. The system can only help to calculate this fraction if the ‘dokumentflyt’ element is ‘DOKUMENT_TIL_TINGLYSING’. This will be cases where the customer want to refinance their existing loans. For transfer of ownership where the pantedocuments are going to be sent to broker we have no way of knowing the fraction. (‘dokumentflyt’ equal to ","type":"text"},{"text":"DOKUMENT_TIL_OPPGJOER","type":"text","marks":[{"type":"em"}]},{"text":" or ","type":"text"},{"text":"DOKUMENT_TIL_EKSISTERENDE_OPPGJOER","type":"text","marks":[{"type":"em"}]},{"text":"). In these cases the fraction element in each ‘hjemmelshaver’ element needs to be correct. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n \n \n \n \n \n \n \n \n \n Ivar\n Nubdal\n \n \n \n \n \n \n Trude\n Nubdal\n \n \n \n \n \n \n \n \n \n \n \n \n 985621551\n \n DOKUMENT_TIL_TINGLYSING\n false\n \n \n \n \n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Figure 4: Example total fractions","type":"text"}]},{"type":"paragraph","content":[{"text":"The picture shows how the borettsandel has added the two new attributes. The teller/nevner shown in the example are not used, and can therefore contain any value.","type":"text"}]},{"type":"paragraph","content":[{"text":"Validation. Using total fractions will check if the total fraction equals the summed fractions, fetched from Grunnboken, of the hjemmelshaver-list. Also, if owners (hjemmelshaver) do not match the Grunnbok, exceptions will be thrown.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"How to handle roles","type":"text"}]},{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"type":"external","url":"https://beta-api.ambita.com/docs/images/etinglysing/image6.png"}}]},{"type":"paragraph","content":[{"text":"Figure 5 Example rekvirent & panthaver","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Using Ambita’s signing service","type":"text"}]},{"type":"paragraph","content":[{"text":"Ambita has a signing service named ","type":"text"},{"text":"Esignering","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.esignering.no"}}]},{"text":". Almost all bank customers have their own signing service they use for signing documents. However, a new feature in Etinglysing allows bank customers to use Ambita’s signing service for signing Pantedokument. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Using the options element ","type":"text"},{"text":"sendToCustomerSigning","type":"text","marks":[{"type":"code"}]},{"text":" will send the generated document to the specified parties for signing with their BankID (they will receive an email with link to ","type":"text"},{"text":"www.esignering.no","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.esignering.no"}}]},{"text":" for signing the document).","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n...\n true\n","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Handle signer’s notification in your own system","type":"text"}]},{"type":"paragraph","content":[{"text":"From version 51.67 (February 2024) it is possible for integrated clients to handle all signing notification and dialogue in their own system. ","type":"text"},{"text":"This may require additional configuration of your account in Etinglysing. Contact customer support if you are interested in using this feature","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"It is now possible to suppress the email notification that is sent from Esignering to all parties that is expected to sign the document. By also setting the option ","type":"text"},{"text":"returnCustomerSigningLinks","type":"text","marks":[{"type":"code"}]},{"text":" to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":" the response from ","type":"text"},{"text":"generatePantedokument","type":"text","marks":[{"type":"code"}]},{"text":" will include an additional signing information object.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Request","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n...\n true\n true\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n https://beta.esignering.no/kunde/login/055c018e-79h6-4c75-938g-ac78c1e53832\n https://beta.esignering.no/kunde/login/d6s01844-6e63-488c-d396-4617626eff61\n \n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"id","type":"text","marks":[{"type":"code"}]},{"text":" attribute is the social security number (fødselsnummer), ","type":"text"},{"text":"signed","type":"text","marks":[{"type":"code"}]},{"text":" is the current signing status for that person and the element text is the link for that person to use for signing the document. Integrated clients can now present the link in their own system or be responsible for sharing the links to the parties in their preferred way.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Check signing status","type":"text"}]},{"type":"paragraph","content":[{"text":"For documentation about how to check the signing status, see ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://ambita.atlassian.net/wiki/spaces/DOC/pages/3744170002"}},{"text":" ","type":"text"}]}],"version":1}

Browser not supported