> 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/camarero.md). # Camarero Prepojenie systému PORTOS s objednávkovým systémom pre čašníkov Camarero prostredníctvom prenosu .pda súborov. ## Na čo slúži prepojenie so systémom Camarero? Camarero je slovenský objednávkový systém, ktorý čašníkom umožňuje zbierať objednávky na prenosných zariadeniach. Vďaka prepojeniu so systémom Camarero získate: * automatický prenos účtov zo systému Camarero do Portosu. Účty viac nemusíte ručne prepisovať do pokladne. * tržby zo systému Camarero budú súčasťou štatistík v systéme Portos a všetky čísla tak budete mať na jednom mieste. * doklady zo systému Camarero sa uzatvárajú na fiškálnej tlačiarni systému Portos. * predaj cez Camarero odťažuje skladové zásoby rovnakým spôsobom, ako predaj cez pokladnicu. ## Ako funguje prepojenie so systémom Camarero? Prostredníctvom súborov. Systém Camarero ukladá každý účet ako samostatný súbor s príponou `.pda` do dohodnutého adresára. Služba PORTOS API tento adresár nepretržite sleduje a každý nový súbor ihneď spracuje: * zo súboru vytvorí v systéme Portos **nový účet** s položkami, zákazníkom, zľavou a umiestnením (stôl a zóna), ak sú v súbore uvedené, * ak je v súbore uvedené platidlo, účet uhradí a uzatvorí na fiškálnej tlačiarni. Ak platidlo uvedené nie je, účet zostane v systéme Portos otvorený, * úspešne spracovaný súbor z adresára vymaže. Súbor, ktorý sa spracovať nepodarilo, presunie do [adresára pre zlyhané súbory](#expertne-nastavenia). Údaje sa prenášajú iba jedným smerom, zo systému Camarero do systému Portos. Tovary, ceny ani iné údaje zo systému Portos sa do systému Camarero neodosielajú. ## Ako spustiť prepojenie so systémom Camarero na mojej prevádzke? Spustenie prepojenia systému Portos so systémom Camarero vyžaduje: * Používanie systému Portos vo verzii 4 alebo novšej. V prípade, ak používate Portos vo verzii 3, bude nutná aktualizácia. * Rozšírenie "*Integrácia so systémom Camarero*", ktoré je spoplatnené podľa [aktuálneho cenníka](https://portos.sk/cennik). * Nastavenie systému Camarero tak, aby ukladal `.pda` súbory do adresára, ku ktorému má prístup služba PORTOS API (štandardne `C:\POS\`). Adresár musí existovať, služba PORTOS API ho sama nevytvorí. * [Zjednotenie údajov](#parovanie-udajov) medzi systémami Camarero a Portos (čísla tovarov, používatelia, platidlá). S celým procesom vám radi pomôžeme. Kontaktujte svojho servisného technika. ## Nastavenia Pre prístup k nastaveniam prepojenia so systémom Camarero: * 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 "**Camarero**" 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ť**". Pôvodné nastavenia obnovíte voľbou "**Obnova továrenských nastavení**".

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

* **Aktívne**: určuje, či je rozšírenie aktívne. Súbory sa spracúvajú iba vtedy, ak je rozšírenie aktívne. ### Tvorba dokladu * **Sklad**: sklad, v ktorom budú vyhľadávané tovary uvedené vo vstupnom súbore. Nechajte prázdne pre vyhľadávanie vo všetkých skladoch. * **Predvolená fiskálna tlačiareň**: tlačiareň, na ktorej budú vytlačené doklady v prípade, ak vo vstupnom súbore nebude uvedená. * **Predvolená trieda DPH**: trieda DPH použitá v prípade, ak vo vstupnom súbore nebude k tovaru uvedená. * **Predvolená jednotka**: množstevná jednotka, ktorá bude použitá, ak vo vstupnom súbore nebude uvedená. Štandardne `ks`. * **Predvolený typ nákupu**: typ nákupu (na mieste, so sebou, rozvoz), ktorý bude použitý pre importované doklady. * **Spracúvať objednávky**: určuje, či systém Portos vytlačí k položkám účtu objednávkové bony na [objednávkových zariadeniach](/nastavenie-systemu/objednavkove-zariadenia.md). Vypnite, ak objednávkové bony tlačí systém Camarero. {% hint style="info" %} Nastavenia **Predvolená trieda DPH** (pre tovary bez čísla) a **Predvolený typ nákupu** sa uplatňujú od verzie PORTOS API 4.3.22. V starších verziách má importovaný účet neznámy typ nákupu a súbor s tovarom bez čísla a bez triedy DPH sa nespracuje. {% endhint %} ### Expertné nastavenia Sekcia je štandardne zbalená. Tieto nastavenia zvyčajne nie je potrebné meniť. * **Vstupný adresár**: cesta k adresáru, z ktorého bude aplikácia spracúvať súbory. Štandardne `C:/POS/`. Spracúvajú sa iba súbory priamo v tomto adresári, podadresáre sa ignorujú. * **Adresár pre zlyhané súbory**: cesta k adresáru, kam bude aplikácia presúvať súbory, ktoré sa nepodarilo spracovať. Štandardne `C:/POS/FAILED/`. Nesmie sa zhodovať so vstupným adresárom. * **Počet pokusov čítania súboru**: maximálny počet pokusov o otvorenie a prečítanie obsahu súboru, ak je súbor ešte otvorený systémom Camarero. Štandardne `3`. * **Čas medzi pokusmi o čítanie súboru**: čas v milisekundách, po ktorom sa aplikácia pokúsi o opätovné prečítanie obsahu súboru. Štandardne `300`. * **Extenzia súboru**: prípona súborov, ktoré bude aplikácia spracúvať. Štandardne `.pda`. Súbory s inou príponou zostanú vo vstupnom adresári nespracované. * **Počet desatinných miest množstva**: počet desatinných miest, ktorými je uvedené množstvo vo vstupnom súbore. Štandardne `2`. * **Počet desatinných miest jednotkovej ceny**: počet desatinných miest, ktorými je uvedená jednotková cena vo vstupnom súbore. Štandardne `2`. * **Výška zaokrúhlenia**: určuje výšku zaokrúhlenia, ktoré má byť použité v prípade hotovostných platieb. Štandardne `0,05`. ## Párovanie údajov Aby systém Portos dokázal súbor zo systému Camarero spracovať, musia sa údaje v súbore zhodovať s údajmi v systéme Portos: | Údaj v súbore zo systému Camarero | Vyhľadá sa v systéme Portos podľa | | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Tovar | čísla tovaru (PLU). Musí existovať práve jeden aktívny tovar s týmto číslom, prípadne práve jeden v sklade zvolenom v nastavení [Sklad](#tvorba-dokladu). | | Tovar bez čísla | Ak tovar v súbore nemá číslo, vytvorí sa položka typu služba s názvom, triedou DPH a jednotkou uvedenými v súbore. Názov musí byť v súbore uvedený. | | Čašník | prihlasovacieho mena [používateľa](/nastavenie-systemu/pouzivatelia.md). Používateľ musí byť aktívny. Systém Camarero posiela číselný kód čašníka, prihlasovacie meno používateľa preto musí byť číselné. | | Platidlo | čísla [platidla](/nastavenie-systemu/platidla.md). Platidlo musí byť aktívne. | | Zákaznícka karta | sériového čísla karty [zákazníckeho účtu](/nastavenie-systemu/zakaznicke-ucty.md). | | Trieda DPH | čísla [triedy DPH](/nastavenie-systemu/triedy-dph.md) (1 až 10). | | Umiestnenie | názvu stola a zóny. | | Fiškálna tlačiareň | názvu [fiškálnej tlačiarne](/nastavenie-systemu/fiskalne-tlaciarne.md). Ak v súbore nie je uvedená, použije sa [predvolená fiskálna tlačiareň](#tvorba-dokladu). | Cena tovaru sa preberá zo súboru, nie z tovaru v systéme Portos. {% hint style="warning" %} Ak niektorý údaj nie je možné spárovať (napríklad tovar s daným číslom v systéme Portos neexistuje), celý súbor sa nespracuje a presunie sa do adresára pre zlyhané súbory. {% endhint %} ## Otázky a odpovede ### Účet zo systému Camarero sa v pokladni nezobrazil 1. Overte, či je rozšírenie v nastaveniach [aktívne](#nastavenia). 2. Overte, či sa súbor nenachádza v [adresári pre zlyhané súbory](#expertne-nastavenia) (štandardne `C:\POS\FAILED\`). Ak áno, súbor sa nepodarilo spracovať, najčastejšie pre nespárovaný tovar, používateľa alebo platidlo. Pozrite časť [Párovanie údajov](#parovanie-udajov). Po oprave údajov presuňte súbor späť do vstupného adresára a systém Portos ho spracuje znova. 3. Ak súbor zostal vo vstupnom adresári, overte, či jeho prípona zodpovedá nastaveniu [Extenzia súboru](#expertne-nastavenia). 4. Ak sa nespracúva žiadny súbor, overte, či vstupný adresár existuje. Ak sa rozšírenie nepodarilo spustiť, zobrazí sa s chybou v aplikácii PORTOS Pokladňa, v obrazovke *Stav systému*. Systém Portos sa ho v takom prípade pokúsi spustiť znova o minútu, prípadne hneď po uložení nastavení rozšírenia. ### Pridajú sa položky zo systému Camarero do už otvoreného účtu na stole? Nie. Každý súbor zo systému Camarero vytvorí v systéme Portos samostatný nový účet. ### Objednávkové bony sa tlačia dvakrát Objednávkové bony pravdepodobne tlačí systém Camarero aj systém Portos. Vypnite nastavenie [Spracúvať objednávky](#tvorba-dokladu).