Advanced Configuration Options
Links on this page.

Configure Activation Warnings
Currency Value Size & Decimals
Disabling Document (Factura) Numbers
Enabling Security in Control
Configuring Automatic Service Charges
Multiple "Areas" and Account Printers

 

Configure Activation Warnings
In the past we have had complaints from customers who have said that:-
  • Activation warnings are too intrusive and annoying.
  • They have had insufficient warning before their activation expired.
Rather than adopt one standard and then argue with people, we have decided to make the Activation warnings configurable. If you don't like the warnings, you can change them.

Things that Trigger Activation
There are 3 situations where the software may need to be activated. These are:-

  • Expiry The term of the license (or evaluation period) has, or is about to expire. In this case you will need to pay for an additional license term and reactivate the software, otherwise it will stop working.

  • Confirmation When you purchase an activation online we activate your software immediately. On some occasions however the transaction is later reversed. You might think it unlikely that someone would buy an accounting software license with a stolen credit card, but it has happened.

    When your activation needs to be confirmed, you do not need to pay anything. But the system running Control needs to check with our server to verify that the payment has not been reversed.

    If there is a problem with your payment, we will be in contact with you long before the confirmation time has expired, and you will have plenty of time to make alternate arrangements.

    If the computer running Control is connected to the internet, you will not need to do anything at all for confirmation, because the system will confirm your activation automatically.

  • Hardware Change Your Activation is keyed to the computers you use to run SELLmatix. You take steps to stop people stealing from your business, and this is how we stop people using our product without payment.

    If you make a substantial change to the hardware you are using to run SELLmatix, you may need to reactivate the software. You might also have a computer fail and need to transfer the activation to another machine. This is no problem, but you will need to reactivate in such cases. If you have any questions contact us using the Contact Form.

Warning Levels
There are 3 warning levels, and the warning screens are color coded like traffic lights.

  • Green warnings are designed to show you that you need to activate fairly soon.
  • Amber Warnings are designed to indicate that you should reactivate now, because activation needs to be done fairly soon. If you delay, and there was a problem with your internet connection, you run the risk of being unable to use the software.
  • Red Warnings are designed to show you that there is danger, and the software is about to stop working.
Configuring the Warning Levels
You configure the warnings by editing entries in the configuration files. The file "SELLmatix Control.cfg" contains the entries for Control, and the file "SELLmatix POS.cfg" contains the settings for POS. This is text file that can be edited with Notepad and consists of [Sections] where the section name appears in square brackets.

Each section contains entries made up of VariableName=Value entries. Lines beginning with a hash (#) are comments and are ignored.

The settings for warning levels appear in the [System] section as follows:-

#License activation warnings
#Low Priority start 336 hours (14 days)before shutoff, and warns every 12 hours
GreenWarn=336,12
#Medium Priority Warning starts 168 (7 days) hours before shutoff and warns every 4 hours
AmberWarn=168,4
#High Priority Warning starts 96 hours (4 days) before shutoff, and warns every hour
RedWarn=96,1
After each value there are two values separated by commas. The first is the number of hours before activation is needed that the warning begins. The second number is the number of hours between when each warning repeats.

Higher priority warnings take precedence over lower priority warnings, so that if a Red warning is active, it will be used instead of an Amber or Green warning.

To change the warning characteristics, just change the numbers to values that you want, save the file, and then restart POS and Control.

If you first installed SELLmatix before this feature was added, these entries will not appear in your configuration files even after you upgrade your version of the software. Upgrades to not change any of your data files or configuration settings. In that case you will need to manually add these lines to your configuration files, otherwise system defaults will apply.

Early versions (before version 3.x) needed to be Activated separately. In Version 3.0.0 of SELLmatix and later, you only need to activate Control, and it automatically keeps the POS terminals activated. If POS runs offline and not connected to POS for an extended period, then POS may generate activation warnings. In this case you may wish to adjust the warnings in POS to different values, however POS must connect to Control before the timeout period displayed has passed, otherwise it will stop working. Having Control re-connect to POS will correct that problem if it occurs, after one update cycle in Connection Manager.

Back to top

Currency Storage and Decimal Places
SELLmatix uses the currency formatting information configured in Windows through Control Panel->Regional Settings and this is all that is required to localise the display of currency values.

In some countries however, currency denominations are very large and they do not use any cents. For example, at the time of writing this page, one € = approx 14,000 Indonesian Rupiah, and one € = 3,000 Colombian Peso.

When SELLmatix operates using these currencies the size of the numbers for prices and totals is very large, and much of the data used to represent currency values is wasted since there is no decimal point and the is no local equivalent of cents/centavos etc.

In this case, SELLmatix can be configured to represent currency amounts as whole units without a decimal place. This is more appropriate for local conditions, and allows the system to store larger numbers.

You can change the way that currency is represented in the system by adding the following line to the [System] section of the "SELLmatix Control.cfg" file and the "SELLmatix POS.cfg" file.

CurrencyStorage=10,0

This tells the system to store currency values as 10 digits with zero decimal places. The default value is 10,2 which means 10 total digits and 2 decimal places. Since the decimal place takes one character of storage the whole number component of a currency value is normally up to7 digits long.

At this time, there are no valid values for this entry, other than what is described in this section.

Back to top

Disabling Document/Receipt/Factura Numbers
In certain countries, particularly in Latin America, there are special requirements for Tax Invoices or "Facturas". While these requirements vary from country to country, the receipt/invoice/factura numbers are allocated by taxation authorities and not the business. The receipt numbers used must be sequential and within the range of numbers allocated. Each document is an accountable document, and retail taxes such as VAT/IVA/GST etc. are calculated based on copies of these Facturas.

It is easy to specify the starting document number for SELLmatix POS to use in POS->General Settings.

There are however certain cases where a business may wish to finalise a transaction without issuing a formal "Factura" that creates a tax liability. For example:-

  • Complimentary meals or drinks in a restaurant or bar. Usually these would be "Finalised" using an in house account budgeted to promotion. However, if a formal "factura" was issued, there would be a false retail tax liability created even though no money was received.
  • We strongly recommend "selling" Staff/Management usage to an in house "debtor account" because
    • it allows management to track the amount of staff and owner usage that is occurring. Frequently this is under estimated.
    • to keep stock counts accurate. If staff and management merely take items for their own consumption, then stock figures cannot be maintained, and there is no way to identify how much of a stock shortage is actually the result of theft, and how much is actually the result of management/staff compensation.
  • We also recommend that stock breakage and spoilage, and known losses such as walk outs etc. be recorded to an in house "debtor account" so that these can be accurately measured and accurate stock levels maintained.
In any of these cases, if a formal "Factura" was issued a false tax liability would be created.

In order to allow such transactions to be "Finalised" on the system, or "paid off" without using a receipt number which would create a false tax liability, there is a configuration setting which allows one of the Finalisation types to not generate or use a document number.

In the [System] section of the "SELLmatix POS.cfg" file and the "SELLmatix Control.cfg" file the following line needs to be added

FinNoRecNum=N
where 'N' is the finalisation number of the Finalisation method that should not generate a receipt number. For example, if Finalisation Number 8 was named "No Pay" and was to be used in these circumstance, then this line should be set to
FinNoRecNum=8
All other Finalisation types will generate document numbers.
Back to top

Enabling Security in Control
In certain cases it is desirable to have SELLmatix Control running and visible to the operator so that Connection Manager and Order Manager are able to operate normally, but where users should be prevented from using Control without entering a Login Code.

Before enabling this option, make sure that you know and are able to use a Login for at least one Clerk that has configure access to the system.

To turn on Security in Control, add the following line in the [System] section of the "SELLmatix Control.cfg" file.

ClerkOnFlag=4
When this option is set, Control will operate normally with Connection Manager and Order Manager operating normally, but in order for anyone to use options on the Menu, it will be necessary to login using the code of a user that has Configure Rights on the system.

Back to top

Configuring Automatic Service Charges
Some sites wish to have service charges added to an account automatically. SELLmatix can automatically add a service charge when the customer account is printed. To configure this feature, you need to have and adjustment set up with the name you wish to appear on the account as the Adjustment Name. The Adjustment Type must be a Surcharge.

In the "SELLmatix Control.cfg" file the following 3 entries must be added to the [System] section.

PrtAcctEvent=22
PrtAcctData=10
PrtAcctEvData=6
Please note that:-
  • PrtAcctEvent must always be set to 22.
  • PrtAcctData must be set to the percentage (%) of surcharge to be applied.
  • PrtAcctEvData must be set to the Adjustment Number set for Service Charges.
Normally the Customer Account would be printed after all items purchased by the customer have been entered and immediately before the account was paid. Open Orders are stored in Order Manager on Control, and orders can be added by any terminal.

To print a customer account, an operator on one of the POS systems enters the Table (location) number and then the "Print Account" button. This sends a request to Control, which actually prints the account.

When Control is configured as described in this section, before printing the account it processes the service charge and adds an adjustment line to the Customer Account which contains the Service Charge. When a POS terminal Retrieves the order so that it can process payment, this adjustment line appears on the transaction the same as any other line on the transaction.

Please Note: The service charge will be added each time the account is printed. Normally, the account would be printed only once. If printed more than once, then the first Service Charge entry that appears on the transaction should be Voided.

Back to top

Multiple "Areas" and Account Printers
Some installations have multiple areas where food and drinks are served and a single cashier processing payments. One real world example features:-
  • Bar 1 serves drinks and has one POS terminal for taking orders.
  • Bar 2 serves drinks and snacks and uses one POS terminal and a Pocket PC running PocketPos for taking orders.
  • The Restaurant serves diners and uses one POS terminal.
  • The cashier's station has one terminal running POS to process payments, and has Control running as a background task to administer orders.
Area Totals
Since one cashier is processing payments for all "Areas" in the establishment, all sales appear on the Z-Read for that cashier's terminal.

Typically the cashier never leaves their station in such businesses and is accountable for the cash balancing, so multiple clerks are not used for sales totals on the Z-Read of the Cashier's terminal. However different Clerks may be used at the terminals where orders are entered.

In such situations, the establishment is likely to be interested in the sales totals for each area, such as Bar 1, Bar2 and Restaurant, and in particular the number of covers in each area. But since all payments are being processed by a single cashier at a single terminal, all sales totals would normally be grouped together in the one Z-Read report.

This can easily be accommodated however, by setting up a separate cashier login for each area, eg. Bar 1, Bar 2, Restaurant, requiring login at the start of each sale for the Cashier, and then running separate Clerk/Cashier reports at the end of shift/day to identify the totals for each area.

Separate Account Printers
SELLmatix Control is the program that handles and consolidates orders for all terminals. Additional orders for a table can be added from any terminal, and when Control receives an order for a location where there is already an existing order, the new order is added to and consolidated with the existing order.

When a customer asks for their account, the request is entered into any POS terminal by entering the Table/Location number followed by <Print Account> and this request is sent to Control by the POS terminal, and Control prints the account on the account printer set up in Control.

In certain areas of some establishments, the account printer that is normally used by Control may be located an inconvenient distance from the POS terminal requesting that the account be printed, so for some terminals it would be more convenient to use another printer more conveniently located to the terminal where the account printing request is entered.

The technique described here is an interim solution that allows accounts to be printed on up to 3 different account printers depending on which terminal requests that the account be printed. We intend to revisit this issue in future with a view to increasing flexibility and this solution provides a technique to meet current requirements of existing sites.

Here are the steps to configure additional Account Printers.

  1. Configure the printers as output devices in Control so that on the machine running Control, you are able to successfully print Windows Printer Test Pages. In many cases the alternate account printers will actually be connected to other terminals and will need to be configured as Shared windows Printers.
  2. Configure those printers as Output Devices in Control. The easiest way would be to set them us as Order printers which are not used. SELLmatix supports up to 9 Kitchen/Bar Order Printers but in practice it is unusual for more than 4 or 5 to actually be used.

    In SELLmatix, and output device can be made to respond to any type of output, and naming the Order Printers as such is really a naming convention to make various concepts easy to explain. If the alternate Account printers are already configured as output devices in Control, you can skip this step. Or, if you are already using all 9 Order Printers for other devices setting up additional output devices is explained elsewhere on this site.

    For the sake of this discussion go to "Control->Tools->Order Printers->Location 8" and "Control->Tools->Order Printers->Location 9" and set up these printers.

  3. Open the "SELLmatix Control.cfg" file using Notepad, and locate the [Section] for the device which handles default account printing and copy the lines which contain the output for account printing. That should appear something like the following:-
    Account Header=<RESET><XTEND,B,logo.bmp,5,0,95,30>
    Account Header1=<XTEND,F,,6,0,600,0,0,><RIGHT>Business Name S.A.<BR>
    Account Header2=Address Etc.<BR>
    Account Header3=<XTEND,F,Arial,12,0,600,0,0,>Table #%LOCATION%<BR>
    Account Line=<XTEND,F,Arial,12,0,600,0,0,>%QTY% %DESC%<RIGHT>%TOTAL%</RIGHT><BR>
    Account Footer=Total<RIGHT>%BALANCE%</RIGHT><BR><BR><XTEND,F,Arial,6,0,600,0,0,>
    Account Footer1=Promotional Message for You<BR><FULLCUT>
    
    Copy and paste this into the device section for the alternate Account Printers set up above. If you have followed the example of using Order Locations 8 & 9 it will be as it appears below.

    In this case, the Alternate Device number needs to be appended after the word "Account" in the output variable names. The result for device 8 would appear something as follows:-

    [Order Loc 8]
    Type=P
    Input=0
    Output=1
    Driver=\\COUNTER\SAMSUNG SRP-350
    ...
    Account1 Header=<RESET><XTEND,B,logo.bmp,5,0,95,30>
    Account1 Header1=<XTEND,F,,6,0,600,0,0,><RIGHT>Business Name S.A.<BR>
    Account1 Header2=Address Etc.<BR>
    Account1 Header3=<XTEND,F,Arial,12,0,600,0,0,>Table #%LOCATION%<BR>
    Account1 Line=<XTEND,F,Arial,12,0,600,0,0,>%QTY% %DESC%<RIGHT>%TOTAL%</RIGHT><BR>
    Account1 Footer=Total<RIGHT>%BALANCE%</RIGHT><BR><BR><XTEND,F,Arial,6,0,600,0,0,>
    Account1 Footer1=Promotional Message for You<BR><FULLCUT>
    
    Loc 8 Order Hdr=<RESET><CENTER><XTEND,B,LogoMono.bmp,10,0,90,25><XTEND,F,,10,0,600,0,0,><BR>
    Loc 8 Order Hdr1=%LONGDATE% %TIME%<BR>TABLE  %LOCATION%<BR>
    ...
    
    and for Alternate Account Printer 2, the device section would be similar to the following if you were using the Order Location 9 Setup.

    [Order Loc 9]
    Type=P
    Input=0
    Output=1
    Driver=\\RESTAURANT\SAMSUNG SRP-350
    ...
    Account2 Header=<RESET><XTEND,B,logo.bmp,5,0,95,30>
    Account2 Header1=<XTEND,F,,6,0,600,0,0,><RIGHT>Business Name S.A.<BR>
    Account2 Header2=Address Etc.<BR>
    Account2 Header3=<XTEND,F,Arial,12,0,600,0,0,>Table #%LOCATION%<BR>
    Account2 Line=<XTEND,F,Arial,12,0,600,0,0,>%QTY% %DESC%<RIGHT>%TOTAL%</RIGHT><BR>
    Account2 Footer=Total<RIGHT>%BALANCE%</RIGHT><BR><BR><XTEND,F,Arial,6,0,600,0,0,>
    Account2 Footer1=Promotional Message for You<BR><FULLCUT>
    
    Loc 9 Order Hdr=<RESET><CENTER><XTEND,B,LogoMono.bmp,10,0,90,25><XTEND,F,,10,0,600,0,0,><BR>
    Loc 9 Order Hdr1=%LONGDATE% %TIME%<BR>TABLE  %LOCATION%<BR>
    ...
    
  4. Now you need to tell Control which Account printer to use for various POS terminals. This is done through entries in the [System] section of "SELLmatix Control.cfg" as in the following examples:-
    TermToAcctPrnt4=2
    TermToAcctPrnt16=1
    TermToAcctPrnt3=2
    
    The first example tells Control to print Accounts requested by Terminal 4 on Alternate Account Printer 2.
    The second example tells Control to print Accounts requested by Terminal 16 on Alternate Account Printer 1.
    The first example tells Control to print Accounts requested by Terminal 3 on Alternate Account Printer 2.

    Please Note that if a terminal is to use the default account printer, then there should be no mapping entry. An assignment to Alternate Account Printer zero is invalid.

    The terminal numbers used are the terminal numbers configured in Connection Manager.

Back to top