The Create Bibliographic record API is an internal call made by SCSB to partner ILS as part of the request API for cross partner borrowings. In case of cross partner borrowings, the requesting institution is unlikely to have the metadata of the item that is being requested and hence cannot be placed on hold for the patron. The Create Bib record API addresses this by creating a temporary record against which a hold can be placed and subsequent charge and discharge processes can be done.
The created items are given a title with the use restriction mentioned in square brackets followed by the title data from 245 $a which is followed by RECAP in square brackets. (e.g. In Library Use] AFGHANISTAN RECAP] All diacritical marks are stripped from the title before the record in created in the partner database. The short records allows the hold to be placed against it and gives the circulation staff and the patron information in the local ILS about use restrictions and the fact that the item belongs to a ReCAP partner.
{
"itemBarcodes": [
"123456789" // Item Barcode. Common across GFA LAS, ILS and SCSB.
],
"itemOwningInstitution": "PUL", // Item owning Institution. Possible values are PUL, CUL and NYPL.
"patronIdentifier": "45678912", // The patron barcode issued by the partner ILS.
"titleIdentifier": "[No Restriction] TITLE IN CAPS [RECAP]" // The title of the created record. It follows the [<Use restriction>] <Title> [RECAP] format.
}
{
"itemBarcode": "",
"itemOwningInstitution": "",
"screenMessage": "Create Bib successful.", // Successful creation of bibliographic record
"success": true,
"esipDataIn": "81N20170112 062300|AO|AA45678912AP|AB123456789|AC|AJ[No Restriction] TITLE IN CAPS [RECAP]|\r",
"esipDataOut": "821MJ|MA9959123|AFCreate Bib successful.|",
"bibId": "9959123",
"itemId": ""
}
{
"itemBarcode": "123213",
"itemOwningInstitution": "",
"screenMessage": "Item Barcode already Exist", // Record already exists
"success": true,
"esipDataIn": null,
"esipDataOut": null,
"bibId": "12040317",
"itemId": null
}
{
"itemBarcode": null,
"itemOwningInstitution": "",
"screenMessage": "Patron Validation Failed: Patron barcode not found", // Patron barcode is not valid/found.
"success": false,
"esipDataIn": null,
"esipDataOut": null,
"bibId": null,
"itemId": null
}