The Hold Item API call is an internal call made by SCSB to the partner's ILS to place a hold request as part of the request API workflow. The API call uses the SIP protocol to communicate with Princeton and Columbia ILS. In case of NYPL, the ILS' (Sierra) API is initially invoked and hence is not subsequently invoked as part of the request workflow.
| Code Block |
|---|
| language | js |
|---|
| title | Request - Hold Item (PUL) |
|---|
| linenumbers | true |
|---|
|
{
"author": "", "bibId": "459389",
"callNumber": "",
"expirationDate// Author information of the bibliographic record.
"bibId": "20170205 221545459389", "itemBarcodes": [
"32101043878741"
],
"itemOwningInstitution// Bibliographic Id of the bibliographic record.
"callNumber": "PUL", "patronIdentifier": "45678913",
"pickupLocation": "rcpcirc",
"title": "",
"trackingId// Call number details to ease process of retrieval.
"expirationDate": ""
} |
| Code Block |
|---|
| language | js |
|---|
| title | Response - Hold Item (PUL) |
|---|
| linenumbers | true |
|---|
|
{20170205 "itemBarcode": "32101043878741221545", // Expiration "itemOwningInstitution": "",
"screenMessage": "Request placed.",
"success": true,
"available": true,
"transactionDate": "12-Jan-2017 03:50:03",
"institutionID": "",
"patronIdentifier": "45678913",
"titleIdentifier": null,
"expirationDate": "05-Feb-2017 22:15:45",
"pickupLocation": null,
"queuePosition": null,
"bibId": "459389",
"trackingId": null,
"updatedDate": null,
"createdDate": null,
"isbn": null,
"lccn": "86213675"
} |
| Code Block |
|---|
| language | js |
|---|
| title | Request - Hold Item (CUL) |
|---|
| linenumbers | true |
|---|
|
{
"author": "",
"bibId": "350215",
"callNumber": "",
"expirationDate": "20170205 221545",
"itemBarcodes": [
"CU53905733"
],
"itemOwningInstitution": "CUL",
"patronIdentifier": "RECAPTST01",
"pickupLocation": "",
"title": "",
"trackingId": ""
date passed to the ILS' hold API. Usually 6 months for PUL and CUL and 1 year for NYPL.
"itemBarcodes": [
"32101043878741" // Item Barcode. Common across GFA LAS, ILS and SCSB
],
"itemOwningInstitution": "PUL", // Item owning institution. Possible values are PUL, CUL or NYPL.
"patronIdentifier": "45678913", // Patron Barcode assigned to the patron by the partner institution.
"pickupLocation": "rcpcirc", // Pickup location as expected by the ILS' API.
"title": "",
"trackingId": "" // NYPL's ILS generated ID initiated on their side while placing hold used as a reference to return response in SCSB.
} |
| Code Block |
|---|
| language | js |
|---|
| title | Response - Hold Item (CUL) |
|---|
| linenumbers | true |
|---|
|
{
"itemBarcode": "CU5390573332101043878741",
"itemOwningInstitution": "",
"screenMessage": "Request placed.",
"success": true,
"esipDataIn": "15+20170112 063342BW20170205 221545|BS|AO|AARECAPTST01|ABCU53905733|MA350215|\r",
"esipDataOut": "161Y20170112 063346BW20170205 221545|AO|AARECAPTST01|ABCU53905733|AJ|MA350215|MB|MC81080611|",
"available": true,
"transactionDate": "12-Jan-2017 0603:3350:4603",
"institutionID": "",
"patronIdentifier": "RECAPTST0145678913",
"titleIdentifier": null,
"expirationDate": "05-Feb-2017 22:15:45",
"pickupLocation": null,
"queuePosition": null,
"bibId": "350215459389",
"trackingId": null,
"updatedDate": null,
"createdDate": null,
"isbn": null,
"lccn": "8108061186213675"
} |