Reservationer

Det kan du bygge

Den centrale handling på et værk: låneren reserverer, vælger hvor materialet skal hentes, og ser sin plads i køen med det samme. Gebyrer og grænser kommer fra bibliotekssystemet, så klienten kan vise dem før låneren bekræfter.

Typisk flow

1. Låneren vælger en udgave. Klienten læser dens reserveId fra GetHoldings.
2. Klienten læser lånerens gebyr, grænser og afhentningssteder fra GetPatronConfiguration.
3. Låneren vælger hvor materialet skal hentes (2.5.8).
4. Klienten opretter reservationen med CreatePatronReservation.
5. Svaret er reservationen, inklusive lånerens queueNumber når den kendes.

Det leverer API'et

• En udgave uden reserveId kan ikke reserveres.
• Et reservationsgebyr har chargedAt: reservation (opkræves når der reserveres) eller checkout (opkræves ved afhentning). amount er i mindste møntenhed, currency i ISO 4217.
• Grænser for reservationer kommer som daily og max.

Det kan du bygge

Et overblik over alt låneren har reserveret: hvad der er klar til afhentning, hvad der står i kø, og hvad der er sat på pause.

Typisk flow

1. Klienten henter reservationerne med GetPatronReservations.
2. Hver reservation vises med sin tilstand og, når den kendes, pladsen i køen.

Det leverer API'et

• state er ready_for_pickup, in_queue eller postponed.
• queueNumber 1 betyder først i køen. Mangler feltet, er pladsen ukendt.
• fulfillmentBy fortæller hvordan reservationen opfyldes: local_circulation, interlibrary_loan, purchase eller unknown.

Det kan du bygge

Lånerne annullerer selv en reservation uden at skulle kontakte biblioteket.

Typisk flow

1. Låneren vælger en reservation og bekræfter annulleringen.
2. Klienten kalder DeletePatronReservation.

Typisk flow

1. Klienten viser afhentningsstederne fra GetLocations.
2. Låneren vælger et nyt.
3. Klienten opdaterer reservationen med UpdatePatronReservation.

Det leverer API'et

• UpdatePatronReservation ændrer kun pickupLocation.

Det kan du bygge

Reservationer på pause bliver stående i lånerens overblik, markeret som sat på pause.

Typisk flow

1. Låneren vælger en periode.
2. Klienten sætter reservation.postpone med UpdatePatronInformation.
3. Reservationer i perioden får tilstanden postponed.

Det leverer API'et

• Pausen gælder låneren, ikke den enkelte reservation.
• Perioden må være åben i den ene ende, for eksempel fra i dag uden slutdato.

Typisk flow

1. Klienten læser lånerens foretrukne afhentningssted fra GetPatronInformation (pickupLocation).
2. Låneren kan vælge et andet fra listen.
3. Det valgte sted sendes som pickupLocation med CreatePatronReservation.

Det leverer API'et

• Valgene kommer fra, i prioriteret rækkefølge: eksemplarets pickupLocations i GetHoldings, beholdningens pickupLocations, lånerens konfiguration (GetPatronConfiguration) og GetLocations.
• Hvert niveau erstatter niveauerne under sig helt. Definerer intet niveau afhentningssteder, kan materialet ikke reserveres.

Typisk flow

1. Personalet identificerer låneren.
2. Reservationen oprettes med CreatePatronReservation for den låner.

Det leverer API'et

• Specifikationen har ingen særskilt operation for personale og beskriver ingen måde at handle på lånerens vegne.