# Vending

Nastavení vending produktů a služeb, správa zařízení

# Založení produktů pro vending

Tento manuál popisuje, jak správně nastavit produkty v Backoffice (sekce Ceník) tak, aby byly správně spárovány s výdejním automatem a aby byla zajištěna správná evidence skladových zásob.

### 2. Kde se produkty nastavují?

- Přihlaste se do **Backoffice** v prohlížeči.
- V levém menu vyberte položku **Ceník**.
- Zde vyhledáte nebo vytvoříte produkt, který chcete spravovat.

### 3. Klíčové pravidlo: Shodný produktový kód (PLU)

**Podmínka pro správné párování mezi Backoffice a vending automatem:**  
Produktový kód musí být **naprosto shodný** v Backoffice i v automatu.

- Kód se v Backoffice zadává do pole **„PLU“** (např. `202`).
- **Důrazně doporučujeme:** Každému produktu přiřaďte **unikátní PLU kód**, který je stejný jako na výdejním automatu

<p class="callout warning">Pokud se kódy liší, nedojde k propojení a sklad nebude správně odečítán.</p>

### 4. Jak funguje párování a skladová evidence?

- Všechny produkty, které mají **stejné PLU**, jsou považovány za jednu položku.
- Při prodeji z automatu se zásoby **odečítají z jedné společné skladové karty** (podle PLU).

### 5. Nutné nastavení skladové evidence

Aby Backoffice evidovalo pohyby zásob (příjem, výdej, prodej z automatu), je nezbytné:

1. Přejděte u produktu v ceníku, záložka **Sklady**.
2. **Zapněte volbu:** `Evidovat skladové pohyby`.

Bez tohoto nastavení nebude systém sledovat stavy zásob a nebude odečítat prodané kusy z automatu.

### 6. Nastavení cen – důležité upozornění

**Ceny se nenastavují v Backoffice.** Ceny jsou vždy řízeny a nastaveny **přímo na vending automatu**.

Backoffice slouží výhradně pro:

- evidenci skladu,
- párování produktu přes PLU,
- sledování stavů zásob.

### 7. Shrnutí kontrolních kroků

<div class="ds-scroll-area ds-scroll-area--show-on-focus-within _1210dd7 c03cafe9" id="bkmrk-krok-akce-1-v-backof"><div class="ds-scroll-area__gutters"><div class="ds-scroll-area__horizontal-gutter">  
</div><div class="ds-scroll-area__vertical-gutter">  
</div></div><table><thead><tr><th>Krok</th><th>Akce</th></tr></thead><tbody><tr><td>1</td><td>V Backoffice → Ceník → vytvořit/editovat produkt</td></tr><tr><td>2</td><td>Vyplnit **PLU** = stejný kód jako na automatu (např. 202)</td></tr><tr><td>3</td><td>Zajistit unikátnost kódu pro každý produkt</td></tr><tr><td>4</td><td>V Skladech zapnout **„Evidovat skladové pohyby“**</td></tr><tr><td>5</td><td>Cenu nastavit **přímo na automatu**</td></tr></tbody></table>

</div>### 8. Časté chyby

- ❌ Různé PLU kódy mezi Backoffice a automatem → sklad se nesprávně odečítá.
- ❌ Nezapnutá evidence skladových pohybů → systém nesleduje zásoby.
- ❌ Více produktů se stejným PLU → považují se za jeden sklad (pokud to není záměr).

# Technické schéma modulu KASA VEND Telematics

### Technický popis modulu

Modul **KASA VEND Telematics** je kompaktního čtvercového tvaru. Pro komunikaci s vending automatem využívá standardizované **MDB rozhraní** (Multi-Drop Bus) s odpovídajícím konektorem.

- **Napájení:** 5 V – 48 V DC
- **Připojení k automatu:** MDB sběrnice (stíněný vodič)
- **Konektor:** Standardizovaný MDB konektor

<p class="callout danger">VAROVÁNÍ: Modul zapojujte výhradně při **vypnutém vending automatu**. Nedodržení tohoto postupu může vést k trvalému poškození základní desky stroje (VMC – Vending Machine Controller).</p>

### Zapojení modulu

1. Odpojte vending automat od elektrické sítě.
2. Propojte modul s automatem pomocí **stíněného MDB kabelu**.
3. Připojte MDB konektor do odpovídající zásuvky na modulu a na VMC automatu.

### Upozornění k současnému použití USB-C a MDB

**Důležité:**  
Pokud je k modulu současně připojen **USB-C konektor** i **MDB konektor**, může docházet k **rušení na MDB sběrnici**. Příčinou je sdílená zem (GND a MDB Ground).

<p class="callout info">**Doporučení:** Pokud není USB-C nezbytně nutné pro daný provozní režim, nepoužívejte jej zároveň s aktivním MDB připojením.</p>

[![image.png](https://manual.kasafik.cz/uploads/images/gallery/2026-04/scaled-1680-/ONiYo8MggeypsNRq-image.png)](https://manual.kasafik.cz/uploads/images/gallery/2026-04/ONiYo8MggeypsNRq-image.png)

[![image.png](https://manual.kasafik.cz/uploads/images/gallery/2026-04/scaled-1680-/VZPyFjre6Vj9Ww9c-image.png)](https://manual.kasafik.cz/uploads/images/gallery/2026-04/VZPyFjre6Vj9Ww9c-image.png)

*Schéma zapojení MDB konektoru*

[![image.png](https://manual.kasafik.cz/uploads/images/gallery/2026-05/scaled-1680-/Gsc1oPljG8NTHUaB-image.png)](https://manual.kasafik.cz/uploads/images/gallery/2026-05/Gsc1oPljG8NTHUaB-image.png)

# Nastavení automatů

# Nastavení automatů Jettino Vending

[![Generated Image May 01, 2026 - 10_33AM.jpg](https://manual.kasafik.cz/uploads/images/gallery/2026-05/scaled-1680-/Mssg5Bp4yO01sTSu-generated-image-may-01-2026-10-33am.jpg)](https://manual.kasafik.cz/uploads/images/gallery/2026-05/Mssg5Bp4yO01sTSu-generated-image-may-01-2026-10-33am.jpg)KASA FIK telematický modul a systém plně integruje telematiku a dohled nad automaty od výtobce Jettino Vending. Podproujeme platby mincovníkem, bezhotovostním platebním terminálem [KASA PAY](https://www.kasapay.cz/) nebo QR kódem.

##### Kompatibilita

Podproujeme všechny stroje systémem Android dodávané společností [AG Foods Machine](https://www.agmachine.cz/cs)

- JL550
- JL300
- JL320
- JL36A

#### Postup nastavení telematiky

1. Připojte automat na Wifi v Nastavení Android
2. V User Settings, General Settings, **Server/Test** změňte **první** server na adresu `95.129.97.134` port 4567 - záložní server se používá pouze při výpadku prvního serveru.
3. Proveďte kontrolu Network testing
4. Ujistěte se, že Off-line mode je ve stavy **vypnuto**, viz obrázek
5. Stroj následně začne zasílat telematická data do Backoffice KASA FIK

[![jettino-server-settings.png](https://manual.kasafik.cz/uploads/images/gallery/2026-05/scaled-1680-/hXoJcAFhRAoFxJlY-jettino-server-settings.png)](https://manual.kasafik.cz/uploads/images/gallery/2026-05/hXoJcAFhRAoFxJlY-jettino-server-settings.png)

#### Postup nastavení MDB s platebním terminálem KASA PAY

- V nastavení - Payment Methods zapněte volbu **MDB cashless**
- Extended mode -&gt; **close**
- Always idle -&gt; **close**

[![screen10.png](https://manual.kasafik.cz/uploads/images/gallery/2026-05/scaled-1680-/bnlHeDUa8Z3jq6lk-screen10.png)](https://manual.kasafik.cz/uploads/images/gallery/2026-05/bnlHeDUa8Z3jq6lk-screen10.png)

[![screen11.png](https://manual.kasafik.cz/uploads/images/gallery/2026-05/scaled-1680-/03h9znEn3KW28oC7-screen11.png)](https://manual.kasafik.cz/uploads/images/gallery/2026-05/03h9znEn3KW28oC7-screen11.png)

[![screen26.png](https://manual.kasafik.cz/uploads/images/gallery/2026-05/scaled-1680-/QgkzNOS5nA6o6hg8-screen26.png)](https://manual.kasafik.cz/uploads/images/gallery/2026-05/QgkzNOS5nA6o6hg8-screen26.png)

# Návod k heslům (PIN)

## Přehled uživatelských účtů

Systém Jettino Coffee Machine používá víceúrovňový systém autentizace. Každý účet má různá oprávnění a přístupová práva.

---

## Dostupné účty a hesla

<table id="bkmrk-%C3%9A%C4%8Det-pin-opr%C3%A1vn%C4%9Bn%C3%AD-z" style="width: 77.2619%; height: 178.781px;"><thead><tr style="height: 29.7969px;"><th style="width: 12.0979%; height: 29.7969px;">Účet</th><th style="width: 21.7522%; height: 29.7969px;">PIN</th><th style="width: 25.1781%; height: 29.7969px;">Oprávnění</th><th style="width: 40.779%; height: 29.7969px;">Změna hesla</th></tr></thead><tbody><tr style="height: 29.7969px;"><td style="width: 12.0979%; height: 29.7969px;">**DEV2**</td><td style="width: 21.7522%; height: 29.7969px;">Dynamické (časové)</td><td style="width: 25.1781%; height: 29.7969px;">Vývojář</td><td style="width: 40.779%; height: 29.7969px;">Nelze změnit – generuje se automaticky</td></tr><tr style="height: 29.7969px;"><td style="width: 12.0979%; height: 29.7969px;">**DEV**</td><td style="width: 21.7522%; height: 29.7969px;">Dynamické (časové)</td><td style="width: 25.1781%; height: 29.7969px;">Vývojář</td><td style="width: 40.779%; height: 29.7969px;">Nelze změnit – generuje se automaticky</td></tr><tr style="height: 29.7969px;"><td style="width: 12.0979%; height: 29.7969px;">**TEST**</td><td style="width: 21.7522%; height: 29.7969px;">`testXXXX`</td><td style="width: 25.1781%; height: 29.7969px;">Testovací účet</td><td style="width: 40.779%; height: 29.7969px;">Lze změnit</td></tr><tr style="height: 29.7969px;"><td style="width: 12.0979%; height: 29.7969px;">**ROOT**</td><td style="width: 21.7522%; height: 29.7969px;">`jnXXXX`</td><td style="width: 25.1781%; height: 29.7969px;">Správce (administrator)</td><td style="width: 40.779%; height: 29.7969px;">Lze změnit</td></tr><tr style="height: 29.7969px;"><td style="width: 12.0979%; height: 29.7969px;">**NORMAL**</td><td style="width: 21.7522%; height: 29.7969px;">`XXX`</td><td style="width: 25.1781%; height: 29.7969px;">Běžný uživatel</td><td style="width: 40.779%; height: 29.7969px;">Lze změnit</td></tr></tbody></table>

---

## Podrobný popis účtů

### ROOT (Správce) – `jnXXXX`

- **Oprávnění:** Nejvyšší úroveň přístupu
- **Přístup:** Úplná správa stroje včetně nastavení, údržby a diagnostiky
- **Heslo:** Lze změnit přes menu *Operator Options → Permission Settings → Modify Password*

### TEST – `testXXXX`

- **Oprávnění:** Testovací účet pro servisní techniky
- **Přístup:** Testovací a diagnostické funkce
- **Heslo:** Lze změnit přes menu *Operator Options → Permission Settings → Modify Password*

### NORMAL (Běžný uživatel) – `XXXX`

- **Oprávnění:** Základní přístup k obsluze
- **Přístup:** Limitované nastavení podle konfigurace
- **Heslo:** Lze změnit přes menu *Operator Options → Permission Settings → Modify Password*

### DEV / DEV2 (Vývojář)

- **Oprávnění:** Speciální vývojářský přístup
- **Heslo:** **Dynamické** – mění se každou hodinu podle času zařízení
- **Vzorec:** `MM_dd_HH` → převrácené pořadí + prohození znaků v každém páru

---

## Jak změnit heslo

1. Přihlaste se pomocí libovolného účtu s oprávněním správce (ROOT, TEST, NORMAL)
2. Přejděte do: **ManageActivity → Operator Options → Permission Settings**
3. Vyberte uživatele z rozbalovacího seznamu
4. Stiskněte tlačítko **Modify Password** (Změnit heslo)
5. Zadejte: 
    - **Původní heslo** (stávající PIN)
    - **Nové heslo**
    - **Potvrzení nového hesla**
6. Potvrďte změnu

### Reset hesla

Pokud potřebujete obnovit výchozí hesla, použijte funkci **Reset Password** ve stejném menu. Toto obnoví hesla z konfigurace AppConfig nebo z pevně zakódovaných výchozích hodnot.

---

## Obnovení továrního nastavení (Factory Reset)

Pokud dojde k problémům s hesly nebo konfigurací:

1. Přihlaste se jako ROOT
2. Přejděte do: **ManageActivity → Operator Options → Factory Settings**
3. Potvrďte obnovení továrního nastavení

<p class="callout info">**Poznámka:** Factory reset obnoví všechna nastavení, ale **neobnoví hesla** – hesla se obnovují funkcí Reset Password.</p>

# Nastavení automatů Bianchi Vending

Na zadní straně panelu stiskněte tlačítko pro přístup do vending stroje.

- V sekci **Payment system** zapněte volbu MDB.
- Pro každou pozici, nastavte unikátní Item Number, které použijete jako **PLU** kód u položky v nastavení v Backoffice - tím dojde ke správnému sprárování se skladovým systémem.

[![image.png](https://manual.kasafik.cz/uploads/images/gallery/2026-05/scaled-1680-/M6bXCtzZB5vht7kU-image.png)](https://manual.kasafik.cz/uploads/images/gallery/2026-05/M6bXCtzZB5vht7kU-image.png)

##### Price management

[![image.png](https://manual.kasafik.cz/uploads/images/gallery/2026-05/scaled-1680-/SA5z9aLTdNaZ0OAV-image.png)](https://manual.kasafik.cz/uploads/images/gallery/2026-05/SA5z9aLTdNaZ0OAV-image.png)

# Instalace a nastavení modulu KASA VEND Telematics

## 1. Rychlý workflow nasazení

1. Vypněte vending automat.
2. Připojte modul do MDB konektoru.
3. Zapněte automat a počkejte na stav LED.
4. Pokud LED není **modrá**, Wi-Fi provisioning není potřeba.
5. Pokud LED svítí **modře**, proveďte Wi‑Fi nastavení podle kapitoly níže.
6. Po úspěšném nastavení ověřte, že LED přejde na **zelenou** (online stav).

## 2. Wi‑Fi nastavení přes Espressif Provisioning app

Wi‑Fi se dá nastavit pouze když je zařízení v provisioning režimu (**modrá LED**).

### Krok 1: Instalace aplikace

- iOS: [**Espressif Provisioning**](https://apps.apple.com/us/app/esp-softap-provisioning/id1474040630) (App Store)
- Android: [**Espressif Provisioning**](https://play.google.com/store/apps/details?id=com.espressif.provsoftap&pli=1) (Google Play)

### Krok 2: Spuštění provisioning flow v aplikaci

1. Otevřete aplikaci.
2. Zvolte **Provision New Device**.

![](https://manual.kasafik.cz/uploads/images/gallery/2026-05/scaled-1680-/shGq0iNGNnTInBt5-image-1778502945617-espressif-provsoftap-edit.jpg)

4. Zvolte **I don't have a QR code**.

![](https://manual.kasafik.cz/uploads/images/gallery/2026-05/scaled-1680-/NnmKnjIl4WvbMNwt-image-1778502992790-espressif-provsoftap-edit.jpg)

### Krok 3: Připojení k AP zařízení

1. Klikněte na tlačítko **Connect**.

![](https://manual.kasafik.cz/uploads/images/gallery/2026-05/scaled-1680-/D2uDV2WCEatn8xLR-image-1778503083760-espressif-provsoftap-edit.jpg)

2. V telefonu se Vám otevře seznam Wi‑Fi sítí.
3. Připojte se k síti ve formátu **`PROV_XXXXXX`**.

![](https://manual.kasafik.cz/uploads/images/gallery/2026-05/scaled-1680-/M1BY3lNjVSxWQ9uM-image-1778503365965-android-settings-edit.jpg)

4. Pokud je vyžadováno heslo, použijte heslo které nájdete na zadní straně modulu.

![](https://manual.kasafik.cz/uploads/images/gallery/2026-05/scaled-1680-/dzBlhTdcy4BnnQY1-image-1778503578779-espressif-provsoftap-edit.jpg)

### Krok 4: Zadání cílové Wi‑Fi

1. Vraťte se do provisioning aplikace (pomocí krok zpět na vašem telefonu).
2. Vyberte cílovou síť (např. firemní Wi‑Fi).
3. Zadejte heslo.
4. Kilkněte na tlačítko **PROVISION**.

![](https://manual.kasafik.cz/uploads/images/gallery/2026-05/scaled-1680-/OL13E4Qa6jn46qSl-image-1778503766273.jpg)

- Zařízení uloží přihlašovací údaje, připojí se do Wi‑Fi a následně k MQTT.

## 3. Význam LED stavů

<table id="bkmrk-barva-led-stav-v%C3%BDzna"><thead><tr><th>Barva LED</th><th>Stav</th><th>Význam</th></tr></thead><tbody><tr><td>**Modrá**</td><td>Provisioning</td><td>Zařízení je v režimu nastavení Wi‑Fi</td></tr><tr><td>**Červená**</td><td>Wi‑Fi down</td><td>Zařízení není připojeno k Wi‑Fi</td></tr><tr><td>**Žlutá**</td><td>Wi‑Fi up / MQTT down</td><td>Wi‑Fi je připojeno, ale MQTT není připojeno</td></tr><tr><td>**Zelená**</td><td>All good</td><td>Wi‑Fi i MQTT jsou připojené a zařízení je online</td></tr></tbody></table>

## 4. Troubleshooting podle barvy LED

### Žlutá LED (svítí i po delší době)

Význam: zařízení je připojené na Wi‑Fi, ale nepřipojilo se na MQTT.

Postup:

1. Stiskněte reset tlačítko v levém dolním rohu desky (krátký stisk).
2. Tím se zařízení restartuje a zkusí se znovu připojit k MQTT.
3. Počkejte chvíli a sledujte LED.
4. Pokud problém přetrvává (stále žlutá), kontaktujte **KASA FIK support**.

### Červená LED

Význam: zařízení není připojeno k Wi‑Fi.

Postup:

1. Podržte reset tlačítko, dokud zařízení nepřejde do provisioning režimu (modrá LED).
2. Pokračujte podle postupu pro modrou LED níže (Wi‑Fi setup).

### Modrá LED

Význam: zařízení je v provisioning režimu.

Postup:

1. Posupujte podle návodu **Wi‑Fi nastavení přes Espressif Provisioning app**.
2. Proveďte celý Wi‑Fi setup krok za krokem.
3. Po úspěšném dokončení má LED přejít na **zelenou**.