foliolib.folio.api.orders.CheckIn
- class foliolib.folio.api.orders.CheckIn(tenant: str, okapi: Optional[foliolib.okapi.okapiClient.OkapiClient] = None)
Bases:
foliolib.folio.FolioApiOrders Business Logic API
API for checking-in pieces
- Parameters
tenant (str) – Tenant id
okapi (OkapiClient, optional) – Instance of OkapiClient. Defaults to None.
Methods
set_checkIn(checkIn)Check-in items spanning one or more po_lines in this order
- set_checkIn(checkIn: dict)
Check-in items spanning one or more po_lines in this order
POST /orders/check-in- Parameters
checkIn (dict) – See Schema below
- Returns
See Schema below
- Return type
dict
- Raises
OkapiRequestError – Bad Request
OkapiFatalError – Server Error
Schema
{ "$schema": "http://json-schema.org/draft-04/schema#", "description": "A collection of check-in", "type": "object", "properties": { "toBeCheckedIn": { "description": "List of check-in", "id": "toBeCheckedIn", "type": "array", "items": { "type": "object", "properties": { "poLineId": { "description": "The id of the checkin PO line", "type": "string", "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$" }, "checkedIn": { "description": "The number of pieces to check-in", "type": "integer" }, "checkInPieces": { "description": "A collection of piece records", "type": "array", "id": "checkInPieces", "items": { "type": "object", "properties": { "id": { "description": "The id of the piece", "type": "string", "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$" }, "barcode": { "description": "The barcode assigned to the piece", "type": "string" }, "callNumber": { "description": "The call number assigned to the piece", "type": "string" }, "comment": { "description": "The free form notes pertaining to the piece", "type": "string" }, "caption": { "description": "The enumeration caption of the piece", "type": "string" }, "createItem": { "description": "Whether or not to create an item record for this piece", "type": "boolean" }, "supplement": { "description": "Whether or not this is a supplementary material for this piece", "type": "boolean" }, "locationId": { "description": "The id of the location", "type": "string", "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$" }, "holdingId": { "description": "UUID of the holding record", "$ref": "../../common/schemas/uuid.json" }, "displayOnHolding": { "description": "Whether or not receiving history should be displayed in holding record view", "type": "boolean", "default": false }, "enumeration": { "type": "string", "description": "Enumeration is the descriptive information for the numbering scheme of a serial. Synchronized with inventory item." }, "chronology": { "type": "string", "description": "Chronology is the descriptive information for the dating scheme of a serial. Synchronized with inventory item." }, "discoverySuppress": { "type": "boolean", "description": "Records the fact that the record should not be displayed in a discovery system" }, "copyNumber": { "type": "string", "description": "Copy number of the piece" }, "materialTypeId": { "description": "The id of the materialType", "type": "string", "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$" }, "productId": { "description": "The id of the Product", "type": "string" }, "productIdType": { "description": "The UUID corresponding to the type of product id", "type": "string", "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$" }, "accessionNumber": { "description": "The number referencing physical item acquired by the library", "type": "string" }, "itemDescription": { "description": "The description associated with the item record", "type": "string" }, "electronicBookplate": { "description": "A text that relates to the owner of the book", "type": "string" }, "itemStatus": { "description": "The status of the Check in piece", "$ref": "item_status.json" } }, "additionalProperties": false } } }, "additionalProperties": false, "required": [ "poLineId" ] } }, "totalRecords": { "description": "The total number of pieces to check-in in the list", "type": "integer" } }, "additionalProperties": false, "required": [ "toBeCheckedIn", "totalRecords" ] }
{ "$schema": "http://json-schema.org/draft-04/schema#", "description": "A collection of receiving results", "type": "object", "properties": { "receivingResults": { "description": "List of receiving/checkin results", "id": "receivingResults", "type": "array", "items": { "type": "object", "properties": { "poLineId": { "description": "The id of the receiving/checkin po line", "type": "string", "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$" }, "processedSuccessfully": { "description": "The number of items processed successfully", "type": "integer" }, "processedWithError": { "description": "The number of items processed with error", "type": "integer" }, "receivingItemResults": { "description": "List of processed receiving item details", "id": "receivingItemResults", "type": "array", "items": { "type": "object", "properties": { "pieceId": { "description": "UUID of this piece record", "type": "string", "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$" }, "processingStatus": { "description": "The status describing item processing result", "type": "object", "properties": { "type": { "description": "Resulting status of the processed piece record", "type": "string", "enum": [ "success", "failure" ] }, "error": { "description": "Error details in case receiving/check-in process for the piece record has failed", "type": "object", "$ref": "../../../raml-util/schemas/error.schema", "readonly": true } }, "required": [ "type" ], "additionalProperties": false } }, "required": [ "pieceId", "processingStatus" ], "additionalProperties": false } } }, "required": [ "poLineId", "receivingItemResults" ], "additionalProperties": false } }, "totalRecords": { "description": "The total number of receiving/check-in items in the list", "type": "integer" } }, "additionalProperties": false, "required": [ "receivingResults", "totalRecords" ] }