Patron Circulation Actions — Debt
General Purpose
The resource may be accessed with the GET method to retrieve a patron’s fines and fees and/or demerits (debt) from a patron’s home server.
Product Version Compatibility
Voyager 7.2.0 and later.
Input Parameters
Parameter | Type | Description | Value | Default | Required |
---|---|---|---|---|---|
patron ID | path parameter | Voyager patron system ID. The system ID can be retrieved from the Voyager circulation staff client interface or returned from the AuthenticatePatronService Web service with patron barcode and last name. | string | None | Yes |
patron_homedb | query parameter | Voyager patron home DB key | string | None | Yes |
institution | query parameter | The database code from SysAdmin -> search -> Database Definitions. This is to retrieve debt for the patron in a specific database. | string | None | No |
view | query parameter | If view=brief, a subset of the debt information is displayed. If view=full, all pertinent debt information is displayed. | string | None | No |
Ensure that the “demerits” and “demeritsdisplay” rows in your global_parm table are set to “Y” to include demerits in your responses from the service.
Input URL Syntax
The following is an example of input URL to retrieve patron debt information:
http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt?patron_homedb=1@DMADB20010103091142
The following is an example of input URL to retrieve patron debt information from a specific database:
http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt?patron_homedb=1@DMADB20010103091142&institution=GWCC
The following is an example of input URL to retrieve patron fines information (patron fines also include demerit information):
http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines?patron_homedb=1@DMADB20010103091142
The following is an example of input URL to retrieve patron fines information from a specific database (patron fines also include demerit information):
http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines?patron_homedb=1@DMADB20010103091142&institution=GWCC
The following is an example of input URL to retrieve patron fines information with view=brief (patron fines also include demerit information):
http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines?patron_homedb=1@DMADB20010103091142&view=brief
The following is an example of input URL to retrieve patron fines information with view=full (patron fines also include demerit information):
http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines?patron_homedb=1@DMADB20010103091142&view=full
The following is an example of input URL to retrieve specific patron fines information (patron fines also include demerit information):
http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines?patron_homedb=1@DMADB20010103091142&view=full
Output XML Format
The following is an output example of patron debt:
<?xml version="1.0" encoding="UTF-8" ?> <response> <reply-text>ok</reply-text> <reply-code>0</reply-code> <debts> <institution id="GWCC"> <instName>ubgwcc720db</instName> <debt href="http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines?institution=GWCC&patron_homedb=1@DMADB20010103091142"> <finesum>USD 21.00</finesum> <demeritsum>21.00</demeritsum> </debt> </institution> <institution id="LOCAL"> <instName>DEV720DMADB</instName> <debt href="http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines?institution=LOCAL&patron_homedb=1@DMADB20010103091142"> <finesum>USD 117.00</finesum> </debt> </institution> </debts> </response>
The following is an output example of patron debt from a specific institution:
<?xml version="1.0" encoding="UTF-8" ?> <response> <reply-text>ok</reply-text> <reply-code>0</reply-code> <debts> <institution id="GWCC"> <instName>ubgwcc720db</instName> <debt href="http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines?institution=GWCC&patron_homedb=1@DMADB20010103091142"> <finesum>USD 21.00</finesum> <demeritsum>21.00</demeritsum> </debt> </institution> </debts> </response>
The following is an output example of patron fines:
<?xml version="1.0" encoding="UTF-8" ?> <response> <reply-text>ok</reply-text> <reply-code>0</reply-code> <fines> <institution id="GWCC"> <instName>ubgwcc720db</instName> <balance> <finesum>USD 21.00</finesum> <demeritsum>21.00</demeritsum> </balance> <fine href="http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines/156?patron_homedb=1@DMADB20010103091142" /> <fine href="http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines/150?patron_homedb=1@DMADB20010103091142" /> <fine href="http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines/156?patron_homedb=1@DMADB20010103091142" /> <fine href="http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines/150?patron_homedb=1@DMADB20010103091142" /> </institution> <institution id="LOCAL"> <instName>DEV720DMADB</instName> <balance> <finesum>USD 117.00</finesum> </balance> <fine href="http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines/1013?patron_homedb=1@DMADB20010103091142" /> <fine href="http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines/1017?patron_homedb=1@DMADB20010103091142" /> <fine href="http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines/1016?patron_homedb=1@DMADB20010103091142" /> <fine href="http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines/1016?patron_homedb=1@DMADB20010103091142" /> <fine href="http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines/1015?patron_homedb=1@DMADB20010103091142" /> </institution> </fines> </response>
The following is an output example of patron fines for a specific institution:
<?xml version="1.0" encoding="UTF-8" ?> <response> <reply-text>ok</reply-text> <reply-code>0</reply-code> <fines> <institution id="GWCC"> <instName>ubgwcc720db</instName> <balance> <finesum>USD 21.00</finesum> <demeritsum>21.00</demeritsum> </balance> <fine href="http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines/156?patron_homedb=1@DMADB20010103091142" /> <fine href="http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines/150?patron_homedb=1@DMADB20010103091142" /> <fine href="http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines/156?patron_homedb=1@DMADB20010103091142" /> <fine href="http://10.100.2.37:30314/vxws/patron/204/circulationActions/debt/fines/150?patron_homedb=1@DMADB20010103091142" /> </institution> </fines> </response>
The following is an output example of specific patron fines:
<?xml version="1.0" encoding="UTF-8" ?> <response> <reply-text>ok</reply-text> <reply-code>0</reply-code> <resource> <fine> <fineId>156</fineId> <fineDate>2009-12-09</fineDate> <itemTitle>Introduction to comparative entomology [by] Richard M. Fox [and] Jean Walker Fox.</itemTitle> <fineType>Overdue</fineType> <amount>USD 20.00</amount> <dbKey>GWCCDB20010402131061</dbKey> <dbName>GWCC</dbName> <instName>ubgwcc720db</instName> </fine> <fine> <fineId>156</fineId> <fineDate>2009-12-09</fineDate> <itemTitle>Introduction to comparative entomology [by] Richard M. Fox [and] Jean Walker Fox.</itemTitle> <fineType>Overdue</fineType> <amount>Demerits: 20.00</amount> <dbKey>GWCCDB20010402131061</dbKey> <dbName>GWCC</dbName> <instName>ubgwcc720db</instName> </fine> </resource> </response>
Possible Error Codes
2: Patron ID is not found
51: patron_homedb is a required parameter
Note
Payments against a fine/fee will be returned in a <fineType> element with a value of “Payment”. Its associated <fineDate> is the date the payment was made. In the example below, a fine of $10 was incurred on 2014-07-24, and $4 of it was paid on 2014-07-28.
<fine href= "http://10.100.3.87:61314/vxws/patron/152/circulationActions/debt/fines/10353?patron_homedb=1@QA20012DB20020613131313" > <fineId>10353</fineId> <fineDate>2014-07-24</fineDate> <itemTitle/> <fineType>Media Booking Late Charge</fineType> <amount>USD 10.00</amount> <dbKey>1@QA20012DB20020613131313</dbKey> <dbName>DEV910NCDB</dbName> </fine> <fine href= "http://10.100.3.87:61314/vxws/patron/152/circulationActions/debt/fines/10353?patron_homedb=1@QA20012DB20020613131313" > <fineId>10353</fineId> <fineDate>2014-07-28</fineDate> <itemTitle/> <fineType>Payment</fineType> <amount>USD 4.00</amount> <dbKey>1@QA20012DB20020613131313</dbKey> <dbName>DEV910NCDB</dbName> </fine>