# Abonnement

Tinglysningsretten
1.0.0

← Tilbage til Hovedside

## Oversigt

e-TL giver mulighed for at man kan abonnere på hændelser på en bestemt ejendom via System-System grænsefladen.

Når der sker en hændelse får abonnenten en besked der indeholder et minimum af information, der gør at abonnenten kan identificere hændelsen.

Adgang til oplysninger i tingbogen er afgiftsbelagte og abonnentsordningen er følgende designet, så der ikke afleveres oplysninger der ellers ville udløse en afgift.

Når der abonneres på en ejendom, modtages samtlige hændelser på ejendommen. Abonnenenten er selv ansvarlig for at frasortere evt. uinteressante hændelser.

Abonnementshændelser modtages via svarservicen AbonnementSvar, hvor der også er nærmere beskrivelse af hvad en hændelse præcist indeholder.

Via system-system grænsefladen er det udelukkende muligt at administrere abonnementer, der resulterer i system-system notifikationer.

Alle kald er asynkrone og udløser en notifikation.

### Endpoints

#### AbonnementOpret

Endpoint URL: `Abonnement/AbonnementOpret`

Beskrivelse | Opret abonnement på en enkelt ejendom. Som svar modtager man en AbonnementIdentifikator der kan anvendes til efterfølgende administration af abonnementet. Ved notifikationer om hændelser på ejendommen bliver abonnementsIdentifikator medsendt.
Input | AbonnementOpret.xsd
Output | AbonnementOpretSvar.xsd
Fejlhåndtering | Hvis der sker fejl, f.eks. hvis ejendommen ikke findes, så sender e-TL en XML fejl. Hvis abonnementet allerede findes har kaldet ingen effekt.
Interaktionsmønster | Forespørgsel-svar

Eksempel på forespørgsel:

    POST /s2s/Abonnement/AbonnementOpret HTTP/1.1
    Content-Type: application/xml
    Tinglysning-Message-ID: uuid:332195c5-e74a-4b42-83f8-a5d9d7f5e576
    Tinglysning-Relates-To: s2s-http-xml-api-end2end-test
    Content-Length: 4342

    <?xml version="1.0" encoding="UTF-8"?><AbonnementOpret xmlns="http://rep.oio.dk/tinglysning.dk/service/message/administration/1/" xmlns:ns="http://rep.oio.dk/tinglysning.dk/schema/model/1/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://rep.oio.dk/tinglysning.dk/service/message/administration/1/ http://rep.oio.dk/tinglysning.dk/service/message/administration/1/AbonnementOpret.xsd">
        <ns:BilIdentifikator>
            <ns:Stelnummer>WAUZZZ8EX7A263972</ns:Stelnummer>
        </ns:BilIdentifikator>
    <Signature xmlns="http://www.w3.org/2000/09/xmldsig#" Id="Signature-573e2f04-4956-4094-a7e5-c06a5e8e0179"><SignedInfo><CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/><SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#rsa-sha512"/><Reference URI=""><Transforms><Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/><Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/></Transforms><DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/><DigestValue>e3Azsb/DuCoOM13NvPtVjuUaWtcBNLsINSCKXP68wzQ=</DigestValue></Reference></SignedInfo><SignatureValue>kVFQ6FFl6LnT3bFlolQ9ii5HJIY7MdhAq5XUZ9OfN+qaJ/kDmzqPaaW1yfmZv2sSQ1M7nQhi37W0&#13;
    QreTsvN8oh0Bxt2RUvkVImOIlj0WXGc6p7x3RmpnLN/oNNeykvrKhXFA+in2gGhnTShGM6IhObgu&#13;
    NNFMsjQm+uwDWL6YabYBrQhzpJtQhhDIasUcoWzEszsDevu2ZqUcXs44B/AgI90eIPx8NP3Dr+mO&#13;
    7nk2oNV5/onhoV/4CrmrTFbv7JAMDvTq7tkSYT7CMiYsheyNaP3qmnYWVzTBMnGDB46YDH9+N9W8&#13;
    0R0iNKbTD7xwXNUkQVtEqyPH9AH1evIb22SgAWxPvAcF6lV2oXcSxL8/4B0hiKEAktSqUpLRcX72&#13;
    NSIvZn16p3DtIApgWmdE1Ua8qLG4nb/k2cNv6n0h3Z3fww3Z9b5fkLrkVZEKQSoN6Nx6DuRBD+uK&#13;
    gsrkVtDTwaYBJK+fSSTGAdSVm3BoomQZ9+MpJbVmHDKgVScbi++LmnU2</SignatureValue><KeyInfo><X509Data><X509Certificate>MIIGrDCCBOCgAwIBAgIUNDToBwFCKjTnfoTggwRZQ7NT70wwQQYJKoZIhvcNAQEKMDSgDzANBglg&#13;
    hkgBZQMEAgEFAKEcMBoGCSqGSIb3DQEBCDANBglghkgBZQMEAgEFAKIDAgEgMGsxLTArBgNVBAMM&#13;
    JERlbiBEYW5za2UgU3RhdCBPQ0VTIHVkc3RlZGVuZGUtQ0EgMTETMBEGA1UECwwKVGVzdCAtIGN0&#13;
    aTEYMBYGA1UECgwPRGVuIERhbnNrZSBTdGF0MQswCQYDVQQGEwJESzAeFw0yMzAzMDgxMzEzMDNa&#13;
    Fw0yNjAzMDcxMzEzMDJaMIGiMSUwIwYDVQQDDBxUTFIgZVRMIFRFU1QgLSBYTUwtc2lnbmVyaW5n&#13;
    MTcwNQYDVQQFEy5VSTpESy1POkc6ODg3YTFlNjktNGU4NC00NmI1LWI2NTQtMzgxYzcxYmU4NTU5&#13;
    MRowGAYDVQQKDBFEb21zdG9sc3N0eXJlbHNlbjEXMBUGA1UEYQwOTlRSREstMjE2NTk1MDkxCzAJ&#13;
    BgNVBAYTAkRLMIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIBigKCAYEAvfks1Cq2hW2c7fmx2rUW&#13;
    oPgHdSNphG7GWO7GrRkVQSCB3GBzdf7qck56obK0XLui8yD00FDHJgyFCSLIOpesAi9fjQnc+Wl1&#13;
    HUx1WfzPzvGbQvGPB9oWtP1lhY9gNxb3ZObzrW3DfOGbKbbNCw6yaaac5ssi/T447Eg/psHnAACG&#13;
    cGCU9OxsBoTgx5Zq+4k1u+I3mpvGeczetzY6fpQyKzpc1NJNhe6UeKZFxYocWDrIvdoMsOlosI9Q&#13;
    +491FnmKj3heCSMGu8o59uhYw2CpwVDreXYK+tfRj1tZWGhj++uYHmA+SgV9qnw+1DvESZZdPPvX&#13;
    IFuHFJZ2SCO2ZOarvX2IrsjHfyLq1zi80fXS1SHeuIZOJwMclQ6uVrn5VYAzCRr/LPEEOptKsLRK&#13;
    m2q81vHcC2eEXq1IaTIhp4tFJyBsSp/JX0bvM23c4AaLnG1WeT1hAWB8oPUKP/Ai3cesn9VOLcv4&#13;
    Fm72jggT/YuS1dpEL6mgGqID3RVEW1t/0DHNAgMBAAGjggGmMIIBojAMBgNVHRMBAf8EAjAAMB8G&#13;
    A1UdIwQYMBaAFH8on9lxmULidefXNXYuTQglbXZeMHsGCCsGAQUFBwEBBG8wbTBDBggrBgEFBQcw&#13;
    AoY3aHR0cDovL2NhMS5jdGktZ292LmRrL29jZXMvaXNzdWluZy8xL2NhY2VydC9pc3N1aW5nLmNl&#13;
    cjAmBggrBgEFBQcwAYYaaHR0cDovL2NhMS5jdGktZ292LmRrL29jc3AwHgYDVR0RBBcwFYETZS10&#13;
    bC0wMTFAZG9tc3RvbC5kazAhBgNVHSAEGjAYMAgGBgQAj3oBATAMBgoqgVCBKQEBAQMHMDsGCCsG&#13;
    AQUFBwEDBC8wLTArBggrBgEFBQcLAjAfBgcEAIvsSQECMBSGEmh0dHBzOi8vdWlkLmdvdi5kazBF&#13;
    BgNVHR8EPjA8MDqgOKA2hjRodHRwOi8vY2ExLmN0aS1nb3YuZGsvb2Nlcy9pc3N1aW5nLzEvY3Js&#13;
    L2lzc3VpbmcuY3JsMB0GA1UdDgQWBBSVkuXJb5Td054/T6F0sIbTJm7MkjAOBgNVHQ8BAf8EBAMC&#13;
    BeAwQQYJKoZIhvcNAQEKMDSgDzANBglghkgBZQMEAgEFAKEcMBoGCSqGSIb3DQEBCDANBglghkgB&#13;
    ZQMEAgEFAKIDAgEgA4IBgQAJKLA11RSpBE+UO2iLl06PlMPOARixoU/3HPqGBPY0YRZvJ0iCUhMx&#13;
    vw/D/vlrk7wh37vkNLLrakau3d9Dcgkh2UUT9JBGy3JzFXQzOjrvaRfWCkY0jIZz945IgqEPjLXo&#13;
    7x+4e9FybtchHLdzkeg+O/n2uYezp8vkAUQJkJOWVQRZngKCADBdhfnqY/PYEO8S38QBMiS0ZWfC&#13;
    Ip+lrFCuKwOVgHZG16+KcSC6shbYYOurvsii6MAE0mFyCnpVmN4wtlbXaxsEreyQ2b2yTTocw24w&#13;
    Po0QBSPVH+wSfE7lQNHxJVEuFBcYUHhtWjhhYWnINmoBVWclZBAYE18m35vm/zrOyLzuYv79vTY/&#13;
    x1J/hPbsgos9D38Dj6Oc7m9BBuQhfS5bKU2ZsUINQgnypMveltm/6Qxc5cDTlrQp6c7/kxBcJTH3&#13;
    5qC4jIvaIB8v5npfpHCqaVPRj1LX6dFMB1dujqv9ME8yUVOTUHT8RPO/kgsxOdzhvBYRGmCU/7co&#13;
    vZk=</X509Certificate></X509Data></KeyInfo></Signature></AbonnementOpret>

Eksempel på svar:

    HTTP/1.1 200 OK

    <ns:AbonnementOpretSvar xmlns:ns="http://rep.oio.dk/tinglysning.dk/service/message/administration/1/" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:dsigModel="http://rep.oio.dk/tinglysning.dk/schema/model/1/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://rep.oio.dk/tinglysning.dk/service/message/administration/1/ http://rep.oio.dk/tinglysning.dk/service/message/administration/1/AbonnementOpretSvar.xsd"><ns1:AbonnementIdentifikator xmlns:ns1="http://rep.oio.dk/tinglysning.dk/schema/anmeldelse/1/">beb1d882-83bd-4e4f-bd01-921037113e46</ns1:AbonnementIdentifikator><Signature xmlns="http://www.w3.org/2000/09/xmldsig#" Id="ID25858289830701-ReplySignature"><SignedInfo Id="ID25858289830702-ReplySignatureInfo"><CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/><SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/><Reference URI=""><Transforms><Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/><Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/></Transforms><DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/><DigestValue>1ctv01VEhvbYp4r8XsemQXD36UM=</DigestValue></Reference><Reference Type="http://www.w3.org/2000/09/xmldsig#SignatureProperties" URI="#ID25858289830704-ReplySignatureProperty"><Transforms><Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/></Transforms><DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/><DigestValue>K8ghEBEwah+2xfWWxYE6os52c9k=</DigestValue></Reference></SignedInfo><SignatureValue> </SignatureValue><KeyInfo><X509Data><X509Certificate> </X509Certificate></X509Data></KeyInfo><Object Id="ID25858289830703-ReplySignatureObject"><SignatureProperties><SignatureProperty Id="ID25858289830704-ReplySignatureProperty" Target="#ID25858289830701-ReplySignature"><dsigModel:UnderskriftTidspunkt>2025-10-31T15:23:58</dsigModel:UnderskriftTidspunkt></SignatureProperty></SignatureProperties></Object></Signature></ns:AbonnementOpretSvar>

#### AbonnementSlet

Endpoint URL: `Abonnement/AbonnementSlet`

Beskrivelse | Sletter abonnementet på en enkelt ejendom. Som svar modtager man information om at abonnementet er inaktivt.
Input | AbonnementSlet.xsd
Output | AbonnementSletSvar.xsd
Fejlhåndtering | Hvis der sker fejl, f.eks. hvis ejendommen ikke findes, så sender e-TL en XML fejl. Hvis abonnementet allerede findes har kaldet ingen effekt.
Interaktionsmønster | Forespørgsel-svar

#### AbonnementStatus

Endpoint URL: `Abonnement/AbonnementStatus`

Beskrivelse | Anmoder om status på abonnement på en enkelt ejendom. Returnerer information om status på abonnement. Status fortæller om abonnementet er oprettet eller ej. Hvis abonnementet findes returneres dato for oprettelse.
Input | AbonnementStatus.xsd
Output | AbonnementStatusSvar.xsd
Fejlhåndtering |
Interaktionsmønster | Forespørgsel-svar