# Varsler

1 av 3 støttet
Kilde: https://plasapi.com/no/funksjoner/patron/notifications/

Gi lånerne beskjed når en reservasjon er klar, et lån skal leveres eller et gebyr forfaller, med hendelser biblioteksystemet sender til din backend.

## 2.9.1 Motta varsler — Støttet

Gi låneren beskjed når noe skjer med lånene, reservasjonene eller gebyrene deres.

### Dette kan du bygge

Påminnelser før et lån skal leveres og en beskjed så snart en reservasjon er klar til henting, som push-varsler eller i din egen innboks. Biblioteksystemet avgjør når en hendelse skjer; tjenesten din avgjør hvordan låneren ser den.

### Typisk flyt

1. Backenden din registrerer en URL og en hemmelighet med `RegisterEventReceiver`.
2. Låneren velger leveringsmetoden `vendor` for de varseltypene de vil ha (2.11.4). Klienten setter den med `UpdatePatronNotificationSettings`.
3. Når en hendelse skjer, sender biblioteksystemet den til URL-en din, beskrevet av `ReceiverEvents` i Vendor API.
4. Backenden din svarer `204` og gjør hendelsen om til et varsel til låneren.

### Dette leverer API-et

- Seks varseltyper er også hendelser: `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 hendelsene sendes bare når låneren har valgt `vendor` for typen, og backenden din har registrert en mottaker.
- Hver leverandør bør ha sin egen forekomst av leveringsmetoden `vendor` per låner, og bør bare se og oppdatere sin egen.
- `secret` må være minst 16 tegn, bør være tilfeldig generert og bør brukes av backenden din til å validere provideren. Registreres en tom `url`, fjernes mottakeren.
- Hver hendelse har `type`, `eventId` og `data`. I tillegg til varseltypene kan mottakeren få `consent_changed`, `patron_deleted`, `item_checkout` og `item_checkin`.

### Kall i API-et

I denne rekkefølgen

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

## 2.9.2 Vis varsler — Ikke ennå

Vis låneren varslene de har fått.

> Ikke i PLAS ennå. Funksjonen er ikke støttet i dag. Beskrivelsen viser hva den gjør, så du kan se sammenhengen med resten.

## 2.9.3 Fjern varsel — Ikke ennå

La låneren fjerne et varsel.

> Ikke i PLAS ennå. Funksjonen er ikke støttet i dag. Beskrivelsen viser hva den gjør, så du kan se sammenhengen med resten.