Versions Compared

Old Version 2

changes.mady.by.user Ekaterina Marchenko

Saved on

compared with

New Version 3

changes.mady.by.user Ekaterina Marchenko

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction

The interface is designed for sending the information on cash station events through the HTTP protocol to the address indicated in the driver parameter.
The main task is to transfer data on order changes, but other cash station events are also supported.

...

  • Using the mailing mechanism for version 7.6.5.440 and later
  • Via HTTP Order Notify interface for versions earlier than 7.6.5.440

Procedure

Once started, the driver waits either for the cash station events or for the cash server to shut down.

...

Code Block
<?xml version="1.0" encoding="utf-8"?>
<a RestCode="199990093" DateTime="2020-01-14T15:38:23" Situation="1" seqnumber="1" guid="{9ECCB1B5-97EE-4B88-9840-8568F05586D0}" name="Started" ShiftNum="1" ShiftDate="2019-11-18T00:00:00">
<Server id="15002"/>
<Item/>
</a>

In this event, only the cash server identifier is specified. If the address is specified in the cash server properties, the server notifies the driver about its availability. After that, the event arrivesoccurs.

When the POS cash station is started, a similar message is queued, but it has an extended set of nodes:

Code Block
<?xml version="1.0" encoding="utf-8"?>

...


<a RestCode="199990093" DateTime="2019-12-18T17:17:58" Situation="1" seqnumber="1" guid="{9ECCB1B5-97EE-4B88-9840-8568F05586D0}" name="Started" ShiftNum="1" ShiftDate="2019-11-18T00:00:00">

...


<Station id="15003" code="1" name="MM_CASH" NetName="MM_CASH_169058"/>

...


<Server id="15002" code="15002" name="MM_MID" NetName="MM_MID"/>

...


<Item/>

...


</a>

It has both the extended information on the POS cash server and data on the POS cash station. This mechanism allows to separate separating the events of the POS cash server loading and POS cash station loading for their separate processing.

...

Supported commands sent by the driver (in the Situation attribute):

Situation

Event

1

POS Cash server or POS cash station start

3

Order changing

4

Order calculation

5

Receipt closing

9

Closing the order

10

POS Cash station locking (logoff)

11

Creation of a New Ordernew order

12

Opening an existing order

13

Order saving

14

Receipt deleting

18

POS Cash station closing

21

POS Cash station sign in

24

Switching to the receipt print mode

...

HTTP Order Notify Licensing

If you need more than one connection, the HttpOrderNotify interface must be licensed.
The license must be activated starting from version 7.6.5.459. The license in the licensing system is called R-Keeper module Order notification interface 12 months software.

HTTP Order Notify Interface

HTTP Order Notify works on the side of the cash server to which the cash station is connected. The driver is added to the cash server.
For the correct loading of the driver, it is necessary to bind the interface for the cash server to it. Find more information below.

For r_keeper versions earlier than 7.6.5

Add HTTP Order Notify to the cash server:
Image Added

Parameters:

Name
Description and Possible Values
Log FileThe path to the file, that will serve as a driver operation log. It may be absent, but in this case it would be difficult to define the operation problems.

LogLevel

Logging level. There are three possible values:

  • 0 - errors only — In this mode, the log contains only the most important messages, f.ex. information on the interface loading, or the error messages: exceeding the limit of events in the list, an error when sending the data to the HTTP server, etc.
  • 1 - input xmls and errors — This mode is similar to the previous one, but also includes some important messages, f.ex. about the start of sending XML to the HTTP server address.
  • 2 - max log — The most complete logging level, containing all the details of the driver operation, including incoming and outgoing XML, the current status of the mailing list. etc.
DestURLs

HTTP address where the data will be sent to. Has the commonly used form of URL addresses.
Can contain only one address. If you need to send data to several HTTP servers, you should add a separate HTTP Order Notify driver for each of them.

For the cash server to download the driver, bind it to the interface:

  1. In the manager station, go to Service > Interfaces

  2. Create a new interface with the following properties:

    Name
    Description and Value
    [Cash server name]select the driver added to the cash server
    Common DLL Namespecify the driver file name, always httpnotf.dll

    Image Added

  3. Restart the cash server.

For r_keeper version 7.6.5 and later


XML Examples

Signing into the POS Station

<?xml version="1.0" encoding="utf-8"?>

...

<Role id="100007" code="7" name="Administrators"/>

</Waiter>

<Item/>

</a>

Creation of a New Order

<?xml version="1.0" encoding="utf-8"?>

...

Name

Description and possible values

Log File

The path to the file that will be used as a driver action log. Can be missing but in this case it will be difficult to identify issues in driver functioning

LogLevel

The logging level, can take one of the following three values:

Value

Description

0 - errors only

In this mode, the log will have only the most important messages (for example, notifications on interface loading) or error messages: exceeded number of events in the queue, failure to send data to the HTTP server, etc.

1 - input xmls and errors

In this mode, in addition to the errors only mode, some other important messages are added, for example, those on the start of sending XMLs to the HTTP server address

2 - max log

The most complete logging mode that comprises the most detailed information on driver functioning including incoming and outgoing XMLs, the status of the messaging queue, etc.


DestURLs

The HTTP address to which data are sent. It is entered in the conventional URL address format. Can contain only one address. If you need to send data to multiple HTTP servers, an individual HTTP Order Notify driver must be added for each of those servers

Troubleshooting

When functioning, the driver adds information on its work to the log to facilitate localization of possible issues. A regular problem is that data does not arrive to the receiving HTTP server. In this case you should check the correctness of the address in the DestURLs parameter of the driver and the HTTP server health. If it is impossible to send data, the log will have messages containing the substring "HTTP: Post error", for example:

...