# Lånehistorik

3 af 3 understøttet
Kilde: https://plasapi.com/da/funktioner/patron/loan-history/

Lad lånerne se tilbage på hvad de har lånt, og selv bestemme hvad historikken indeholder.

## 2.8.1 Se lånehistorik — Understøttet

Vis det materiale låneren har lånt før.

### Det kan du bygge

En historik låneren kan bruge til at finde en titel igen eller huske hvad de har læst. Den gemmes kun når låneren har givet samtykke til det.

### Typisk flow

1. Klienten tjekker med `GetPatronConsents` om låneren har givet samtykket `loan_history`.
2. Uden samtykket kan klienten bede låneren om at give det (2.11.5).
3. Klienten henter historikken side for side med `GetPatronLoanHistory`.
4. Hver post vises med sin udgave og den dato den blev lånt eller afleveret.

### Det leverer API'et

- `before`, `offset` og `size` er påkrævet. `size` er mellem 1 og 50.
- Sortér efter `addedToHistoryTime` (standard) eller `dueDate`, i rækkefølgen `desc` (standard) eller `asc`.
- `addedToHistoryTime` er altid sat. `checkoutTime` og `checkinTime` er kun sat når de kendes.
- `manuallyAdded` fortæller om låneren selv har tilføjet posten (2.8.2).

### Kald i API'et

Forudsætter: 2.2.1

I denne rækkefølge

1. [GET /patron/{patronId}/consent](https://plasapi.com/da/provider/v0.6.7/patron/#GetPatronConsents) — Get patron consents
2. [GET /patron/{patronId}/loan-history](https://plasapi.com/da/provider/v0.6.7/patron-loan-history/#GetPatronLoanHistory) — Get patron loan history

## 2.8.2 Tilføj til lånehistorik — Understøttet

Lad låneren selv tilføje materiale til sin lånehistorik.

### Typisk flow

1. Låneren vælger en udgave, for eksempel på værksiden.
2. Klienten kalder `AddLoanToPatronLoanHistory` med `publicationId` og `manuallyAdded` sat til true.

### Det leverer API'et

- Er `patron.loanHistory.blockManuallyAddingLoans` i `GetConfiguration` true, forventes det at lånerne ikke må tilføje lån selv. Standard er false.
- `checkoutTime`, `checkinTime`, `dueDate` og `acquiredFrom` er valgfrie.

### Kald i API'et

Forudsætter: 2.2.1

Slås til i konfigurationen: `GetConfiguration`

- [POST /patron/{patronId}/loan-history](https://plasapi.com/da/provider/v0.6.7/patron-loan-history/#AddLoanToPatronLoanHistory) — Adds a loan to the patron's loan history

## 2.8.3 Fjern fra lånehistorik — Understøttet

Fjern en post låneren ikke vil have i sin lånehistorik.

### Typisk flow

1. Låneren vælger en post.
2. Klienten kalder `DeleteLoanFromPatronLoanHistory` med postens `id`.

### Det leverer API'et

- Id'et er lånehistorik-id'et fra `GetPatronLoanHistory`, ikke lånets id.

### Kald i API'et

Forudsætter: 2.2.1

- [DELETE /patron/{patronId}/loan-history/{loanHistoryId}](https://plasapi.com/da/provider/v0.6.7/patron-loan-history/#DeleteLoanFromPatronLoanHistory) — Delete loan from patron loan history