SCSB Accession

The Accession API (also known as Ongoing Accession) is used to add item records to SCSB whenever there is a new item added to the storage facility. This API is called by the storage facility as part of the accession workflow at their end with the customer code, item barcode and storage location

Internally, SCSB uses the customer code and storage location to identify the institution and use the institution's service (ILS's Bibdata API) to retrieve bibliographic, holding and item information using the item barcode. If the information is not available in ILS, SCSB creates a dummy record with dummy values and marks it 'Incomplete'. Incomplete records are neither displayed as part of search results nor they are requestable. It can be viewed as part of the reports UI and modified to become complete using the Submit Collection API. There is a configurable (parameter ongoing.accession.input.limit) limit of 10 items for each call.

Request - Accession

API End Point: /sharedCollection/accession

Request - Accession

{
   "imsLocationCode":"Storage location",  // RECAP for ReCAP Warehouse, HD for Harvard Depository
   "accessionRequests":[
      {
         "customerCode":"PA",
         "itemBarcode":"PULTST54340"
      },
      {
         "customerCode":"PA",
         "itemBarcode":"PULTST54341"
      },
      {
         "customerCode":"PA",
         "itemBarcode":"PULTST54342"
      }
   ]
}

Response - Accession

[
  {
    "itemBarcode": "PULTST54340",
    "message": "Success"
  }
]

Alternate Response - Accession

[
  {
    "itemBarcode": "33433002004194",
    "message": "Item Barcode not found, Dummy record created" // When the barcode information is not found in ILS,a dummy record is created in SCSB.
  }
]

Alternate Response - Accession

[
  {
    "itemBarcode": "33433002004194",
    "message": "Item already accessioned - Existing item details :  OwningInstBibId-1483796425 OwningInstHoldingId--2007145460 OwningInstItemId-473338094" // When the barcode has already been accessioned, SCSB returns an 'Item already accessioned' message with the relevant ids.
  }
]

Alternate Response - Accession

[
  {
    "itemBarcode": "33433002004194",
    "message": "Unable to parse input, xml is having invalid marc tag, Dummy record created" // When the item record is not parsable due to invalid marc tags, a dummy record is created.
  }
]