3 This file describes the event codes that an ILS method might return. Not all
4 methods will return event codes and it is up to each method to define which
5 types of events it may return. The standard event procedure is to return an
6 object (JSON hash) with a field called "ilsevent" which contains the event code
9 If events need to be placed into groups for any reason, the segregation shall
10 be defined below with the accompanying events.
13 <event code='0' textcode='SUCCESS'>
14 <desc>No errors or unexpected events occurred</desc>
16 <event code='1' textcode='UNKNOWN'>
17 <desc>Placeholder event. Used for development only</desc>
19 <event code='3' textcode='NO_CHANGE'>
21 The called method didn't actually do anything
24 <event code='1000' textcode='LOGIN_FAILED'>
26 User login failed. Why the login failed is not specified.
29 <event code='1001' textcode='NO_SESSION'>
31 User login session has either timed out or does not exist.
34 <event code='1002' textcode='USER_NOT_FOUND'>
36 Someone attempted to retrieve a user from the system and the user
40 <event code='1003' textcode='Z3950_SEARCH_FAILED'>
41 <desc>The Z search did not succeed</desc>
43 <event code='1200' textcode='USERNAME_EXISTS'>
45 The given username exists in the database
48 <event code='1201' textcode='CIRC_PERMIT_BAD_KEY'>
50 A checkout was attempted without a valid checkout permit key
53 <event code='1202' textcode='ITEM_NOT_CATALOGED'>
55 The requested item is not cataloged in the database
58 <event code='1203' textcode='COPY_BAD_STATUS'>
60 The given copy is not in a standard circulation status
63 <event code='1204' textcode='CIRC_BAD_STATUS'>
65 The given circulation is not in a standard status or
66 the circulation was never fully closed properly
69 <event code='1205' textcode='CARD_EXISTS'>
70 <desc>The given user barcode already exists</desc>
72 <event code='1206' textcode='VOLUME_NOT_EMPTY'>
73 <desc>The selected volume has copies attached</desc>
75 <event code='1207' textcode='REFUND_EXCEEDS_BALANCE'>
76 <desc>A refund greater than the negative balance on a transaction was provided</desc>
83 <event code='1500' textcode='CIRCULATION_NOT_FOUND'>
85 Someone attempted to retrieve a circulation object from the system and
86 the object was not found.
89 <event code='1501' textcode='BIBLIO_RECORD_NOT_FOUND'>
91 Someone attempted to retrieve a biblio record entry object from the
92 system and the object was not found.
95 <event code='1502' textcode='COPY_NOT_FOUND'>
97 Someone attempted to retrieve a copy object from the
98 system and the object was not found.
101 <event code='1503' textcode='HOLD_NOT_FOUND'>
103 Someone attempted to retrieve a hold object from the
104 system and the object was not found.
107 <event code='1504' textcode='TRANSIT_NOT_FOUND'>
109 Someone attempted to retrieve a transit object from the
110 system and the object was not found.
113 <event code='1505' textcode='BILLING_NOT_FOUND'>
115 Someone attempted to retrieve a transit object from the
116 system and the object was not found.
119 <event code='1506' textcode='CONTAINER_NOT_FOUND'>
121 Someone attempted to retrieve a container object from the
122 system and the object was not found.
125 <event code='1507' textcode='CONTAINER_ITEM_NOT_FOUND'>
127 Someone attempted to retrieve a container item object from the
128 system and the object was not found.
131 <event code='1508' textcode='VOLUME_NOT_FOUND'>
133 Someone attempted to retrieve a volume object from the
134 system and the object was not found.
137 <event code='1509' textcode='ORG_UNIT_NOT_FOUND'>
139 Someone attempted to retrieve an org unit object from the
140 system and the object was not found.
143 <event code='1510' textcode='STAT_CAT_NOT_FOUND'>
144 <desc> Stat cat object does not exist </desc>
146 <event code='1511' textcode='STAT_CAT_ENTRY_NOT_FOUND'>
147 <desc> Stat cat entry object does not exist </desc>
149 <event code='1512' textcode='STAT_CAT_ENTRY_MAP_NOT_FOUND'>
150 <desc> Stat cat entry map object does not exist </desc>
152 <event code='1513' textcode='NON_CAT_TYPE_NOT_FOUND'>
153 <desc> The non cataloged type object does not exist </desc>
155 <event code='1514' textcode='CIRC_DURATION_NOT_FOUND'>
156 <desc> The circ duration object does not exist </desc>
158 <event code='1515' textcode='RECURRING_FINE_NOT_FOUND'>
159 <desc> The recurring fines object does not exist </desc>
161 <event code='1516' textcode='MAX_FINE_NOT_FOUND'>
162 <desc> The max fines object does not exist </desc>
164 <event code='1517' textcode='COPY_LOCATION_NOT_FOUND'>
165 <desc> The copy location object does not exist </desc>
167 <event code='1518' textcode='HOLD_TRANSIT_NOT_FOUND'>
168 <desc> The hold transit object does not exist </desc>
170 <event code='1519' textcode='TRANSACTION_NOT_FOUND'>
171 <desc> Requested transaction object does not exist </desc>
173 <event code='1520' textcode='WORKSTATION_NOT_FOUND'>
174 <desc> Requested workstation object does not exist </desc>
176 <event code='1521' textcode='COPY_NOTE_NOT_FOUND'>
177 <desc> Requested copy note does not exist </desc>
179 <event code='1522' textcode='VOLUME_NOTE_NOT_FOUND'>
180 <desc> Requested copy note does not exist </desc>
182 <event code='1523' textcode='TITLE_NOTE_NOT_FOUND'>
183 <desc> Requested copy note does not exist </desc>
185 <event code='1524' textcode='CARD_NOT_FOUND'>
186 <desc> Requested copy note does not exist </desc>
188 <event code='1525' textcode='BILLING_NOT_FOUND'>
189 <desc> Requested copy note does not exist </desc>
191 <event code='1526' textcode='BILLABLE_XACT_SUMMARY_NOT_FOUND'>
192 <desc> Requested transaction summary does not exist </desc>
195 <event code='1527' textcode='OPEN_TCN_NOT_FOUND'>
196 <desc>No TCN could be found that does not collide with existing records</desc>
202 <event code='1700' textcode='NON_CAT_TYPE_EXISTS'>
203 <desc> The non-cataloged type object already exists </desc>
206 <event code='1701' textcode='COPY_LOCATION_EXISTS'>
207 <desc> The copy location object already exists </desc>
210 <event code='1702' textcode='OPEN_CIRCULATION_EXISTS'>
211 <desc> There is an open circulation on the requested item </desc>
214 <event code='1703' textcode='WORKSTATION_NAME_EXISTS'>
215 <desc> A workstation with that name already exists </desc>
218 <event code='1704' textcode='TCN_EXISTS'>
219 <desc>A record already exists with the requested TCN value</desc>
221 <event code='1705' textcode='VOLUME_LABEL_EXISTS'>
222 <desc>A volume with the same label, title and owning library exists</desc>
224 <event code='1706' textcode='ITEM_BARCODE_EXISTS'>
225 <desc>An item with the same barcode exists</desc>
230 <event code='2000' textcode='BAD_PARAMS'>
232 Invalid parameters were encountered in a method
236 <event code='2001' textcode='DATABASE_UPDATE_FAILED'>
238 The attempt to write to the DB failed
243 <event code='5000' textcode='PERM_FAILURE'>
245 Permission Error. * The object returning this code shall also
246 contain a field "ilsperm" containing the name of the permission which failed
247 and a field called "ilspermloc" defining the location at which the permission
253 <!-- ================================================================ -->
255 <event code='7000' textcode='ROUTE_ITEM'>
257 A copy needs to be routed to a different location
258 The destination location will be specified by an 'org' key
259 within the event object
263 <event code='7001' textcode='PATRON_BAD_STANDING'>
265 The patron in question is not able to check out materials because
266 their account is in bad standing
270 <event code='7002' textcode='PATRON_EXCEEDS_CHECKOUT_COUNT'>
272 The patron in question has the maximum number of items already checked out
276 <event code='7003' textcode='COPY_CIRC_NOT_ALLOWED'>
277 <desc> Target copy is not allowed to circulate </desc>
280 <event code='7004' textcode='COPY_NOT_AVAILABLE'>
281 <desc> Copy is not available </desc>
284 <event code='7005' textcode='LOCATION_CIRC_NOT_ALLOWED'>
285 <desc> Location does not allow materials to circulate </desc>
288 <event code='7006' textcode='COPY_IS_REFERENCE'>
289 <desc> Copy is reference material </desc>
292 <event code='7007' textcode='COPY_NEEDED_FOR_HOLD'>
293 <desc> Copy is needed to fulfil a hold </desc>
296 <event code='7008' textcode='MAX_RENEWALS_REACHED'>
297 <desc> Circulation has no more renewals remaining </desc>
300 <event code='7009' textcode='ROUTE_TO_COPY_LOCATION'>
302 A copy needs to be routed to a copy location. The location
303 should be specified within the event with a 'location' key
307 <event code='7009' textcode='CIRC_CLAIMS_RETURNED'>
308 <desc> Requested circulation is marked claims returned </desc>
311 <event code='7010' textcode='COPY_ALERT_MESSAGE'>
312 <desc> The requested copy has an alert message attached </desc>
315 <event code='7011' textcode='COPY_STATUS_LOST'>
316 <desc>Copy has is marked as lost</desc>
319 <event code='7012' textcode='COPY_STATUS_MISSING'>
320 <desc>Copy has is marked as missing</desc>
323 <event code='7013' textcode='PATRON_EXCEEDS_FINES'>
324 <desc>The patron in question has reached the maximum fine amount</desc>
327 <!-- ================================================================ -->
330 <event code='8000' textcode='OFFLINE_SESSION_ACTIVE'>
331 <desc> An offline session for this location is currently processing </desc>
333 <event code='8001' textcode='OFFLINE_SESSION_FILE_EXISTS'>
334 <desc> An offline file for this workstation exists within this session </desc>
336 <event code='8002' textcode='OFFLINE_FILE_ERROR'>
337 <desc> An offline file or directory could not be created or accessed </desc>
339 <event code='8003' textcode='OFFLINE_PARAM_ERROR'>
340 <desc> Missing params in offline upload </desc>
342 <event code='8004' textcode='OFFLINE_CONFIG_ERROR'>
343 <desc> Offline server is not configured properly </desc>
345 <event code='8005' textcode='OFFLINE_CHECKSUM_FAILED'>
346 <desc> Offline server is not configured properly </desc>
348 <event code='8006' textcode='OFFLINE_SESSION_NOT_FOUND'>
349 <desc> Offline server is not configured properly </desc>
351 <event code='8007' textcode='OFFLINE_SESSION_EXISTS'>
352 <desc> A session with the given name already exists </desc>
354 <event code='8008' textcode='OFFLINE_INVALID_SESSION'>
355 <desc> The session name is invalid </desc>
357 <event code='8009' textcode='OFFLINE_NO_ORG'>
358 <desc> No org id was provided </desc>
360 <event code='8010' textcode='OFFLINE_SESSION_COMPLETE'>
361 <desc> No org id was provided </desc>
364 <!-- ================================================================ -->