> For the complete documentation index, see [llms.txt](https://docs.portos.sk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.portos.sk/rozsirenia/choiceqr.md). # ChoiceQR Prepojenie systému PORTOS s objednávkovým systémom ChoiceQR pre objednávky cez QR kód, s osobným odberom a s rozvozom. ## Na čo slúži prepojenie so systémom ChoiceQR? ChoiceQR je objednávkový systém, prostredníctvom ktorého si zákazníci objednávajú cez QR kód na stole, s osobným odberom alebo s rozvozom. Vďaka prepojeniu so systémom ChoiceQR získate: * automatický prenos objednávok zo systému ChoiceQR do Portosu. Objednávky viac nemusíte ručne prepisovať do pokladne. * tržby zo systému ChoiceQR budú súčasťou štatistík v systéme Portos a všetky čísla tak budete mať na jednom mieste. * objednávky zo systému ChoiceQR sú spracované podobne, ako objednávky zadané priamo do pokladne, vrátane tlače objednávkových bonov. * predaj cez ChoiceQR odťažuje skladové zásoby rovnakým spôsobom, ako predaj cez pokladnicu. * automatické zrkadlenie tovarov zo systému Portos do menu v systéme ChoiceQR. Pri zmene ceny či úprave ponuky tak nemusíte upravovať tovary na dvoch miestach. ## Ako funguje prepojenie so systémom ChoiceQR? Systém Portos sa na pozadí služby PORTOS API opakovane, štandardne každých 10 sekúnd, pýta systému ChoiceQR na nové a zmenené objednávky. Každú objednávku zapíše do pokladne ako účet s názvom `ChoiceQR #(číslo objednávky)`. Podľa [nastavení](#spracovanie-objednavok) účet vytvorí po schválení alebo po zaplatení objednávky a zaplatený účet automaticky uzatvorí na fiškálnom zariadení. Opačným smerom systém Portos odosiela do systému ChoiceQR menu, teda tovary, tovarové skupiny, ceny a modifikátory. Menu sa odosiela pri štarte služby (ak je to [povolené](#menu)), alebo manuálne. Viac v časti [Zrkadlenie tovarov](#zrkadlenie-tovarov). Systém Portos do systému ChoiceQR neposiela stav objednávky ani informáciu o úhrade. Objednávky schvaľujete a spravujete v systéme ChoiceQR. ## Ako spustiť prepojenie so systémom ChoiceQR na mojej prevádzke? V prípade, ak ešte ChoiceQR nepoužívate, kontaktujte spoločnosť ChoiceQR ohľadom zriadenia služby na vašom predajnom mieste. Prepojenie s pokladničným systémom je dostupné iba vo vybraných plánoch služby ChoiceQR a môže vyžadovať tablet so systémom Android na prevádzke. Podrobnosti vám poskytne spoločnosť ChoiceQR. Spustenie prepojenia systému Portos so systémom ChoiceQR vyžaduje: * Používanie systému Portos vo verzii 4.3.20 alebo novšej. * Rozšírenie "*Prepojenie so systémom ChoiceQR*", ktoré je spoplatnené podľa [aktuálneho cenníka](https://portos.sk/cennik). * Token pre prepojenie, ktorý vám poskytne spoločnosť ChoiceQR. * Pripojenie počítača so službou PORTOS API na internet. Služba *Expose* pre prepojenie so systémom ChoiceQR potrebná nie je. S celým procesom vám radi pomôžeme. Kontaktujte svojho servisného technika. ## Nastavenia Pre prístup k nastaveniam prepojenia so systémom ChoiceQR: * otvorte aplikáciu [Portos BackOffice](/backoffice/uvod-do-aplikacie-backoffice.md) a prihláste sa. * v hlavnom menu kliknite v sekcii "**Systém**" na položku "**Rozšírenia**". * Zobrazí sa zoznam rozšírení systému. V časti "**ChoiceQR**" stlačte tlačidlo "**Spravovať**". Zobrazí sa obrazovka s nastaveniami, na ktorej sú k dispozícii nastavenia popísané nižšie. Zmeny nastavení sa uplatnia po stlačení tlačidla "**Uložiť**", pričom sa rozšírenie reštartuje.

Nastavenia rozšírenia ChoiceQR v aplikácii PORTOS BackOffice

* **Aktívne**: určuje, či je rozšírenie aktívne. Objednávky sa prenášajú iba vtedy, ak je rozšírenie aktívne. ### Pripojenie * **Token**: token pre prepojenie, ktorý vám poskytne spoločnosť ChoiceQR. ### Menu * **Názov menu**: názov, ktorý sa odošle do systému ChoiceQR. Štandardne `Menu`. * **Popis menu**: popis, ktorý sa odošle do systému ChoiceQR. Štandardne `Aktuálna ponuka`. * **Predvolený jazyk**: jazyk prenášaný do menu v systéme ChoiceQR. K dispozícii je slovenčina. * **Sklad pre export menu**: ak je zvolený, do menu sa zahrnú len tovary z tohto skladu. Pri voľbe "Všetky sklady" sa zahrnú tovary zo všetkých skladov. * **Nahrať menu pri štarte**: ak je zapnuté, pri každom štarte služby PORTOS API sa menu znovu odošle do systému ChoiceQR. * **Vymazať nenájdené tovary**: ak je zapnuté, zo systému ChoiceQR sa pri odosielaní menu vymažú tovary, ktoré v systéme Portos neboli nájdené. ### Synchronizácia objednávok * **Perióda synchronizácie**: ako často sa systém Portos pýta systému ChoiceQR na nové objednávky. Hodnota v tvare `HH:mm:ss`, štandardne `00:00:10` (každých 10 sekúnd). Najkratšia povolená perióda je 10 sekúnd. * **Zahrnúť schválené objednávky**: ak je zapnuté, do synchronizácie sa zahrnú aj objednávky v schválenom stave. ### Spracovanie objednávok * **Vytvoriť otvorený účet**: určuje, kedy sa pre objednávku vytvorí v pokladni otvorený účet. K dispozícii sú možnosti: * **Po schválení objednávky**: účet sa vytvorí, keď obsluha objednávku v systéme ChoiceQR schváli. * **Po zaplatení objednávky**: účet sa vytvorí, keď je objednávka zaplatená. * **Nikdy**: otvorený účet sa nevytvára. Účet sa vytvorí až pri jeho uzatvorení (ak je nastavené [Uzatvoriť účet](#uzatvaranie-uctu)). * **Tlačiť objednávkové bony**: ak je zapnuté, pri vytvorení alebo uzatvorení účtu sa vytlačia objednávkové bony na [objednávkových zariadeniach](/nastavenie-systemu/objednavkove-zariadenia.md) priradených tovarom. * **Trieda DPH pre neznáme tovary**: trieda DPH použitá pre položky objednávky, ktoré nie je možné spárovať s tovarom v systéme Portos. Viac v časti [Párovanie tovarov](#parovanie-tovarov). * **Trieda DPH pre prepitné**: trieda DPH použitá pre položku prepitného. * **Hotovostné platidlo**: [platidlo](/nastavenie-systemu/platidla.md), pod ktorým sa eviduje úhrada objednávky zaplatenej v hotovosti. * **Bezhotovostné platidlo**: platidlo, pod ktorým sa eviduje úhrada objednávky zaplatenej ostatnými spôsobmi platby. ### Uzatváranie účtu * **Uzatvoriť účet**: určuje, kedy sa účet automaticky uzatvorí. K dispozícii sú možnosti: * **Po zaplatení objednávky**: účet sa uzatvorí na zvolenom fiškálnom zariadení, keď je objednávka zaplatená. Ak pre objednávku ešte nebol vytvorený otvorený účet, vytvorí sa a ihneď uzatvorí. * **Nikdy**: účet sa automaticky neuzatvára, uzatvára ho obsluha v pokladni. * **Fiškálne zariadenie**: [fiškálna tlačiareň](/nastavenie-systemu/fiskalne-tlaciarne.md), ktorá sa použije pri automatickom uzatváraní účtu. Povinné, ak sa účet uzatvára automaticky. ### Diagnostika * **Podrobné zaznamenávanie údajov**: predvolene vypnuté. Zapnutím sa do aplikačných denníkov uložia kompletné údaje komunikácie so systémom ChoiceQR, čo môže výrazne zväčšiť ich veľkosť. Používajte iba na odporúčanie technickej podpory. ## Zrkadlenie tovarov Do menu v systéme ChoiceQR sa odosielajú tovary, ktoré: * sú aktívne, * majú povolený predaj cez online objednávky (v úprave tovaru, v sekcii "**Online objednávky**" prepínač "**Povolené**"), * sa nachádzajú v sklade zvolenom v nastavení [Sklad pre export menu](#menu), ak je zvolený. Tovary sa v menu zoskupia podľa [tovarových skupín](/nastavenie-systemu/tovarove-skupiny.md). Ku každému tovaru sa odošle názov, popis pre zákazníka, predajná cena s DPH, obrázok a [modifikátory](/skladove-hospodarstvo/modifikatory.md). Zmeny tovarov v systéme Portos (napríklad zmena ceny) sa do systému ChoiceQR prenesú až pri najbližšom odoslaní menu. Menu odošlete manuálne takto: 1. otvorte [nastavenia rozšírenia](#nastavenia), 2. v hornej pravej časti kliknite na ponuku (ikonka troch bodiek) a zvoľte možnosť "**Synchronizovať tovary teraz**". Tovary, ktorým vypnete predaj cez online objednávky, sa pri odoslaní menu zo systému ChoiceQR vymažú. ## Párovanie tovarov Pri odoslaní menu si systém ChoiceQR ku každému tovaru uloží jeho identifikátor v systéme Portos (číslo tovaru a názov skladu). Podľa neho sa položky prijatých objednávok automaticky spárujú s tovarmi v systéme Portos. Preto odporúčame menu v systéme ChoiceQR vytvárať výhradne odoslaním zo systému Portos. Položku objednávky, ktorú nie je možné spárovať, systém Portos zapíše do účtu ako položku typu služba s triedou DPH podľa nastavenia [Trieda DPH pre neznáme tovary](#spracovanie-objednavok). Pre takúto položku sa nevytlačí objednávkový bon. Do účtu sa ďalej zapíšu: * poznámka zákazníka k objednávke, ako položka s nulovou cenou, * zvolené možnosti modifikátorov a poznámky k položkám, * poplatky (napríklad za dopravu) a prepitné, ako samostatné položky. Typ nákupu účtu sa nastaví podľa spôsobu doručenia objednávky (na mieste, so sebou, rozvoz). Pri rozvoze sa k účtu zapíše aj meno a telefónne číslo zákazníka. ## Otázky a odpovede ### Objednávka zo systému ChoiceQR sa v pokladni nezobrazila 1. Overte, či je rozšírenie v nastaveniach [aktívne](#nastavenia). 2. Overte nastavenie [Vytvoriť otvorený účet](#spracovanie-objednavok). Pri možnosti "Po zaplatení objednávky" sa nezaplatená objednávka v pokladni nezobrazí. 3. Overte, či sa rozšírenie nezobrazuje v aplikácii PORTOS Pokladňa, v obrazovke *Stav systému*. Ak sa pri synchronizácii vyskytla chyba, zobrazí sa tu spolu s popisom. Rozšírenie, ktoré pracuje správne, sa v tejto obrazovke nezobrazuje. ### K objednávke sa nevytlačil objednávkový bon Overte, či je zapnuté nastavenie [Tlačiť objednávkové bony](#spracovanie-objednavok) a či má tovar priradené objednávkové zariadenie. Ak sa položka objednávky nespárovala s tovarom v systéme Portos, objednávkový bon sa pre ňu nevytlačí. Pozrite časť [Párovanie tovarov](#parovanie-tovarov). ### Zmenil som cenu tovaru, ale v systéme ChoiceQR sa nezmenila Zmeny sa do systému ChoiceQR prenesú až pri odoslaní menu. Postup nájdete v časti [Zrkadlenie tovarov](#zrkadlenie-tovarov).