# Get started

Hello! It's the SmVend team. We've prepared instructions about our web app to help you set up your SmVend account and get up to speed as soon as possible.

Also, you can always refer to these instructions for more detailed info on the personal account sections and features.

If you're new to SmVend, follow this essential steps to get started:

1. [Sign up for an account](/personal-account/sign-up)
2. Install [the SmVend equipment](https://github.com/dimk-i/smvend-faq-docs/blob/main/broken-reference/README.md)
3. [Set up](/personal-account/machines/settings), [configure](/personal-account/machines/configuration) and [edit the parameters](/personal-account/machines/parameters) of your machines
4. Create [resources](/personal-account/products/resources), [products](/personal-account/products/products) and [product matrix templates](/personal-account/products/matrix-templates)
5. Edit [product matrixes](/personal-account/machines/product-matrix) for single machines


# Sign-up

### How to sign up for an account?

{% tabs %}
{% tab title="For the head of the company" %}
You'll be assigned the [admin role](/personal-account/settings/team#what-are-the-team-roles) and have full control of your company space.

1. Go to <https://app.smvend.io/signup> and enter your e-mail address
2. Enter a confirmation code sent to your e-mail
3. Create a password
4. Fill out an onboarding form about you and your company. It's essential for quick start and convenient use of SmVend

Done! You've signed up, created your company's space and got full access to it.

Then you can [add other members](/personal-account/settings/team#how-to-add-a-team-member) to the company team.
{% endtab %}

{% tab title="For other team members" %}
You'll join the company space in the [role](/personal-account/settings/team#what-are-the-team-roles) assigned by its admin.

1. Please wait for the invitation e-mail and click the Accept button on it
2. Create a password

Done! You've signed up, joined the company space, and got access to it within your role.
{% endtab %}
{% endtabs %}

***

### What to do if I have issues when signing up?

* Double-check that you've entered the correct info in the registration form
* Ensure that you have a stable internet connection
* Clear your browser's cache and cookies, then restart your browser
* If you see any error messages, make a note of them and contact our support team

Our support team is available via e-mail at **<support@smvend.io>** or chat at the bottom right corner of our [website](https://smvend.io/en). We're always ready to help you resolve any issues with the SmVend app.

***

### How to get a demo account if I just want to explore the SmVend app?

Contact our team in any convenient way provided on our [website](https://smvend.io/en/contacts). We'll give you credentials to enter the demo account and see what the app looks like with the installed and configured machines.


# Machines

In this section, you can see a list of all your machines and general info about their operation. Every machine in this list has the name, type, and serial number of the SmVend controller installed in it.

At a glance, you can review their key performance highlights, such as recent sales, and revenue figures, and ensure smooth connectivity, stock availability, and minimal performance issues.

<figure><img src="/files/g9QSpjB9NvDK0wpwDqqx" alt=""><figcaption></figcaption></figure>

To go to the single machine page, click on one of the machines in the list. There you can:

* Change the machine [settings](/personal-account/machines/settings)
* [Configure](/personal-account/machines/configuration) the machine
* Set up machine [parameters](/personal-account/machines/parameters)
* Fill in the [product matrix](/personal-account/machines/product-matrix) and monitor [stocks](/personal-account/machines/stocks)
* Check logs, connections, and technical reports
* View reports on [events](/personal-account/reports/events), [sales by date](/personal-account/reports/sales-by-date), [sales details](/personal-account/reports/sales-details), [encashments](/personal-account/reports/encashments), [money in machine](/personal-account/reports/money-in-machines), [consumptions](/personal-account/reports/consumptions), [products](/personal-account/reports/products), and [traffic](/personal-account/reports/traffic). Their concept is the same as the main reports in the sidebar, but they only apply to that specific machine


# Settings

This section is crucial for your further work with our app. Please make sure to select all the options applicable in your case.

Everything selected in this section transfers directly to the [Configuration](/personal-account/machines/configuration) tab, where you can configure the specific function in more detail.

<figure><img src="/files/syfWW9yEe4SKtbOS8jiL" alt=""><figcaption></figcaption></figure>


# Configuration

**Deposit button** — allows you to remotely send money to the machine, for example, in case of need to refund the customer. Remote deposits are considered an expense in the reports and are always automatically deducted from the Income figures.

Other settings options depend on what you selected in the [Settings](/personal-account/machines/settings) tab. Use the info icon next to each parameter to find out its tag.

Below you can find detailed info about POS terminal settings and Recipe teaching mode.

<details>

<summary>POS terminal settings</summary>

* Payment timeout in seconds means that if the set time is exceeded, someone in the payment chain hasn't responded in time. This could be us, your bank, or the payment processor
* Vend timeout in seconds means that if the set time is exceeded, the sale is considered completed
* The interval in which the payment request restarts is the time after the payment timeout exceeds

</details>

<details>

<summary>Recipe teaching and testing mode</summary>

This section applies to the following coffee machines:

* Dr.Coffee Minibar/CoffeeBar
* Dr.Coffee M12
* Dr.Coffee F2
* Dr.Coffee F3
* Dr.Coffee F10
* Dr.Coffee F20
* Dr.Coffee F100
* Dr.Coffee CoffeeBreak
* Dr.Coffee CoffeeCentre
* Dr.Coffee C11
* Dr.Coffee H2
* Kaffit K95L/K96L

First fill out the [resources](/personal-account/products/resources), [products](/personal-account/products/products), and [matrix templates](/personal-account/products/matrix-templates) and set up the [product matrix](/personal-account/machines/product-matrix) for that specific machine. Then you can go back to the Recipe teaching and testing mode.

<img src="/files/zufOghFaG4BFDPNSt3IV" alt="" data-size="original">

1. Select Testing mode and click Save.
2. Check if the task is completed in the History tab.
3. Customize the drinks on the coffee machine. When the drinks setup is complete, go back to your SmVend account.
4. Change Testing mode to Teaching mode and click Save.
5. Check if the task is completed in the History tab.
6. Press on each drink in the coffee machine in the same order as you have in your Product matrix. When done, go back to your SmVend account.
7. Change Teaching mode to Default mode and click Save.
8. Check if the task is completed in the History tab.
9. Reboot the coffee machine.

</details>


# Parameters

In this section, you can:

* **Name the machine**
* **Select its time zone** to see reports and events in both the machine and your local time zones, if they differ
* **Identify its location** so that you can have a general view of the area your business covers
* **Set up notifications** about no payments for a long time
* **Customize the working hours** of your machine and create a complex schedule if necessary

{% hint style="info" %}
**Important!** The schedule setting does not imply the actual working schedule of the machine. This schedule is used for creating alerts. The machine remains online regardless of this setting.
{% endhint %}

<figure><img src="/files/opk6PRnQ2cuTKk5TzvyL" alt=""><figcaption></figcaption></figure>


# Product matrix

The product matrix is one of the most crucial sections that you need to fill out to benefit from all the reports in the app. The logic is that the product matrix is essentially the set of products and their resources in your machine.

There are two ways to fill it out:

1. **Create a new product matrix for the specific machine**\
   You can do it right there in the Product matrix tab, the process is the same as for [matrix templates](/personal-account/products/matrix-templates). But before that, you need to set up [resources](/personal-account/products/resources) and [products](/personal-account/products/products).
2. **Fill from the template or another machine and edit it if necessary**\
   This way is convenient if you've already filled out [matrix templates](/personal-account/products/matrix-templates) or want to copy a product matrix from another machine.

<figure><img src="/files/eaozn9v9QeEWLyioypLR" alt=""><figcaption></figcaption></figure>


# Stocks

In the Stocks tab, you can check and regulate the amount of [resources](/personal-account/products/resources) left in the machine. Resources automatically appear in this section once you've filled out the product matrix of the machine.

The logic is based on the fact that the max refill quantity you indicate in the [product matrix](/personal-account/machines/product-matrix) counts as 100%. The bare minimum of each resource is 20%. When the resource stock in the machine is below 20%, it's highlighted in red, warning you to refill it.

{% hint style="info" %}
You can refill the resource beyond the max refill quantity, but with a warning that you are refilling more than you are meant to.
{% endhint %}

<figure><img src="/files/FFMkZoHGbsceaqn3gKc1" alt=""><figcaption></figcaption></figure>

***

### How to set up Stocks for a product that consists of only 1 ingredient?&#x20;

If your business involves selling one-piece products (like soda cans or tennis balls) you will need to set up Stocks so that 1 product consists of 1 ingredient. You can read the step-by-step instructions [here](/personal-account/machines/stocks/stocks-when-1-product-1-ingredient).


# Stocks when 1 product = 1 ingredient

If your business involves selling one-piece products (like soda cans or tennis balls) you will need to set up Stocks so that 1 product consists of 1 ingredient. Below you can find the full guide on how to do so.&#x20;

1. **Create an ingredient** \
   In the [Resources](/personal-account/products/resources) section in the left menu, create an ingredient with the name of the product you are selling. For example, to count the sale of 1 can of Sumol Orange put "Sumol Orange" in the ingredient name. \
   \
   Select "pieces" (**pc**) as the unit of measure.

<figure><img src="/files/blgKkFalQxnNzvgobuy1" alt=""><figcaption></figcaption></figure>

2. **Create a product**\
   Then go to the [Products](/personal-account/products) tab in the left menu and create a product with the same name ("Sumol Orange"). Add the appropriate ingredient to this product.&#x20;

<figure><img src="/files/haEIhghp5QIE23ACEM3F" alt=""><figcaption></figcaption></figure>

3. **Repeat steps 1 and 2 (if needed)**\
   Repeat it for each product you want to count.
4. **Set up the Product Matrix table**\
   Then go to the controller profile (you can do it through the Machines section), to the [Product Matrix tab](/personal-account/machines/product-matrix). Here set the maximum amount of product the vending machine can support.

<figure><img src="/files/2joNucaz08xqyCayNPbM" alt=""><figcaption></figcaption></figure>

5. **Go to the Stocks tab**\
   Now click on the Stocks tab. Here replenish the amount of product to the current amount in the vending machine using the **Refill resources** button.

<figure><img src="/files/ndYT6JbaPsVTgjPtiPrs" alt=""><figcaption></figcaption></figure>

6. **Check the configuration**\
   You can now see the remaining product in the vending machine on the Stocks tab, and the units sold on the Consumption tab.

<figure><img src="/files/jl1oOufY6NSwOQsYL2oV" alt=""><figcaption></figcaption></figure>

## How do Stocks work?

In the Stocks tab, you can check and regulate the amount of resources left in the machine. Resources automatically appear in this section once you've filled out the product matrix of the machine.

The logic is based on the fact that the max refill quantity you indicate in the product matrix counts as 100%. The bare minimum of each resource is 20%. When the resource stock in the machine is below 20%, it's highlighted in red, warning you to refill it.


# Products

<figure><img src="/files/ZI6VeZoGemAYyfWOUiUl" alt=""><figcaption></figcaption></figure>

This section is all about the products — goods or services — that you sell. Within it, you can:

1. Specify the [resources](/personal-account/products/resources) from which your products are made
2. Specify the [products](/personal-account/products/products) themselves
3. Create product [matrix templates](/personal-account/products/matrix-templates) to quickly fill in the matrixes of single machines

Please fill out the Products section in this exact order.


# Resources

In this section, you can add resources (ingredients) that your products consist of. For example, for coffee machines, it could be coffee beans, milk, cups, water, sugar, etc.

**How to add a new resource:**

1. Click Create
2. Enter resource name
3. Select resource unit. Available units are based on the unit system selected in [Company details](/personal-account/settings/company-details): metric or imperial

You can edit resources whenever you need.

<figure><img src="/files/FN6nzoRu9lVjws1jKL7T" alt=""><figcaption></figcaption></figure>


# Products

Here you can specify all the goods and services you sell, but without prices — the main thing in this section is the composition of the products.

**How to add a new product:**

1. Click Create
2. Enter product name. Please create unique names to easily distinguish products in reports, when creating matrixes, etc.
3. Select product type: goods or service. In our app, goods have resources, but services do not. If your service requires to account  some resources/materials, select the goods product type
4. If you selected the goods product type, specify the resources and their quantities that your product consists of

<figure><img src="/files/0KdV7EKndTywQjcUSGVd" alt=""><figcaption></figcaption></figure>


# Matrix templates

Creating product matrix templates is not a must, but a very useful step if you have several machines with similar products and their prices. With the matrix templates, you can easily fill out product matrices for single machines.

**How to create a new matrix template:**

1. Enter the template name.
2. Choose how many rows and columns you need. The idea is that ideally it should be set up like your actual machine’s display, but may not be applicable in cases when you don't have products displayed. Then it's up to your personal convenience.

<figure><img src="/files/t7cf4gwHkco0wSlkXZ0m" alt=""><figcaption></figcaption></figure>

3. Select the products you are selling or create new ones if you haven't previously created them in the [Products](/personal-account/products/products) section.\
   Also, if you haven't created products before, you can select SmVend Default Product, but then it will be difficult to distinguish sales results in reports later on.
4. Once you have selected the product, enter the correct price for it.

<figure><img src="/files/ipT8HITs1WEAIzquafXK" alt=""><figcaption></figcaption></figure>

3. When all the desired fields in the matrix turn blue, it means that it's ready and nothing is missed.
4. Also, below the matrix itself, you can indicate the maximum amount of each resource per machine, so then in the [Stocks](/personal-account/machines/stocks) you can regulate the amount based on how much of that resource is left in the machine.
5. Check out all the entered data once again and click Create.

<figure><img src="/files/sNChGQJZHDFOhE2AXVJu" alt=""><figcaption></figcaption></figure>

Then you can use the created template to fill out the product matrixes for the single machines.

{% hint style="info" %}
If you've filled out the machine product matrix with the template and then made changes to the template, the machine matrix won't be updated automatically.\
To apply the changes, you need to fill out the machine matrix with the template again.
{% endhint %}


# Reports

The Reports section contains various types of statistics for your entire network of vending machines.

On each page of the section there is a filter with which you can set which machines will be displayed in the report. Using the filter, you can choose to display:

• Only online machines

• Only offline machines

• Certain [groups of machines](/personal-account/settings/groups-of-machines)

• Specific machines from the drop-down list

<img src="/files/i1jRmXVjoYFVKJncxapl" alt="" data-size="original">

Also, you can download the data from each report as a file. To do so, click on the download icon in the upper right corner of the report.

![](/files/sEL6WRPQOwhjSDFWBqhF)


# General report

The general report focuses on the financial performance of your business.&#x20;

You can see how much income each machine brings over a specific period, of time as well as its income share in comparison to other machines in the company. This allows you to make significant conclusions for your business and use this analysis to leverage the best performing devices, depending on their stock/location/etc.

To better understand the calculation here, refer to this formula:

> Income = (Coins + Bills + Cards + Remote payments) - Change\
> We don't count the remote deposits here as this is an expense in reality.

{% hint style="info" %}
**Remote payment** — payment that goes directly to the server, like QR-code payment.

**Remote deposit** — deposit made to the machine via a personal account.\
For example, a customer paid for a drink, but for some reason the drink was not made. In this case, you can remotely deposit money to the machine and let the customer get drink. This isn't included in Income, as it's essentially an expense made on your end.
{% endhint %}

<figure><img src="/files/o3yZahaMyUBHI047pezg" alt=""><figcaption></figcaption></figure>

**Negative income**

In very rare cases, income can be negative, and that's okay. For instance, when your customer made a payment but forgot to ask for change and did it later.

Let’s say Alice inserted 10€, bought a drink for 1€ and is waiting for it to be prepared. At that time, the controller is already sending information. So we have Inserted as 10€ and Income as 10€ and that Alice hasn't asked for change yet.

Next she decides to make another purchase, inserts 1€ and buys for 1€. Then she presses the Change button and gets 9€ of change. The next data we receive will look like that Alice inserted 1€, bought a product for 1€ and received change of 9€. So the income for this sale is: 1€ - 9€ = -8€.

In sum, the actual income from both sales is: 10€ + (-8€) = 2€.


# Sales by date

This report is designed to display sales analytics with a focus on time-of-sale analysis.

You can see how many sales and income were made on a certain day for all machines in total.

<figure><img src="/files/WqMJtw7TUDHRfRHkwJK3" alt=""><figcaption></figcaption></figure>


# Sales details

This report is focused on the particular details of each sale that happened on a certain day within a specific machine. Now you can see how much money was inserted into a specific machine, including all payment types.

> Inserted  = Coins + Bills + Cards + Remote payments + Remote deposits

Also, what's new here is the display of how many products and which products were sold within that specific sale and what payment type was used.

<figure><img src="/files/EB2bm4L4Md4oRMLkQN7l" alt=""><figcaption></figcaption></figure>

If you need to delete a sale from your records, you can do so by clicking on the red trash can icon for that sale.


# Money in machines

This report is a great way to find out how much money is in your machines and in what form. In addition, you can filter the information depending on what exactly you want to analyze or check.

<figure><img src="/files/yHNhIDWo7RExmRMG9K6n" alt=""><figcaption></figcaption></figure>


# Encashments

The Encashments report within the Reports section also allows you to filter the data and target a specific machine or a group of them.

The encashment formula here is simple: the sum of all encashed payment types, except for remote deposits, for a certain period.

After encashment, the numbers in the [Money in Machines](/personal-account/reports/money-in-machines) report are annulled. Encashment can be done by clicking on the "Encash" button on the single machine page.

<figure><img src="/files/SfdoGWby3QJGXZQSowXr" alt=""><figcaption></figcaption></figure>

**Special case for coffee machines**

There is a piggy bank, aka cash box, for the money inserted into the coffee machine. If a coin falls into the cash box, the only thing that can be done is to encash it.

Change is done by extracting from the bowls, in which there is money with different denominations. Usually, the machine has 10 such bowls, like 50 cents, 1€, 2€, etc.

Most coffee machines are very smart. When a customer inserts money, the machine decides where to put it: into the cash box or the bowl.

So the inserted money, no matter where it goes, counts as a part of the sale. But at the same time, only part of the inserted money will be encashed, since the other part goes into the bowls. Hence, Inserted is not equal to what we process as Encashment.

We do the encashment only from the cash box, while some of the inserted money may get into the bowls.


# Events

Events show you important updates on the machine’s performance. Once you resolve the issue, you can move the event to irrelevant.

Apart from the issues, it might as well include positive informative events, for instance, that the connection is restored. All these events are logically related to each other, and if an event switches from negative to positive, it is automatically moved to the irrelevant list.

Also, you can filter all these events by a specific machine, groups of machines, or by date.

<figure><img src="/files/tbz7ZjVSDe2kWaWRbC4Z" alt=""><figcaption></figcaption></figure>


# Products

The Product report is a great tool to understand the performance of each product in your machines and make a decision on whether to continue selling it or maybe it's time to switch to something new.

You can select a specific time period and filter the data depending on whether you need information on a specific machine or a group of machines.

Also, you can use the Quantity/Money switch to see either the number of products sold or the sales price of those products in total.

<figure><img src="/files/OEQ02EZMecLSH0yhM6Rq" alt=""><figcaption></figcaption></figure>


# Consumptions

The Consumptions report shows how much of a certain resource has already been consumed in all your machines. The data in this report is based on the [product matrixes](/personal-account/machines/product-matrix) of all your machines and the [resources](/personal-account/products/resources) you specified for each product in the [Products](/personal-account/products/products) section.

This report will help highlight the most important resources that need to be procured more frequently and in larger quantities.

<figure><img src="/files/EOg6J21siy9H22vIyFsm" alt=""><figcaption></figcaption></figure>


# Traffic

The Traffic report is located only on the Home page in the sidebar and on the Home page of a single machine.&#x20;

It allows you to identify the hours when the machines make the most sales and for the largest amount of money.

In the table, the data in the rows refer to each hour from the left column. For example, the data from the first row in the screenshot below refers to the period from 00:00 to 01:00.

![](/files/0Os5oOoAtKek0AcSLO7u)![](/files/wXN63Fp41Mw8A7W2pE4I)


# Settings

For the admin role only

This section is availiable only for the admin role. Here you can set up and edit all info related to your company:

* [Company details](/personal-account/settings/company-details) such as address, language, currency, units, time format and zone
* [Integrations](/personal-account/settings/integrations) with various platforms depenging on your local market
* [Groups of machines](/personal-account/settings/groups-of-machines)
* [Team](/personal-account/settings/team) members and their roles within the company


# Company details

For the admin role only

### How to set up the company details?

Almost all the required info is already filled out from the onboarding form. You should enter just a few details and click Save:

* Company address
* Zip / Postal code
* State (optional)
* VAT / GST (optional)

You can update your company details at any time you need.

> If you have any issues or need further assistance, contact our support team via email at **<support@smvend.io>** or via chat located in the bottom right corner of the app.


# Integrations

For the admin role only

This section offers a range of possibilities to seamlessly integrate with various platforms depending on your local market. Those integrations allow you to expand the payment options, providing greater convenience to your customers.

### Integrations

{% tabs %}
{% tab title="Payment Systems" %}

* [MB WAY](/equipment-installation/payment-systems/mb-way) (Portugal)
* [MONEI](/equipment-installation/payment-systems/monei) / Bizum (Spain)
  {% endtab %}
  {% endtabs %}

You can request a new integration according to your needs or use the existing integrations with our partners. If you have any questions don't hesitate to contact us. Our support team is available via e-mail at **<support@smvend.io>** or via chat located in the bottom right corner of our [website](https://smvend.io/en).&#x20;


# Groups of machines

For the admin role only

### How to create a group of machines?

You can bundle machines into groups to manage them in a more convenient way. One company can have several groups of machines. To create a group:

1. Click `Create group`
2. Enter the group name
3. Select the group color
4. Select the machines you want to group

> If you have any issues or need further assistance, contact our support team via email at **<support@smvend.io>** or via chat located in the bottom right corner of the app.


# Team

For the admin role only

### What are the team roles?

1. **Admin**\
   Has all rights and full access to everything in the company space. There can be only one admin in the team.
2. **Manager**\
   Has access to full data on machines added to him by the admin, but can'‎t set up members, groups of machines, integrations and company details.
3. **Technician**\
   Has access to the machines added to him by the admin. Sees only technical data: errors, connections, stocks, technical report, etc.
4. **Accountant**\
   Has access to the machines added to him by the admin. Sees only data financial data: sales, encahments, money in machines, etc.

Check out the link below for a full list of roles and permissions.

{% embed url="<https://yuccadigital.notion.site/Roles-and-permissions-0bd9d1e4205b4f138f576fffb139dac6>" %}

***

### How to add a team member?

1. Click Add member
2. Enter member's e-mail
3. Select member's role
4. Select member's machines
5. Click Invite
6. Added member will receive an e-mail invitation and has to accept it to join the team

> If you have any issues or need further assistance, contact our support team via email at **<support@smvend.io>** or via chat located in the bottom right corner of the app.


# Profile

### How do I set up my profile?

1. Fill in your full name and select your time zone, preferred interface language and time format. Save the changes

{% hint style="info" %}
You can select your local time zone. If the time zone of the machine differs from yours, you'll see the date and time in both zones in the reports.

The interface language selected in your profile applies only to your personal account and may differ from the company language.
{% endhint %}

2. Select the types of notifications you want to receive about the state of your machines. Notifications about no payments for a long time can be set up in more detail in the [Parameters](/personal-account/machines/parameters) tab of the single machine

You can update your profile details at any time you need.

> If you have any issues or need further assistance, contact our support team via email at **<support@smvend.io>** or via chat located in the bottom right corner of the app.

***

### Can I delete my profile?

Yes, you can delete your profile at any time by clicking the "Delete profile" button in the Profile section.

**If you're an admin**, your company will be deleted from SmVend app along with your account. Also, if your team members don't have membership in any other companies within SmVend, their personal accounts will be deleted too.

**If you're a team member** of several companies, your account will be deleted only in that company where you click Delete profile.

### How to switch between multiple accounts?

If you have multiple accounts bound to the same email address, you might need to know how to switch between them. Follow these steps:

1. **Finding the Profile Icon**\
   As a first step, locate the profile icon on your screen in the upper right corner.
2. **Changing Accounts**\
   To switch accounts, click the profile icon. A dropdown menu with all available accounts will appear.\
   To choose the correct account (in the example below, you can see 3 of them), click on the account name in the list, and you will be redirected to it.

<figure><img src="/files/hJrDRTmVtSQp8Z0BVLLz" alt=""><figcaption></figcaption></figure>

<br>


# Payment

To ensure uninterrupted access to your [SmVend personal account](https://app.smvend.io/), please make sure your subscription payments are made on time.

For your convenience, all payments are handled through Stripe, a secure payment system that allows you to link a card and manage your monthly billing automatically.

## How to add a payment method

1. Go to the <kbd>Payment</kbd> section in your [SmVend account](https://app.smvend.io/).

<figure><img src="/files/zEAsIAkj3uLzxyAqF33y" alt=""><figcaption></figcaption></figure>

2. You will be redirected to a secure Stripe page. Click on the <kbd>Add payment method</kbd> button.

<figure><img src="/files/GSu9WtBCQafEPcBFuBM7" alt=""><figcaption></figcaption></figure>

3. Choose your preferred option:

* Enter your card details manually
* Use Revolut Pay
* Use Google Pay

Once added successfully, your payment method will appear on the <kbd>Payment</kbd> page.

<figure><img src="/files/9ZefaOLD4q0bISIdLJ5s" alt=""><figcaption></figcaption></figure>

## Billing details & invoices

In the <kbd>Billing and Shipping Information</kbd> section, fill in your up-to-date billing details. These will be used to generate your invoices.

In the <kbd>Invoice History</kbd> section, you can view all issued invoices and their statuses.&#x20;

<figure><img src="/files/KJ8p7IlzIjDI0TRYNFJY" alt=""><figcaption></figcaption></figure>

## How to download an invoice

1. Click on the relevant invoice in the <kbd>Invoice History</kbd> list
2. Select <kbd>Download invoice</kbd> or <kbd>Download receipt</kbd>

<figure><img src="/files/PfaSt2OGLyloch6WA1os" alt=""><figcaption></figcaption></figure>

> We are always happy to help — contact our SmVend support team via email at <support@smvend.io>, through the chat in the bottom right corner of the app, or on WhatsApp at +371 28 701 129.


# Telegram Bot

## How to enable Telegram notifications

1. Follow the [link](https://t.me/SmVendBot) and click <kbd>Start</kbd> (the `/start` command will be sent automatically in the chat).
2. You'll receive a message with your <kbd>chat ID</kbd>.

<figure><img src="/files/RnBjr12wRA8wIWmlx5sr" alt=""><figcaption></figcaption></figure>

3. Then open your [SmVend account](https://app.smvend.io/) on the <kbd>Profile</kbd> page and:

* enable <kbd>Telegram</kbd> notifications
* enter your <kbd>chat ID</kbd>&#x20;
* click <kbd>Save</kbd>.

{% hint style="info" %}
If you do not see the Telegram checkbox on your <kbd>Profile</kbd> page, please contact our support team at **<support@smvend.io>**, via the chat in the bottom-right corner of the app, or on **WhatsApp at +371 28 701 129**.
{% endhint %}

<figure><img src="/files/zyIqT74AIFHntqCSxOku" alt=""><figcaption></figcaption></figure>


# Controllers

Below you can find manuals for SmVend telemetry controllers.

<figure><img src="/files/4LvRMAJAfVmWAqDiJaLm" alt=""><figcaption></figcaption></figure>

{% file src="/files/F44kefjsjSLFLgEChg07" %}

<figure><img src="/files/awfXYkk1OmMkVgIE8qii" alt=""><figcaption></figcaption></figure>

{% file src="/files/PMeQf8UT7pSG29b4kl8t" %}


# Smart controller without machines

{% hint style="info" %}
This solution is compatible with the **PULSE protocol** only.
{% endhint %}

Sometimes our goal involves processing a payment and displaying a notification on the screen to confirm that a payment has been completed. In such cases, we connect the payment system to the controller plugged into a power socket.

This approach was used in an amusement park for a Ferris wheel. We processed the payment, and once the administrator confirmed that the payment was successful, the client was granted access to the attraction.

There are various usage scenarios for this system. Some examples we have encountered include:

1. Ferris wheel
2. Cinema entrance
3. Shooting gallery
4. Shower stall at a gas station

<figure><img src="/files/hV9WvDx3p7Hfu3wQ5BNu" alt=""><figcaption></figcaption></figure>


# Remote firmware update

Updating the SmVend telemetry controller remotely keeps your system up-to-date with the latest features and security updates. Here's how to do it:

1. **Request the latest firmware**\
   Contact SmVend technical support to have the latest firmware uploaded to your сontroller.
2. **Initiate the update**\
   Follow the instructions below for your SmVend controller model.

### How to initiate updates on Smart controllers

{% hint style="danger" %}
Remote firmware update for the SmVend Smart controller is only supported when **connected via a SIM card**. Connections through Wi-Fi or Ethernet do not support remote firmware updates.
{% endhint %}

{% embed url="<https://drive.google.com/file/d/1puVEInb2STgFoZmh_ldf1KCKgELk0jVm/view?usp=sharing>" %}

### How to initiate updates on Mini controllers

{% hint style="info" %}
SmVend Mini controllers can be remotely updated via SIM card or WiFi.
{% endhint %}

To initiate the update:

1. **Disconnect power**\
   Turn off the controller's power.
2. **Ensure Internet access**\
   Ensure the device can access the Internet via SIM card or Wi-Fi.
3. **Power on**\
   While holding the controller's button, turn the power back on. All four LED indicators will briefly light up. Then the POS indicator will turn off, and the LINK and ONLINE indicators will flash alternately with a duration ratio of 1 to 1.
4. **Enter bootloader mode**\
   The controller is now in bootloader mode — release the button. Once the controller is connected to the server, the LINK and ONLINE indicators will flash with a new pattern — the duration ratio will be 1 to 7.&#x20;
5. **Update is complete**\
   After downloading the update, all four indicators will light up continuously as the new software is installed. Once the installation is completed, the controller will automatically switch back to normal operating mode.


# Coffee machines

Welcome to the Coffee Machines Installation section of our guide! Whether it's your first time setting up a coffee machine or your hundredth, this section will guide you through the process to ensure a smooth and hassle-free installation.

From simple drip coffee makers to sophisticated espresso machines, our step-by-step instructions will help you get your machine up and running in no time.

We prepared guides on how to set up the following coffee machines:&#x20;

{% tabs %}
{% tab title="Dr.Coffee" %}

* [C11](/equipment-installation/coffee-machines/dr.coffee/c11)
* [CoffeeBar / MiniBar S / S2](/equipment-installation/coffee-machines/dr.coffee/coffeebar-minibar-s-s2)
* [F2](/equipment-installation/coffee-machines/dr.coffee/f2)
* [F3](/equipment-installation/coffee-machines/dr.coffee/f3)
* [F10](/equipment-installation/coffee-machines/dr.coffee/f10)
* [F11/F12](/equipment-installation/coffee-machines/dr.coffee/f11-f12)
* [F20](/equipment-installation/coffee-machines/dr.coffee/f20)
* [H2](/equipment-installation/coffee-machines/dr.coffee/h2)
* [H8](/equipment-installation/coffee-machines/dr.coffee/h8)
* [M12](/equipment-installation/coffee-machines/dr.coffee/m12)

Also, in the Dr. Coffee section you can find useful instructions on how to:&#x20;

* Use the [Test mode](/equipment-installation/coffee-machines/dr.coffee/test-mode)
* Do the [Recipe learning](/equipment-installation/coffee-machines/dr.coffee/recipe-learning)
* Connect Dr.Coffee via [MDB with the error reading](/equipment-installation/coffee-machines/dr.coffee/mdb-+-error-reading)
  {% endtab %}

{% tab title="Eversys" %}

* [Cameo](#eversys)

Also, in the Eversys section you can find tips on how to:&#x20;

* Set up [API interface](/equipment-installation/coffee-machines/eversys/api-interface)
* Configure the [Product Matrix](/equipment-installation/coffee-machines/eversys/product-matrix)
* Use [Avertising on the screen feature](/equipment-installation/coffee-machines/eversys/advertising)
  {% endtab %}

{% tab title="Jofemar" %}

* [G23](/equipment-installation/coffee-machines/jofemar)
  {% endtab %}

{% tab title="Kaffit" %}

* [95L / 96L](/equipment-installation/coffee-machines/kaffit-95l-96l)
  {% endtab %}

{% tab title="La Cimbali" %}

* [S15 / S30](/equipment-installation/coffee-machines/la-cimbali)
  {% endtab %}

{% tab title="Necta" %}

* [Koro Prime](/equipment-installation/coffee-machines/necta/koro-prime)
* [Brio Up Lavazza](/equipment-installation/coffee-machines/necta/brio-up-lavazza)
* [Canto Plus Model ES-8/IQ](/equipment-installation/coffee-machines/necta/canto-plus-model-es-8-iq)
  {% endtab %}

{% tab title="Rheavendors" %}

* [eC](/equipment-installation/coffee-machines/rheavendors/ec)
* [XX-OC](/equipment-installation/coffee-machines/rheavendors/xx-oc)
  {% endtab %}

{% tab title="Shaerer" %}

* [Barista One](/equipment-installation/coffee-machines/schaerer/barista-one)
* [Coffee Factory](/equipment-installation/coffee-machines/schaerer/coffee-factory-tchibo-coffea-touch)
* [Coffee Soul](/equipment-installation/coffee-machines/schaerer/coffee-soul)
  {% endtab %}

{% tab title="WMF" %}

* [WMF](/equipment-installation/coffee-machines/wmf)

In this section you can find [the training documentation](/equipment-installation/coffee-machines/wmf) for WMF New Generation machines.&#x20;
{% endtab %}
{% endtabs %}

Also, you can find the universal [MDB](/equipment-installation/coffee-machines/mdb) connection scheme with the video explanation.


# MDB

Let's make it simple: MDB stands for **Multi-Drop Bus**. It's a standard way for different parts of a vending machine to talk to each other. Think of it as a common language that all the components understand.

**Key points about MDB:**

1. **Standard Communication**\
   MDB ensures that parts like coin acceptors, card readers, and the vending machine controller can communicate smoothly.
2. **Single Cable for Power and Data**\
   MDB cables carry both power and data, making setup easier with fewer cables.
3. **Master-Slave Setup**\
   The vending machine controller (master) talks to the other devices (slaves) to get information and send commands.
4. **Polling Mechanism**\
   The controller checks each device to see if there's any new data as coins inserted or cards swiped.

**Why MDB is important:**

* **Compatibility**: Different parts from various manufacturers can work together.
* **Reliability**: Provides a dependable way for devices to exchange data.
* **Simplicity**: Fewer cables and easier installation.

The MDB protocol is commonly used for managing payments, selecting products, and integrating various payment options.

If you have any questions, feel free to reach out to our support team at **<support@smvend.io>**. We're here to help!


# MDB + Smart controller

Below is the cable scheme and video guide for connecting the SmVend Smart controller to a vending machine via MDB.

<figure><img src="/files/SDerY4NtvVC0sMit241d" alt=""><figcaption></figcaption></figure>

{% embed url="<https://drive.google.com/file/d/1dOYUtWw-rSPwrXT01Qq9cZQFZgi-XQI6/view?usp=sharing>" %}


# MDB + Mini controller

Below is a general scheme for connecting the SmVend Mini controller to a vending machine via MDB.

<figure><img src="/files/7BXSLkNuehMbgdCGuN16" alt=""><figcaption></figcaption></figure>


# Dr.Coffee

In the Dr. Coffee section, you will find guides on how to set up the following coffee machines:&#x20;

* [C11](/equipment-installation/coffee-machines/dr.coffee/c11)
* [CoffeeBar / MiniBar S / S2](/equipment-installation/coffee-machines/dr.coffee/coffeebar-minibar-s-s2)
* [F2](/equipment-installation/coffee-machines/dr.coffee/f2)
* [F3](/equipment-installation/coffee-machines/dr.coffee/f3)
* [F10](/equipment-installation/coffee-machines/dr.coffee/f10)
* [F11/F12](/equipment-installation/coffee-machines/dr.coffee/f11-f12)
* [F20](/equipment-installation/coffee-machines/dr.coffee/f20)
* [H2](/equipment-installation/coffee-machines/dr.coffee/h2)
* [H8](/equipment-installation/coffee-machines/dr.coffee/h8)
* [M12](/equipment-installation/coffee-machines/dr.coffee/m12)

Also, here you can find useful instructions on how to:&#x20;

* Use the [Test mode](/equipment-installation/coffee-machines/dr.coffee/test-mode)
* Do the [Recipe learning](/equipment-installation/coffee-machines/dr.coffee/recipe-learning)
* Connect Dr. Coffee via [MDB with the error reading](/equipment-installation/coffee-machines/dr.coffee/mdb-+-error-reading)


# C11

### Mini controller + C11

{% embed url="<https://drive.google.com/file/d/16Kk-IJLT4srTktNvmwzLxFHHFLltGf4P/view?usp=sharing>" %}

### Smart controller + C11

{% embed url="<https://drive.google.com/file/d/1XQhZ1Glj9ioCzEwSVvYAixz0WWV3tdvQ/view?usp=sharing>" %}


# CoffeeBar / Minibar S / S2

### Mini controller + Minibar

{% embed url="<https://drive.google.com/file/d/1WmBBXX7GirtV8bx76yx3H9hC22TQWgHU/view?usp=sharing>" %}

### Smart controller + Coffee Bar

{% embed url="<https://drive.google.com/file/d/1dxWjMTaKrpdQmaKgDJZ7-jglnCWtS9ia/view?usp=sharing>" %}


# F2

### Mini controller + F2

{% embed url="<https://drive.google.com/file/d/1YPELCeDXrU-2k7kEb_D6H2PWLbWabB-8/view?usp=sharing>" %}

### Smart controller + F2

{% embed url="<https://drive.google.com/file/d/1ydt1p_CF4Wgq_rQb_4WKIKxgubwikbt1/view?usp=sharing>" %}


# F3

### Mini controller + F3

{% embed url="<https://drive.google.com/file/d/1Ou6bFzPJhbseMUH8yZjF5Xku4W3zcyGC/view?usp=sharing>" %}


# F10

### Smart controller + F10

{% embed url="<https://drive.google.com/file/d/165-ydluiGXUzJJLle3WNXdVA7RH9hip4/view?usp=sharing>" %}

| Data Line                                                     | Power Supply                                              |
| ------------------------------------------------------------- | --------------------------------------------------------- |
| <p><br><img src="/files/YdA8n6gf2WfZdcQjlOqu" alt=""><br></p> | <p><br><img src="/files/EOtGPrq1NZbX2zGhSzzm" alt=""></p> |


# F11 / F12

### Mini controller + F12

{% embed url="<https://drive.google.com/file/d/1cy_ulgjJ2kCqj8tbayEtBwjo2GEfogn2/view?usp=sharing>" %}

### Smart controller + F11

{% embed url="<https://drive.google.com/file/d/1PzK-42xIKom6gxILkjqwoU7628eHS3xs/view?usp=sharing>" %}

### Product matrix for Dr.Coffee F11/F12 machines

<table><thead><tr><th width="121">ID</th><th>Product name</th></tr></thead><tbody><tr><td>1</td><td>Ristretto </td></tr><tr><td>2 </td><td>2 Ristretto </td></tr><tr><td>3 </td><td>Espresso </td></tr><tr><td>4 </td><td>2 Espresso </td></tr><tr><td>5 </td><td>Lungo </td></tr><tr><td>6 </td><td>2 Lungo </td></tr><tr><td>7 </td><td>Black coffee (Crema) </td></tr><tr><td>9</td><td>Americano</td></tr><tr><td>11 </td><td>Coffee filter (Regular)</td></tr><tr><td>13 </td><td>Cappuccino</td></tr><tr><td>14</td><td>2 Cappuccino</td></tr><tr><td>15</td><td>Flat white</td></tr><tr><td>16</td><td>2 Flat white</td></tr><tr><td>17</td><td>Macchiato</td></tr><tr><td>18</td><td>2 Macchiato</td></tr><tr><td>19</td><td>Latte</td></tr><tr><td>20</td><td>2 Latte</td></tr><tr><td>21</td><td>Latte Macchiato</td></tr><tr><td>23</td><td>Heating/Warm milk</td></tr><tr><td>25</td><td>Milk foam</td></tr><tr><td>27</td><td>Hot water</td></tr><tr><td>28</td><td>My coffee</td></tr><tr><td>29</td><td>Coffee pot</td></tr><tr><td>32</td><td>Hot chocolate</td></tr><tr><td>33</td><td>Cold americano</td></tr><tr><td>34</td><td>Americano big</td></tr><tr><td>38</td><td>Barista</td></tr></tbody></table>


# F20

### How to disassemble Dr. Coffee F20

{% embed url="<https://drive.google.com/file/d/1ilzw5xJ11DqqVvnDOpvDBNV_QhLQ_qpW/view?usp=sharing>" %}

### How to modificate the MDB connector

{% embed url="<https://drive.google.com/file/d/16javnw3ppnISJuBmME6CdQKAs72-ItwT/view?usp=sharing>" %}

### Mini controller + F20

{% embed url="<https://drive.google.com/file/d/1yh76j0AbYHVXKkirgStbvuwfSHFH9yhf/view?usp=drive_link>" %}

### Smart controller + F20

{% embed url="<https://drive.google.com/file/d/1QDbf1rOHg2IL9WCVNt5js5pQRLxfqnxB/view?usp=drive_link>" %}

| <p><br><img src="/files/l5kKrWnv1BvPqVLLifHN" alt=""></p> | <p><br><img src="/files/r2jXrzdoHYXYye33IxLj" alt=""></p> |
| --------------------------------------------------------- | --------------------------------------------------------- |


# H2

### Mini controller + H2

{% embed url="<https://drive.google.com/file/d/1cj9LHmQIg1_1-5xR20siTY3DoEmoh3LL/view?usp=sharing>" %}

### Smart controller + H2

{% embed url="<https://drive.google.com/file/d/1VCk4DLDlDZ6iWWKbwBMnOUY6E7Kd5uSw/view?usp=sharing>" %}


# H8

### Smart controller + H8

{% embed url="<https://drive.google.com/file/d/1CHtllzlSxwNaPd7FQIrdfgzZieL5WEfX/view?usp=sharing>" %}


# M12

### Mini controller + M12

{% embed url="<https://drive.google.com/file/d/1PPuahbEtSo4FegY8_OdZy4tLhZllBltk/view?usp=sharing>" %}

### Smart controller + M12

{% embed url="<https://drive.google.com/file/d/1kBxBtkaVF6nRPlLxgr7EgL6AYjUt06mD/view?usp=sharing>" %}


# Coffee Zone / Coffee Express

### How to connect Mini controller

1. **Preparation**\
   Disconnect the machine from the power supply and remove the back cover of the coffee machine. This will provide access to the internal components for connecting the controller.
2. **Disconnect the Display cable**\
   Disconnect the cable from the coffee machine's board that goes to the display.

<figure><img src="/files/Cv2epj62L9sX1NDZVWD1" alt=""><figcaption></figcaption></figure>

3. **Connect the Display cable to the controller**\
   Connect the disconnected cable to the 7-pin connector on the controller.

<figure><img src="/files/rPZtQXvn5vT4QGYt7tQB" alt="" width="563"><figcaption></figcaption></figure>

4. **Connect the Supplied Cable**\
   In place of the disconnected cable connect the cable supplied with the controller to the coffee machine's board. Connect the other end of this cable to the 8-pin connector on the controller.

<figure><img src="/files/jaIBVYMhEloxkUgyi6rQ" alt="" width="563"><figcaption></figcaption></figure>

### How to connect Smart controller

1. **Preparation**\
   Disconnect the machine from the power supply and remove the back cover of the coffee machine. This will provide access to the internal components for connecting the controller.
2. **Disconnect the Display Cable**\
   Disconnect the cable from the coffee machine's board that goes to the display.

<figure><img src="/files/WJXg6CAjkvByvryscWKx" alt=""><figcaption></figcaption></figure>

3. **Connect the Supplied Cable and the Display Cable**\
   In place of the disconnected cable connect the cable supplied with the controller to the coffee machine's board. Connect the other end of the supplied cable to the display cable.

<figure><img src="/files/Pw4wjg8zy7ynunmB4cr7" alt="" width="375"><figcaption></figcaption></figure>

4. **Connect the Power Supply**\
   Connect the power supply plug of the supplied cable to the socket marked +24V in the image from step 2. Connect the remaining end of the supplied cable to the Smart Connector controller.


# Recipe learning

Recipe learning is essential for your Dr. Coffee machine to collect and provide accurate data about your sales and resources. To ensure everything is set up correctly, please follow the guide below.

### Recipe learning process

1. Go to the page of a specific machine. Ensure that the controller is online.

{% hint style="info" %}
**Important!** If the controller is offline, check the internet connectivity via a SIM card or Ethernet cable. If the controller remains offline, settings **will not be transmitted** to the controller.
{% endhint %}

2. Go to the `Configuration` tab on the machine page. In `Teach mode` section enable `Testing mode` and click `Save` button at the bottom of the page.

<figure><img src="/files/vHfk3jZGpzDIAPbILvvJ" alt=""><figcaption></figcaption></figure>

3. Ensure that changes are applied on the `History` tab.

<figure><img src="/files/H5MTGYkxoTEMyYmiMez9" alt=""><figcaption></figcaption></figure>

4. Set up all recipes on the coffee machine itself.
5. After the recipes are correctly implemented on the machine, you need to teach the controller. To do so, go to the `Configuration` tab on the machine page and change `Teach mode` to `Teaching mode` . Then, click `Save` button at the bottom of the page.

<figure><img src="/files/UM99cHMJiHhr2VbslUTM" alt=""><figcaption></figcaption></figure>

6. Ensure that changes are applied on the `History` tab.
7. Click twice on each drink on the coffee machine screen. There should be a 3-second pause between the first and second attempts.

{% hint style="info" %}
**Important!** The order in which the drinks are pressed should match the numbering of the drinks. The numbering is usually arranged from left to right.

<img src="/files/kAaDdDq5B6RutxqUmO2S" alt="" data-size="original">.           ![](/files/1bnprSBLt1hXq05oeBGk)
{% endhint %}

8. After all drinks are pressed, go back to the `Configuration` tab and change `Teach mode` to `Default mode`. Then, click `Save` button at the bottom of the page.

<figure><img src="/files/ONWzwC7akkH7PF0MYhL5" alt=""><figcaption></figcaption></figure>

9. Ensure that changes are applied on the `History` tab.
10. Then you need to create [Resources](/personal-account/products/resources), [Products](/personal-account/products), and [Product Matrix](/personal-account/machines/product-matrix).&#x20;

{% hint style="warning" %}
**Important!** The matrix should be created in the same order as the numbering of the drinks.
{% endhint %}

11. Add the ready matrix template to the specific machine page that you configured before.

***

{% embed url="<https://drive.google.com/file/d/1IFD5lKR5qKINRitFtX3hQGw2oHg_Lsfh/view?usp=sharing>" %}


# Test mode

{% embed url="<https://drive.google.com/file/d/17mjTB1_vY3r-SQ98MRk0VgveEk-wWGbd/view?usp=sharing>" %}


# MDB

1. **Connect the MDB cable to the machine**\
   Connect the SmVend MDB cable to the MDB connector on the coffee machine.<br>

   <div align="center"><figure><img src="/files/l26a0qkshnCBGoSb7MLS" alt="" width="375"><figcaption></figcaption></figure></div>
2. **Connect the MDB cable to the controller**\
   Connect the other end of the SmVend cable to the Micro-Fit connector on the controller.

<div align="center"><figure><img src="/files/DtVUd2bXjLuuTOrSS7vz" alt="" width="563"><figcaption></figcaption></figure></div>

3. **Enable the MDB mode**\
   Enable the MDB mode on the coffee machine and set the prices as shown in the videos below.

{% embed url="<https://drive.google.com/file/d/1j12ilAvEd8cSW7CqVdIK-_e1WgUTWnA0/view?usp=sharing>" %}

{% embed url="<https://drive.google.com/file/d/1b2UPpxUr8TopawM-cC1_bksgM3-F31XR/view?usp=sharing>" %}


# MDB + error reading

Advantages of connecting Dr.Coffee machines via MDB with error reading:

1. **Minimal disassembly required**\
   The connection for reading errors is conveniently located on the backboard of the coffee machine, reducing the need for extensive disassembly.
2. **Simplified recipe management**\
   There's no need to perform recipe learning on the controller, streamlining the setup process.
3. **Enhanced compatibility**\
   Eliminates issues related to the controller's compatibility with specific recipes, such as those involving chocolate.
4. **MDB bill acceptor integration**\
   Provides the option to connect an MDB bill acceptor, enhancing payment flexibility.

{% embed url="<https://drive.google.com/file/d/1Jy06zLKCEBgCWE37cjbFFiZaTqUwkqJM/view?usp=sharing>" %}

<figure><img src="/files/cNvrlJOiBEkZPahrCC2l" alt=""><figcaption></figcaption></figure>


# Eversys

Setting up your Eversys coffee machine with the SmVend controller will enhance your coffee vending experience by providing advanced features such as versatile payment options, remote management, and detailed reporting.&#x20;

To start integrating your machine, go to the [API interface](/equipment-installation/coffee-machines/eversys/api-interface) guide.


# API interface

Here you can find an answer on how to enable the API interface to make your Eversys coffee machine set up well.

### **Locating the API connector on Eversys machines**

Below is a tip on where to find the API connector on Eversys machines.

1. First, you need to remove a grounds drawer&#x20;
2. Look at the bottom panel of the machine — the API connector will be visible there

<figure><img src="/files/CmDUnefDh9tSUF4sBtdb" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/i5KnKhOLjZNsv6FOiOvQ" alt=""><figcaption></figcaption></figure>

### **Enabling the API interface on your machine**

To enable the API Interface functionality on your machine, follow these steps. Without enabling this feature, the machine will not respond to any API requests.

**Steps to Enable API Interface:**

1\. Enter the Service Menu

<img src="/files/u58OVPcKnlPFnTd3aVnS" alt="" width="563">

2\. Navigate to the "Interfaces" Section

<img src="/files/FfINMUEDZGdbfmsYwghw" alt="" width="563">

3\. Access the "CCI/CSI/API" Section

<img src="/files/4lUhOOrXpF6lyvLnxMsA" alt="" width="563">

4\. Select the "API" Option

<img src="/files/MXMLnqljrl4zGlJf1SfT" alt="" width="563">

5\. Set the "Use API for Payment Solution" parameter to "Yes"

<img src="/files/RVyCNA7opo2SGqBBfO8R" alt="" width="563">

{% hint style="info" %}
**Attention!** `Payment solution - Yes` option must always be set, even if no payment device is connected. Otherwise, sales will not appear in your SmVend personal account.

If no payment solution is connected, you need to set the price for the goods to 0 in your SmVend personal account to enable free preparation.
{% endhint %}

6\. Tap the back arrow button and restart the display to apply changes.

### Is it necessary to set the prices of goods on the machine?

No, as soon as you set the prices on the controller, they will immediately appear on the screen of the coffee machine.


# Product matrix

If the `Payment system` configuration is set to `Yes` without an existing terminal, the coffee machine will send all data to the controller, which acts as a payment device in this case. \
\
If the `Payment system` is set to `No`, the coffee machine will not send any data except for error messages. This configuration helps manage data flow and ensures that the machine operates correctly based on the available payment infrastructure.

{% hint style="info" %}
Prices in the product matrix should be included only if you are using a payment terminal. If there is no payment terminal, set the product prices to 0. This ensures that the machine does not attempt to process payments without the necessary hardware.
{% endhint %}

Eversys coffee machines equipped with the latest software versions support product numbering as illustrated in the image below.

<figure><img src="/files/ByM6REfyBssHGGGLZrBs" alt=""><figcaption><p>Standard product numbering in the product matrix for Eversys coffee machines</p></figcaption></figure>

### How to configure the product matrix if I have 2 display screens on my Eversys coffee machine?&#x20;

For Eversys coffee machines equipped with dual display screens, an additional configuration is required. Please contact the SmVend support team at **<support@smvend.io>** or via WhatsApp at **+371 28 701 129** to obtain this configuration. Once the configuration is complete, set up your product matrix as follows:

* **Left Screen:** Assign odd-numbered products (e.g., 1, 3, 5, 7, ...)
* **Right Screen:** Assign even-numbered products (e.g., 2, 4, 6, 8, ...)

<figure><img src="/files/xV4wR5WwyTRoP74ubdaO" alt=""><figcaption><p>Product numbering in the product matrix for Eversys coffee machines with dual display screens</p></figcaption></figure>

### What if I plan to use different sorts of milk in my machine?&#x20;

If you intend to use two different sorts of milk in your products, please contact the SmVend support team for assistance with additional configuration. You can contact them via email at **<support@smvend.io>** or WhatsApp at **+371 28 701 129**.

{% hint style="info" %}
**Please note** that if your coffee recipes differ in more than just the type of milk used, configure the controller as if it is using only one type of milk. This means that the distinction between the recipes is not solely based on the milk type.

The setting for two types of milk should be used only when the drinks differ solely by the milk type, with all other aspects of the recipe being identical. In this scenario, the drinks will appear as the same drink number in the coffee machine's sales history.
{% endhint %}


# Advertising

{% hint style="warning" %}
This function is only available for coffee machines with firmware **v.5.3.1** or higher.
{% endhint %}

### Advertising with SmVend controller

To set up advertising on your coffee machine screen, please follow these steps:

1. **Connect to the Internet**\
   Plug in a LAN cable to connect your Eversys Cameo coffee machine to the Internet. Then, ensure the Internet is working. To do so, log in with the technician's password and navigate to `Interfaces menu` > `Telemetry` > `Check connection`
2. **Upgrade firmware**

   In your Eversys account, upgrade the coffee machine’s firmware to version 5.3.1 or newer.<br>

   <figure><img src="/files/MYpvJ6xNV3cFq337FIh2" alt=""><figcaption></figcaption></figure>
3. **Import screen file**\
   Download the screen file [here](https://drive.google.com/file/d/1jMbgtZ--3xMDJWJNtkQw7ydTx_HVsVhU/view) and save it to a USB key. Then, log in to the Menu with the technician's password and go to the `Display`

<figure><img src="https://lh7-us.googleusercontent.com/O37B0DmWFKx4S5am4JmHQKbSapsJZ1Y0Ps2bLQqF2zJ_RVL_uMrAWpGgTFfOXWLjQ8Q6CK-KMboj79mdnfYt1nDISeAeCa7QzY_RwE21D6nSEW9BXGne7I5U4vZ2hfAGztRMp-dA8qppw1hh-5hpR6o" alt="" width="563"><figcaption></figcaption></figure>

Click `Import Screen`

<figure><img src="https://lh7-us.googleusercontent.com/aXzEXCkIgGYRn8wZsrbueLf8RxzM4jWC6scIkp8oX_k6o-vzY9B7VPTkvYpKrCaS42vvmF7BA9pVdhT8VEZ9FsDbpGoGtJrDlEFe-buisIhk_z_Pt5dMXXkEDJG0eVkrPXFNC35IuF3OGDVyYfA-itQ" alt="" width="563"><figcaption></figcaption></figure>

Insert the USB key until `Start import` lights up, then click it.

<figure><img src="https://lh7-us.googleusercontent.com/wefNeZrgzqX4jON79bRLYAWZ5otpDq1VMJzR_9LWEqHFnVJf8aBdIw4QMFYaCTsgnZ7FydEHDD858mnX-gbiXPru523CvgrDKiJH2cq4O-bibo4_iggmNQgiGn8ujDMAR-oAVJGdoO9HPkd8TWsSACQ" alt="" width="563"><figcaption></figcaption></figure>

Remove the USB key after the import and let the display reboot.

4. **Configure display settings**\
   Log in to the menu with the technician password and go to the `Display` again.

<figure><img src="https://lh7-us.googleusercontent.com/O37B0DmWFKx4S5am4JmHQKbSapsJZ1Y0Ps2bLQqF2zJ_RVL_uMrAWpGgTFfOXWLjQ8Q6CK-KMboj79mdnfYt1nDISeAeCa7QzY_RwE21D6nSEW9BXGne7I5U4vZ2hfAGztRMp-dA8qppw1hh-5hpR6o" alt="" width="563"><figcaption></figcaption></figure>

Go to the `Screensaver menu`

<figure><img src="https://lh7-us.googleusercontent.com/x02mG6HmK4ukXXVOuBkgKP5WlTeyvBJ_sW2_eP5qWvjaMOydb8D1H0BBbAPEaxhzNfgovYXpMV3c1tJtyhIthnuUdy2FlM-9zBi0PRXErsdT31969HhSfrB8Wp63E3KPE8QPdoeMYtEvBc-585L-fl0" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://lh7-us.googleusercontent.com/jkqV_iI1zfhHIde63dKIBDgKeC-H4icaDHFJhSxmBmASjusbFLKXPyHrOrWjujXN0CPdGQ5ZuUmOSkLHLxJbD9zsrzh-mZXZuxn2r8wWOdEMGnp_80mezvQtAgEgZgxG66ohUT76DhfMftPusoxylwg" alt="" width="563"><figcaption></figcaption></figure>

Then, go to the `Machine configuration menu`and set `Operating Mode` to `Self-Service`

<figure><img src="https://lh7-us.googleusercontent.com/U37XwnQmlL_gWR5CvF4o-qS-2TLT_ij7KQ6ejz3jvhCe4UzSrTdtsJH-OltZbDxIe4t5o4lbFdCBe89K3W1lRn9NVEdXTD3WZHHKbnToqHFUPv0fIizr9xEl6XUf38JGdH9HtHj6Zj8zOZsa3mzPyig" alt="" width="563"><figcaption></figcaption></figure>

Exit the menu (lower left arrow) and let the display reboot.&#x20;

5. **Configure Product Display**\
   Go to the `Product & Keys` menu and select a coffee product (1). Go to the second parameter page (2) and set `Progress Screen` to `Pictures during dispensing (3)`

<figure><img src="https://lh7-us.googleusercontent.com/W48uMhkRJiOX_KVsWM_Yi8ZyHAKrFOSPLrNmp1gjyxqjBNqGZyi1wfPEHWRkzfELhyWi791_s6foWB13ErqxUCxNW83yB1XHTarfZES3J4xjye8DNIIJ3JbVfIXp6fWi8SxdQAsT3hOQPQhI6-5J8vU" alt="" width="563"><figcaption></figcaption></figure>

6. **Verify Display Settings**\
   Logout from the menu (lower left corner). Press the same coffee button (e.g., the second button) and verify that the imported pictures are displayed during dispensing.
7. **SmVend configuration**\
   Log into your [SmVend account](https://app.smvend.io), go to the `Machines` list and select your machine.

<figure><img src="/files/T0Xuqz1vDKSWy1nyYnbM" alt=""><figcaption></figcaption></figure>

Navigate to the `Settings` menu, set the parameter to `Eversys`, and click `Save`. Refresh the page.

<figure><img src="/files/mBaBmkBipWdzxBBheYVT" alt=""><figcaption></figcaption></figure>

Go to the `Ads campaign` section and enter the campaign name. Also, you need to choose the resolution of your coffee machine. After that add 5 pictures for the progress screen and 5 for the screensaver.\
Click `Create` to send the pictures to your coffee machine.

<figure><img src="/files/jSnH3xFuFaB3RZH34fWg" alt=""><figcaption></figcaption></figure>

***

### Advertising without a controller

To display advertisements on your coffee machine, please follow these steps:

1. **Connect and Bind the Coffee Machine**

   Connect the coffee machine to the internet. Bind the machine to your personal Eversys account.<br>
2. **Upgrade Firmware**

   In your Eversys account, upgrade the coffee machine’s firmware to version 5.3.1 or newer.

<figure><img src="/files/46zKAIeQTDbLevhPHZ5H" alt=""><figcaption></figcaption></figure>

3. **Install Advertisement Screen File (Optional)**\
   If you want advertisements to show during drink preparation, download the [screen file](http://nevada317.com/testsv2-3cc677bb32.Screen) to a pen drive and install it on the coffee machine.\
   \
   If you only want advertisements in screensaver mode, skip this step.<br>
4. **Add Machine to SmVend Account**

   Contact the Eversys Support team at **<services@eversys.com>** and request them to add your coffee machine to the SmVend account.

{% hint style="warning" %}
Please be aware that we cannot send advertisements if the coffee machine is not added to the SmVend account.
{% endhint %}

5. **Provide Machine ID**\
   Locate the machine ID in your Eversys account or in the machine’s settings. Navigate to `Service menu` —> `Interfaces` —> `Telemetry` to find the ID. Provide this ID to the SmVend support team at **<support@smvend.io>** or via WhatsApp at +371 28 701 129 (available for messaging only).&#x20;

6. **Follow Video Manuals**

   For Eversys Cameo, review and follow the steps in this [video manual](#eversys-cameo).

   For Eversys Legacy, review and follow the steps in this [video manual.](#eversys-legacy)<br>

7. **Upload Advertisements**

   Once setup is complete, you can upload pictures directly to the machine.

{% hint style="info" %}
Please be aware that the machine must be connected to the internet over the LAN to do so.
{% endhint %}

***

### Send pictures to multiple machines

1. **Access Integrations**

   Go to `Settings` and navigate to `Integrations` —> `Ads campaign`
2. **Configure Campaign for Multiple Machines**

   Enter the campaign name. Add 5 pictures for the progress screen and 5 for the screensaver. Select the coffee machines you want to update using the arrow.

   Click `Create` to send the pictures to the selected machines.

   <figure><img src="/files/KYQ4mDhpbPoId0hXFZvy" alt=""><figcaption></figcaption></figure>

### Video guides

{% embed url="<https://drive.google.com/file/d/1FM0oDVQd6VU9LTHmEJLrO1OfEjC-gNaD/view?usp=drive_link>" %}

{% embed url="<https://drive.google.com/file/d/1-wR4d7wtvIKWxLeSlx0qpOJzeg2EoVDZ/view?usp=sharing>" %}

{% embed url="<https://drive.google.com/file/d/16WS3ImstXPpykGAJd-yi2-JXRUJZvFyG/view?usp=drive_link>" %}


# Jofemar

To connect your Jofemar coffee machine with the Mini controller, please use the standard [MDB scheme](/equipment-installation/coffee-machines/mdb/mdb-+-mini-controller).

To connect your Jofemar coffee machine with the Smart controller, please follow steps below:

1. Find the 12V power supply unit on the front panel (marked with a yellow circle)
2. Disconnect the wires currently connected to the power supply unit (indicated by an orange arrow)
3. Insert the SmVend cable between the disconnected wires (indicated by two orange arrows) to establish a parallel connection
4. Identify the two MDB ports on the machine (indicated by blue arrows)
5. Connect the MDB cable to either of the two MDB ports (blue arrows)

<figure><img src="/files/jI1xERKMiSPxTcAikAQ7" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/13ONS4rAwrsnzOijBfYK" alt=""><figcaption></figcaption></figure>

If you need any assistance, please contact customer support at **<support@smvend.io>**


# Kaffit 95L / 96L

### Disassembling Kaffit K96L

{% embed url="<https://drive.google.com/file/d/1i_m4VkgYHo-vCBnH4KPovRW5H4KMHL46/view?usp=sharing>" %}

### Smart controller + K96L&#x20;

{% embed url="<https://drive.google.com/file/d/1t6KOOW5DunIqJDxkDliXUPI46b6s-y4e/view?usp=sharing>" %}

## Reassembling the K96L cable

To connect the power supply to the SmVend telemetry controller, follow these steps to reassemble your coffee machine's standard +24V power supply cable.

{% hint style="danger" %}
**Attention!** Ensure the coffee machine is turned off before performing any actions.
{% endhint %}

### 1. Prepare the coffee machine

1. **Turn off the coffee machine**\
   Ensure the coffee machine is completely powered off.
2. **Remove the back cover**\
   Remove the back cover of the coffee machine to access the internal components.
3. **Locate the power supply cable**\
   Find the +24V power supply cable you will reassemble (the pink one marked in the picture below).

<figure><img src="/files/2Uf0as8Gx2dDhYy51nBl" alt=""><figcaption></figcaption></figure>

### 2. Disconnect the existing cable

1. **Disconnect the cable**

   Disconnect the cable marked in the photo below from the coffee machine.

<figure><img src="/files/AWbVT1kPnWBB17wcpeTd" alt=""><figcaption></figcaption></figure>

### 3. Connect the SmVend cable

1. **Disconnect the +24V wire**\
   Disconnect the +24V wire from the connector.
2. **Connect wires**\
   Connect the disconnected +24V wire to the +24V (red) wire of the SmVend cable. You can twist the wires together, but for the best contact, solder the wires.
3. **Reconnect the cable**\
   Connect the joined wires back into the connector of the coffee machine cable.

<figure><img src="/files/Ucco35boUpqzarUnuwyQ" alt=""><figcaption></figcaption></figure>

### 4. Final connections

1. **Reconnect to the coffee machine**

   Connect the reassembled cable back to the coffee machine.
2. **Connect to the level converter and SmVend controller**

   Connect the cable to the level converter and the SmVend telemetry controller. The level converter is supplied with the controller.

<figure><img src="/files/wptyYE6JHQU5djnLdsS2" alt=""><figcaption></figcaption></figure>

By following these steps, you will successfully connect the power supply to the SmVend Smart controller. If you encounter any issues, please get in touch with the SmVend support team at email **<support@smvend.io>** for further assistance.


# La Cimbali

### Disassembling La Cimbali S15

{% embed url="<https://drive.google.com/file/d/1YRPp8TDfLa1A6jmVVKRmPf9B7E2LCysI/view?usp=sharing>" %}

### Smart controller + La Cimbali S15

{% embed url="<https://drive.google.com/file/d/1quH19BrKIxQ2yDP53XVjMVnkELw8ApVR/view?usp=sharing>" %}


# Necta

In the Necta section, you will find guides on how to set up the following coffee machines:&#x20;

* [Koro Prime](/equipment-installation/coffee-machines/necta/koro-prime)
* [Brio Up Lavazza](/equipment-installation/coffee-machines/necta/brio-up-lavazza)
* [Canto Plus Model ES-8/IQ](/equipment-installation/coffee-machines/necta/canto-plus-model-es-8-iq)


# Koro Prime

### Disassembling Koro Prime

{% embed url="<https://drive.google.com/file/d/1N-pnuCky4r9gjWUO9RCHioJ3YH_2kBvq/view?usp=sharing>" %}

### Smart controller + Koro Prime

{% embed url="<https://drive.google.com/file/d/1gR0NBg7Gx5G3yNiqUbDamtXj8ATWaRkq/view?usp=sharing>" %}

### Placing controller in Koro Prime

<div align="center"><figure><img src="/files/dEPOYRHrE9QxcpcfZFBO" alt="" width="375"><figcaption></figcaption></figure></div>


# Brio Up Lavazza

To connect your Necta Brio Up Lavazza coffee machine to the SmVend controller via MDB interface, please follow these steps:

1. **Enter programming mode**\
   Press the `PROGRAMMING` button on the back side of the door to enter programming mode.
2. **Navigate menu**

   Use the `cancel` button to switch between the technician and manager menus.

   Use the `+/-` buttons to switch between menu items.

   Use the `ok` button to select a menu item.
3. **Configure coin mechanisms**

   `TECN -> COIN MECHANISMS -> COIN MECH SETT -> Coin Mech Type -> MDB`&#x20;

   `TECN -> COIN MECHANISMS -> COIN MECH SETT -> CASHLESS ALWAYS IDLE -> OK`&#x20;

   `TECN -> COIN MECHANISMS -> RESERVATION TIME -> 90`&#x20;
4. **Configure statistics**

   `TECN -> STATISTICS -> EVADTS -> EVADTS PROTOCOL -> DEXUCS`&#x20;

   `TECN -> STATISTICS -> EVADTS -> MODE -> ALWAYS EVADTS`&#x20;

   `TECN -> STATISTICS -> EVADTS -> SERIAL BAUDRATE -> 9600`&#x20;
5. **Exit programming mode**

   Press the `PROGRAMMING` button on the back side of the door to exit programming mode.&#x20;

| Programming button                                        | Navigation                                                |
| --------------------------------------------------------- | --------------------------------------------------------- |
| <p><br><img src="/files/J59qguspuQ8NaJlGB5vp" alt=""></p> | <p><br><img src="/files/ZTNw4ufH3a1R5IB20Tjf" alt=""></p> |


# Canto Plus Model ES-8/IQ

To connect your Necta Canto Plus Model ES-8/IQ coffee machine to the SmVend controller via MDB interface, please follow these steps:

1. **Preparation**\
   Ensure you have the MDB cable as shown below. Indicators in the picture show the exact connector and to which place it must be connected.

<figure><img src="/files/RmUlH7wr6QK6sAvtcbe5" alt=""><figcaption></figcaption></figure>

2. **Connect MDB cable** \
   Plug the MDB connector marked blue into the MDB port (J14 on the scheme below) on the coffee machine's mainboard.

<figure><img src="/files/7K37Pu02zJ83SQNsrpla" alt=""><figcaption></figcaption></figure>

3. **Connect coin acceptor**\
   Plug the connector marked green in the picture into the coin acceptor.
4. **Connect SmVend controller**\
   Plug the connector marked red into the suitable port on the SmVend controller.

{% hint style="info" %}
If you want to collect information about errors and events on the machine, plug the DB9 connector into the mainboard and leave the connector dedicated to the coin/bills unplugged.
{% endhint %}

Once these steps are completed, please do not forget to set up the [product matrix](https://help.smvend.io/machines/product-matrix).


# Rheavendors

In the Rheavendors section, you will find guides on how to set up the following coffee machines:&#x20;

* [eC](/equipment-installation/coffee-machines/rheavendors/ec)
* [XX-OC](/equipment-installation/coffee-machines/rheavendors/xx-oc)


# eC

To connect your Rheavendors eC coffee machine to the SmVend controller using the MDB interface, follow these steps:

1. **Enter programming mode**

   Press the button on the back side of the door and then press the `1` button to enter programming mode.
2. **Navigate menu**\
   Use buttons `1` and `6` to switch menu items.\
   Use buttons `2` and `3` to switch menu sub-items.\
   Use buttons `4` and `5` to set the parameter.
3. **Configure machine's settings**

   `PROGRAMMING -> ID. MACHINE -> DataAudit -> 01`

   `PROGRAMMING -> MISCELLANEOUS -> coin-mech type -> MDB`
4. **Set prices**

   Set all prices in the `PROGRAMMING -> PRICES` section to be different from zero.
5. **Exit programming mode**

   Switch the menu item again (for example, with the `1` button) and then press the button on the back side of the door to exit programming mode.&#x20;

| Programming button                                                  | Navigation                                                          |
| ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| <img src="/files/Jbgs8RT7bChBRyipViEO" alt="" data-size="original"> | <img src="/files/ubhXNVawOqgAjl816EXs" alt="" data-size="original"> |

### eC connection view&#x20;

| <img src="/files/4zXUW9uXCsNNIHAoa33F" alt="" data-size="original"> | <img src="/files/kjCiKDfhQLcZW3v62uLb" alt="" data-size="original"> |
| ------------------------------------------------------------------- | ------------------------------------------------------------------- |


# XX-OC

To connect your Rheavendors XX-OC coffee machine to the SmVend Smart controller, please follow these steps:

1. **Disconnect the Screen cable**

   Disconnect the Screen cable from the coffee machine.

<figure><img src="/files/Ks0yxtoRPhNfbCr9dAqD" alt="" width="563"><figcaption></figcaption></figure>

2. **Connect the IDC-20**\
   Place an additional IDC-20 connector on the screen cable with the key facing up.

<figure><img src="/files/m0ZtsgNuuWNHf1LJGY0t" alt="" width="563"><figcaption></figcaption></figure>

3. **Reconnect the Screen cable**\
   Connect the screen cable back to the coffee machine.

<figure><img src="/files/JF7v7fPEUxsIYn7Z6q1n" alt="" width="563"><figcaption></figcaption></figure>

4. **Connect the Display decoder board**\
   Connect the display decoder board to the additional IDC-20 connector.

<figure><img src="/files/6Y1r9zD60ax4qEQbMBgd" alt="" width="563"><figcaption></figcaption></figure>

5. **Connect the Converter**\
   Connect the converter to the 24V power supply (MDB).

<figure><img src="/files/bEn6lMMLxdmnR3xLGYtC" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/a9myaLugbaMeKXRAgoDW" alt="" width="563"><figcaption></figcaption></figure>

6. **Connect the SmVend controller**\
   Connect the SmVend controller to the display decoder board.

<figure><img src="/files/E2CzH4aIzcYvsaGGcIvJ" alt="" width="563"><figcaption></figcaption></figure>


# Schaerer

In the Schaerer section, you will find guides on how to set up the following coffee machines:&#x20;

* [Barista One](/equipment-installation/coffee-machines/schaerer/barista-one)
* [Coffee Factory / Tchibo Coffea Touch](/equipment-installation/coffee-machines/schaerer/coffee-factory-tchibo-coffea-touch)
* [Coffee Soul](/equipment-installation/coffee-machines/schaerer/coffee-soul)


# Barista One

To use your Barista One coffee machine with the SmVend controller, please connect cables as shown in the picture below.

<figure><img src="/files/M7pGEUg1yl5WGVmD7GSG" alt="" width="375"><figcaption></figcaption></figure>


# Coffee Factory / Tchibo Coffea Touch

### Disassembling Coffee Factory

{% embed url="<https://drive.google.com/file/d/1D9DP8ysn4hLF82l70m9-8HbxKWwV53wR/view?usp=sharing>" %}

### Smart controller + Schaerer Coffee Factory / WMF Presto / WMF 2000S / Tchibo Coffea Touch

{% embed url="<https://drive.google.com/file/d/1upI0EM2De2e6MNFcmOWklfX3lw-5sNZU/view?usp=sharing>" %}


# Coffee Soul

The connection of the SmVend Smart controller to the Schaerer Coffee Soul coffee machine is shown below.

| <img src="/files/SChMyxxeasflu04PL8nP" alt="" data-size="original"> | <img src="/files/NUBLfUiZgBtC5hNICB2h" alt="" data-size="original"> |
| ------------------------------------------------------------------- | ------------------------------------------------------------------- |


# WMF

### Smart controller + 1500S/5000S

{% embed url="<https://drive.google.com/file/d/16CLmZWPR6BhE-YaoKX1NEB1kr6fP6D91/view?usp=sharing>" %}

#### Step-by-Step guide

1. Connect the original telemetry cable from WMF to the socket on the right side of the machine according to the scheme.

<figure><img src="/files/yPOkh58RuBKVTWDGdPTw" alt="" width="563"><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="351"></th><th></th></tr></thead><tbody><tr><td><img src="/files/9mmAWwU1pO8VKTL7gcxm" alt="" data-size="original"></td><td><img src="/files/UH9aS08xfSqzofAXUyaO" alt="" data-size="original"></td></tr></tbody></table>

2. Connect WMF and SmVend cables as shown in the picture below.

<figure><img src="/files/bEo9V0OWookTJEtxRljC" alt="" width="375"><figcaption></figcaption></figure>

3. The second plug from the SmVend cable connects to the socket on the right side of the coffee machine.

<figure><img src="/files/0ADWoMdaIQWZXy011xBY" alt="" width="375"><figcaption></figcaption></figure>

4. Connect the black flat plug of the SmVend cable to the corresponding socket on the controller.

<figure><img src="/files/azjs3tx4Z1PHrjC6dGmz" alt=""><figcaption></figcaption></figure>

### How to connect the Smart controller to the WMF 2000s or WMF Presto?&#x20;

To connect your WMF 2000S or Presto coffee machine, please refer to the instructions in the Schaerer section under[ the Coffee Factory](/equipment-installation/coffee-machines/schaerer/coffee-factory-tchibo-coffea-touch) guidelines. These models have the same way of connection. <br>


# PULSE machines

### To start with

1. Register [the SmVend personal account](https://app.smvend.io/) and add your SmVend telemetry controllers.
2. Read the user manual for your [SmVend telemetry controller](/equipment-installation/controllers) model.

### Connect your equipment

Connect your SmVend equipment to the pulse machines according to one of the schemes below:

{% tabs %}
{% tab title="Without controller" %}

<figure><img src="/files/x5yyNVeUFbMXbu7XYUoH" alt=""><figcaption><p>Connecting pulse machines without the telemetry controller</p></figcaption></figure>

<figure><img src="/files/IpPJD3iEUDiAHGabexOG" alt=""><figcaption><p>Connecting massage chairs without the telemetry controller</p></figcaption></figure>
{% endtab %}

{% tab title="Smart controller" %}

<figure><img src="/files/w7kWtYZvcDrfgHQRGPZI" alt=""><figcaption><p>Connecting pulse machines to the Smart telemetry controller</p></figcaption></figure>

<figure><img src="/files/81i2FxV48pkVf3SjaRkz" alt=""><figcaption><p>Connecting massage chairs to the Smart telemetry controller</p></figcaption></figure>

**INPUTS and OUTPUTS:**

1. **+12V** — Connect the +12V power supply wire from the machine board.
2. **+12V** — Connect +12V power supply wires from the coin and bill acceptors. This configuration allows you to turn off the power on acceptors via your SmVend personal account remotely.
3. Not used (configured only in custom cases).
4. Not used (configured only in custom cases).
5. **PULSE IN1** — Connect the PULSE (signal) wire from the bill acceptor to enable the controller to receive a pulse when a bill is deposited.
6. **PULSE IN2** — Connect the PULSE (signal) wire from the coin acceptor to enable the controller to receive a pulse when a coin is deposited.
7. Not used (configured only in custom cases).
8. **PULSE OUT** — Connect the PULSE wire from the machine board to enable the machine to receive a pulse from the controller when the game price is reached.
9. Not used (configured only in custom cases).
10. **GND** — Connect the ground wires from the coin acceptor, bill acceptor, and machine board to enable contact closure between the pulse and ground, creating an input pulse to the controller and an output pulse to the machine.
    {% endtab %}

{% tab title="Mini controller" %}

<figure><img src="/files/ucykscCcH1qTJuSgDyln" alt=""><figcaption><p>Connecting pulse machines to the Mini telemetry controller with the pulse adapter</p></figcaption></figure>

**INPUTS and OUTPUTS:**

1. **GND** — Connect the ground wire from the coin acceptor to enable contact closure between the pulse and ground, creating an input pulse to the controller.
2. Not used (configured only in custom cases).
3. **PULSE OUT1** — Connect the PULSE wire from the machine board to enable the machine to receive a pulse from the controller when the game price is reached.
4. **PULSE IN1** — Connect the PULSE (signal) wire from the bill acceptor to enable the controller to receive a pulse when a bill is deposited.
5. **PULSE IN2** — Connect the PULSE (signal) wire from the coin acceptor to enable the controller to receive a pulse when a coin is deposited.
6. Not used (configured only in custom cases).
7. Not used (configured only in custom cases).
8. **GND** — Connect the ground wire from the bill acceptor to enable contact closure between the pulse and ground, creating an input pulse to the controller.
9. **GND** — Connect the ground wire from the machine board to enable contact closure between the pulse and ground, creating an output pulse to the machine.
10. **+12V** — Connect the power wire from the machine's board to supply voltage to the controller. Then connect +12V power supply wires from the coin and bill acceptors. This configuration allows you to turn off the power on acceptors via your SmVend personal account remotely.
    {% endtab %}
    {% endtabs %}

## Connecting GSM <a href="#heading-h.lxfoi6zdpz0x" id="heading-h.lxfoi6zdpz0x"></a>

After connecting the telemetry controller to the vending machine, it is necessary to connect a GSM antenna to amplify the GSM signal:

1. Install a SIM card in the designated slot.
2. Ensure that the SIM card is activated and has a working internet connection.&#x20;

{% hint style="info" %}
**Alternatively**, SmVend telemetry controllers can be connected to the internet via WiFi. The Smart controller also supports internet connection via an Ethernet cable.&#x20;
{% endhint %}

## Configuration of the SmVend controller <a href="#heading-h.w10t1eeojlu9" id="heading-h.w10t1eeojlu9"></a>

Next, configure the telemetry controller through your [SmVend personal account](https://app.smvend.io/).

1. Go to the `Machines` section.

<figure><img src="/files/TKdcjJs027E5buDCTBhj" alt=""><figcaption></figcaption></figure>

2. Go to the page of a specific vending machine.

{% hint style="warning" %}
**Please ensure that the controller is online**. If the controller is offline, check the internet connectivity on the SIM card / WiFi / Ethernet cable. If the controller remains offline, the settings will not be transmitted to the controller.
{% endhint %}

<figure><img src="/files/TN0cDNSrMVPwdM3M2B4D" alt=""><figcaption></figcaption></figure>

3. Go to the `Configuration` tab.

<figure><img src="/files/qnHFtgdTiKbFO9zjWrF9" alt=""><figcaption></figcaption></figure>

4. Configure the settings of the controller and click the `Save` button. Settings that must be configured:

* `Price`\
  The price of a single launch by the OUT 1 link. \
  ❗️Default setting = €1
* `Input pulse price for input 1 (bills)` \
  The price of one input pulse from a bill acceptor to the SmVend controller. \
  ❗️Default setting = €1
* `Input pulse price for input 2 (coins)` \
  The price of one input pulse from a coin acceptor to the SmVend controller. \
  ❗Default setting = €0.1
* `Multiplier for output 1` \
  The number of pulses transmitted from the SmVend controller to the machine board if the machine requires more than one pulse to start (OUT 1 link).\
  ❗️Default setting = 1
* `Output pulse duration (active time), ms` \
  The pulse duration is transmitted from the SmVend controller to the machine board. Most machines operate at a pulse duration of 100 ms (milliseconds).\
  ❗️Default setting = 100
* `Output pulse pause (inactive time), ms` \
  The time between two consecutive pulses transmitted from the SmVend controller to the machine board. Most machines operate with a pulse pause duration of 100 ms (milliseconds).\
  ❗️Default setting = 100

5. After configuring settings, you need to ensure that settings are applied. To do this, go to the `History` tab and check the task's status. If the `Completed` column contains:\
   ![](/files/D8Cd4BnLte4oeQ8jCweW)— settings are applied  ![](/files/Y2xW4t3dePbPejIMA9OY) — settings have not been applied yet.

<figure><img src="/files/mW10c6y621OswbOBqC6A" alt=""><figcaption></figcaption></figure>


# POS terminals

This section is designed to help you set up your Point of Sale (POS) terminals efficiently and effectively, ensuring a seamless transaction experience for your customers.

POS terminals are crucial for modern businesses, enabling quick and secure payment processing. Whether you are installing a new POS terminal in a retail store, restaurant, or any other business environment, our comprehensive instructions will guide you through the entire process.

In this section, you will find guides on the following terminals:

{% tabs %}
{% tab title="myPOS" %}

* [Go2](/equipment-installation/pos-terminals/mypos/go2)
* [Sigma](/equipment-installation/pos-terminals/mypos/sigma)
* [Mini](/equipment-installation/pos-terminals/mypos/mini)
  {% endtab %}

{% tab title="Worldline" %}
[Self](/equipment-installation/pos-terminals/worldline) (all models)
{% endtab %}
{% endtabs %}


# myPOS

This section is designed to help you set up your myPOS terminals efficiently and effectively, ensuring a seamless transaction experience for your customers. Choose yours and dive into the step-by-step guide!

* [Go2](/equipment-installation/pos-terminals/mypos/go2)
* [Sigma](/equipment-installation/pos-terminals/mypos/sigma)
* [Mini](/equipment-installation/pos-terminals/mypos/mini)


# Go2

This guide provides a comprehensive step-by-step process to set up the myPOS Go 2 with the SmVend Controller. Whether you are a seasoned vending machine operator or new to the industry, this guide will help you seamlessly integrate these technologies, ensuring your vending machine is equipped to handle a variety of payment methods.

### Step-by-step

1. **Registration**\
   Register for the myPOS service by visiting [myPOS Enrollment](https://www.mypos.com/en/enroll).

2. **Add the terminal**\
   Add the terminal to your myPOS account using the serial number printed on the back of the terminal.

3. **Update firmware** \
   Contact myPOS support and request an update for your terminal to operate with a vending machine. You will receive a notification from myPOS support once the new firmware is ready.

4. **Connect to SmVend controller**\
   Connect the myPOS terminal to the SmVend telemetry controller using a special сonnector depending on the model of the controller:&#x20;

{% tabs %}
{% tab title="Smart controller" %}
\
Connect the POS terminal to the **6p6c** connector.

<figure><img src="/files/299bhTCwfzN2FU1nFrrA" alt="" width="375"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Smart controller + USB-RS232 adapter " %}

1. Please make sure that you have all the necessary equipment.

<figure><img src="/files/BAaS4ik16Vx3aX9pMSnt" alt=""><figcaption></figcaption></figure>

2. Connect the equipment as shown in the video.

{% embed url="<https://drive.google.com/file/d/1l_4NhoCGWg01f03PThtZK50j-l6aj3YJ/view?usp=sharing>" %}

3. The final connection must look like the one shown in the picture below.

<figure><img src="/files/HwNX7YAIDWM7FtYija74" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Mini controller" %}
\
Connect the **USB type-C** connector to your myPOS Go2 terminal and the **USB** connector to the controller.

<figure><img src="/files/fC2R2tcCbjru0y4LcNxT" alt="" width="375"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

5. **Power up**\
   Apply power to the controller and press the `Power` button on the POS terminal.<br>
6. **Configuration of the terminal**

{% embed url="<https://drive.google.com/file/d/1I7Th7Fuv0AX07amB_yYKOIGqSQ00G9EE/view?usp=sharing>" %}

* Go to the `Settings` menu by pressing F2.
* Select the `Update Software` option. After the update is confirmed, the POS will reboot.
* After the reboot, go to the `Settings` menu again.
* Select the `Change Profile` option and choose the `Cash Register` profile. The POS will reboot again.
* After the reboot, the `Connection type` menu will appear. Choose the `USB cable` option.
* Select the `myPOS DATA card` option. The message `Network Registration` will appear, and after a few seconds, the terminal will connect to the Internet.

7. **Connecting GSM** \
   After connecting the telemetry controller to the vending machine, it is necessary to connect a GSM antenna to amplify the GSM signal. Install a SIM card in the designated slot and ensure that the SIM card is activated and has a working internet connection. <br>
8. **Configuration of the SmVend controller**&#x20;

   Next, configure the telemetry controller through your [SmVend personal account](https://app.smvend.io/). Go to the page of a specific vending machine, and then go to the `Configuration` tab on the machine page.

{% hint style="info" %}
**Important!** Ensure that the controller is online. A green indicator next to the machine name means the controller is online, while a red indicator means it is offline. If the controller is offline, check the internet connectivity of the SIM card. If the controller remains offline, the settings will not be transmitted.
{% endhint %}

<figure><img src="/files/qVkKebm8i2Sb5tufNuOt" alt=""><figcaption></figcaption></figure>

Settings that need to be configured on the `Configuration` tab:

* Select the `myPOS` option in the `POS terminal type` section.
* Turn on the toggle for `Pre-authorization` if needed.
* Choose the currency of your country in the `POS Currency` section.
* After everything is submitted correctly, don't forget to click the `Save` button at the bottom of the page.

<figure><img src="/files/qfA9agRfhqlJAILXHBl7" alt=""><figcaption></figcaption></figure>

That's it. If you have any questions, don't hesitate to contact the SmVend support team at **<support@smvend.io>** or WhatsApp: **+371 28 701 129.**&#x20;

### Bracket template

If you need to drill holes in the bracket for mounting, please print the template below.

{% file src="/files/pLs8BwZST4AOriXlnmYP" %}


# Initiate payment mode

If you're using your Go2 myPOS terminal with the pulse SmVend controller, you must enable the `Initiate payment` mode on the terminal. Please follow these steps:

{% tabs %}
{% tab title="Step 1" %}
Connect the power cable to the terminal. The terminal will start charging.

<figure><img src="/files/svnbrdzb6t5dzzZJRE1e" alt="" width="188"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 2" %}
Hold the power button. Release the button after the sound signal. The terminal will power on.

<figure><img src="/files/JJnW1wwj5874KHeLruiI" alt="" width="188"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 3" %}
Once the terminal has powered up, the white screen with the message "myPOS helps my business grow" will appear. Press the `F2` button to open the `Settings Menu 1`.

<figure><img src="/files/IQm5cYdeDAEIB0ainM0G" alt="" width="375"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 4" %}
Press `6` (`Transactions config`) → Press `4` (`Initiate payment`) → Press `1` (`ON`).

<figure><img src="/files/KQWwkeymMt7oejugZuHk" alt="" width="563"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 5" %}
After these settings, the phrase "To pay press any key" will appear on the main screen.

<figure><img src="/files/FG2qrfsDgfAg1Ea5nLWR" alt="" width="188"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

That's it! To initiate the payment, a user can tap almost any button (except the power and cancel buttons). If you have any questions, contact our Support team at **<support@smvend.io>** or WhatsApp at **+371 28 701 129.**


# Sigma

This guide provides a comprehensive step-by-step process to set up the myPOS Sigma with the SmVend Controller. Whether you are a seasoned vending machine operator or new to the industry, this guide will help you seamlessly integrate these technologies, ensuring your vending machine is equipped to handle a variety of payment methods.

### Step-by-step

1. **Registration**\
   Register for the myPOS service by visiting [myPOS Enrollment](https://www.mypos.com/en/enroll).

2. **Add the terminal**\
   Add the terminal to your myPOS account using the serial number printed on the back of the terminal.

<figure><img src="/files/5wICgQsamjH0qHN71Ytq" alt="" width="375"><figcaption></figcaption></figure>

3. **Gather Necessary Equipment**\
   Ensure you have the following equipment:

   * SmVend telemetry controller
   * SmVend - myPOS cable
   * myPOS Sigma POS terminal

4. **Connect the Cable**&#x20;
   * Connect the SmVend - myPOS cable to the corresponding connectors on the POS terminal.
   * Connect the other end of the cable to the POS port on the SmVend controller.

<table data-header-hidden><thead><tr><th width="244">POS</th><th>Smart Connector</th><th>Coffee Mini</th></tr></thead><tbody><tr><td><img src="/files/bsYGNGdN03nYTpK2vOG2" alt="" data-size="original">     </td><td><img src="/files/vl9S4YqJ2p0kTyNo552A" alt="" data-size="original"></td><td><img src="/files/TTVRPfEC2yx1IpPIxVtw" alt="" data-size="original"></td></tr></tbody></table>

5. **Power Up**\
   Apply power to the SmVend controller. The myPOS Sigma terminal will start automatically.<br>
6. **Configure settings** \
   Enter the settings menu by pressing the `volume +` button twice, followed by the `volume -` button twice, located on the back of the terminal.

   When accessing the terminal settings for the first time, you will be prompted to set a password for future access.<br>
7. **Pairing**\
   By default, access to the status and navigation bars is limited. Change this by doing the following:&#x20;
   1. Pair the myPOS Sigma with a vending machine.
   2. Enter the `Settings menu` of the device.
   3. Choose `Pair device`
   4. Choose `RS-232A` port.
8. **Final setup with SmVend support**\
   Contact the SmVend support team for the final controller setup. In your request, indicate the currency you chose when activating the terminal. Technical support’s WhatsApp: **+371 28 701 129**


# Mini

Whether you are a seasoned vending machine operator or new to the industry, this guide will help you seamlessly integrate the myPOS Mini terminal, ensuring your vending machine is equipped to handle payments.

### Step-by-step

1. **Registration**\
   Register for the myPOS service by visiting [myPOS Enrollment](https://www.mypos.com/en/enroll).

2. **Add the terminal**\
   Add the terminal to your myPOS account using the serial number printed on the back of the terminal.

<figure><img src="/files/UYjg20xPgSy7uuCqkbXx" alt="" width="188"><figcaption></figcaption></figure>

3. **Power up**\
   Turn on the terminal by holding the right button on the top of the terminal.

<figure><img src="/files/mul2hkofAYOGPRVob7t7" alt="" width="375"><figcaption></figcaption></figure>

4. **Configure the terminal**

{% embed url="<https://drive.google.com/file/d/1BctaBJO__fsR41m2YraOYecac79yKyh4/view?usp=sharing>" %}

{% tabs %}
{% tab title="Step 1" %}
Go to the `Settings menu 1` by pressing `F2`

<figure><img src="/files/WYpWOvp1T1lvC2LXH3fy" alt="" width="188"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 2" %}
Go to the `Settings menu 2` by pressing `F2` again

<figure><img src="/files/FE7NjjoTQZ745uY91pE9" alt="" width="188"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 3" %}
Go to the `Change profile` by pressing `6`&#x20;

<figure><img src="/files/uCmMPoiSg7l6RsMzlbT7" alt="" width="188"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 4" %}
Select `Cash register` by pressing `2` ; the terminal will be rebooted

<figure><img src="/files/8RO93pDAU1norhy5sx4s" alt="" width="188"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 5" %}
After the terminal is rebooted, select `RS-232` by pressing `3` in the `Connection type` menu

<figure><img src="/files/fLEaw1PGbEJVqAMf6bCL" alt="" width="188"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 6" %}
Select `SIM card` by pressing `3` in the `Financial host connectivity` menu.&#x20;

<figure><img src="/files/Gwxo6F0FbYWspb11qxtw" alt="" width="188"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 7" %}
Select `115200` by pressing `2` in the `Financial host connectivity` menu.&#x20;

<figure><img src="/files/td23FyAsz2mm7Ec9KFN1" alt="" width="188"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

5. **Gather necessary equipment**\
   All necessary equipment is listed below:&#x20;
   1. myPOS card (or another bank card)
   2. SmVend telemetry controller
   3. myPOS mini protective cover
   4. myPOS mini POS terminal
   5. myPOS micro USB power cable
   6. SmVend - myPOS DB9 cable
   7. &#x20;myPOS mini USB-RS232 cable

<figure><img src="/files/dua9sNIHTdKcpyXJbzFp" alt=""><figcaption></figcaption></figure>

6. **Connect to SmVend controller**

* Connect the micro USB power cable and the RS232 mini USB cable to the corresponding POS-terminal connectors. Connect the other end of the power cable to the USB port on the controller, or an external power source.&#x20;
* Put the POS terminal into a protective cover.

| <img src="/files/tPK8gvrem1o7Gc2vHsM5" alt="" data-size="original"> | <img src="/files/O47371iVyqXzC4l5HCBs" alt="" data-size="original"> |
| ------------------------------------------------------------------- | ------------------------------------------------------------------- |

* Connect myPOS mini USB RS232 cable to SmVend - myPOS DB9 cable.

<figure><img src="/files/jjBvg06G7HQS8P6RN7L2" alt="" width="563"><figcaption></figcaption></figure>

* Connect the second end of the SmVend - myPOS DB9 cable to the corresponding connector on the SmVend telemetry controller.

<figure><img src="/files/3KZpewWQoix8AZmi3jOw" alt="" width="375"><figcaption></figcaption></figure>

7. **Final setup with SmVend support**\
   Contact the SmVend support team for the final controller setup. In your request, indicate the currency you chose when activating the terminal. Technical support’s WhatsApp: **+371 28 701 129**


# Worldline

This section is designed to help you set up your Worldline Self terminal efficiently and effectively, ensuring a seamless transaction experience for your customers. To start with, go to the [Self Instruction](/equipment-installation/pos-terminals/worldline/self) page.&#x20;


# Self

This guide provides a comprehensive step-by-step process to set up the Worldline Self with the SmVend Controller. &#x20;

1. **Registration**\
   To register in the Worldline system, please reach out to Mr. David Mainka at [**david.mainka@worldline.com**](mailto:david.mainka@worldline.com)<br>
2. **Get a TID** \
   Once you complete the registration and answer all questions, you will receive a TID number from the bank.<br>
3. **Activate the terminal** \
   The terminal can be activated by using the [manual](/equipment-installation/pos-terminals/worldline/self-manual).[<br>](https://docs.google.com/document/d/1RHUiiI46ceedifJ2dizRrIU32RDlpKuK/edit?usp=drive_link\&ouid=114314316752757522079\&rtpof=true\&sd=true)
4. **Software update**\
   Once this part is completed, you will need to access the `Service mode` again and navigate to `Setup`, then to `SW Update`. For accessing `SW Update`, you will need a password that you should get from Worldline (you will need a dedicated password for each terminal).

{% hint style="info" %}
You might not be able to set up everything correctly on the first attempt and may need to reset the terminal via the `Setup menu` (`Trm reset`). Once that’s done, you will need to retry configuring it from the beginning.
{% endhint %}

5. **Configuration in the SmVend personal account**\
   In your SmVend account, go to the specific machine page, then to the `Configuration` tab and select the POS terminal type `MDB`, then click `Save`. To apply the changes, the controller must be online. After the command is delivered to the controller, the controller must be restarted.

<figure><img src="/files/2KVpueEE6qXDXd7vymgZ" alt=""><figcaption></figcaption></figure>

### Additional information

* Terminal can use MDB ONLY over the Ethernet connection. Even if you purchase a 4G modem for this terminal it will not be able to work via it. Due to this limitation, please be aware that you will need to purchase a router.
* To make this terminal work over MDB, you will require a special MDB module.
* If the terminal’s firmware is set by the bank to use EURO and if you set the currency to, for example, Czech Krones, the display will show CZK but all transactions will be done in EUR.
* If the terminal is registered in one country and activated for another country, all operations done on it will be declined.


# Self Manual

Before you can get started, the individual modules must be correctly and securely mounted. Then the commissioning process described below must also be carried out before configuration.

### **Commissioning your terminal**

{% tabs %}
{% tab title="Step 1" %}

<figure><img src="/files/pLsCwa7JIDFKDPW3bHFa" alt=""><figcaption></figcaption></figure>

Press the `Maintenance button` immediately when it turns white and keep pressed until it is blinking red. Release the LED button when it blinks red.

**Note:** The white light is only available directly after connecting it to power for approx. 2 seconds. After that moment you are no longer able to get into the maintenance mode unless power is dis- and reconnected again.
{% endtab %}

{% tab title="Step 2" %}

<figure><img src="/files/Uj0iA9RaOCyngnrfd1k8" alt="" width="354"><figcaption></figcaption></figure>

The terminal reboots and the menu will open, then press `1`
{% endtab %}

{% tab title="Step 3" %}

<figure><img src="/files/UgzzpyeVl6m1h6OvPAUm" alt=""><figcaption></figcaption></figure>

Press `2`
{% endtab %}

{% tab title="Step 4" %}

<figure><img src="/files/P0sRMYU8PLBUJ7uI0z6j" alt="" width="354"><figcaption></figcaption></figure>

You need to select the **MDB** option, not the TIM option. Press `2`
{% endtab %}

{% tab title="Step 4.1" %}

<figure><img src="/files/ClzbEqUBOZC4n6fzuZHv" alt="" width="354"><figcaption></figcaption></figure>

**MDB configuration**&#x20;

To setup the terminal for vending machine using a MDB protocol, you will need to do additional configuration steps.

Choose the requested cashless address and confirm with `OK`
{% endtab %}

{% tab title="Step 4.2" %}

<figure><img src="/files/ktCPVUAsLeI7RpcL5joD" alt="" width="354"><figcaption></figcaption></figure>

Choose the timeout of MDB delivery and confirm with `OK`
{% endtab %}
{% endtabs %}

Then you can come back to the main flow.

{% tabs %}
{% tab title="Step 5" %}

<figure><img src="/files/zoK6T62obLMFd8eFZnVF" alt="" width="354"><figcaption></figcaption></figure>

Press `2`
{% endtab %}

{% tab title="Step 6" %}

<figure><img src="/files/sEYeZCOTW5QPdnl8YLs3" alt="" width="354"><figcaption></figcaption></figure>

Press `1`
{% endtab %}

{% tab title="Step 7" %}

<figure><img src="/files/Qfq7fdtdB8LmlsOYNPtU" alt="" width="354"><figcaption></figcaption></figure>

MAC address will be displayed. Press `OK`
{% endtab %}

{% tab title="Step 8" %}

<figure><img src="/files/7AveoMHwcwtkCFdCzzwG" alt="" width="354"><figcaption></figcaption></figure>

Press `1` for DHCP
{% endtab %}

{% tab title="Step 9" %}

<figure><img src="/files/YeNivAgg4an1kwZysJ1l" alt="" width="354"><figcaption></figcaption></figure>

Press `1`
{% endtab %}

{% tab title="Step 10" %}

<figure><img src="/files/OPBeJ1Z9DzJzSJjP7t5b" alt="" width="354"><figcaption></figcaption></figure>

Press `OK`
{% endtab %}

{% tab title="Step 11" %}

<figure><img src="/files/MHXRb0b398jDm4UPEb8n" alt="" width="354"><figcaption></figcaption></figure>

Enter the terminal-ID and confirm with `OK`
{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Step 12" %}

<figure><img src="/files/VDzdGzyB9iihaSoilVno" alt="" width="354"><figcaption></figcaption></figure>

Software is downloaded in this step. The terminal reboots to install it.
{% endtab %}

{% tab title="Step 13" %}

<figure><img src="/files/biF5K8uY4ysnopJBZ27j" alt="" width="354"><figcaption></figcaption></figure>

Wait..
{% endtab %}

{% tab title="Step 14" %}

<figure><img src="/files/xiD3hFwgYeB4y0vpHa5h" alt="" width="354"><figcaption></figcaption></figure>

Wait..
{% endtab %}

{% tab title="Step 15" %}

<figure><img src="/files/Dh7caiP3yZUUfwytqKYy" alt="" width="354"><figcaption></figcaption></figure>

Wait..
{% endtab %}

{% tab title="Step 16" %}

<figure><img src="/files/tiFZltpQ3P7wgNmYJlUj" alt="" width="354"><figcaption></figcaption></figure>

Wait..
{% endtab %}

{% tab title="Step 17" %}

<figure><img src="/files/DCfNkXtutmrS7EP6tjZc" alt="" width="354"><figcaption></figcaption></figure>

Wait for reboot.
{% endtab %}

{% tab title="Step 18" %}

<figure><img src="/files/K0OSPleSnl8jCjnmdC38" alt="" width="354"><figcaption></figcaption></figure>

Ready to use.
{% endtab %}
{% endtabs %}

### Static IP Configuration&#x20;

It may be required to setup static IP on your terminal. Here are the alternative steps to take at step 8 of the main flow.

{% tabs %}
{% tab title="Step 8.1" %}

<figure><img src="/files/MMoOeStlMjmvfNg444Gf" alt="" width="354"><figcaption></figcaption></figure>

Press `2`
{% endtab %}

{% tab title="Step 8.2" %}

<figure><img src="/files/6GRWGW1RLTR70YOgZMzw" alt="" width="354"><figcaption></figcaption></figure>

Press `CORR` to remove the currently entered IP-address and enter your own IP-address.\
Validate with `OK`
{% endtab %}

{% tab title="Step 8.3" %}

<figure><img src="/files/ipqC2nndp4KlIIjYxjmV" alt="" width="354"><figcaption></figcaption></figure>

Press `CORR` to remove the currently entered Mask and use the `0-9` keys to enter your own.\
Validate with `OK`
{% endtab %}

{% tab title="Step 8.4" %}

<figure><img src="/files/3zsUertuiESANze059MG" alt="" width="354"><figcaption></figcaption></figure>

Press `CORR` to remove the currently entered IP-address and use the `0-9` keys to enter your own. \
Validate with `OK`
{% endtab %}

{% tab title="Step 8.5" %}

<figure><img src="/files/RE5y7q7X2uTFAVma15KL" alt="" width="354"><figcaption></figcaption></figure>

Press `CORR` to remove the currently entered IP-address and use the `0-9` keys to enter your own. \
Validate with `OK`
{% endtab %}

{% tab title="Step 8.6" %}

<figure><img src="/files/8SDEtm5vDcSSPLxnzMsd" alt="" width="354"><figcaption></figcaption></figure>

Press `CORR` to remove the currently entered IP-address and use the `0-9` keys to enter your own. \
Validate with `OK`
{% endtab %}

{% tab title="Step 8.7" %}

<figure><img src="/files/MhP8160cuRDAfMV19YL5" alt="" width="354"><figcaption></figcaption></figure>

Wait for reboot and restart at Step 1.
{% endtab %}
{% endtabs %}


# Bill & Coin acceptors

Below is the scheme of the universal connection of a bill and coin acceptor.

<figure><img src="/files/DMIuqcqc88mc9cuNYhWw" alt=""><figcaption></figcaption></figure>


# EXE PH coin acceptor

Below are the cables you will need to proceed with the installation and the connection scheme.

<figure><img src="/files/d4sRqSMnox0mqPV60Woq" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/ehdprVwvHh5B04fyMHJd" alt=""><figcaption></figcaption></figure>

To connect the EXE PH (Executive Price Holding) coin acceptor to the SmVend controller, please do the following steps:&#x20;

1. **Connect the Coin acceptor cable** \
   Connect the Coin acceptor cable (MFD 3x3M) to the coin acceptor for data exchange.
2. **Connect the Machine cable** \
   Connect the Machine cable (MFD 3x3F) to your machine for data exchange.

<figure><img src="/files/3bKYY1YD2K3m1Um2jaqV" alt="" width="375"><figcaption></figcaption></figure>

3. **Connect the Power supply +24V cable**\
   Connect the Power supply +24V (MFD 2x3F) cable to your machine to power up the controller.

<figure><img src="/files/00nJUkIgn8M86s0t5VI8" alt="" width="375"><figcaption></figcaption></figure>

4. **Power up the coin acceptor** \
   Power up your coin acceptor using the machine's Coin acceptor power supply cable.

<figure><img src="/files/M7HletXm0hHfmgCMdSWV" alt="" width="375"><figcaption></figcaption></figure>

5. **Configure your machine**\
   Configure your machine to work using the EXE PH (price holding) protocol.
6. **Set the SmVend account product matrix**\
   Set the same product prices in the SmVend account [product matrix](/personal-account/machines/product-matrix) as on the coin acceptor.
7. **Contact the SmVend team** \
   Contact the SmVend support team for the final controller setup. Technical support’s WhatsApp: **+371 28 701 129**


# ccTalk bill/coin acceptor

Below you can find the guide on how to connect the ccTalk bill/coin acceptor with the SmVend Smart Connector controller.

1. **Connect the SmVend cable to a bill and coin acceptor**\
   Connect the SmVend cable to the corresponding slots on the bill acceptor and coin acceptor.

<table data-header-hidden><thead><tr><th width="263"></th><th width="249"></th><th></th></tr></thead><tbody><tr><td><img src="/files/NhNpkRZWPjkXfG1UN6p1" alt="" data-size="original"></td><td><img src="/files/Dx6Na1tBriZulOYZbdG8" alt="" data-size="original"></td><td><img src="/files/9zT0N8mCUIxFqOanCelu" alt="" data-size="original"></td></tr></tbody></table>

2. **Connect the SmVend cable to the Micro-Fit connector** \
   Connect the other end of the SmVend cable to the Micro-Fit connector on the controller.

<figure><img src="/files/7uOCtOgwl3TDHK6WDdvq" alt="" width="375"><figcaption></figcaption></figure>

3. **Connect red wires**\
   Connect both red wires to the “EN OUT” terminal on the controller.

<figure><img src="/files/Aqkt45UdYPoGqJ8bObp5" alt="" width="375"><figcaption></figcaption></figure>

4. **Contact the SmVend team**\
   Contact the SmVend support team for the final controller setup. Technical support’s WhatsApp: +371 28 701 129


# Azkoyen U II hopper

Below you can find the guide on how to connect the Azkoyen U-II hopper with the SmVend Smart Connector controller.

### Step-by-step guide

1. **Switch the hopper to the STANDARD PULSE mode**\
   To switch the Azkoyen U-II hopper to pulse mode, you need to install a jumper at the underside of the hopper as shown in the illustration in accordance with the instructions indicated on the machine.&#x20;

| <img src="/files/UIaKdYeq6nw7dzFAidfv" alt="" data-size="original"> | <img src="/files/WbZ9nsxRDYScG9X58Cix" alt="" data-size="original"> |
| ------------------------------------------------------------------- | ------------------------------------------------------------------- |

2. **Connect the power supply cable and pulse output to the hopper** \
   Contacts 1, 2, 3 are combined into one — this is +12V.\
   Contacts 4, 5, 6 are combined into one — this is GND.\
   Contact 7 (“Control”) is used to transmit the pulse and deliver the change from the hopper.\
   The other contacts are not used.

| <p><br><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnrXt79Zqh1vochrJxgjb%2Fuploads%2F5tkfBlZEQ2B1OEKnt7xR%2Fimage.png?alt=media&#x26;token=fedfdd70-5e4b-4d2f-b272-00255a22f180" alt=""><br></p> | <img src="/files/yg77Fl5aWodjxc1lLNz2" alt="" data-size="original"> |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |

3. **Connect everything to the SmVend telemetry controller**\
   Connect the coin acceptor, hopper, output motor, and output sensor to the SmVend telemetry controller and an external +12V power supply according to the following scheme.

<figure><img src="/files/AYhH2EOXF2WK6qH1F8u1" alt=""><figcaption></figcaption></figure>

* **Coin acceptor**\
  The +12V power supply wire from the coin acceptor is connected to the ENABLE terminal.\
  The PULSE wire from the coin acceptor (signal wire) is connected to the COIN terminal.\
  The GND wire from the coin acceptor is connected to the GND terminal.
* **Output motor**\
  The +12V power supply wire from the output motor is connected to the +12V terminal.\
  The GND wire from the output motor is connected to the OUTPUT1 terminal.
* **Output sensor**\
  The +12V power supply wire from the output sensor is connected to the +12V terminal.\
  The GND wire from the output sensor is connected to the CARD terminal.

{% hint style="warning" %}
**Attention!** The output sensor must be closed (short-circuit the input to the ground) at the time of the product's passage.
{% endhint %}

* **Hopper**\
  The +12V power supply wire from the hopper is connected to the +12V terminal.\
  The PULSE wire from the hopper (signal wire) is connected to the OUTPUT2 terminal.\
  The GND wire from the hopper is connected to the GND terminal.
* **External power supply +12V**\
  The +12V power supply wire from the external power supply is connected to the +12V terminal.\
  The GND wire from the external power supply is connected to the GND terminal.

4. **GSM antenna** \
   After connecting the telemetry controller to the machine, a GSM antenna must be connected to amplify the GSM signal. Ensure that a SIM card is installed in a designated slot.
5. **Configuration in the SmVend personal account**\
   Next, you need to configure the telemetry controller through your [**SmVend personal account**](https://app.smvend.io/)**:**&#x20;

* Go to the specific machine page
* Go to the `Configuration` tab
* Set the cost of 1 unit of product in the `Price` field

<figure><img src="/files/PwV9wAKZyMq2BjUBQwWN" alt=""><figcaption></figcaption></figure>

* Set the cost of 1 pulse in the `Input pulse price for input 2 (coins)`field
* Set the change value in the `Input pulse price for input 3 (acquiring)` field
* Enable the `Hopper mode (enable output 1 until pulse on input 3)` option

<figure><img src="/files/yyYvdv9qO0DRdLUmE8w9" alt=""><figcaption></figcaption></figure>

* Click `Save` for the settings to be transmitted to the telemetry controller
* Go to the `History` tab and check that the settings were applied on the telemetry controller. If the `Completed` column contains:\
  ![](/files/D8Cd4BnLte4oeQ8jCweW)— the settings are applied  \
  ![](/files/Y2xW4t3dePbPejIMA9OY) — the settings have not been applied yet.

  <figure><img src="/files/mW10c6y621OswbOBqC6A" alt=""><figcaption></figcaption></figure>

6. **Restart the machine**\
   Restart the machine's power supply after switching to the hopper operation mode.


# Payment Systems

Here you can find instructions for additional payments systems that you can use with your SmVend telemetry controller.&#x20;

For Spain: \
\- [MONEI and Bizum](/equipment-installation/payment-systems/monei)

For Portugal: \
\- [MB WAY](/equipment-installation/payment-systems/mb-way)


# MB WAY

Are you based in Portugal? Then the video below might be helpful to you.

{% embed url="<https://drive.google.com/file/d/1YKDb3GifDH3TDcc0F5SC_xPCOAwJBdWr/view?usp=sharing>" %}


# MONEI

Welcome to the SmVend guide for registering and integrating with MONEI. This guide will walk you through the necessary steps to set up your MONEI account and integrate it with SmVend, ensuring a seamless payment experience for your vending solutions. Please follow the instructions carefully to complete the process.

### Registration <a href="#dne5g2bxz5aw" id="dne5g2bxz5aw"></a>

Registration link: <https://dashboard.monei.com/?action=signUp&promo=smvend>

{% hint style="info" %}
**Attention!** You must register the MONEI account strictly through the link provided by SmVend. Accounts created by self-registration cannot be integrated.
{% endhint %}

### Integration process <a href="#id-9dg23c65j4r" id="id-9dg23c65j4r"></a>

1. **Enable Live Data Mode**\
   Ensure that the toggle in the header is turned on in `Live data` mode.

<figure><img src="/files/3rGoZawJEXXoDRbPXiuQ" alt=""><figcaption></figcaption></figure>

2. **Find an Account ID**\
   Go to `Settings` using the menu in the top right corner.&#x20;

<figure><img src="/files/qYEasTw7O2FM3JHjtXoz" alt=""><figcaption></figcaption></figure>

Copy your Account ID using the provided button in the `Account` section.

<figure><img src="/files/Sjxnk6EvY8i7w5ZtbJZ9" alt=""><figcaption></figcaption></figure>

3. **Contact SmVend tech support**\
   Contact SmVend tech support at **+371 28701129** (WhatsApp) to add MONEI integration settings to your account.
4. **Insert the API key in your SmVend account**\
   Once the integration is added, insert the Account ID in your SmVend personal account in the controller profile: `Settings -> Integrations ->  MONEI`\
   The `Name` parameter can be filled with any information you want to use to identify this integration.

<figure><img src="/files/HHnIMeS5ClXF9MRghNai" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Attention!** After adding the Account ID, the integration will be saved within 1-2 minutes.
{% endhint %}

5. **Select payment methods in your MONEI account**\
   Go back to your MONEI account and select the payment methods you want to use in the `Payment Methods` section.

<figure><img src="/files/PATnZZw8tinxgecnpeqv" alt=""><figcaption></figcaption></figure>

6. **Create a QR code**

   Go to the specific machine for which you want to create a QR code in your SmVend account.

   Create a QR code in the section `Settings -> MONEI`

<figure><img src="/files/IXHKebni5SiIsUUjASiR" alt=""><figcaption></figcaption></figure>

Both codes with flexible and fixed prices can be created for each controller.

{% tabs %}
{% tab title="Fixed price" %}

<figure><img src="/files/FcGKucnkdmNkS639k7yP" alt="" width="375"><figcaption></figcaption></figure>

To create a QR code with a fixed price, enter the desired amount in the `Price` section and click `Apply`
{% endtab %}

{% tab title="Flexible  price" %}

<figure><img src="/files/GXY31iKGiVm7qnD5bu8o" alt="" width="375"><figcaption></figcaption></figure>

To create a QR code with a flexible price, switch the toggle to the blue color and click `Apply`
{% endtab %}
{% endtabs %}


# Reader

To connect RFID-reader Matrix III RD-ALL to the SmVend Smart Connector controller, please do the following steps:

1. Insert the connector into the `QR-DISPLAY (IDC-10)` connector on the controller

<figure><img src="/files/ibo98wDkMzuKZVH355R1" alt="" width="563"><figcaption></figcaption></figure>

2. Connect the red wire to the `EN OUT` on the controller's contact block

<figure><img src="/files/RokTgTHJPFs3O5g6A7h4" alt="" width="563"><figcaption></figcaption></figure>