The Cancel Hold of an Item is an internal call made by SCSB as part of the Cancel Request API. This is exposed as an API to ease the process of testing and will not be directly used by any actors outside of SCSB.
| Code Block |
|---|
| language | js |
|---|
| title | Request - Cancel Hold |
|---|
| linenumbers | true |
|---|
|
{
"bibId": "459389", // Owning Institution Bibliographic Id
"itemBarcodes": [
"32101043878741" // Item Barcode. Common across GFAStorage LASLocation, ILS and SCSB.
],
"itemOwningInstitution": "PUL<Institution>", // Item owning Institution. PossibleExample values are PUL, CUL and NYPL.
"patronIdentifier": "45678913<Patron ID>", // The patron barcode issued by the partner ILS.
"pickupLocation": "rcpcirc<Pickup Location>", // The pickup location detail used in the partner's ILS.
"trackingId": "" //NYPL's ILS generated ID when the cancel is initiated on their side used as a reference to return response in SCSB.
} |
...
| Code Block |
|---|
| language | js |
|---|
| title | Request - Cancel Hold (NYPL) |
|---|
| linenumbers | true |
|---|
|
{
"bibId": "",
"itemBarcodes": [
"33433033691407"
"itemOwningInstitution": "NYPL<Institution>",
"patronIdentifier": "23333097542730<Patron ID>",
"pickupLocation": "",
"trackingId": "221"
} |
...
| Info |
|---|
| title | trackingId in NYPL Request |
|---|
|
Example: The trackingId (221 in the above example) is got as a response during initiating the cancel hold in NYPL ILS (calling cancelRecapHoldRequest API in NYPL ILS). In practical scenarios where this API will be used, SCSB ensures the inclusion of the tracking id. While testing this API as a standalone, the tracking id must be generated by manually calling the NYPL ILS' API. More information here. |
...
| Code Block |
|---|
| language | js |
|---|
| title | Response - Cancel Hold (NYPL) |
|---|
| linenumbers | true |
|---|
|
{
"itemBarcode": "33433033691407",
"itemOwningInstitution": "NYPL<Institution>",
"screenMessage": "Successfully processed cancel hold request",
"success": true,
"esipDataIn": null,
"esipDataOut": null,
"available": false,
"transactionDate": null,
"institutionID": null,
"patronIdentifier": "23333097542730<Patron ID>",
"titleIdentifier": null,
"expirationDate": null,
"pickupLocation": null,
"queuePosition": null,
"bibId": null,
"trackingId": "221",
"jobId": "1046587df2e952698<Job ID>",
"updatedDate": null,
"createdDate": "2017-01-17T05:33:13-05:00",
"isbn": null,
"lccn": null
} |
...