Skip to main content

 

OCLC Wise Support EN

SIP2 suppliers

SIP2 suppliers

Every SIP2 supplier can be granted access to a Wise system. OCLC is not responsible for the consequences of the operations of the connected SIP2 machines and systems. The license agreement between OCLC and the third-party supplier determines to which extent OCLC is responsible for the operations of the Wise systems.

Every SIP2 supplier has access to the default SIP2 dialogs. If the supplier wants to access the payment SIP2 dialogs, they should request a SIP2 supplier code from OCLC and OCLC will instruct and support the SIP2 supplier with configuring this code and logging into the Wise system. Using this code (and number), Wise can identify the SIP2 supplier. A supplier code will be granted to a requester for the uses in the agreement. Transferring this code is not allowed. Third-party suppliers should contact busdev@oclc.org to request a supplier code.

SIP2 suppliers that sign in with a supplier code are granted use of the payment SIP2 dialogs, but the license will be checked. SIP2 suppliers with a code can contact busdev@oclc.org   to request SIP2+. OCLC will instruct and support the supplier with the configuration and usage of the additional SIP2+ functionality. The SIP2 licenses must be activated by the SIP2 supplier for every branch that wants to use a payment terminal.

OCLC reserves the right to stop the support and operations of supplier codes and SIP2+ in cases of abuse.

Default SIP2-dialogs

From the default SIP2 protocol the following functions are supported:

Dialog Description
Dialog 9/10 Checking in
Dialog 11/12 Checking out
Dialog 17/18 Item info
Dialog 23/24 Patron status
Dialog 29/30 Renewing
Dialog 35/36 End of session
Dialog 63/64 Patron information
Dialog 65 /66 Renew every item
Dialog 97 Retry request
Dialog 93/94 Sign in / connect
Dialog 99/98 Sign in

SIP2 payment dialogs

For processing payments, OCLC has developed the following dialogs:

Dialog 37/38 Pay unpaid registrations
Dialog 41/42 View paid registrations

Usage of the dialogs depends on the following:

  • The SIP2 supplier should implement the SIP2 supplier code from OCLC correctly in the dialogs.
  • The software of the SIP2 supplier must be able to process the functionality.
  • The needed SIP2 licenses must be configured correctly for the library/branch/supplier.

SIP2-Plus (SIP2+)

Delivery of SIP2+-functionality is dependent on the following:

  • The SIP2 supplier has implemented SIP2+ by OCLC
  • The software of the SIP2 supplier is able to handle the functionality.
  • The needed SIP2 licenses have been configured correctly for the library/branch/supplier.

SIP2+ has the following functionality:

  • Selling of depreciated items: when checking out a depreciated item, it is possible to sell it to the patron.
  • When the patron checks out an already borrowed item, ask to confirm whether the patron wants to borrow the item again.
  • Confirming that items have an attachment.
  •  Handling attachments as configured in Wise.
  •  Confirming items are damaged.
  •  Checking out damaged items as configured in Wise.
  •  Working with duplicate loan periods.
  •  Improved error handling.
  •  Improved design of receipts.
  •  Paying for other patrons.
  •  Patron language preference.
  • Separate renewal dialog: see borrowed items, see if an item can be renewed, what the new loan period will be, and see the renewal costs.
  • Patron notifications: within Wise you can set individual or general notifications for a patron. These will be shown on a vending machine.

For more information, see the associated license below:
 

SIP2 licenses

The SIP2 machine receives access to additional functionality using these licenses. The following extensions are available and must be activated per branch/machine:

ANONIEME_LENERS

  • This machine can be used anonymously (creating/depositing credit).

BETAAL

  • Registrations can be paid using the methods configured in the SIP2 machine. Registrations can be viewed per type and per id (recno). Without this license, dialog 37 won’t be shown.
  • Dialog 41 can also be shown (about paid registrations).

DUBBELE_LEENTERMIJN

  • Support for double loan periods.

GEBRUIKERSNAAM

  • Support for saving the username in dialog X1.

FAMILIE

  • Ability to see if other family members have unpaid registrations. These registrations will be shown in the field FM.

ITEM_LENER

  • Showing the patron number in field AA in dialog 17/18 if the status of the item is U (loaned), R (on hold) or F (loaned to special patron).
  • This license is supplier-independent.

LENERS_MELDINGE N

  • Showing patron notifications in the AF-field.

LEENSTRIPPEN

  • Showing payment possibilities of punches and registering sold punches for patron (dialog Y1/Y2, Y3/Y4, Y5/Y6).
  • For registering punches, the license BETAAL must be configured as well.

MACHTIGING

  • Whether the library supports allowing patrons to let others pay unpaid registrations. With this license, this functionality is enabled.
  • Showing in dialog 64/64 whether there are unpaid registrations for patrons whom you are authorized to pay these registrations for. These are shown in the field FM.

MAKEN_BOEKINGEN

  •  Allows patrons to create a journal entry within Wise.
  • This license is needed for dialog 39 (depositing/creating credit for anonymous users). If a machine only needs to create a journal entry without the ability to pay them, this license is sufficient. Otherwise, the license BETAAL is needed.
  • The journal entry codes sent to Wise need to be known within the Wise system.

SORT_LIC

  • Without this license, Wise will always use the deposits 01 - 04. Every item that can be placed on the shelves will be placed in deposit 05. Only directly checking in items from patrons will be supported. For branches without this license and with a deposit for a temporary shelf, it will look at the filled deposit. Items from a route collection don’t receive status D but can be placed directly on the shelf. If no deposit is filled for the temporary shelf then it will use deposit 4.
  • If this license is configured, all items will be placed in a deposit (no. 05-99) corresponding to the configured shelf when checking in (09/10). Wise will also handle the transport items. For dialog 17/18, it will also show the deposit number if the item is not loaned. If the item is loaned, it won’t show a deposit number.
  • Dialog 43/44 (NBD-sorting) is only available in combination with this license.
  • The license must be configured for each branch and is independent of the supplier. The license is also available for SIP2-suppliers without SIP2-supplierscode.

VERLENGMOGELIJKHEDEN

  • Support for dialog 70/71 where the renewing options are shown.

VEST_WISSEL

  • Whether the machine is able to send the branch number with journal entries. Can be used with a central machine for the purpose of internet regulation. To create a journal entry, the license ‘MAKEN_BOEKINGEN’ must be configured.
License Conditions
ANONIEME_LENERS VEST/LEV
BETAAL VEST/LEV
DUBBELE_LEENTERMIJN PLUS/VEST
GEBRUIKERSNAAM PLUS/VEST
ITEM_LENER VEST/LEV
LENERS_MELDINGEN VEST/PLUS
LEENSTRIPPEN VEST/LEV
MACHTIGING PLUS/VEST (from 6.3.2)
MAKEN_BOEKINGEN VEST/LEV
SORT_LIC VEST
VERLENGMOGELIJKHEDEN PLUS/VEST
VEST_WISSEL VEST/LEV

Conditions:

  •     PLUS = Supplier needs a SIP2+ license.
  •     PLUS/VEST = Supplier needs a SIP2+ license and the branch must have configured the license.
  •     VEST/LEV = Supplier needs to share the SIP2-supplierscode and the branch must have configured the license.
  •     VEST = The branch must have configured the SIP2-license.

SIP2 Connection/response-times

Only SIP2 connections based on socket connections are supported in Wise. The character set of the data sent is UTF-8. The names of patrons or item descriptions can contain special characters.

The real response time depends on the network and server load, but for the most important dialogs (9/10, 11/12 and 63/64), one second is the maximum target response time. For the signing dialogs (93-99), the target response time is less than five seconds. For all other dialogs, the target response time is two seconds. Here, response time is the same as the response time from the Wise system.

 

 

  • Was this article helpful?