When using NCIP to interact with a library management system (LMS), you may encounter errors. This guide describes common categories of NCIP errors. Note that the exact error text may vary depending on which LMS is being used.
If an NCIP error occurs, you will see a red banner across the top of the screen when trying to complete the related action.
To get more details about the error, click on “View audit trail.” Note that some errors are sent with messy formatting and extraneous text. Look for strings prefixed with “detail” or “type” to extract meaningful content.
Here is an example of a typical NCIP error displayed in the audit trail:
You can find more information about configuring NCIP and editing NCIP settings on the /wiki/spaces/PR/pages/1578172417 page.
NCIP Client failed to call NCIP server or parse returned results. This error indicates that the system could not connect to your LMS at all. Verify that the NCIP information in your settings app is correct and that you are using HTTP or HTTPS as required.
Unknown partner (Alma). This-Alma specific error usually indicates that the Application Profile configured in settings in incorrect. Verify the correct profile name within Alma and update settings if necessary.
Unknown User. The user ID associated with the request could not be found in your LMS. Confirm that the user ID is correct and associated with a user account in your LMS.
Unknown user. The user ID associated with the request could not be found in your LMS. Confirm that the user ID is correct and associated with a user account in your LMS.
User is ineligible to borrow. The patron ID associated with the request does not have the correct privileges for a hold to be placed. Verify that your local circulation policies are configured to allow the hold.
Element rule violated. An "element rule violated" error is indicative of an issue with improper data being transmitted. One of the conditions that can cause that is an invalid pickup location code.
Failed To Update Hold Database. (waiting for an explanation of this from III)
Unknown item. The item barcode is not recognized by the LMS. Verify that you have a valid item barcode that exists in your LMS.
Unknown user. The institutional patron barcode is not recognized by your LMS.
User is ineligible to borrow. The institutional patron account being used does not have the correct privileges to borrow the item. Verify that your local circulation policies are configured to allow the loan.
No institutional patron ID. You have not configured an institutional patron ID for the item to be checked out to. See Configuring institutional patron IDs for more information.
Item is already checked in. The item is already checked into your LMS. To complete the request, you may need to temporarily disable NCIP or manually check it out of your LMS and then complete the request in ReShare.