2.1. Licensing

• To order a SmartControl license, you need to contact Syrve support (service organization);
• The license is issued for an RMS server, includes connecting up to 10 tills of one restaurant;
• The number of connecting applications and bots is not limited;
• Payment for the license does not guarantee its automatic appearance on the till; you need to check the presence of the license directly on the till;
• The license in the Syrve system is called "SmartControl";
• New Syrve clients may be provided with a license for a certain period as part of a "welcome" package (usually 4 months);
• The time it takes for the license to appear after payment depends on payment processing in the Syrve system;
• If the license was not paid on time, additional intervention by Syrve support may be required;
• When the license expires, SmartControl stops receiving new data from the till;
• Licenses are issued only at the level of individual restaurants (RMS); there is no separate license for the central office (Chain);
• The license usually does not end in the middle of the month; if the data stopped updating in the middle of the month, the reason is probably something else;
• Installation and configuration are performed by a Syrve partner.

2.2. Plugin installation

• Starting from Syrve version 7.6, the plugin is installed automatically if a license is present when the cash register shift is closed;
• For forced plugin installation:
  • Go to the "Plugins" menu on the POS;
  • Click the "Check and Update Plugins" button.
• If the plugin is installed but blocked by Windows:
  • Find the plugin file;
  • In the file properties, click "Unblock";
  • Restart Syrve POS.
• Links to plugins for manual installation are also available on the SmartResto.pro website;
• After the license appears on the till, you need to restart Syrve POS.

For manual installation:

• Turn off Syrve POS and copy the "SmartControl.dll" plugin to the Syrve POS plugins directory "C:\Program Files\Syrve\SyrveRMS\Front.Net\Plugins\SmartControl\SmartControl.dll";
• The plugin must be installed only on the Main POS. Installing the plugin on auxiliary tills or waiter terminals is necessary only if cash register shifts are opened on them.

2.3. Checking plugin operation

• Check the plugin log: "%AppData%\Syrve\CashServer\Logs\plugin-SmartControl.V*.log". If the log is missing, the plugin is not starting;
• Check the general log: "cash-server.log";
• The main reasons for the plugin not starting:
  1. No SmartControl license;
  2. The plugin is blocked by Windows (requires unblocking in the file properties);
  3. Incorrect location of plugin files in the folder structure;
  4. Duplication of the plugin in different places of the file system;
  5. The "Main POS" checkbox is not set in Syrve Office settings;
  6. Missing System.Reactive.dll library (for Syrve version 7.1.x).

2.4. Description of SmartControlConfig.xml configuration file

The SmartControlConfig.xml file is a configuration file for the SmartControl plugin installed on Syrve POS. It contains various parameters that allow you to configure the plugin's operation according to the restaurant's needs.

2.5. Plugin configuration

2.6. Network access configuration

• The plugin connects to the server at http://sp1.smartresto.pro/Service1.svc;
• Alternative address: http://sp2.smartresto.pro/Service1.svc;
• HTTP protocol is used on the standard port 80;
• To check the connection with the server you can:
  • Check the availability of the address http://sp1.smartresto.pro/Service1.svc in the browser on the POS;
  • Perform a ping test to the server address (ping sp1.smartresto.pro);
  • Check availability from another device on the same network and outside the network (via cellular connection).
• For restaurant server without static IP and external access (LifeTime licenses):
  • SmartControl will work, as the plugin on the POS sends data to the SmartControl server;
  • The mobile application must be connected in the local network;
  • For the Telegram bot, additional setup through SmartResto support is required. You can contact support through the Telegram chat @smart_resto or via the link https://t.me/smart_resto.

2.7. Network problem diagnostics

• If the ping does not pass -- the problem is at the network level (there may be a problem in firewall or antivirus settings, router settings, and, in rare cases, restrictions from the provider);
• If the ping passes but the service is unavailable -- probably port blocking by firewall or at the protocol level;
• Typical errors in the log with network problems:
  • "System.TimeoutException: Request channel timeout while waiting for a response";
  • "ERROR [ 6] - [TypeValue][310] Listening on http://sp1.smartresto.pro/Service1.svc was not performed by any endpoint...".
• Possible causes of access problems:
  • Firewall or antivirus settings;
  • Router settings.
  • Blocking at the provider level;
• For testing, you can try to connect the POS via mobile Internet (modem or smartphone);
• Solutions:
  • Configure the firewall to allow connection;
  • Disable or configure VPN;
  • Contact your network administrator.

3.1. Technical requirements

• Smartphone based on Android (starting from version 4.1) or iOS (starting from version 9.0);
• SmartControl application, which can be downloaded from:
  • Google Play: https://play.google.com/store/apps/details?id=pro.smartresto.control
  • App Store: https://apps.apple.com/us/app/smartcontrol-for-syrve/id6472660712
• The SmartControl plugin must be installed on the Syrve POS.

3.2. Installation and connection

1. Install the SmartControl application from the app store;
2. Launch SmartControl;
3. Click on 3 horizontal lines in the upper left corner;
4. Go to Settings ⚙ and add your restaurant using the "➕" button;
5. Enter:
   • Connection address to the Syrve server (can be found in the Syrve Office login window);
   • Connection protocol and port;
   • Syrve user's login and password.
6. The login must belong to one of the roles: ADM, MN0 or SmartControl;
7. Click "Add restaurant";
8. Your restaurant's tills will appear in the list;
9. You can add an unlimited number of restaurants;
10. You can add not only by the RMS server address but also by the Chain server address. In this case, all tills of restaurants included in the Chain that have SmartControl plugins installed will be added.

3.3. Main application sections

3.4. Navigation in the application

• To move between sections, you can swipe the screen left or right;
• For quick transition, you can use the bottom panel with icons;
• The full list of sections is available through the right side menu -- button [ ⋮ ] in the upper right corner;
• Each section displays the time of the last data receipt from the till. If the time text is orange, it means that the last data transmission was more than 10 minutes ago and the data may not be up-to-date;
• At the first launch, information on the first restaurant from the list is displayed;
• To select a restaurant, go to the left side menu -- button [ ☰ ] in the upper left corner and click on the desired restaurant.

3.5. Proxy server configuration

• If the main address of the SmartControl service http://sp1.smartresto.pro/Service1.svc is not available from the smartphone, there is an option to add an alternative Proxy server address;
• To do this:
  • Click on the "ID" field in the upper right corner in the window with the list of tills in "Parameters";
  • Enter the Proxy server address in the opened window;
  • Click the [OK] button.
• In the address field, only the domain name or IP address of the host is specified without the protocol (http/https);
• To cancel the entry, click [Cancel];
• To delete the Proxy server address, delete it in the input window and click [OK].

3.6. Managing tills and restaurants

• SmartControl allows adding multiple restaurants (RMS servers) to one application;
• You can add not only by the RMS server address but also by the Chain server address. In this case, all tills of restaurants included in the Chain that have SmartControl plugins installed will be added;
• To delete a till from the list in SmartControl parameters, click the [❌] button in the line with the till name. This way, you can configure the connection of not all restaurant tills, but only those necessary for viewing;
• Users with the ADM role (marked as ADMIN in the application or 🅰 in the bot) can see and disconnect other connected employees. In this case, in the list of tills in the parameters, employees connected to the tills are displayed below. To disable employees from monitoring, click on the cross in the line with the employee's name;
• On iPhone, to delete a till or employee connection, you need to swipe right on the line with the till name or the name of the employee to be deleted;
• When changing the restaurant structure (for example, when adding new tills), you need to add the restaurant again, as SmartControl does not store credentials for connection.

3.7. Data display features

• The upper right corner displays the time of the last data transmission from the till;
• If the time text is orange, it means that the last data transmission was more than 10 minutes ago, the data may not be up-to-date;
• The ⚖️ (scales) symbol shows the percentage of occupied tables relative to the total number of tables;
• In the Orders section, information about the number of orders is displayed in the format "X/Y", where X is the number of open orders, Y is the number of closed ones;
• Calculation of "expected revenue": Expected revenue = Sum of closed orders + Sum of open orders;
• Information is transmitted by the plugin approximately once every 2 minutes to the SmartControl server;
• The color scheme corresponds to the colors of order statuses used in SmartControl (similar to colors in Syrve POS):
  • Green: "Prepared";
  • White: "Closed";
  • Red: "Guest bill";
  • Blue: "New".

4.1. Connection and setup

1. Install the Telegram application from the app store;
2. In the Telegram search bar, type SmartControl bot or @smart_control_bot/ Link to the bot from external systems https://t.me/smart_control_bot;
3. Click on the bot name in the search results. In the chat window with the bot, click START;
4. Select the language for communication with the bot and data display;
5. Select the type of data display — Text view or Icons. The text format is old, contains less information and is not supported, left as is. It is preferable to use the view with Icons, it is more informative, compact and easier to understand after studying the meaning of icons. To request a description of icon notations, send the command /legend or click: ➕ → ⚙ Settings and help → ℹ️ Description of icon notations;
6. To add a new restaurant, send the command /add or click: ➕ → ⚙ Settings and help → 🏰 Add a new restaurant;
7. Enter the Syrve server address and port in the format: address:port;
8. Enter the Syrve user's login and password;
9. Your restaurant will be connected to the Telegram bot.

4.2. Bot's main sections and commands

• 📊 - summary information about the restaurant (revenue, occupancy, number of orders, employees, dangerous operations, revenue forecast);
• 💶 - revenue by restaurants, tills, halls (occupancy, table occupancy, revenue breakdown);
• 👤 - revenue by waiters (report on the effectiveness of employees);
• 📋 - list of orders for the current shift (orders in the hall, banquets, delivery, takeaway, statuses, amounts);
• ➕ - output of additional reports;
• ⏹ - tables with open orders;
• 🔴 - dangerous operations;
• 🔟 - rating of 10 items by revenue;
• 🚫 - stop list, remaining items.

4.3. Settings and help

To navigate to this section, use the ➕ button and then ⚙ Settings and help or select the /param command and then ⚙ Settings and help. The bot will send a message with buttons. In the header of the message, the chat ID will also be displayed, which may sometimes be required for diagnostics by SmartResto support.

Available actions:

• ❌ Reset connection settings - resets settings without confirmation;
• ❔ Connection help - calls up built-in connection help;
• 🏰 Add a new restaurant - allows you to add another restaurant;
• 🛑 Delete connected tills - allows you to delete selected tills;
• ⛔️ Disable employees - allows you to disable selected employees from monitoring;
• ♨️ Change display type - switching between text and graphic display;
• ✅ Event notification filter - allows you to select types of notifications to receive;
• ♻️ Update button status - updates buttons in the bot interface.

4.4. Additional bot commands

• /param - calls up the settings window and additional information;
• /renew - updates the chat bot menu buttons;
• /amounts - stop list, remaining items;
• /help - calling built-in help;
• /filter - setting up the notification filter;
• /change - changing the type of data display (icons or text);
• /add - adding a new restaurant;
• /edit - deleting connected tills;
• /legend - description of icon notations;
• orderNNN - show order № NNN
• /start - reset settings.

4.5. Reports and notifications

• The bot can send notifications about dangerous operations;
• To view the contents of an order, you can select an order from the order list or use the "order" command with the order number (for example, "order123");
• Any report can be requested manually by buttons or by user text command;
• The bot sends all reports when closing a shift, which are saved in the chat history;
• There is no ability to configure automatic sending of reports on a schedule (by timer);
• The "Top 10 items" report shows only the 10 most popular positions;
• By default, the waiting time for table closing after guest bill is 10 minutes;

4.6. Features of working in groups

• When working in Telegram group chats, the bot responds to messages only if:
  • The message is sent in response to a bot message;
  • A slash (/) is added before the command;
  • The bot is appointed as a group administrator.
• In the standard configuration, any group member can call bot commands;
• When converting a regular group to a supergroup, the group identifier changes. In this case, you need to reconnect the restaurant, as the binding of till identifiers is made to the Telegram chat identifier;
• You can create a group with the bot and several users for joint viewing of reports;
• You can create separate Telegram groups for each restaurant.
• Groups can be renamed and have an image set as an avatar (logo) for convenience of use in Telegram;
• You can create groups with restricted rights for employees, where they will not be able to request data themselves. For example, you can configure with a filter only certain types of events that group users will receive;

4.7. Notification filtering

• Setting up the event filter: ➕ → ⚙ Settings and help → ✅ Event notification filter;
• Filter settings only affect the specific chat with the bot, not all restaurant tills or restaurants in the network;
• Discount notifications show the discount amount at the time of the event (may differ from the final discount of the order);
• Notifications for the kitchen: you can configure the plugin to read the virtual printer log and send service checks as notifications in the chat;
• When adding a new restaurant, filter settings may sometimes reset to default values. After adding a new restaurant, it is recommended to check the filter settings.

6.1. Data not updating

• An exclamation mark (‼️) next to the date and time in reports means that the last data transmission was more than 10 minutes ago, the data may not be up-to-date;
• Causes:
  • Absence or expiration of license;
  • Non-working or stopped plugin;
  • Closed cash register shift with active "WorkOnlyOnOpenShift" parameter;
  • Network restrictions blocking access to the server http://sp1.smartresto.pro/Service1.svc.
• Check: Determine if the address http://sp1.smartresto.pro/Service1.svc is visible in the browser on the POS, another device on the same network, on a smartphone via cellular connection;
• If the data in the application has stopped updating and an old date is displayed, the most likely cause is the expiration of the license, especially at the beginning of the month.

6.2. Error "No tills transmitting data found"

• Causes:
  • No active SmartControl license. Payment for the license does not guarantee its automatic appearance on the till; you need to check the presence of the license directly on the till, for example in the cash-server.log;
  • The plugin on the till is not working or is working with errors;
  • Closed cash register shift (if configured to work only with an open shift);
  • The Main POS is not specified in Syrve settings;
  • The plugin is disabled (PluginDisabled parameter).
• Solution:
  • Check for a license;
  • Check the plugin operation on the till;
  • Open the cash register shift;
  • Update the plugin with the "Check and Update Plugins" button in the "Plugins" menu;
  • Set the "Main POS" checkbox in Syrve Office settings;
  • Change the PluginDisabled parameter to false in the configuration file.

6.3. Old or "stuck" orders displayed

• Signs: old orders that are not in the list of orders in Syrve POS are displayed;
• Cause: as a result of failures, orders are "stuck" in the entities database;
• Solutions:
  • Main solution: cleaning the database of old orders through Syrve support or a special utility;
  • Temporary solution: reduce the order filtration period in the plugin config (OldOrdersPeriod parameter);

6.4. Future deliveries or banquets not displayed

• Cause: the OldOrdersPeriod parameter also affects the display of future orders;
• Solution: increase the value of the OldOrdersPeriod parameter so that it covers the time until the planned delivery/banquet date.

6.5. Bot not responding to commands in group

• Solutions:
  • Write in response to a bot message;
  • Add a slash (/) before commands;
  • Make the bot a group administrator.

6.6. Error "Exception: Remote server returned an error: (403) Forbidden"

• Cause: insufficient REST API licenses;
• Solution: Check for and free up REST API licenses on the server.

6.7. License problems

• Signs of license problems in logs:
  • Change of parameter "[28009601, MaxConnections]=0" (where 28009601 is the SmartControl module identifier);
  • Messages about attempting to release connections: "Try release connections";
  • In the till log, there are no records about the license or the value in "MaxConnections" for SmartControl is 0.
• Solution:
  • Add a SmartControl license or contact Syrve support to release "stuck" licenses.

6.8. Other common problems

• Problems with proxy settings:
  • Check the "Proxy" field in the application parameters - perhaps the restaurant address is specified there;
  • Delete the incorrect value from the "Proxy" field.
• Slow data loading in the application:
  • Ensure internet connection stability;
  • With repeated errors, SmartControl automatically increases the connection timeout.
• Multiple connections and identification problems:
  • When reinstalling the application, a new identifier is issued each time;
  • A user with the ADM role can delete unused identifiers in SmartControl parameters.
• Error loading System.Reactive library (for Syrve versions 7.1.x):
  • Copy the System.Reactive.dll library to the Syrve POS folder: "C:\Program Files\Syrve\SyrveRMS\Front.Net".
• Displaying an old till group that is no longer on the Syrve server:
  • Delete the extra till group through the parameters menu in the application;
  • Contact SmartControl support to delete old data. Old data is automatically deleted after 14 days from the last transmission from the till.
• Problems after updating Syrve:
  • Update the SmartControl plugin to a version compatible with the new Syrve version.

8.1. Areas of responsibility

• SmartResto Team: technical support and consultations for Syrve partners, third line of support;
• Syrve Support (Syrve partners): technical support and consultations for clients, ordering and managing licenses, plugin installation, diagnosing plugin operation, solving problems with the Syrve POS database;
• Hierarchy of technical support for solving problems with SmartControl:
  • First line of support: Syrve support - organization servicing Syrve at the client, Syrve partner;
  • Second line of support: Syrve;
  • Third line of support: SmartControl developers (SmartResto).
• For problems with updating data in the SmartControl application or SmartControl Telegram bot, clients need to first contact the service organization (first line of support);
• The SmartResto team provides consultations only for their products (SmartControl, SmartOrder);
• For questions about setting up Syrve, you need to contact Syrve support.

8.2. Contacts

• Website: https://smartresto.pro/;
• SmartControl application page: https://smartresto.pro/control;
• SmartControl Telegram bot page: https://smartresto.pro/bot;
• SmartControl knowledge base page: https://smartresto.pro/wiki;
• Bot in Telegram: https://t.me/smart_control_bot;
• Email: info@smartresto.pro;