foliolib.folio.api.dcb.DcbTransaction

class foliolib.folio.api.dcb.DcbTransaction(tenant: str)

Bases: foliolib.folio.FolioApi

mod DCB FOLIO API

mod DCB FOLIO API

Base class of the Folio API

Parameters

tenant (str) – Tenant id

Methods

createcirculationrequest(dcbTransactionId, ...)	Create circulation request
gettransactionstatusbyid(dcbTransactionId)	Get transaction status across circulation institutions
updatetransactionstatus(transactionStatus, ...)	Update transaction status across circulation institutions

createcirculationrequest(dcbTransactionId, dcbTransaction)

Create circulation request

POST /transactions/{dcbTransactionId}

Parameters

• dcbTransactionId (str) –

• dcbTransaction (dict) – See Schema below.

Returns

See Schema below.

Return type

dict

Raises

• OkapiRequestError – Bad request

• OkapiRequestConflict – Validation errors

• OkapiRequestFatalError – Internal server error

Schema

{
    "type": "object",
    "properties": {
        "item": {
            "$ref": "dcbItem.yaml#/DcbItem"
        },
        "patron": {
            "$ref": "dcbPatron.yaml#/DcbPatron"
        },
        "pickup": {
            "$ref": "dcbPickup.yaml#/DcbPickup"
        },
        "role": {
            "type": "string",
            "enum": [
                "LENDER",
                "BORROWER",
                "PICKUP",
                "BORROWING-PICKUP"
            ]
        }
    }
}

{
    "allOf": [
        {
            "$ref": "transactionStatus.yaml#/TransactionStatus"
        },
        {
            "$ref": "dcbTransaction.yaml#/DcbTransaction"
        }
    ]
}

gettransactionstatusbyid(dcbTransactionId)

Get transaction status across circulation institutions

GET /transactions/{dcbTransactionId}/status

Returns

See Schema below.

Return type

dict

Raises

• OkapiRequestNotFound – Resource not found

• OkapiRequestError – Bad request

• OkapiRequestFatalError – Internal server error

Schema

{
    "allOf": [
        {
            "$ref": "transactionStatus.yaml#/TransactionStatus"
        },
        {
            "$ref": "dcbTransaction.yaml#/DcbTransaction"
        }
    ]
}

updatetransactionstatus(transactionStatus, dcbTransactionId)

Update transaction status across circulation institutions

PUT /transactions/{dcbTransactionId}/status

Parameters

transactionStatus (dict) – See Schema below.

Returns

See Schema below.

Return type

dict

Raises

• OkapiRequestError – Bad request

• OkapiRequestNotFound – Resource not found

• OkapiRequestFatalError – Internal server error

Schema

{
    "type": "object",
    "properties": {
        "status": {
            "type": "string",
            "enum": [
                "CREATED",
                "OPEN",
                "AWAITING_PICKUP",
                "ITEM_CHECKED_OUT",
                "ITEM_CHECKED_IN",
                "CLOSED",
                "CANCELLED",
                "ERROR"
            ]
        },
        "message": {
            "type": "string"
        }
    }
}

{
    "allOf": [
        {
            "$ref": "transactionStatus.yaml#/TransactionStatus"
        },
        {
            "$ref": "dcbTransaction.yaml#/DcbTransaction"
        }
    ]
}