ILL (Interlibrary loan) requests

The ILL (Interlibrary loan) requests module adds the ability to request and manage loans or copies of material from external sources. Patrons can submit a request via the OPAC from the Interlibrary loan requests tab of their account. Library staff can then review and process those requests. Alternatively, staff can place requests themselves from the staff interface.

Bemerkung

Nur Bibliothekspersonal mit der Berechtigung ill (oder der superlibrarian-Berechtigung) sind in der Lage, Fernleihaufträge zu erstellen und zu verwalten.

Konfiguration

Before using the ILL requests module, you will want to make sure that you have reviewed all ILL-related configuration.

The ILL requests module can be configured for different types of requests and workflows. Koha uses ‚backends‘ to process ILL requests depending on how the document should be supplied. Currently available backends are documented on the Koha community wiki at https://wiki.koha-community.org/wiki/ILL_backends. Some backends are available as plugins. You will need to configure at least one backend.

Achtung

As of version 24.11, Koha has a default backend known as ‚Standard‘, which replaces the FreeForm backend. The ILL module can be used solely with the Standard backend.

Next, set your system preferences for interlibrary loans. The most important one is the ILLModule system preference, the master switch for the ILL module.

In patron categories, choose which patron categories can place ILL requests from the OPAC.

Version

Vor Version 23.11 ist dies nicht erforderlich. Alle Benutzertypen können Fernleihbestellungen über den OPAC aufgeben.

Ab Version 23.11 müssen Sie die Option für jeden Benutzertyp definieren.

Das Fernleihmodul verwendet vom System voreingestellte Status. Sie können eigene, auf Ihren Fernleih-Workflow abgestimmte Status als ILL_STATUS_ALIAS authorized values definieren.

Finally, library staff responsible for ILL requests need the ill permission (or the superlibrarian permission).

E-Mail-Benachrichtigungen für die Fernleihe

Email notifications can be sent to library staff when a patron makes a request to modify (notice code: ILL_REQUEST_MODIFIED) or cancel (notice code: ILL_REQUEST_CANCEL) an existing request. Enable this feature using the ILLSendStaffNotices system preference.

The ILL staff email address can be configured per library in the Libraries settings. If there is no email for a library, the address in the ILLDefaultStaffEmail system preference will be used.

Notifications can be sent to patrons for updates on their requests:

  • ILL request update (notice code: ILL_REQUEST_UPDATE)

  • ILL request unavailable (notice code: ILL_REQUEST_UNAVAIL)

  • ILL request ready for pickup (notice code: ILL_PICKUP_READY)

The notifications are enabled from the patron categories default patron messaging preferences.

All notice templates can be customized in the Notices and slips tool.

Fernleihbestellungen anlegen

Pfad in Koha: Mehr > Fernleihbestellungen

Die Schaltfläche „Neue Fernleihbestellung“ ist angeklickt; ein Menü zur Auswahl eines Backends wird angezeigt, das die Optionen BLDSS und FreeForm enthält.

  • Wählen Sie ‚Neue Fernleihbestellung‘ und dann Freeform.

Bemerkung

Die hier gezeigten Bilder beziehen sich nur auf das FreeForm-Backend.

Neue Seite für Fernleihbestellungen, ohne Auswahl des Anfragetyps, mit einem Bereich zum Hinzufügen von benutzerdefinierten Feldern und einem weiteren für Benutzeroptionen.

  • Wählen Sie einen Exemplartyp: Buch, Kapitel, Zeitschrift, Zeitschriftenartikel, Dissertation, Konferenzbeitrag, sonstiges, allgemeine Ressource.

  • Jeder Exemplartyp verfügt über einen spezifischen Satz an Beschreibungsfeldern.

Der obere Teil der neuen Seite für Fernleihbestellungen wird angezeigt, mit dem Typ „Buch“ ausgewählt; ein Bereich für Buchdetails wird angezeigt.

  • Geben Sie so viele Informationen ein, wie Sie möchten.

  • Fügen Sie benutzerdefinierte Felder hinzu, z. B. wenn Sie eine Notiz hinzufügen möchten oder wenn Sie den Bestelltyp „Sonstige“ verwenden.

  • Geben Sie im Bereich der Benutzeroptionen die Nummer des Bibliotheksausweises an und an welche Bibliothek die Bestellung geschickt werden soll.

Klicken Sie auf „Neu“ und Sie sehen eine Detailansicht für die Fernleihbestellung.

Bemerkung

Wenn Sie den Systemparameter ILLCheckAvailability aktiviert und die entsprechenden Plugins in der Dienstoberfläche installiert haben, erhalten Sie Suchergebnisse. Der Benutzer kann dann einen relevanten Treffer auswählen oder mit der Fernleihbestellung fortfahren. Wenn keine Treffer gefunden wurden, wird die Fernleihbestellung in der üblichen Weise durchgeführt.

Sie können nun die Fernleihbestellungen verwalten oder durch Klicken auf „List requests“ zur Liste der Fernleihanfragen zurückkehren.

Fernleihbestellungen anzeigen

From the main ILL requests screen you can view, filter and sort your ILL requests.

Click on the ‘List requests’ button from other pages in the ILL module to return to this list.

Teil der Homepage des Fernleih-Moduls mit einer Liste von Fernleihbestellungen.

Tipp

You can customize this view.

There is a large amount of data available in the table; scroll right to see all the columns. You can define which columns are visible / hidden by default in the Table settings section of the Administration module (table id: ill-requests).

Use the filters on the left of the page to display a subset of requests based on your chosen criteria.

Filter für Fernleihbestellungen; zeigt Optionen für Schlagwort, Status, Datum der Bestellung zwischen, Aktualisierung zwischen, Bibliothek, Nutzer.

Fernleihbestellungen verwalten

From the main ILL requests view, click on a request ID in the first column or on the ‚Manage request‘ button in the final column. The request’s full details are displayed.

On the Manage ILL request page, we can see a row of buttons: Edit request; Confirm request; PLace request with partners; Delete request; Edit item metadata; Send notice to patron; Display supplier metadata; ILL request log. Below are the Request details with some of the following values: Patron = Sam Page ; Library = Ada Lovelace Library; Status = New request; Last updated; Request type = thesis; Author; Institution; Publication date; Title. At the bottom is a section to add comments.

Depending on the current status of the request and the backend used, you may see some or all of the buttons described in the next section.

From this screen, you can add comments to the request. You may want to use comments to keep track of work undertaken. Comments are read-only (they cannot be edited or deleted). They are only visible in the staff interface. If any comments have been added to a request, a number will appear in the ‚Comments‘ column when viewing the full list of ILL requests.

Authenticated requests

Authenticated requests are requests linked to the Koha patron who requested the document. All requests placed in the staff interface or placed on the OPAC by patrons logged in to their account are authenticated requests.

New authenticated requests have the status ‚New request‘. Staff can progress the requests straightaway by using some of the following buttons.

  • Edit request: to update the patron the request is associated with, which staff member is managing the request, the destination library.

    On the Edit request page, the Request details form includes the following fields and values: Patron ID = 13; Bibliographic record ID; Library = Ada Lovelace Library; Status = New request; Last updated = 10/04/2026 15:03; Request type = thesis; Cost = N/A; Price paid; Request ID = 4; Staff notes; OPAC notes.

    • OPAC and staff-only notes can be added from the edit screen.

    • If you have custom ILL statuses (managed through the ILL_STATUS_ALIAS authorized values category) you can apply one by editing the Status field.

  • Confirm request: to manually mark the request as ‚Requested‘.

  • Place request with partners: for Koha to send a request to supply to a library. Using this option requires some prior configuration. The request status is then updated to ‚Requested from partners‘.

    On the Place request with partner libraries page, we can see fields for: Filter partner libraries; Select partner libraries; Subject line; Email text. Underneath is a button labelled Send email.

    • Filter partner libraries: type keywords to narrow down the list of accounts displayed in the next field.

    • Select partner libraries: choose a recipient from the list of your ILL partners. Each account’s library code is shown in capital letters before the account name.

    • Subject line: you can customize the subject line of the email Koha will send.

    • Email text: you can customize the text of the email Koha will send.

    Bemerkung

    The default subject line and email text used here are defined in the ILL_PARTNER_REQ notice template in the Notices and slips tool.

  • Delete request: to fully delete the request. Details of deleted requests are not retained in the Koha database.

  • Edit item metadata: to update the metadata (title, author, etc.) for the title requested. This is useful when the information provided initially is incomplete or incorrect.

    Bemerkung

    Some backends may not allow updates to the metadata.

  • Send notice to patron: to send an update to the patron requesting the title.

    • ILL request ready for pickup: to alert the patron that their requested item is ready for collection. You can customize the notice text in the ILL_PICKUP_READY notice template in the Notices and slips tool.

    • ILL request unavailable: to inform the patron that your library will not be able to supply the requested title. You can customize the notice text in the ILL_REQUEST_UNAVAIL notice template in the Notices and slips tool.

  • Display supplier metadata: to view a text-only version of the details of the title requested. This may be useful in the cases where you need to quickly copy and paste this information outside of Koha.

  • ILL request log: to view a history of the actions on this request. For any information to be displayed here, the IllLog system preference needs to be set to ‚Log‘.

    Request log showing entries for status changed and patron notice sent. For each entry, we see the date, time, name and card number of the user who performed the action, type of action and details. For example, the first entry reads: '03/06/2026 09:13 : Clara Birchwood (20001037) - Status changed: From "Requested from partners" to "Checked out".'

Other buttons you may see as you progress the request:

  • Switch provider: to select a different backend and request the title from another provider. This is useful when the the wrong backend was initially selected or when the provider has indicated they are unable to supply.

  • Revert request: to cancel the request placed with an external source. This button is visible when the request has a status of ‚Requested‘ or ‚Requested from partners‘. The status is updated to ‚Request reverted‘.

  • Check out: to checkout the item supplied by a partner library directly to the patron who placed the request. The request status is updated to ‚Checked out‘.

  • Mark completed: to update the status to ‚Completed‘ when the request has been fulfilled and fully processed.

Unauthenticated requests

If the ILLOpacUnauthenticatedRequest system preference is set to ‚Allow‘, patrons can place requests without being logged in or without having an account.

Version

This feature was first introduced in version 25.05 of Koha.

Requests placed in this way have the status ‚Unauthenticated‘. Before they can be progressed, you need to link it to a patron record.

  1. From the main ILL requests view, identify a request with the status ‚Unauthenticated‘.

  2. Click on the request ID in the first column or on the ‚Manage request‘ button in the final column to view the request’s full details.

  3. Click the ‚Edit request‘ button.

  4. The Unauthenticated request details section shows the details entered by the patron who placed the request. Use this to search for an existing patron.

    1. The ‚Patron ID‘ field at the top of the page can be used as a patron quick search. Start typing the patron name to see suggestions.

      On the Edit request page, the Request details form includes the following fields and values: Patron ID = sam (underneath are two suggestions for patrons Sam Hawkins and Sam Page); Managed by; Bibliographic record ID = 440; Library = Riverside; Status = Unauthenticated; Last updated = 05/29/2026 12:26; Request type = book; Cost = N/A; Price paid; Request ID = 2; Staff notes; OPAC notes. Underneath is a section for Unauthenticated request details, displaying the following information: First name = Sam; Last name = Page; Email = sam.page@unauth.ill

    2. Alternatively, you can open the Patrons module in another browser tab and perform your search there.

    Warnung

    If the patron who placed the unauthenticated request is not yet a library member, you will need to add a new patron record for them before progressing the ILL request.

  5. Whether you are searching a patron by name in the Patron ID field or pasting their card number in the field, you will need to select the correct patron from the suggestions. The field will then update to display the borrowernumber.

  6. Click ‚Submit‘ to save your changes.

You can now manage the request in the same way as for other authenticated requests. The Unauthenticated request details section will stop displaying as it is not an unauthenticated request anymore.

Bestellstatus

Koha has a set of core ILL statuses, listed below (with status codes as stored in the illrequests table). Installed backends may use additional statuses.

  • Neue Bestellung (NEW)

  • Unauthenticated (UNAUTH)

  • Angefragt (REQ)

  • Von Partnern angefordert (GENREQ)

  • Bestellung zurückgesetzt (REQREV)

  • Stornierung gewünscht - ein Benutzer hat vom OPAC ausgehend die Stornierung der Fernleihbestellung beantragt. (CANCREQ)

  • Abgeschlossen (COMP)

  • Ausgeliehen (CHK)

  • Zurückgegeben (RET)

Bestellung bei Fernleihpartnern

Wenn Sie über ein Netzwerk von Partnerbibliotheken verfügen, die Fernleihbestellungen zulassen, können Sie diese über Koha verwalten. Zunächst müssen Sie Konten Ihrer Partnerbibliotheken anlegen:

  • Benutzertyp anlegen, der den Partnerbibliotheken zugewiesen wird. Geben Sie dem Benutzertyp die Bezeichnung „Fernleihe“ oder „Bibliothek“ und den Kategorietyp „Organisation“. Geben Sie dann diese Kategorie im Systemparameter ILLPartnerCode ein.

    Version

    Der Systemparameter ILLPartnerCode wurde in Version 23.11 hinzugefügt. In früheren Versionen wurde der Partnercode in der Datei koha-conf.xml definiert.Der Standardcode war ‚IL‘.

  • Für jede Partnerbibliothek müssen Sie nun ein Benutzerkonto mit diesem Benutzertyp anlegen.

  • Für jede Bibliothek muss eine E-Mail-Adresse erfasst werden, damit die Fernleihbestellung verschickt werden kann.

Bemerkung

Das Template für die Benachrichtigung ist „ILL_PARTNER_REQ“ und der Text kann über Benachrichtigungen und Quittungen im Modul „Werkzeug“ angepasst werden.

Sie können dann die „Bestellung bei Fernleihpartnern“-Option verwenden, wenn Sie Bestellungen bearbeiten.

Bemerkung

Wenn Sie den Systemparameter ILLCheckAvailability aktiviert haben, können Sie Plugins verwenden, um vor der Bestätigung der Bestellung mit Z9.50 in den Katalogen Ihrer Fernleihpartner zu suchen.

Ausleihe von Fernleihen

Wenn Sie den Systemparameter CirculateILL aktiviert haben, können Sie Fernleihexemplare direkt aus der Fernleihbestellung heraus ausleihen.

Wenn Sie eine Fernleihbestellung für ein Buch anlegen, wird automatisch eine Schnellaufnahme basierend auf dem MARC-Framework für Schnellaufnahmen (FA) angelegt. Sobald die Bestellung den passenden Status erreicht, wird eine Schaltfläche „Ausleihe“ in der Werkzeugleiste für die Fernleihbestellung angezeigt. Über diese ist es möglich das Medium an den Besteller oder an einen statistischen Benutzer auszuleihen.

Um ein Exemplare auszuleihen:

  • Klicken Sie auf die Schaltfläche „Ausleihe“.

  • Wählen Sie einen Exemplartyp aus, wenn Sie dazu aufgefordert werden. Es wird automatisch ein Exemplar angelegt und an den biblio-Datensatz der Bestellung angehängt. Der Barcode des Exemplars hat das Format ILL-requestid.

  • Wählen Sie dann auf dem Ausleihbildschirm für den Benutzer ein Fälligkeitsdatum aus. Wenn Sie kein Fälligkeitsdatum auswählen, wird die entsprechende Ausleihregel zur Berechnung des Fälligkeitsdatums verwendet.

  • Sobald das Exemplare ausgeliehen wurde, ändert sich der Status der Bestellung auf „Ausgeliehen“, nach der Rückgabe dann automatisch auf „Zurückgegeben“.

  • Titeldatensätze die als Teil einer Fernleihbestellung angelegt wurden, haben einen zusätzlichen Reiter in der Exemplartabelle über den zurück auf die Fernleihbestellung im Fernleihmodul verlinkt wird.