# e-Tinglysning - WSDL for Abonnement

## Abonnement

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.

### Roller

Responsible: | Tinglysningsrettens' udviklingsleverandør
Accountable: | Tinglysningsretten
Consulted: | System-til-System brugere, Tinglysningsrettens portal udviklingsteam
Informed: | OIO

## Targetnamespace

http://rep.oio.dk/tinglysning.dk/service/interface/administration/1/

## Inkluderer

- ../../../message/administration/1/AbonnementOpret.xsd - http://rep.oio.dk/tinglysning.dk/service/message/administration/1/
- ../../../message/administration/1/AbonnementOpretSvar.xsd - http://rep.oio.dk/tinglysning.dk/service/message/administration/1/
- ../../../message/administration/1/AbonnementStatus.xsd - http://rep.oio.dk/tinglysning.dk/service/message/administration/1/
- ../../../message/administration/1/AbonnementStatusSvar.xsd - http://rep.oio.dk/tinglysning.dk/service/message/administration/1/
- ../../../message/administration/1/AbonnementSlet.xsd - http://rep.oio.dk/tinglysning.dk/service/message/administration/1/
- ../../../message/administration/1/AbonnementSletSvar.xsd - http://rep.oio.dk/tinglysning.dk/service/message/administration/1/

## Beskeder

- AbonnementOpretRequest - admmsg:AbonnementOpret
- AbonnementOpretResponse - admmsg:AbonnementOpretSvar
- AbonnementStatusRequest - admmsg:AbonnementStatus
- AbonnementStatusResponse - admmsg:AbonnementStatusSvar
- AbonnementSletRequest - admmsg:AbonnementSlet
- AbonnementSletResponse - admmsg:AbonnementSletSvar

## Operationer

PortType: Abonnement

### Operation 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 | admifc:AbonnementOpretRequest
Output | admifc:AbonnementOpretResponse
Fejlhåndtering | Hvis der sker fejl, f.eks. hvis ejendommen ikke findes, så sender e-TL en SOAP fejl. Hvis abonnementet allerede findes har kaldet ingen effekt.
Interaktionsmønster | Forespørgsel-svar

### Operation AbonnementSlet

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

### Operation 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 | admifc:AbonnementStatusRequest
Output | admifc:AbonnementStatusResponse
Fejlhåndtering |
Interaktionsmønster | Forespørgsel-svar