Inventory Status Interface Overview

Transcription

1 Inventory Status Interface Overview Inventory Status Interface (ISI) is a telephony interface allowing users the ability to report item and quantity information to remote servers. The original design was for reporting inventory of the room mini-bar by maid staff. However the interface has been designed to allow for any type of inventory reporting the user may have in mind. Features No PMS required. No VM/AA required. No mailboxes required. Unlimited number of user accounts. Unlimited number of items. Telephony interface uses user s configured language. All items may have a recorded description in any language supported. Reporting of all item and user changes made via web interface. Support posting changes to five remote servers simultaneous. Requirements Inventory Status Interface is a licensed feature and must be purchased from DuVoice on a per-site basis. Administration Administration for ISI is provided via InnDesk under the Inventory tab. Items Manage inventory items. Users Manage user accounts used in telephony interface. Rooms Manage rooms associated with the inventory system. Room Fields Manage custom fields associated with rooms. Change Log Log of any Item, User, or Room changes made via InnDesk. Server? Logs View recent activity associated with a specific ISI remote server. Sync with Voic Provides a form allowing the user to sync guest rooms with rooms in the inventory system.

2 Items List contains the Item ID, Description and Price of each item. The list is sorted by the Description field. You can search for any item using a partial ID or Description placed in the search box provided. Selecting either the Item ID or the Description will present a form allowing it to be changed. Prices for items should be entered in monetary form. However this field is not used or interpreted by the inventory server therefore it may contain any specific format for the remote server. Add Item:

3 Insert Save your entry. your change and return to the item list. Adds the current item and displays an empty form in order to add another. Edit Item: The Item ID field is read-only and cannot be changed. Delete Save your changes. your change and return to the item list. Delete the item. Users Users accessing the system via the telephony interface are required to have a user account in ISI. You can search for any user using a partial ID, First or Last name placed in the search box provided. Selecting User ID will present a form allowing it to be changed.

4 Add User The language selection box will list all the available languages installed. While only the User ID is required it is strongly suggested that the others be filled in for reporting purposes. Insert Save your entry. your change and return to the user list. Adds the current user and displays an empty form in order to add another. Edit User

5 The User ID field is read-only and cannot be changed. Delete Save your changes. your change and return to the item list. Delete the item. Rooms Rooms in the inventory system need not match those of the voic . This allows the inventory system to have rooms such as conference rooms, offices and others. Room numbers may also start with leading zeros. You can search for any room using a partial number or description placed in the search box provided. Selecting either the room number or description will present a form allowing it to be changed. It is possible to delete multiple rooms by checking the box next to the room number and choosing Delete.

6 Add Room Insert Save your entry. your change and return to the room list. Adds the current room and displays an empty form in order to add another. Edit Room Room number is read-only and cannot be changed. Delete Save your changes. your change and return to the room list. Delete the room. Room Fields Each room may have an unlimited number for additional items. These fields are sent to the remote server only. You can display all fields associated with a room by entering a partial number in the search box provided. Selecting either the room number or description will present a form allowing it to be changed.

7 Add room field The name field cannot contain any spaces or punctuation. This field is used to represent a node in the packet sent to the remote server. The value field may contain any sting the user desires. Insert Save your entry. your change and return to the field list. Adds the current field and displays an empty form in order to add another. Edit room field Delete Save your changes. your change and return to the room list. Delete the room.

8 Change Log Any changes made will be logged here. Log entries are kept for a maximum of size months. Server? Logs ISI supports up to five remote servers. Each server has it s own queue and report log. Sync with Voic Only guest rooms which do not exist in the inventory system will be displayed. The synchronization will not remove or change any rooms in the inventory system.

9 To add guest rooms to the inventory system, select the checkbox next to the room number and choose Add. Rooms which are not checked will not be added. Telephone Interface The inventory system runs as an IVR script on the VMS. It can be assigned to any key within a single digit action template by entering ISI in the Action field.

10 Dial access # for Inventory System. Please enter your ID number, followed by the # key. Enter user ID. # Repeat back user s entry. Is password blank? No Please enter your password now. Enter password. # Yes Please enter the room number, followed by the # key. Enter room #. # Repeat back user s entry. Enter the item code, followed by the # key. Enter the quantity, followed Enter item code. # Enter quantity. # by the # key. No Finished? Enter the next item code, followed by the # key. Or press the # key by itself to end input. Repeat back user s entry. Yes # Confirmation Menu 1 To post your entries, press 1. Entry accepted. Post & Exit. 2 3 To review your entries, press 2. To continue posting items, press 3. Review all entries. * To cancel this operation, press *. Entry canceled. Exit without posting. Configuration Options Configuration for ISI server is located in System Configuration Features Connectors.

11 Location IP address or name of remote server machine. Enabled Disable the server. TCP/IP Port Port number used to connect to the remote server. Initial delay (seconds) Enter the number of seconds to wait before sending information to remote server when received. A value of zero will have no delay. Retry interval (seconds) Enter the number of seconds to wait if the server receives an error connecting to the remote server before another attempt. Maximum attempts Maximum number of attempts before a failure is logged. Items per packet Used to limit the packet size in situations where the remote server cannot support large packets. This value has no effect on the number of attempts. Include guest room status Include the state of the room. This will be the maid status of the room as defined in Hospitality. Exclude custom fields Used to block the addition of any custom room fields in the packet.

12 Server Protocol ISI server protocol uses XML sent via a standard HTML POST method. HTTP Headers Along with the standard Content-type and Content-Length fields the server sends the field User-Agent consisting of the DuVoice version and the version of ISI as a three digit number. Document Root: The document root is defined as inventory and may contain one or more room elements. Room Element Specifies the room update element. There may be more than a single room element depending on configuration. Attribute Required Description number Yes Room number. date Yes Date item was posted by user. YYYYMMDD. description No Description of the room. time Yes Time item was posted by user in 24 hour format. HH:MM:SS. Status No Room status as defined in the system configuration under hospitality. sequence Yes Unique integer message number per server. result Yes (response only) On return result. 0 = Success. 1 = Reschedule. Item Element Each room element may have one or more item elements. Attribute Required Description id Yes Item ID entered by user. description No Item Description. price Yes Price of single item. quantity Yes Quantity of this item. User Element The room element will contain a single user element containing the user information who posted the inventory item. The users first and last name if specified will be placed in elements within the user element. These elements will be labeled fname and lname. Attribute Required Description id Yes User id. Post Sample POST / HTTP/1.0 Content-type: text/xml User-Agent: DuVoice/ ISI/100

13 Content-Length: length <?xml version="1.0" encoding="iso "?> <inventory> <room number="600" date=" " time="15:58:39" description="blue suite" status="4" sequence="76"> <user id="999"> <fname>ren</fname> <lname>hoek</lname> </user> <item id="3" quantity="1" description="bud Light" price="3.99"/> <item id="6" quantity="5" description="bottled Water" price="1.95"/> </room> </inventory> </xml> Response Sample HTTP/ OK Content-type: text/xml Content-Length: length <?xml version="1.0" encoding="iso "?> <inventory> <room number="600" sequence="76" result="0"/> </inventory> </xml>