foliolib.folio.api.audit.AcquisitionEvents

class foliolib.folio.api.audit.AcquisitionEvents(tenant: str, okapi: Optional[foliolib.okapi.okapiClient.OkapiClient] = None)

Bases: foliolib.folio.FolioApi

Acquisition Audit events API

API for retrieving events for acquisition changes

Parameters

• tenant (str) – Tenant id

• okapi (OkapiClient, optional) – Instance of OkapiClient. Defaults to None.

Methods

get_order(orderId, **kwargs)	Get list of order events by order_id
get_orderLine(orderLineId, **kwargs)	Get list of order_line events by order_line_id

get_order(orderId: str, **kwargs)

Get list of order events by order_id

GET /audit-data/acquisition/order/{orderId}

Parameters

• orderId (str) –

• **kwargs (properties) – Keyword Arguments

Keyword Arguments

• sortBy (str) – (default=action_date) sorting by field: actionDate

• sortOrder (str) – (default=desc) sort order: asc or desc

• limit (int) –

  (default=10) Limit the number of elements returned in the response

  Example

  • 10

• offset (int) –

  (default=0) Skip over a number of elements by specifying an offset value for the query

  Example

  • 0

Returns

See Schema below

Return type

dict

Raises

• OkapiFatalError – Server Error

• OkapiRequestUnprocessableEntity – Unprocessable Entity

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "Collection of orderAuditEvents",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "orderAuditEvents": {
      "description": "List of orderAuditEvents",
      "type": "array",
      "id": "orderAuditEventsList",
      "items": {
        "type": "object",
        "$ref": "order_audit_event.json"
      }
    },
    "totalItems": {
      "description": "total records",
      "type": "integer"
    }
  },
  "required": [
    "orderAuditEvents",
    "totalItems"
  ]
}

get_orderLine(orderLineId: str, **kwargs)

Get list of order_line events by order_line_id

GET /audit-data/acquisition/order-line/{orderLineId}

Parameters

• orderLineId (str) –

• **kwargs (properties) – Keyword Arguments

Keyword Arguments

• sortBy (str) – (default=action_date) sorting by field: actionDate

• sortOrder (str) – (default=desc) sort order: asc or desc

• limit (int) –

  (default=10) Limit the number of elements returned in the response

  Example

  • 10

• offset (int) –

  (default=0) Skip over a number of elements by specifying an offset value for the query

  Example

  • 0

Returns

See Schema below

Return type

dict

Raises

• OkapiFatalError – Server Error

• OkapiRequestUnprocessableEntity – Unprocessable Entity

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "Collection of orderLineAuditEvents",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "orderLineAuditEvents": {
      "description": "List of orderLineAuditEvents",
      "type": "array",
      "id": "orderLineAuditEventsList",
      "items": {
        "type": "object",
        "$ref": "order_line_audit_event.json"
      }
    },
    "totalItems": {
      "description": "total records",
      "type": "integer"
    }
  },
  "required": [
    "orderLineAuditEvents",
    "totalItems"
  ]
}