ISO ILL

ISO 18626 Details

Borrower Messages

Request

Message =request.

Header :

• supplyingAgencyId = requester ISO Symbol
• requestingAgencyId = lender ISO Sybmol
• timestamp
• requestingAgencyRequestId = request Id

bibliographicInfo

• As today. BibliographicItemIdCode is ISSN or ISBN or ISMN (http://illtransactions.org/opencode/)
• bibliographicRecordId is LCCN/OCLC/MID.

publicationInfo

• From today’s itemId relevant fields

ServiceInfo

• requestType – ‘New’ or ‘Retry’
• ServiceType – ‘Copy’ or ‘Loan’ or ‘CopyOrLoan’ if “Allow Other Format” is selected
• ServiceLevel – like the current level of service. Codes in http://illtransactions.org/opencode/
• Preferred format – code table should be enriched with values from http://illtransactions.org/opencode/. There should be a mapping of the old values to these values, with additional information sent as note in case old ISO is used. OI
• needBeforeDate – as today
• copyrightCompliance – a stoday
• anyEdition – Yes/No depending on ‘Specific Addition Only
• note – Request Note

supplierInfo – this will be used for IE and barcode- information obtained from the supplier’s record

• supplierCode – Institution code when sending IE or barcode
• supplierDescription – ‘IE’ or ‘barcode’
• bibliographicRecordId the IE or the barcode

requestedDeliveryInfo – the delivery address, using address/electronicAddress or address/physicalAddress. This is for ADD.

requestingAgencyInfo – The resource sharing library physical and electronic (email) address

patronInfo – if ‘share patron information is on’.

billingInfo – only the maximum costs from ‘Maximum Fee’

Received

Message = RequestingAgencyMessage with

• Header
• Action – “Received”
• note

Lender will respond with RequestingAgencyMessageConfirmation. The confirmationHeader is as in the request, and the messageStatus is OK. timestampReceived is the time the message was received (taken from its timestamp).

Action is “Received”

Returned

Message = RequestingAgencyMessage with

• Header
• Action – “ShippedReturned”
• note

Lender will respond with RequestingAgencyMessageConfirmation. The confirmationHeader is as in the request, and the messageStatus is OK. timestampReceived is the time the message was received (taken from its timestamp).

Action is “ShippedReturned”

Renew

Message = RequestingAgencyMessage with

• Header
• Action – “Renew”
• note

Action is “Renew”

Expired

Will be managed as borrower side triggered cancellation, as done for fulfillment network

Cancel

Message = RequestingAgencyMessage with

• Header
• Action – “Cancel”
• note

Action is “Cancel”

General Message

Message = RequestingAgencyMessage with

• Header
• Action – “Notification”
• note

Action is “Notification”

Lender Messages

Shipped

Message = supplyingAgencyMessage with

• Header
• MessageInfo
  • reasonforMessage – ‘RequestResponse’
  • note if filled in
  • reasonUnfilled – as per codes in http://illtransactions.org/opencode/. Code table should be adjusted and mapped to old ISO codes
• statusInfo
  • status = ‘Loaned’ or ‘CopyCompleted’ or ‘CompletedWithoutReturn’ as per format
  • dueDate – the due date
  • DeliveryInfo
    • dateSent
    • itemId – the barcode
    • sentToPatron Yes\No as per incoming request
    • deliveryCosts/monetaryValue – shipping costs
  • lastChange – timestamp

CheckedIn

Message = supplyingAgencyMessage with

• Header
• MessageInfo
  • reasonforMessage – ‘RequestResponse’
  • note if filled in
• statusInfo
  • status = ‘LoanCompleted’
  • lastChange – timestamp

reasonforMessage is RequestResponse

Overdue

Message = supplyingAgencyMessage with

• Header
• MessageInfo
  • reasonforMessage – ‘StatusChange’
  • note if filled in
• statusInfo
  • status = ‘Overdue’
  • lastChange – timestamp

reasonforMessage is StatusChange

Recall

Message = supplyingAgencyMessage with

• Header
• MessageInfo
  • reasonforMessage – ‘StatusChange’
  • note if filled in
• statusInfo
  • status = ‘Recalled’
  • lastChange – timestamp

reasonforMessage is StatusChange

RenewResponse

Message = supplyingAgencyMessage with

• Header
• MessageInfo
  • reasonforMessage – ‘RenewResponse’
  • note if filled in
  • AnswerYesNo – as per whether the renew is done or not.
• statusInfo
  • status = ‘Loaned’ or real status (such as ‘Loaned’) is cancellation failed.
  • dueDate – the due date
  • lastChange – timestamp

reasonforMessage is RenewResponse

Rejected

Message = supplyingAgencyMessage with

• Header
• MessageInfo
  • reasonforMessage – ‘RequestResponse’
  • note if filled in
  • reasonUnfilled – as per codes in http://illtransactions.org/opencode/. Code table should be adjusted and mapped to old ISO codes
• statusInfo
  • status = ‘Unfilled’
  • lastChange – timestamp

reasonforMessage is RequestResponse

Cancel Response

Message = supplyingAgencyMessage with

• Header
• MessageInfo
  • reasonforMessage – ‘CancelResponse’
  • note if filled in
  • aswwerYesNo – as per whether the cancallation is done or not.
• statusInfo
  • status = ‘Cancelled’ or real status (such as ‘Loaned’) is cancellation failed.
  • lastChange – timestamp

reasonforMessage is CancelResponse

Will Supply

Message = supplyingAgencyMessage with

• Header
• MessageInfo
  • reasonforMessage – ‘RequestResponse’
  • note if filled in
• statusInfo
  • status = ‘WillSupply’
  • lastChange – timestamp

reasonforMessage is RequestResponse

General message

Message = supplyingAgencyMessage with

• Header
• MessageInfo
  • reasonforMessage – ‘Notification’
  • note if filled in
• statusInfo
  • status = Real status (such as ‘Loaned’). One of:
    • RequestReceived
    • ExpectToSupply
    • WillSupply
    • Loaned
    • Overdue
    • Recalled
    • Unfilled
    • CopyCompleted
    • LoanCompleted
    • CompletedWithoutReturn
    • Cancelled
• lastChange – timestamp

reasonforMessage is Notification

Security and Privacy

Required Configuration in Alma

Required Configuration in the ILL system integrating with Alma