- Publishing of holdings information
- User authentication
- Availability check
- Create a borrowing request
- Resource sharing communication
Publishing of Holdings Information
Libraries have the option to update the Netpunkt ILL system of the materials they own. This is done by publishing the holdings information to Netpunkt. For more information regarding the publishing configuration options please refer to the Alma OLH.
When a patron places an order request for a specific material Netpunkt authenticates the user. This is done by sending an NCIP V.1 LookupUser message to the borrowing library. For more information regarding the NCIP V.1 specifications please refer to the Alma documentation.
Netpunkt checks with the lending library that the material requested by the patron is currently available for resource sharing. This is done by sending an SRU (ISO 20775) request to the lender to get its holdings information. For more information regarding the SRU (ISO 20775) specifications please refer to the Alma documentation.
Create a Borrowing Request
Netpunkt sends an OpenReceipt message to the borrowing library to create a borrowing request. Upon receiving the message in Alma the message is converted to a borrowing request based on the mapping table below. For more information regarding the integration configuration with Netpunkt please refer to the Alma OLH.
Resource sharing communication
Libraries can communicate with each other directly (P2P) or via Netpunkt. This is done by using the ISO 18626 protocol supported by Alma. For more information regarding the ISO 18626 standard please refer to the protocol documentation.
Mapping table of OpenReceipt tags to borrowing request fields
|OpenReceipt tag||Borrowing request field||Description|
|orderId||External ID||The order ID from Netpunkt/bibliotek. Alma generates the request ID.|
|userId||Requester||The primary identifier of the requesting user based on the User Identified Type.|
|requesterId||Owner||The resource sharing library code. Used only when there are more than one resource sharing library defined for the user.|
|author||Author||Author data (monographs) in orders without locations.|
|authorOfComponent||Author||Author of an journal article/part of work.|
|responderId||Partner||The lender partner code for the creation of lending request (only 1 can be supplied). If not supplied will be left empty.|
|callNumber||Call number||The call number of the book.|
|Boolean indication whether user wants a photocopy of an article or component. Default is false|
|mediumType||Requested media||A description of the requested media.|
Netpunkt media options will be added to the Additional requested media table.
|creationDate||Created date||Date of order received/created.|
|lastModification||Last modified date||last modification date.|
|language||Requested language||The requested language for the resource sharing request. Possible codes are the enabled fields in ResourceSharingLanguages. Default is null.|
|pickUpAgencyId||Pickup location||The pickup library code where the resource will be delivered to. Mandatory for physical format delivery. Optional for digital format.|
|needBeforeDate||Last interest date||Last date the request is needed. Optional parameter.|
|title/titleOfComponent||Title||Title of the requested resource. Mandatory parameter.|
|issn||ISSN||ISSN of the requested resource.|
|isbn||ISBN||ISBN of the requested resource.|
|publicationDate/ publicationDateOfComponent||Year||Year of publication of the requested resource.|
|publisher||Publisher||Publisher of the requested resource.|
|placeOfPublication||Place of publication||The publication place of the requested resource.|
|edition||Edition||The edition of the requested resource.|
|volume||Volume||The volume number of the journal that contains the article.|
|issue||Issue||The issue of the requested resource.|
|pagination||Pages||The relevant pages of the requested resource.|
The borrowing request in Alma is either of the types Article or Book. As suggested by DBC the bibliographicCategory element on the OrderReceipt message contains either of the two values:
- mono – for monographic material (book, music, etc)
- peri – for periodical material (journals, articles, etc)
based on the above options the resource sharing request type will be, Article (“peri”) or Book (“mono”).