Utlån og innlevering

Dette kan du bygge

Utlån på en selvbetjeningsautomat, ved personalskranken eller på lånerens egen telefon, med RFID eller strekkode. Har et lån vilkår, for eksempel et utlånsgebyr, godtar låneren dem i samme flyt. En automat kan fortsette å låne ut mens biblioteksystemet ikke kan nås, og registrere lånene etterpå.

Typisk flyt

1. Låneren identifiseres, enten ved å logge inn (2.2.1) eller med kortnummeret sitt og, der det kreves, et passord.
2. Eksemplaret skannes, og klienten kaller Checkout med eksemplarets ID, låneren, filialen og tidspunktet da låneren handlet.
3. Er status needs_acknowledgement, viser klienten låneren hver post i acknowledgement.conditions.
4. Når låneren godtar, sender klienten det samme utlånet igjen med acknowledgement.code.
5. Er status completed, inneholder checkout lånet, inkludert dueDate. Er den failed, sier reason hvorfor.

Dette leverer API-et

• Klienten må finne circulation.checkout.isEnabled satt til true i GetConfiguration før den kaller Checkout.
• Når forespørselen er forstått, er svaret 200. Utfallet står i status: completed, needs_acknowledgement eller failed. Et ukjent eksemplar er failed med item_not_found, ikke 404.
• Et vilkår er et lending_fee (med amount og currency), previously_checked_out (låneren har hatt tittelen før) eller en message som må godtas. Én code dekker alle. Den kan brukes én gang og utløper ved expiresAt.
• Årsaker til failed er blant annet 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. Behandle en ukjent årsak som unknown, og vis message.
• En låner som identifiseres med kortnummer, får patron_authentication_failed ved ethvert problem med identiteten, så ingen kan finne ut hvilke kortnumre som finnes.
• Det er trygt å sende det samme utlånet igjen. Har låneren allerede eksemplaret, er svaret completed med det lånet.
• Offline: med circulation.checkout.offline.isAllowed kan en automat sende checkout.offline med den dueDate den ga låneren. Låneren må identifiseres med kortnummer, og defaultLoanPeriodDays gir låneperioden som skal brukes.
• message.text vises for låneren. Send ui_language for å velge språket.

Dette kan du bygge

Innlevering på en selvbetjeningsautomat, et sorteringsanlegg eller ved personalskranken. Svaret forteller hvor eksemplaret hører hjemme, og om en ansatt må se på det, så et sorteringsanlegg kan sende det videre med en gang.

Typisk flyt

1. Eksemplaret skannes, og klienten kaller Checkin med eksemplarets ID, filialen og tidspunktet for innleveringen.
2. Er status completed, inneholder checkin resultatet. Er den failed, sier reason hvorfor.
3. Eksemplaret sorteres etter permanentLocation, sortingCode og needsStaff.

Dette leverer API-et

• Klienten må finne circulation.checkin.isEnabled satt til true i GetConfiguration før den kaller Checkin.
• Når forespørselen er forstått, er svaret 200. De kjente årsakene til failed er item_not_found, item_not_on_loan, item_belongs_to_other_library og unknown. Behandle en annen årsak som unknown, og vis message.
• permanentLocation er der eksemplaret vanligvis står: et eksemplar som hører til en annen filial, sendes dit. needsStaff er true når en ansatt må se på eksemplaret, for eksempel fordi det er skadet.
• sortingCode bærer providerens egen sorteringsverdi, avtalt mellom biblioteket, provideren og leverandøren av sorteringsanlegget.
• fees viser gebyrer innleveringen skapte, for eksempel et gebyr for for sen levering.
• Det er trygt å sende den samme innleveringen igjen: item_not_on_loan ved et nytt forsøk betyr at eksemplaret allerede er tilbake.
• Offline: med circulation.checkin.offline.isAllowed kan en automat sende checkin.offline satt til true for en innlevering den allerede har tatt imot.
• securityTags.isDisabled i GetConfiguration forteller om biblioteket bruker alarmbrikker. Gjør det ikke det, bør klienten ikke aktivere dem ved innlevering.