Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

When using NCIP to interact with a library management system (LMS), you may encounter errors. This guide describes some common categories of NCIP errors. Note that the exact error text may vary depending on which LMS is being used.

...

To get more details about the error, click on “View audit trail.” Note that some errors are sent with a lot of 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.

General

  • 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.

...

Receive request (NCIP acceptItem)

  • Unknown user. The patron user ID associated with the request is not recognized by the 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.

...

  • 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.

Complete request (NCIP checkinItem)

...