~~NOTOC~~
====== Inventory Status Interface ======

The Inventory Status Interface (ISI) is a telephony interface designed to allow users to report item and quantity information to one or more remote servers.  Although the original conception was to provide a method for a hotel's housekeeping staff to report usage of items from the guest room minibar, the interface has been designed to allow for any type of inventory reporting a user may require.

This dialog is used to configure both the telephony interface and how to communicate with the remote server(s) or PMS.

{{:images:vs8:vsconfig:inventory.png?direct|}}

===== User Interface Settings =====

These settings configure how the telephony user interface operates.

^Setting^Description^
|//Require user id//|Check this box to prompt for a user ID at the start of the call.\\ \\ //If this option is disabled, the system will not ask for a password either.//|
|//Require password//|Check this box to require a valid password after prompting for the user ID.\\ \\ //If the //Require user id// setting is disabled, the system will never ask for a password, even if this setting is enabled.//|
|//Block checked out postings//|Check this box if you want the system to block the housekeeping staff from posting minibar charges in checked-out rooms.|
|//Allow zero quantity//|Defaults to force client to enter a value greater than 0. Checking this field allows them to enter a quantity of 0 or skip entry.|
|//Use custom room list.//|If checked the Administrator must add individual rooms to the Inventory Web Interface. Default is unchecked which uses the list of guest mailboxes.|
|//Enable data entry for multiple rooms//|Check this box if you want the telephony interface to allow data entry for more than one room in the same call.\\ \\ //Default is// ''disabled''.|
|//Room number source//|Use the selection box to select how the room number is determined.\\ <WRAP>
  * **//Ask Caller//** -- Always ask the caller for the room number.
  * **//Use Calling Party//** -- Use the calling party (caller ID) as received from the PBX. //If the calling party information was not provided, the system will ask the caller instead.//
  * **//Use Called Party//** -- Use the called party as received from the PBX. //If the called party information was not provided, the system will ask the caller instead.//
</WRAP>|

===== Global Settings =====

This section lists server-side settings that are global across all servers.

^Setting^Description^
|//Post Delay (seconds)//|Set the amount time after a change is sent to the ISI before it is posted to all configured servers.  Value is in seconds.\\ \\ Range is 10 to 999 seconds.  Default is ''60'' seconds.|

===== Per-Server Settings =====

Use the selection box to choose one of five servers to configure, then configure the remaining settings for the selected server.

^Setting^Description^
|//Enabled//|Check this box to enable the selected server.|
|//Protocol//|Select the protocol to use for the selected server.\\ <WRAP>
  * **//HTTP POST JAZZ//** -- Perform an HTTP Post with the content being XML. This was originally called //DuVoice Version 1.00//. This is the default setting.
  * **//HTTP POST JSON//** -- Perform an HTTP Post with the content being JSON.
  * **//HTTP POST FORM//** -- Perform an HTTP Form Post.
  * **//Comtrol//** -- Choose this option if you are using a Comtrol device.
  * **//Opera Minibar//** -- Choose this option if you are sending the minibar data through the PMS link to an Opera PMS and you want to use the Minibar message type.
  * **//Opera Direct Charge//** -- Choose this option if you are sending the minibar data through the PMS link to an Opera PMS and you want to use the Direct Charge message type.
</WRAP>|
|//IP address or name//|Enter a valid URL address or server name for the remote server. Examples: <nowiki>http://192.168.25.122/ivr/isi</nowiki> or <nowiki>https://192.168.25.122/ivr/isi</nowiki> |
|//TCP/IP port//|Enter the TCP address to use to connect with the remote server. Only used when connecting to Opera. |
|//Username//|Optional username in order to support basic security.|
|//Password//|Optional password in order to support basic security.|
|//Retry interval//|Enter the number of seconds to wait after failing to connect to the remote server before making another attempt.\\ \\ //The default value is// ''60'' seconds.|
|//Maximum attempts//|Enter the maximum number of times to attempt connecting to the remote server before logging a failure.\\ \\ //The default value is// ''30'' //attempts.//|

<WRAP round info 75%>
**If the protocol is set to either //Comtrol//, //Opera Minibar// or //Opera Direct Charge//, all fields in the Server Settings box except //Enabled// and //Protocol// will be grayed-out and ignored.\\ \\ In the case of Comtrol, the data is routed through the Comtrol connector so all further configuration must be done on the [[vs7:manual:syscon:conn:comtrol|Comtrol connector]] page.\\ \\ For the two Opera protocols, the data is routed through the hospitality server so that it gets sent to the Opera PMS over the PMS Link.**
</WRAP>