Lån

Det kan du bygge

Et overblik der får de lån der kræver handling, til at skille sig ud: overskredne, de der skal afleveres i dag, og de der snart skal. Hvert lån fortæller om det kan fornyes, så klienten kan tilbyde fornyelse ved siden af.

Typisk flow

1. Klienten henter lånene med GetPatronLoans.
2. Hvert lån vises med sin udgave og afleveringsdato, og klienten markerer lån der er overskredne eller snart skal afleveres.
3. Låneren åbner et lån for at se detaljerne eller forny det (2.4.3).

Det leverer API'et

• dueDate er den seneste dato lånet skal afleveres. createdTime er hvornår lånet blev foretaget.
• renew.state er renewable, not_renewable, renewable_later eller unknown. renew.count er hvor mange fornyelser der er tilbage, når det kendes.
• acquiredFrom fortæller om lånet kommer fra local_circulation eller et interlibrary_loan, eller er unknown.
• publicationMetadata er kun reservedata, til når provideren ikke kan levere udgaven gennem GetPublications, for eksempel ved fjernlån.

Det kan du bygge

Lånerne fornyer fra listen over lån eller fra selve lånet. Bliver en fornyelse afvist, giver svaret grunden, så klienten kan fortælle låneren hvorfor.

Typisk flow

1. Klienten læser renew.state for hvert lån fra GetPatronLoans.
2. Låneren vælger et lån der kan fornyes.
3. Klienten kalder RenewPatronLoan med lånets id.
4. Lykkes det, er svaret det fornyede lån med dets dueDate.

Det leverer API'et

• Tjek altid status i svaret: success eller en grund som too_many_renewals, reservation_blocked_renewal, renewal_blocked_by_fees, user_blocked eller denied.
• Et lån kan ikke fornyes når en anden låner har reserveret materialet. Nogle biblioteker tillader kun fornyelse et bestemt antal dage før afleveringsdatoen.
• RenewPatronLoan fornyer ét lån. Flere lån betyder ét kald pr. lån.