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 ReCAP facility. This API is called by the GFA LAS as part of the accession workflow at their end with the customer code and item barcode.

Internally, SCSB uses the customer code to identify the institution and use the institution's service (ILS 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 are they requestable. It can be viewed as part of the reports UI and modified to become complete using the Submit Collection API.

Request - Accession

{
  "customerCode": "PA", // Customer code as stored in GFA LAS. This is used to identify the institution in SCSB.
  "itemBarcode": "PULTST54340" // Item Barcode. Unique and common across SCSB, GFA LAS and partners' ILS.
}

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.
  }
]