PatronAccountGet
Returns list of fines and fees associated with a specified patron. The list can be filtered by outstanding (current) or reconciled (historical) fines and fees.
| GET | /public/1/patron/{PatronBarcode}/account/outstanding | ||
| GET | /public/1/patron/{PatronBarcode}/account/reconciled |
Authorization required?
Yes
URI Parameters
| Name |
Required |
Description/Notes |
|
PatronBarcode |
Yes |
Barcode of patron. |
XML Elements Returned
One or more fines and fees associated with the patron. The list is sorted in ascending order by transaction date.
|
Name |
Description/Notes |
| PAPIErrorCode |
PAPI Error code: Negative values represent errors and are defined elsewhere. Note: On successful completion, the PAPI error code is populated with a positive integer representing the number of rows returned. |
| ErrorMessage | Error or information message |
|
TransactionID |
Polaris ID of the transaction |
|
TransactionDate |
Date and time the transaction was logged |
|
BranchID |
Polaris ID of the branch associated with the fine |
|
BranchName |
Name of the branch associated with the fine |
|
TransactionTypeID |
Polaris ID of the type of transaction 1 - Charge |
|
TransactionTypeDescription |
Description of the type of transaction |
|
FeeDescription |
Detailed description of the fee |
|
TransactionAmount |
Amount of transaction in dollar and cents |
|
OutstandingAmount |
Outstanding amount |
|
FreeTextNote |
Free text note associated with the transaction |
|
ItemID |
Polaris ID of the associated item record |
|
Barcode |
The item barcode |
|
BibID |
The ID of the associated bibliographic record |
|
FormatID |
Polaris ID of the type of format (see Material Format Types) |
|
FormatDescription |
Format description |
|
Title |
Title of the item |
|
Author |
Author of the item |
|
CallNumber |
Call Number of the item |
|
CheckOutDate |
Date the item associated with the fine was checked out |
|
DueDate |
The original due date of the item associated with the fine |
Example
http://localhost/PAPIService/REST/public/v1/1033/100/1/patron/21756003332022/account/outstanding
Return - Success
HTTP/1.1 200 OK
<PatronAccountGetResult
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<PAPIErrorCode>0</PAPIErrorCode>
<ErrorMessage/>
<PatronAccountGetRows>
<PatronAccountGetRow>
<TransactionID>3605602</TransactionID>
<TransactionDate>2009-09-09T17:18:31</TransactionDate>
<BranchID>3</BranchID>
<BranchName>Amsterdam Free Library</BranchName>
<TransactionTypeID>1</TransactionTypeID>
<TransactionTypeDescription>Charge</TransactionTypeDescription>
<FeeDescription/>
<TransactionAmount>2.0000</TransactionAmount>
<OutstandingAmount>2.0000</OutstandingAmount>
<FreeTextNote/>
<ItemID>0</ItemID>
<Barcode/>
<BibID>0</BibID>
<FormatID>0</FormatID>
<FormatDescription/>
<Title/>
<Author/>
<CallNumber/>
<CheckOutDate>0001-01-01T00:00:00</CheckOutDate>
<DueDate>0001-01-01T00:00:00</DueDate>
</PatronAccountGetRow>
...
</PatronAccountGetRows>
</PatronAccountGetResult>
Return - Failed
HTTP/1.1 200 OK
<PatronAccountGetResult
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<PAPIErrorCode>-1</PAPIErrorCode>
<ErrorMessage>Invalid type specified</ErrorMessage>
<PatronAccountGetRows i:nil="true"/>
</PatronAccountGetResult>