Suspend / retrieve

Suspend / retrieve

Each operator can only work with one sales transaction at a time on each POS. If a customer asks to postpone an unfinished sales transaction so that another customer can be served in the meantime, the transaction can be suspended. There is no limit on how many sales transactions can be suspended nor how long time they can be suspended. To suspend a transaction, the Suspend transaction button is clicked some time during a sale. Similarly the Retrieve transaction button brings up a list of suspended transactions to be retrieved.

Activating the ability to suspend

It must be possible to retrieve a suspended transaction and retrieve it back at any POS within the store. There for a Suspend server must be added as a plug-in to one of the POSes which all of the POSes (including the POS that hosts the suspend server) communicate with.

Configuring the Suspend server

Since the server is a lightweight application, we recommend activating the suspend server on all POSes even though the clients will all point to just one of them. This give an extra flexibility to change the configuration later to point to a new server, in case the previous server fails.

• Click Admin - Server information - Plugins

• Check the box next to SUSPENDED-TRANSACTION-SERVER, then click Save

• Select to upgrade the database if asked.

• Click Setup - POS Groups

• Navigate to the workstation group (this is the group that all POSes in the desired cell inherit settings from) within the store the functionality should be applied to.

• Add the plugin to the group by clicking the arrow next to new Suspended Transaction Server, to add the plugin to the group.

• Click the new plugin to navigate into it.

• Change the ID to something descriptive like susp-server, and the name to Suspend server

• Add the property IP-settings and type in the Port number: 8077

• Publish those changes and wait for the POSes to received an updated application containing the new plugin, then restart the POSes to start that new application.

Configuring the clients

Now that all POSes are running as suspend servers we simply need to tell the POSes which of them are to act as servers and which as clients (the POS in the role of a server can also be a client).

Since there is little extra overhead to configure a POS to act as server, it is recommended to do just that for every POS (place the configuration on a higher lever).

• Click Setup - POS groups and located the same workstation group as above

• Make a note of the network ID (computer host name) of the POS you want to use as a server, in this demo let's call it susp_serv_01

• Click the arrows next to the property Suspended transaction server

• Type in URL to the suspended server, in this case http://susp_serv_01:8077

• Publish the changes, allow the POSes to receive the configuration update, then restart the POSes for this change to take effect.

Receipt configuration

The following receipt (in this case nr: 11) should be inserted to print a slip when a transaction has been suspended, to better identify the transaction when it needs to be retrieved.

[RCPT_PROPERTIES]
LINECHARS=42
ROTATION=0
ACTIVE_AT_TENDER_LINE=false
ACTIVE_AT_CHANGE_LINE=false
ALIGNALL=0
FEED_BLOCK_LINES=0
[RCPT_HEADER]
[RCPT_LAYOUT]
</BITMAP>
</CENTER></RCPTTOP>
</CENTER>  
</CENTER></DBLWIDE>Geymd færsla
</CENTER> 
Dags/tími...: </TRANSDATETIME>
Afgreiðsla..: </TRANSNUM,-20> </REPEATPRNCOUNT>
Starfsmaður.: </OPERNUM> </OPERNAME>
</CENTER> 
Lýsing               stk.     Upphæð
</LINE>
</BODY>
</LINE>
</CENTER> 
</SUSPEND_NUMBER,BC[Type=110][Height=100][Width=150][Alignment=-2][TextPosition=-13]>


[RCPT_FOOTER]

Layout configuration

• Suspend transaction

  • Run the following macro to suspend. If the action is successful, the macro also prints the provided receipt id, given the id is greater than 0:

    • Transaction.Suspend(receiptId=11);

  • Optionally run a macro to return to the root view, initial

    • MENUOPEN(MenuControlId=root;MenuId=initial;);

• Retrieve transaction

  • Display the layout; transaction-search, containing the grid; Transaction search, with a list of suspended transactions:

    • MENUOPEN(MenuControlId=root;MenuId=transaction-search;);