Udlån og aflevering

Det kan du bygge

Udlån på en selvbetjeningsautomat, ved personaleskranken eller på lånerens egen telefon, med RFID eller stregkode. Har et lån betingelser, for eksempel et udlånsgebyr, accepterer låneren dem i samme flow. En automat kan blive ved med at låne ud, mens bibliotekssystemet ikke kan nås, og registrere lånene bagefter.

Typisk flow

1. Låneren identificeres, enten ved at logge ind (2.2.1) eller med sit kortnummer og, hvor det kræves, en adgangskode.
2. Eksemplaret scannes, og klienten kalder Checkout med eksemplarets ID, låneren, filialen og tidspunktet hvor låneren handlede.
3. Er status needs_acknowledgement, viser klienten låneren hver post i acknowledgement.conditions.
4. Når låneren accepterer, sender klienten samme udlån igen med acknowledgement.code.
5. Er status completed, indeholder checkout lånet, inklusive dueDate. Er den failed, siger reason hvorfor.

Det leverer API'et

• Klienten skal finde circulation.checkout.isEnabled sat til true i GetConfiguration, før den kalder Checkout.
• Når forespørgslen er forstået, er svaret 200. Udfaldet står i status: completed, needs_acknowledgement eller failed. Et ukendt eksemplar er failed med item_not_found, ikke 404.
• En betingelse er et lending_fee (med amount og currency), previously_checked_out (låneren har haft titlen før) eller en message der skal accepteres. Én code dækker dem alle. Den kan bruges én gang og udløber ved expiresAt.
• Årsager til failed er blandt andre item_not_lendable, item_on_loan, item_reserved_for_other_patron, patron_blocked, patron_owes_fees, patron_loan_limit_reached, patron_expired og acknowledgement_rejected. Behandl en ukendt årsag som unknown, og vis message.
• En låner der identificeres med kortnummer, får patron_authentication_failed ved ethvert problem med identiteten, så ingen kan finde ud af hvilke kortnumre der findes.
• Det er sikkert at sende samme udlån igen. Har låneren allerede eksemplaret, er svaret completed med det lån.
• Offline: med circulation.checkout.offline.isAllowed kan en automat sende checkout.offline med den dueDate den gav låneren. Låneren skal identificeres med kortnummer, og defaultLoanPeriodDays giver den låneperiode der skal bruges.
• message.text vises for låneren. Send ui_language for at vælge sproget.

Det kan du bygge

Aflevering på en selvbetjeningsautomat, et sorteringsanlæg eller ved personaleskranken. Svaret fortæller hvor eksemplaret hører hjemme, og om en medarbejder skal se på det, så et sorteringsanlæg kan sende det videre med det samme.

Typisk flow

1. Eksemplaret scannes, og klienten kalder Checkin med eksemplarets ID, filialen og tidspunktet for afleveringen.
2. Er status completed, indeholder checkin resultatet. Er den failed, siger reason hvorfor.
3. Eksemplaret sorteres efter permanentLocation, sortingCode og needsStaff.

Det leverer API'et

• Klienten skal finde circulation.checkin.isEnabled sat til true i GetConfiguration, før den kalder Checkin.
• Når forespørgslen er forstået, er svaret 200. De kendte årsager til failed er item_not_found, item_not_on_loan, item_belongs_to_other_library og unknown. Behandl en anden årsag som unknown, og vis message.
• permanentLocation er hvor eksemplaret normalt står: et eksemplar der hører til en anden filial, sendes dertil. needsStaff er true når en medarbejder skal se på eksemplaret, for eksempel fordi det er beskadiget.
• sortingCode bærer providerens egen sorteringsværdi, aftalt mellem biblioteket, provideren og leverandøren af sorteringsanlægget.
• fees viser gebyrer afleveringen skabte, for eksempel et gebyr for overskredet afleveringsdato.
• Det er sikkert at sende samme aflevering igen: item_not_on_loan ved et nyt forsøg betyder at eksemplaret allerede er tilbage.
• Offline: med circulation.checkin.offline.isAllowed kan en automat sende checkin.offline sat til true for en aflevering den allerede har taget imod.
• securityTags.isDisabled i GetConfiguration fortæller om biblioteket bruger alarmmærker. Gør det ikke, bør klienten ikke aktivere dem ved aflevering.