# Notifikationer

1 af 3 understøttet
Kilde: https://plasapi.com/da/funktioner/patron/notifications/

Giv lånerne besked når en reservation er klar, et lån skal afleveres eller et gebyr forfalder, med hændelser bibliotekssystemet sender til din backend.

## 2.9.1 Modtag notifikationer — Understøttet

Giv låneren besked når der sker noget med deres lån, reservationer eller gebyrer.

### Det kan du bygge

Påmindelser før et lån skal afleveres og en besked så snart en reservation er klar til afhentning, som push-notifikationer eller i din egen indbakke. Bibliotekssystemet afgør hvornår en hændelse sker; din tjeneste afgør hvordan låneren ser den.

### Typisk flow

1. Din backend registrerer en URL og en hemmelighed med `RegisterEventReceiver`.
2. Låneren vælger leveringsmetoden `vendor` for de notifikationstyper de vil have (2.11.4). Klienten sætter den med `UpdatePatronNotificationSettings`.
3. Når en hændelse sker, sender bibliotekssystemet den til din URL, beskrevet af `ReceiverEvents` i Vendor API.
4. Din backend svarer `204` og laver hændelsen om til en notifikation til låneren.

### Det leverer API'et

- Seks notifikationstyper er også hændelser: `reservation_ready_for_pickup`, `ready_reservation_expires_soon`, `reservation_expires_soon`, `reservation_reminder`, `loan_due_date_is_approaching` og `fee_due_date_is_approaching`.
- De seks hændelser sendes kun når låneren har valgt `vendor` for typen, og din backend har registreret en modtager.
- Hver leverandør bør have sin egen forekomst af leveringsmetoden `vendor` pr. låner og bør kun se og opdatere sin egen.
- `secret` skal være mindst 16 tegn, bør være tilfældigt genereret og bør bruges af din backend til at validere provideren. Registreres en tom `url`, fjernes modtageren.
- Hver hændelse har `type`, `eventId` og `data`. Ud over notifikationstyperne kan modtageren få `consent_changed`, `patron_deleted`, `item_checkout` og `item_checkin`.

### Kald i API'et

I denne rækkefølge

1. [POST /configuration/event/register/receiver](https://plasapi.com/da/provider/v0.6.7/configuration/#RegisterEventReceiver) — Register an event receiver
2. [PATCH /patron/{patronId}/notification-settings](https://plasapi.com/da/provider/v0.6.7/patron/#UpdatePatronNotificationSettings) — Update one or more patron notification settings
3. [POST /events/receiver](https://plasapi.com/da/vendor/v0.6.7/event/#ReceiverEvents) — Receives events from an LMS

## 2.9.2 Vis notifikationer — Ikke endnu

Vis låneren de notifikationer de har modtaget.

> Ikke i PLAS endnu. Funktionen er ikke understøttet i dag. Beskrivelsen viser hvad den gør, så du kan se sammenhængen med resten.

## 2.9.3 Fjern notifikation — Ikke endnu

Lad låneren fjerne en notifikation.

> Ikke i PLAS endnu. Funktionen er ikke understøttet i dag. Beskrivelsen viser hvad den gør, så du kan se sammenhængen med resten.