Create Bibliographic record

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. For Institution, the title identifier is sent as part of the create request endpoint of Institution.

The created items are given a title with the use restriction mentioned in square brackets followed by the title data from 245 $a & $b which is followed by Storage Location in square brackets. (e.g. In Library Use] AFGHANISTAN Storage Location] 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 Storage Location's partner.

Request - Create Bib Record

{
  "itemBarcodes": [
    "123456789" // Item Barcode. Common across Storage Location IMS System, ILS and SCSB.
  ],
  "itemOwningInstitution": "Institution", // Item owning Institution. Possible values are PUL and CUL. 
  "patronIdentifier": "45678912", // The patron barcode issued by the partner ILS.
  "titleIdentifier": "[No Restriction] TITLE IN CAPS [Storage Location]" // The title of the created record. It follows the [<Use restriction>] <Title> [Storage Location] format.
}

Response - Create Bib Record

{
  "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 [Storage Location]|\r",
  "esipDataOut": "821MJ|MA9959123|AFCreate Bib successful.|",
  "bibId": "9959123",
  "itemId": ""
}

Alternate Response - Create Bibliographic record

{
  "itemBarcode": "123213",
  "itemOwningInstitution": "",
  "screenMessage": "Item Barcode already Exist", // Record already exists
  "success": true,
  "esipDataIn": null,
  "esipDataOut": null,
  "bibId": "12040317",
  "itemId": null
}

Alternate Response - Create Bibliographic record

{
  "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
}