Reservasjoner

Dette kan du bygge

Den sentrale handlingen på et verk: låneren reserverer, velger hvor materialet skal hentes, og ser plassen sin i køen med en gang. Gebyrer og grenser kommer fra biblioteksystemet, så klienten kan vise dem før låneren bekrefter.

Typisk flyt

1. Låneren velger en utgave. Klienten leser reserveId fra GetHoldings.
2. Klienten leser lånerens gebyr, grenser og hentesteder fra GetPatronConfiguration.
3. Låneren velger hvor materialet skal hentes (2.5.8).
4. Klienten oppretter reservasjonen med CreatePatronReservation.
5. Svaret er reservasjonen, inkludert lånerens queueNumber når den er kjent.

Dette leverer API-et

• En utgave uten reserveId kan ikke reserveres.
• Et reservasjonsgebyr har chargedAt: reservation (belastes når det reserveres) eller checkout (belastes ved henting). amount er i minste myntenhet, currency i ISO 4217.
• Grenser for reservasjoner kommer som daily og max.

Dette kan du bygge

En oversikt over alt låneren har reservert: hva som er klart til henting, hva som står i kø, og hva som er satt på pause.

Typisk flyt

1. Klienten henter reservasjonene med GetPatronReservations.
2. Hver reservasjon vises med tilstanden sin og, når den er kjent, plassen i køen.

Dette leverer API-et

• state er ready_for_pickup, in_queue eller postponed.
• queueNumber 1 betyr først i køen. Mangler feltet, er plassen ukjent.
• fulfillmentBy forteller hvordan reservasjonen oppfylles: local_circulation, interlibrary_loan, purchase eller unknown.

Dette kan du bygge

Lånerne kansellerer selv en reservasjon uten å måtte kontakte biblioteket.

Typisk flyt

1. Låneren velger en reservasjon og bekrefter kanselleringen.
2. Klienten kaller DeletePatronReservation.

Typisk flyt

1. Klienten viser hentestedene fra GetLocations.
2. Låneren velger et nytt.
3. Klienten oppdaterer reservasjonen med UpdatePatronReservation.

Dette leverer API-et

• UpdatePatronReservation endrer bare pickupLocation.

Dette kan du bygge

Reservasjoner på pause blir stående i lånerens oversikt, merket som satt på pause.

Typisk flyt

1. Låneren velger en periode.
2. Klienten setter reservation.postpone med UpdatePatronInformation.
3. Reservasjoner i perioden får tilstanden postponed.

Dette leverer API-et

• Pausen gjelder låneren, ikke den enkelte reservasjonen.
• Perioden kan være åpen i den ene enden, for eksempel fra i dag uten sluttdato.

Typisk flyt

1. Klienten leser lånerens foretrukne hentested fra GetPatronInformation (pickupLocation).
2. Låneren kan velge et annet fra listen.
3. Det valgte stedet sendes som pickupLocation med CreatePatronReservation.

Dette leverer API-et

• Valgene kommer fra, i prioritert rekkefølge: eksemplarets pickupLocations i GetHoldings, beholdningens pickupLocations, lånerens konfigurasjon (GetPatronConfiguration) og GetLocations.
• Hvert nivå erstatter nivåene under seg helt. Definerer ingen nivåer hentesteder, kan materialet ikke reserveres.

Typisk flyt

1. De ansatte identifiserer låneren.
2. Reservasjonen opprettes med CreatePatronReservation for den låneren.

Dette leverer API-et

• Spesifikasjonen har ingen egen operasjon for ansatte og beskriver ingen måte å handle på lånerens vegne.