Inhoudelijke beschrijving dialogen
Algemene kennis over opzet en inhoud van SIP2-dialogen wordt verondersteld. Alleen de specifieke OCLC-dialogen en de definitie van afwijkende (SIP+) velden worden hier beschreven. In de dialogen is op verschillende plaatsen het 'lenernummer' van de klant opgenomen. Hierin zal het (hoofd)pasnummer van de klant worden opgenomen. In de beschrijving zal hiervoor zowel lenernummer als pasnummer worden gebruikt.
Dialoog 41/42: Opvragen openstaande posten
Request: veld FA of FB of FC moet nu een Y hebben, bijv. FBY. Ook posten die een incasso op 'J' hebben staan worden doorgegeven. De automaat kan hierop inspelen en deze al dan niet tonen. Toegevoegd aan antwoord:
- Omschrijving van de post/titel
- Status indicatie: I=Incasso,D=Deurwaarder,R=Betalingsregeling
- Deurwaarder datum, dd-mm-yyyy (in de status dan ook een 'D' opgenomen)
- Unieke identifier van de post: adm_id
- Post type (1-contributie, 2-boetes/leengeld etc., 3-winkelverkopen, 4-kasontvangsten, 6-Theater)
- Datum afbetalingsregeling. Posten met een gevulde datum hoeven nog niet te worden betaald. (in de status is dan ook een 'R' opgenomen)
Velden worden nu gescheiden door een tilde ipv een '-'
Veld 1 2 3 4 5 6 7 8 9 10
YZ-regel: 14-03-2004 ~ Boete ~ ~ 10-03-2004 ~ 0.30 ~ ID ~ 01-10-2008 ~ 10 ~1~ - -
Opbouw:
| Veld | Uitleg |
|---|---|
|
Veld 1 |
Datum ontstaan post |
|
Veld 2 |
Omschrijving uit de post |
|
Veld 3 |
Titel van het materiaal of omschrijving van de boekingscode |
|
Veld 4 |
Datum waarop de berekeningen zijn gebaseerd (bv inleverdatum van het exemplaar) |
|
Veld 5 |
Bedrag |
|
Veld 6 |
Statussen: (I=Incasso, D=Deurwaarder) |
|
Veld 7 |
Datum post doorgestuurd naar deurwaarder |
|
Veld 8 |
Id van de post, kan worden gebruikt bij het betalen van deze post (unieke identificatie) |
|
Veld 9 |
Posttype |
|
Veld 10 |
Datum afbetalingsregeling |
Dialoog 41/42: Opvragen gedane betalingen
De velden zijn door een tilde gescheiden i.p.v. een '-'
YZ-regel: 01-11-2009 ~ Registraties ~ 0.40 ~ Munt ~ Omschrijving
Dialoog 37/38: Betalen openstaande posten
Toegevoegd: meerdere id's in veld fee_identifier (CG), gescheiden door een '+'
CG<id>+<id>+<id>+
vb: CG2500+417+312+
Deze posten zullen eerst worden afgehandeld, mocht er nog geld over zijn dan wordt dat als tegoed op deposito gestort.
Toegevoegd: veld ‘FX’
Dit veld kan worden gebruikt voor het bijeenhouden van betalingen zodat de betaalde posten naar het juiste dagboek kunnen worden teruggeleid. Het is een 5 cijferig getal en wordt door de automaat uitgegeven. De automaat kan bv een volgnummer per klant per dag bijhouden. Dit volgnummer wordt in veld 'FX' meegegeven en wordt doorgegeven bij zowel het verhogen van de tegoeden als het betalen van de posten.
Voorbeeld:
De klant heeft 2 openstaande posten, beide 1.25 euro. De id's van deze posten zijn 464305 en 464306 (verkregen via dialoog 41/42)
3720200117 1347060100EURBV1.25|AOBicat|AA28340011105903|AC|AD|CG|BK|FX12345|FC1.25|AY1AZEAD4
3720200117 1347060101EURBV1.25|AOBicat|AA28340011105903|AC|AD|CG|BK|FX12345|FC1.25|AY1AZEAD4
3720200117 1347060109EURBV2.50|AOBicat|AA28340011105903|AC|AD|CG464305+464306+|BK|FX12345|FB2.50 |AY1AZEAD4
Regel 1: stort 1.25 op tegoed. De betaalwijze is contant (paymenttype 00), volgnummer is 12345 (veld FX)
Regel 2: stort 1.25 op tegoed. De betaalwijze is betaling via bank (paymenttype 01), volgnummer is 12345 (veld FX)
Regel 3: betaal posten met id's 464305 en 464306 via het tegoed (paymenttype 09), gebruik stortingen gedaan onder volgnummer 12345 (veld FX)
Gevolg in Wise:
Post 464305 zal op dagboek Knnn worden gesloten
Post 464306 zal op dagboek Bnnn worden gesloten
De gedane betalingen, de stortingen op tegoed, zullen worden verwijderd uit de database en verstoren het journaal niet langer. Deze werkwijze werkt alleen voor gedane stortingen op dezelfde dag.
Als de automaat de id's van de openstaande posten niet meegeeft zal Wise automatisch de oudste posten het eerst afboeken net zolang totdat het tegoed is opgebruikt. De id's van de openstaande posten zijn via dialoog 41/42 op te vragen.
Dialoog 63/64: Opvragen lenersinfo
Indien in veld “FW” de waarde “B” wordt meegegeven wordt dat geïnterpreteerd als het opvragen van klantgegevens voor een Betaal station. In dat geval zal de klant niet worden gestopt als deze te veel registraties op heeft staan. De volgende velden worden nu standaard meegegeven naast de reguliere velden:
- Veld FN, bevat de naam van de klant voluit bv t.b.v. printen klantnaam
- Veld FM, bevat pasnummers van de klanten waarvoor (ook) mag worden betaald.
- Veld FO, bevat de gebruikersnaam van de klant
- Veld FU, bevat de statistische categorie van de klant, wordt meegegeven indien de betaal- of maken_boekingen licentie is afgenomen.
- Veld LF, bevat de geboortedatum van de klant in formaat yyyymmdd
- Veld AK, bevat per geleend materiaal het exemplaarnummer, titel en inleverdatum (formaat dd-mm-yyyy). Voorbeeld: AK10000021028319 De Terugkeer – 22-03-2012|
Voor betaalautomaten met een sip2-plus-licentie zal in het veld FM de pasnummers worden doorgegeven van de klanten waarvoor ook de ingelogde klant ook mag betalen. Hiervoor moet de LIC_MACHTIGING zijn gezet en moet voor de betreffende klant de machtiging voor betalen zijn ingesteld. Ook de pasnummers van hoofd/neven-abonnementen zullen hierin worden meegegeven.
Storten en verbruiken tegoeden
Algemene werkwijze
Lener wordt aangemeld met dialoog 63/64. Hierbij wordt de pincode gecontroleerd als hiervan gebruik gemaakt wordt. In het antwoord wordt in veld FeeLimit (CC) het bedrag geretourneerd wat de gebruiker kan besteden.
Opmerking:
De bestedingsruimte (FeeLimit) wordt bepaald door:
- Totaal openstaande bedrag aan registraties (moet nog worden betaald)
- Totaal tegoed van de klant (heeft de klant op zijn pas gestort)
- Instelling van het bedrag dat een klant maximaal 'rood' mag staan.
De bestedingsruimte is dan (tegoed + rood_bedrag) – openstaande registraties. Openstaande contributie heeft geen invloed op de bestedingsruimte. Het bedrag dat een klant maximaal rood mag staan wordt in OCLC Wise vastgelegd in de abonnementsdefinitie van de klant. Voor verschillende soorten klanten kan het rood-bedrag dus anders zijn.
Indien de bestedingsruimte onvoldoende is moet de klant eerst geld storten op zijn tegoed (deposito). Hiervoor is SIP2 dialoog 37 beschikbaar die telkens na aanroep retour geeft het bedrag dat de klant nog kan gebruiken (FeeLimit). Na gebruik van de faciliteit (kopieerapparaat, internetgebruik etc.) wordt aan OCLC Wise gemeld, d.m.v. dialoog 39, hoeveel geld er is gebruikt. OCLC Wise boekt dit af van het tegoed (deposito) van de klant. Er wordt geen geld geretourneerd, het niet gebruikte tegoed blijft staan.
Opmerking:
Negatieve bedragen worden niet geaccepteerd.
Gebruikers die niet bekend zijn in OCLC Wise kunnen geen deposito storten. Wel kan worden vastgelegd dat zij van de faciliteiten gebruik hebben gemaakt. Dit gaat d.m.v. het nieuw te maken dialoog 39 waarbij de 'Payment Method Type' gevuld moet zijn en geen '09' (deposito) mag zijn.
Storten deposito voor niet anonieme leners
Opmerking:
Klant moet bekend zijn in OCLC Wise!
Dialoognummers: 37/38
Aanvulling op het SIP2 protocol:
Veld FA,FB of FC om aan te geven waarvoor het geld gebruikt gaat worden.
FA – betaling contributieposten
FB – betaling registraties
FC – verhoging deposito
Voor deze toepassing moet dus FC worden gebruikt.
Voorbeeld request
3720091116 0910000000AA29444000001179|AOHKA-Testbibliotheek|BV10.00|FC10.00|AY2AZE1EF
Bericht 37
Transaction date : 16-11-2009 (09:10:00)
Fee type : 00 (wordt niet gebruikt)
Payment type : 00 (00-cash,01-visa,02-creditcard,03-chipknip)
Patron-id : 29444000001179
Bedrag : 10.00
Doel : verhoging deposito (veld FC) met 10.00 euro
Betalingswijze : cash
Volgnr dialoog : 2
checksum : E1EF (fictief in dit voorbeeld)
Het bedrag wordt zowel in het veld BV als FC meegegeven.
Voorbeeld response
Het standaard SIP2 38 antwoord wordt aangevuld met het nieuwe limiet in veld CC (FeeLimit)
38Y20091116 091000AOHKA-Testbibliotheek|AA29444000001179|AFBetaling akkoord|APBetaling akkoord|CC10.00|AY2AZE1EF
Bericht 38
Betaling akkoord : Y
Transaction date : 16-11-2009 (09:10:00)
Patron-id : 29444000001179
Huidige limiet : 10.00
Volgnr dialoog : 2
Checksum : E1EF (fictief in dit voorbeeld)
Verbruik deposito bij niet anonieme leners of registratie faciliteitsgebruik door anonieme klant
Dialoognummers: 39/40
Request
39<transaction date><Patron Identifier><Fee amount><Fiscal Transaction Type><Payment Method Type>
Het bericht wordt standaard afgesloten met een sequence number en evt. een checksum
Response
40<payment accepted><Patron Identifier><screen message><print line>
|
Veld |
Code |
Format |
|---|---|---|
|
Transaction date |
18 pos. Verplicht veld: YYYYMMDDZZZZHHMMSS |
|
|
Fee Amount |
BV |
Variabele lengte verplicht veld, nummeriek format nnnnnn.nn (decimalen na de punt) |
|
Fiscal Transaction Type |
FH |
4 pos nummeriek, verplicht veld, bevat de boekingscode in OCLC Wise wordt gebruikt. Dialoog wordt geweigerd als dit veld leeg is of als deze niet voorkomt in OCLC Wise. Alleen boekingscodes beginnend met een 2,3 of 4 worden geaccepteerd (2xxx,3xxx,4xxx) |
|
Patron Identifier |
AA |
Variabele lengte, optioneel. Als dit veld wordt gebruikt moet de klant bekend zijn in OCLC Wise. Is de klant niet bekend, dan wordt de dialoog geweigerd. Ontbreekt het veld dan wordt klant als anoniem beschouwd. |
|
Payment Method Type |
FI |
2 posities, nummeriek, 00 – cash, 01 – visa, 02 – credit card, 03 – chipknip, 09 – deposito. Bij leners bekend in OCLC Wise moet hier altijd '09' worden gebruikt. Bij anonieme leners mag '09' niet worden gebruikt en moet deze waarde '00','01','02' of '03' zijn. Pin betalingen worden als bank (dus 01 of 02) doorgegeven. |
Er wordt niet gewerkt met 'patron passwords'. Dit gebeurt reeds in dialoog 63/64.
Fee Amount
Het bedrag mag nooit hoger zijn dan de 'FeeLimit' doorgegeven in dialoog 63/64 of 37/38. Van de bedragen wordt verondersteld dat deze in EURO's zijn.
Voorbeeld request
3920091116 091000AA29444000001179|BV1.00|FH2910|FI09|AY3AZE1EF
Bericht 39
Transaction date : 19-03-2003 (09:10:00)
Patron-id : 29444000001179
Bedrag : 1.00
Actie : Internet gebruik
Boekcode : 2910
Betalingswijze : deposito (klant is bekend in OCLC Wise)
Volgnr dialoog : 3
checksum : E1EF (fictief in dit voorbeeld)
Voorbeeld response
40Y20091116 091000AA29444000001179|AF1.00 euro van uw tegoed afgeboekt|AG1.00 euro van uw tegoed afgeboekt|CC9.00|AY3AZE1EF
Bericht 40
Betaling akkoord : Y
Transaction date : 16-11-2009 (09:10:00)
Patron-id : 29444000001179
Schermmelding : 1.00 euro van uw tegoed afgeboekt
Printmelding : 1.00 euro van uw tegoed afgeboekt
Huidige limiet : 9.00
Volgnr dialoog : 3
Checksum : E1EF (fictief in dit voorbeeld)
Vastleggen tegoed t.b.v. anonieme klanten of dagpas klanten
De doelstelling is het vastleggen van een tegoed wat vervolgens door een, voorheen, anonieme klant kan worden gebruikt voor bijvoorbeeld internettoegang. Het idee is dat een anonieme klant een tegoed stort in OCLC Wise. OCLC Wise maakt van deze anonieme klant een reguliere OCLC Wise klant met een speciaal klantnummer waardoor deze te herkennen is. Na het aanmaken kan deze klant als een reguliere klant worden behandeld en kan deze dus ook zijn/haar tegoed ophogen.
Dialoognummers: 37/38
Aanvulling op het SIP2 protocol:
Veld FC geeft aan dat het om het ophogen van een tegoed gaat
Voor anonieme klanten:
Veld AA bevat geen lenersnummer maar de tekst “**ANONIEM**”
Voor dagpas klanten:
Veld AA bevat geen lenersnummer maar de tekst “**DAGPAS**”
Dit is beschikbaar vanaf OCLC Wise versie 6.4.1
Het verschil tussen anonieme klanten en dagpas klanten is dat dagpas klanten slechts 1 dag gebruik kunnen maken van de diensten. Elke nacht wordt de status van deze klanten op ‘bedankt (9)’ gezet. Als er een pincode wordt meegegeven dan zal deze bij de anonieme klant worden opgenomen. Als deze later het tegoed weer wil ophogen dan moet dezelfde pincode weer worden gebruikt.
Voorbeeld request
3720180115 1347060000EURBV10.00|AA**ANONIEM**|AOHKA-Testbibliotheek|FC10.00|AY2AZE1EF
Bericht 37
Transaction date : 15-01-2018 (13:47:06)
Fee type : 00 (wordt niet gebruikt)
Payment type : 00 (00-cash,01-visa,02-creditcard,03-chipknip)
Patron-id : **ANONIEM**
Bedrag : 10.00
Doel : verhoging deposito (veld FC) met 10.00 euro
Betalingswijze : cash
Volgnr dialoog : 2
checksum : E1EF (fictief in dit voorbeeld)
Voorbeeld voor dagpas klanten:
3720180115 1347060000EURBV10.00|AA**DAGPAS**|AOHKA-Testbibliotheek|FC10.00|AY2AZE1EF
Bericht 37
Transaction date : 15-01-2018 (13:47:06)
Fee type : 00 (wordt niet gebruikt)
Payment type : 00 (00-cash,01-visa,02-creditcard,03-chipknip)
Patron-id : **DAGPAS**
Bedrag : 10.00
Doel : verhoging deposito (veld FC) met 10.00 euro
Betalingswijze : cash
Volgnr dialoog : 2
checksum : E1EF (fictief in dit voorbeeld)
Enkele opmerkingen:
Het bedrag wordt zowel in het veld BV als FC meegegeven. Zonder aanwezigheid van het veld FC werkt deze dialoog niet.
De payment type mag geen 09 zijn. Deze is gereserveerd voor tegoeden en het storten van een tegoed mag niet worden betaald vanuit een tegoed.
Voorbeeld response
Het standaard SIP2 38 antwoord wordt aangevuld met het nieuwe limiet in veld CC (FeeLimit)
38Y20091116 091000AOHKA-Testbibliotheek|AA299970001012345|AFBetaling akkoord|AGBetaling akkoord|CC10.00|AY2AZE1EF
Bericht 38
Betaling akkoord : Y
Transaction date : 16-11-2009 (09:10:00)
Patron-id : 29997000101234. Dit is het gegenereerde klantnummer waaronder deze klant vanaf nu bekend is.
Huidige limiet : 10.00
Volgnr dialoog : 2
Checksum : E1EF (fictief in dit voorbeeld)
In verdere communicatie moet nu het zojuist gegeneerde lenersnummer worden gebruikt.
NB. Deze dialoog zal alleen maar werken als de klant waar deze functionaliteit wordt aangeboden dit heeft geregeld met OCLC.
Opvragen gedane betalingen
Deze aanvulling dient voor het verkrijgen van een boekingen overzicht. De boekingen worden ingeteld per datum-soort-betaalwijze. Hierbij worden de bedragen opgeteld van boekingen gedaan op dezelfde dag van hetzelfde soort en dezelfde betaalwijze. Tevens kan deze dialoog worden gebruikt om een overzicht te krijgen van de nog openstaande schulden.
Dialoognummers: 41/42
Request
41<transaction date><Patron Identifier><Date from><Date To><Payment Method Type><Debt type>
Het bericht wordt standaard afgesloten met een sequence number en evt. een checksum
|
Veld |
Code |
Format |
|---|---|---|
|
Transaction date |
18 pos. Verplicht veld.: YYYYMMDDZZZZHHMMSS |
|
|
Patron Identifier |
AA |
Variabele lengte. Verplicht veld. |
|
Payment Method Type |
FI |
2 posities, numeriek, 00 – cash, 01 – visa, 02 – credit card, 03 – chipknip, 09 – deposito. |
|
Date From |
FJ |
Verplicht veld. Datum vanaf. De te selecteren posten moeten op of na de aangegeven datum zijn afgehandeld. Format: dd-mm-jjjj |
|
Date To |
FK |
Verplicht veld. Datum tm. De te selecteren posten moeten voor of op de aangegeven datum zijn afgehandeld. Format: dd-mm-jjjj |
|
Debt type |
FA |
Weergeven van contributieposten (FA), Registraties (FB) of Deposito (FC). 0, 1 of meer mogen voorkomen in de dialoog. Bij ontbreken zullen alle soorten worden meegenomen. Bij gebruik van het veld FD zullen alleen de openstaande schulden worden weergegeven. Als tevens FA,FB of FC is gebuikt dan zullen deze worden genegeerd. Veld FG bepaalt dat alleen het openstaande aantal leenstrippen zal worden weergegeven. Dit kan niet in combinatie met andere codes worden gebruikt. |
Er wordt niet gewerkt met 'patron passwords'. Dit gebeurt reeds in dialoog 63/64.
NB. Veld FD bepaalt of het een 'schuld' overzicht is of niet. In geval van een schuldoverzicht is het gebruik van de Payment Method Type niet relevant en zal worden genegeerd.
Response
42[<YZmessage>|]
Het nog niet bestaande Field Identifier 'YZ' wordt hier gebruikt.
Het antwoord bestaat uit een of meer tekstregels met de volgende layout:
YZDatum ~ Soort ~ Bedrag ~ Betaalwijze|
Soort kan zijn:
'Contributie', 'Registraties', 'Deposito'. Hier kan om gevraagd worden via de 'Debt. Type' in het request. Deze kunnen niet gecombineerd worden opgevraagd.
Betaalwijze kan zijn:
Munt, chipknip, bank/giro (betaling via creditcard)
Voorbeeld request, opvragen gedane betalingen
4120091116 091000AA29444000001179|FJ01-11-2009|FK30-11-2009|FI00|FAY|AY3AZE1EF
of
4120091116 091000AA29444000001179|FJ01-11-2009|FK30-11-2009|FI00|FBY|AY3AZE1EF
of
4120091116 091000AA29444000001179|FJ01-11-2009|FK30-11-2009|FI00|FCY|AY3AZE1EF
Bericht 41
Transaction date : 16-11-2009 (09:10:00)
Patron-id : 29444000001179
Datum vanaf : 01-11-2009
Datum t/m : 30-11-2009
Payment type : 00 (00-cash,01-visa,02-creditcard,03-chipknip)
Debt type : Contributie of Registraties of Deposito posten
Volgnr dialoog : 3
Checksum : AZE1EF
Voorbeeld antwoord
42YZ01-11-2009 ~ Registraties ~ 10.00 ~ munt ~ <omschrijving>|YZ01-11-2009 ~ Contributie ~ 15.00 ~ munt ~ <omschrijving>|AY3AZE1EF
Bericht 42
1e boeking : 01-11-2009 ~ Registraties ~ 10.00 ~ Munt ~ omschrijving
2e boeking : 01-11-2009 ~ Contributie ~ 15.00 ~ Munt ~ omschrijving
Volgnr dialoog : 3
Checksum : E1EF (fictief in dit voorbeeld)
Voorbeeld request, opvragen openstaande posten
4120100310 091000AA29444000001179|FJ01-01-2009|FK31-12-2010|FDY|AY3AZE1EF
Bericht 41
Transaction date : 10-03-2010 (09:10:00)
Patron-id : 29444000001179
Datum vanaf : 01-01-2009
Datum t/m : 31-12-2010
Debt type : Schuld overzicht
Volgnr dialoog : 3
Checksum : AZE1EF
Voorbeeld antwoord
42YZ01-12-2009 ~ Volw 4155 E ~ Abonnement ~ 01-01-2010 ~ 41.00 ~ J ~ - - ~ 382 ~ 1 ~ - -|YZ25-02-2010 ~ Boekbeschadiging ~ ~ 01-01-2010 ~ 4.00 ~ ~ - - ~ 393781 ~ 4 ~ 01-04-2010|YZ05-03-2010 ~ Vervangen pas ~ ~ 05-03-2010 ~ 3.00 ~ ~ - - ~ 393831 ~ 2 ~ - -|AY0
Bericht 42
1e regel : 01-12-2009 ~ Volw 4155 E ~ ~ 01-01-2010 ~ 41.00 ~ J ~ - - ~ 382 ~ 1 ~ - -
veld 1: 01-12-2009 : boekdatum (datum ontstaan post)
veld 2: Volw 4155 E : omschrijving post
veld 3: <leeg> : titel (leeg bij abonnement regels)
veld 4: 01-01-2010 : startdatum abonnement
veld 5: 41.00 : bedrag vordering
veld 6: J : bedrag zal via automatische incasso worden geind
veld 7: - - : datum waarop vordering aan deurwaarder is overgedragen
veld 8: 382 : unieke recordnummer, kan worden gebruikt voor afboeken van deze post
veld 9: 1 : type post, zie verder voor definitie
veld 10: - - : datum afbetalingsregeling. Indien gevuld hoeven deze posten voor deze datum niet te worden betaald
2e regel : 25-02-2010 ~ Boekbeschadiging ~ ~ 01-01-2010 ~ 4.00 ~ ~ - - ~ 393781 ~ 4 ~ 01-04-2010
3e regel : 05-03-2010 ~ Vervangen pas ~ ~ 05-03-2010 ~ 3.00 ~ ~ - - ~ 393831 ~ 2 ~ - -
Volgnr dialoog : 0
Post typen:
|
1 |
Contributie posten |
|
2 |
Boetes/leengeld etc. |
|
3 |
Winkelverkopen |
|
4 |
Kasontvangsten |
Voorbeeld request, opvragen leenstrippen
4120091116 091000AA20105000000011|FGY|AY3AZE1EF
Bericht 41
Transaction date : 16-11-2009 (09:10:00)
Patron-id : 20105000000011
Debt type : Overzicht leenstrippen
Volgnr dialoog : 3
Checksum : AZE1EF
Voorbeeld antwoord
42FGBoekenstrips~35|FGStrippen-2~75|FGStrippen3~Afgekocht|AY3AZE1EF
Bericht 42
1e regel : Boekenstrips, 35 stuks
2e regel : Strippen2, 75 stuks
3e regel : Strippen3, afgekocht.
Volgnr dialoog : 3
Checksum : E1EF (fictief in dit voorbeeld)
Leenstrippen
Opmerking:
Alleen actief als de licentie is geregeld.
Opvragen leenstrip koop mogelijkheden, dialoog Y1/Y2.
Dialoog Y1 kan worden gebruikt voor het opvragen van de mogelijk te verkopen strippen. In de dialoog dient het lenersnummer te worden weergegeven waarna het systeem antwoord met de strippen die voor deze lener van toepassing zijn.
Request: Y1
Y120091116 091000AA20105000000011|AY3AZE1EF
Veld AA dient het lenersnummer te bevatten
Antwoord:
Y21[FGStripsoort ~ Boekingscode ~ Omschrijving ~ Aantal ~ Prijs|]AF<tekst>|seq.nr
Indien het verzoek niet correct was, zal de status op 0 worden gezet (Y20).
Verzoek tot vastleggen verkoop strippen, dialoog Y3/Y4
Request Y3
Voorbeeld:
Y320161116 091000AA20105000000011|FG01-40-15.75-4810 ~ 02-35-13.25-4810|FI00|AY0000
Veld AA bevat: lenersnummer
Veld FG bevat: stripsoort - aantal - prijs - boekingscode
Veld FI bevat: payment type
De diverse verkopen worden door een tilde gescheiden.
Let op: het genoemde stripsoort komt voort uit dialoog Y1. Daar wordt ook een omschrijving meegegeven die op het scherm kan worden getoond zodat de klant weet wat voor soort strippen het zijn.
Antwoord:
Y4[1/0]AF<melding>
Waarbij 1=ok en 0 = niet ok, veld AF bevat een melding verklarende melding.
Dubbele leentermijn
Opmerking:
Alleen actief als de licentie is geregeld.
Via veld 'FE' in dialoog 11 kan worden aangegeven dat de lener een dubbele leentermijn wenst. Dit veld moet dan een 'Y' bevatten. Kan worden gebruikt bij uitlenen en verlengen (dialoog 11 resp. 29)
Opvragen overige familieleden
Opmerking:
Alleen actief als de licentie is geregeld.
Dialoog 63/64 is uitgebreid met het veld FM. Dit veld bevat het (hoofd)pasnummer, naam, openstaande contributieposten, openstaande registraties en openstaand deposito.
De structuur is als volgt:
[FM<lenersnummer> ~ <naam> ~ <contributie> ~ <registraties> ~ <deposito>|]
Opvragen / saven gebruikersnaam
Opmerking:
Alleen actief als de licentie is geregeld.
Dialoog X1/X2 is beschikbaar voor het vastleggen van een gebruikersnaam bij een (anonieme) lener.
De structuur is als volgt:
X1<FO<gebruikersnaam>|AA<lenersnummer>|AD<pincode>
voorbeeld:
X1FPjan12345|AA20105000000011|AD1234
Antwoord:
X2<status>|AA<lenersnummer>|FO<gebruikersnaam>|AF<tekst>
Status kan zijn:
0 – Foutsituatie
1 – Akkoord
Welke licenties zijn gezet?
In dialoog antwoord 98 wordt in veld 'GG' doorgegeven welke licenties zijn gezet voor deze client:
98YYYYYY30000320110201 1138402.00AO|BXYYYYYYNYYYYNNNYY|AMBibl.Test|GGLIC_SORTEER / LIC_BETAAL / LIC_MAKEN_BOEKINGEN / LIC_VERLENGMOGELIJKHEDEN|AFWelkom <automaat>|AY1AZD052
In dit voorbeeld zijn de volgende licenties gezet:
- SORTEER
- BETAAL
- MAKEN_BOEKINGEN
- VERLENGMOGELIJKHEDEN
SIP2+
Naast de bovenstaande opties kan een leverancier met OCLC aanvullende mogelijkheden activeren:
- Verkoop van afgeschreven (verkoopbare) materialen.
- Vragen om bevestiging bij materialen die al eerder door klant zijn geleend.
- Vragen om bevestiging bij materialen die een bijlage hebben.
- Vragen om bevestiging bij materialen die schade hebben.
In bovenstaande gevallen zal de klant eerst om bevestiging moeten worden gevraagd alvorens de uitlening/verkoop kan worden doorgezet. De meldingen worden doorgegeven in het veld FV. De bevestiging gebeurt in het veld FV indien in het request dit veld een 'Y' bevat geldt dat als een bevestiging van de vragen. Voor toepassing van het melden van eerder geleend moet de optie: LEENHIS zijn gezet. Per poort (toegang tot OCLC Wise) kan worden aangegeven of een automaat deze optie ondersteunt.
Indien de licentie NIET is afgenomen:
- Verkoop van afgeschreven materialen is niet mogelijk
- In veld FV wordt doorgegeven wanneer de lener het exemplaar voor het laatst een exemplaar van dezelfde titel eerder heeft geleend. De uitlening is dan al doorgezet.
- Materialen met bijlage worden uitgeleend via de instellingen in OCLC Wise, als dat mag is de uitlening al doorgezet.
- Materialen met schade worden gewoon uitgeleend.
Voorbeeld:
Zonder bevestiging:
11YN20110905 09301320110905 093013|AO|AA28340011105903|AB10000021028319|BON|BIN|AY1
Antwoord:
120NNN20110905 092633AOBibl.8340|AA28340011105903|AB10000021028319|AJDe Terugkeer van de dansleraar|AH|BHEUR|BV0.00|BK0|ST0|FVTitel eerder geleend op: 26-08-2011|AY1
Met bevestiging:
11YN20110905 09301320110905 093013|AO|AA28340011105903|AB10000021028319|BOY| FVY |BIN|AY1
Antwoord:
121NNY20110905 093013AOBibl.8340|AA28340011105903|AB10000021028319|AJDe Terugkeer van de dansleraar|AH26-09-2011|BHEUR|BV0.10|BK4|ST0|AFUitlening akkoord|AFEUR. 0.10 Leengeld|FQ0337|FQ0342|AGLeengeld|AGEUR. 0.10 Leengeld|AY1
Opvragen verlengmogelijkheden
Opmerking:
Alleen actief als de licentie is geregeld.
Dialoog 70/71 is beschikbaar voor het opvragen van de verleng-mogelijkheden voor de klant of specifieke exemplaren.
Request:
7020110907 092600|AA28340011105903|AB|AY1
Response:
71GC8340450365719~Het schateiland : een oud verhaal van R.~11-11-2011~12-12-2011~0.00~0.15~0~0.00~|GC8340450371998~Brandt New York?~28-09-2011~26-10-2011~0.00~0.15~0~0.00~|GC8340450372020~Roebels voor de generaal / Tais Teng ; t~25-07-2011~05-10-2011~4.30~0.15~0~0.00~|GC8340450372053~De wraak van Rachwana / Peter Vervloed ;~25-07-2011~05-10-2011~4.30~0.15~0~0.00~|GC8340450372079~Kinderen gezond grootbrengen : wegwijzer~02-05-2011~05-10-2011~7.50~0.15~0~0.00~|FG0|AY1
Velden worden gescheiden door een tilde.
Veld 1 2 3 4 5 6 7 8 9
GC-regel: 8340450365719~Het schateiland : een oud verhaal van R.~11-11-2011 ~ 12-12-2011 ~ 0.00 ~ 0.15 ~ 0 ~ 0.00 ~|
Opbouw:
| Veld | Betekenis |
|---|---|
|
Veld 1 |
Te verlengen exemplaarnummer |
|
Veld 2 |
Titel |
|
Veld 3 |
Huidige inleverdatum |
|
Veld 4 |
Nieuwe inleverdatum (als verlengen is toegestaan) |
|
Veld 5 |
Boete bij telaat verlengen |
|
Veld 6 |
Leengeld |
|
Veld 7 |
Aantal leenstrippen |
|
Veld 8 |
Verlenggeld |
|
Veld 9 |
Opmerkingen |
Verwerken van bijlagen met SIP2
OCLC Wise kan in combinatie met de mogelijkheden van de gebruikte automaat op verschillende wijzen omgaan met bijlagen. Belangrijk hierbij is:
- Per automaat moet in OCLC Wise de zgn. ZUS-instellingen zijn gezet.
- Per automaatleverancier zijn verschillende instellingen mogelijk voor de afhandeling van bijlagen.
- Sommige automaatleveranciers kunnen SIP2+ met OCLC Wise communiceren.
- De wijze van conversie (in de RFID) van de bijlage-gegevens van een exemplaar:
- Hoofdobject en bijlage hebben elk een eigen RFID-tag.
- In de RFID-tag van het hoofdobject is opgegeven hoeveel bijlagen (zonder RFID-tag) er zouden moeten zijn.
Op basis van bovenstaande instellingen en mogelijkheden zal er op verschillende manieren worden opgegaan met bijlagen.
Instellingen in de automaat zelf
De mogelijkheden hiervoor verschillen per leverancier/automaat. Bij de meeste leveranciers kan op een of andere manier worden ingesteld:
- Blokkeer uitlenen en/of innemen als het exemplaar volgens de gevonden RFID-tags onvolledig is.
- Vraag om bevestiging van de aanwezigheid van de bijlage(n) als er volgens de gegevens in de tag van het hoofdobject een of meerdere bijlagen zouden moeten zijn. Op basis van het door de klant gegeven antwoord zal de automaat de uitleen- of uitleenactie doorzetten naar het bibliotheeksysteem.
Zus-instellingen
- Exemplaren met bijlagen is inneembaar/methode (J/N)
- Exemplaren met bijlagen is uitlenen/methode (J/N)
(Als er een bijlagecode is opgenomen in het exemplaar)
|
N = Niet |
Innemen zal door OCLC Wise worden geblokkeerd. |
|
T = Tabel |
Bij de bijlagecode (TABBIJ) moet per code zijn opgegeven of de bijlage vraag 'overtreden mag worden door het publiek'. |
|
A = Altijd |
Een bijlage zal geen reden voor blokkeren voor inname zijn. |
Sorteren
Bij het innemen (9/10) zal OCLC Wise bepalen of er een reden is waarom het exemplaar niet direct teruggeplaatst mag worden in de bibliotheek. Als hiervoor een reden wordt gevonden, zal OCLC Wise dit aangeven in een blokkeerredenen aangeven. Deze reden wordt in de CL-veld meegegeven.
01 = Hits
02 = Reserveringen
03 = Transport
04 = Magazijn/Geblokkeerd
Exemplaren met een blokkeerreden zullen bij het innemen altijd de exemplaar-status D (uitgesorteerd) krijgen. Voor een juiste afhandeling MOETEN deze exemplaren alsnog in de OCLC Wise-client worden ingenomen. Als het exemplaar geen blokkeerreden heeft zal het exemplaar direct Binnen worden geplaatst. Hierbij zal in het CL de waarde 05 worden meegegeven. Deze exemplaren krijgen als exemplaarstatus de waarde B(innen).
Als een bibliotheek gebruik maakt van de mogelijkheid om de binnen-exemplaren uit te sorteren, moet in OCLC Wise de sorteerlicentie (voor de betreffende vestiging) worden aangezet.
Op basis van de plaatsing in de bibliotheek kan dan worden aangestuurd hoe het exemplaar moet worden uitgesorteerd. De sorteerwaarden 05 t/m 99 zijn hiervoor beschikbaar. Deze sorteerwaarde wordt meegegeven in het CL-veld. Als er fysiek moet worden gesorteerd zal de automaat de vertaling moeten maken van de waarde van het CL-veld naar het fysieke baknummer.
Bovenstaande beschrijving geeft een beeld in grote lijnen van de werking van het sorteren. Naast deze mogelijkheden zijn er mogelijkheden voor:
- Bepalen van baknummer per exemplaar.
- Bepalen van het baknummer op basis van de doelvestiging(transport)
- Mogelijkheden om op basis van materiaalsoort extra schermmeldingen te maken.
Deze mogelijkheden zullen in overleg met de betrokken systeembeheerder moeten worden besproken.
Versturen mail vanuit sip2
Het mogelijk om vanuit de automaat direct een mail naar de klant te sturen. Vanuit OCLC Wise is standaard het e-mailadres opgenomen in sip2 protocol. Het e-mailadres wordt meegeleverd in het BE-veld (dialoog 63/64).
SIP2 2-Factor Authentication
Het is mogelijk om 2-Factor Authentication in te stellen voor het toevoegen van SIP2 automaten.
- Ga hiervoor in de Manager naar Poort- en Profielbeheer > Profielen > ZUS profielen.
- Klik vervolgens op het ZUS profiel waarvoor de 2-Factor Authentication moet worden ingesteld of maak een nieuw ZUSprofiel aan. De 2-Factor Authentication is te activeren door een getal in te vullen bij ‘Geldigheid 2-Factor token’. Bij deze optie kan ingesteld worden hoelang een nieuwe token geldig is.
- (Optioneel) Selecteer ‘Vast IP adres voor 2-F authenticatie’ om een vast IP adres te forceren. Als het IP adres van de automaten niet meer gelijk is aan het IP-adres van de server dan moeten de automaten opnieuw het authenticatieproces door lopen.
Instellen van het ontvangende e-mailadres van het One Time Password (OTP)
Wise > Beheer organisaties > Vestigingen > (Selecteer de vestiging) > Tabblad NAW
- Vul een e-mailadres in bij ‘Email 2-factor authentication’.
- Er kan eventueel ook een CC gestuurd worden naar een tweede e-mailadres, hiervoor moet het veld ‘CC 2-factor authentication’ ingevuld worden.
Er wordt vervolgens een eenmalig wachtwoord naar het emailadres gestuurd op het moment dat er een nieuwe SIP2 automaat wordt gekoppeld. Dit eenmalig wachtwoord is 30 minuten geldig en wordt ook opgeslagen onder Wise > Poort- en profielbeheer > Poorten > Sip2 Two Factor Authentication
De berichten met het eenmalig wachtwoord zijn zogeheten ‘PCC’ berichten. Kijk voor meer informatie over het configureren van deze berichten in Publieksberichten (Berichtklasse P).
Afvangen status D exemplaren intelligente kasten
Exemplaren die gereserveerd zijn en door de klant worden ingeleverd via een automaat krijgen status D (uitgesorteerd). Deze exemplaren moeten normaal gesproken klaar gemaakt worden voor de reserveringsplank via de balie (Wise Client). Aan de hand van onderstaande functionaliteit gecombineerd met de intelligente kast is het mogelijk deze stap te versimpelen. De functionaliteit laat het toe de bovengenoemde exemplaren direct in de intelligente kast te plaatsen wat ze 'reserveringsklaar' maakt zonder tussenkomst van de Wise Client. Dit geldt alleen voor exemplaren die daadwerkelijk zijn gereserveerd in de vestiging waar ze uitgeleend zijn; in het geval ze op transport moeten komen, weigert de intelligente kast ze met een bijkomstige foutmelding. Van deze functionaliteit kan gebruik worden gemaakt door het veld DR op te nemen in het 09 dialoog:
- Indien in het SIP2 inname request veld DRY is meegegeven, zal de server de reservering afhandelen zoals een inname via de reguliere Wise Client.
- Indien in het SIP2 inname request veld DR niet wordt meegegeven dan wordt dit beschouwd als DRN.
- Indien in het SIP2 inname request veld DRN wordt meegegeven, zal de inname standaard worden afgehandeld behorende bij het gedrag van een zelfservice automaat.
- Er zijn geen aanvullende instellingen, licenties of opties nodig.
Verdere uitleg DR veld:
Huidige Situatie
Optie 1
Klant neemt een gereserveerd exemplaar in bij automaat (SIP):
- Het exemplaar krijgt status D.
- Het SIP antwoord bevat de uitzonderingenbak zoals geconfigureerd in het ZUS-profiel (02 by default).
Optie 2
Medewerker neemt het exemplaar in via de Client:
- Als er een reservering is die in deze vestiging afgehandeld wordt:
- Het exemplaar krijgt status R;
- Er worden mailtjes en dergelijke gestuurd.
- Het exemplaar gaat naar de domme reserveringenkast.
- Als er geen reservering is die in deze vestiging afgehandeld wordt (exemplaar heeft status D omdat het bijvoorbeeld op transport moet):
- De client geeft een melding
DRN
Optie 1
Klant neemt een gereserveerd exemplaar in bij automaat (SIP):
- Het exemplaar krijgt status D
- Het SIP antwoord bevat de uitzonderingenbak zoals geconfigureerd in het ZUS-profiel (02 by default).
Optie 2
Iemand neemt het exemplaar met status D in met iets dat SIP gebruikt:
- Als er een reservering is die in deze vestiging afgehandeld wordt:
- Geef een foutmelding.
- Als er geen reservering is die in deze vestiging afgehandeld wordt (exemplaar heeft status D omdat het bijvoorbeeld op transport moet):
- Geef een foutmelding.
DRY
Optie 1
Klant neem een gereserveerd exemplaar in bij automaat (SIP):
- Het exemplaar krijgt status D.
- Het SIP antwoord bevat de uitzonderingenbak zoals geconfigureerd in het ZUS-profiel (02 by default).
Optie 2
Medewerker neemt het exemplaar in met de intelligente kast (SIP):
- Als er een reservering is die in deze vestiging afgehandeld wordt:
- Het exemplaar krijgt status R.
- Er worden mailtjes en dergelijke gestuurd.
- Het exemplaar staat in de intelligente reserveringenkast.
- Het SIP antwoord bevat de uitzonderingenbak zoals geconfigureerd in het ZUS-profiel (02 by default).
- Als er geen reservering is die in deze vestiging afgehandeld wordt (exemplaar heeft status D omdat het bijvoorbeeld op transport moet):
- Weiger de inname