Hagaha HorecaPOS

Hagahan wuxuu ka kooban yahay saddex qaybood: marka hore shaqaalaha (adeegga), kadib maareeyaha ugu dambeyntiina maamulaha. Qayb kastaa waxay ku dhisan tahay tii ka horreysay: maareeyuhu wuxuu samayn karaa wax kasta oo adeeggu samayn karo, maamuluhuna wax walba.

Waxa doorkaagu sameyn karo, maamulaha ayaa dejiya Dejinta → Ogolaanshaha. Haddii aadan badhan arkin, doorkaagu (weli) ogolaansho uma laha.

Hagahan sidoo kale wuxuu ku jiraa kashiirka: taabo badhanka © ee midigta hoose ee shaashad kasta oo dooro Hagaha, ama fur http://<kassa-pc>:3000/handleiding. Sidoo kale eeg hordhaca iyo dukumentiga API-ga.

Qaybta 1 · Shaqaalaha

Bilow

Gelitaan. Ka fur kashiirka kashiirka, tablet-ka ama telefoonka oo geli PIN-kaaga (4 ilaa 8 god). Kadib waxaad arkaysaa khariidadda miisaska.

Furitaanka miis. Taabo miis. Miis bannaan wuxuu helayaa dalab cusub; miis la fadhiyo waxaad ku sii wadaysaa dalabka hore u jiray. Xagga sare waxaad ku kala beddeshaa qolalka (tusaale Hoolka iyo Barxadda). Kawaanka waxaad u isticmaashaa Iib degdeg ah, dalabaadka la qaato Qaadasho.

Dalbasho. Dooro koox alaab ah oo taabo alaabta. Waxay ka soo muuqanayaan rasiidka bidixda. Haddii aad rabto, marka hore dooro koorsada (1 = isla markiiba, 2 iyo 3 way sugayaan ilaa aad u yeerto). Taabo Dalbo: markaas warqadaha jikada waxay u baxayaan jikada iyo baarka. Inta aadan taaban Dalbo, si fudud ayaad saf uga saari kartaa.

Xisaabin. Taabo Xisaabi, dooro Pin / Bancontact, Kaash ama Kaarka hadiyadda, haddii aad rabto baqshiish, kadibna xaqiiji. Marka kaar lagu bixiyo, lacag bixintu si toos ah ayay uga bilaabantaa mashiinka kaarka. Rasiidka waa la daabacayaa; sidoo kale iimayl ayaad ku diri kartaa.

Ka bixid. Ka bax markaad dhammayso, si aan qof kale magacaaga ugu shaqayn. 8 saacadood kadib si toos ah ayaa lagaa saarayaa.

Internet ma jiro? Kaashku si caadi ah ayuu u sii shaqaynayaa. Haddii korka ay ku qoran tahay Internet ma jiro · kaar gacanta ku bixi, lacagta ku gali mashiinka kaarka laftiisa, kadibna shaashadda xisaabinta ka dooro Horay terminalka loogu bixiyay.

Kooxo badan hal miis

Miis keliya waxaa ku fadhiyi kara dhowr kooxood, mid walbana wuxuu leeyahay biil iyo rasiid u gaar ah.

• Taabo miis: bannaan = dalab cusub; hal koox = isla markiiba kooxdaas; dhowr kooxood = marka hore dooro, ama + Koox cusub (magacu wuu madhnaan karaa).
• Shaashadda dalabka korkeeda waxaa ku yaal xarriiqda kooxaha: ku kala wareeg kooxaha, + Koox, Magaca kooxda (tusaale "Jansen") iyo Kala qaybi / wareeji.
• Kala qaybi / wareeji: saf kasta dooro inta raacaysa (tusaale 1 ka mid ah 3× Pils) iyo kooxda ay u socdaan, ama samee koox cusub. Sidaas ayaad ku wareejin kartaa wax ku jira biil khaldan, ama kadib u kala qaybin kartaa "qof walba qaybtiisa ayuu bixiyaa". Haddii koox madhato, way baaba'aysaa.
• Qaybo badan hal mar: + Qayb kale waxaad ku diyaarisaa qayb, kadibna dooro tan xigta (tusaale kalluun iyo hal Dry Martini miiska 2, inta kale miiska 35). Qayb waxay sidoo kale aadi kartaa + Miis kale (halkaas koox cusub). U wareeji wax walba hal mar ayay u wareejisaa. ½ sadar ayay kala badh u qaybisaa, xataa nus dhalo (0,667 wuxuu noqdaa 2 × 0,3335).
• Isku dar: wax walba oo ka yimid hal ama dhowr miis oo kale (ama kooxo miiskan ku jira) biilkan, hal mar.
• Beljiyam: kala qaybinta ama isku darka hal mar waa hal beddelka miis sanduuqa madow, sida FOD rabto (UC242, UC251, UC252, UC4119bis). Haddii dalabka kadib wax la tirtiro ama qiimo-dhimis lagu sameeyo sadar hore loo dalbaday, taasi waxay la socotaa fariinta xigta ee miiskaas (dalab, biil ku-meel-gaar ah, beddelka miis), haddii kalese iibka: sadarka hore taban, kan cusubna togan (UC226, UC4102, UC4104, UC4107, UC4110).
• Shaashadda miisaska, dhibic oranji ah ayaa muujisa inta kooxood ee jirta; lacagtu waa wadarta kooxaha oo dhan.
• Rasiidka kaashka iyo warqadda jikada waxay muujinayaan "Miiska 5 - kooxda 2" ama "Miiska 5 - Jansen".

Kala qaybi biilka marka la xisaabinayo

Xisaabintu sidii caadiga ahayd ayay u shaqaysaa: Dhammaan hal mar. Shaashadda xisaabinta hadda biilka sidoo kale waa la kala qaybin karaa, iyadoo la isticmaalayo badhamada ka hooseeya Dib u noqo iyo Xisaabi (sidaas ayay had iyo jeer u muuqdaan, iyadoo aan la jiidin):

• U qaybi si siman: ku dooro − iyo + inta qof (caadi ahaan tirada martida, ama 2 haddii khasnaddu aysan diiwaangelin tirada dadka). Shaashaddu waxay muujinaysaa qaddarka qof kasta; qof walba wuxuu qaybtiisa ku bixiyaa kaarka, lacag caddaan ah ama kaarka hadiyadda (bakhshiish haddii aad rabto). Qayb kasta kadib wuu hoos u tiriyaa ("weli 3 qof"); kan ugu dambeeya wuxuu bixiyaa inta hartay oo sax ah.
• Lacag gaar ah: qof ayaa bixiya lacag go'an (tusaale € 20); inta kale way furnaanaysaa.
• Alaab kasta…: wuxuu furaa Kala qaybi / wareeji si alaab loogu wareejiyo biil gaar ah oo si gooni ah loo xisaabiyo (sida kor ku xusan).

Lacag bixin qayb ah waxay diiwaangelisaa oo kaliya lacag bixinta; biilku wuu furnaanayaa, shaashadda dalabkana waxaa ku qoran "horay loo bixiyay … · weli furan …". Rasiidka (oo ay ku qoran yihiin lacag bixinnada oo dhan) wuxuu imanayaa lacag bixinta ugu dambaysa, sida xisaabinta caadiga ah. Kaar ku bixinta xiriirka waxay noqonaysaa lacagta qaybta oo sax ah. Haddii qayb horay loo bixiyay, safaf looma wareejin karo koox kale, qiimo-dhimisna laguma dari karo; ka saarid waa suurtagal oo kaliya haddii ay inta furan ku filan tahay. Lacag bixin qayb ah kasta waxay gashaa diiwaanka.

Iib degdeg ah iyo qaadasho (miis la'aan)

Shaashadda miisaska geeska sare ee midig waxaa ku yaal Iib degdeg ah iyo Qaadasho. Labaduba isla markiiba waxay furaan dalab miis la'aan ah. Iib degdeg ah waa iib miiska hore (VAT cunista goobta); Qaadasho waxay isticmaashaa heerka VAT qaadashada ee alaab kasta. "Magaca macmiilka" waxaad ku dari kartaa magac; wuxuu ku qoran yahay rasiidka ("Qaadasho – Jansen") iyo korka warqadda jikada. Dalabyada furan ee miis la'aanta ah waxay ku hoos qoran yihiin badhamada qolalka ("Miis la'aan: Qaadasho #12 – Jansen"), si aad dib ugu heshid. Haddii aad dib u noqoto adigoon waxba iibin, dalabka madhan si toos ah ayuu u baaba'aa.

Labada badhan ganacsi kasta waa la shidi karaa ama la demin karaa Dejinta → Ganacsiga, isla hoosta mawduuca iftiinka/mugdiga (caadi ahaan waa shidan). Dansan = badhanka waa qarsoon yahay; dalabyada miis la'aanta ah ee horay u furnaa way muuqanayaan.

Keenis iyo xilliyo

Dalabyada adigu kaashka ku diiwaangeliso, tusaale taleefan ama miiska hore, iyadoo la raacayo xeerarka dukaanka online-ka: aagagga keenista iyo tirada ugu badan ee dalabyada xilli kasta. Ka shid Dejinta → Ganacsiga → Keenis iyo xilliyo, si toos ah hoostooda badhamada Iib degdeg ah iyo Qaado (caadi ahaan waa dansan).

• Badhanka Keenis ee shaashadda miisaska (Qaado agtiisa): geli magac, taleefan iyo cinwaan (marka Cinwaan si degdeg ah u geli shidan yahay: kood boosto iyo lambar guri ka raadi). Kaashku wuxuu raadiyaa aagga keenista wuxuuna muujiyaa kharashka keenista, ugu yaraanta iyo "bilaash laga bilaabo". Haddii cinwaanku ka baxsan yahay aagagga, suurtagal ma aha.
• Aagagga keenista: kood boosto ahaan (taxane iyo kood keli ah, tusaale 5000-5049, 5051, 5052 AB), gudaha fogaan km ah oo ganacsiga laga bilaabo (xariiq toos ah) ama aag khariidadda ku yaal oo adigu sawirto. Fogaanta iyo aagga waxay la shaqeeyaan cinwaanada Nederland oo keliya (goobta waxaa laga helaa PDOK). Aag kasta: kharashka keenista, ugu yaraan, bilaash laga bilaabo iyo daqiiqado dheeraad ah; aagga ugu horreeya ee sare ee ku habboon ayaa shaqeeya, sidaa darteed noocyada waa la isku dari karaa (tusaale marka hore dhowr kood boosto, kadib aag, kadib fogaan inta kale). Aag la dejiyay ma jiro = meel kasta keen, kharash iyo ugu yaraan la'aan. Aagagga dukaanka online-ka si gooni ah ayaad u dejisaa (maamulka dukaanka online-ka).
• Aag khariidadda ku yaal: aagga keenista ka dooro nooca Aag khariidadda ku yaal kadibna Ku sawir khariidadda. Guji khariidadda si aad dhibcood u dhigto (ugu yaraan 3); jiid dhibic si aad u guurisid, guji dhibic si aad u tirtirto, oo jiid goobada yar ee bartamaha xarriiqda si aad dhibic dhexdooda ugu darto. Khariidaddu waxay sidoo kale muujisaa aagagga fogaanta iyo ganacsiga. Xabbadaha khariidadda waxay ka yimaadaan OpenStreetMap, sidaa darteed khariidadda internet ayaa loo baahan yahay; keenista lafteeda looma baahna (marka laga reebo raadinta cinwaanka). Haddii cinwaanka la raadin waayo, kaashku taas ayuu sheegaa halkii uu ka odhan lahaa "aagagga keenista ka baxsan".
• Kharashka keenista wuxuu dalabka ugu jiraa khad ahaan "Kharashka keenista" waxaana dib loo xisaabiyaa isbeddel kasta kadib (bilaash laga bilaabo, alaab la'aan = kharash la'aan), inta aan waxba la bixin. Ka hooseeya ugu yaraanta lacag bixin lama samayn karo; shaashadda dalabku waxay muujisaa inta weli dhiman, iyo badhanka Qaado si kastaba (kharashka keenista iyo ugu yaraantu way baaba'ayaan).
• Waqti: Sida ugu dhakhsaha badan (hadda + waqtiga keenista, oo lagu daray daqiiqadaha dheeraadka ah ee aagga) ama xilli maanta ah. Haddii saacadaha furitaanka ee Thuisbezorgd la dejiyay, halkanna way khuseeyaan.
• Ugu badnaan xilli kasta (0 = xad la'aan; xilli 5 ilaa 60 daqiiqo): Qaado iyo Keenis wadajir; dalabyada dukaanka online-ka ee kaashka ku jira sidoo kale waa la xisaabiyaa. Haddii xad jiro, Qaado sidoo kale waqti ayuu weydiiyaa, xilliyada buuxana lama dooran karo. Laba kaash oo hal mar qaata booska ugu dambeeya: mid keliya ayaa hela.
• Warqadda jikada waxaa ku qoran cinwaanka, magaca, taleefanka iyo waqtiga; gudaha "Miis la'aan" iyo xagga sare ee warqadda jikada, tusaale "Keenis – 18:30 Jansen".

Kordhinno (dhammaan caadi ahaan waa dansan; dejintan la'aantood wax walba sida kor ku xusan ayay u shaqeeyaan):

• Saacado furitaan gaar ah oo qaadashada iyo keenista (maalin kasta oo toddobaadka ah, tusaale 16:00-21:00 ama 11:30-14:00, 17:00-22:00; saqda dhexe kadib waa suurtagal: 17:00-01:00; madhan = maalintaas waa xiran tahay). Dansan = sidii hore (waqtiyada Thuisbezorgd, haddii ay jiraan, haddii kale maalinta oo dhan).
• Maalmaha xiran (tusaale 25-12-2026, 26-12-2026): markaas qaadasho iyo keenis midna ma jiro.
• Horay u dalbasho: 0 (maanta kaliya, sidii hore) ilaa 14 maalmood. Daaqadda Keenis/Qaado marka hore waxaad doorataa maalinta; maalin dambe waxay ku qoran tahay warqadda jikada waqtiga hortiisa.
• Mashquul: intaas daqiiqo oo dheeraad ah marka "sida ugu dhakhsaha badan" (khasnadda iyo dukaanka online). Sidoo kale si dhakhso ah ayaa loogu dejin karaa badhanka Dukaan online ee baarka sare.
• Cinwaannada Beljiyam (koodh boosta oo 4 lambar ah): marka la isticmaalayo raadiyo ama aag khariidadda ku yaal, khasnaddu waxay goobta ka raadisaa OpenStreetMap (Nominatim; waddada iyo magaalada ayaa loo baahan yahay).
• Dukaanka online wuxuu raacaa khasnadda: khasnaddu ayaa go'aamisa. Dukaanka online markaas wuxuu isticmaalaa aagagga keenista, waqtiga keenista iyo qaadashada, xilliga, ugu badnaanta xilli kasta, saacadaha furitaanka (haddii halkan lagu dejiyay), maalmaha xiran iyo maalmaha horay ee khasnadda, wuxuuna xilliga ku xisaabiyaa dalabyada lagu aqbalay khasnadda. Dansan = dukaanka online wuxuu leeyahay dejin u gaar ah (maamulka dukaanka online), sidii hore. Shidista ama damiska qaadashada/keenista waxay ku hartaa dukaanka online.

Koodh: lib/bezorgen.ts, routes/bezorgen.ts, BezorgDialoog.tsx, BezorgInstellingen.tsx, BezorgKaart.tsx iyo lib/kaart.ts (khariidadda, xirmo dheeraad ah la'aan; isla koodhkaas wuxuu dukaanka online-ka ugu jiraa public/kaart.js).

Taleefan: aqoonsiga macmiilka marka dalab taleefan la sameeyo

Dejinta → Taleefan (caadi ahaan waa dansan; damintu wax walba way kaydisaa). Laba furaha oo kala gooni ah:

• Ka raadi macmiilka lambarka taleefanka marka la keenayo iyo marka la qaadanayo: haddii aad lambarka ku qorto shaashadda keenista, kaashku wuxuu muujiyaa macmiilka oo leh cinwaanka iyo dalabaadkii hore; Qaado xogta wuxuu buuxiyaa magaca, iimaylka iyo cinwaanka. Wuxuu shaqeeyaa xitaa xarun taleefan la'aan.
• Aqoonsiga lambarka: marka macmiil soo waco, xarunta taleefanka (ama aaladda, FRITZ!Box, modemka ama taleefanka Android) ayaa soo sheegta lambarka. Shaashadaha waxaa ka soo baxa ogeysiis muujinaya cidda wacaysa: magaca, cinwaanka, dalabaadkii ugu dambeeyay (oo leh cuntooyinka iyo qiimaha, xitaa kuwa dukaanka online, Thuisbezorgd iyo madallada keenista), wadarta iyo ballan. Qaado dalab keenis ama Qaado dalab la qaadanayo waxay furaan shaashadda keenista oo wax walba horey loo buuxiyay (marka Keenis iyo waqtiyada la shiday); dalabku wuxuu ku xirmaa wicitaanka, ogeysiiskuna wuu ka baxaa dhammaan shaashadaha. Badhanka 📞 ee baarka sare: wicitaannada 24 saac ee ugu dambeeyay. Shaashad kasta waa la damin karaa (Ku muuji ogeysiisyada shaashaddan).

Waxaa laga raadiyaa kaarka macmiilka, dalabaadka keenista iyo la qaadashada ee kaashka, dukaanka online, Thuisbezorgd, madallada keenista iyo ballamaha. Lambarrada waa la mideeyaa (+31 6 1234 5678, 0031612345678 iyo 06-12345678 waa isku mid; xitaa lambarrada Beljimka).

Sida lambarku u yimaado (dhowr hal mar waa suurtagal; isla wicitaanka hal mar ayaa la tiriyaa):

Jawaabtu waxay ka kooban tahay qofka wacaya, sidoo kale sida contact (firstname, lastname, phone, email, address) oo loogu talagalay template CRM ee 3CX. Wicitaannada baxaya iyo kuwa gudaha lama muujiyo; Kaliya khadadkan wuxuu ku koobaa khadad ama aalado gaar ah. Wicitaannada waa la tirtiraa marka muddada kaydintu dhammaato (caadi ahaan 30 maalmood, GDPR). Wicitaan tijaabo wuxuu u dhaqmaa sidii lambar soo wacaya.

Koodh: apps/pos-server/src/lib/telefonie.ts, routes/telefonie.ts, packages/shared/src/telefonie.ts; shaashadaha Telefonie.tsx, BezorgDialoog.tsx; Android android-app/native/java/Beller*.java. Diiwaanka: Taleefan.

Keeniyeyaal gaar ah: safarro, wareejinta lacagta iyo track & trace

Ganacsiyada leh keeniyeyaal gaar ah. Ka shid Dejinta → Ganacsiga → Keenis → Keeniyeyaal gaar ah (caadi ahaan waa dansan yahay). App looma baahna keeniyaha: keeniyuhu wuxuu isticmaalaa bog ku jira browser-ka taleefankiisa (haddii uu doono, wuxuu isticmaali karaa app-ka Optimum Bezorger: eeg App-ka keeniyaha hoose).

Samaynta safar. Khasnadda waxaa ku jira badhanka Safarro (oo leh tirada keenisyada weli baxaya iyo safarrada jidka ku jira).

1. Hoosta Diyaar u ah keenis calaamadee dalabyada raacaya. Kuwani waa dalabyada keeniska ee ka yimid khasnadda, dukaanka online iyo Thuisbezorgd (kaliya adigu keen; kuwa leh keeniye Thuisbezorgd maaha).
2. Dooro keeniyaha (shaqaale) iyo sarrifka raacaya (caadi ahaan qadarka dejinta), kadibna taabo Samee safar.
3. Waxaa soo baxaya QR-kood. Keeniyuhu wuxuu ku iskaanaa taleefankiisa oo cinwaan kasta wuxuu ku arkaa magaca, cinwaanka oo leh badhanka Jid (hagid), Wac, faallada, waqtiga la doonayo iyo waxa la ururinayo. Waxaa jira xisaabiye sarrif (macmiilku wuxuu bixiyaa € 50 → celi € 31,50). Gelid looma baahna. Linkiga la wadaag keeniyaha oo keliya: qof kasta oo haysta wuxuu arkayaa cinwaannada safarkan. QR-kood keeniyaha waxaad ku samaysaa link cusub; kii hore markaas ma shaqeeyo.
4. Taabo Ambabax marka keeniyuhu baxayo. Sarrifku wuxuu ka baxaa khaanadda (lacag bax, oo leh sababta). Macmiilku wuxuu helaa fariin in dalabku jidka ku jiro:
   • dalab khasnadda ka yimid SMS iyo/ama iimayl, haddii Fariimaha macmiilka shidan yihiin (eeg Keenis iyo xilliyo);
   • dukaanka online sida lagu dejiyay dukaanka online (iimayl, SMS ama fariin push);
   • Thuisbezorgd iyada oo loo marayo Thuisbezorgd.

Haddii safarku weli uusan bixin, weli waa la joojin karaa.

1. Jidka, keeniyuhu cinwaan kasta wuxuu taabtaa Waa la keenay, kaash, Waa la keenay, kaar (mashiin kaar oo u gaar ah) ama Waa la keenay (horey ayaa loo bixiyay). Khasnaddu isla markiiba way aragtaa. Haddii keeniyuhu uusan sheegi karin, khasnadda ayaa sidoo kale lagu samayn karaa. Marka uu ku soo laabto ganacsiga, keeniyuhu wuxuu taabtaa Waan ku soo laabtay ganacsiga.

Wareejinta lacagta. Safarka kadib waxaad taabtaa Bixi lacagta (xuquuqda Maamul khaanadda lacagta):

• Dalab kasta waxaad dooranaysaa kaash, kaar albaabka, horey ayaa loo bixiyay ama lama keenin (soo laabtay). Waxa keeniyuhu sheegay hore ayaa loo buuxiyay.
• Khasnaddu dalab kasta oo leh lacag furan waxay xisaabisaa iyada oo aan rasiid cusub la samaynin (macmiilku rasiidka wuu haystaa; dib u daabacid waxaa laga samayn karaa Rasiidyada). Dalab aan la keenin wuxuu ka baxaa safarka oo furan ayuu ahaanayaa, si uu safar xiga u raaco.
• Waxaad arkaysaa waxa la filayo: sarrifka iyo waxa kaash lagu helay. Geli waxa keeniyuhu wareejiyo, ama ku tiri warqad iyo qadaadiic (Ku tiri warqad iyo qadaadiic). Khasnaddu waxay muujinaysaa inuu sax yahay, ama inta ka badan ama ka yar.
• Sarrifku wuxuu ku laabtaa khaanadda (lacag gal). Farqiga waxaa lagu arkaa safarka iyo diiwaanka, sidoo kale wuxuu ka muuqdaa farqiga lacagta ee Warbixinta Z.

Track & trace (si gaar ah ayaa loogu shidaa dejinta). Marka jidka ku jira macmiilku wuxuu helaa link bog raadraac ah oo ku yaal portalka. Linkigaas wuxuu ku jiraa SMS-ka ama iimaylka, iyo bogga xaaladda ee dukaanka online (La soco keeniyahaaga). Bogga raadraaca waxaa ku jira:

• in dalabka la diyaarinayo, jidka ku jiro ama la keenay;
• waqtiga la filayo: laga bilaabo goobta keeniyaha iyada oo la marayo cinwaannada horreeya, haddii kale waqtiga la doonayo;
• inta cinwaan ee ka horreeya (iyada oo aan cinwaanno kale la muujin);
• Keeniyaha si toos ah khariidadda sidoo kale keeniyaha, ganacsiga iyo cinwaankaaga khariidad (OpenStreetMap). Keeniyuhu isagaa ka shidaya wadaagista goobta taleefankiisa (Wadaag goobtayda). Goobta waxaa la diraa kaliya inta boggu furan yahay; boggu shaashadda wuu shidan yahay.

Bogaggu waxay ku qoran yihiin luqadda taleefanka (dhammaan luqadaha portalka). Khasnadda safarka waxaad ku arkaysaa goorta goobta ugu dambaysay la diray (oo leh link khariidadda).

Asturnaanta. Portalku xogta safarka (magacyo, cinwaanno, lambarro taleefan, goobta) wuxuu kaydiyaa kaliya inta safarku socdo. Xisaabinta kadib dhammaan waa la tirtiraa, haddii kale 24 saacadood kadib. Macmiilku wuxuu arkaa dalabkiisa oo keliya. Goobta keeniyaha waxaa la arki karaa kaliya inta safarku socdo, mana muuqato marka keeniyuhu soo laabto.

Qorsheynta safarrada (ikhtiyaari)

Ka shid Dejinta → Ganacsiga → Keenis → Qorsheynta safarrada (caadi ahaan waa dansan tahay; waxay la shaqeysaa keeniyeyaal gaar ah). Daaqadda Safarro waxaa markaas ku jira badhanka Soo jeedi safarro. Khasnaddu waxay dalabyada weli baxaya u isku dartaa safarro:

• dalabyada isku dhow oo waqtiyada la rabo ay ku dhex jiraan daaqadda waqtiga (caadi ahaan 30 daqiiqo) waa wada socdaan;
• ilaa tirada ugu badan ee cinwaan safarkiiba (caadi ahaan 4), inta safarku (tagidda, dhammaan cinwaannada iyo ku noqoshada ganacsiga) aanu ka dheereyn xadka ugu badan (caadi ahaan 45 daqiiqo);
• safar kasta kala horreynta ugu fiican, masaafada (km), waqtiga safarka tag iyo soo noqod iyo cinwaan kasta imaatinka la filayo haddii hadda la ambabaxo. Haddii uu ka dambeeyo waqtiga la rabay, waxaa la qorayaa ka dambeeya waqtigii la codsaday.

Isticmaal safarkan wuxuu calaamadeeyaa dalabyadaas, siday u kala horreeyaan; dooro keeniyaha oo taabo Samee safar. Safar aan weli bixin, Kala horreynta ugu fiican wuxuu cinwaannada u dhigaa siday u kala horreeyaan sida ugu dhakhsaha badan (sidoo kale taleefanka keeniyaha). Safar kasta waxaa ku qoran masaafada iyo waqtiga safarka.

Dejinta: cinwaanno safar kasta, inta uu safar qaadan karo, muddada waqtiga, xawaaraha keeniyaha (baaskiil ~15, mooto ~25, baabuur ~35 km/s magaalada) iyo daqiiqadaha cinwaan kasta (baarkin, garaacidda albaabka, lacag-bixinta; caadi 2). Tirooyinkan maareeyaha ayaa sidoo kale dejin kara: daaqadda Safarro badhanka Deji qorsheynta safarrada (ogolaanshaha Deji qorsheynta safarrada, caadi ahaan u shidan maareeyaha; lagu beddeli karo Dejinta → Ogolaanshaha). Shidista ama damidda qorsheynta safarrada iyo adeegga waddooyinka (cinwaan, furaha API) waxay ku hadhayaan maamulaha.

Masaafada iyo waqtiga safarka, uu doorto maamuluhu:

• Qiyaas (caadi): xariiq toos ah oo lagu dhuftay 1.35 (isku-wareeg) iyo xawaaraha keeniyaha. Wuxuu shaqeeyaa internet la'aan iyo akoon la'aan.
• OSRM: waddooyinka dhulka iyadoo loo marayo server OSRM ah. Geli cinwaanka (https://, ama http:// shabakadda gudaha). Server-ka bandhigga ee dadweynaha (https://router.project-osrm.org) waa mararka qaarkood oo keliya; isticmaal maalinle ah, samee server OSRM ah oo kuu gaar ah ama qaado bixiye.
• OpenRouteService: waddooyinka dhulka oo leh furaha API ee adiga kuu gaar ah (bilaash ayaa looga sameeyaa openrouteservice.org, oo leh xad maalinle ah). Cinwaanku caadi ahaan waa https://api.openrouteservice.org waxaana loo bedeli karaa server kuu gaar ah. Furuhu wuxuu ku harayaa khasnadda; shaashaduhu waxay muujiyaan oo keliya in la geliyay.

Tijaabi ayaad ku tijaabisaa adeegga. Haddii adeeggu shaqeyn waayo, qorsheyntu waxay ku noqotaa qiyaasta wayna sheegtaa. Cinwaan aan goobtiisa la aqoon (koodka boostada iyo lambarka guriga oo sax ah ma laha) wuxuu soo jeedinta ku jiraa goob aan la aqoon lamana qorsheeyo. Dhoofinta dejintu waxay qaadaysaa dejinta, furahase ma qaado.

Koodh: lib/ritplanning.ts.

App-ka keeniyaha (ikhtiyaari)

Ka shid Dejinta → Ganacsiga → Keenis → App-ka keeniyaha (caadi ahaan waa dansan yahay; wuxuu la shaqeeyaa keeniyeyaal gaar ah iyo portalka maamulka). Markaas keeniye kasta wuxuu isku xiraa taleefankiisa hal mar, halkii uu safar kasta QR-code iskaan lahaa:

1. Taleefannada la isku xiray ka dooro keeniyaha (shaqaale), haddii loo baahdo magaca taleefanka, kadibna taabo Isku xir taleefanka.
2. Waxaa soo baxaya QR-code. Keeniyuhu wuxuu ku iskaanaa app-ka Optimum Bezorger (badhanka Isku xir), ama kamarada taleefanka: markaas bogga ayaa ka furmaya browser-ka. Wuxuu shaqeeyaa xitaa app la'aan, waxaana lagu dari karaa shaashadda hore.
3. Isku xirku wuu ansax ahaanayaa ilaa aad ka noqoto; taleefanku isla markiiba waxba ma arki doono. Isku xir cusub oo isla shaqaalaha ah ayaa beddelaya kii hore (tusaale ahaan marka taleefan cusub la helo).

App-ka ama bogga waxaa ku jira dhammaan safarradiisa (safar kasta oo kaashku u sameeyo keeniyahan), oo leh badhamada la midka ah ee safarka: Jid, Wac, lacagta la qaadanayo oo leh xisaabiyaha sarrifka, Waa la keenay iyo Waan ku soo laabtay ganacsiga. Si gaar ah ayaa loo shidi karaa:

• Dalabaad uu isagu qaato: keeniyuhu wuxuu arkaa keenisyada weli safar u baahan, wuxuu calaamadeeyaa waxa uu qaadanayo kadibna wuxuu taabtaa Qaado. Kaashku ayaa sameeya safarka (ama ku dara haddii keeniyahaas uu leeyahay safar aan weli bixin); sarrifka caadiga ah ayaa la raacinayaa. Wixii qof kale horay u qaatay lama qaadan karo.
• Isagu bixi: Bax ee app-ka wuxuu sameeyaa wax la mid ah kaashka (sarrifka khaanadda laga bixiyo, macaamiishuna fariin ayay helaan).
• Khariidad toos ah: Safarro waxaa ku yaal badhanka Khariidad oo leh ganacsiga, dhammaan keeniyeyaasha shaqada ku jira iyo cinwaannada weli la keenayo. Keeniyuhu isagaa shida oo dansiya Shaqada ku jira. App-ku wuxuu gudbiyaa goobta xitaa marka shaashaddu dansan tahay (Android: ogeysiis ku jira bar-ka inta wadaagistu shidan tahay); bogga internetka keliya inta uu furan yahay. Dejintan la'aanteed goobta waxaa la wadaagaa oo keliya inta lagu jiro safar leh track & trace.

App-ka Android wuxuu ku jiraa Google Play iyo bogga soo dejinta ee portalka (/download/). Nooc iPhone ah waa diyaar, laakiin wuxuu imanayaa marka la helo akoon horumariye Apple; ilaa markaas iPhone-yadu waxay isticmaalaan bogga internetka. Safarka uu keeniyuhu isagu qaatay waxaa ku qoran isagu ka qaatay app-ka.

Koodh: lib/bezorgersapp.ts, portalka src/volgen.mjs iyo app-ka ku jira repo-ga horecapos-bezorger.

Diiwaanka waxaa ku qoran cidda samaysay safar, ambabixisay, sheegtay in la keenay iyo xisaabisay, iyo qadarrada. Damin: badhanka Safarro ma jiro; safarrada iyo dejintu waa la kaydinayaa.

Portalka: /bezorger/<sleutel> iyo /volg/<code>. Koodh: lib/bezorgers.ts, routes/bezorgers.ts, Bezorgers.tsx iyo portalka src/volgen.mjs.

Ogeysiis waqti diyaarin dheer

Dalab qaadasho ama keenis oo diyaar noqda waqtiga la ballanqaaday ka dib: kaashku wuu arkaa oo ogeysiiyaa, isla markaana macmiilka u diri karaa raalligelin, haddii loo baahdo iyo foojar magdhow. Ka shid Dejinta → Ganacsiga → Keenis → Ogeysiis waqti diyaarin dheer (caadi ahaan waa dansan yahay).

• Dalabyada kee: qaadasho iyo keenis leh waqti la ballanqaaday, kaashka (keenis iyo xilliyada waqtiga), dukaanka online-ka iyo Thuisbezorgd.nl / Takeaway.com.
• Daahay: inta daqiiqo (caadi ahaan 10) ka dib waqtiga la ballanqaaday oo weli aan diyaar ama jidka ku jirin. Diyaar ama jidka ku jira waa: wax walba diyaar shaashadda jikada, xaaladda diyaar ama jidka ku jira ee dukaanka online-ka ama Thuisbezorgd, farriinta ✉ Diyaar / ✉ Jidka ku jira ee macmiilka, ama la bixiyay. Kaashku daqiiqad kasta ayuu hubiyaa.
• Ogeysiis: badhanka Daahay ee bararka sare oo wata tirada (cod marka mid cusub yimaado), dalab kasta waqtiga la ballanqaaday iyo inta daqiiqo uu daahay. Dalab wuu iska baaba'aa marka uu diyaar ama jidka ku jiro, ama La xalliyay; hoostooda waxaa ku jira kuwii 24-kii saac ee la soo dhaafay, iyo goorta ay diyaar noqdeen. Wax walba waxay ku jiraan diiwaanka.
• Dukaan online: bogga xaaladda ee martida wuxuu muujiyaa in ay dheeraanayso, iyo waqtiga cusub ee la filayo.
• Thuisbezorgd taas lama samayn karo (macmiilku wuxuu ka tirsan yahay Thuisbezorgd): halkaas ogeysiiska oo kaliya. Qoraal gaar ah waa suurtagal; {naam}, {zaak}, {code}, {korting} iyo {geldig} waa la buuxiyaa.
• Foojar magdhow (oo kaliya marka Koodhadhka qiimo-dhimista shidan yihiin): raalligelinta waxaa la socda kood qiimo-dhimis shakhsi ah oo loogu talagalay dalabka xiga (tusaale SORRY-7K4Q2M), lacag ama boqolkiiba, hal mar la isticmaalo, inta maalmood ansax ah, kaashka iyo dukaanka online-ka. Koodhadhku kuma jiraan liiska Koodhadhka qiimo-dhimista. Haddii dirista guuldarreysato, koodhku wuu dhacayaa. Badhanka kaashka oo kaliya xuquuqda Sii qiimo-dhimis.
• Dansan: ogeysiisyada iyo koodhadhka la bixiyay waa la kaydiyaa (sidoo kale kaydka nuqulka); dejintu waxay la socotaa dhoofinta habaynta.

Kood: lib/telaat.ts, routes/telaat.ts, TeLaat.tsx iyo packages/shared/src/telaat.ts.

Badhanka Dalbo: waxa uu qabto iyo goorta aad u baahan tahay

Taabashada alaab iyo taabashada Dalbo waa laba tallaabo oo kala duwan:

• Taabashadu isla markiiba alaabta waxay ku dartaa biilka (liiska bidixda), iyadoo ah cusub. Adiga keliya ayaa arka: jikada iyo baarku weli waxba kama oga. Saf cusub waa qabyo: weli si caadi ah ayaad uga saari kartaa, ama u beddeli kartaa tirada ama doorashooyinka, storno la'aan.
• Dalbo wuxuu hal mar u diraa dhammaan safafka cusub: warqadaha shaqadu waxay aadaan daabacayaasha jikada iyo baarka (iyo shaashadda jikada), kadibna safafku waxay noqdaan la dalbaday. Markaas saarista waxaa lagu samayn karaa oo keliya Storno (ogolaanshaha storno). Badhanka waxaa ku qoran inta saf ee cusub ee diyaar ah, tusaale Dalbo (3); haddii aanay jirin saf cusub, badhanku waa cawl.

Maxay laba tallaabo u yihiin? Miiska agtiisa waxaad ka qaadataa dalabka oo dhan (cabitaanno, cunto bilow, cunto weyn), wax baad ka beddeshaa haddii martidu fikirka beddesho, kadibna hal mar ayaad u dirtaa jikada, iyadoo hal warqad loo diro saldhig kasta halkii alaab kasta warqad loo diri lahaa. Sidaas jikadu waxay bilaabi kartaa muddo dheer ka hor inta aan lacag la bixin.

Waxa kale ee dhaca marka la riixo Dalbo:

• Koorsooyinka: koorsada 1 isla markiiba waxay aadaa jikada; koorsooyinka 2, 3 iyo 4 waxay u socdaan sidii SUG, jikaduna waxay bilaabaysaa oo keliya marka aad koorsadaas u yeerto (eeg Koorsooyinka).
• Wareegyada: mar kasta oo Dalbo la riixo waa hal wareeg; taas ayuu ku shaqeeyaa ↻ Wareeg kale.
• Kaydka waa la dhimaa, tuubada cabitaanka ee la qiyaasayna waa la furaa.
• All-you-can-eat: haddii ay aad u badan tahay, ay goor hore tahay ama ay goor dambe tahay qorshaha, kaashku marka hore wuxuu weydiinayaa in weli la oggol yahay.
• Beljiyam (GKS 2.0): safafku marka hore waxay u socdaan sidii pro forma sanduuqa madow; haddii taasi guuldarraysato, waxba uma tagaan jikada, waxayna sii ahaanayaan cusub.
• Xiriir ma jiro: dalabka waa la kaydiyaa wuxuuna aadayaa jikada isla marka xiriirku soo laabto. Daabacaha waa demisan yahay: dalabku wuu socdaa, warqadda shaqadu waxay gashaa safka daabacaadda (eeg Daabacaha jikada waa demisan yahay ama ma jiro shaashad jiko).

Toos ayaad sidoo kale lacagta u bixin kartaa. Haddii aad taabato Bixi lacagta iyadoo biilka weli ay ku jiraan safaf cusub, kaashku marka hore si toos ah ayuu u dalbadaa, si jikada iyo baarku had iyo jeer u helaan warqaddooda. Baarka ama qaadashada (take-away) looma baahna inaad marka hore taabato Dalbo: taabo alaabta oo isla markiiba Bixi lacagta. Haddii dalbashadaas tooska ahi guuldarraysato (xiriir la'aan, saf all-you-can-eat, sanduuqa madow), shaashadda lacag bixintu way xirnaanaysaa waxaadna arkaysaa sababta.

Ma doonaysaa in baarku uusan helin rasiid marka aad isla markiiba lacagta qaaddo? Gal Dejinta → Ganacsiga → Dalbasho iyo lacag-bixin oo calaamadee Lacag-bixin toos ah oo aan warqad shaqo lahayn. Markaas waxa kaliya ee jikada iyo baarka loo diro waa waxa aad ku dirto Dalbo; waxa aad isla markiiba lacagta ka qaaddo ma helo warqad shaqo.

Badhanka Bixi lacagta oo weyn ama yar

Marka la calaamadiyo Badhanka weyn ee "Bixi lacagta", shaashadda dalabka waxaa isla hoosta alaabta la dalbaday ku yaal badhan weyn oo Bixi lacagta ah: ballaaran, dheer oo lacagta ku qoran, si dhakhso loo riixo. Haddii qayb biilka ah horay loo bixiyay, badhanku wuxuu muujiyaa lacagta harsan. Badhanka yar ee hoose agtiisa Dalbo markaas wuu baxayaa.

Marka badhanka weyn la shido, badhamada shaashadda lacag-bixinta sidoo kale waa waaweyn yihiin: Bixi lacagta (Kaar, Kaarka hadiyadda iyo hababka kale ee lacag bixinta) iyo Kaash-ka Lacag sax ah iyo Bixi lacagta waa ballaaran yihiin oo dheer yihiin, si fudud ayaa loo riixi karaa, xitaa faraha wasakhaysan (tusaale ahaan hilib-iibiye). Hababka lacag bixinta waa yara waaweyn yihiin, badhamada baqshiishkuna waa yara yar yihiin, si wax walba shaashadda ugu jiraan.

Rakibaad cusub, calaamaddu waa dansan tahay: markaas badhanka yar ee hoose ee ku ag yaal Dalbo iyo shaashad lacag-bixin oo leh badhamo caadi ah. Ma door bidaysaa mid weyn? Gudaha Dejinta → Ganacsiga, si toos ah hoosta mawduuca iftiinka/mugdiga, calaamadi Badhanka weyn ee "Bixi lacagta". Kashiir horay loo isticmaalayay wuxuu haynayaa wixii uu lahaa. Doorashadu waxay khusaysaa dhammaan kashiirada iyo tablet-yada ganacsiga.

Alaab u calaamadee "dhammaatay" (la iibiyay oo dhan)

Qof kasta shaashadda dalabka wuu riixi karaa oo hayn karaa alaab (ama badhanka midig ee jiirka ku riixi karaa) kadibna dooran karaa Dhammaatay. Alaabtu markaas waxay noqonaysaa cawl, kaashyada oo dhanna lagama dalban karo. Sidaas oo kale ayaad dib ugu celin kartaa Mar kale waa la heli karaa. Beddel kasta wuxuu ku qoran yahay diiwaanka. Maamuluhu weli wuu ka samayn karaa Dejinta → Alaabta. Server-ka kaashka sidoo kale wuu diidaa alaab loo calaamadeeyay "dhammaatay" ("Cola" waa dhammaatay), xitaa haddii ay ka timaado tablet aan weli helin beddelka ama dalabyo offline lagu kaydiyay; tablet-kaasi markaas wuxuu muujinayaa "Lama diri karin".

Shaashadda jikada (KDS)

Daabacayaasha warqadaha jikada agtooda (ma aha beddelkooda), jikada ama baarku waxay isticmaali karaan shaashad. Tablet/kombiyuutar jikada ku jira ka fur http://<kassaserver>:3000/keuken, ku gal PIN, kadibna dooro goobta: waa magacyada daabacayaasha oo kale (jikada, baarka, ...), sidaa darteed shaashadda waxaa ku qoran wixii saxda ah ee warqaddaas jikada ku qormi lahaa. "Dhammaan" wuxuu muujinayaa goobaha oo dhan.

• Dalab kasta hal warqad, kan ugu da'da weyn marka hore, oo leh miiska/qaadashada, lambarka iyo inta uu sugayay (oranji 10 kadib, casaan 20 daqiiqo kadib).
• Koorsooyinku si gooni ah ayay u qoran yihiin; koorso aan weli loo yeerin waa cawl oo waxaa ku qoran "WAA SUGAYAA u yeerid". Baajimaha waxaa lagu dul xarriiqay.
• Taabo saf si aad diyaar ugu calaamadayso, ama Diyaar warqadda oo dhan. Adeegayaasha markaas xarriiqda sare waxay ku arkaan "Jikada: Miiska 5 waa diyaar". Dejinta → Ganacsiga → Shaashadda jikada → Codka adeegayaasha (caadi ahaan waa dansan) kaashku sidoo kale wuu dhawaaqaa ("ding-dong", fayl cod la'aan). Browser-ku codka wuxuu oggolaadaa oo kaliya taabashada ugu horraysa ee shaashadda kadib; kor u qaad codka tablet-ka.
• Soo celi wuxuu muujinayaa wixii saacaddii ugu dambaysay diyaar loo calaamadeeyay, sidaas wixii si qalad ah loo taabtay dib ayaa loo soo celin karaa.

Shaashaddu isla markiiba way is cusboonaysiisaa. Warqadaha jikada si caadi ah ayay u sii daabacmayaan; qofka aan shaashadda isticmaalin waxba ma dareemayo.

Shaashadda jikada: u dirid, kala horreyn iyo koorso

Dejinta → Daabacayaasha → Shaashadda jikada. Qayb kasta si gooni ah ayaa loo shidaa, si caadi ah waa dansan tahay; damintu wax walba way kaydisaa.

• U dirid goobaha dhexdooda, tusaale qabow → kulul → bixinta. Goob kasta waxaad u dejisaa goob xigta oo go'an; warqadda waxaa markaas ku jira badhanka → kulul (iyo mar walba U dir… si aad u doorato goob kale). Kaliya safafka furan ee goobtaas ayaa raaca. Goobtu uma baahna daabace: goobaha sida bixinta ku qor Goobo aan daabace lahayn. Diyaar (iyo ogeysiiska adeegaha) waxay timaadaa oo kaliya goobta ugu dambeysa. Gudaha "Dhammaan" safka la diray agtiisa waxaa ku qoran halka uu hadda joogo. Tallaabo kasta waxay ku qoran tahay safka agtiisa iyo diiwaanka.
• Dib u habayn: jiid warqadaha (jiirka) ama ku dhaqaaji ◀ ▶ (shaashadda taabashada). Kala horreyntu waxay khusaysaa goob kasta iyo dhammaan shaashadaha goobtaas; warqadaha cusub waxay yimaadaan dhammaadka.
• Koorsada xigta laga bilaabo shaashadda jikada: warqad leh koorso sugaysa waxaa ku jira Codso koorsada 2. Adeeguhu markaas wuxuu helayaa "Jikadu waxay codsanaysaa koorsada 2 ee Miiska 5" (cod leh) wuxuuna u yeeraa sida caadiga ah; shaashadda jikada waxaa ku qoran "Koorsada 2 waa la codsaday · n daq" ilaa koorsada loo yeero. Ama dooro U yeer: markaas shaashadda jikada ayaa iskeed ugu yeerta koorsada, iyadoo leh warqadda shaqada "U YEERIDDA KOORSADA 2", sida badhanka khasnadda.

Daabacaha jikada oo dansan ama shaashad jiko la'aan

Kaashku had iyo jeer wuu sii shaqeeyaa, xitaa haddii daabacaha jikada ama baarka uu dansan yahay (ama warqaddu dhammaatay, ama fiilada ay furan tahay) iyo xitaa shaashad jikada la'aan:

• Dalbashadu had iyo jeer way socotaa. Safafku isla markiiba waxay noqonayaan la dalbaday, biilku waa sax, xisaabintuna si caadi ah ayay u shaqaysaa. Daabacayaasha hal mar ayaa loo wada diraa, daabace kastana ugu badnaan qiyaastii 4 ilbiriqsi ayuu helaa: daabace dansan ma sugsiiyo kuwa kale (ama adeegayaasha) muddo dheer.
• Safka daabacaadda. Warqad jikada oo aan la daabici karin waxay gashaa safka daabacaadda. Server-ka kaashka wuxuu isku dayaa mar kale 30 ilbiriqsi kasta, muddo rubuc saac ah; isla marka daabacuhu dib u shaqeeyo way soo baxdaa, iyadoo korka ku qoran tahay GOOR DAMBE LA DAABACAY. Haddii warqad xigta oo daabacahaas ah ay guulaysato, warqadaha sugaya isla markiiba way daba socdaan.
• Rubuc saac kadib isku daygii tooska ahaa wuu istaagaa; Hadda dib u daabac weli waa la isticmaali karaa.
• Shaashadda jikada. Haddii dalabku ku jiro shaashadda jikada, jikadu halkaas ayay ku arkaysaa xitaa haddii daabacuhu dansan yahay. Qofka aan isticmaalin shaashadda jikada waxba kama dhumaan: kaashku meelna kuma sugo "Diyaar" jikada.
• Safku wuxuu ku jiraa oo kaliya xusuusta server-ka kaashka (dib u kicin kadib wuu madhan yahay).
• Rasiidka kaashka sidoo kale: haddii uu guuldareysto, xisaabintu way dhammaatay (kaashku wuxuu sheegayaa "daabacaaddu way guuldareysatay"), kadibna waxaad Rasiidyada ka daabici kartaa nuqul.

Koorsooyin (cuntada hore, cuntada ugu weyn ...)

Badhamada koorsada waxaa la muujiyaa oo keliya marka loo baahdo: isla marka uu menu (alaab isku-dhafan) ku jiro dalabka, ama marka wax horey ugu jiraan koorsada 2 ilaa 4. Alaabta caadiga ah, sida kola, ma aragtid, wax walbana isla markiiba jikada ayay u socdaan. Ma jiraan wax la dejiyo.

Liiska dalabka hoostiisa waxaa ku yaal Koorso 1 2 3 4. Caadi ahaan koorsada 1 ayaa shidan, wax walbana sidii caadiga ahayd ayay u shaqeeyaan: "Dalbo" wax walba isla markiiba jikada ayuu u diraa, cinwaanno koorso la'aan warqadda jikada. Haddii aad doorato koorsada 2 (ama ka sarreysa) ka hor intaadan alaabta taaban, markaas:

• "Dalbo" marka la taabto way u baxayaan jikada, iyagoo ku hoos qoran "-- Koorso 2 · WAA SUGAYAA u yeerid --", si jikadu u diyaarin karto;
• liiska dalabka waxaa ku qoran "Koorso 2 · sugaya" oo leh badhanka U yeer;
• marka U yeer la taabto jikadu waxay helaysaa warqad " U YEERID KOORSO 2 " oo leh waxa hadda la samaynayo.

Koorsada 1 had iyo jeer isla markiiba way baxdaa. Haddii koorsada 2 horay loogu yeeray, cunto dambe lagu dalbaday koorsada 2 sidoo kale isla markiiba way baxdaa.

Xasaasiyadda alaab kasta

Caadi ahaan waa dansan: markaas xasaasiyadda meelna kama muuqato. Ka shid Dejinta → Ganacsiga → Geli oo muuji xasaasiyadda alaab kasta.

• Dejinta → Alaabta: alaab kasta ku calaamadee 14-ka xasaasiyadood ee EU (gluten, qolofleyda badda, ukunta, kalluunka, lawska, soya, caanaha, lowska geedaha, celery, khardal, sisin, sulfiit, lupine, nafleyda jilicsan). Liiska alaabta, soo gaabinta ayaa magaca ka dambaysa.
• Shaashadda dalabka: badhan alaab kasta waxaa ku qoran soo gaabinta oo yar (tusaale Gl Me), badhanka ⚠ Xasaasiyadda ee xarriiqda kooxaha wuxuu si buuxda u muujiyaa xasaasiyadda alaab kasta ee kooxda la doortay, iyo sharraxaadda soo gaabinta.
• Beddelka xasaasiyadda wuxuu galaa diiwaanka (hore → cusub). Haddii dejintu dansan tahay, xasaasiyaddii horay loo geliyay way kaydsanaanaysaa.

All-you-can-eat

Caadi ahaan waa dansan. Ka shid Dejinta → Ganacsiga → All-you-can-eat (maamulaha oo keliya). Waxaad samaynaysaa hal ama dhowr xirmo, tusaale Kalluun, Hilib iyo Sushi, mid walbana leh:

• magac (wuxuu ku qormayaa rasiidka: "Kalluun qof weyn", "Kalluun ilmo");
• qiimo qofka weyn iyo ilmaha (VAT ku jira) iyo heerka VAT (caadi ahaan NL LAAG, BE B);
• cuntooyinka ku jira (€ 0): kooxo alaab oo dhan iyo/ama alaab gaar ah (xitaa kooxo kale, tusaale baradho shiilan oo ku jirta Kalluunka iyo Hilibkaba);
• xad waqti daqiiqado ah (0 = midna);
• wareegyo: ugu badnaan inta cunto qof kasta wareeg kasta (0 = xad la'aan) iyo ugu yaraan inta daqiiqo u dhexeeya laba wareeg (0 = midna);
• lacagta khasaaraha xabbad kasta (0 = midna).

↑ ↓ ayaad ku dejinaysaa kala horreynta. Waxay muhiim tahay marka cunto ka mid tahay dhowr xirmo: markaas waxay u xisaabtamaysaa xirmada ugu sarraysa ee kooxdu dooratay. Tirtir wuxuu xirmo ka saaraa miisaska cusub; miisaska socda waxay haystaan safafkooda qiimaha (dad ka yar halkaas waa suurtagal, ka badan maaha).

Miiska:

• Shaashadda dalbashada, korka rasiidka waxaa ku yaal + All-you-can-eat. Xirmo kasta u dooro tirada dadka waaweyn iyo carruurta; isku-darku waa la oggol yahay (tusaale 2× Kalluun iyo 2× Hilib). Qiimuhu wuxuu biilka ku soo galaa sida safaf; kuwaasi ma aadaan jikada. Tirada dadka kooxdu waxay noqonaysaa wadarta ka qaybgalaysa (haddii khasnaddu diiwaangeliso tirada dadka).
• Xarriiqdu xirmo kasta waxay muujinaysaa: dadka, waqtiga haray (casaan marka waqtigu dhammaado), wareegga uu yahay iyo ugu badnaantiisa, iyo inta ka hartay wareegga xiga. Cuntooyinka ku jira badhamada waxaa ku qoran AYCE, rasiidkana waxay ku qoran yihiin calaamadda AYCE oo € 0 ah. Wax kasta oo aan ku jirin xirmo la doortay (cabbitaan, macmacaan ...) si caadi ah ayaa lacag loogu qaadaa.
• Dalbo: mar kasta oo "Dalbo" la taabto oo ay ku jiraan cuntooyin bilaash ah waa wareeg, xirmo kasta (oo kaliya xirmooyinka ay cuntooyinkoodu ku jiraan). Wixii offline lagu taabtay oo goor dambe la diray lama joojiyo.
• Beddel: wax ka beddel tirooyinka xirmo kasta. Dad ka yar waxay u xisaabtamaysaa baajin (oggolaanshaha "baajin"). Xirmo in la dhigo 0 (ama Jooji wax walba) waa suurtagal inta aysan biilka weli ku jirin cuntooyin xirmadaas ka mid ah.
• Lacag dheeraad ah (oo kaliya haddii xirmo la doortay ay leedahay lacagta khasaaraha): dooro tirada (iyo xirmada, haddii ay dhowr jiraan); "Lacagta khasaaraha × tirada" ayaa biilka galaysa.
• Xisaabinta, kala qaybinta, qiimo-dhimista iyo rasiidku sidii caadiga ahayd ayay u shaqeeyaan: qiimayaasha xirmada, lacagta dheeraadka ah iyo cabbitaanku waa safaf caadi ah oo leh VAT-kooda.
• Haddii maamuluhu demiyo all-you-can-eat inta kooxo ay socdaan, cuntooyinka cusub ee la taabto mar kale waxay qaadanayaan qiimaha caadiga ah; wixii horay biilka ugu jiray way sii jirayaan.
• Dukaanka online (ikhtiyaari, caadi ahaan waa dansan): marka Sidoo kale marka miiska laga dalbado koodhka QR (dukaanka online) shidan yahay, martida ka dalbata miis ay xirmo ku socoto waxay arkaysaa cuntooyinka xirmada oo ah Ku jira € 0, korkana xaaladda (dadka, wareegga, waqtiga). Dalab kastaa waa wareeg, isla xeerarka Dalbo; wax aad u badan, aad u hore ama aad u daahay, dukaanka online isla markiiba wuu diidaa. Cabitaannada iyo cuntooyinka kale martidu si caadi ah ayay u bixisaa; wax walba waxay galaan biilka miiska. Dansan = dukaanka online wuxuu xisaabiyaa qiimaha caadiga ah, sidii hore.

Kaararka hadiyadda

Laba furaha oo ku jira Dejinta → Ganacsiga → Kaararka hadiyadda:

• Kaarka hadiyadda oo ah hab lacag bixin marka la xisaabinayo: caadi ahaan waa shidan, sidii had iyo jeer ahayd. Dansan = badhanka Kaarka hadiyadda kama muuqdo xisaabinta (iyo lacag celin iyadoo loo marayo marka wax la soo celiyo), server-ka kaashkuna wuu diidaa in kaarka hadiyadda lagu bixiyo.
• Iibi kaararka hadiyadda ee haraaga leh: caadi ahaan waa dansan. Shidan:
  • Shaashadda dalabka waxaa ku yaal badhanka Kaarka hadiyadda: dooro lacagta (€ 10, 25, 50, 100 ama lacag kale) oo kaashka u daa inuu koodh sameeyo, ama sawir koodhka kaar horay loo daabacay. Kaarka hadiyaddu wuxuu biilka ku galaa saf ahaan (koodhka VAT BON: dakhli ma aha, VAT ma leh, jikada uma baxo). Halkaas sidoo kale waxaad macmiilka u eegi kartaa haraaga.
  • Xisaabinta kadib kaarka hadiyaddu waa firfircoon yahay, daabacaha rasiidkuna wuxuu daabacaa kaar hadiyad oo leh lacagta, koodhka iyo koodh QR.
  • Isticmaalid: marka la xisaabinayo dooro Kaarka hadiyadda oo sawir ama qor koodhka (badhanka Haraaga wuxuu muujiyaa haraaga). Lacagta waxaa laga jarayaa haraaga. Haddii haraagu ka yar yahay biilka, haraaga oo dhan waxaa loo isticmaalayaa lacag bixin qayb ah, inta kalena waxaad ku bixinaysaa kaar ama kaash. Haraaga qaybo ayaa loo isticmaali karaa.
  • Koodhka madhan u daa = kaar hadiyad koodh la'aan ah, sidii hore (tusaale kaar warqad ah oo duug ah).
  • Warbixin → Kaararka hadiyadda (oggolaanshaha Maamul kaararka hadiyadda, caadi ahaan maareeyaha iyo maamulaha): ku raadi koodh, haraaga furan, taariikhda kaar kasta, xannib (lumay/la xaday) iyo sax haraaga adigoo sabab sheegaya. Tani waxay gashaa diiwaanka.
  • Warbixinnada: kaararka hadiyadda ee la iibiyay uma xisaabtamaan dakhli, waxayna ku qoran yihiin si gooni ah (Kaararka hadiyadda ee la iibiyay); lacagta la helay se waxay ku jirtaa hababka lacag bixinta. Wixii lagu bixiyo kaarka hadiyadda waa dakhli caadi ah (VAT leh) oo ku jira habka lacag bixinta Kaarka hadiyadda.
  • Xisaabaadka: kaararka la iibiyay waxay galaan credit, kaararka la isticmaalayna debit xisaabta Kaararka hadiyadda (lacagta macaamiisha ee kaydsan).
  • Kaar hadiyad oo la iibiyay waxaa lagu soo celin karaa Rasiidyada → Soo celin, inta aan weli la isticmaalin (haraaga = qiimaha). Soo celinta kadib kaarka waa la buriyay (haraaga 0, waa xannibban yahay; wuxuu ku qoran yahay taariikhda kaarka). Haddii horay (qayb ahaan) loo isticmaalay, haraaga u dhig 0 Warbixin → Kaararka hadiyadda, inta hartayna si gooni ah dib ugu celi. Qiimo-dhimis kaarka hadiyadda laguma samayn karo.

Haraa la shuban karo (ikhtiyaari)

Naadiyada, maqaayadaha isboortiga, xarumaha dhallinyarada iyo munaasabadaha: kaarka hadiyadda ee haraaga leh wuxuu noqdaa kaar la shuban karo. Waxaa laga shidaa Dejinta → Ganacsiga → Haraa la shuban karo, kaararka hadiyadda hoostooda (caadi ahaan waa dansan; wuxuu shaqeeyaa kaliya marka Iibi kaararka hadiyadda ee haraaga leh shidan yahay).

• Kaar ama jijin gacan: iibi kaarka hadiyadda oo leh Kaar horay loo daabacay oo sawir kaarka (akhriye NFC/RFID oo u shaqeeya sida kiiboodh, ama barcode). Lambarka kaarka ayaa markaas noqda koodhka; martidu waxay ku bixisaa sida kaarka hadiyadda.
• Ku shubid: shaashadda dalabka → Kaarka hadiyadda → Ku shub haraaga: sawir kaarka hadiyadda ama kaarka oo geli lacagta. Waxay biilka ugu dhacdaa sadar ahaan (koodhka canshuurta BON: dakhli ma aha, canshuur ma leh, sida kaarka hadiyadda la iibiyay), lacag bixinta kadibna waxay ku jirtaa haraaga. Taariikhda kaarka waxaa ku qoran La shubay.
• Haraaga ugu badan ee kaarka hadiyadda ama kaarka (caadi ahaan € 500, waxaa la dejin karaa ilaa € 5.000).
• Celi haraaga hadhay (calaamad, caadi ahaan dansan; xuquuqda Maamul khaanadda lacagta): Hubi haraaga kadib waxaa jira Celi haraaga hadhay. Haraagu wuxuu noqdaa € 0, lacagtuna warbixinta X iyo Z waxay ugu qorantahay lacag khaanadda laga saaray (Haraa la celiyay …).
• Ku shubidda waxaa lagu celin karaa Rasiidyada → Celin inta haraagu weli yahay ugu yaraan lacagtaas; kaarka hadiyadda ama kaarku wuu ansax ahaanayaa.
• Ku shubid kiosk-ga (ikhtiyaari): eeg Kiosk is-adeeg ah.

Jeegagga cuntada

Kaliya ganacsiyada Beljiyam, caadi ahaan dansan: Dejinta → Ganacsiga → Bixi lacagta → Jeegagga cuntada. Jeegagga cuntada waa faa'iido mushahar: loo-shaqeeyuhu wuxuu ku shubaa kaarka shaqaalaha (Edenred, Monizze ama Pluxee). Martidu waxay ku bixisaa mashiinka kaarka ee caadiga ah; looma baahna xiriir lala sameeyo bixiyeyaasha.

• Shidan: marka lacagta la bixinayo waxaa jira badhanka Jeegga cuntada. Dooro bixiyaha (kaliya bixiyeyaasha ganacsigu aqbalo) oo martida ha u qabato kaarka mashiinka kaarka, sida marka kaar lagu bixinayo. Haddii aan mashiinka kaarka lagu xirin: martidu waxay ku bixisaa mashiinka kaarka laftiisa, adiguna waxaad taabataa Bixi lacagta.
• Baqshiish iyo baaqi midna ma jiro marka jeegagga cuntada la isticmaalo. Haddii haraagu yar yahay, martidu inta kale si kale ayay u bixisaa (biilku furan ayuu ahaanayaa ilaa wax walba la bixiyo).
• Kaliya kooxo alaab oo gaar ah (ikhtiyaari, tusaale cunto laakiin aan aalkolo ahayn): markaas jeegagga cuntada waxaa lagu bixin karaa ugu badnaan qiimaha alaabtaas ee biilka. Shaashadda lacag bixintu waxay sheegaysaa inta; inta kale martidu si kale ayay u bixisaa.
• Rasiidka: Jeegga cuntada Pluxee (bixiyaha gadaashiisa).
• Warbixinta Z iyo warbixinta X: bixiye kasta sadar u gaar ah (Jeegga cuntada Edenred, … Monizze, … Pluxee).
• Xisaabaadka: bixiye kasta xisaab buugga weyn oo u gaar ah (Jeegagga cuntada Pluxee (la helayo) iwm., caadi ahaan 416100, 416200 iyo 416300), maxaa yeelay lacagtu waxay ka timaadaa bixiyaha, kamana timaado bangiga mashiinka kaarka.
• Loo baahan yahay: heshiis lala galo bixiye kasta oo aad jeegagiisa aqbasho, iyo mashiinka kaarka oo aqbala kaararkan (ka hubi alaab-qeybiyaha mashiinka kaarka).

Lacag qalaad

Kaash ku bixi lacag kale, tusaale dalxiisayaal Ingiriis ama Mareykan ah, ama gobolka xuduudda oo lagu bixiyo faranka Swiss-ka. Caadi ahaan waa dansan: Dejinta → Ganacsiga → Bixi lacagta → Lacag qalaad. Ku dar noocyada lacagta (CHF, CZK, DKK, GBP, HUF, NOK, PLN, SEK, TRY, USD) oo mid kasta leh sicir: inta euro aad ku xisaabiso 1 unug (tusaale 1 GBP = € 1,15).

• Gacanta lagu geliyay: sicir go'an; adigu beddel marka uu isbeddelo.
• Toos (ECB): sicirka maalinlaha ah ee Bangiga Dhexe ee Yurub (sicirro tixraac ah, maalin kasta oo shaqo qiyaastii 16:00; bilaash, akoon looma baahna). Marka la raaciyo dheeraad boqolley ah (0-20) sicirku intaas ayuu hoos u dhacaa, si ganacsigu uusan isagu u bixin kharashka sarrifka. Kaashku sicirrada isagaa soo qaada haddii ay ka da' weyn yihiin 6 saacadood; Hadda cusboonaysii isla markiiba ayay soo qaadaa. Internet la'aan sicirkii ugu dambeeyay ayaa sii jira.
• Shidan: marka lacagta la bixinayo waxaa jira badhanka Lacag qalaad. Dooro nooca lacagta; kaashku wuxuu muujiyaa inta ay tahay lacagtaas. Geli inta martidu bixiso: kaashku wuu beddelaa oo wuxuu bixiyaa sarrifka euro ahaan. Haddii martidu aysan waxba dib u rabin, calaamadee Sarrifku waa baqshiish: sarrifku wuxuu rasiidka ugu jiraa baqshiish ahaan, Beljamka lacagtaas (GKS 2.0, UC296).
• Haddii martidu bixiso wax ka yar lacagta oo dhan, waa qayb; inta kale si kale ayay u bixisaa.
• Rasiidka: nooca lacagta, lacagta iyo sicirka, iyo sarrifka euro ahaan.
• Warbixinta X iyo Z: nooc lacag kasta sadar u gaar ah (Lacag qalaad GBP, euro ahaan), khaanadda lacagtana inta nooca lacagtaas khaanadda ku jirta. Sarrifka euro waxaa laga jaraa lacagta la filayo ee khaanadda; lacagaha qalaad adigu si gooni ah u tiri.
• Xisaabaadka: waxaa loo tiriyaa kaash (sanduuqa), euro ahaan.

Badhamo dheeraad ah marka la dalbanayo iyo marka lacagta la bixinayo

Badhamo loogu talagalay waxa aan ganacsi kastaa u baahnayn. Dhammaan waa dansan yihiin asal ahaan; shid badhan kasta Dejinta → Ganacsiga → Dalbasho iyo lacag-bixin (xuquuqda Deji ganacsiga, lacag-bixinta iyo daabacayaasha). Dansan = badhanku meelna kuma jiro kashiirka, server-ka kashiirkuna wuu diidaa ficilka. Nederland wax walba waxay ku shaqeeyaan sanduuqa madow la'aan; Beljamka badhanku wuxuu shaqeeyaa oo keliya marka shaqadaas lagu tijaabiyay sanduuqa madow (badhanka ayaa lagu qoraa haddii aan weli sidaas ahayn).

Marka miis la furayo:

• Diiwaangeli tirada dadka: su'aasha "Immisa qof?" ee miis bannaan, dadka ku jira khariidadda miisaska iyo shaashadda dalbashada, iyo martida ku jirta warbixinada. Eeg Tirada dadka.

Marka la dalbanayo (shaashadda dalabka, waxa aad taabato kadib):

• Isku-darka alaabooyinka isku midka ah (badhan la'aan, si caadi ah daaran): haddii aad mar kale taabato isla alaabta (isla doorashooyinka, aan weli la dalban), tirada ayaa korodha halkii saf cusub laga samayn lahaa: 4 Cola hal saf ah oo qiimaha lagu dhuftay 4. − ayaa mid mar kale ka jaraysa, xitaa haddii horay loo dalbaday (storno hal mid ah). Haddii ay leedahay faallo, kursi ama qaadasho, waxay ahaanaysaa saf gaar ah; waxa horay loo dalbaday wuxuu ahaanayaa saf gaar ah (wareeg cusub).
• − iyo + (qiimaha hortiisa sadar kasta): − mid ayuu ka jaraa, + mid ayuu ku daraa (isla alaab, doorashooyin iyo qoraal; haddii Isku-darka alaabooyinka isku midka ah uu dansan yahay, sadar cusub). Weli lama dalban oo wuxuu joogaa 0: sadarku wuu baxaa. Horay ayaa loo dalbaday: mid ka jarid waa storno, sadarkaas wuxuu sii ahaanayaa mid la xarriiqay (jikada iyo warbixinnada awgood); mid ku darid wuxuu noqonayaa sadar cusub oo weli la dalban doono. Taabashada qiimaha laftiisa waxba kama saarto mar dambe. Menu-ga kaliya −.
• Qaado (kaliya halkan lagu cuno): martidu way qaadataa alaabtan, tusaale dhalo biyo ah ama macmacaan. Safkaas wuxuu helaa VAT-ka qaadashada (Beljamka summadda C), inta kale ee biilka VAT-ka halkan lagu cuno. Rasiidka safka waxaa ku qoran qaado.
• Kursi (miis): taabo sii wad kursiga 1, 2, 3 ...; safafku waxay helaan lambarkaas kursiga (xataa warqadda jikada). Beljamka saf kasta wuxuu sanduuqa madow ugu socdaa xarunta kharashka ee kursiga (CHAIR, UC4123). Mar kale kursiga 12 kadib = mar kale kursi la'aan.
• Dib u qaado: alaabta xigta waxay ku timaadaa -1, tusaale dhalo ama koob madhan (lacagta deposit-ka). Taasi waxay suurtagal tahay oo keliya alaabta leh Waa la celin karaa (lacagta deposit-ka) (Dejinta → Alaabta). Haddii biilka oo dhan uu taban yahay (kaliya deposit dib loo celiyay, iib la'aan), Bixi lacagta wuxuu noqonayaa lacag celin: kaash dib ama kaar (terminalka laftiisa dib loogu celiyo). Beljamka sida lacag celin (REFUND, UC4108 iyo UC4114).
• Isticmaal SPV: martidu waxay alaab ama menu ku bixisaa single purpose voucher (foojar u gaar ah alaabtaas, tusaale "1 menu all-in"). Taabo Isticmaal SPV kadibna alaabta rasiidka: waxay ku timaadaa -1 (isla qiimaha iyo VAT-ka, menu-na qaybihiisa), oo ay la socoto SPV. Jikada uma socdo; si caadi ah ayaa looga saari karaa. Alaabta foojarka horay ayaa loo iibiyaa sida alaab caadi ah; ku calaamadee SPV (foojar) Dejinta → Alaabta. Beljamka safku marka la iibinayo wuxuu sanduuqa madow ugu socdaa VOUCHER ahaan (UC271).
• Ka jar hor-bixinta: eeg hoos.
• Qiime furan (badhan maaha, alaab kasta): alaabta leh Qiime furan kashiirku wuxuu weydiiyaa qiimaha, tusaale cuntada maalinta ama hor-bixin.

Marka lacagta la bixinayo:

• Lacag-bixin toos ah oo aan warqad shaqo lahayn (badhan ma aha): sida caadiga ah, Bixi lacagta marka hore wuxuu dalbadaa waxa aan weli la dalban, si jikada iyo baarku had iyo jeer u helaan rasiidkooda (eeg Badhanka Dalbo: waxa uu qabto iyo goorta aad u baahan tahay). Daaran: waxa aad isla markiiba lacagta ka qaaddo adigoon marka hore taabanin Dalbo ma helo warqad shaqo, tusaale ahaan baarka, halkaas oo aad adigu qaadato. Waxa horay loo dalbaday isma beddelo.
• Gooni u bixi (miis, Kala qaybi biilka): dooro waxa hal marti hadda bixinayo, xataa qayb saf ka mid ah (½ nus dhalo). Taasi waxay noqonaysaa qayb gooni ah oo aad isla markiiba bixiso; inta kale biilka ayay ku hartaa, adigoon biilka marka hore kala qaybin ama koox kale u rarin. Qiimo-dhimista boqolleyda ah ee rasiidka oo dhan si saami ah ayay ula socotaa. Dib u noqo adigoon lacag bixin = wax walba mar kale biilka. Beljamka iibku wuxuu ku jiraa goobta miiska, miis-beddel la'aan (UC4103bis, UC4104).
• Martidu way tagtay iyadoo aan lacag bixin (xuquuqda Xir lacag-bixin la'aan, asal ahaan kaliya maareeyaha iyo maamulaha): biilka waxaa loo xiraa iib aan lacag lagu bixin, iyadoo sababta diiwaanka ku jirto. Warbixinta X iyo Z iyo warbixinta maalinlaha waxay ku jirtaa sida Lama bixin (martidu way tagtay); buugga waxay u socotaa lama soo celin karo (asal ahaan 4985 / 643000). Beljamka iib aan lacag lagu bixin (UC4109).

Kadib (Rasiidyada):

• Sax qiimaha (xuquuqda Sax qiimaha rasiidka, asal ahaan kaliya maareeyaha iyo maamulaha): qiimaha rasiid la bixiyay ma saxnayn, tusaale 50% qiimo-dhimis halkii 5%. Kashiirku wuxuu sameeyaa rasiid cusub oo miis la'aan ah oo safafkii rasiidkii hore dib loo celiyay (taban, sidii markaas la bixiyay) iyo isla alaabtii mar kale qiimaha caadiga ah. Halkaas ku sii qiimo-dhimista saxda ah oo bixi faraqa (ama dib u celi haddii qiimaha cusub ka yar yahay). Rasiidkii hore sidiisii ayuu ahaanayaa; hal mar rasiid kasta, mana aha haddii wax horay loo celiyay. Beljamka safafkii hore waxay la socdaan CORRECTION ahaan (UC4116).

Koodh: apps/pos-server/src/lib/kassaopties.ts, routes/kassaopties.ts; shaashad KassaOpties.tsx. Diiwaanka: Dejin la beddelay, SPV la isticmaalay, Sax rasiidka, Lama bixin.

Ka jar hor-bixinta

Hor-bixin (lacag hore, tusaale xaflad ama ballan) waxaa loo iibiyaa sida alaab caadi ah oo Hor-bixin shidan tahay (Dejinta → Alaabta; had iyo jeer qiime furan). Samee mid heer VAT kasta haddii hor-bixintu ay tahay inay heer kasta ahaato (tusaale Hor-bixin cunto iyo Hor-bixin cabbitaan), ama hal alaab haddii ay qayb ka tahay dalab-qiimeedka. Martidu horay ayay u bixisaa hor-bixinta oo waxay helaysaa rasiid.

Shid: Dejinta → Ganacsiga → Dalbasho iyo lacag-bixin → Ka jar hor-bixinta (asal ahaan dansan). Lacag-bixinta ugu dambaysa, shaashadda dalabka ku taabo Ka jar hor-bixinta oo geli lambarka rasiidka ee hor-bixinta. Kashiirku wuxuu biilka ku darayaa safafka hor-bixinta ee rasiidkaas oo tiro taban leh (isla alaabta, qiimaha iyo VAT-ka). Wixii horay loo jaray mar kale lama jari karo. Haddii hor-bixintu ka badan tahay biilka, martidu waxay dib u helaysaa faraqa (lacag celin). Beljamka safafka la jaray waxay sanduuqa madow ugu socdaan lacag celin ahaan (REFUND) (UC4110, UC4111, UC4113). Diiwaanka: Hor-bixin la jaray.

Rasiidka iimaylka

Caadi ahaan waa dansan. Ka shid Dejinta → Ganacsiga → Rasiidka sidoo kale iimayl ahaan.

SMTP_HOST=smtp.voorbeeld.nl
SMTP_PORT=587
SMTP_GEBRUIKER=kassa@voorbeeld.nl
SMTP_WACHTWOORD=...
SMTP_AFZENDER=bon@voorbeeld.nl

Kaashka dib u kici marka aad buuxiso kadib. Markaas Xisaabi waxaa ku jira goobta Rasiidka sidoo kale iimayl u dir (ikhtiyaari): madhan u daa = daabac oo kaliya sidii had iyo jeer; ciwaan iimayl geli = isla rasiidkaas (oo leh faahfaahinta VAT iyo safafka canshuurta) waxaa sidoo kale iimayl loogu dirayaa martida, iyadoo magaca ganacsigu yahay diraha.

• Ciwaanka iimaylka lama kaydiyo; diiwaanka waxaa ku qoran oo kaliya "rasiidka N waxaa loo iimaylay a***@domein.nl" iyo inuu guulaystay iyo in kale.
• Haddii iimaylku guuldareysto (tusaale xogta galitaanka oo khaldan), rasiidka si caadi ah ayaa loo xisaabiyay oo loo daabacay; fariintu waxay sheegaysaa waxa khaldamay.
• Maaha lacag bixin qayb ah (biilka oo la kala qaybiyo): rasiidku wuxuu imanayaa lacag bixinta ugu dambaysa, sidaa darteed halkaas ku geli ciwaanka.
• Iimayl u dir goor dambe: Rasiidyada rasiid kasta wuxuu leeyahay badhanka Iimayl u dir (oggolaanshaha Daabac nuqul rasiid). Wuxuu iimayl ku diraa rasiidka oo ay ku qoran tahay NUQUL, sida nuqul la daabacay oo kale (Beljiyam waxaa loo diiwaangeliyaa nuqul).
• Xirmooyin dheeraad ah looma baahna: kaashku isagaa la hadla server-ka iimaylka (STARTTLS 587, TLS 465).

Ballamaha

Ka shid Dejinta → Ganacsiga → Ballamaha (caadi ahaan waa dansan). Halkaas sidoo kale waxaad ku dejinaysaa inta daqiiqo ka hor ay miis la ballansaday ka soo muuqato khariidadda (caadi ahaan 60) iyo muddada caadiga ah ee ballanta (caadi ahaan 120 daqiiqo).

• Badhanka Ballamaha ee xarriiqda sare: dulmar maalin kasta (◀ ▶), oo leh tirada ballamaha, dadka iyo kuwa aan iman. + Ballan cusub: magac, taleefan, iimayl, dad, taariikh, waqti, muddo, miis (goor dambe waa la geli karaa) iyo faallo. Ballansashada waxaa sameeya shaqaalaha; ballansasho online ah (weli) ma jirto.
• Haddii isla miiskaas waqtigaas ballan horay ugu jirto, kaashku wuu ku ogeysiinayaa; "Hadda kaydi si kastaba" waa suurtagal.
• Xaqiijin iimayl ah (calaamadee, ama goor dambe "Iimayl u dir") haddii ciwaan iimayl iyo server iimayl jiraan (SMTP_HOST, eeg Rasiidka iimaylka).
• Khariidadda, miis bannaan oo la ballansaday wuxuu u muuqdaa guduud oo leh "R 19:30 Jansen (4)". Haddii aad taabto: "Jansen waa yimid" wuxuu furaa miiska oo leh 4 qof iyo "Jansen" oo ah magaca kooxda; "Marti kale" si caadi ah ayuu u furaa.
• Dulmarka: Yimid (wuxuu furaa miiska; haddii miis la'aan yahay marka hore mid dooro), Wax ka beddel, Ma iman, Jooji iyo Dib u celi. Wax walba waxay ku qoran yihiin diiwaanka.
• Ballansashooyinka barxamyada online-ka: eeg Barxamyada ballansashada hoose.

Isku xirka kaashka TheFork: miiska wuu furmaa marka la yimaado, biilka wuu laabtaa

POS-API ee TheFork kaashku wuxuu la shaqeeyaa TheFork Manager (caadi ahaan waa dansan), marka laga reebo soo qaadista ballamaha kor ku xusan. Ka shid Dejinta → Barxamyada ballansashada → Isku xirka kaashka TheFork; wuxuu maraa portalka maamulka.

• Haddii aad marti ku dhigto TheFork Manager Yimid ama Miiska fadhiya, kaashka miiska magaca la mid ah ayaa furma, iyadoo ay la socdaan tirada martida iyo faallo: magac, xasaasiyad iyo cunto gaar ah, lacag hore, dalab/qiimo dhimis iyo dhibcaha (Yums). Haddii dalab furan horey miiskaas ugu jiro, kaas ayaa lagu xiraa. Miis magacaas leh ma jiro: ogeysiis, oo Madallada ayaad ku dooranaysaa miiska.
• Kadib lacag-bixinta biilka waxaa loo diraa TheFork (wadarta iyo saf leh magac, kooxda alaabta, tirada iyo qadarka); TheFork ballanta kadib wuxuu u beddelaa Baxay. Lacag-bixin la qaybiyay waxay noqotaa hal biil oo wadarta leh. Haddii aysan suurtagal noqon, kaashku wuxuu isku dayaa rubuc saac kasta (laba maalmood), ama Mar kale dir ee Madallada.
• Isku xirka: kaashku wuxuu muujiyaa koodhka isku xirka; ku geli TheFork Manager (Isku-xirnaanta → kaash). Aqoonsiga makhaayadda TheFork (Customer-id) maamulaha ayaa geliya, ama si toos ah ayuu ula yimaadaa dalabka ugu horreeya.
• Calaamadaha: si toos ah u fur miiska, magaca, xasaasiyadda iyo lacagta hore sidii faallo, biilka u dir TheFork.
• Shuruud: Pin Voordeel waxay haysaa furaha API ee TheFork (lammaanayaasha oo keliya) waxayna halkaas ku diiwaangelisay kaashka sidii POS (badhan ku jira portalka maamulka); TheFork kadib kal tijaabo ah ayuu isku xirka nool ka dhigaa.

Dukumentiyada TheFork: https://docs.thefork.io/POS-API/introduction

Liiska sugitaanka ee martida aan ballanta lahayn

Martida aan ballan lahayn ee sugaya miis. Ka shid Dejinta → Ganacsiga → Liiska sugitaanka (walk-ins) (caadi ahaan waa dansan). Waxay muuqataa oo kaliya marka SMS-ka CM.com la dejiyay; haddii kale liiska sugitaanku meelna kuma jiro kaashka (xitaa dejinta). Si gooni ah ayay uga shaqaysaa ballamaha: xitaa haddii kuwaasi dansan yihiin. Halkaas sidoo kale waxaa ku yaal qoraalka SMS-ka (madhan = "Hallo {naam}, uw tafel bij {zaak} is klaar. Wilt u zich melden bij de bediening?"; {naam}, {zaak} iyo {personen} si toos ah ayaa loo buuxiyaa).

• Badhanka Liiska sugitaanka ee xarriiqda sare, oo leh tirada sugaysa (oranji marka qof sugayo). + Ku dar liiska sugitaanka: magac, taleefan (SMS-ka), dad, waqtiga sugitaanka la sheegay iyo codsi (barxadda, kursi carruur).
• Liisku wuxuu u kala horreeyaa sida ay isu diiwaangeliyeen, oo leh inta qof kastaa sugayay (casaan haddii ay ka dheeraato inta la sheegay), korkana waxaa ku qoran tirada sugaysa, dadka iyo celceliska waqtiga sugitaanka ee maanta.
• Haddii SMS-ku guuldareysto, sababta ayaa ku qoran. Mar kale SMS dir waa suurtagal.
• Fadhiisi: dooro miiska; khasnaddu waxay ku furaysaa tirada dadka (haddii khasnaddu diiwaangeliso tirada dadka) iyo magaca oo ah magaca kooxda (sida boos-qabsasho imanaysa).
• Tagay (baxay ama ka noqday) iyo Dib u celi. Liiska hoostiisa waxaa ku qoran cidda maanta la fadhiisiyay ama tagtay, iyo inta ay sugeen.
• Asturnaanta: lambarada taleefanka maalin kadib waa la tirtiraa; qofkii weli liiska ku jira 12 saac kadib si toos ah ayaa looga saarayaa. Diiwaangelinta, u yeeridda (oo leh oo kaliya 3-da tiro ee ugu dambeeya lambarka) iyo fadhiisinta waxay ku qoran yihiin diiwaanka.
• Maxay ugu jirin Ballamaha? Ballantu waa mid dambe (taariikh, waqti, miis horay loo doortay); liiska sugitaanku waa hadda (kala horreyn, waqti sugitaan, SMS marka miisku bannaanaado). Sidaa darteed furaha iyo badhan u gaar ah, oo leh isla "fur miiska" sida ballanta.
• Liiska sugitaanka online (ikhtiyaari, caadi ahaan waa dansan; kaliya dukaanka online): marka Martidu waxay sidoo kale isku diiwaangelin karaan dukaanka online shidan yahay, dukaanka online waxaa ku jira Liiska sugitaanka (iyo koodh QR oo albaabka loogu talagalay, maamulka dukaanka online ee Miisaska iyo QR). Martidu waxay qortaa magac, taleefan, dad iyo codsi, waxayna si toos ah u aragtaa booskeeda. Kaashka waxay liiska ku jirtaa iyadoo leh online; u yeerid, fadhiisin iyo bixid sidii caadiga ahayd, martiduna waxay ku aragtaa taleefankeeda (halkaas ayay sidoo kale iska saari kartaa).

Kaarka macmiilka / dhibcaha

Ka shid Dejinta → Ganacsiga → Kaarka macmiilka / dhibcaha (caadi ahaan waa dansan, markaas meelna waxba lagama arko). Halkaas sidoo kale waxaad ku dejinaysaa: dhibcaha euro kasta (0 = kaararka shaambada oo kaliya), inta dhibcood kadib abaalmarin la helo iyo inta euro qiimo-dhimis ah abaalmarintaasi tahay.

• Kaashka, rasiidka korkiisa waxaa ku yaal "+ Kaarka macmiilka": macmiilka ku raadi magac ama lambar taleefan, ama samee macmiil cusub (magac, ikhtiyaar ahaan taleefan iyo iimayl). Kadib magaca iyo haraaga dhibcaha ayaa ku qoran rasiidka.
• Beddelid: marka dhibco ku filan jiraan "Beddel 100 dhibcood: € 5 qiimo-dhimis"; marka kaar shaambo buuxo "Kafee bilaash ah" (kafeegaasi waa inuu rasiidka ku jiraa). Taasi waxay noqonaysaa saf qiimo-dhimis; qof kastaa wuu ka saari karaa.
• Dhibcaha iyo shaambada waxaa lagu daraa ama laga jaraa oo kaliya marka la xisaabinayo: dhibcaha lacagta qiimo-dhimista kadib (kaararka hadiyadda ee la iibiyay ma ku jiraan), shaambada xabbad kasta oo alaab leh kaar shaambo (alaabta bilaashka ah ma xisaabtamayso).
• Rasiidka kaashka: dhibcaha la ururiyay, la beddelay, haraaga iyo heerka kaararka shaambada.
• Warbixin → Macaamiisha (oggolaanshaha Maamul kaarka macmiilka): raadi macaamiil, wax ka beddel xogta, sax dhibcaha (sabab la sheego), taariikhda, iyo tirtir (AVG: magaca, taleefanka iyo iimaylka waa la tirtiraa; taariikhdu qarsoodi ayay ku sii jiraysaa). Hoosta waxaa ku yaal kaararka shaambada alaab kasta (tusaale 10 kafee = 1 bilaash).
• Celintu si toos ah dib uma celiso dhibcaha la ururiyay; haddii loo baahdo ka sax Warbixin → Macaamiisha.
• Kaarka macmiilka oo lambar leh (ikhtiyaari): Warbixin → Macaamiisha → (macmiil) ku qor lambarka kaarka (ama kaarka ku iskaan garee meeshaas). Iskaanka barkoodka, iskaanka kaarkaas wuxuu macmiilka ku xiriiriyaa rasiidka, qalabka lacag-qaadka iyo kiosk-kaba. Raadinta lambarka kaarka waxaa sidoo kale lagu sameyn karaa + Kaarka daacadnimada.

Xogta martida: VIP, baahiyaha cuntada iyo doorbidyada (ikhtiyaari)

Ka shid Dejinta → Ganacsiga → Xogta martida, kaarka macmiilka hoostiisa (caadi ahaan dansan; wuxuu shaqeeyaa kaliya marka kaarka macmiilku shidan yahay). Kadib:

• Shaashadda dalabka, macmiilka ku xiran hoostiisa waxaa ku yaal "+ Xogta martida": calaamadee VIP, dooro baahiyaha cuntada (vegetarian, vegan, pescatarian, xalaal, kosher) iyo xasaasiyadaha (14-ka xasaasiyadood), oo qor doorbidyada (tusaale "miis go'an oo daaqadda ag yaal", ugu badnaan 300 xaraf). Kadib waxay ku muuqdaan macmiilka agtiisa shaashadda dalabka, xasaasiyaduhu waa casaan. Sidoo kale waa laga beddeli karaa Warbixin → Macaamiisha → (macmiil) → Xogta martida.
• Haddii aad taabato alaab leh xasaasiyad martida (eeg Xasaasiyadda alaab kasta), kaashku marka hore wuxuu weydiinayaa in weli lagu daro. Kaliya waxa alaabta lagu buuxiyay ayaa la tixgeliyaa; haddii aad shaki qabto had iyo jeer weydii jikada.
• VIP wuxuu helayaa ★ khariidadda miisaska: biil furan iyo ballanta la muujiyay ee macmiilkaas. Marka martida ballan ay yimaadaan, kaashku wuxuu biilka ku xiraa macmiilka ballanta.
• Baahiyaha cuntada iyo xasaasiyadaha (iyo VIP) waxay ku soo baxaan warqadda jikada ee jikada iyo baarka: GAST: VIP · Vegetarisch · allergie: Noten.
• Baahiyaha cuntada iyo xasaasiyaduhu waa xog caafimaad: ku buuxi kaliya oggolaanshaha martida. Diiwaanka waxaa ku qoran kaliya in xogta la beddelay, ee ma aha baahiyaha laftooda. Tirtiridda macmiilka waxay sidoo kale tirtirtaa xogta martida.

Kuwa la jecel yahay / badhamada degdegga ah

Caadi ahaan waa dansan. Dejinta → Ganacsiga → Kuwa la jecel yahay / badhamada degdegga ah:

• Kuwa ugu iibka badan: bilowga xarriiqda kooxaha waxaa ku yaal badhanka ★ Kuwa la jecel yahay oo leh 12-da alaab ee ugu badan ee la iibiyay 14-dii maalmood ee la soo dhaafay (si toos ah ayaa loo cusboonaysiiyaa). Shaashadda dalabku waxay ku furantaa kuwa la jecel yahay.
• Adigu dooro: shaashadda dalabka alaab riix oo hay (ama badhanka midig ku riix) kadibna dooro ★ La jecel yahay (badhan degdeg ah); mar kale = ka saar. Oggolaanshaha Maamulka alaabta. Kaashyada oo dhan isla markiiba way arkaan.
• Gelinta, doorashooyinka, menu-yada, happy hour iyo "dhammaatay" waxay kuwa la jecel yahay ugu shaqeeyaan si la mid ah kooxaha caadiga ah.

Mar kale

Shaashadda dalabka waxaa ku yaal badhanka ↻ Wareeg kale (isla marka wax biilka ku jiraan, xitaa haddii aan weli la dalban). Hal taabasho waxay mar kale ku daraysaa wareeggii ugu dambeeyay (wax walba oo hal mar lagu diray "Dalbo", ama waxa aad hadda taabatay) safaf cusub ahaan; kadib si caadi ah u taabo Dalbo. Qiimayaashu waa kuwa hadda (happy hour-na ku jiro).

• Riix dheer (ama midig-guji): adigu dooro. ◀ ▶ waxaad ku daalacan kartaa wareegyadii hore, alaab kasta shid/dami (tusaale calaamadda ka saar cuntada) oo tirada ku beddel − / +. Doorashooyinka iyo faallooyinka way raacaan.
• Alaabta dhammaatay iyo menu-yada ma raacaan (menu-yada si gooni ah u geli). Xitaa xiriir la'aan wuu shaqeeyaa.
• Safafyada waxaa loo daraa sida ay ugu qoran yihiin biilka: marka Isku-darka alaabooyinka isku midka ah uu shidan yahay, hal saf alaab kasta (2 Cola); marka uu dansan yahay, saf kasta si gooni ah (2 jeer 1 Cola).

Waqtiga miiska ee khariidadda

Miis kasta oo la fadhiyo waxaa ku qoran ⏱ 45m · 12m: inta miisku la fadhiyay iyo inta ka hor wax ugu dambeeyay la galiyay (miiska taabo oo hay, ama jiirka dul saar, si aad u aragto waqtiyada saxda ah). Haddii muddo waxba la dalban, miisku wuxuu helayaa xuduud oranji ah: u soo mar. Inta daqiiqo waxaad ku dejinaysaa Dejinta → Ganacsiga → Waqtiga miiska (caadi ahaan 20, 0 = xuduud oranji ah ma jirto). Haddii aan weli waxba la galin, waqtigu wuxuu ka bilaabmaa marka miiska la furay.

Haddii dhowr kooxood (biilal gaar ah) hal miis ku fadhiyaan, koox kasta waxay leedahay saf, tusaale G1 ⏱ 50m · 12m iyo Jansen ⏱ 10m (magaca kooxda, haddii kale lambarka kooxda). Koox muddo dheer aan waxba dalban waxay helaysaa calaamad oranji ah, miiskuna xuduud oranji ah.

U wareeji miis dhan

Shaashadda dalabka waxaa ku jira Miiska u wareeji. Dooro goobta (tusaale Barxadda) iyo miis: dhammaan kooxaha miiska way la socdaan, mid walba biilkiisa. Haddii aad doorato miis la fadhiyo, miisaska waa la isku daraa (kooxaha ayaa lagu daraa). Haddii aad qayb keliya rabto inaad wareejiso, sidii hore u isticmaal Kala qaybi / rar. Haddii wax walba hal biil ku jiraan, isticmaal Isku dar.

Offline ku sii shaqee (tablet aan Wi-Fi lahayn)

Haddii xiriirka u dhexeeya tablet iyo server-ka kaashka go'o (Wi-Fi-ga barxadda, server-ka oo wax yar dansan), xarriiq jaale ah ayaa soo muuqata, tablet-kuna wuxuu ku sii shaqaynayaa miisaska, alaabta iyo dalabyada furan ee ugu dambeeyay ee la kaydiyay:

• furidda miisaska, gelinta alaabta iyo Dalbo waxaa lagu kaydiyaa tablet-ka (xitaa haddii dib loo kiciyo) waxayna liiska dalabka ugu jiraan xuduud dhibco ah ("weli lama dirin");
• isla marka xiriirku soo noqdo, wax walba waxay server-ka ugu baxayaan si kala horreysa, kadibna warqadda jikada ayaa jikada u baxda. Xirmo kasta waxay leedahay fure, sidaa darteed waxba laba jeer ma yimaadaan. Haddii qof kale inta u dhaxaysa furay miiska, alaabta waxaa lagu darayaa dalabkaas;
• xisaabinta, qiimo-dhimista, kala qaybinta iwm. waxay shaqeeyaan oo kaliya marka xiriir jiro; "Xisaabi" wuxuu sugayaa ilaa wax walba oo miiskaas ah la diro.

Tirada dadka

Ikhtiyaari ah oo caadi ahaan dansan: Dejinta → Ganacsiga → Dalbasho iyo lacag-bixin → Diiwaangeli tirada dadka. Dansan = taabasho intii suurtagal ah u yar: miis bannaan hal taabasho ayuu ku furmaa, meelna dad laguma muujiyo, warbixinta, dashboard-ka iyo soo koobidda maalintuna ma muujiyaan marti iyo kharashka marti kasta.

Shidan: marka aad taabato miis bannaan, khasnaddu waxay weydiisaa immisa qof (badhamo waaweyn 1-8, ama qor; "Ka bood" = 1). Khariidadda miisaska, miis la isticmaalayo waxaa ku qoran "3/4 qof" (dad/kuraas, jaalle haddii dadka fadhiya ay ka badan yihiin kuraasta). Shaashadda dalbashada waxaad ku beddeshaa badhanka "3 qof" ee ku yaal xariijinta kooxaha; marka ay kooxo badan jiraan miisku wuxuu isku daraa dhammaan kooxaha.

Tirada dadka la'aanteed wax walba way shaqaynayaan: U qaybi si siman marka lacagta la bixinayo wuxuu ka bilaabmaa 2, all-you-can-eat laftiisu wuxuu weydiiyaa tirada dadka waaweyn iyo carruurta, boos-qabsashooyinka iyo liiska sugitaankuna waxay hayaan tiradooda dadka (miisku markaas wuxuu furmaa dad la'aan).

Diiwaangelinta HACCP

Makhaayad kasta waa inay ilaalisaa oo diiwaangelisaa badbaadada cuntada: Nederland sida Hygiënecode voor de Horeca (kormeerka NVWA), Beljiyam sida is-hubinta FAVV (hagaha G-023). Daar Diiwaangelinta HACCP gudaha Dejinta → Sharciga iyo xeerarka (asal ahaan waa dansan tahay).

• Meelaha cabbirka (maamulaha): tusaale qolka qaboojinta, barafeeyaha, kulayl-haynta, heerkulka gudaha kadib karinta, dib u qaboojinta iyo helitaanka alaabta, oo leh ugu yaraan iyo/ama ugu badnaan °C iyo inta jeer (maalin kasta, laba jeer maalintii, toddobaad kasta ama marka la isticmaalo). Ku dar liiska caadiga ah wuxuu dhigaa bilow (qaboojin ilaa 7 °C, Beljiyam ilaa 4 °C; barafeeye ilaa -18 °C; kulayl-hayn laga bilaabo 60 °C; karin laga bilaabo 75 °C).
• Nadiifin iyo hubin: hawlo maalinle, toddobaadle (laga yaabo maalin go'an) ama bille, oo leh goob iyo tilmaan, tusaale jeermis-dilka looxyada jarista, shaandhooyinka subagga, hubinta cayayaanka, hubinta heerkulbeegga.
• Diiwaangelin (qof kasta oo galay): badhanka HACCP ee xariijinta sare, oo leh tirada maanta weli furan. Geli heerkulka, ama calaamadee hawl (La sameeyay ama Ma suurtowin). Haddii heerkul ka baxo xadka, waa in lagu daro tallaabo sixitaan (tusaale "albaabka waa la xiray, alaabta waa la tuuray"). Diiwaangelinta lama beddeli karo; khalad waxaad ku saxdaa diiwaangelin cusub.
• Warbixin (xuquuqda Dakhliga muddadii): muddo kasta dhammaan diiwaangelinta, tirada leexashooyinka iyo diiwaangelinta la seegay maalin kasta; sida CSV (Excel) ama in la daabaco / PDF ahaan loo kaydiyo kormeer.

Nidaamka shubista iyo cabbirayaasha socodka

Shubis kasta oo kombiyuutarka shubista ama cabbiraha socodku sheego wuxuu galaa rasiidka, sidaa darteed waxba ma "daataan". Ka shid Dejinta → Nidaamka shubista (caadiyan waa dansan yahay).

• Ilaha (maamule): kombiyuutarka shubista ama nidaamka mitirrada socodka. Dooro summadda; khasnaddu waxay buuxisaa habayn horay loo sii dejiyay. Nederland iyo Beljiyam: Van Duijnen Horeca (otomaatigga shubista, Dashbar), Beconet (Multi-Tap), TapSystems, Horecatechniek Nederland, Heineken SmartDispense, WeissBeerger / AB InBev iyo BarTrack; sidoo kale Gruber, Addimat, WMF / Hogatron (E-Protokoll), Drinkotec (ex-Hartec), , Berg, Easybar, Azbar, Scanabar, PourMyBeer, iPourIt, BeerBoard, US BeerSAVER, Bevchek, Capton/BarVision, Kegtron, Kegbot Kegboard, "qasabad caqli leh" ama nidaam kuu gaar ah. Xiriirintu waxay suurtagal tahay shan hab (Kegboard: eeg Shubid la cabbiray iyo Kegboard hoos):
  • Goobaha: kraan (ama tap, plu), ml (ama cl, liter, volume oo leh eenheid) ama porties, id (isla shubis laba jeer = hal mar la diiwaangeliyay), tijdstip, tafel, bediening; hal shubis, liis ama { "taps": [...] }.
  • Shabakad (TCP): kaashku wuxuu ku xidhmaa kombiyuutarka shubista (cinwaan iyo deked) ama isagaa deked ku dhegeysta.
  • Dekedda taxanaha: dekedda COM ama USB-taxane, 1200–115200 baud, 8N1, 7E1 ama 7O1.
  • Shabakad iyo taxane waxaad dejisaa qaabka fariinta (hal fariin khad kasta, ama STX … ETX oo laga yaabo hubin XOR iyo ACK/NAK dib loogu celiyo) iyo qaabka fariinta, oo leh qaybaha kraan ama plu iyo haddii loo baahdo ml, cl, liter, porties, tafel, bediening iyo id (tusaale kraan;ml ama PLU keliya koob kasta). Bixiyayaashu qaabka saxda ah waxay siiyaan rakibayaasha oo keliya; weydii bixiyaha kombiyuutarka shubista. Shubis tijaabo ah wuxuu diraa shubis sida kombiyuutarka shubistu u diri lahaa.
• Qasabadaha (maamulaha): qasabad ama PLU kasta alaabta iyo sida ay rasiidka u gasho: koob kasta (koobka ml ahaan; shubis 520 ml ah oo koobab 250 ml ah = 2 koob; laga bilaabo 50% koob ayaa la tiriyaa) ama litir kasta (qiimaha alaabtu waa qiimaha litirka; rasiidka tusaale "Pils 0,33 l" lacagta saxda ah).
• Rasiidka: haddii kombiyuutarka shubistu sheego miis, shubistu isla markiiba waxay gashaa dalabka furan ee miiskaas. Haddii kale waxay yaallaa La shubay: shaashadda dalabka waxaa ka soo baxa baarka "… jeer la shubay rasiid la'aan"; dooro shubisyada oo taabo Rasiidkan ku dar. Safafku isla markiiba waa la dalbaday (warqad shaqo baarka looma diro) kaydkana waa laga jarayaa. Badhanka La shubay ee baarka sare wuxuu muujiyaa wax kasta oo aan weli rasiid lahayn.
• Diidid (oggolaanshaha Storno): biyo-mareen, jab, dhadhamin, shaqaale, bilaash ama kuwo kale (faahfaahin leh); taas waxay gashaa diiwaanka. Wax ka yar koob (tusaale biyo-mareen) waa in la diido.
• Guudmar (oggolaanshaha Dakhliga muddo kasta): qasabad kasta waxa la shubay, rasiidka ku jira, la diiday (sabab kasta), la joojiyay iyo weli furan, litir ahaan, boqolleyda la iibiyay, iyo sida CSV.
• Shubisyada la soo sheegay lama beddeli karo (keliya waa la xallin karaa).

Shubid la cabbiray iyo Kegboard

Shubidda la cabbiray, qasabaddu waxay furantaa kaliya kadib marka koobka lagu diiwaangeliyo khasnadda, oo kaliya qaddarkaas. Sidaas darteed waxba lama shubo oo aan biilka ku jirin. Waxay shaqeysaa kaliya marka nidaamka shubistu shidan yahay, waxaadna u shidaysaa qasabad kasta (asal ahaan dansan).

• Qasabad kasta (maamule, Dejinta → Nidaamka shubista → Qasabadaha): calaamadee Shubid la cabbiray oo dooro inta qasabaddu furnaan karto kadib diiwaangelinta (10–600 ilbiriqsi, asal ahaan 120). Kegboard, sidoo kale geli rileeyga (waalka birlabta). Shubidda la cabbiray waxay shaqeysaa kaliya koob-koob.
• Diiwaangelin: marka Dalbo (ama marka si toos ah Bixi lacagta) khasnaddu waxay u samaysaa saf kasta oo biilka ah oo leh alaabtaas siidayn (tirada koobabka × koob ml ahaan) waxayna u dirtaa kombiyuutarka shubista. Shubidda kadib timaadda waxay ka tirsan tahay safkaas. Sidaas darteed mar kale kuma soo baxdo biilka iyo La shubay midna. Shubid aan siidayn lahayn waxay si caadi ah u gashaa La shubay.
• Storno safka ka hor shubidda: qasabaddu mar kale way xirantaa. Siidayn aan waqtigeeda la shubin way dhacdaa; qasabaddu weligeed ma furanto goor dambe.
• Siidaynta shaashadda dalabka (bar ka sarreysa biilka): arag waxa socda, Jooji iyo Mar kale sii daa. Mar kale sii dayntu waxay suurtagal tahay kaliya haddii aan weli waxba la shubin, markaa weligeed wax dheeraad ah lama sii daayo. Siidayn tijaabo ah (maamule) waxay sii daysaa hal koob iyada oo aan biil lahayn; taasi waxay gashaa diiwaanka.
• Sida siidayntu u gaarto kombiyuutarka shubista:
  • Kegboard (Kegbot, open source, ESP32 leh mitirro socod iyo waalal birlab; borotokool gebi ahaanba furan): khasnaddu waxay bixisaa grant qasabadaha leh alaabtaas, rileeyada iyo qaddarka. Boodhku isagaa xira qasabadda marka qaddarka la gaaro ama waqtigu dhammaado.
  • Shabakad/taxane: amar siidayn la habayn karo oo leh {kraan}, {ml}, {porties}, {sec} iyo {id} (tusaale V{kraan};{ml}), loo diray qaabka fariinta isha (saf ama STX … ETX leh XOR). Ikhtiyaar ahaan waxaa jira amar joojin. Amarka saxda ah waxaa bixiya alaab-qeybiyaha.
• Ku xir Kegboard: ka dooro + Il summadda Kegbot Kegboard. Looxu wuxuu isku soo bandhigaa isha; guji Oggolow (ama Diid). Looxu markaas hal mar ayuu helaa fure u gaar ah, oo khasnaddu u kaydiso oo kaliya sida hash. Qalab kale ama fure khaldan waxba kama beddelo looxa ku xiran; haddii looxu furihiisa lumiyo, marka hore isticmaal Ka jar xiriirka. Ishu waxay muujisaa firmware-ka, mitirrada iyo relay-yada looxa. Qasabadaha waa lambarrada mitirrada (0, 1 …). Kaar loo taabto looxa waa la diidaa: lacag bixintu waxay ka dhacdaa khasnadda. Haddii nidaamka shubistu dansan yahay, looxu wuu kaydiyaa farriimihiisa wuxuuna diraa goor dambe.
• Isha ayaad ku dejisaa inta ilbiriqsi ee aan socod lahayn kadib qasabaddu xirmayso (5–300, caadi ahaan 30). Qasabad kasta waxaad ku buuxisaa lambarka mitirka, relay-ga (waalwalka magnetka) iyo inta ay qasabaddu furnaan karto kadib marka la diiwaangeliyo.

Xakamee muusigga kaashka

Shaqaaluhu waxay muusigga ka xakamayaan shaashadda taabashada ee kaashka, sidaas darteed looma baahna shaashad gaar ah oo baarka la dhigo. Ka shid Dejinta → Ganacsiga → Shaashadaha iyo isticmaalka → Xakamee muusigga kaashka (caadi ahaan waa dansan yahay). Markaas badhanka Muusig ayaa ka muuqda baarka sare: il kasta (tusaale Baar iyo Teraas) waxay leedahay Daar, Jooji, Xiga, Hore, Kor u qaad, Hoos u dhig iyo slider mugga ah, iyo waxa hadda socda. Ku noqo kaashka wuxuu xiraa guddiga. Dansan: ilaha waa la kaydiyaa.

• Liiska ciyaarta (Sonos, Bluesound iyo VLC): safka leh waxa hadda shidan. Taabo hees si aad u daarto; Wax ka beddel waxaad ku saari kartaa heesaha (✕), kor ama hoos u dhaqaajin kartaa (↑ ↓; Sonos iyo Bluesound) ama madhin kartaa liiska ciyaarta. Dooro muusig kale waxaad ku daari kartaa mid Sonos ah oo la jecel yahay (tusaale idaacad ama kanaal Tunify) ama liis kaydsan, ama doorasho BluOS ah oo horay loo dejiyay.
• Shaashad gaar ah: isla xakamaynta iyo liiska ciyaarta oo weyn http://<kassaserver>:3000/muziek, tusaale shaashad labaad oo kaashka ag taal ama tablet baarka saaran (haddii aad horay ugu gashay qalabka isku midka ah, haddii kale PIN).
• Tablet ama telefoon: QR code leh ciwaanka shaashaddaas gaarka ah ee shabakadda goobta. Shaqaale ayaa ku iskaan gareeya tablet-kiisa ama telefoonkiisa (oo ku xiran shabakadda wifi ee goobta) wuxuuna ku galaa PIN-kiisa; Ka bax ayaa mar kale xira. Eeg Shaashad labaad oo tablet ama telefoon ah.

Maamuluhu wuxuu ku daraa ilaha + Isha muusigga, wuxuu doortaa sida ay ugu xiran tahay, wuxuuna ku tijaabiyaa Tijaabi:

• Soundtrack (soundtrack.io): iyadoo loo marayo API-ga furan, leh API-token (laga codsado Soundtrack) iyo aag cod (Soo rar aagagga). Daar, jooji, xiga, mugga iyo waxa socda.
• Sonos: ciwaanka IP ee sameecadda (koox ahaan: sameecadda kooxda hogaaminaysa). Waxay la shaqaysaa wax kasta oo ka socda Sonos, tusaale Tunify, Spotify ama raadiye.
• Bluesound (BluOS): ciwaanka IP ee ciyaaraha; sidoo kale waxay la shaqaysaa wax kasta oo ka socda, tusaale Tunify.
• VLC ee kombiyuutarka muusigga: shid interface-ka web (Tools → Preferences → All → Interface → Main interfaces: Web, leh furaha sirta Lua); ciwaanka IP (haddii loo baahdo leh :poort, caadi ahaan 8080) iyo furaha sirta.
• Kombiyuutar muusig oo gaar ah (ciwaanno web): kombiyuutar ama sanduuq muusig oo ciwaan web u leh badhan kasta; GET ama POST, iyo {volume} (0-100) ciwaanka si mugga loo dejiyo. Haddii aan ciwaan Kor u qaad/Hoos u dhig la hayn, kaashku wuxuu mugga u dejiyaa tallaabo-tallaabo.
• Webplayer-ka xirmada muusigga: ciwaanka web ee webplayer-ka ama bogga xakamaynta (tusaale webplayer-ka Tunify ama Media Tools) wuxuu ka furmayaa kaashka marka la riixo badhanka Muusig; haddii adeegga aan laga furi karin shaashad kale, isticmaal Ku fur daaqad gaar ah.

Kaashku wuxuu ciyaarayaasha kala hadlaa server-ka, sidaas darteed waa inay ku jiraan isla shabakadda kaashka (Soundtrack wuxuu maraa internetka). Xakamaynta waxaa samayn kara qof kasta oo soo galay; dejinta waxay u baahan tahay xuquuqda Deji ganacsiga, lacag-bixinta iyo daabacayaasha. Token-ka iyo furaha sirta marnaba dib uguma muuqdaan shaashadda mana galaan diiwaanka; diiwaanka waxaa ku qoran oo keliya dejinta (shid/dansan, ilaha), ma aha badhan kasta. Dhoofinta qaabeynta waxay qaadataa oo keliya shid/dansan (ilaha waxay ka tirsan yihiin hal ganacsi).

Shaashad labaad oo tablet ama telefoon ah

Muusigga iyo kamaradaha waxaa sidoo kale lagu furi karaa tablet-ka ama telefoonka shaqaalaha, sida shaashad labaad oo kaashka ag ah. Daaqadda Muusig ama Kamaradaha waxaa ku jira badhanka Tablet ama telefoon: wuxuu muujiyaa QR code leh ciwaanka, tusaale http://192.168.1.20:3000/muziek ama .../camera.

1. Ku xir tablet-ka ama telefoonka shabakadda wifi ee goobta.
2. Ku iskaan garee QR code-ka kamaradda (ama ku qor ciwaanka browser-ka).
3. Ku gal PIN-kaaga. Waxaad arkaysaa oo kaliya waxa laguu oggol yahay: muusigga qof walba, kamaradaha oo kaliya xuquuqda Daawo muuqaallada kamaradaha.
4. Dhammaad: Ka bax dhinaca midig ee sare. Haddii gelitaanku dhacay (tusaale tablet-ku habeen ayuu fadhiyay), shaashaddu mar kale ayay PIN-ka weydiinaysaa.

Talo: boggan ku dar shaashadda hore ee tablet-ka (browser-ka: Ku dar shaashadda hore), markaas wuxuu u furmayaa sida app.

Sidaas darteed kaashku wuxuu weydiiyaa ciwaanka IP ee kombiyuutarka kaashka ee shabakadda (haddii kombiyuutarku leeyahay wax ka badan, tusaale wifi iyo fiilo, adiga ayaa dooranaya shabakadda). Bogga maamulka (kaash fog) waa ciwaanka bogga. QR code-ka kaashka laftiisa ayaa sameeya, internet la'aan.

Ku xirista tablet-yada: hal badhan ugu dir tablet-ka (ikhtiyaari)

Xitaa ka fudud: hal mar ku xir tablet, kadib kaashku wuxuu hal badhan ugu diraa muusigga ama kamaradaha tablet-kaas. Ka shid Dejinta → Ganacsiga → Shaashadaha iyo isticmaalka → Tablet-yada shaashad labaad ahaan (caadi ahaan waa dansan yahay).

1. Tablet-ka: fur http://<kassaserver>:3000/tablet (dejinta waxaa ku qoran Tablet ama telefoon oo leh koodhka QR), ku gal PIN oo tablet-ka magac sii, tusaale Tablet-ka Baarka. Isku xir.
2. Kaashka: daaqadda Muusig ama Kamaradaha hadda waxaa ku jira badhanka U dir Tablet-ka Baarka (oo leh dhibic cagaaran marka tablet-ku shidan yahay). Taabo: tablet-ku si toos ah ayuu shaashaddaas u furaa. Muusigga, isha la doortay ayaa la socota (tusaale Teeraas).
3. Tablet-ka: Xir wuxuu ku celiyaa sugitaanka; Ka goo xiriirka tablet-kan wuxuu meesha ka saaraa xiriirka.

Bogga tablet-ka furan u daa; haddii tablet-ku dansan yahay ama hurdo, wuxuu furayaa shaashadda marka uu mar kale shido. Tablet-ku wuxuu ku jirayaa sidii shaqaalihii ku galay: dirista iyo daawashada kamaradaha waxay suurtagal tahay oo kaliya ogolaanshaha Daawo muuqaallada kamaradaha. Maamuluhu dejinta wuxuu ku arkaa tablet-yada ku xiran iyo inay shidan yihiin, wuxuuna siin karaa magac kale ama ka saari karaa. Tablet-ku wuxuu kaydiyaa fure u gaar ah; kaashku wuxuu kaydiyaa oo kaliya hash-kiisa. Damin: tablet-yada ku xiran way kaydsan yihiin. Diiwaanka waxaa ku qoran cidda ku xirtay, magaca u beddeshay ama ka saartay tablet.

Shaashadda u yeedhista dadka qaata

Shaashad martida loogu talagalay: bidixda Waa la diyaarinayaa, midigta Diyaar, lambarro waaweyn, sida makhaayadda cuntada fudud ama fast food. Ka shid Dejinta → Ganacsiga → Shaashadaha iyo isticmaalka → Shaashadda u yeedhista dadka qaata (caadi ahaan waa dansan tahay).

Isku xidhid looma baahna: TV leh browser (smart-TV, stick ama mini-PC), tablet ama shaashad labaad ku fur cinwaanka kaashka oo leh /oproep, tusaale ahaan http://192.168.1.20:3000/oproep. Dejinta iyo daaqadda U yeedh waxaa ku yaal badhamada Shaashad gaar ah iyo Tablet ama telefoon (QR-code leh cinwaanka). Gelid looma baahna: shaashaddu lambarro kaliya ayay muujisaa. Hal mar taabo shaashadda, markaas browser-ku cod ayuu sii daayn karaa.

Waxa ka muuqda:

• dalabyada la qaato ee kaashka, dukaanka online iyo Thuisbezorgd (haddii la rabana dalabyada miiska adeegga ee aan miis lahayn, iib degdeg ah), 12-kii saac ee ugu dambeeyay;
• isla marka wax loo diro jikada ama baarka (ama dukaanka online uu yahay waa la diyaarinayaa): lambarku wuxuu galaa Waa la diyaarinayaa;
• Diyaar si toos ah ayuu u noqdaa marka shaashadda jikadu sheegto in dalabka oo dhan diyaar yahay ama dalabka dukaanka online uu yahay diyaar. Lambarku in yar ayuu biligleeyaa, shaashadduna waxay bixisaa ding-dong;
• lambar diyaar ah wuxuu joogaa inta daqiiqo ee la dejiyay (caadi ahaan 10), ama ilaa La qaatay;
• dalabaadka kiosk-ga (eeg Kiosk is-adeeg ah) had iyo jeer way muuqdaan isla marka la bixiyo ama khasnadda lagu bixin doono, xitaa "halkan ayaan ku cunayaa", iyagoo wata lambarka qaadashada ee rasiidkooda;
• ikhtiyaar ahaan sidoo kale dalabyada gaarsiiyeyaasha Thuisbezorgd, Uber Eats, Deliveroo iyo HubRise (sanduuqa Sidoo kale dalabyada gaarsiiyeyaasha …): oo leh lambarka dalabka madalka iyo magaca madalka hoostiisa, si gaarsiiyuhu u arko marka dalabkiisu diyaar yahay. La qaaday markaas sidoo kale wuxuu madalka u sheegaa in gaarsiiyuhu qaatay (sida daaqadda madalka).

Lambarka: dukaanka online-ka, Thuisbezorgd iyo madallada gaarsiinta, lambarka dalabka ee martida ama gaarsiiyuhu horey u haysto; haddii kale lambarka qaadashada (1 ilaa 999). Wuxuu si weyn ugu daabacan yahay rasiidka, oo leh sharaxaad ah in lambarku ka soo muuqan doono shaashadda marka dalabku diyaar noqdo (luqadda rasiidka).

Ikhtiyaari (asal ahaan dansan, dejinta dhexdeeda):

• Ku dhawaaq lambarka cod: marka lambar cusub diyaar noqdo, shaashaddu waxay ku leedahay luqadda la doortay (Nederlandis, Ingiriis, Jarmal, Faransiis, Isbaanish, Talyaani, Bortuqiis, Boolish, Turki ama Carabi) tusaale "Nummer 42…". Codku wuxuu ka yimaadaa browser-ka shaashadda wuxuuna ku kala duwan yahay qalab kasta; marka aad furto hal mar taabo shaashadda. Kadib dawanka, haddii codkuna shidan yahay.
• Xaaladda dalabka ee taleefanka: koodh QR ayaa ka soo baxa lambarka qaadashada hoostiisa ee rasiidka. Martidu way iskaan gareysaa, waxay aragtaa lambarkeeda iyo xaaladda (la dalbaday, waa la diyaarinayaa, diyaar, la qaatay) waxayna heshaa ogeysiis marka dalabku diyaar yahay. Waxay ku shaqeysaa bogga maamulka, sidaas darteed khasnaddu waa inay ku xiran tahay. Ma aha dukaanka online-ka iyo Thuisbezorgd (xaaladdooda gaarka ah ayay leeyihiin) mana aha kiosk-ga (dejin gaar ah ayuu leeyahay).

Kaashka waxaa ku yaal badhanka U yeedh (oo leh tirada weli la diyaarinayo):

1. Diyaar gacanta ayuu lambar ku diyaariyaa (shaashad jiko la'aan, ama haddii ay ka dhakhso badan tahay). Dalabka dukaanka online ama Thuisbezorgd xaaladdu way la socotaa, sidaas darteed martidu sidoo kale fariin ayay helaysaa.
2. Dib u noqo wuxuu dib ugu celiyaa Waa la diyaarinayaa.
3. La qaatay wuxuu ka saaraa shaashadda (leh Ka noqo).

Dejinta waxaad sidoo kale ku doorataa in magaca hore uu ku xigo lambarka (caadi ahaan maya, sirta awgeed) iyo in shaashaddu cod bixiso. Damin: badhanka U yeedh ma jiro, rasiidkana lambar qaadasho kuma jiro; dejintu way kaydsan yihiin. Diiwaanka waxaa ku qoran cidda gacanta ku samaysay diyaar, dib u noqo ama la qaatay.

Saxiixa gelitaanka iyo ka bixitaanka

Caadi ahaan saacad-diiwaangelintu waa dansan tahay: markaas meelna kama muuqato kaashka (badhan kuma jiro xarriiqda sare, kuma jiro shaashadda galitaanka, tab Saacadaha shaqada ma jiro). Ka shid Dejinta → Ganacsiga, hoosta Shaqada galitaanka iyo ka bixitaanka shaqaalaha:

• Dansan: ha isticmaalin. Haddii aad hadhow damiso diiwaangelinta saacadaha, meelna kuma muuqato, laakiin saacadaha horey loo diiwaangeliyey waa la kaydiyaa (waxba lama tirtirayo); haddii aad dib u shido, way soo laabanayaan.
• Shidan: shaqaaluhu way geli karaan oo ka bixi karaan shaqada. Galitaanka kadib kaashku wuxuu weydiinayaa inaad rabto inaad shaqada gasho (Hadda maya waa la oggol yahay). Xarriiqda sare markaas waxaa ku qoran Gal shaqada ama Shaqada gal 17:02; taabo si aad shaqada uga baxdo.
• Qasab: galitaanka kadib marka hore shaqada gal, haddii kale kaashka ma isticmaali kartid. Ka bixidda shaqadu isla markiiba waxay kaa saaraysaa kaashka.

Qofka aan kaashka isticmaalin (tusaale jikada) wuxuu saacadda ku diiwaangeliyaa shaashadda galitaanka: taabo Gal / ka bax shaqada oo geli PIN-kaaga. Taasi waxay isu beddeshaa gal iyo ka bax, adigoon kaashka gelin.

Marka saacad-diiwaangelintu shidan tahay, maamuluhu wuxuu Dejinta → Saacadaha shaqada ku arkaa:

• cidda hadda shaqada ku jirta (wuxuuna ka saari karaa qof ilaaway inuu ka baxo);
• saacadaha la shaqeeyay shaqaale kasta muddo kasta, oo leh wareegyada shaqo oo dhan, iyo soo dejin CSV ah (saacadaha sidoo kale tiro jajab ah oo loogu talagalay mushaharka);
• wax ka beddel ama ku dar wareegyo shaqo (taabo wareeg shaqo, ama + Ku dar wareeg shaqo). Beddel kasta wuxuu diiwaanka ku galaa waqtiyada hore iyo kuwa cusub.

Beljiyam, gelid iyo ka bixid kasta waxaa sidoo kale loo sheegaa sanduuqa madow. Haddii aan la gaari karin, saacad-diiwaangelintu ma dhacayso (sida xisaabinta oo kale). Haddii tani si buuxda u buuxinayso shuruudaha diiwaangelinta shaqaalaha ee Beljiyam weli waa in la xaqiijiyaa.

Miisaamid iyo calaamado (miisaan)

Marka miisaanku shidan yahay (Dejinta → Miisaan), alaabtu waxay yeelan kartaa qiimo kiilo kasta. Alaabta kale oo dhan waxay ahaanaysaa xabbad-xabbad.

• Miisaamid: taabo alaab leh qiimo kiilo kasta (badhanka waxaa ku qoran tusaale 12,95/kg). Daaqadda Miisaamid waxay si toos ah u muujinaysaa miisaanka (tusaale Aclas OS6X, ama miisaanka kaashku laftiisa ku shaqeeyo); cagaar = deggan. Alaabta saar miisaanka oo taabo Ku dar isla marka miisaanku dego. Qiimuhu waa qiimaha kiilada × miisaanka (loo soo koobay sentiga); weelka (tarra) alaabta si toos ah ayaa looga jaraa. Haddii alaabtu leedahay doorashooyin, kadib ayay imanayaan.
• Miisaanno badan: haddii ay jiraan miisaanno badan, daaqadda korkeeda ka dooro midka aad ku miisaamayso. Kaash/tablet kasta wuu xasuustaa doorashadiisa.
• Gacanta: miisaan ma jiro (ama gacanta waa la oggol yahay)? Markaas miisaanka qor: 0,512 ama 1,2 waa kiilo, 512 ama 512 g waa garaam.
• Calaamadda TS6X: barcode-ka calaamadda ku sawir aaladda barcode-ka shaashadda dalabka (si caadi ah u sawir, waxba uma baahna inay furnaadaan), ama taabo Calaamad oo sawir ama qor 13-da tiro. Alaabta (PLU) iyo miisaanka waxay ka yimaadaan calaamadda. Haddii qiimo ku qoran yahay calaamadda, kaashku wuxuu xisaabiyaa qiimahaas saxda ah.
• Shaashadda, rasiidka kaashka iyo shaashadda macmiilka waxaa ku qoran miisaanka, tusaale Gehakt 6,63 oo hoostiisa ah 0,512 kg x € 12,95/kg; warqadda jikada 0,512 kg Gehakt. Kala qaybinta, wareejinta iyo celinta waxay ku socdaan kiilo.
• Alaab la miisaamay waxay shaqaysaa oo kaliya marka xiriir lala leeyahay server-ka kaashka (miisaanku wuxuu ka yimaadaa server-ka kaashka).

Uber Eats, Deliveroo iyo HubRise

Marka laga reebo Thuisbezorgd.nl / Takeaway.com, kaashka waxaa sidoo kale yimaada dalabyada Uber Eats (Nederland iyo Beljamka), Deliveroo (Beljamka oo keliya; Deliveroo waxay Nederland ka baxday dhammaadkii 2022) iyo wax kasta oo ku jira HubRise (sida Uber Eats, Deliveroo, Just Eat/Takeaway.com iyo app-yada dalabka ee yaryar). Madal kasta si gaar ah ayaa looga shidaa Dejinta → Madallada keenista (caadi ahaan waa dansan; damintu wax walba way kaydisaa). Tab-ku wuxuu muujiyaa madal kasta dalalka uu ka shaqeeyo wuxuuna digaa haddii uusan ka shaqayn dalka ganacsiga.

• Shid, kadib Gal Uber Eats oo ku xir dukaanka (ganacsigu wuxuu ku galaa akoonkiisa Uber Eats). Haddii akoonku leeyahay dukaanno badan, geli aqoonsiga dukaanka (store id) oo mar kale gal. Uber Eats marka hore waa inay Pin Voordeel u oggolaato lammaane ahaan.
• Deliveroo: si toos ah, portalka. Geli site-id (location id) iyo aqoonsiga summadda (brand id). Tablet la'aan (caadi): kaashku wuu aqbalaa ama diidaa; tablet leh: ganacsigu wuxuu ku aqbalaa tablet-ka portalkuna wuxuu sheegaa oo keliya in dalabku kaashka ku jiro.
• HubRise: kaashku keligiis ayuu soo qaadaa dalabyada (20 ilbiriqsi kasta, portal looma baahna).
• Madal kasta: si toos ah u aqbal, warqadda jikada isla markiiba jikada/baarka iyo (Uber Eats, Deliveroo) si toos ah u dir menu-ga kadib isbeddel iyo Hadda dir menu-ga. Menu-ga waxaa ku jira alaabta lagu calaamadeeyay Alaabta ku jirta menu-ga Uber Eats iyo Deliveroo, oo leh doorashooyin; dhammaaday sidoo kale wuu raacaa.

Dalabyada. Dalab wuxuu noqdaa dalab caadi ah (bezorgen ama afhalen, magaca kooxda <platform> <nummer>) oo leh qiimaha madalka: alaabta waxaa lagu aqoonsadaa aqoonsiga (menu-ga), koodhka ama lambarka PLU, aan la aqoon = saf gaar ah oo leh qiimaha madalka (iyo ogeysiis); kharashka keenista, khidmadaha iyo qiimo dhimista sidii safaf gaar ah; haddii wadartu weli aysan is waafaqin, saf "Farqi". Warqadda jikada isla markiiba waxay aadaa jikada/baarka. Badhanka Madallada ee baarka sare (tirada dalabyada socda; oranji marka wax la aqbalo jiraan): aqbal ama diid (sabab), waa la diyaarinayaa, diyaar, jidka ku jira, waa la keenay ama la qaatay, jooji, iyo Dhammaystir (online lagu bixiyay). Waxa madalku yaqaan dib ayuu u laabtaa (Uber Eats: aqbal, diid, jooji; Deliveroo: aqbal, diid, waa la diyaarinayaa, diyaar, la qaatay; HubRise: dhammaan xaaladaha). Haddii ganacsigu keligiis keeno (keenis gaar ah), dalabku sidoo kale wuxuu ku jiraa Safarro, ka bixitaanka iyo la keenay si toos ah ayay madalka u aadaan. Joojin madalka ka timid waxay dalabka ka dhigtaa mid la joojiyay. Haddii kaashku in ka badan 2 daqiiqo aan portalka ku xirnayn, portalku wuxuu diidaa dalab cusub oo Uber Eats ah wuxuuna Deliveroo (tablet leh) u sheegaa inaysan suurtagal noqon, si ganacsigu ugu arko tablet-ka.

Koodh: apps/pos-server/src/lib/bezorgplatforms.ts, routes/bezorgplatforms.ts; shaashadaha Bezorgplatforms.tsx. Dhinaca portalka: horecapos-portaal/src/platforms.mjs. Diiwaanka: Madallada keenista (shid/dami, dejinta, dalabyada). Wax walba waxay ku jiraan nuqullada kaydka ee kaashka.

Madallada yaryar ee Nederland iyo Beljamka (Homie, Hebtrek, sneleten.nl, Bistroo ...) ma laha isku xir kaash oo furan; haddii ay ku jiraan HubRise, waxay ku shaqeeyaan HubRise. Intaas kadib: eeg backlog-ga.

Mashiinka lacagta (nidaam lacageed oo xiran)

Caadi ahaan waa dansan: kaashku sidii caadiga ahayd ayuu u shaqeeyaa. Nidaam lacageed oo xiran, shaqaaluhu ma taabtaan lacagta kaashka ah: macmiilka ama shaqaaluhu wuxuu lacagta geliyaa mashiinka, kaas oo tiriya, hubiya lacag been abuur ah oo sarrifka celiya.

• Mashiinnada uu kaashku si toos ah ula hadlo:
  • CashDro (3, 4+, 5, 7, S Compact; NuKassa, KluisKassa): shabakadda (web service). CashDro-ga ka shid Web Integration oo u samee kaashka isticmaale u gaar ah.
  • Cashmatic (SelfPay 460/860/1060; Beljiyam Xpos): shabakadda (dekedda 50301) oo leh isticmaale Cashmatic ah.
  • Azkoyen Cashlogy (POS1000, POS1500): CashlogyConnector oo ku jira kombiyuutar Windows ah oo mashiinka u dhow (dekedda 8092).
  • CashKeeper: CKMonitor oo ku jira kombiyuutar Windows ah (dekedda 16501).
  • Glory CASHINFINITY (CI-5, CI-10, CI-10X; sidoo kale Cikam): maamulka (FCC) ee mashiinka. Weli waa beta: isku xirka ugu horreeya ha hubiyo Glory ama ganacsadahaagu.
  • Dibadda: software kale ayaa mashiinka maamula oo la hadla kaashka (sida Cikam, ImaCash oo loogu talagalay 25 nooc, software-ka CashGuard/StrongPoint (Merlin), PayComplete (SUZOHAPP), Gunnebo SafePay ama noocyo Faransiis ah sida CashMag).
  • Mashiin tijaabo: qalab la'aan, tababar ama bandhig. Tijaabi xiriirka waxaad ku hubisaa cinwaanka iyo galitaanka. Mashiinka geli shabakaddaada gaarka ah (marnaba ha u furin internetka) oo kaashka u isticmaal isticmaale u gaar ah, maamule ma aha.
• Bixi lacagta adigoo isticmaalaya Kaash: Ku bixi mashiinka lacagta wuxuu bilaabaa lacag bixinta qaddarka (kaash la dhoweeyay haddii taasi shidan tahay, oo lagu daray baqshiish; marka biilka la kala qaybiyo qaybta). Shaashaddu waxay muujisaa waxa la geliyay iyo waxa soo noqonaya; kaashku wuxuu xisaabta xiraa oo kaliya marka mashiinku sheego diyaar. Jooji = mashiinku lacagta wuu celiyaa. Haddii mashiinku uusan bixin karin dhammaan sarrifka (qadaadiic yar), waxaa la qoraa inta ay tahay in laga bixiyo khaanadda lacagta. Lacag bixin guulaysatay oo aan weli la xisaabin (tusaale tablet-ku damay) waxaa dib looga helaa dalabkaas.
• Kaash kaliya mashiinka (caadi ahaan waa shidan): markaas server-ka kaashku wuxuu kaash aqbalaa oo kaliya marka lacag bixin guulaysatay lagu sameeyay mashiinka dalabkaas iyo qaddarkaas saxda ah. Dansan = sidoo kale kaash caadi ah oo khaanadda la geliyo.
• Khaanadda lacagta (Warbixin → Kaash, ogolaanshaha Maamul khaanadda lacagta): Eeg xaaladda (qadaadiic iyo warqad kasta, Cashmatic, Cashlogy, Glory iyo mashiinka tijaabada), Bixi lacag sabab leh (tusaale sarrif loogu talagalay khaanadda), Buuxin iyo Ka qaadis lacagta dheeraadka ah (sarrifku wuu harayaa; Cashmatic). Waxa la filayo khaanadda kaashka kuma xisaabiyo lacagta mashiinka ku jirta (taasi hoosta si gooni ah ayay ugu qoran tahay: Mashiinka lacagta ku jira), laakiin wuxuu xisaabiyaa sarrifka ay ahayd in khaanadda laga bixiyo.

Badhanka ©

Shaashad kasta geeskeeda hoose ee midig (PIN, khariidadda, dalbashada iyo jikada) waxaa ku yaal badhan yar oo © ah. Wuxuu furaa xogta OptimumPOS: astaanta, ciwaanka, taleefanka, iimaylka iyo website-ka. Astaantu gudaha app-ka ayay ku kaydsan tahay, sidaa darteed xitaa internet la'aan way shaqaysaa. Isla astaantaas waa astaanta app-ka (tabka browser-ka iyo shaashadda hore).

Qaybta 2 · Maareeyaha

Bilow

Caadi ahaan maareeyuhu wuxuu samayn karaa wax kasta oo adeeguhu samayn karo, iyo weliba kuwa kale sida qiimo-dhimis bixinta, celinta, xiritaanka maalinta, maamulka khaanadda kaashka iyo eegidda diiwaanka iyo kaydka alaabta. Inta badan waxay ku hoos jiraan badhanka Warbixin:

• Wadarta ku meel gaarka ah (X): dakhliga ilaa hadda, adigoon xirin maalinta.
• Khaanadda kaashka: lacagta bilowga, lacag gelin/saarid iyo furidda khaanadda.
• Xir maalinta (Z): dhammaadka maalinta; kadib maalin cusub ayaa bilaabanaysa.
• Warbixinnadii Z ee hore, Dakhliga muddo kasta iyo Dashboard.
• Diiwaanka, Kaararka hadiyadda iyo Macaamiisha.

Kaydka alaabta

Caadi ahaan waa dansan yahay. Ka shid Dejinta → Ganacsiga → La soco kaydka alaabta. Dansan = meelna kashiirka kama muuqdo.

• Alaab kasta waxaad ka dooranaysaa Dejinta → Alaabta → (alaabta) → Kaydka alaabta:
  • Maya: sidii caadiga ahayd;
  • Alaab kasta: iib kastaa wuxuu ka jaraa 1 (tusaale dhalooyin, qasacado), oo leh heer digniin oo loogu talagalay "ku dhowaad dhammaatay";
  • Maaddooyinka: cunto-karis, tusaale hamburger = 1 rooti + 150 g hilib + 1 xabbo farmaajo. Iib kastaa wuxuu ka jaraa maaddooyinka.
• Dejinta → Kaydka alaabta (ogolaanshaha Maamul kaydka alaabta, caadi ahaan maareeyaha iyo maamulaha):
  • Alaabta iyo Maaddooyinka: xaaladda kaydka, oo leh dhammaatay / ku dhowaad dhammaatay; shaandhee "kaliya (ku dhowaad) dhammaatay" oo u dhoofi CSV.
  • Alaab ama maaddo kasta waxaad diiwaangelisaa Helitaan (+) (keenis), Tirin (=) (tirada la tiriyay ayaa noqota xaaladda cusub) ama Ka jar (−) (jab, taariikhdu dhaaftay; sababta waa khasab).
  • Samee maaddooyin leh cabbir (xb, g, kg, ml, cl, l, qayb, dhalo, foosto) iyo heer digniin.
  • Taariikhda: dhammaan isbeddellada (iib, baajin, helitaan, tirin, ka jarid) iyo cidda iyo goorta. Ficillada maamulka sidoo kale waxay galaan diiwaanka.
• Ka jaridda waxay dhacdaa marka Dalbo la taabto (ama marka la xisaabinayo waxa isla markiiba la xisaabiyay). Baajintu dib ayay u celisaa. Kala qaybinta iyo wareejintu laba jeer ma tiriyaan. Menu-yada waxaa laga jaraa cuntooyinka, ma aha safka menu-ga. Celinta (rasiidka deyn-celinta) dib uma celiso kaydka (waxa la soo celiyay inta badan dib looma iibin karo); haddii loo baahdo u diiwaangeli helitaan ahaan.
• Marka kaydku dhammaado (ama maaddo aan ku filnayn hal mar oo kale), alaabta si toos ah ayaa kashiirada oo dhan loogu calaamadeeyaa la iibiyay oo dhan. Marka ay ku dhowaad dhammaato, badhanka alaabta waxaa ku qoran N ayaa haray. Helitaan ama tirin kadib isla markiiba mar kale ayaa la dalban karaa. Server-ka kashiirkuna wuu diidaa alaabta ("Pils" waa dhammaatay (kayd 0)), sidaas darteed xitaa tablet aan weli ogeyn.
• Kaydku wuu ka hoos mari karaa 0 (tusaale laba tablet isku mar, ama offline lagu dalbaday); tirintu dib ayay u saxdaa.
• Liiska dalabka: Dejinta → Kaydka alaabta → Liiska dalabka. Alaab kasta (alaab kasta) iyo maaddo kasta waxaad dejisaa, heerka digniinta ka sokow, buuxi ilaa iyo alaab-keenaha. Liiska dalabka waxaa ku jira wax kasta oo gaaray ama ka hooseeya heerka digniinta (heer digniin la'aan: 0), alaab-keene kasta, oo soo jeedin ahaan leh buuxi ilaa − xaaladda. Tirooyinka waa la beddeli karaa oo calaamadin/ka saari karaa. Kadib Daabac (daabacaha rasiidka), Koobi (iimayl ama WhatsApp), Dhoofi (CSV), keenista kadibna La keenay: u diiwaangeli helitaan (wax walba hal mar ayuu diiwaangeliyaa). Calaamadda xagga sare waxaad sidoo kale ku aragtaa waxa aan weli dhammaan, si aad dheeraad u dalbato.
• Ikhtiyaarrada doorashada: koox doorasho (Dejinta → Alaabta → Ikhtiyaarrada doorashada) waxay leedahay badhanka Kaydka alaabta. Doorasho kasta geli maaddooyinka xabbad kasta, tusaale Farmaajo dheeraad ah = 1 xabbo farmaajo, Baradho shiilan = 150 g baradho shiilan. Marka doorashada la doorto, maaddooyinkaas xabbad kasta ayaa laga jaraa (xitaa haddii alaabta laftigeedu aysan kayd la socon; baajinta way soo noqdaan). Haddii maaddo dhammaato, doorashada kashiirka waxay ku muuqataa (dhammaatay) lamana dooran karo.

Ka dalbo alaab-qeybiyeyaasha

Caadi ahaan waa dansan. Ka shid Dejinta → Kaydka alaabta → Ka dalbo alaab-qeybiyeyaasha (kaliya marka La soco kaydka alaabta shidan yahay). Dansan = liiska dalabku sidii caadiga ahayd ayuu u shaqeeyaa.

• Alaab-qeybiyeyaasha (tabka Alaab-qeybiyeyaasha): mid ka dooro liiska ama samee alaab-qeybiye kaaga gaar ah. Liisku wuxuu leeyahay jumladleyda iyo cash & carry (Sligro, Sligro-ISPC/Sligro-M, HANOS, Makro, De Kweker, Horeca Totaal, Van Zon, zegro, Lekkerland), foodservice (Bidfood iyo Bidfood Belgium, Solucious, Chefs Culinar, Java, Q-Food, Agora Culinair, VHC Jongens/Kreko/Actifood, Hocras, Van Hoeckel ...), jumladleyda cabitaanka (De Klok, Henk Smit, Horesca, De Monnik, Hansen, Dranken Geers ...), warshadaha biirka iyo cabitaanka fudud (Heineken oo maraya Sligro, AB InBev/BEES, Alken-Maes, Haacht, Duvel Moortgat, Martens, Coca-Cola, Spadel, Grolsch, Bavaria), alaab-qeybiyeyaasha cuntada cusub (Van Gelder, Driessen, FiliusKaas, Bakkers Brigade, Rungis ...), aan cunto ahayn (Bunzl, Takeaware, Supplierz), dukaanka khamriga ee onlaynka ah Vinify.nl iyo madallada dalabka (Apicbase, Exact Horeko, Growzer, inOne, Cuisin.io, OrderXL). Kaliya alaab-qeybiyeyaasha dalka ganacsiga ayaa ku jira. Marka aad mid doorato, habka dalabka, faylka iyo tiirarku horay ayay u saxan yihiin; alaab-qeybiye kasta waxaa ku qoran sida loogala dalbado.
• Alaab-qeybiye kasta: lambarka macmiilka, ku dalbo:
  • Iimayl: dalabka oo iimayl ah (shax leh) oo loo diro cinwaanka iimaylka dalabka, nuqul ikhtiyaari ah, liiska dalabkana lifaaq ahaan: CSV, Excel, CSV loogu talagalay Care4Fresh (jumladleyda cuntada cusub badankood), UBL 2.1 Order (Peppol BIS Order), EANCOM ORDERS (D96A Nederland, D01B/HO2C Beljiyam) ama cXML. Jawaabuhu waxay yimaadaan cinwaanka iimaylka ganacsiga.
  • Fayl: kaashku wuxuu sameeyaa faylka, adiga ayaa ku shuba bakhaarka online-ka ee alaab-qeybiyaha (tusaale Bunzl Snel bestellen: artikel;aantal, Takeaware: SKU,Quantity). Kala-saaraha, safka madaxa iyo tiirarka waa la dejin karaa (artikel, ean, omschrijving, aantal, eenheid, prijs, totaal; artikel=SKU waxaad madaxa ku siisaa magac kaaga gaar ah).
  • Isku xir (cXML): cXML OrderRequest oo leh lambarka macmiilka iyo sirta la wadaago oo loo diro cinwaanka dalabka ee alaab-qeybiyaha, sida nidaamyada iibsigu ugu diraan Sligro, HANOS iyo Bidfood. Cinwaanka, lambarka macmiilka iyo sirta waxaad ka helaysaa alaab-qeybiyaha (Sligro: koppelingen@sligro.nl). Sirtu marnaba dib ugu soo noqon mayso shaashadda.
  • Labada isku xirba waxaa sidoo kale la siin karaa magaca isticmaalaha iyo furaha sirta (Basic) iyo header-yo dheeraad ah (mid sadar kasta, tusaale X-Api-Key: ...).
  • Soo gelin (SFTP/FTPS): kaashku isagaa faylka (EANCOM, UBL, CSV, Excel ...) dhigaya gal ku yaal server-ka alaab-qeybiyaha, sida jumladlayaal badan u aqbalaan dalabaadka EDI. SFTP (SSH), FTPS (cad oo ku jira dekedda 21 ama qarsoon oo ku jira dekedda 990) ama, kaliya shabakadaada gudaheeda, FTP. Gelitaanka waxaa lagu sameeyaa furaha sirta ama furaha SSH (OpenSSH, PEM ama PuTTY .ppk; ed25519, ECDSA ama RSA). Samee fure wuxuu kaashka ku sameeyaa lammaane fure ah; furaha guud waxaad u dirtaa alaab-qeybiyaha. Tijaabi xiriirka wuu galaa oo galka raadiyaa. Raadka farta ee server-ka SFTP waxaa la diiwaangeliyaa xiriirka ugu horreeya kadibna waa la hubiyaa (server kale ma helo furaha sirta); FTPS oo leh shahaado adiga kuu gaar ah, waxaad go'aamisaa raadka farta ee shahaadada. Looma baahna software dheeraad ah.
  • Daabac: dalabka oo ka soo baxa daabacaha rasiidka, si telefoon loogu gudbiyo.
• Furaha sirta, furayaasha, token-nada iyo header-yada weligood dib uguma soo laabtaan shaashadda (madhan u daa = sidiisa u daa, Masax = ka saar).
• Codsi isku xir: alaab-qeybiye ahaan kaashku wuxuu diyaariyaa iimayl lagu codsanayo isku xir (cXML, EDI iyadoo loo marayo SFTP/FTPS, UBL/Peppol ama API-ga alaab-qeybiyaha u gaarka ah) oo ay ku jiraan xogta ganacsiga (magac, ciwaan, lambarka VAT, lambarka macmiilka, GLN) iyo waxa loo baahan yahay; EDI-da waxaa la socda furaha guud. Wax ka beddel oo dir; nuqul iyo jawaabaha waxay aadaan ciwaanka iimaylka ganacsiga. Taariikhda codsiga waxay ku qoran tahay alaab-qeybiyaha agtiisa. Sligro waxay u socotaa koppelingen@sligro.nl, haddii kale waxaad gelisaa ciwaanka maareeyaha akoonkaaga.
• Alaab-qeybiye adiga kuu gaar ah (aan ka mid ahayn liiska) wax walba wuu samayn karaa marka laga reebo waxa alaab-qeybiyaha laftiisu bixiyo: iimayl, fayl iyo daabacaad had iyo jeer way shaqeeyaan; isku xir ama soo gelin kaliya xogta alaab-qeybiyahaas.
• Maalmaha dalabka iyo keenista: maalmaha dalabka, waqtiga ugu dambeeya, muddada keenista (taariikhda keenista la rabo ee dalabka) iyo qadarka ugu yar ee dalabka. Si toos ah: maalmaha dalabka laga bilaabo waqtigaas kaashku isagaa dalab qabyo ahaan u diyaariya (adigu dib u eegaysid) ama isla markiiba u dira (iimayl, soo gelin ama isku xir; hoostiisa qadarka ugu yar ee dalabka kaliya qabyo ahaan ayaa loo diyaariyaa). Hal mar maalintii alaab-qeybiye kasta.
• Alaab kasta (Dejinta → Alaabta → (alaab) → Kaydka alaabta, meesha Alaab kasta) iyo walax kasta: Ka dalbo (alaab-qeybiyaha), lambarka dalabka ee alaab-qeybiyahaas, EAN, baakad kasta (sanduuq 24 ah = 24), magaca baakadda iyo qiimaha iibsiga baakad kasta. Heerka digniinta waa xilliga la dalbanayo; ku buuxi ilaa inta ay markaas ahaato.
• Dalabaadka iibsiga (tabka Dalabaadka iibsiga):
  • Dalab la soo jeediyay alaab-qeybiye kasta: wax kasta oo gaadhay ama ka hooseeya heerka digniinta. Waxa horay loo dalbaday oo aan weli iman (waddada ku jira) waa la xisaabiyaa, si aadan laba jeer wax u dalban. Soo jeedin = ku buuxi ilaa − kaydka − waddada ku jira (ku buuxi ilaa la'aan: ilaa heerka digniinta), kor loo dhoweeyay baakado dhan. Beddel tirooyinka oo Samee dalab.
  • Dalabku marka hore waa diyaar loo dhigay: tirooyinka, safaf gaar ah (alaab la'aan, tusaale masaxado), faallada iyo taariikhda keenista weli waa la beddeli karaa. Kadib Dir (habka alaab-qeybiyaha ama mar kale hab kale). Haddii uu fashilmo (tusaale alaab-qeybiyuhu diido), sababta ayaa la qoraa oo mar kale ayaad isku dayi kartaa.
  • La helay: saf kasta tirada la helay (horay ayay ugu qoran tahay tirada la dalbaday); kaydka alaabta waxaa lagu daraa baakad kasta (2 sanduuq oo 24 ah = 48), dalabkana taariikhda ayaa lagu qoraa.
  • Fayl kasta (CSV, Excel, UBL, EANCOM, cXML) sidoo kale si gooni ah ayaa loo soo dejin karaa.
• La diray, fashilmay, la helay iyo la joojiyay waxay galaan diiwaanka. Liiska dalabka caadiga ah wuu sii shaqaynayaa; haddii alaab ay leedahay alaab-qeybiye liiska ka mid ah, halkaas ayay ku jirtaa magacaas hoostiisa.

Maamulka faallooyinka

Ka akhri oo uga jawaab faallooyinka Google iyo Trustpilot kaashka. Ka shid Dejinta → Dhibco iyo faallooyin → Maamulka faallooyinka (caadi ahaan waa dansan, markaas meelna waxba lagama arko). Akhriska iyo jawaabta waxay ku jiraan Warbixin → Faallooyin (xuquuqda Akhri oo ka jawaab faallooyinka, caadi ahaan sidoo kale maamulaha). Haddii aad damiso, xiriirada iyo faallooyinka waa la kaydinayaa.

• Kadib ganacsi kastaa wuxuu kaliya taabanayaa Ku xir Google oo ku galayaa akoonka Google ee bogga ganacsigiisa. Furaha Places sidoo kale si dhexe ayaa loo dejin karaa (markaas kharashka waxaa bixinaya alaab-qeybiyaha). Trustpilot waa ganacsi kasta: ganacsi kastaa wuxuu leeyahay akoon Trustpilot Business oo u gaar ah (API-gu wuxuu la socdaa rukummo lacag ah), halkaasna waxaa ka yimaada furaha, sirta iyo business user ID. Kaashka, hab kasta waxaa ku qoran "Yaa dejiya tan?".
• App-ka alaab-qeybiyaha (iyadoo loo marayo portalka macmiilka): haddii app-ka Google iyo/ama app-ka Trustpilot ee alaab-qeybiyaha ay ku jiraan portalka macmiilka (eeg README-ga horecapos-portaal, "Reviews: apps van de leverancier"), maamuluhu wuxuu ku doortaa Gelid iyo furayaal App-ka alaab-qeybiyaha (caadi u ah xiriir cusub haddii portalku leeyahay app-ka). Ganacsigu wuxuu taabtaa Ku xir Google ama Ku gal Trustpilot wuxuuna ku galaa akoonkiisa gaarka ah; kaashku isagaa sugaya ilaa gelitaanku dhammaado (3 ilbiriqsi kasta, ugu badnaan 15 daqiiqo) wuxuuna hal mar ka soo qaataa tokens-ka portalka. Cusboonaysiintuna waxay sidoo kale maraysaa portalka. Kaashka looma baahna client-ID, secret ama furaha API; Trustpilot-se waxaa loo baahan yahay domain-ka iyo, jawaabaha, business user ID-ga. Akhrinta dadweynaha ee Trustpilot waxay markaas maraysaa furaha portalka. Waxay u baahan tahay PORTAAL_URL iyo PORTAAL_SLEUTEL. App kuu gaar ah ama furaha API wuxuu u shaqeynayaa sidii hoos ku qoran.
• Yaa iska leh faallooyinka: waxay ku sii jiraan Google Business Profile-ka iyo bogga Trustpilot ee ganacsiga, kaashkuna wuxuu ku kaydiyaa oo keliya keydka xogta kaashka. Jawaabuhu waxay ka muuqdaan magaca ganacsiga. Portalku wuxuu gudbiyaa oo keliya gelitaanka (xusuusta, ugu badnaan 15 daqiiqo, hal mar la soo qaadan karo) mana kaydiyo faallooyin ama tokens; magaca app-ka alaab-qeybiyaha wuxuu ku jiraa oo keliya shaashadda oggolaanshaha.
• Adigu is-diiwaangeli: madal kasta waxaa ku yaal link aad naftaada ugu sameyn karto Google Business Profile (business.google.com/create) ama akoon Trustpilot Business (business.trustpilot.com), Trustpilot-na link loo raaco qorshayaasha (business.trustpilot.com/plans). Is-diiwaangelinta iyo lacag-bixintu waxay ka dhacaan madasha lafteeda; API looma hayo.
• Kadib Ku xir Google oo ku gal akoonka maamula Business Profile. Hal laan oo profile-ka ku jirta = isla markiiba waa la doortaa; ka badan = ka dooro kaashka.
• Google Places (akhris kaliya): Place ID iyo furaha API ee Places API (ama GOOGLE_PLACES_API_KEY): celceliska, tirada faallooyinka iyo 5-ka faallo ee ugu muhiimsan. Sidan lagama jawaabi karo.
• Trustpilot Business (akhris iyo jawaab): furaha API iyo sirta API ee codsi ku jira Trustpilot Business (Integrations → API; ama TRUSTPILOT_API_KEY iyo TRUSTPILOT_API_SECRET), domain-ka goobta (kaashku wuxuu raadiyaa business unit) iyo, jawaabaha, business user ID-ga qofka jawaabaya.
• Trustpilot dadweyne (akhris kaliya): furaha API kaliya.
• Kaashku wuxuu soo qaadaa 30-kii daqiiqo kasta (iyo isla markiiba ka dib xiriirinta; Hadda soo qaado). Iimaylka iyo lambarka dalabka martida (oo Trustpilot soo dirto) kaashku ma kaydiyo.
• Warbixin → Faallooyin: celceliska, tirada xiddig kasta, jawaab la'aan iyo aan la akhriyin; ku shaandhee madal, xiddigo, jawaab la'aan iyo aan la akhriyin. Faallo kasta Ka jawaab (ugu badnaan 4000 xaraf; qof walba wuu akhrin karaa), Beddel jawaabta, Tirtir jawaabta iyo La akhriyay. Faallo cusub ama la beddelay waa aan la akhriyin. Diiwaanka waxaa ku jira review_beantwoord iyo review_antwoord_weg.
• Ka goynta xiriirka waxay haysaa faallooyinka la soo qaaday.

Suuq-geynta SMS iyo iimaylka

Fariimo loo diro macaamiisha kaarka macmiilka ee bixiyay oggolaansho. Kaarka macmiilka la'aantiis midkoodna lama shidi karo.

• Oggolaansho macmiil kasta iyo kanaal kasta: macmiil cusub oo khasnadda ah waxaa la socda calaamadaha "Macmiilku wuxuu rabaa dallacaadyo SMS ah" iyo "... iimayl ah" (caadi ahaan way dansan yihiin). Warbixin → Macaamiisha waxaad ku aragtaa oo ku beddeshaa oggolaanshaha (iyo taariikhda la bixiyay) iyo dhalashada (maalinta iyo bisha kaliya). Isa saar: calaamadaha ka saar oo kaydi.
• Menu-ga isla markiiba waa la cusboonaysiiyaa: haddii aad shido ama damiso suuq-geynta ama kaarka macmiilka, kaashku dhowr ilbiriqsi gudahood ayuu menu-ga mar kale u diraa dukaanka online-ka (keliya haddii wax isbeddeleen), si calaamaddu isla markiiba u muuqato ama u maqnaato.
• Oggolaansho dukaanka online-ka: haddii ganacsigu leeyahay dukaan online, marka lacagta la bixinayo waxaa jira calaamadda "Waxaan rabaa inaan helo dalabyo gaar ah iimayl/sms ahaan" (kanaalada shidan oo keliya; caadi ahaan waa dansan). Marka dalab noocaas ah yimaado, kaashku wuxuu macmiilka ku raadiyaa lambarka taleefanka (haddii kale iimaylka), haddii loo baahdo wuu abuuraa wuxuuna diiwaangeliyaa oggolaanshaha iyo taariikhda. Lambar ama cinwaan ka maqan macmiil jira waa la buuxiyaa; diiwaanka waxaa ku jira klant_toestemming oo isha ah webshop.
• Warbixin → Suuq-geyn (xuquuqda Maamul kaarka macmiilka): korka waxaa ku qoran inta macmiil ee oggolaaday SMS iyo iimayl.
• Dallacaadyo (hal mar): magac, SMS ama iimayl, (mawduuc,) qoraal leh {naam}, {zaak} iyo {punten}, iyo haddii aad rabto kaliya macaamiisha muddo aan iman ama leh ugu yaraan dhibco intaas le'eg. Eeg wuxuu muujiyaa inta macmiil, fariinta sida macmiilku u helayo iyo tirada SMS ee macmiil kasta. Tijaabo dir lambarkaaga ama cinwaankaaga. Kadib Dir: khasnaddu gadaal ayay ka dirtaa (ugu badnaan 1000 mar kasta) waxayna tirisaa inta la diray iyo inta fashilantay. Qofna isla dallacaadka laba jeer ma helo; haddii khasnaddu badhtamaha istaagto, Sii wad dirista waxay ka sii wadaa kuwa aan wali waxba helin.
• Ku dirista Mailchimp ama Klaviyo (marka lagu xiro liis la doortay, eeg hoose): dallacaad iimayl ah, Ku dir waxaad ka dooranaysaa kaashka (server-ka iimaylka u gaarka ah, sida kor ku xusan) ama Mailchimp ama Klaviyo. Markaas kaashku marka hore wuu cusboonaysiiyaa liiska (iska-saarista, dhibcaha) wuxuuna halkaas olole u sameeyaa si sax ah macaamiisha la doortay ee ku jira liiska (Mailchimp: koox go'an oo audience-ka ah; Klaviyo: liis u gaar ah dallacaadka), wuxuuna ku diraa diraha caadiga ah ee audience-ka ama akoonka. {naam} iyo {punten} waxaa macmiil kasta u buuxiya Mailchimp/Klaviyo; xiriirka iska-saarista ee adeegga ayaa hoosta ku jira. Ma jiro xad 1000 ah mar kasta mana jiro koodh qiimo-dhimis shakhsi ah ({code}). Haddii aysan guulaysan, dallacaadku wuxuu ahaanayaa qabyo iyadoo fariinta lagu lifaaqay. Tabka Suuq-geyn wuxuu sidoo kale jiraa marka xiriirka oo keliya firfircoon yahay (markaas dallacaadyo kaliya iyadoo loo marayo Mailchimp/Klaviyo; Tijaabo dir waxay ku shaqaysaa server-ka iimaylka ee kaashka). Fariimaha tooska ah kaashku had iyo jeer isagaa dira; Mailchimp/Klaviyo waxaad ku samaysaa sida Customer Journey ama Flow. Furaha Klaviyo: sidoo kale xuquuqda qorista ee Campaigns iyo Templates (qofkii hore u galay: dib u gal).
• Ogeysiis push ahaan iyadoo loo marayo dukaanka online-ka (haddii maaraynta dukaanka online-ka Ogeysiisyada push ee dalabyada ay shidan yihiin): U dir iyadoo loo marayo ka dooro Ogeysiis push (dukaanka online-ka oo app ah), oo leh cinwaan (ugu badnaan 60 xaraf) iyo qoraal gaaban (ugu badnaan 200 xaraf; oo keliya {zaak} ayaa la buuxinayaa, maxaa yeelay dukaanka online-ka ma yaqaan cidda martida ah). Kaashku wuxuu dallacaadda u dirayaa dukaanka online-ka iyadoo loo marayo bogga maamulka, kaasoo u dira martida halkaas ka shiday Dalacsiinno ogeysiis ahaan; taabashadu waxay furaysaa menu-ga dukaanka online-ka. Dhowr ilbiriqsi kadib dallacaadda waxaa ka muuqda inta gaartay. Ugu badnaan 3 maalintii, oo ay la socdaan waxa ganacsigu ka diro maamulka dukaanka; haddii kale dallacaaddu waxay ahaanaysaa qabyo oo sababta ayaa lagu qorayaa. Tabka Suuq-geyn wuu jiraa xataa haddii kan oo keliya shidan yahay (kaarka macmiilka ama suuq-geynta iimaylka la'aan). Kood qiimo-dhimis ama xulasho (maalmo, dhibco) ma jiro; tijaabin: taleefankaaga, dukaanka online-ka ka shid Dalacsiinno ogeysiis ahaan.
• Si toos ah: fariinta dhalashada (maalinta dhalashada, hal mar sanadkii) iyo "waanu ku xiisnay" (kadib inta maalmood ee aan la iman, hal mar markasta oo macmiilku maqnaado). Shid/dami fariin kasta; waxay baxaan maalintii kaliya (10:00–20:00).
• Kood qiimo-dhimis shakhsi ah (ikhtiyaari, fariin ama dallacaad kasta; kaliya haddii Koodhadhka qiimo-dhimista ay shidan yihiin Dejinta → Ganacsiga): macmiil kasta wuxuu helaa kood u gaar ah, tusaale TERUG-7K4Q2M (dhalasho JARIG-…, dallacaad ACTIE-…), boqolkiiba ama lacag go'an, haddii aad rabto leh qadarka ugu yar ee dalabka, hal mar la isticmaalo, ansax inta maalmood ee la dejiyay kadib dirista (caadi 30), khasnadda iyo/ama dukaanka online. Geli {code} iyo {geldig} qoraalka meesha aad rabto; haddii kale khasnaddu fariinta hoosteeda waxay dhigtaa "Uw kortingscode: … (10% korting, aan de kassa of in de webshop, geldig t/m …)". Eeg iyo Tijaabo dir waxay muujiyaan kood tusaale ah (TERUG-VOORBEELD, ma shaqeeyo). Haddii dirista ay guuldareysato, koodhka lama sameeyo. Dallacaadda waxaa ku qoran inta kood ee la bixiyay iyo inta la isticmaalay.
• Isa saar fariin kasta hoosteeda ayuu ku qoran yahay: SMS-ka "Isa saar? Wac ... ama noo sheeg booqashadaada xigta", iimaylka xiriiriye isa saar oo ku socda iimaylka ganacsiga (sidoo kale badhanka Unsubscribe ee Gmail iyo Outlook). Jawaabta iimaylka waxay u tagtaa ganacsiga.
• Asturnaanta (GDPR): kaliya macaamiisha oggolaaday oo leh lambar ama cinwaan; diiwaanka kuma jiraan lambarro ama cinwaanno, laakiin dallacaad kasta waxaa ku qoran inta la diray iyo inta fashilantay. Haddii aad macmiil tirtirto, liiska dirista ayuu sidoo kale ka baxayaa.
• Kharashka: SMS-ku waxay maraan akoonkaaga CM.com (in ka badan 160 xaraf = SMS badan macmiil kasta). Gmail iyo adeegyada kale ee iimaylka waxay leeyihiin xad maalinle ah; haddii macaamiil badan jiraan qaybo ugu dir.

Baqshiish shaqaale kasta

Dejinta → Ganacsiga → Baqshiish (kaliya haddii "Tus badhamada baqshiishka marka la xisaabinayo" shidan yahay) waxaad ku doortaa sida baqshiishka shaqaale kasta uga muuqdo natiijada ku-meel-gaarka ah (X), warbixinta Z (rasiid iyo iimayl) iyo Dakhliga muddo kasta (sidoo kale CSV-ga):

Senti-yada haray waxay u tagaan qofka ugu dhow senti-ga xiga, si wadartu had iyo jeer u saxnaato. Waa guudmar: kashiirku waxba ma bixiyo (taas waxaad ku samayn kartaa "Lacag ka bixi khaanadda"). Warbixinnadii Z ee hore sidii ay ahaayeen ayay ahaanayaan.

Warbixinta Z iimayl ahaan

Dejinta → Ganacsiga → U dir warbixinta Z iimayl hal mar geli iimaylka maamulaha (cinwaanno badan: hakad u dhexee, ugu badnaan 3). Xir maalinta kadib warbixinta Z si toos ah ayay cinwaankaas ugu tagtaa, rasiidka la daabacay ka sokow. Bannaan = iimayl ma jiro, sidii caadiga ahayd.

• Iimayl dirista waxay ka dhacdaa gadaal, si server iimayl oo gaabis ah uusan u joojin xiritaanka maalinta.
• Haddii ay fashilantay ama mar kale loo baahdo: Warbixin → Warbixinnadii Z ee hore → (warbixin) → Mar kale iimayl u dir (oo ay ku qoran tahay NUQUL).

Soo koobidda maalinta (ikhtiyaari)

Haddii cinwaan ku jiro U dir warbixinta Z iimaylka, hoostiisa waxaa ku yaal sanduuqa Iyadoo soo koobid gaaban oo maalinta ah ay ku jirto xagga sare ee iimaylka (caadi ahaan dansan). Shidan = xagga sare ee iimaylka warbixinta Z dhowr sadar oo luqad fudud ah, kaliya xogta kaashka laftiisa (AI ma jiro, waxba dibadda uma baxaan):

• dakhliga, rasiidyada iyo martida iyo celceliska rasiid kasta, marka la barbardhigo isla muddadii toddobaad ka hor (boqolkiiba); haddii markaas waxba jirin, taas ayaa la sheegayaa;
• 5-da alaab ee ugu iibka badan, iyo waxa muuqda: alaab laga iibiyay ugu yaraan 3 ka badan ama ka yar toddobaadkii hore;
• tirada storno-yada (marka la barbardhigo toddobaadkii hore) iyo saacadda ugu mashquulka badan (rasiidyada iyo dakhliga).

Warbixinta Z lafteeda (rasiidka iyo iimaylka) sideedii ayay ahaanaysaa. Tusaalaha maanta wuxuu muujiyaa soo koobidda laga bilaabo xiritaankii maalinta ee u dambeeyay ilaa hadda. Soo koobiddu waa af-Holandi, sida iimaylka warbixinta Z.

Dashboard

Tabka Dashboard ee Warbixinta (ogolaanshaha Dakhliga muddo kasta), akhris kaliya:

• Dakhliga saacad kasta garaaf ahaan: maalinta la doortay (buluug) iyo isla maalintii usbuucii hore (cawl). Maanta waxaa la barbar dhigaa usbuucii hore ilaa isla waqtigaas, si boqolleydu cadaalad u noqoto. ◀ ▶ ama taariikhda ku dooro maalin kale.
• Sanduuqyada: dakhliga (± % marka loo eego usbuucii hore), rasiidyada iyo celceliska rasiid kasta, celceliska kharashka marti kasta (kaliya goobta lagu cunay; qaadashada/gaarsiintu kuma jiraan) maalintaas iyo muddada la doortay.
• 10-ka alaab ee ugu sarreeya iyo saacadaha ugu mashquulsan 7, 28 ama 90 maalmood ee u dambeeyay. Saacadaha ugu mashquulsan waa khariidad kuleyl oo maalinta usbuuca × saacad (celceliska dakhliga maalin kasta oo furan) oo ay korkeeda ku qoran yihiin saddexda saacadood ee ugu mashquulsan, waxtar u leh jadwalka shaqaalaha.

Kaararka hadiyadda ee la iibiyay dakhli looma tiriyo, qiimo-dhimista iyo madaxyada menu-ga kuma jiraan 10-ka ugu sarreeya (sida warbixinnada kale). Maalintu waxay socotaa 00:00 ilaa 24:00.

Warbixinno dheeraad ah

Saddex tab oo dheeraad ah oo ku jira Warbixin, mid kasta si gooni ah looga shido Dejinta → Ganacsiga → Maamulka iyo warbixinnada → Warbixinno dheeraad ah (caadi ahaan dansan: markaas tab ma jiro). Waxay u baahan yihiin isla oggolaanshaha Dakhliga muddo kasta, waxayna yihiin akhris kaliya. Muddada: toddobaadkan, toddobaadkii hore, bishan, bishii hore, 90-kii maalmood ee u dambeeyay, sannadkan ama adigu dooro (ugu badnaan wax yar ka badan sannad).

• Menu engineering: alaab kasta inta jeer ee la iibiyay (saamiga dhammaan xabbadaha la iibiyay) marka loo eego waxa ay xabbaddiiba keento (faa'iido = qiimaha iibka oo aan VAT lahayn laga jaray kharashka). Alaab kasta waxay helaysaa qayb: Xiddig (caan ah oo faa'iido badan: sidaas u daa), Faras shaqo (caan ah, faa'iido yar: qiimaha xoogaa kor u qaad ama ka dhig mid ka jaban in la sameeyo), Halxiraale (wax yar ayaa la iibiyay, faa'iido badan: si fiican u muuji) iyo Eey (wax yar ayaa la iibiyay, faa'iido yar: ka saar menu-ga ama beddel). Caan = ugu yaraan 70% qayb siman; faa'iido badan = ugu yaraan celceliska faa'iidada xabbad kasta oo la iibiyay. Kharashku wuxuu ka yimaadaa Apicbase (Dejinta → Hab cunto), haddii kale qiimaha iibsiga alaabta (qiimaha iibsiga baakad kasta oo loo qaybiyay tirada baakaddii), haddii kale habka cuntada ee walxaha leh qiimaha iibsiga (Kaydka alaabta). Alaabta aan kharash lahayn si gooni ah ayay ugu jiraan xagga hoose. Ikhtiyaari: koox alaab kasta (?groep=).
• Dallacaadyo iyo koodhadh: koodh qiimo-dhimis kasta, dallacaad kasta oo ka yimid Suuq-geyn (koodhadhka shakhsiga ah wada jir) iyo happy hour kasta: inta jeer ee la isticmaalay (rasiidyo; happy hour-ka sidoo kale xabbadaha), inta qiimo-dhimis ah, dakhliga iyo celceliska rasiidkiiba.
• Khasaare: waxa laga jaray kaydka alaabta (Dejinta → Kaydka alaabta, Ka jar (−)), sabab kasta (xarfaha waaweyn iyo meelaha bannaan muhiim ma aha) iyo alaab ama walax kasta, oo leh qiimaha kharashka; iyo waxa la joojiyay kadib markii horay loogu diray jikada ama baarka, oo leh qiimaha iibka iyo qiimaha kharashka.

Qiimo-dhimis

Maareeye ama maamule wuxuu shaashadda dalbashada, wadarta agteeda, ku arkaa badhanka % Qiimo-dhimis:

• rasiidka oo dhan ama hal saf;
• boqolley ahaan (10, 15, 20, 25, 50, 100% = bilaash, ama adigu geli) ama lacag go'an;
• had iyo jeer leh sabab (Shaqaale, Macmiil joogto ah, Cabasho, Dalab gaar ah, Isticmaal gaar ah ama adigu qor).

Qiimo-dhimistu waxay rasiidka ku timaadaa saf u gaar ah ("Qiimo-dhimis 10%", sababtuna hoosta) oo leh isla heerka VAT-ka, si wadarta iyo faahfaahinta VAT-ku u saxnaadaan. Rasiidka oo dhan, qiimo-dhimista waxaa loo qaybiyaa heer VAT kasta. Si aad uga saarto: taabo lacagta safka qiimo-dhimista. Haddii saf leh qiimo-dhimis u gaar ah la joojiyo, qiimo-dhimistaasi way la baaba'daa. Haddii aad alaab ka saarto rasiid leh qiimo-dhimis boqolley ah oo rasiidka oo dhan ah, kashiirku wuxuu dib u xisaabiyaa qiimo-dhimistaas inta hartay (Beljamka UC226); lacag go'an way sii jirtaa waxaana marka lacagta la bixinayo mar kale loo qaybiyaa safafka. Haddii 100% qiimo-dhimis awgeed aan waxba la bixinayn, ku xir "Xir (waxba lama bixinayo)". Qiimo-dhimistu waxay ku jirtaa diiwaanka, iyo warbixinta X/Z iyo guudmarka muddada sida "oo ay ku jirto qiimo-dhimis". Marka rasiid leh qiimo-dhimis la celiyo, qiimo-dhimistu si saami ah ayay ula socotaa.

Koodhadhka qiimo-dhimista (ikhtiyaari)

Koodhad qiimo-dhimis ku sameeya rasiidka oo dhan, tusaale olole (ZOMER10). Ka shid Dejinta → Ganacsiga → Koodhadhka qiimo-dhimista (caadi ahaan waa dansan); koodhadhka waxaad ka samaysaa Dejinta → Koodhadhka qiimo-dhimista (oggolaanshaha Maaraynta alaabta):

• qiimo-dhimis boqolkiiba ah ama lacag go'an, haddii loo baahdo leh lacag dalab oo ugu yar, ansax laga bilaabo/ilaa iyo ugu badnaan inta jeer (madhan = xad la'aan);
• koodh kasta: khasnadda iyo/ama dukaanka online (khasnaddu koodhadhka waxay la dirtaa menuga; isticmaalka waxaa loo wada tiriyaa khasnadda iyo dukaanka online).

Shaashadda dalabka waxaa ku yaal badhanka Koodhka qiimo-dhimista (qof walba wuu gelin karaa koodh; koodhka ganacsiga ayaa horay u sameeyay). Qiimo-dhimistu waxay rasiidka ku soo baxdaa sida safka "Kortingscode CODE", oo loo qaybiyay heerarka VAT; hal koodh rasiid kasta, mana suurtagal haddii horay (qayb ahaan) wax loo bixiyay. Haddii aad safka ka saarto ama dalabka la joojiyo, isticmaalku mar dambe ma xisaabmo. Tirtiridda koodh la isticmaalay waxay damisaa (warbixinnadu way saxan yihiin). Wax walba waxay ku jiraan diiwaanka (Koodhka qiimo-dhimista). Koodh: lib/kortingscodes.ts, routes/kortingscodes.ts, Kortingscodebeheer.tsx, KortingscodeDialoog.tsx.

Kuma jiraan liiska Dejinta → Koodhadhka qiimo-dhimista (laakiin tirada dallacaad kasta waxay ku jirtaa Warbixin → Suuq-geyn) waxaana loo gudbiyaa dukaanka online inta ay ansax yihiin oo aan la isticmaalin.

Warbixinnada iyo xiritaanka maalinta

Badhanka Warbixin ee xariijinta sare:

• Natiijada ku-meel-gaarka ah (X): dakhliga, VAT-ka, hababka lacag-bixinta, koox kasta iyo khaanadda lacagta laga soo bilaabo xiritaankii maalinta ee hore. Sidoo kale waa la daabici karaa. Waxba ma xiro.
• Xir maalinta (Z) (maareeye ama maamule): tiri khaanadda lacagta (farqiga u dhexeeya lacagta bilowga + lacagta caddaanka ah ayaa la muujiyaa), geli lacagta bilowga ee maalinta xigta, xir. Warbixinta Z waxay helaysaa lambar isxiga, waa la kaydiyaa waxaana lagu daabacaa daabacaha rasiidka. Lama samayn karo inta dalabaad furan yihiin. Ikhtiyaari: Tiri qadaadiic iyo warqad kasta (caawiye tirin) wuxuu kuu gelinayaa lacagta la tiriyay; tirinta qadaadiic/warqad kastana waxay sidoo kale ku soo baxdaa warbixinta Z. Inaad adigu wadarta qorto sidii caadiga ahayd ayay u shaqaysaa.
• Khaanadda lacagta (maareeye ama maamule, ikhtiyaari):
  • Lacag ka bixi khaanadda (bangiga u dhig, kharash, baqshiish la bixiyay) ama lacag geli khaanadda (lacag sarif ah) oo leh lacagta iyo sababta. Khaanaddu way furantaa waxaana soo baxa warqad yar oo leh saf saxiix si lacagta loogu kaydiyo (waa la demin karaa). Waxay ku tirsan tahay waxa la filayo khaanadda waxayna saf kasta ugu qoran tahay warbixinta X iyo Z.
  • Geli ama sax lacagta bilowga ee maanta (caadi ahaan waxaad gelisaa xiritaanka maalinta, maalinta xigta).
  • Fur khaanadda iib la'aan, oo leh sabab.
  • Wax walba waxay galaan diiwaanka. Haddii aadan tan isticmaalin, xiritaanka maalintu sidii hore ayuu u shaqeeyaa (lacagta bilowga + lacagta caddaanka ah = waxa la filayo khaanadda).
• Dakhliga hoostiisa waxaa ku qoran tirada martida (dadka dalabaadka la xisaabiyay) iyo celceliska marti kasta, sidoo kale warbixinta X/Z ee la daabacay.
• Dakhliga muddo kasta (maareeye ama maamule): maanta, shalay, usbuucan/usbuucii hore, bishan/bishii hore, sannadkan ama adigu dooro laga bilaabo-ilaa. Wuxuu muujiyaa dakhliga, VAT-ka, hababka lacag-bixinta, baqshiishka, martida, kooxaha alaabta, maalin kasta iyo shaqaale kasta. Dhoofi (Excel/CSV) waxaad ku helaysaa fayl loogu talagalay xisaabiyaha (hakad-dhibcood iyo jajab hakad leh, wuxuu si toos ah uga furmaa Excel-ka Nederlandiiska).
• Warbixinnadii Z ee hore: liis leh dakhliga iyo farqiga lacagta; fur oo daabac nuqul (oo ay ku qoran tahay "NUQUL").

U dhoofi xisaabaadka

Warbixin → Dakhliga muddo kasta → Dhoofinta xisaabaadka (joornaal) (ogolaanshaha Dakhliga muddo kasta) wuxuu sameeyaa CSV leh hal qoraal joornaal maalin kasta, diyaar u ah in lagu soo geliyo e-Boekhouden, Exact, SnelStart, Twinfield iwm. (soo-gelintooda CSV/memoriaal), ama mid ka mid ah qaababka hoose (UBL, XAF iyo diyaar u ah 14 barnaamij).

Maalin kasta hal dukumenti (KASSA-JJJJMMDD) oo had iyo jeer isku dheelli tiran (debit = credit):

Celinta iyo qiimo-dhimistu horeba waxay ugu jiraan rasiidyada waxayna yareeyaan dakhliga. Tiirarka: Datum; Boekstuk; Dagboek; Rekening; Omschrijving; Debet; Credit; Btw-code; Btw-% (hakad-dhibcood, jajab hakad leh). Soo-dejinta kadib, kashiirku wuxuu sheegaa haddii ay jiraan maalmo aan isku dheelli tirnayn ama farqi ka weyn dhowaynta leh.

Badhanka agtiisa waxaad ka dooranaysaa qaabka (doorashada waxaa xasuusta browser-ka). Isla joornaalka, laakiin loo qaabeeyay si barnaamijku si toos ah u akhrin karo. Liisku wuxuu muujiyaa oo keliya qaababka dalka ganacsiga (Dejinta → Ganacsiga), marka hore heerarka (CSV, UBL, XAF), kadib barnaamijyada sida alifbeetada:

Dulmar: barnaamij xisaabeedkee iyo habkee

Qayb kasta, sida alifbeetada. NL/BE = dalka uu barnaamijku ka shaqeeyo: Dejinta → Xisaabaadka → Barnaamijka xisaabaadka waxaad ku arkaysaa oo keliya barnaamijyada dalka ganacsiga (barnaamijyada Nederland kama shaqeeyaan Beljim, sidoo kale lidkeeda). Toos = khasnaddu maalin kasta iyadaa diiwaangelisa (laga doorto Dejinta → Xisaabaadka → Barnaamijka xisaabaadka); codsi ahaan = API ayaa jira, laakiin marka hore waxay u baahan tahay diiwaangelin lammaane ama ogolaansho bixiyaha (noo sheeg). Fayl = qaabka ku jira Dhoofinta xisaabaadka. Meesha labaduba suurtagal yihiin, labadaba waad isticmaali kartaa. Liisku wuxuu ku jiraa packages/shared/src/boekhoudcatalogus.ts wuxuuna sidoo kale ka muuqdaa Dejinta → Xisaabaadka.

Xisaabiyaha ha eego soo-gelinta ugu horreysa. Qaabeynta waxay ku jirtaa packages/shared/src/journaalexport.ts (tijaabooyin la socda).

Dejinta → Xisaabaadka (ogolaanshaha Deji ganacsiga, lacag-bixinta iyo daabacayaasha): koodka joornaalka (caadi ahaan MEM) iyo xisaabta buugga guud qayb kasta. Bannaan = xisaab tusaale ah (NL: 8000/8010/8020 dakhli, 1500/1510 VAT, 1000 lacag caddaan ah, 1100 kaar; BE: 7000xx dakhli, 451000 VAT, 570000 lacag caddaan ah). Xisaabiyaha ha geliyo xisaabaadka dhabta ah.

Isku xirka barnaamijka xisaabaadka

Isku xirro toos ah oo lala sameeyo Acumulus, AFAS Profit, Microsoft Dynamics 365 Business Central, Exact Online, Horus, Moneybird, Odoo, QuickBooks Online, SAP Business One, Silvasoft, SnelStart, Twinfield, Xero, Yuki iyo Zoho Books. Maalin kasta kadib khasnaddu waxay isla jaraa'idka dhoofinta kor ku xusan (dakhliga iyo VAT-ga heer kasta, hababka lacag bixinta, baqshiishka, isku soo koobidda, khaanadda iyo farqiga lacagta) sidii diiwaan memoriaal ah ugu diiwaangelisaa barnaamijka la doortay, iyadoo la adeegsanayo buugga maalinlaha iyo xisaabaadka buugga weyn ee Dejinta → Xisaabaadka. Had iyo jeer ugu badnaan hal barnaamij ayaa shidan.

• Liisku wuxuu u qaybsan yahay qaybo (Ganacsiyada yaryar iyo kuwa dhexe iyo shaqo-u-qabsoonayaasha, Caalami, Shirkadaha waaweyn iyo silsiladaha) wuxuuna muujiyaa oo keliya barnaamijyada ka shaqeeya dalka ganacsiga; server-ku wuxuu diidaa barnaamij dal kale ah (400) mana ku diiwaangeliyo (409). Isla hoostiisa maamulaha wuxuu helaa goobaha saxda ah ee barnaamijkaas; isku xirka iyo liiska maalmaha la diiwaangeliyay waxay ku jiraan xisaabaadka buugga weyn hoostooda, oo ay ka hooseeyaan dulmarka dhammaan barnaamijyada dalkan. Haddii markii la cusboonaysiiyay laba shidnaayeen (nooc hore taasi waa suurtagal ahayd), Exact Online wuu shidnaanayaa, barnaamijka kalena waa la damiyaa.

• OAuth (Horus, QuickBooks, Twinfield, Xero, Zoho): hal mar app ka diiwaangeli barnaamijka.
• Barnaamijyada qaarkood goobaha API-gooda si buuxda lagama xaqiijin karo dukumentiga furan (tusaale Horus, Zoho Books, calaamadda Business Central iyo dhismaha SAP Business One): diiwaangelinta ugu horreysa had iyo jeer xisaabiyuhu ha hubiyo.
• Exact Online: wuxuu jaraa'idka u diiwaangeliyaa sidii diiwaan memoriaal ah maamulka xisaabaadka la doortay.
  • Ka dooro Dejinta → Xisaabaadka → Barnaamijka xisaabaadka → Exact Online (caadi ahaan Dansan). Beljim: khasnaddu iskeed ayay u isticmaashaa start.exactonline.be.
  • Dejinta → Xisaabaadka → Exact Online: Ku xir Exact Online wuxuu furaa galitaanka Exact; kadib waxaa ku qoran maamulka xisaabaadka ee khasnadda lagu xiray. Buugga maalinlaha ku qor koodka memoriaal ee Exact (tusaale 90) oo hubi in xisaabaadka buugga weyn ay Exact ku jiraan.
  • Goorma: isla markiiba kadib Xir maalinta iyo saacad kasta kadib, dhammaan maalmihii tagay (ilaa shalay) laga bilaabo Diiwaangeli laga bilaabo (caadi ahaan maalinta la isku xiray; maalmihii hore xisaabiyaha ayaa haysta). Maalin kasta hal mar; maalmaha aan dakhli lahayn waa laga boodaa. Hadda diiwaangeli had iyo jeer waa la samayn karaa.
  • Khaladaadka (xisaab aan Exact ku jirin, maalintu isma dheellitirmin, internet ma jiro) waxay la muuqdaan maalintaas iyo sababta; khasnaddu mar dambe ayay isku daydaa, maalmaha xigana way sugaan ilaa ay guulaysato (si kala horreyntu u saxsanaato). Diiwaanka: "exact_geboekt".
  • VAT-gu wuxuu ku jiraa xisaabaadka buugga weyn ee VAT (kood VAT la'aan, sida dhoofinta). Diiwaannada ugu horreeya xisaabiyahaaga ha eego.
  • Exact: isku xirku wuu shaqeeyaa inta khasnaddu isticmaasho (token cusub 10 daqiiqo kasta, mar kasta refresh token cusub). Haddii la laalay ama muddo dheer aan la isticmaalin, khasnaddu waxay ku weydiinaysaa Mar kale ku xir. Ka goo xiriirka wuxuu tirtiraa token-nada; waxa la diiwaangeliyay way sii jiraan.
• AFAS Profit: lambarka deegaanka (tusaale 12345; wax-soo-saar, tijaabo ama aqbalaad), token-ka app-connector leh UpdateConnector FiEntries iyo lambarka maamulka (caadi ahaan 1). Buugga maalinlaha = koodka memoriaal ee AFAS (tusaale 90).
• Buugga maalinlaha = lambarka ama magaca buug maalinle memoriaal ah; haddii uu jiro hal buug maalinle memoriaal ah oo keliya, khasnaddu kaas ayay qaadataa. Xisaabaadka buugga weyn waa inay lambarro noqdaan.
• Twinfield: galitaan OAuth. App-kaas la'aantiis khasnaddu ma xirmi karto. Khasnaddu waxay raadisaa cluster-ka iyo maamulka (bannaan = kan ugu horreeya); buugga maalinlaha = koodka memoriaal (tusaale MEMO). Waxay u diiwaangelisaa si kama dambays ah (destiny="final").
• Yuki: furaha API ee maamulka (Yuki → Dejinta → Adeegyada webka); maamulka oo bannaan = kan ugu horreeya ee furahaas. Wuxuu diiwaangeliyaa memoriaal (GeneralJournal); Yuki ma isticmaalo koodka buugga maalinlaha.
• Goorma: isla markiiba kadib Xir maalinta iyo saacad kasta, dhammaan maalmihii tagay laga bilaabo Diiwaangeli laga bilaabo (caadi ahaan maalinta la isku xiray; barnaamij kale markaas mar kale laga bilaabo maalintaas). Maalin kasta hal mar barnaamij kasta; maalmaha aan dakhli lahayn waa laga boodaa; haddii khalad dhaco sababta waxay la muuqataa maalintaas, maalmaha xigana way sugaan. Hadda diiwaangeli had iyo jeer waa la samayn karaa. Diiwaanka: "boekhoudpakket_geboekt".
• Furayaasha iyo token-yada marnaba shaashadda ma yimaadaan (bannaan ka tag marka mar kale la isku xirayo = sidiisa u hay). Nuqulka khasnadda ee bogga portal-ka wax lagama diiwaangeliyo.

Faylka hanti-dhowrka kaashka (XAA)

Ganacsiyada Nederland, gudaha Warbixin → Dakhliga muddo kasta waxaa ku xiga dhoofinta xisaabaadka badhanka Faylka hanti-dhowrka kaashka (XAA): XML Auditfile Afrekensystemen 3.2 ee Belastingdienst (Maamulka Canshuuraha Nederland) iyo XML Platform (SRA) ee muddada la doortay (ugu badnaan wax yar ka badan hal sano; ogolaanshaha Dakhliga muddo kasta). Kani waa faylka ay Belastingdienst ku talisay in lagu bixiyo xogta kaashka marka la kormeerayo ama xisaabiyaha; xeerarku waxay ku qoran yihiin Handreiking voor een betrouwbaar afrekensysteem (Hagaha nidaam lacag-qabasho oo la isku halleyn karo) (docs/xaa).

Faylka dhexdiisa (auditfile_kassa_<van>_tm_<tot>.xml, qorshaha docs/xaa/XmlAuditfileAfrekensystemen3.2.xsd):

• xogta aasaasiga ah: ganacsiga (magaca, lambarka VAT-ga, cinwaanka), koodhadhka VAT-ga, dhammaan shaqaalaha (doorkooda iyo taariikhda la abuuray; iyo SYSTEEM waxa kaashku isagu sameeyo, sida dukaanka online-ka iyo isku xirnaanshaha) iyo dhammaan alaabta iyo kooxdooda;
• dhacdooyinka: wax kasta oo ku jira diiwaanka muddada (gelitaan iyo ka bixid, furitaanka khaanadda lacagta, xiritaanka maalinta, beddelka dejinta iyo qiimaha, storno, qiimo-dhimis, celin, nuqul rasiid, gelitaan iyo ka bixitaan shaqo ...) iyo furitaanka maalinta kaashka oo leh lacagta bilowga, mid kastaa wuxuu leeyahay koodhka Belastingdienst (18001 gelitaan, 18003 khaanad, 18006 beddelka rakibaadda, 18008 warbixinta Z, kuwa kale 18999);
• macaamilada kaashka: rasiid kasta (iib, celin iyo proforma, oo leh lambarka rasiidka, shaqaalaha iyo xaaladda canshuurta haddii aysan sax ahayn) oo leh dhammaan safafka (alaab, koox, tiro, qiimo, VAT; sidoo kale qiimo-dhimisyada, kaararka hadiyadda, cinwaannada menu-ga iyo safafka la joojiyay ka hor lacag-bixinta, kuwaas oo leh qadarka 0), VAT-ga heer kasta, soo-koobidda, lacag-bixinnada hab kasta (kaash, kaarka, kaarka hadiyadda, online; tip-ka si gaar ah) iyo lacagta la geliyo/laga saaro khaanadda lacagta.

Qadarradu waa togan yihiin oo leh C (iib, helid) ama D (celin, bixin); waqtiyadu waa waqtiga Nederland oo leh farqiga. Dhammaan furayaashu waa id-yada keydka xogta oo aan lahayn xariijimo, sidaas darteed waa laga heli karaa kaashka.

Saxiixid (cutubka 6 ee faahfaahinta): haddii Optimum POS dejiyay shahaado, faylka hanti-dhowrku wuxuu imanayaa isagoo la saxiixay oo ku jira baqshad (XML Signature), faylkuna wuxuu la baxayaa …_ondertekend.xml; haddii kale waa fayl hanti-dhowr oo keli ah, kaashkuna taas ayuu sheegaa marka la soo dejinayo.

Bixinta deynta

Macaamiisha ganacsiga (shirkad toddobaad kasta qado soo qaadata, hoteel, urur) waxay wax ku iibsadaan deyn oo hadhow ayay bixiyaan, qaansheeg. Ka shid Dejinta → Qaansheegyo → Bixinta deynta (kaliya marka Qaansheegyo shidan yihiin; caadi ahaan waa dansan yahay).

• Macaamiisha: Warbixin → Deyn waxaad ku diiwaangelisaa macaamiisha ganacsiga iyo xogta qaansheegga (magac, cinwaan, lambarka VAT, lambarka KvK/shirkadda, Peppol-ID, iimayl), haddii loo baahdo xadka deynta (inta ugu badan ee harsan karta) iyo muddo bixin gaar ah (haddii kale tan qaansheegyada), iyo in qaansheegga isla markiiba la diro.
• Bixi lacagta: habka bixinta Deyn, dooro macmiilka (iyadoo la muujinayo waxa horay u harsan iyo xadka). Rasiidku waa iib caadi ah: dakhliga iyo VAT-ka maalintaas, Beljim sida caadiga ah sanduuqa madow (zwarte doos), rasiidka waxaa ku qoran "Deyn". Kaashku isla markiiba wuxuu sameeyaa qaansheegga (UBL/Peppol iyo mid la daabaco) oo leh lacagta weli harsan iyo taariikhda bixinta, wuxuuna u diraa sida loo dejiyay qaansheegyada (iimayl, Peppol iyada oo loo marayo Billit/Storecove/Banqup ama cinwaanka gaarka ah). Deyntu waa hal lacag oo ah inta ka hartay biilka (qayb hore si kale ayaa loo bixin karaa), bakhshiish la'aan; kaarka hadiyadda deyn laguma iibin karo. Haddii xadka la dhaafo, kaashku wuu diidaa.
• Bixinta: macmiilku wuxuu dukaanka ku bixiyaa kaash, kaar ama kaarka hadiyadda (Warbixin → Deyn → Lacag la helay; qayb ahaanna). Taasi iib cusub maaha, rasiid cusubna maaha: kaashku wuxuu galaa khaanadda (khaanaddu way furmaysaa), wax walbana waxay X iyo Z ku jiraan Deyn la helay. Marka wax walba la bixiyo, qaansheeggu wuxuu noqdaa "la bixiyay". Lacag-bixinta online-ka kuma jirto.
• La wareejiyay: haddii IBAN lagu qoray Xogta qaansheegga, wuxuu ka muuqanayaa qaansheegga (iyo UBL-ka), oo ay la socoto "Waxaad sidoo kale ku bixin kartaa dukaanka". Haddii macmiilku lacagta wareejiyay, waxaad ku diiwaangelinaysaa Lacag la helay → La wareejiyay (bangi): sanduuqa ma galayso, laakiin waxay ka muuqanaysaa X iyo Z hoosta Deyn la helay. IBAN la'aantiis waxaa ku qoran "Lagu bixinayo dukaanka". Beljamka qaansheegga iyo UBL-ka waxaa ku qoran tixraac lacag-bixineed oo habaysan (+++123/4567/89012+++, oo laga sameeyay lambarka qaansheegga), si bangigu ula soo diro.
• Bangi: ku diiwaangeli lacag-wareejinta qaansheegyada adigoon dib u qorin, eeg hoos.
• Haraa (lacag hore): Warbixin → Deyn → Dhig haraa waxaad lacag horay ugu dhigtaa koontada macmiil, kaash (khaanaddu way furmaysaa) ama kaar, tusaale qado taxane ah. Iibka deynta ee xiga, haraagu marka hore wuxuu ka go'aa qaansheegga; haddii qaansheeggu ka badan yahay, inta kale way furan tahay. Haraagu wuxuu ku qoran yahay macmiilka (haraa € ...), X iyo Z hoostooda Deyn la helay (Haraa la dhigay, Haraaga macmiilka) iyo buugga sida horay loo helay (asal ahaan 1640 / 460000). Beljamka dhigiddu waxay sanduuqa madow ugu socotaa lacag soo gashay (signMoneyInOut) (UC4100).
• Qaansheeg wadareed (macmiil kasta, caadi ahaan dansan): Hal qaansheeg dhammaan rasiidyada markay shidan tahay, macmiilku weli qaansheeg ma helo iibka deynta. Rasiidku wuxuu u furan yahay macmiilka (Rasiidyo aan weli qaansheeg loo samayn, waxaa lagu tiriyaa xadka) waana la bixin karaa hadda. Samee qaansheeg wadareed (tusaale dhammaadka bisha) dhammaan rasiidyada furan waxay galaan hal qaansheeg, sadar kasta lambarka rasiidka hortiisa; wixii hore loo bixiyay waxaa lagu calaamadeeyaa la bixiyay. Celin koontada ah waxay u soo baxdaa sadaro taban. Dansan = sidii had iyo jeer hal qaansheeg iib kasta. Beljiyam hal qaansheeg oo leh dhammaan rasiidyada sanduuqa madow (signInvoice, UC4121 iyo UC4122).
• Beljamka: haddii macmiilku hadhow bixiyo iib deyn ah (kaash, kaar, kaarka hadiyadda ama wareejin), kashiirku wuxuu rasiidka ku soo sheegaa saxid lacag-bixineed: deynta macmiilka ilaa habka lacag-bixinta dhabta ah (signPaymentCorrection, UC4118).
• Guudmar: qaansheegyada harsan iyo taariikhda bixinta (kuwa dib u dhacay waa casaan), macmiil kasta qaansheegyadiisa iyo lacag-bixinnadiisa. Dejinta → Qaansheegyo waxaa ku jira tiir Harsan.
• Xisaabaadka: buugga maalinlaha ah iibka deynta wuxuu aadaa Deymaha la sugayo (caadi ahaan 1300 Nederland, 400000 Beljim; waxaa lagu dejin karaa Dejinta → Xisaabaadka), lacag-bixinta kaash, kaar, kaarka hadiyadda ama bangi (caadi ahaan 1050 / 550000) waxay u gudubtaa deymaha la sugayo. XAA: habka bixinta "Deyn".
• Xuquuq: Deyn ku bixi oo hel lacag-bixinnada deynta (caadi ahaan adeegaha maya, maareeyaha haa). Wax walba waxay ku qoran yihiin diiwaanka.
• Dansan: macaamiisha, qaansheegyada iyo lacag-bixinnada waa la kaydinayaa (sidoo kale nuqulka kaydka); furaha wuxuu raacaa dhoofinta dejinta, macaamiishuse ma raacaan (waxay ka tirsan yihiin hal dukaan).
• Dukaanka online (ikhtiyaari, caadi ahaan waa dansan): marka Sidoo kale dukaanka online shidan yahay, macaamiisha ganacsigu waxay online ku dalbadaan deyn (qaadasho iyo keenis). Warbixin → Deyn waxaad macmiil kasta u samaysaa koodhka macmiilka oo aad siisaa macmiilka; kaashku wuxuu kaydiyaa nooc sir ah oo keliya, markaa hal mar ayaad aragtaa. Koodh macmiil cusub = kii hore ma shaqaynayo; Tirtir koodhka macmiilka = macmiilkaas mar dambe online kuma dalban karo deyn. Dukaanka online wuxuu ilaaliyaa xadka. Daaqadda Dukaanka online dalabkaas waxaad ku dhammaysaa Dhammee (deyn): bixin deyn ah, isla markiiba qaansheegga.

Bangi: ku diiwaangeli lacag-wareejinta qaansheegyada

Gudaha Warbixin → Deyn → Bangi kaashku wuxuu lacag-soo-gelin kasta u raadiyaa qaansheegga deynta ee ku habboon:

• Soo geli bayaanka bangiga: faylka bangiga internetkaaga, sida CAMT.053 (XML, dhammaan bangiyada Nederland iyo Beljamka), MT940 (.sta/.940) ama CODA (.cod, Beljamka). Lacag-soo-gelin oo keliya; bayaan laba jeer la soo geliyo ma sameeyo saf labanlaaban.
• Raadin: lambarka qaansheegga ama tixraaca lacag-bixinta ee habaysan ee sharaxaadda ku jira (hubaal), haddii kale lacagta (iyo magaca): markaas waa soo jeedin. Saf kasta waad diiwaangelin kartaa (soo jeedinta ama qaansheeg kale), iska indha tiri kartaa ama hadhow hadana diiwaangelin kartaa. Diiwaangelin = La wareejiyay (bangi) taariikhda bangiga, weligeed kama badna inta furan; sanduuqa ma gasho.
• Isku xirka bangiga (PSD2, ikhtiyaari): gudaha Dejinta → Qaansheegyo → Isku xirka bangiga kaashku saacad kasta isagu ayuu soo qaadaa lacag-soo-gelinta isagoo adeegsanaya Enable Banking (bangiyada Nederland, Beljamka iyo inta kale ee Yurub). Dooro bangiga oo gal bangiga (koonto ganacsi); ogolaanshuhu wuxuu socdaa 180 maalmood, kadib mar kale ku xir. Ka goynta xiriirku wuxuu kala noqdaa ogolaanshaha; lacag-soo-gelintu way harayaan. Qandaraas la'aan Enable Banking, tani waxay u shaqaysaa koontooyinkaaga gaarka ah oo keliya (restricted production).
• Diiwaangelin toos ah (caadi ahaan dansan): lacag-soo-gelin si hubaal ah qaansheeg ugu xiran, kaashku isla markiiba wuu diiwaangeliyaa (xitaa marka la soo gelinayo).
• Ogolaansho: diiwaangelinta waxaa loo baahan yahay Deyn ku bixi oo hel lacag-bixinnada deynta; dejinta isku xirka bangiga waxaa loo baahan yahay Deji ganacsiga, lacag-bixinta iyo daabacayaasha. Soo gelinta, isku xirka, soo qaadista iyo diiwaangelinta waxay ku jiraan diiwaanka.
• Dansan: marka bixinta deynta dansan tahay kaashku waxba ma soo qaado; lacag-soo-gelinta iyo isku xirku way kaydsan yihiin (xitaa kaydka nuqulka).

Muuqaallada kamaradaha ee kaashka

Dhammaan muuqaallada kamaradaha ganacsiga hal bog, la'aan shaashad ama app gaar ah. Ka shid Dejinta → Ganacsiga → Shaashadaha iyo isticmaalka → Muuqaallada kamaradaha ee kaashka (caadi ahaan waa dansan yahay). Markaas badhanka Kamaradaha wuxuu ka muuqdaa baarka sare qofkii leh ogolaanshaha Daawo muuqaallada kamaradaha (caadi ahaan maareeye iyo maamule; Dejinta → Ogolaanshaha waxaa sidoo kale loo shidi karaa adeegaha). Dhammaan kamaradaha waa is-ag yaallaan; taabo kamarad si aad u aragto muuqaal weyn. Damin: nidaamyada kamaradaha way kaydsan yihiin.

Sidoo kale shaashad gaar ah: Shaashad gaar ah waxay furtaa http://<kassaserver>:3000/camera (tusaale shaashad baarka gadaashiisa ah), Tablet ama telefoon wuxuu muujiyaa QR code: shaqaale ayaa ku iskaan gareeya tablet-kiisa ama telefoonkiisa wuxuuna ku galaa PIN-kiisa (halkaasna oo kaliya xuquuqda Daawo muuqaallada kamaradaha). Shaashad cidhiidhi ah kamaraduhu midba midka kale hoostiisa ayuu yaal. Eeg Shaashad labaad oo tablet ama telefoon ah.

Maamuluhu wuxuu ku daraa nidaamyada kamaradaha + Nidaam kamarad, wuxuu ku tijaabiyaa Tijaabi wuxuuna kamarad kasta u doortaa magaca iyo inuu bogga ku jiro:

• Hikvision, Dahua, Axis iyo Reolink: kamarad ama duube (NVR) shabakadda ku jira: ciwaanka IP (haddii loo baahdo leh :poort), isticmaale (haddii ay suurtagal tahay daawasho kaliya) iyo kanaallada, tusaale 1-8 ama 1,3,5. Gelitaan Basic ama Digest; https leh shahaado gaar ah waa la oggol yahay.
• Synology Surveillance Station: ciwaanka NAS-ka (caadi ahaan dekedda 5000, https-na 5001) iyo isticmaale; Soo qaado kamaradaha wuxuu soo qaadaa kamaradaha iyo magacyadooda.
• UniFi Protect: ciwaanka konsoolka (https) iyo akoon maxalli ah; Soo qaado kamaradaha.
• ONVIF: kamarad kasta ama duube kasta oo ONVIF leh (tusaale Hanwha, Bosch, Uniview, Annke); Soo qaado kamaradaha wuxuu raadiyaa ciwaanka sawirka il kasta oo muuqaal ah.
• Ciwaan web gaar ah: sawir (JPEG), qulqul MJPEG ah ama ciwaan rtsp:// ah.
• Bogga web ee nidaamka kamaradaha (tusaale Frigate, Blue Iris ama go2rtc): wuxuu ka furmayaa kaashka marka la riixo badhanka Kamaradaha (ama daaqad gaar ah).

La'aan ffmpeg: sawirka.

Asturnaanta: kaashku wuxuu muuqaallada ka soo qaadaa nidaamka kamaradaha oo kaliya u gudbiyaa; waxba lama kaydiyo (duubis ma jirto, cache ma jiro). Isticmaalayaasha iyo furayaasha sirta waxay ku jiraan server-ka mana ka muuqdaan shaashadda ama diiwaanka. Diiwaanka waxaa ku qoran cidda daawatay kamaradaha. Bogga wuxuu muuqaallada ku codsadaa fure (12 saacadood ayuu shaqeeyaa, inta shaqaaluhu galsan yahay), sababtoo ah muuqaal browser-ka ku jira ma diri karo token. Dhoofinta habaynta waxay qaadataa shid/dansan oo kaliya.

Diiwaanka ficillada xasaasiga ah

Warbixin → Diiwaanka (maareeye ama maamule) wuxuu muujiyaa cidda wax samaysay, waxa ay samaysay iyo goorta.

• Dooro muddo (maanta, shalay, usbuucan, bishan/bishii hore ama adigu laga bilaabo-ilaa), waxa aad rabto inaad aragto (caadi ahaan Ficillada xasaasiga ah, ama tusaale kaliya baajinta iyo qiimo-dhimista, ama Dhammaan) iyo haddii aad rabto hal shaqaale.
• Xagga sare shaqaale kasta: tirada iyo lacagta baajinta (la tirtiray dalbashada kadib), qiimo-dhimista iyo celinta, iyo inta jeer ee khaanadda la furay iib la'aan, lacag laga bixiyay khaanadda, nuqullada rasiidka, pro forma-yada iyo bixinta kaarka gacanta lagu sameeyay. Taabo magac si aad u aragto kaliya shaqaalahaas. Sidoo kale inta jeer ee PIN khaldan la geliyay.
• Hoostiisa ficil kasta oo leh waqtiga, cidda, waxa iyo sharraxaad la akhrin karo (tusaale "2x Cola la tirtiray dalbashada kadib € 5,60 · miiska 4 · sabab: macmiilku ma rabin").
• Soo dejiso (CSV) Excel ahaan.

Waxa la diiwaangeliyo: tirtirista, qiimo-dhimisyada (iyo ka saaristooda), soo celinta, nuqullada rasiidhada, pro forma, kaar-bixinta gacanta, furitaanka khaanadda, lacag gelin/ka bixin khaanadda, lacagta bilowga, xiritaanka maalinta, u wareejinta safafka ama miisaska, xiritaanka dalabyada madhan, beddelka qiimaha/magaca/VAT-ka alaabta, alaab cusub ama la tirtiray, beddelka shaqaalaha iyo dejinta, hagaajinta saacadaha shaqada, gelitaanka iyo ka bixitaanka, PIN khaldan iyo saacad-gelinta iyo saacad-ka-bixinta. Bixinta deynta sidoo kale: macaamiisha, iibka iyo lacag-bixinta deynta, akhrinta bayaannada bangiga, isku xirka bangiga iyo ka soo qaadashada bangiga. Ogeysiiska waqti diyaarin dheer: dalabyada daahay iyo raalligelinta la diray. Mailchimp ama Klaviyo: ku xiridda, dooranta liiska, ka goynta xiriirka iyo iska-saaridda halkaas ka timaada. Xakamaynta muusigga: shid/dansan iyo ku darista, beddelka iyo ka saaridda ilaha muusigga. Muuqaallada kamaradaha: cidda daawatay kamaradaha (ugu badnaan hal mar nus saacaddiiba shaqaale kasta), shid/dansan iyo nidaamyada kamaradaha. Ilaalinta: digniin kasta, xallinteeda iyo shidista iyo demista.

Ilaalinta: khiyaano iyo isbeddello aan caadi ahayn

Dejinta → Ilaalinta. Laba qaybood, mid kasta si gooni ah loo shido, si caadi ahna way dansan yihiin; demintu waxay kaydisaa dhammaan digniinaha iyo dejinta. Dejin kara qofka leh xuquuqda Dejinta ilaalinta (si caadi ah maareeyaha iyo maamulaha); digniinaha arki kara oo xallin kara qofka loo oggol yahay inuu arko diiwaanka. Khasnaddu waxay hubisaa 5-kii daqiiqo kasta (iyo Hadda hubi); kuma jirto khasnadda hooska.

Ilaalinta khiyaanada iyo xatooyada (shaqaale kasta, maalin shaqo kasta laga bilaabo 05:00), xeer kasta si gooni ah loo shido ama loo damiyo oo leh xad u gaar ah:

• storno kadib pro forma: la tirtiray kadib markii martidu aragtay biilka;
• storno, qiimo-dhimisyo iyo celinno: laga bilaabo tiro jeer ah, ama wadar ahaan laga bilaabo lacag (0 = lacag kuma salaysna);
• khaanad la furay iib la'aan (badhanka Fur khaanadda);
• rasiid muddo dheer furan: la dalbaday laakiin dhowr daqiiqo kadib aan weli la bixin.

Ogeysiisyada isbeddellada aan caadiga ahayn, marka la barbardhigo isla maalinta toddobaadka iyo isla waqtiga toddobaadyadii hore (si caadi ah 4; maalmaha aan dakhli lahayn lama tiriyo, ugu yaraan laba maalmood oo barbardhig ah):

• dakhliga ilaa hadda in ka badan farqiga ka hooseeya (iyo/ama ka sarreeya) caadiga, kaliya marka dakhliga caadiga ahi gaaro lacag la dejiyay;
• waqtiga jikada (rasiidka jikada ilaa diyaar shaashadda jikada) saacaddii u dambaysay ee ka badan farqiga, ama ka badan tiro daqiiqo go'an;
• storno maanta ka badan farqiga, kaliya laga bilaabo tiro ugu yar.

Digniin kastaa hal mar ayay timaadaa (xeer, shaqaale iyo maalin kasta; waqtiga jikada ugu badnaan hal mar saacaddiiba) waxayna u socotaa:

• khasnadda: badhanka Digniinaha (n) ee baarka sare oo leh digniinaha maalintii, toddobaadkii ama 30 maalmood ee la soo dhaafay; La xalliyay oo leh qoraal. Shaashadaha kale waxay helaan kaliya calaamad aan magacyo lahayn;
• fariin push oo ntfy ah (app bilaash ah; ntfy.sh ama server kuu gaar ah, topic iyo haddii loo baahdo token), Pushover (API-token-ka app-ka iyo user key) ama Telegram (token-ka bot-ka iyo chat-id);

Kanaal kasta waxa uu leeyahay badhan Fariin tijaabo. Token-yada iyo furayaashu waxay ku hadhaan khasnadda (shaashaduhu waxay arkaan kaliya haddii la buuxiyay). Digniin ma aha caddayn: eeg rasiidka iyo diiwaanka, kalana hadal shaqaalaha.

Rasiidyada: nuqul iyo celin (rasiidka deyn-celinta)

Badhanka Rasiidyada ee xariijinta sare:

• Liiska rasiidyada laga soo bilaabo xiritaankii maalinta ee u dambeeyay, ama 7-kii maalmood ee u dambeeyay; rasiid ka duqsan waxaad ku raadisaa lambarkiisa.
• Daabac nuqul: isla rasiidka oo ay ku qoran tahay "NUQUL" (Beljiyam oo leh qaybta FDM ee rasiidka asalka ah). Waxaa lagu diiwaangeliyaa diiwaanka.
• Celin / rasiidka deyn-celinta (maareeye ama maamule): saf kasta dooro inta soo noqonaysa, sabab iyo sida lacagta loo celinayo (lacag caddaan ah, kaar, kaarka hadiyadda, kale). Rasiidkii hore lama taabto: waxaa lagu darayaa rasiid deyn-celin cusub oo leh lambar u gaar ah joornaalka (nooca ticket-ka retour, lacago taban, Beljiyam waxaa loo diraa FDM-ka sida NR). Marnaba lama celin karo wax ka badan inta la iibiyay. Warbixinta X iyo Z celintu waxay u tirsan tahay dakhli taban.
• CCV ama mashiin kale: marka hore lacagta ku celi mashiinka laftiisa, kadib calaamadee "Horeba loogu celiyay mashiinka".
• Lacag caddaan ah oo loo dhoweeyay 5 senti: lacagta la celinayo sidoo kale waa la dhoweeyaa.
• Dib ugu celi koontada (iib deyn ah): haddii rasiidku ahaa deynta macmiil ganacsi, dooro Deyn. Lacagta waxaa laga jaraa qaansheegga furan, kashiirkuna isla markiiba wuxuu sameeyaa qoraal deyn-celin (UBL-ka CreditNote, nooca 381, oo tixraac u leh qaansheegga; Beljamka lagu saxiixay signInvoice, UC4122). Wax ka badan inta qaansheegga ka furan dib looguma celin karo koontada; inta kale ku celi kaash ama kaar. Qoraalka deyn-celinta wuxuu ku jiraa Qaansheegyo waxaana loo diraa sida qaansheeg.

Khaanadda lacagta oo dareeme leh iyo khaanad shaqaale kasta

Caadi ahaan waa dansan. Ka deji Dejinta → Lacag bixinta → Khaanadda lacagta.

• Dareeme: khaanado badan ayaa daabacaha rasiidka u sheega inay furan yihiin ama xiran yihiin (ESC/POS DLE EOT 1, biinka 3 ee dekedda DK). Taasi waxay suurtagal tahay oo kaliya daabacaha rasiidka ee shabakadda ku xiran. Taabo Cabbir: khaanadda xiran iyo Cabbir: khaanadda furan; haddii farqi jiro, qaado xaaladda saxda ah (sare = furan ama hoose = furan). Farqi la'aan = khaanaddan (ama fiiladu) dareeme ma leh. Jawaab la'aan daabacaha = lama yaqaan, marnaba "xiran".
  • Ha xisaabin inta khaanaddu furan tahay: markaas server-ka kaashku wuxuu diidaa xisaab cusub isagoo leh "Khaanadda lacagta weli waa furan tahay".
• Khaanad u gaar ah shaqaale kasta: daabacaha rasiidka wuxuu furi karaa laba khaanadood (khaanad 1 iyo khaanad 2). Shaqaale kasta u dooro khaanaddiisa; markaas kaashku marka kaash lagu xisaabinayo, lacag la gelinayo/laga saarayo khaanadda iyo Fur khaanadda wuxuu furaa khaanadda qofka galay. Warbixin → Kaash waxaa markaas ku jira Khaanad shaqaale kasta: lacagta bilowga shaqaale kasta, kaash (mashiinka lacagta la'aan), la filayo, Tiri iyo farqiga qof kasta (diiwaanka sida ladetelling). Xiritaanka maalinta caadiga ah sidiisa ayuu ahaanayaa.
• Tijaabi khaanad 1 iyo Tijaabi khaanad 2 waxay furaan khaanadda si loo hubiyo.
• Fur khaanadda iib la'aan (sabab leh) had iyo jeer horay ayuu ugu qornaa diiwaanka iyo faylka hantidhowrka kaashka (XAA), sida ay codsato Belastingdienst (waaxda canshuurta) (ka-reebitaanno sida "no sale").

Qaybta 3 · Maamulaha

Bilow

Rakibid. HorecaPOS waxaad ku rakibtaa barnaamijka rakibidda ee nidaamkaaga, oo laga helo bogga soo-dejinta OptimumPOS: Android (app), Windows (barnaamijka rakibidda), macOS (rakibe loogu talagalay Mac-yada Apple Silicon iyo Intel), Linux (rakibe garaafik ah, ama xirmada .deb ama .rpm), Raspberry Pi (rakibe garaafik ah ama .deb oo loogu talagalay Raspberry Pi 3, 4 ama 5 oo leh Raspberry Pi OS 64-bit) iyo Chromebook (app-ka Android ee Google Play). Dooro dhammaan isticmaalayaasha server kashiir oo ay tablet-yada iyo shaashadda jikadu ku xirmaan, ama aniga oo kaliya kashiir kaliya oo qalabkaas ku jira. Rakibuhu wuxuu dhigaa wax kasta oo loo baahan yahay, oo uu ku jiro database-ku, wuxuuna sameeyaa kayd (backup) habeen kasta. Si aad u cusboonaysiiso, rakib nooca cusub: xogtaadu way sii jiraysaa. Barnaamijka rakibiddu wuxuu ku bilaabmaa luqadda kombiyuutarkaaga (haddii kale Ingiriis); Windows iyo Linux shaashadda koowaad ayaad luqad kale ka dooran kartaa. Kadib kashiirku isla markiiba wuxuu ku bilaabmaa luqaddaas. Xirmooyinka .deb iyo .rpm iyo app-ka Android waxay raacaan luqadda nidaamka, haddii kale Nederlandiis.

Maamuluhu wuxuu kashiirka ku habeeyaa Dejinta. Halkaas waxaa ku yaal tabab sida Ganacsiga, Shaqaalaha, Ogolaanshaha, Saacadaha shaqada, Alaabta, Happy hour, Kaydka alaabta, Khariidadaha, Lacag-bixinta, Daabacayaasha, Xisaabaadka, Kaydadka (backup), Soo-dejin/Dhoofin iyo Database. Tababka uu maareeyuhu sidoo kale arko waxay ku xiran yihiin ogolaanshaha.

Xogta. Gudaha Dejinta → Xogta (maamulaha oo keliya) waxaad ka dooranaysaa MySQL / MariaDB, kaydka xogta ee ku dhex dhisan iyo PostgreSQL; marka aad beddesho, xogta oo dhan way raacdaa (eeg Xogta). Haddii Optimum POS uu horey u dejiyay cinwaan go'an markii la rakibayay, cinwaankaas ayaa shaqeeya oo ma jiraan goobo la buuxiyo. Haddii kale, adigu waxaad buuxisaa Server, Dekedda (port), Xogta, Isticmaalaha iyo Furaha sirta. Kaashku isagaa kaydiya, kadibna mar kale ayuu u muujiyaa iyagoo buuxa, oo had iyo jeer waad ku beddeli kartaa Beddel xogta MySQL/MariaDB ama Beddel xogta PostgreSQL. Furaha sirta oo bannaan laga tago macnaheedu waa: furaha sirta ee la kaydiyay ayaa sii jira (isla isticmaalahaas). Rakibaha iyo cusboonaysiintu waxba kama beddelaan DATABASE_URL ama kaydka xogta ee la doortay.

Xisaabaadka

Wax kasta oo xisaabaadka ah waxay ku jiraan Dejinta → Xisaabaadka. Adiga iyo xisaabiyahaaga wada geliya buugga maalinlaha iyo xisaabaadka buugga weyn. Haddii aad rabto in khasnaddu maalin kasta iyadu diiwaangeliso dakhliga maalinta, kor ka dooro barnaamijkaaga Barnaamijka xisaabaadka, xitaa Exact Online: waxaad arkaysaa oo keliya barnaamijyada ka shaqeeya dalka ganacsigaaga. Isla hoostiisa ku geli xogta barnaamijkaas oo ku xir. Barnaamijyada aad ku galayso (sida Exact Online, Twinfield ama Xero) marka hore geli app-ka: client-ID iyo sirta client-ka. Haddii Optimum POS uu barnaamijka ama xog si go'an u dejiyay xilliga rakibidda, doorashadaas ama goobtaas ma arkaysid. Halkaas waxaa sidoo kale ku yaal dulmar dhammaan barnaamijyada: kuwa si toos ah loo xiri karo iyo kuwa fayl helaya. Fayl waxaad ku samaysaa Warbixin → Dakhliga muddo kasta → Dhoofinta xisaabaadka: dooro qaabka barnaamijkaaga, ama UBL (Peppol), XAF ama warbixin maalinle. Diiwaangelinta ama soo-gelinta ugu horreysa had iyo jeer xisaabiyahaaga ha hubiyo.

Ganacsi Nederland ah halkaas waxaa sidoo kale ku yaal Faylka hanti-dhowrka kaashka (XAA): XML Auditfile Afrekensystemen ee Belastingdienst (Maamulka Canshuuraha Nederland) oo leh dhammaan rasiidyada, safafka, lacag-bixinnada iyo dhacdooyinka kaashka ee muddada la doortay. Waxaad siisaa xisaabiyahaaga ama marka la kormeerayo Belastingdienst.

Mushahar iyo qorshayn

Haddii shaqaalahaagu ay isticmaalaan saxiixa gelitaanka iyo ka bixitaanka, Dejinta → Saacadaha shaqada xaggeeda hoose waxaa ku yaal Mushahar iyo qorshayn, oo laba qaybood ah. Qaybta Maamulka mushaharka waxaad ka dooranaysaa barnaamijkaaga mushaharka ama (Beljim) xoghaynta bulshada, waxaadna shaqaale kasta u buuxinaysaa lambarkiisa shaqaale ee barnaamijkaas. Kadib muddo waxaad u samaynaysaa faylka saacadaha la shaqeeyay iyo dakhliga shaqaale kasta, waxaadna ku shubaysaa barnaamijkaaga mushaharka. Qaybta Qorshaynta shaqaalaha waxaad ka dooranaysaa nidaamkaaga qorshaynta: Deputy, Dyflexis iyo Shiftbase dakhligu wuxuu si toos ah u aadaa saacad kasta, kuwa kalena waxaad samaynaysaa fayl dakhli. Sidaas qorshayntaada waxaad ku aragtaa kharashka mushaharka oo ag yaal dakhliga. Haddii aad shaqeyso adigoon isticmaalin saxiixa, weli waxaad dakhliga u diri kartaa qorshayntaada: markaas waxay ku taal xagga hoose ee Dejinta → Xisaabaadka, qaybta Dakhliga u dir qorshayntaada. Haddii Optimum POS uu wax si go'an u dejiyay xilliga rakibidda, doorashadaas ama goobtaas ma arkaysid.

Kaydadka (backup)

Kaashku wuxuu si toos ah u sameeyaa kayd-nuqul (back-up) habeen kasta, iyo had iyo jeer ka hor cusboonaysiin. Dejinta → Kayd-nuqullada waxaad ku arkaysaa dhammaan kayd-nuqullada (goorma, yaa sameeyay ama si toos ah, cabbirka) waxaadna mid adigu ku samayn kartaa Samee kayd-nuqul. Haddii kayd-nuqulkii ugu dambeeyay ka badan yahay laba maalmood, digniin cas ayaa soo baxaysa: markaas la xiriir Optimum POS.

Soo celinta waxaa lagu sameeyaa badhanka Soo celi ee ku ag yaal kayd-nuqul. Wax kasta oo dhacay kayd-nuqulkaas ka dib way lumayaan. Waa inaad calaamadisaa oo aad mar kale gelisaa PIN-kaaga. Kaashku marka hore wuxuu sameeyaa kayd-nuqul badbaado ah oo xaaladda hadda ah, kadibna qof kasta wuu ka saaraa. Belgium tan lagama samayn karo kaashka (tiriyeyaasha sanduuqa madow way socdaan); halkaas Optimum POS ayaa samaysa.

Xogta

Gudaha Dejinta → Xogta (maamulaha oo keliya) waxaad ku aragtaa meesha kaashku xogtiisa ku kaydiyo. Xagga sare waxaa ku yaal kaydka xogta ee hadda oo leh barnaamijka, nooca, miisaska, safafka iyo cinwaanka ama galka. Shaqaalaha iyo tablet-yada, kaashku si isku mid ah ayuu ugu shaqeeyaa kayd kasta. Windows, macOS, Linux iyo Raspberry Pi waxaad ka dooranaysaa saddex kayd xog:

• MySQL / MariaDB: barnaamij kayd xog oo gaar ah (MySQL 8.0 ama ka cusub, MariaDB 10.6 ama ka cusub), tusaale ahaan server ama NAS aad hore u haysatay. Markaas dhammaan xogtu waxay ku jirtaa miisas caadi ah oo MySQL ama MariaDB ah, oo uu akhrin karo barnaamijkaaga warbixinta ama BI. Kaashku wuxuu u xisaabiyaa si sax ah sida PostgreSQL oo kale.
• Ku dhex dhisan (PGlite): wuxuu ku jiraa kaashka laftiisa, waxba uma baahnid inaad rakibto. Doorashada ugu fiican inta badan ganacsiyada, iyo kaydka xogta ee Android iyo Chromebook.
• PostgreSQL: barnaamij kayd xog oo gaar ah oo ku jira kombiyuutarka kaashka ama meel kale oo shabakadda ah.

Goorma MySQL ama MariaDB? Haddii ganacsigaagu horeba u leeyahay server MySQL ama MariaDB ah, haddii maamulahaaga IT uu ku shaqeeyo, ama haddii aad rabto inaad xogta ku akhrido warbixinnadaada, Excel ama barnaamij BI. Haddii aad shakisan tahay, dooro ku dhex dhisan: isla markiiba wuu shaqeeyaa.

Maxaa loo baahan yahay MySQL ama MariaDB?

• MySQL 8.0 ama ka cusub, ama MariaDB 10.6 ama ka cusub, oo laga gaari karo server-ka kaashka.
• Kayd xog oo gaar ah kaashka (ama kaashashka silsilad), oo leh qaybta xarfaha utf8mb4.
• Isticmaale kayd xog oo kaydkaas ku samayn kara, beddeli kara, magac u beddeli kara oo tirtiri kara miisas (CREATE, ALTER, DROP, INDEX, SELECT, INSERT, UPDATE, DELETE), tusaale ahaan sidan:

CREATE DATABASE horecapos CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
CREATE USER 'horecapos'@'localhost' IDENTIFIED BY 'wachtwoord';
GRANT ALL PRIVILEGES ON horecapos.* TO 'horecapos'@'localhost';

Haddii MySQL ama MariaDB uu ku shaqeeyo kombiyuutar kale, labada sadar ee ugu dambeeya ku qor cinwaanka IP-ga ee server-ka kaashka meesha localhost.

U beddelidda MySQL / MariaDB:

1. Hoostinta Cinwaanka MySQL/MariaDB buuxi goobaha: Server (caadi ahaan localhost), Dekedda (port) (caadi ahaan 3306), Xogta (caadi ahaan horecapos), Isticmaalaha iyo Furaha sirta; MariaDB-na sidaas oo kale. Haddii cinwaanka horey loo dejiyay, goobaha horey ayay u buuxsan yihiin; haddii furaha sirta aad bannaan ka tagto, kan la kaydiyay ayaa sii jira (isla isticmaalahaas). Kaashku cinwaanka isagaa kaydiya; haddii Optimum POS uu horey u dejiyay cinwaan go'an, cinwaankaas ayaa shaqeeya oo goobo ma jiraan. Haddii kaashku horey ugu shaqaynayo MySQL/MariaDB, xogta hadhow waxaad ku beddeshaa Beddel xogta MySQL/MariaDB. Xiriir qarsoon Optimum POS ayaa kuu dejinaysa.
2. Taabo Tijaabi xiriirka: waxaad arkaysaa barnaamijka iyo nooca, ama sababta aanu u shaqayn.
3. Taabo U beddel MySQL/MariaDB, calaamadee inaad fahantay oo geli PIN-kaaga.

Beddelidda waxay u shaqaysaa jiho kasta oo u dhexeysa saddexda kayd ee xogta, dhammaan xogtuna way raacdaa:

1. Kaashku muddo gaaban codsiyo ma aqbalo (badanaa in ka yar hal daqiiqo); kadib tablet-yadu iskood bay u sii socdaan.
2. Marka hore kaashku wuxuu sameeyaa nuqul kayd ah oo xaaladda hadda ah (gudaha Dejinta → Nuqullada kaydka).
3. Wax walba waxay u gudbaan kaydka cusub, kaashkuna miis kasta wuu tiriyaa si uu u hubiyo in wax walba si sax ah halkaas ugu jiraan.
4. Kaliya marka wax walba is waafaqaan ayuu kaashku ku sii shaqeeyaa kaydka cusub. Shaqaalaha soo galay way sii jiraan.

Haddii wax fashilmaan, waxba isma beddelaan, kaashkuna wuxuu ku sii shaqeeyaa kaydkii hore. Kaydkii hore wuu sii jiraa, markaa had iyo jeer waad dib ugu noqon kartaa. Xogta kaashka ee horey ugu jirtay kaydka cusub ee MySQL/MariaDB ama PostgreSQL waa la beddelaa. Belgium-na waa ka suurtagal: tiriyeyaasha sanduuqa madow si sax ah ayay u gudbaan.

Nuqullada kaydka iyo soo celinta si isku mid ah ayay ugu shaqeeyaan saddexda kayd (Dejinta → Nuqullada kaydka). Nuqul kayd oo ka mid ah hal kayd xog ayaad ku soo celin kartaa kayd kasta oo kale, xitaa nuqul PostgreSQL ah oo MySQL ama MariaDB ah.

Maxaa ku jira MySQL ama MariaDB? Miis kasta oo kaashka ah, oo leh magac iyo tiirar isku mid ah (waqtiyada UTC). Miis kasta wuxuu helayaa tiirka furaha ee dheeraadka ah _hp_sleutel, miisaska caawinta _horecapos_stand, _horecapos_kolom, _horecapos_reeks iyo _horecapos_wijziging (diiwaanka isbeddellada, 14 maalmood ayaa la hayaa)-na kaashku wuxuu ku hayaa xaaladda, noocyada tiirarka, tiriyeyaasha iyo isbeddellada. Barnaamijyada kale waxay akhriyaan xogta; kaashashka oo keliya ayaa wax qora.

Sida uu u shaqeeyo: kaashku wuxuu ku xisaabiyaa nuqul shaqo oo degdeg ah oo ku yaal server-ka kaashka, isbeddel kastana isla tallaabadaas ayuu ku qoraa MySQL/MariaDB. Haddii taasi fashilanto, isbeddelku ma dhaco, kaashkuna wuxuu muujiyaa qalad; sidaas darteed MySQL/MariaDB ha ahaado mid la gaari karo. Marka uu bilaabo, kaashku wax walba wuxuu ka akhriyaa MySQL/MariaDB.

Kaashash badan oo hal kayd xog ah. Sida PostgreSQL oo kale, kaashash badan ayaa isticmaali kara isla kaydka xogta MySQL/MariaDB, tusaale ahaan goob kasta oo silsilad ah oo leh server kaash u gaar ah. Isbeddelladu midba mid ka dib ayay dhacaan, kaash kastana marka hore wuxuu qaataa waxa kuwa kale sameeyeen, sidaas darteed waxba ma lumaan marka isla mar wax la beddelo. Haddii kaash uu soo celiyo nuqul kayd ah ama kaash nooc cusub leh uu cusboonaysiiyo kaydka xogta, kaashashka kale iskood ayay dib u akhriyaan wax walba; sidaas darteed dhammaan kaashashka isla mar cusboonaysii. Kaash xirnaa in ka badan 14 maalmood wax walba dib ayuu u akhriyaa marka uu bilaabo.

Marka la rakibayo waxaad sidoo kale doorataa kaydka xogta: MySQL / MariaDB, ku dhex dhisan (lagu taliyay) ama PostgreSQL oo cinwaankiisa la socdo. Haddii aan la gaari karin, kaashku wuxuu ku rakibmaa kaydka ku dhex dhisan; kadib halkan ayaad ka beddeli kartaa. Cusboonaysiin ka dib doorashadu way sii jirtaa.

Ku xir tablet-yada iyo shaashadaha

• Tablet/kaash kasta ka fur cinwaanka server-ka kaashka, tusaale http://192.168.1.20:3000, oo ku dhig gaab-wade shaashadda hore (Chrome: Ku dar shaashadda hore).
• Shaashadda jikada: http://192.168.1.20:3000/keuken.
• Shaashadda macmiilka (u jeedda macmiilka, ikhtiyaari): http://192.168.1.20:3000/klantscherm, eeg Shaashadda macmiilka.
• Shaashaduhu si toos ah ayay u helaan server-ka kaashka (isla cinwaanka, dekedda 4000).

Shaashadda macmiilka

Shaashad kaashka ku taal oo u jeedda macmiilka. Macmiilku wuxuu arkaa qiyaastii waxa la dalbaday, si cad ayuuna u arkaa lacagta iyo sida loo bixinayo. Badhamo ma leh: shaashaddu waxay kaliya raacdaa waxa kaashku sameeyo. Caadi ahaan waa dansan; ka shid Dejinta → Ganacsiga → Shaashadda macmiilka. Kombiyuutarka kaashka ee leh laba shaashadood, kaashku si toos ah ayuu u shidaa markii ugu horreysay; haddii aad intaas ka dib damiso, way dansanaan doontaa. Shaashad macmiil la'aan (dansan, ama midna ma jiro) wax walba sidii hore ayay u shaqeeyaan: kaashku sawirka gadaal ayuu ka diraa, shaqaaluhuna weligood ma dareemaan qalad ama shaashad maqan.

Waxa macmiilku arko:

• Nasasho (cidna ma bixinayso): magaca ganacsiga iyo qoraal soo dhaweyn ah oo aad adigu qorto (Dejinta → Ganacsiga; madhan = "Ku soo dhowow").
• Dalbasho: alaabta oo leh tirada iyo lacagta (saddarrada isku midka ah waa la isku daraa, menu waa hal saddar oo qaybaha hoos ugu qoran yihiin far yar, qiimo-dhimistu waa hal saddar), iyo wadarta oo far waaweyn ah. Waxa horay loo bixiyay marka la kala qaybiyo bixinta hoos ayay ku qoran yihiin. Dejinta → Ganacsiga → Sawirrada alaabta → shaashadda macmiilka alaab kasta sawir yar ayaa la socda.
• Bixinta: habka lacag-bixinta (Kaar, Lacag caddaan ah, Kaarka hadiyadda), bakhshiishka iyo far waaweyn Lacagta la bixinayo. Lacag caddaan ah: waxa macmiilku bixiyo iyo baaqiga loo celinayo, marka kaashka lagu qoro. Kaar: "Raac tilmaamaha mashiinka kaarka".
• Mahadsanid: bixinta ka dib dhowr ilbiriqsi "Mahadsanid!" oo leh lacagta la bixiyay (lacag caddaan ah: baaqiga macmiilka), kadibna mar kale shaashadda nasashada.

Ku xirid, laba siyaabood (labadaba waxaa lagu dejiyaa qalabka laftiisa):

• Shaashad labaad oo ku xiran kombiyuutarka khasnadda (Windows, Linux/Raspberry Pi, macOS): si toos ah. Marka la soo galo iyo ka dib rakibidda, khasnaddu waxay shaashadda macmiilka ku furtaa shaashad buuxda shaashadda ugu yar ee aan ahayn shaashadda ugu weyn (haddii ay isku cabbir yihiin, ta ugu midigsan); marka la isticmaalayo Windows, had iyo jeer shaashad ka duwan tan khasnadda (khasnaddu waxay ku jirtaa shaashadda taabashada, sidoo kalena si toos ah ayay u furantaa marka la shido). Cabbirka iyo meesha waxaa go'aamiya nidaamka, sidaa darteed cabbir kasta wuu shaqeeyaa. Haddii aysan jirin shaashad labaad, waxba ma dhacaan. Windows-ka, shaashadda macmiilka ee la xiray si toos ah ayay u soo noqotaa; Linux iyo macOS, furaha gaaban HorecaPOS shaashadda macmiilka ee menu-ga ku jira ayaa dib u saxa. Marka la isticmaalayo Windows, waxay ku furantaa habka kiosk-ga ee Chrome (ama Edge): shaashad buuxda, bilaa bar cinwaan iyo bilaa taskbar (ku xir Alt+F4). Waxay raacdaa khasnadda isla kombiyuutarka iyada oo aan code isku xir loo baahnayn.
  • Browser kasta, riixid dheer meelna kuma furto menu-ga browser-ka, mana soo baxdo su'aal ah in bogga la turjumo.
  • Khasnadda oo xiran = shaashadda macmiilka oo xiran. Haddii barnaamijka khasnaddu istaago (Dib u bilow, cusboonaysiin, khasnadda oo la joojiyay ama la saaray), shaashadda macmiilka sidoo kale way xirmaysaa wax yar ka dib 10 ilbiriqsi; marka khasnaddu mar kale shaqeyso, si toos ah ayay u soo laabanaysaa. Windows-ka sidoo kale way xirmaysaa haddii aad xirto daaqadda khasnadda oo keliya. Wayland (Linux) hoostiisa khasnaddu ma xiri karto daaqadda lafteeda.
  • Shaashadda macmiilka si qalad ah ayaa loo xiray? Windows-ka si toos ah ayay u soo laabanaysaa dhowr ilbiriqsi ka dib, inta khasnaddu furan tahay oo shaashadda labaad ku xiran tahay.
  • Had iyo jeer hal shaashad macmiil oo keliya. Windows-ka shaashadda macmiilku waxay ku jirtaa oo keliya habka kiosk-ga ee shaashadda labaad. Shaashad macmiil oo ku jirta daaqadda khasnadda (tusaale ahaan Edge ayaa dib u soo celiyay ka dib markii korontadu go'day, ama waxaa lagu furay badhanka khasnadda) si toos ah ayay u xirmaysaa dhowr ilbiriqsi gudahood; markaas shaashadda macmiilka saxda ah ayaa meesheeda gasha.
  • Qofna ma soo galin = soo dhaweyn oo keliya. Haddii khasnaddu ku jirto shaashadda koodhka PIN (sidoo kale ka dib dib u bilaabid ama ka bixid), shaashadda macmiilku waxay muujisaa qoraalka soo dhaweynta oo keliya, marnaba biilkii hore.
  • Windows-ka waxaad sidoo kale ku joojin kartaa furitaanka tooska ah calaamadda Shaashadda macmiilka si toos ah ... ee rakibaha.
  • Linux-ka khasnaddu waxay daaqadda ku dhaqaajisaa wmctrl (wuxuu la yimaadaa xirmada). Wayland hoostiisa (tusaale Raspberry Pi OS oo leh labwc) taasi ma suurtagalto: markaas hal mar adigu shaashadda macmiilka u wareeji shaashadda labaad (browser-ku wuu xasuustaa), ama ka dooro X11 raspi-config. macOS-ka, Mac-gu markii ugu horreysay wuxuu oggolaansho ka codsadaa Gelitaanka.
  • Gacanta: Dejinta → Ganacsiga → Shaashadda macmiilka → Fur shaashadda macmiilka (shaashad labaad). Chrome iyo Edge (sidoo kale Chromebook) badhanku isla markiiba daaqadda wuxuu dhigaa shaashadda macmiilka (markii ugu horreysay browser-ku oggolaansho ayuu weydiiyaa); hal guji oo shaashadda macmiilka ah ayaa ka dhigta shaashad buuxda. Browser-yada kale: jiid oo riix F11.
• Khasnad Android ah oo leh shaashad macmiil oo ku dhex jirta (tusaale Sunmi D2/T2) ama shaashad HDMI/USB-C ku xiran: sidoo kale si toos ah. Marka app-ku khasnadda ku jiro, shaashadda macmiilku waxay ka soo baxdaa shaashadda labaad; ku xiridda iyo ka saaridda isla markiiba way shaqeysaa.
• Sunmi T1 mini / T2 mini oo leh shaashadda qoraalka yar (2 sadar): app-ku si toos ah ayuu lacagta ugu muujiyaa: Wadarta, Lacagta la bixinayo, lacag caddaan ah marka Haraaga, lacag bixinta ka dib Mahadsanid!, marka la nasanayona magaca goobta. Shaashadda macmiilku waa inay shidan tahay.
• iPad (shaashadda shaqada) oo leh shaashad dibadeed oo HDMI/USB-C ama AirPlay ah: app-ku si toos ah ayuu shaashadda macmiilka u dhigaa shaashaddaas (waa la diyaariyay; app-ka iOS weli lama soo saarin).
• Chromebook: marka uu yahay shaashadda shaqada ee Chrome, badhanka Fur shaashadda macmiilka (shaashad labaad) wuxuu u shaqeeyaa sida kor ku xusan. App-ka Android-ka, shaashadda macmiilku si toos ah ayay uga soo baxdaa shaashadda labaad marka ChromeOS shaashaddaas u gudbiyo app-yada Android; haddii uusan sidaas samayn, isticmaal qalab gooni ah oo leh code isku xir.
• Qalab gooni ah (tablet ama kombiyuutar kale oo kaashka ag yaal): fur http://<kassaserver>:3000/klantscherm. Shaashaddu midigta hoose waxay ku muujinaysaa kood isku-xir oo 6 xaraf ah. Ku qor kaashka Dejinta → Ganacsiga → Shaashadda macmiilka → Isku xir. Ka goo xiriirka shaashadda wuxuu dib ugu celiyaa koodka isku-xirka. Isku-xirka kaash kasta waa loo kaydiyaa (browser-ka kaashkaas), sidaas darteed kaash kasta wuxuu yeelan karaa shaashad macmiil oo u gaar ah.

Shaashadda macmiilku ma weydiiso PIN (wax la maamulo ma jiraan) waxayna muujisaa kaliya sawirka kaashka ay ku xiran tahay. Sawirku wuxuu ku jiraa kaliya xusuusta server-ka kaashka; dib-u-bilaabid ka dib shaashaddu way madhan tahay ilaa isbeddelka xiga. Dejintu (shid/dami iyo qoraalka soo dhaweynta) waxay ku jirtaa kayd-nuqulka iyo Soo-gelin/dhoofin (Dejinno kale).

Rasiid dhijitaal ah oo QR ah (ikhtiyaari)

Caadi ahaan waa dansan. Ka shid Dejinta → Ganacsiga → Jikada iyo shaashadda macmiilka → Rasiid dhijitaal ah (doorashadu waxay soo baxdaa marka shaashadda macmiilka la keydiyay iyadoo shidan). Lacag bixinta kadib, agta Mahadsanid! waxaa ka muuqda QR code; markaas wuxuu joogayaa 45 ilbiriqsi halkii dhowr ilbiriqsi. Martidu waxay ku iskaan gareysaa telefoonkeeda waxayna aragtaa rasiidka, sida rasiidka warqadda ah oo kale (isla qoraalka, kaashka Belgium-na sidoo kale leh qaybta FDM). Telefoonka waxay ka daabici kartaa rasiidka, u keydin kartaa pdf ahaan ama u soo dejisan kartaa fayl qoraal ah.

• Waxay maraysaa bogga maamulka: https://kassa.<portaal>/__bon/<kassa>/<sleutel>. Sidaas darteed kaashku waa inuu ku xiran yahay bogga; haddii kale QR code ma soo baxo, waxna isma beddelaan.
• Furaha waa mid nasiib ah oo aan la qiyaasi karin, wuxuuna shaqeeyaa 30 maalmood. Kadib kaashku si toos ah ayuu u tirtiraa. Boggu waxba ma keydiyo.
• Wuxuu la shaqeeyaa shaashad labaad iyo shaashad macmiil oo gooni ah. Rasiidka warqadda ah iyo rasiidka iimaylka si caadi ah ayay u sii shaqeeyaan.

Shaashadda macmiilka marka ay nasanayso: bandhig sawirro (ikhtiyaari)

Caadi ahaan waa dansan. Ka shid Dejinta → Ganacsiga → Jikada iyo shaashadda macmiilka → Shaashadda macmiilka marka ay nasanayso. Haddii aysan jirin xisaab shaashadda macmiilka saaran, sawirradu way isbeddelaan (caadi ahaan 8 ilbiriqsi kasta, laga dejin karo 4 ilaa 60):

• Dallacaadyo: happy hours-ka (haddii happy hour shidan yahay), oo leh qiimo-dhimista, maalmaha iyo saacadaha iyo alaabta ama kooxaha; kuwa hadda socda ayaa ugu horreeya, oo leh "Hadda!".
• Alaab la muujiyay (ugu badnaan 12, tusaale ahaan cusub oo menu-ga ku jira), oo leh qiime iyo (haddii sawirrada alaabta ee shaashadda macmiilka shidan yihiin) sawirka. Alaab dhammaatay shaashaddu way ka boodaa.
• Kaarka dhibcaha: dhibcaha euro kasta, abaalmarinta iyo kaararka shaambada (kaliya haddii kaarka macmiilka shidan yahay).
• Qoraallo gaar ah: ugu badnaan 5, mid kasta sawir u gaar ah (tusaale ahaan "Laga bilaabo Jimcaha waa cusub: menu-gayaga xagaaga").

Sawirro la'aan, shaashadda macmiilka waxay muujisaa shaashadda soo dhaweynta, sidii had iyo jeer.

Happy hour

Caadi ahaan waa dansan. Ka shid Dejinta → Ganacsiga → Isticmaal happy hour; kadib waxaa soo baxaya tabka Dejinta → Happy hour.

• Happy hour kasta: magac (wuxuu ku qormaa rasiidka), maalmo, laga bilaabo–ilaa (wuu dhaafi karaa saqda dhexe, tusaale 23:00–01:00), qiimo-dhimis % ama qiime go'an, iyo kooxaha alaabta iyo/ama alaabta gaarka ah ee ay khusayso.
• Muddadaas gudaheeda kaashku si toos ah ayuu u xisaabiyaa qiimaha happy hour-ka marka alaabta la geliyo (weligiis kama qaalisanaado caadiga; qiime go'an marka la isticmaalo doorashooyinka sidii caadiga ahayd ayaa loogu daraa). Badhanka alaabta qiimihii hore waa la tirtiray oo waxaa la socda qiimaha cusub iyo HH; dalabka iyo rasiidka waxaa ku qoran magaca happy hour-ka. Wixii horay loo geliyay qiimahooda ayay haystaan.
• Dalab maalmeed: calaamadee Maalinta oo dhan (00:00–24:00) oo dooro maalinta (maalmaha), tusaale Talaado kasta spareribs qiime go'an.
• Xilli: calaamadee Kaliya xilli gaar ah (sannad kasta) oo dooro laga bilaabo iyo ilaa (maalin iyo bil, tusaale 1 Juun ilaa 31 Ogost; dhaafitaanka sannadka waa la oggol yahay, tusaale 1 Diseembar ilaa 28 Febraayo). Xilliga dibaddiisa happy hour-ku ma shaqeeyo.
• Isbeddellada waxaa lagu qoraa diiwaanka.

Qaybaha maalinta iyo xilliyada

Caadi ahaan waa dansan. Ka shid Dejinta → Ganacsiga → Qaybaha maalinta iyo nooca dalabka → Alaabta qayb-maalmeed iyo xilli kasta; kadib waxaa soo baxaya tabka Dejinta → Qaybaha maalinta. Haddii aad damiso, alaabta oo dhan mar kale had iyo jeer waa la iibin karaa, qaybaha maalintuna waa la kaydiyaa.

• Qayb-maalmeed kasta: magac (tusaale Quraac, Qado, Casho, Menuuga xagaaga), maalmo, laga bilaabo–ilaa (wuu dhaafi karaa saqda dhexe; Maalinta oo dhan = 00:00–24:00), haddii loo baahdo xilli (sannad kasta, maalin iyo bil), iyo kooxaha alaabta iyo/ama alaabta gaarka ah ee ka tirsan.
• Alaabta iyo kooxaha alaabta ee ku jira hal ama dhowr qayb-maalmeed waxaa la iibin karaa kaliya marka mid ka mid ah qaybahaas uu socdo; wixii aan ku jirin qayb-maalmeed, had iyo jeer waa la iibin karaa. Shaashadda dalabka waxay muujisaa kaliya waxa hadda la iibin karo, waxayna si toos ah isu beddeshaa marka qayb-maalmeed bilaabmo ama dhammaado; server-ku wuu diidaa inta kale ("hadda lama iibin karo, kaliya Quraac").
• Dukaanka online wuxuu muujiyaa oo xisaabiyaa isla alaabta (waqtiga dalabka).
• Qiime kale maalin ama xilli gaar ah waa happy hour (dalab maalmeed, eeg kor).
• Menu goob kasta: khasnad kasta (laan kasta) waxay leedahay alaab, qaybo maalmeed iyo qiimo u gaar ah.
• Isbeddellada waxaa lagu qoraa diiwaanka.

Alaabta iyo qiimaha nooc dalab kasta

Caadi ahaan waa dansan. Ka shid Dejinta → Ganacsiga → Qaybaha maalinta iyo nooca dalabka → Alaabta iyo qiimaha nooc dalab kasta. Haddii aad damiso, meel kasta mar kale qiimaha caadiga ah ayaa shaqeeya, wax walbana meel kasta waa la iibin karaa; qiimaha la geliyay waa la kaydiyaa.

• Dejinta → Alaabta alaab kasta: Qiimaha qaadashada iyo Qiimaha keenista (madhan = qiimaha caadiga ah) iyo Lagu iibiyo (goobta, qaadasho, keenis; ugu yaraan mid). Koox alaab sidoo kale Lagu iibiyo, dhammaan alaabta kooxdaas.
• Dalab qaadasho ama keenis ah, shaashadda dalabku waxay muujisaa qiimaha nooca dalabkaas iyo kaliya waxa halkaas lagu iibiyo; server-ku wuxuu xisaabiyaa qiimahaas oo diidaa inta kale. Happy hour, menuyada iyo doorashooyinka waxay ku xisaabiyaan qiimahaas.
• Heerka VAT-ka qaadashada (alaabta) taas kama xirna, sidii had iyo jeer.
• Dukaanka online marka qaadasho iyo keenis la doorto wuxuu muujiyaa qiimaha iyo alaabta doorashadaas (marka la beddelo bogga menu-ga dib ayuu u furmaa), miiskana kuwa goobta.
• Dhoofinta iyo soo dejinta habaynta (Dejinta → Soo dejin/dhoofin) waxay qaadaan qiimaha nooc dalab kasta, "lagu iibiyo", qaybaha maalinta iyo xilliga happy hour-yada.

Menu-yada

Caadi ahaan waa dansan. Ka shid Dejinta → Ganacsiga → Isticmaal menu-yada.

• Menu waa alaab caadi ah (oo leh qiimaha menu-ga) oo aad qaybaheeda ku dejiso Dejinta → Alaabta → (alaab) → Menu:
  • go'an: had iyo jeer alaabtan (tusaale "Cabbitaan: Khamriga guriga");
  • doorasho: dooro 1 (ama ka badan) koox alaab ah, haddii loo baahdo kaliya alaab go'an (tusaale "Cunto weyn: dooro 1 Cuntooyinka waaweyn").
  • Qayb kasta marxaladda (1 = isla markiiba, 2/3 = sug ilaa loo yeedho).
• Marka aad menu-ga geliso, qayb kasta cuntooyinka ayaad u doorataa. Cunto kasta (xitaa kuwa go'an) waxaad u dooran kartaa doorashooyinka sida alaab gaar ah (habka karinta, farmaajo dheeraad ah; doorashooyinka qasabka ah waa in la doortaa) iyo faallo. Qiimaha dheeraadka ah ee doorashooyinka waxaa lagu darayaa qiimaha menu-ga. Menu-gu wuxuu u muuqdaa hal saddar oo cuntooyinka (iyo doorashooyinkooda) hoos ugu qoran yihiin.
• Cuntooyinku waxay u tagaan jikada/baarka saddarro gooni ah (warqadda jikada iyo shaashadda jikada), marxaladdooda. Saddarka menu-ga laftiisu ma tago.
• Canshuurta (btw) awgeed, qiimaha menu-ga waxaa loo qaybiyaa qaybaha si u dhiganta qiimahooda caadiga ah, si cuntada iyo cabbitaanku mid walba u helo heerka saxda ah. Rasiidka waxaa ku qoran menu-ga oo leh qiimaha guud iyo cuntooyinka hoostiisa.
• Haddii menu-ga laftiisu leeyahay doorashooyin (tusaale cabbir), waxaad ka doorataa xagga sare ee daaqadda menu-ga. Waxay la socdaan saddarka menu-ga ee rasiidka, iyo cunto kasta oo menu-ga ka mid ah warqadda jikada iyo shaashadda jikada sida "(menu)".
• Ka saaridda/storno-ga waxaa lagu sameeyaa menu dhan (taabo saddarka menu-ga).
• Kala qaybi / rar: dooro saddarka menu-ga; cuntooyinku way la socdaan. 2× isla menu-ga waxaad sidoo kale rari kartaa 1 (madaxa iyo cuntooyinka waa la kala qaybinayaa).
• Xiriir la'aan menu-yada waad gelin kartaa sidii caadiga ahayd; waxaa lagu kaydiyaa tablet-ka waxaana la diraa marka xiriirku soo laabto (sida alaabta gaarka ah).
• Happy hour sidoo kale wuxuu khusayn karaa menu.

Habka cuntada iyo kharashka (Apicbase)

Xiriirka Apicbase (habka cuntada, kharashka, kaydka iyo iibsiga) iyadoo loo marayo Generic POS API-ga Apicbase (caadi ahaan waa dansan, qayb kasta si gaar ah ayaa loo shidaa ama loo damiyaa). Dejinta waxaa laga sameeyaa Dejinta → Hab cunto (xuquuqda Dejinta ganacsiga, lacag bixinta iyo daabacayaasha). Khasnaddu iyadu ayay la hadashaa Apicbase (kaliya taraafikada baxaysa, portal looma baahna).

1. Ku xir (dhammaan waxaa buuxinaya maamulaha), mid ka mid ah saddex hab:
   • Dheji token: Apicbase gudahiisa Library Settings → API Settings → New token → Service Account Token (scopes accounts, library, sales); dheji access token iyo refresh token;
   • Gal adigoo isticmaalaya API-app-ka ganacsiga (client-id iyo client secret ee API Settings): Gal Apicbase, oo dheji koodhka uu Apicbase kadib muujiyo;
   • Token dhacay (7 maalmood kadib) khasnaddu si toos ah ayay ugu cusboonaysiisaa refresh token.
2. Outlet: Soo qaado Outlets oo dooro outlet-ka ganacsigan. Khasnaddu halkaas waxay POS-ka u dhigtaa Generic POS API oo leh location-id u gaar ah (waa la buuxin karaa; caadi ahaan HORECAPOS-…, mid gaar ah khasnad kasta).
3. Shid, oo leh calaamadaha:
   • Alaabta, kooxaha iyo doorashooyinka Apicbase: kooxaha alaabta, alaabta (PLU = lambarka PLU ee alaabta, haddii kale koodhka, haddii kale id), doorashooyinka sida modifiers, oo leh qiime iyo cashuur. Si toos ah isbeddel kasta kadib (hal daqiiqo kadib) iyo maalin kasta. Kadib Apicbase waxaad ku xiraysaa alaab kasta oo khasnadda ah hab cunto;
   • Rasiid kasta oo la bixiyay Apicbase: kan ugu da'da weyn marka hore, ugu badnaan 100 mar kasta, rubuc saac gudihiis bixinta kadib (iyo 5-kii daqiiqoba mar). Qiimo-dhimista waxaa loo qaybiyaa safafka; lacagaha furan, khidmadda baakadaha hal mar la isticmaalo iyo lacagta deposit-ka waxay Apicbase ugu jiraan alaab gaar ah; alaabta la miisaamay sida 1 xabbo oo leh wadarta lacagta. Haddii aanu guulaysan, khasnaddu way joogsataa (Apicbase wuxuu rabaa rasiidyada iyagoo isku xigxiga) oo hadhow mar kale ayay isku daydaa: lacag bixintu waxba kama dareemayso. Marka la shido waxaad doorataa maalinta laga bilaabayo (caadi ahaan hadda);
   • Dib u soo qaado kharashka qayb kasta (6-kii saacadoodba mar): hab cunto kasta oo ku xiran food cost (walxaha iyo khasaaraha), kharashka shaqaalaha, qiimaha iibka iyo faa'iidada sida uu Apicbase sheegay. Waxaa lagu xisaabiyaa alaab-qeybiyaha ugu jaban, qiimaha ugu dambeeyay ee la dalbaday ama qiimaha celceliska kaydka;
   • Qiimaha iibka ka qaado Apicbase (caadi ahaan waa dansan yahay): qiimaha iibka alaabta ku xiran wuxuu gelinayaa khasnadda (waxaa lagu qoraa diiwaanka).
4. Hoosta: Kharashka alaab kasta oo leh kharash, kharash shaqaalaha ku jiro, qiimaha khasnadda, kharash % iyo faa'iido. Badhamada Hadda dir kataloogga, Hadda dir rasiidyada iyo Hadda soo qaado kharashyada.

Koodh: apps/pos-server/src/lib/apicbase.ts, routes/apicbase.ts; shaashad Apicbase.tsx. Diiwaanka: Apicbase. Shuruud: module-ka API ee Apicbase. App-ka Pin Voordeel ee dhammaan macaamiisha: iskaashi iyo shahaado Apicbase (eeg backlog-ga). Dukumentiyada: https://developers.apicbase.com/docs/generic-pos-api-guide

Barnaamijka hoteelka: qolka ku qor

Maqaayad ama baar hoteel ku yaal: biilka qolka martida ku qor. Asal ahaan dansan: Dejinta → Hoteel (xuquuqda Deji ganacsiga, lacag-bixinta iyo daabacayaasha).

• Hal liis oo leh dhammaan barnaamijyada hoteelka (Software-ka uu hoteelku isticmaalo). Xiriirada ku dhex jira:
  • Mews (Connector API: client token iyo access token, service-ka maqaayadda iyo heer kasta oo VAT ah koodhka VAT ee Mews), apaleo (app gaar ah oo leh client-id iyo client secret, property-id; heer kasta oo VAT ah haddii loo baahdo nooca VAT) iyo Cloudbeds (furaha API iyo property-id), mid walba wuxuu leeyahay deegaan tijaabo iyo mid dhab ah;
  • Oracle OPERA Cloud (OHIP), protel (protel I/O), RoomRaccoon, Booking Experts, Amadeus (XMLPOS), VIPS, Stayntouch, Clock PMS+, Guestline (Rezlynx), Hotelogix, eviivo, Little Hotelier, Shiji iyo Infor HMS (Databridge). Kadib marka aad doorato, waxaa soo baxa kaliya meelaha uu barnaamijkaas hoteelku u baahan yahay (furayaal, id-ga hoteelka, haddii loo baahdo cinwaanka API-gooda iyo heer kasta oo VAT ah koodhkooda), iyo sharraxaad gaaban oo ah waxa aad ka codsanayso iibiyaha. Xiriiradan waxaa loo dhisay sida ku qoran dukumentiyada iibiyeyaasha; iibiyaha ha xaqiijiyo xiriirka, oo marka hore isku day Tijaabi xiriirka iyo hal rasiid;
  • demo (afar suite, qolka 4 ilaa 7) si aad u tijaabiso;
  • Sirvoy, sida isku xir badh ah iyo kaliya Sirvoy Pro. Sirvoy ma laha API uu kashiirku wax ugu daro ballan, xitaa fayl ma aha (soo dejinta CSV waxay sameysaa kaliya ballamo cusub). Sidaas kashiirku wuu yaqaan martida (qolka, magaca, imaatinka, ka bixitaanka): raadinta Qolka ku qor iyo is-adeegga kiosk-ga iyo dukaanka online-ka si caadi ah ayey u shaqeeyaan. Rasiidku si iskiis ah uma galo Sirvoy: kadib lacag bixinta wuxuu ku jiraa Dejinta → Hoteel hoostiisa Weli geli Sirvoy, oo leh qolka, martida, lambarka rasiidka iyo qadarka heer VAT kasta. Hoteelku gacanta ayuu ugu daraa ballanta sida extra wuxuuna gujiyaa Waa ku jiraa (dib ugu celi Weli maya). Loo baahan yahay:
    1. waxaa la door bidaa kashiir ku xiran bogga maamulka: markaas cinwaanku wuxuu sii maraa bogga (https://<portaal>/hotel/<kassa-id>/sirvoy?sleutel=...), hoteelkana looma baahna in port la furo. Haddii kale kashiirka laftiisa waa in laga gaari karo internetka iyadoo la adeegsanayo https (domain gaar ah oo shahaado leh ama port forwarding; Sirvoy wuxuu u baahan yahay TLS 1.2 ama ka sarreeya) oo aad gelisaa cinwaankaas;
    2. Cinwaanka hal mar oo keliya ayaa la arki karaa; kashiirku wuxuu kaydiyaa oo keliya hash-ka. Samaynta cinwaan cusub = kii hore mar dambe ma shaqeeyo;

Sirvoy wax buu soo diraa kaliya marka ballan isbeddesho: ballamaha ka horreeyay isku xirka kashiirku wuxuu ogaadaa kaliya kadib isbeddel Sirvoy. Fariimuhu way isku dhex iman karaan; fariin ka duug ah (generatedAt) waxa kashiirku hore u hayo waa la dhaafaa. Hoteelka = aan la joojin oo aan ka bixin, la diiwaangeliyay ama imaatin maanta ama ka hor, iyo ka bixitaan maanta ama ka dib. Tijaabi xiriirka wuxuu sheegaa inta ballan ee soo gashay.

Dhammaan barnaamijyada hoteelka waxaa laga iibsan karaa Nederland iyo/ama Beljamka. Tijaabi xiriirka wuxuu hubiyaa xogta. Koodhka xiriir kasta: apps/pos-server/src/lib/pms/<naam>.ts.

• Is-adeeg (asal ahaan dansan): martida hoteelku qudheeda ayay dalabkeeda ugu qortaa qolkeeda, kiosk-ka iyo/ama dukaanka online-ka (qaadasho iyo keenis, ma aha dalbashada miiska). Waxay gelisaa lambarka qolka iyo magaca qoyska; kashiirku wuxuu barnaamijka hoteelka ka hubiyaa in martidaasi hadda qolkaas deggan tahay. Dalab kasta wuxuu leeyahay xad (asal ahaan € 150), oo kadib 5 isku day oo khaldan rubuc saac gudihiis marka hore miiska adeegga u tag. Fariintu marnaba ma sheegto cidda qol deggan.
• Bixi lacagta: haddii isku xirku shidan yahay, waxaa jira habka lacag-bixinta Qolka ku qor. Ka raadi martida magaca ama lambarka qolka (kaliya martida hadda hoteelka deggan) oo taabo Ku qor qolka .... Kashiirku wuxuu rasiidka heer VAT kasta ugu qoraa biilka hoteelka ee martida; martidu waxay bixisaa marka ay ka baxayso.
• Beljamka: haddii dalabku horay ugu jiro miiska sanduuqa madow, marka hore wuxuu ka guurayaa miiska una guurayaa qolka (signCostCenterChange ilaa ROOM, UC4101); rasiidku wuxuu sanduuqa madow ugu socdaa deyn qol ahaan (ROOM_CREDIT).
• Haddii qorista barnaamijka hoteelka ay fashilanto (internet ma jiro), iibku wuu jiraa, qoristuna waxay ku muuqataa Wuu fashilmay Dejinta → Hoteel, oo leh Mar kale.
• Warbixinaha iyo xisaabaadka: Qolka ku qor (hoteel) waa hab lacag-bixineed gooni ah oo ku jira warbixinta X iyo Z, warbixinta maalinlaha iyo auditfile-ka (XAA).

Koodh: apps/pos-server/src/lib/hotel.ts, routes/hotel.ts, xiriirada lib/pms/, liiska packages/shared/src/hotelcatalogus.ts; shaashadda Hotel.tsx. Diiwaanka: Hoteel. Sirta (tokens) waxay ku jirtaa database-ka oo keliya, weligeedna shaashadda kuma muuqato.

Maareynta khamriga ee Vinify

Dejinta → Maareynta khamriga (caadi ahaan waa dansan; damintu wax walba way kaydisaa). Vinify wuxuu la socdaa bakhaarka khamriga, liiska khamriga iyo kaydka, waana isha ugu weyn ee khamriyada. Sida ay dhigayaan shuruudaha POS ee Vinify, kaashku wuxuu bixiyaa API u oggolaanaya Vinify inuu:

Galitaanka, dhammaan saddexda hab ee Vinify yaqaan (maamulaha ayaa shida midka la rabo):

1. API-id iyo furaha API (X-Api-Id iyo X-Api-Key, ama Authorization: Bearer <id>:<sleutel>);
2. Furaha API iyo API-secret oo leh saxiix: X-Api-Key, X-Timestamp iyo X-Signature = hex HMAC-SHA256(secret, <timestamp>\n<METHODE>\n<pad met query>\n<sha256 van de body>), ugu badnaan 5 daqiiqo jir.

Furaha iyo secret-ka waxaa sameeya kaashka (hal mar ayaa la muujiyaa); shaashadaha waxay arkaan oo keliya inay buuxsan yihiin iyo in kale. Waxaa laga gaari karaa portalka https://<portaal>/vinify/<kassa-id>/... (dekad furan kuma jirto meesha ganacsiga; cinwaanku wuxuu ku jiraa Dejinta → Maareynta khamriga). Alaabta khamriga ah: waxa Vinify sameeyo, iyo kooxaha aad calaamadiso. Haddii Vinify bixiyo cinwaan iibka loo diro, kaashku isna wuu diraa (push, oo leh token): rasiid kasta oo la bixiyay kadib iyo 5-tii daqiiqoba mar wixii aan weli guulaysan. Vinify ayaa shidaya xiriirka HorecaPOS (hello@vinify.no). Wax walba waxay ku jiraan diiwaanka. Ha ku khaldin Vinify.nl, oo ah dukaan khamri oo onlayn ah: wuxuu ku jiraa alaab-qeybiyeyaasha (Ka dalbo alaab-qeybiyeyaasha).

Cinwaan si degdeg ah ugu geli koodka boostada iyo lambarka guriga

Ka shid Dejinta → Ganacsiga → Cinwaan si degdeg ah u geli (caadi ahaan waa dansan; kaliya ganacsi ku yaal Nederland). Qor koodka boostada iyo lambarka guriga (xitaa xaraf ama kordhin leh, tusaale 12A ama 12-1) oo taabo Raadi cinwaanka: waddada, lambarka guriga, koodka boostada iyo magaalada ayaa la buuxiyaa. Haddii lambarkaas ay cinwaanno badan leeyihiin (12, 12A, 12B), dooro kan saxda ah. Kadib wax walba adigu waad beddeli kartaa.

• Xogta ganacsiga (Dejinta → Ganacsiga, cinwaanka korkiisa).
• Macmiilka kaarka macmiilka: khasnadda marka macmiil cusub la galiyo iyo Warbixin → Macaamiisha. Macaamiishu waxay u helaan cinwaan (ikhtiyaari ah): waddada iyo lambarka guriga, koodka boostada iyo magaalada.
• Cinwaannadu waxay ka yimaadaan Locatieserver-ka PDOK oo bilaash ah (cinwaannada rasmiga ah ee Nederland, BAG): akoon ama fure looma baahna, internet baa loo baahan yahay. Internet la'aan ama cinwaan Beljiyam ah, cinwaanka adigu qor.

Ogeysiis marka nooc cusub yimaado

Ka shid Dejinta → Ganacsiga → Ogeysiiska cusboonaysiinta (caadi ahaan waa dansan).

• Kaashka waa la cusboonaysiiyay: haddii server-ka kaashka la cusboonaysiiyay iyadoo tablet uu weli furan yahay shaashadihii hore, xagga sare waxaa ku qoran "Kaashka waa la cusboonaysiiyay (nooca …)" oo leh Cusboonaysii. Tablet-ku wuxuu eegaa 5 daqiiqo kasta, marka shaashaddu mar kale muuqato iyo dib-u-bilaabidda server-ka ka dib.
• Cusboonaysiin ayaa diyaar ah: haddii kaashku ku xiran yahay portaalka maamulka (PORTAAL_URL/PORTAAL_SLEUTEL) oo halkaas lagu qoray NIEUWSTE_VERSIE, qofka loo oggol yahay inuu maamulo dejinta wuxuu arkaa "Cusboonaysiin ayaa diyaar ah: nooca …" (oo leh sharaxaadda UPDATE_NOTITIE). Goor dambe wuxuu ogeysiiska ku qariyaa tablet-kaas ilaa uu jiro nooc ka cusub. Cusboonaysiintu sidii had iyo jeer ayay ku socotaa scripts\windows\update.cmd (eeg Cusboonaysiinta).

Barxamyada ballansashada

Ballansashooyinka TheFork, Formitable, Zenchef, Resengo (Beljim oo kaliya), OpenTable (Nederland oo kaliya), PlanPanther, RestoManager iyo Aqqo (Nederland oo kaliya) si toos ah ayay u galaan qalabka iibka iyo khariidadda qolka. Ka shid Dejinta → Barxamyada ballansashada (asal ahaan waa dansan yahay). Waxay shaqeysaa oo kaliya haddii Ballansashooyinku shidan yihiin.

• Waddanka ganacsiga: waxaad dooran kartaa oo kaliya barxamyada ka shaqeeya waddanka ganacsiga (Resengo Beljim oo kaliya, OpenTable iyo Aqqo Nederland oo kaliya). Server-ku isna wuu hubiyaa.
• Dhowr madal hal mar: waxaad isku xidhi kartaa dhowr madal oo wada jira, tusaale ahaan TheFork iyo Formitable. Laba madal weligood ma helaan miis isku mid ah isla waqtiga; markaas ballanta labaad waxay timaadaa miis la'aan.
• + Ku xir barxamad: dooro barxamadda oo buuxi xogta. Sirta (Client secret, furaha dib-u-sheegidda) weligeed kuma muuqato dulmarka; banaan ka tag = hay, Tirtir = ka saar.
• TheFork (API B2B dadweyne): Restaurant-UUID, Client ID iyo Client Secret (laga codsado TheFork). Haddii qalabka iibku joojiyo, TheFork-na wuu ka joojiyaa.
• Formitable, Zenchef, Resengo, OpenTable, PlanPanther, RestoManager, Aqqo: API-gooda waxaa loogu talagalay lammaanayaasha oo kaliya ama ma furna (PlanPanther, RestoManager iyo Aqqo: isku xirka kaashka waxaa lagala heshiiyaa iyaga). Dhacdooyinka Formitable (booking.created, .changed, .canceled, .checkin, .checkout) waa la aqoonsadaa.
• Khariidadda qolka: haddii miis ku jira qalabka iibku leeyahay magac la mid ah miiska barxamadda oo uu banaan yahay waqtigaas, ballansashadu waxay aadaysaa miiskaas; haddii kale miis la'aan (dooro marka uu yimaado). Ballansasho mar kale timaada waa la cusboonaysiiyaa, lama labanlaabo. Dulmarka waxaa ku qoran "via TheFork".
• Xaaladda: haddii barxamaddu joojiso ama sheegto no-show, qalabka iibku wuu qaataa. Wixii qalabka iibka horay ugu yimid, waxay ahaanayaan yimid.
• Dib u sheeg (no-show dib): geli cinwaan dib-u-sheegid (tusaale ahaan kan adeeggaaga isku-xirka). Qalabka iibku wuxuu u diraa isbeddel kasta oo ka yimaada qalabka iibka (yimid, no-show, la joojiyay, la bixiyay iyo lacagta) JSON ahaan: { platform, id, status, statusEn, bedrag, valuta, tafel, tijdstip, gemeldOp } (lacagta sentiyo ahaan, oo kaliya marka la bixiyo), oo leh Authorization: Bearer <terugmeld-sleutel> haddii aad geliso. Haddii ay guuldareysato, qalabka iibku daqiiqad kasta ayuu isku dayaa, khaladkuna wuxuu ka muuqdaa barxamadda. Wixii ka yimid barxamadda lafteeda dib looma diro.
• Ballansasho tijaabo ah: waxay samaysaa ballansasho sidii barxamaddu u diri lahayd.
• Tirtir: isku-xirka iyo furaha waa la tirtiraa; ballansashooyinku way sii jiraan.
• Dhammaan isbeddellada waxay ku jiraan diiwaanka (sir la'aan).

Barnaamijyada daacadnimada iyo faallooyinka

Laba furaha oo kala gooni ah oo ku jira Dejinta → Dhibco iyo faallooyin (labaduba caadi ahaan waa dansan, markaas meelna waxba lagama arko). Haddii aad damiso, dejintu iyo wixii horey u dhacay way kaydsan yihiin.

Barnaamij daacadnimo oo madal kale ah: martidu waxay dhibco ku ururisaa Joyn (Beljimka) iyo/ama Piggy (Leat; Nederland iyo Beljimka). Tani way ka go'an tahay kaarka macmiilka ee kaashka; labaduba way wada shaqeyn karaan.

• Dhowr hal mar: Beljimka Piggy iyo Joyn waa wada shidnaan karaan, mid kasta xogtiisa gaarka ah (dooro madasha, buuxi, Kaydi; Wax ka beddel iyo Tirtir madal kasta). Martidu barnaamij kasta waxay u helaysaa kood QR u gaar ah oo rasiidka ku yaal, link u gaar ah oo ku jira rasiidka iimaylka lagu diray iyo badhan u gaar ah oo dukaanka online ku yaal, waxayna barnaamij kasta dhibco ku ururisaa hal mar dalab kasta. Wixii horey loo dejiyay si caadi ah ayay u sii shaqaynayaan.
• QR code rasiidka: lacag bixinta kadib, rasiidka hoostiisa waxaa ku yaal QR code leh "Sawir oo dhibco ku ururi ...". Rasiidka iimaylka waxaa ku jira link, dukaanka online-ka (qaadasho iyo keenis) waxaa ku yaal badhan bogga dalabka iyo link iimaylka xaqiijinta. Hal dalab wuxuu dhibco bixiyaa hal mar oo keliya: rasiidka, iimaylka iyo dukaanka online-ka waxay isticmaalaan isla koodh gaar ah (lambarka dalabka). "QR code ku yaal rasiidka daabacan" waad dami kartaa; iimaylka iyo dukaanka online-ka weli link-ga way helayaan.
• Piggy, habka "QR code iyo link": buuxi ciwaanka bogga macaamiisha Piggy, Shop UUID iyo Account secret (Piggy Business Dashboard). Wuxuu shaqeeyaa internet la'aan: kaashku laftiisa ayaa link-ga sameeya.
• Piggy, habka "Isla markiiba ku dar": sidoo kale buuxi personal access token (Piggy → Marketplace → Private App). Haddii kaashku rasiidka iimayl ku diro oo martida iimaylkaas leh horey xubin u tahay, kaashku dhibcaha isla markiiba wuu ku daraa; rasiidka waxaa markaas ku qoran "Dhibcaha waa lagu daray Piggy". Kaashku weligii xubin cusub ma abuuro; xubin ma aha (ama iimayl ma jiro) = QR code.
• Joyn, habka "QR code iyo link": partner key, shop reference iyo shared secret ee Joyn (ka codso api-integration@joyn.be). Wuxuu shaqeeyaa internet la'aan. QR code-ku wuxuu shaqeeyaa 2 saacadood.
• Joyn, habka "Iyadoo API la marayo": shop API key (xiriirka ka shid bogga ganacsatada ee Joyn). Marka lacagta la bixinayo kaashku wuxuu Joyn ka codsadaa koodh dhibco. Beddelka dhibcaha sida caadiga ah wuxuu ka dhacaa Joyn-iPad.
• Samee link tusaale ah: wuxuu hubiyaa in xogtu sax tahay (link € 10 ah; u fur kaliya si aad u eegto).
• Kaliya madallada dalka ganacsiga ayaa la dooran karaa; sirtu waxay ku jirtaa xogta oo keliya, weligeedna shaashadda kama muuqato (bannaan u daa = sidii ayuu ahaanayaa).

Codso faallooyin: booqashada kadib hal iimayl oo leh badhan u horseeda Google iyo/ama Trustpilot.

• Dhowr saacadood kadib (waa la beddeli karaa, caadi ahaan 3) martidu waxay heshaa iimaylka, luqadda rasiidka.
• Dukaanka online-ka: qaadashada iyo keenista dukaanka online-ka laftiisa ayaa iimaylka dira, dhowr saacadood kadib marka dalabka kaashka lagu dhammeeyo, luqadda martida.
• Google: dheji link-ga faallada ee Business Profile-kaaga (Google → Business Profile-kaaga → Codso faallooyin, https://g.page/r/.../review) ama buuxi Place ID.
• Trustpilot: buuxi domain-ka ganacsigaaga (badhanku wuxuu u tagaa trustpilot.com/evaluate/<domein>). Haddii aad Trustpilot ku leedahay ciwaan casuumaad (Automatic Feedback Service, ...@invite.trustpilot.com), sidoo kale buuxi: iimaylka wuxuu markaas BCC ahaan ugu tagaa Trustpilot, magaca, iimaylka iyo lambarka rasiidka oo qarsoon, Trustpilot laftiisa ayaa casuumaadda dira (markaas badhan Trustpilot oo kaaga gaar ah ma jiro). Kaliya Trustpilot oo leh ciwaan casuumaad: kaashku wuxuu iimayl u diraa Trustpilot oo keliya.
• Ha badnaan: isla martida (iimaylka) waxay heshaa ugu badnaan hal codsi muddadii (caadi ahaan 90 maalmood; 0 = mar walba). Kaashku arrintan wuxuu u kaydiyaa kaliya hash-ka ciwaanka; iimaylka laftiisa waa la tirtiraa marka la diro (haddii aysan suurtoobin, saddex isku day kadib, haddii kale 14 maalmood kadib).
• QR code rasiidka (ikhtiyaari): sidoo kale QR code faallo ah oo ku yaal rasiidka daabacan hoostiisa.
• Tusaalaha iimaylka iyo Tirtir iimaylada sugaya (ciwaannadu isla markiiba way baxaan). Diiwaanku wuxuu muujiyaa review_gevraagd oo leh a***@domein.nl.
• Google iyo Trustpilot waxay mamnuucaan abaalmarin faallo loo bixiyo iyo in martida qanacsan oo keliya la weydiiyo ("review gating"). Sidaas darteed kaashku qof walba si isku mid ah ayuu u weydiiyaa, waxbana kama bixiyo faallo.
• Akhri oo ka jawaab faallooyinka kaashka: eeg Maamulka faallooyinka hoos.

Xiriirka Mailchimp iyo Klaviyo

Macaamiishaada kaarka macmiilka barnaamijkaaga iimaylka: Dejinta → Ganacsiga → Mailchimp iyo Klaviyo (hoosta suuq-geynta SMS iyo iimaylka). Ma jiro furaha shid/dami: xiriir la'aantiis oo liis la doortay leh waxba ma dhacaan.

• Ku xir: adoo isticmaalaya furaha API (Mailchimp: Profile → Extras → API keys; Klaviyo: fure gaar ah pk_… oo leh xuquuqda qorista ee Lists, Profiles, Subscriptions, Events, Campaigns iyo Templates). Sirta client-ka iyo furaha mar dambe shaashadda kuma soo muuqdaan (ka tag madhan = hay). Kadib waxaad doorataa liiska (Mailchimp: audience).
• Macaamiisha: qofkii oggolaaday iimaylka wuxuu aadaa liiska (ku biiray), oo leh magaca hore, magaca dambe, telefoonka, dhalashada iyo dhibcaha (Mailchimp: goobta PUNTEN, kaashku isagaa sameeya; Klaviyo: astaanta punten). Oggolaansho la qaatay, cinwaanka iimaylka la beddelay ama macmiil la tirtiray: iska saaray. Kaliya waxa isbeddelay ayaa mar kale la diraa. Marka xiriir jiro, kaashka (iyo calaamadda "dallacaadyo" ee dukaanka online) wuxuu macmiil cusub sidoo kale weydiiyaa oggolaanshaha iimaylka, waxaana lagu beddeli karaa Warbixin → Macaamiisha, xitaa iyada oo aan la haysan suuq-geynta iimaylka ee gaarka ah.
• Iska saarid: qofkii iska saara Mailchimp ama Klaviyo, kaashka sidoo kale oggolaansho iimayl uma hayo (diiwaanka: "iska saaray Mailchimp"). Qofkii isagu iska saaray, kaashku dib uma biiriyo.
• Dalabyada: rasiid kasta oo la bixiyay oo macmiil liiska ku jira wuxuu u raacaa dhacdo ahaan (Mailchimp: bestelling, oo leh qaddarka, lambarka rasiidka iyo tirada; Klaviyo: Placed Order, oo leh qiimaha euro). Taas ayaad barnaamijka iimaylka ku samaysaa iimaylo toos ah, tusaale kadib dalabka koowaad ama haddii qof bil soo maqnaado. Rasiidyada ka horreeyay doorashada liiska lama raaciyo.
• Dallacaadyo: Warbixin → Suuq-geyn waxaad dallacaad sidoo kale ku diri kartaa Mailchimp ama Klaviyo (eeg Suuq-geynta SMS iyo iimaylka); markaas kaashku halkaas ayuu ololaha ku sameeyaa oo diraa.
• Cusboonaysiin: 5 daqiiqo kasta, ama Hadda cusboonaysii. Ka goynta xiriirka: kaashka waa laga saaraa; Mailchimp iyo Klaviyo wax walba way ku harayaan. Furayaashu waxay ku jiraan database-ka (waa ku jiraan kaydka nuqulka, kuma jiraan dhoofinta dejinta).

Koodh: lib/mailinglijst.ts, routes/mailinglijst.ts iyo MailingKoppelingen.tsx.

BI iyo dhoofinta xogta

Xogta iibka u dir Power BI, Looker Studio, Excel, Google Sheets, Tableau, Qlik Sense, Metabase, adeeg BI (tusaale YourBI, BI4Horeca ama Moore DRV) ama data warehouse kaaga gaar ah. Ka shid Dejinta → BI iyo dhoofinta xogta (caadi ahaan waa dansan). Akhris keliya: isku xir kasta wax kama beddeli karo kaashka. Xog martida ah ma jirto.

• Xogta: rasiidyo (oo ay ku jiraan rasiidyada deynta), alaab la iibiyay (safafka rasiidka), lacag-bixinno, dakhliga maalinlaha, dakhliga saacadlaha, storno, alaab, shaqaale (PIN la'aan) iyo saacadaha la shaqeeyay. Qaddarrada waa euro iyadoo dhibic loo isticmaalo calaamadda tobanlaha, waqtiyaduna waa waqtiga meheradda.
• + Isku xir: dooro barnaamijka iyo habka. Barnaamij kasta wuxuu taageeraa hal hab ama ka badan; waxaad yeelan kartaa dhowr isku xir hal mar (sidoo kale isla barnaamij).
• Barnaamijku keligiis ayuu soo qaadaa (API): kaashku hal mar ayuu bixiyaa fure akhris keliya. Muddada iyadoo la isticmaalayo ?van=&tot= (YYYY-MM-DD) ama cinwaan go'an oo leh ?periode= (vandaag, gisteren, 7d, 30d, 90d, 365d, week, maand, vorigemaand, jaar); ugu badnaan 366 maalmood, ugu badnaan 200.000 saf. Furaha wuxuu galaa Authorization: Bearer, X-Sleutel ama ?sleutel=.
• Iyada oo loo marayo portal-ka: haddii kaashku ku xiran yahay portal-ka macaamiisha, isla cinwaankaas wuxuu ka shaqeeyaa meheradda dibaddeeda, iyadoo aan deked la furin: https://<portaal>/bi/<kassa-id>/<gegevens>?periode=90d&formaat=csv&sleutel=.... Sidaas adeegga Power BI ayaa u cusbooneysiiya jadwal ahaan (gateway la'aan), Google Sheets-na wuu soo qaadan karaa =IMPORTDATA("...") (sidoo kale ilaha Looker Studio). Kaashku wuxuu cinwaanka ku muujiyaa isku xirka.
• Guudmarka laamaha ee portalka macmiilka (ganacsiyo badan): hal cinwaan iyo hal fure oo dhammaan kaashashkaaga ah. Kaash kasta oo ka qayb qaadanaya ka shid Guudmarka laamaha ee portalka macmiilka (hoosta badhanka BI) oo portalka macmiilka ka samee fure, qaybta Kaashadahayga → BI ganacsiyadaada oo dhan. Kadib: https://<portaal>/bi/keten/<gegevens>?periode=90d&formaat=csv&sleutel=hpk_.... Portalku xogta wuxuu ka soo qaadaa kaash kasta oo isku daraa, iyadoo saf kasta leeyahay kassaId iyo zaak. Kaashashka offline-ka ah ama aan ka qayb qaadan waxay ku jiraan ontbrekend (JSON) iyo madaxa X-Ontbrekend. Kaashku laftiisu uma baahna fure u gaar ah; in laga damiyo kaashka ama portalka macmiilka ayaa joojinaya.
• Haddii token jiro, wuxuu u socdaa sida Authorization: Bearer, saxiixna wuxuu ku jiraa X-HorecaPOS-Handtekening (sha256= HMAC ee waxa ku jira). Haddii ay guuldareysto, kaashku daqiiqad kasta ayuu isku dayaa mar kale; waxba laba jeer lama diro. Iyadoo la isticmaalayo laga bilaabo wuxuu sidoo kale diraa rasiidyo hore.
• Kaashku wuxuu keenaa faylal: maalin kasta (waqti go'an, maalintii ka horreysay; maalmaha la seegay waa la buuxiyaa) ama saacad kasta (maanta ilaa hadda), sida CSV (hakad, ama hakad-dhibic Excel Nederland) ama JSON, una dira gal ku jira kombiyuutarka kaashka (tusaale gal OneDrive ama SharePoint oo loogu talagalay Power BI ama Excel), server FTP(S) ama SFTP ama iimayl. Magacyada faylasha: horecapos_<gegevens>_<datum>.csv.
• Dir tijaabo (push) iyo Hadda dhoofi (fayl) ee isku xirka.
• Adigu soo deji: dooro xogta, muddada iyo qaabka.
• Template-ka Power BI (.pbit): warbixin diyaar ah oo loogu talagalay Power BI Desktop, oo leh Soo deji template-ka Power BI qaybta BI iyo dhoofinta xogta. Marka hore samee isku xir API (Power BI). Moodelka: shax xog-ururin kasta oo leh noocyada saxda ah, kalandar (sanad, bil, toddobaad, maalinta toddobaadka), xiriirro (taariikh → kalandar, safafka rasiidka → alaabta, saacadaha la shaqeeyay → shaqaalaha) iyo cabbirro (iibka oo leh iyo aan lahayn VAT, VAT, tiib, rasiidyo, marti, celceliska rasiid kasta iyo marti kasta, tirada la iibiyay, iibka alaabta, la bixiyay, storno, saacadaha la shaqeeyay, iibka saacad kasta oo la shaqeeyay). Saddex bog: Guudmar (tirooyinka muhiimka ah, iibka maalinta, maalinta toddobaadka iyo saacadda, hababka lacag-bixinta), Alaabta (koox kasta iyo alaab kasta) iyo Shaqaalaha (saacadaha iyo iibka shaqaale kasta). Portalka, adeegga Power BI sidoo kale wuu cusboonaysiiyaa jadwal ahaan.
• Sirta (token, furaha sirta, fure) weligeed kama muuqato dulmarka; madhan = hay, Tirtir = ka saar. Wax walba waxay ku jiraan diiwaanka (sir la'aan).

Mushahar iyo qorshayn

Marka Saxiixa gelitaanka iyo ka bixitaanka uu shidan yahay (Dejinta → Ganacsiga), Dejinta → Saacadaha shaqada xaggeeda hoose waxaa ku yaal Mushahar iyo qorshayn (oggolaanshaha Maaraynta dejinta), oo laba qaybood oo kala gooni ah. Haddii saxiixu dansan yahay, saacado ma jiraan: markaas waxaa jira oo keliya qaybta Qorshaynta shaqaalaha (dakhliga, toos ah ama fayl dakhli) xagga hoose ee Dejinta → Xisaabaadka, cinwaanka hoostiisa Dakhliga u dir qorshayntaada:

• Maamulka mushaharka (payroll): dooro barnaamijka mushaharka ama (Beljim) xoghaynta bulshada, buuxi goobahiisa iyo shaqaale kasta lambarkiisa shaqaale ee barnaamijkaas. Kadib muddo waxaad u samaynaysaa faylka saacadaha la shaqeeyay (shaqooyin la xiray, shaqaale kasta maalinta uu galay) iyo dakhliga shaqaale kasta (VAT la'aan, waxa uu/ay lacag ka qaaday): diyaar u ah Loket.nl (Variabele gegevens, wadarta shaqaale kasta ee muddada, safka madaxa aanslnr;persnr;ploeg;<looncomponent>) iyo SD Worx Beljim (Tijdsregistratie, meelo go'an, shaqaale kasta maalin kasta), haddii kale liiska saacadaha (CSV: Taariikh; Lambarka shaqaalaha; Magac; Saacado; Dakhli VAT la'aan). Shaqaalaha aan lambar shaqaale lahayn kuma jiraan faylka Loket ama SD Worx; kaashka ayaa sheegaya cidda ay yihiin.
• Qorshaynta shaqaalaha (WFM): dooro nidaamka qorshaynta. Dib u dirista waxay beddeshaa xogtii hore. Sidoo kale liiska dakhliga (CSV maalin iyo saacad kasta, VAT la'aan iyo VAT ku jiro) iyo Strobbo faylka Excel ee Importeer omzet.
• Kaliya barnaamijyada ka shaqeeya dalka ganacsiga, koox kasta iyo sida alifbeetada; server-ku wuxuu diidaa barnaamij ka yimid dal kale (400).
• Furayaasha iyo token-yada weligood shaashadda kama muuqdaan.
• Waxay saameysaa xisaabaadka: kharashka mushaharka barnaamijka mushaharka ayaa xisaabaadka ku diiwaangeliya, dakhliga kaashka ayaa diiwaangeliya (Dejinta → Xisaabaadka). AFAS Payroll iyo Exact Online Loon waxay ku jiraan isla deegaanka xisaabaadka AFAS iyo Exact.
• Nuqulka kaashka ee portal-ka tan laguma samayn karo (kaashka ganacsiga ku jira ayaa sameeya).
• Barnaamijyo qaar API-gooda ma aha mid dadweyne ama waa la-hawlgalayaasha oo keliya (tusaale Loket, Nmbrs, Nostradamus, Employes, Shyfter, Planday, Eitje): kuwaas waa marka la codsado; ilaa markaas faylka. Qaabka SD Worx iyo Strobbo wuxuu ka yimid dukumentiyadooda: ka codso in la hubiyo soo-gelinta ugu horreysa.

Shuruudaha sharciga ee Beljim iyo Nederland

Waxa sharcigu dalbado iyo waxa HorecaPOS u qabto (xisaabiyahaaga ha xaqiijiyo waxa khuseeya ganacsigaaga):

Sharciga iyo xeerarka

Dejinta → Sharciga iyo xeerarka (maamulaha; kaaliyaha VAT-ga sidoo kale xuquuqda Maamul alaabta). Wax walba si caadi ah way dansan yihiin; dejintan la'aanteed khasnaddu sidii hore ayay u shaqaysaa.

• Hubinta da'da khamriga (18+): Alaabta ku calaamadee Waxaa ku jira khamri (ama isticmaal kaaliyaha VAT-ga). Qaadashada iyo keenista khamriga leh "18+" ayaa ku qoran rasiidka shaqada, rasiidka khasnadda iyo shaashadda dalabka. Dukaanka online-ka macmiilku isaga ayaa xaqiijinaya inuu jiro 18 sano ama ka weyn (sanduuqa horay looma calaamadeyn) wuxuuna arkayaa in da'da la hubin doono marka la keenayo.
• Khidmadda baakadda la tuuro (Nederland): alaab kasta qiime (qiimayaal la soo jeediyey: koob € 0,25, weel cunto € 0,50, weel yar € 0,05). Marka la qaato ama la keeno khasnaddu iyadaa rasiidka ku dari saf "Khidmadda baakadda la tuuro" (oo leh VAT-ga alaabta); si toos ah ayuu ula socdaa alaabta (kaydka xogta ayaa raaca, xitaa ka dib tirtir, wareejin ama nooc dalab oo kale) si gaar ahna dakhliga ugu jira. Meesha lagu cunayo khidmad ma jirto. Thuisbezorgd.nl iyo dukaanka online-ku waxay xisaabiyaan khidmaddooda.
• Deposit (Nederland): alaab kasta (€ 0,15 qasac/dhalo yar, € 0,25 dhalo weyn), saf "Deposit" VAT la'aan, oo keliya marka la qaato ama la keeno.
• Lacag caddaan ah € 3.000 ama ka badan (Nederland, laga bilaabo 1-1-2026 waa mamnuuc badeecadda): marka la qaato ama la keeno digniin marka lacagta la bixinayo iyo mashiinka lacagta; shaqaaluhu wuu xaqiijin karaa (tusaale cunto-bixin adeeg ahaan), taasina waxay gashaa diiwaanka. Cunista iyo cabitaanka meesha waa adeeg: digniin ma jirto.
• Kaaliyaha VAT-ga: alaab kasta nooca (cunto, cabitaan aan khamri lahayn, cabitaan khamri leh, cunto aan diyaarin u baahnayn, kale; marka hore qiyaas ku salaysan magaca iyo kooxda). Khasnaddu waxay muujisaa heerka saxda ah meesha lagu cunayo iyo qaadashada (Beljiyam laga bilaabo 1-3-2026: cuntooyin iyo cabitaanno fudud 12%, xitaa qaadasho; khamri 21%; cunto aan diyaarin u baahnayn 6%. Nederland: 9% iyo 21%) wayna dabaqdaa, isla markiiba ama laga bilaabo taariikh.
• Qorsheynta isbeddelka VAT-ga: alaab loo wareejiyo heer kale, ama (Nederland oo keliya) heer leh boqolley cusub, laga bilaabo taariikh. Khasnaddu iyadaa fulisa maalintaas (rubuc saac kasta waa la eegaa, iyo marka la shido).

Qaansheegyada (Beljiyam qasab ka ah shirkadaha dhexdooda) waxay ku jiraan Qaansheegyo loogu talagalay macaamiisha ganacsiga. Weli la samayn: GKS 2.0, weydii xaaladda shahaadeynta (eeg docs/backlog-concurrenten.md).

Qaansheegyo loogu talagalay macaamiisha ganacsiga

Dejinta → Qaansheegyo (maamulaha; si caadi ah waa dansan yahay): shid Qaansheegyo loogu talagalay macaamiisha ganacsiga (UBL / Peppol). Marka uu shidan yahay, hoostiisa waxaa ku jira Bixinta deynta, Xogta qaansheegga, Adeegyada Peppol, Isku xirka bangiga (oo leh bixinta deynta) iyo liiska dhammaan qaansheegyada. Beljiyam qaansheegga elektaroonigga ah ee u dhexeeya shirkadaha waa qasab laga bilaabo 1-1-2026.

• Qaansheegad macaamiisha ganacsiga: Rasiidyada → dooro rasiidka → Qaansheegad. Geli macmiilka (ama dooro mid hore); khasnaddu waxay samaysaa qaansheegad lambar leh (tusaale F2026-0001, sannad kasta kordhaya), sida UBL sida uu dhigayo Peppol BIS Billing 3.0 iyo qaansheegad la daabaco ama PDF ahaan loo kaydiyo. U dir e-mail (labaduba lifaaq ahaan, haddii la doono nuqul xisaabiyaha), iyada oo loo marayo Billit shabakadda Peppol (BILLIT_API_KEY, BILLIT_PARTY_ID), iyada oo loo marayo Storecove (STORECOVE_API_KEY, STORECOVE_LEGAL_ENTITY_ID; qaataha waxaa laga helaa Peppol-ID-ga macmiilka, tusaale 0208 → BE:EN, 0106 → NL:KVK, haddii kale e-mail iyada oo loo marayo Storecove) ama iyada oo loo marayo Banqup ee Unifiedpost (BANQUP_CLIENT_ID, BANQUP_CLIENT_SECRET, BANQUP_SPACE_ID; BANQUP_SANDBOX=1 deegaanka tijaabada; Banqup waxay hubisaa UBL-ka oo iyadu gaarsiisaa), cinwaan adiga kuu gaar ah (FACTUUR_HTTP_URL, tusaale barnaamij xisaabeed ama adeeg kale oo Peppol) ama soo dejin. Hal qaansheegad rasiid kasta; rasiidka horay ayaa loo bixiyay, sidaas darteed "la bixiyay". Lambarka KvK/shirkadda, IBAN, Peppol-ID, horgalaha iyo muddada lacag bixinta waxay ku jiraan Xogta qaansheegadka. Dhammaan qaansheegadka waxay ku jiraan xagga hoose ee tabka (oggolaanshaha Iibka muddo kasta).
• Furayaasha, sirta iyo madaxyada weligood lama muujiyo (kaliya "la buuxiyay"; madhan ka tag = hay, Masax = waa la tirtiray) lagumana qoro diiwaanka (kaliya meelaha isbeddelay). Waxay ku jiraan database-ka (vestiging.peppol_gegevens): waa ku jiraan kaydka nuqullada, kuma jiraan dhoofinta dejinta.

Kiosk is-adeeg ah

Martidu iyagaa ku dalbada tiir ama tablet, sida makhaayadda cuntada degdegga ah, waxayna ku bixiyaan khasnadda ama kaar ahaan kiosk-ga. Shaashadaha dalabku waa qayb ka mid ah khasnadda lafteeda, sidaas darteed liiska, qiimayaasha, doorashooyinka, menu-yada, happy hours, qaybaha maalinta, sawirrada, xasaasiyadaha, luqadaha iyo rasiidka waxay ka yimaadaan khasnadda mana aha in meel kale lagu dejiyo. Kiosk-ga waxaa ku shaqeeya app-ka PinPortal Kiosk 2 (Android, oo ay ku jirto Sunmi, iyo Windows, Linux iyo macOS), kaas oo muujiya bogga oo daabaca rasiidka. Asal ahaan waa dansan yahay.

Shidid iyo dejin (maamule): Dejinta → Ganacsiga → Shaashadaha iyo isticmaalka → Kiosk is-adeeg ah.

• Dooro waxa martidu dooran karto: Halkan ku cun iyo/ama Qaado (qaadashadu waxay isticmaashaa qiimaha qaadashada iyo heerka VAT-ka qaadashada, haddii la dejiyay).
• Qoraalka soo dhaweynta, imisa ilbiriqsi oo aan la taaban kadib kioskigu ku noqdo bilowga (dambiishana waa la madhiyaa), iyo kooxaha alaabta ee kioskiga ku jira (waxba la ma calaamadin = dhammaan).
• Wax kale ma rabtaa?: calaamadee kooxo alaab (tus. cabbitaanno, macmacaan); dambiisha agteeda kioskigu wuxuu markaas soo jeedinayaa dhowr alaab oo ka mid ah.
• Lacag bixinta, kiosk kasta (eeg Ku darista iyo isku xidhka kiosk):
  • Khasnadda (asal ahaan, sida kiosk-gii hore): martidu way dalbataa, waxay heshaa lambar qaadasho waxayna ku bixisaa khasnadda. Kiosk-ga looma baahna mashiinka kaarka.
  • Kaar ahaan kiosk-ga: martidu waxay ku bixisaa mashiinka kaarka ee kiosk-ga agtiisa.
  • Martidu waa dooranaysaa: khasnadda ama kaar. Haddii kiosk-gu uusan lahayn mashiinka kaarka, waxaa lagu bixiyaa khasnadda.
• Jikada (marka khasnadda lagu bixinayo): isla markiiba kadib dalabka kiosk-ga (asal ahaan), ama kaliya marka khasnadda lagu bixiyo.
• Rasiid: daabacaha kiosk-ga (asal ahaan), daabacaha rasiidka khasnadda, ama rasiid la'aan (lambarka shaashadda oo keliya). Marka khasnadda lagu bixinayo, kiosk-gu wuxuu daabacaa warqad leh lambarka iyo weli lama bixin; rasiidku wuxuu yimaadaa marka khasnadda xisaabta lagu xiro.
• Xaaladda dalabka ee taleefanka (ikhtiyaari, asal ahaan dansan): koodh QR ayaa ka muuqda rasiidka kiosk-ga iyo shaashadda ugu dambeysa. Martidu way iskaan gareysaa, waxay aragtaa lambarkeeda iyo xaaladda (la dalbaday, waa la diyaarinayaa, diyaar) waxayna heshaa ogeysiis marka dalabku diyaar yahay. Waxay ku shaqeysaa bogga maamulka, sidaas darteed khasnaddu waa inay ku xiran tahay.
• Khamriga iyo alaabta kiilo lagu iibiyo weligood kuma jiraan kioskiga: shaqaale la'aan da'da lama hubin karo, miisaanna ma jiro.
• Iskaanka barkoodka (ikhtiyaari, caadi ahaan dhammaan dansan): calaamadee waxa iskaanku ku samayn karo kiosk-ka:
  • alaab dambiisha (koodhka alaabta);
  • koodh qiimo-dhimis;
  • kaarka macmiilka (martidu dhibco ayay kaydsataa);
  • kaarka hadiyadda ama kaarka horay-u-bixinta lacag-bixin ahaan. Haddii haraagu ku filan yahay, dalabka isla markiiba waa la bixiyay. Haddii kale kaarku qayb ayuu bixiyaa, martiduna inta kale waxay ku bixisaa kaar ama qalabka lacag-qaadka (taas waa la ogol yahay xitaa kiosk kaar keliya ah). Lacag-bixin qayb ah kadib martidu ma joojin karto; dalabku wuxuu qalabka ka muuqdaa sida Kiosk … · lambar.

Iskaanka laftiisa waxaad ku dejisaa kiosk-ka: app-ka PinPortal Kiosk 2 ee maamulka → Iskaanka barkoodka (sida kiiboodh, iskaanka ku dhex dhisan ama dekedda COM), oo leh tijaabo iskaan. Iskaan u shaqeeya sida kiiboodh wuxuu shaqeeyaa xitaa app-ka la'aantiis.

• Ku shub haraaga (ikhtiyaari, caadi ahaan waa dansan yahay; wuxuu shaqeeyaa kaliya marka haraa la shuban karo shidan yahay): markaas shaashadda bilowga ee kiosk-ga waxaa ka muuqda Ku shub haraaga. Martidu waxay iskaan gareysaa kaarkeeda ama kaarka hadiyadda (ama qortaa koodhka), waxay aragtaa haraaga waxayna doorataa lacag. Lacagaha adigaa dejiya (1 ilaa 6, caadi ahaan € 10, € 20 iyo € 50). Lacag bixintu waxay u dhacdaa sida kiosk-ga loo dejiyay: kaarka, ama khasnadda iyadoo la isticmaalayo lambarka qaadashada. Lacag bixinta kadib lacagta waxay ku jirtaa haraaga. Ku shubiddaas uma tagto jikada, kama muuqato shaashadda u yeedhista mana helo koodh QR. Haraaga ugu badan ee haraa la shuban karo halkan sidoo kale wuu khuseeyaa.
• Qolkayga (xiriirka hoteelka, asal ahaan dansan; Dejinta → Hoteel → Is-adeeg): markaas dambiisha agteeda waxaa ka muuqda Qolkayga ku qor. Martida hoteelku waxay gelisaa lambarka qolka iyo magaca qoyska; haddii ay la mid tahay marti hadda qolkaas deggan, dalabku wuxuu aadaa jikada oo waxaa qolka loogu qoraa sidii la bixiyay (eeg Barnaamijka hoteelka: qolka ku qor).
• Beljamka (sanduuqa madow): waxa aan weli lagu tijaabin sanduuqa madow si toos ah ayay kiosk-ka uga dansan yihiin (kaarka hadiyadda ama haraaga lacag-bixin ahaan, ku shubid, koodhka qiimo-dhimista, menu-yada, doorashooyin qiime dheeraad ah leh, happy hour), sida kashiirka oo kale.

Ku darista iyo isku xidhka kiosk

1. Qaybta Kioskyada ku qor magac (tus. Kiosk albaabka) oo dooro Ku dar kiosk. Waxaad helaysaa koodh isku xidh ah oo 6 god ah (wuxuu shaqeeyaa 30 daqiiqo).
2. Kiosk-ga ku dooro sida martidu u bixiso: asal ahaan khasnadda. Haddii uu yahay kiosk leh mashiinka kaarka, dooro kaar ama martidu waa dooranaysaa, oo dooro mashiinka kaarka ee kiosk-gan (ka Dejinta → Lacag bixinta).
3. Kioskiga ka fur bogga kioskiga:
   • ganacsiga gudihiisa: app-ka, maamulka → Vast adres, cinwaanka ku qoran dejinta, tus. http://192.168.1.20:3000/kiosk;
   • ama portalka maamulka (https, xitaa haddii kioskigu uusan ku jirin isla shabakadda): cinwaanka kioskiga ee ku qoran dejinta ku xir koodhka kioskiga ee app-ka, sidii kioskigii hore.
4. Koodhka isku xidhka ku qor kioskiga. Waa dhammaatay: kioskigu wuxuu xasuustaa furihiisa. Mar kale ku xir wuxuu bixiyaa koodh cusub; Ka saar wuu kala furaa.

Kiosk kasta waxaa lagu arkaa inuu online yahay iyo in kale.

Sida martidu u dalbato

1. Shaashadda bilowga oo leh qoraalka soo dhaweynta; martidu waxay doortaa luqaddeeda (dhammaan luqadaha qasnadda) oo taabataa si ay u dalbato.
2. Halkan ku cun ama qaado.
3. Liiska kooxda alaabta, oo leh sawirro, qiimaha (happy hour), xasaasiyad iyo waxa dhammaaday. Alaabta leh doorashooyin ama menu waxay furaan daaqadda doorashada.
4. Dambiisha: beddel tirada oo ikhtiyaar ahaan Wax kale ma rabtaa?.
5. Dalbo (khasnadda ku bixin): martidu waxay aragtaa lambarka qaadashada oo weyn shaashadda iyo qaddarka, waxay qaadataa warqadda waxayna ku bixisaa khasnadda. Khasnadda dalabku wuxuu u furan yahay sida Kiosk Albaabka · 42 (lambarka martidu sheegto); xisaabta sidii caadiga ahayd. Kadib wuxuu shaashadda wicitaanka uga muuqdaa mid la bixiyay wuxuuna aadaa jikada haddii taasi ahayd kadib bixinta oo keliya.
6. Kaar ku bixi: khasnaddu waxay qaddarka u dirtaa mashiinka kaarka ee kiosk-gan (isla xiriirka lacag bixinta ee khasnadda). Haddii ay fashilanto, martidu waxay isku dayi kartaa mar kale ama joojin kartaa (ama, haddii loo ogol yahay inay doorato, ku bixin kartaa khasnadda). Kaliya marka bixintu guulaysato ayuu dalabku aadaa jikada oo la xisaabiyaa. Martidu waxay aragtaa lambarka qaadashada oo weyn shaashadda waxayna heshaa rasiidka.
7. Dhowr ilbiriqsi kadib kiosk-gu wuxuu ku noqdaa bilowga.

Marka cillad jirto: ogeysiis iyo habka degdegga (app-ka kiosk-ga, maamulka → Bij storing; caadi ahaan waa dansan yahay). Haddii kiosk-gu gaari waayo khasnadda, waxaa ka muuqda Even gesloten. Laba dheeri ah:

• Teams, Slack, Discord, ntfy, Home Assistant, Make ama Zapier), iyo hersteld marka wax walba mar kale shaqeeyaan. Testmelding sturen ayaad ku hubisaa cinwaanka.
• Habka degdegga: kiosk-gu wuxuu keydiyaa menu fudud oo uu soo gudbiyo bogga kioskiga: alaab aan lahayn doorashooyin ama menuyo isku dhafan, oo leh qiimaha halkan wax lagu cuno (ama qaadashada, haddii taasi tahay doorashada kaliya).
  • Haddii khasnaddu muddo maqan tahay (caadi ahaan 60 ilbiriqsi), martidu waxay ka dalbataa menu-gaas.
  • Martidu waxay ku bixisaa kaar ama miiska adeegga. Kaar ku bixintu waxay suurtagal tahay oo kaliya haddii Pinbetaling uu ka shidan yahay app-ka.
  • Waxaa soo baxa laba rasiid degdeg ah: mid martida ah (N1, N2 …) iyo mid miiska adeegga/jikada ah. Waxaa ku qoran inaanu ahayn rasiidka khasnadda.
  • Marka khasnaddu soo laabato, bogga kioskiga wuxuu dalabyada degdegga ah khasnadda ku daraa sida Nood N… <kiosk>. Uma gudbaan jikada (horay ayay u haysatay rasiidka degdegga ah) kamana muuqdaan shaashadda u yeedhista.
  • Kaar lagu bixiyay oo lacag la mid ah tan khasnadda: waxaa loo xisaabiyaa sida Kaar gacanta lagu bixiyay. Haddii kale (bixinta miiska adeegga, ama lacag kale) dalabku wuu u furnaanayaa adeegaha.
  • Wax walba waxay ku jiraan diiwaanka.
• Beljiyam: nidaamka khasnadda ee diiwaangashan (GKS, sanduuqa madow) iib kasta waa inuu isla markiiba maraa khasnadda iyo FDM-ta. Sidaas darteed habka degdegga suurtagal ma aha inuu la oggol yahay; marka hore weydii. App-ka kiosk-gu Beljiyam kuma shido mooyee xaqiijin dheeri ah kadib, khasnadduna waxay digniin ku bixisaa qaybta kiosk-ga.

Khasnadda dalabka kiosk-gu waa dalab caadi ah (qaadasho ama halkan, magaca Kiosk Albaabka) oo ku qoran magaca shaqaalaha Kiosk. Khasnaddu iyadaa samaysa; qofna kuma geli karo. Ha ka dhigin mid aan firfircoonayn, haddii kale kiosk-gu ma dalban karo. Dalabaadka kiosk-ga waxay ku jiraan warbixinnada, Rasiidyada iyo shaashadda wicitaanka. Dalab aan kiosk-ga lagu dhammaystirin (aan la dalban ama aan kaar lagu bixin) wuxuu iskiis u dhacaa 30 daqiiqo kadib.

Kaarka ku bixinta hab tijaabo (Dejinta → Lacag bixinta)? Markaas kioskigu dhab ahaan lacag ma qaado; waxtar u leh tijaabinta. Internet la'aan kaarka laguma bixin karo; kioskigu markaas wuxuu sheegaa in laga dalban karo miiska adeegga.

Cillad: haddii khasnadda la gaari waayo, app-ka kiosk-gu wuxuu muujiyaa "Si ku meel gaar ah ayuu xiran yahay" wuxuuna iskiis u sii socdaa. Haddii kiosk-gu ku shaqeeyo bogga maamulka oo internetku go'o, app-ku wuxuu u gudbi karaa khasnadda shabakadda gudaha (app-ka: maamulka → Kordhinta → Marka cillad jirto isticmaal shabakadda gudaha); kiosk-ga laftiisa ayaa bixiya cinwaankaas.

Damin: kioskigu wuxuu sheegaa inuu xiran yahay in yar. Kioskyada iyo dejintu way kaydsan yihiin. Diiwaanka waxaa ku jira shidid/damin, dejinta, kioskyada lagu daray iyo kuwa laga saaray, isku xidhka iyo dalabyada la joojiyay.

Looxa menu-ga dhijitaalka ah

Menu-ga iyo qiimayaasha oo ku yaal TV (ama shaashad kale oo browser leh), si toos ah kaashka uga yimid. Caadi ahaan waa dansan; ka shid Dejinta → Ganacsiga → Shaashadaha iyo isticmaalka → Looxa menu-ga dhijitaalka ah. Kadib TV-ga ku fur http://<kassaserver>:3000/menubord (ama badhanka Shaashad gaar ah / Tablet ama telefoon oo leh QR code). Gelid la'aan iyo isku xir la'aan.

• Koox alaab kasta, alaabta iyo qiimahooda, sida ay ugu kala horreeyaan kaashka. Adigu dooro kooxaha (iyo kala horreynta), 1 ilaa 4 tiir, mugdi ama iftiin, cinwaan gaar ah (madhan = magaca ganacsiga), sawirrada alaabta iyo xasaasiyadaha.
• Isla markiiba sax: looxu 10 ilbiriqsi kasta wuxuu codsadaa menu-ga (iyo isla markiiba marka wax isbeddelaan), sidaas darteed alaab dhammaatay (lagu xariiqay Waa dhammaaday, ama looxa laga saaray), kayd madhan, happy hour (qiimaha dallacaadda oo qiimaha caadiga ah la xariiqay, magaca iyo waqtiga dhammaadka korka) iyo qaybaha maalinta (kaliya waxa hadda la iibinayo) si toos ah ayay u saxan yihiin.
• Haddii wax walba aysan shaashadda ku wada filnayn, boggaggu way isbeddelaan (caadi ahaan 12 ilbiriqsi kasta, laga dejin karo 5 ilaa 120).

Shaqaalaha iyo PIN-ka

Dejinta → Shaqaalaha (kaliya maamulaha): ku dar shaqaale, beddel magaca, doorka iyo PIN-ka, oo ka dhig mid aan firfircoonayn.

• Doorarka: adeege (dalbasho, bixin, warbixinta X), maareeye (intaas waxaa dheer qiimo-dhimis, celin, xiritaanka maalinta, khaanadda lacagta iyo diiwaanka) iyo maamule (wax walba, oo ay ku jiraan dhammaan Dejinta). Taasi waa caadiga; waxa adeegaha iyo maareeyaha loo oggol yahay waa la beddeli karaa (eeg Ogolaanshaha door kasta).
• PIN 4 ilaa 8 tiro, oo u gaar ah shaqaalaha firfircoon dhexdooda. PIN-yada waxaa lagu kaydiyaa xog-ururinta iyagoo sir ah (hash) oo dib looma akhrin karo.
• Si dhab ah looma tirtiri karo (rasiidyada iyo diiwaanku waxay tilmaamaan shaqaalaha); aan firfircoonayn = mar dambe ma geli karo.
• Had iyo jeer waxaa haraya ugu yaraan hal maamule oo firfircoon.
• Door kale, PIN cusub ama aan firfircoonayn: fadhiyada socda ee shaqaalahaas isla markiiba waa la joojinayaa.
• Belgium: ikhtiyaari lambarka diiwaanka qaranka ee diiwaangelinta shaqaalaha.
• Luqadda: luqadda shaashadaha ee shaqaalahan (ama "Luqadda qalabka"). Gelitaanka ka dib kaashku isla markiiba wuxuu ku jiraa luqaddaas; shaqaaluhu sidoo kale wuu beddeli karaa calanka yar ee midigta hoose (eeg Luqadaha).
• Talo: beddel PIN-yada tijaabada ah 1111 iyo 2222 ka hor inta kaashku aanu shaqo bilaabin.

Ku gal kaar (ikhtiyaari)

Caadi ahaan dansan. Shidid: Dejinta → Shaqaalaha, calaamadee Ku gal kaar (NFC, RFID ama iButton). Loo baahan yahay: akhriye kaar oo USB ah oo u shaqeeya sida kiiboodh (kaararka NFC ama RFID, silsiladaha furayaasha, jijimada gacanta ama furayaasha iButton). Akhriyahan oo kale wuxuu "qoraa" lambarka kaarka oo riixaa Enter; looma baahna darawal ama xiriir.

• Ku xiridda: taabo shaqaalaha, kadib Ku xir kaar oo kaarka u qabo akhriyaha. Kaarku wuxuu leeyahay hal shaqaale. Ka saar kaarka haddii uu lumo.
• Galitaanka: shaashadda galitaanka kaarka u qabo akhriyaha. PIN-ku sidoo kale si caadi ah ayuu u shaqaynayaa.
• Galitaanka iyo ka bixitaanka shaqada (haddii uu shidan yahay): shaashadda galitaanka Gal / ka bax shaqada oo kaarka u qabo akhriyaha.
• Lambarka kaarka waxaa xogta lagu kaydiyaa oo keliya isagoo sir ah (hash), sida PIN-ka. Shaqaalaha aan firfircoonayn kuma geli karaan xitaa kaarkooda.
• Dansan: galitaan kaliya PIN-ka, sida had iyo jeer. Kaararka la xiray waa la hayaa.

Ogolaanshaha door kasta

Dejinta → Ogolaanshaha (kaliya maamulaha): door kasta calaamadi waxa adeegaha iyo maareeyaha loo oggol yahay. Caadi ahaan wax walba waa sida kor ku xusan (sidii kaashku had iyo jeer samayn jiray); sanduuq ka duwan waa midab leeyahay.

• Maamuluhu had iyo jeer wax walba wuu samayn karaa. Beddelidda shaqaalaha iyo ogolaanshaha had iyo jeer waxay u gaar tahay maamulaha (haddii kale qof ayaa naftiisa siin kara ogolaansho dheeraad ah).
• Badhamada iyo tabyada aan door loo oggolayn waa ku qarsan yihiin doorkaas; server-ka kaashku sidoo kale wuu hubiyaa. Haddii maareeye la siiyo tusaale Maamul alaabta, wuxuu arkaa badhanka Dejinta oo leh kaliya tabka Alaabta.
• Isbeddelladu isla markiiba waxay ka shaqeeyaan dhammaan kaashyada waxaana lagu qoraa diiwaanka. Ku celi caadiga wax walba wuxuu dib ugu celiyaa sidii ay ahaayeen.

Xogta ganacsiga

Dejinta → Ganacsiga (kaliya maamulaha): magaca, cinwaanka, koodka boostada, magaalada, telefoonka iyo lambarka canshuurta (btw) ee goobta. Kuwani waxay ku qoran yihiin xagga sare ee rasiid kasta iyo pro forma kasta. Qoraalka hoose ee rasiidka sidoo kale halkan ayaa lagu dejin karaa (saddarro badan waa la oggol yahay; madhan = qoraal ma jiro; caadi ahaan "Bedankt en tot ziens!"), hoostiisana luqadda rasiidka (caadi ahaan Af-Holandi; eeg Luqadaha). Tusaale rasiidka ah ayaa si toos ah isu beddela. Kaydinta ka dib rasiidka xiga isla markiiba wuxuu isticmaalaa xogta cusub. Waddanka iyo xogta canshuurta (GKS) si ula kac ah halkan looma beddeli karo. Belgium lambarka canshuurta (btw) waa qasab. Calaamadda Lacagta caddaanka ah ku soo koob 5 senti (caadi ahaan waa dansan) marka lacag caddaan ah la bixiyo wadarta waa la soo koobaa (€ 6,62 → € 6,60, € 6,63 → € 6,65); farqiga wuxuu rasiidka ku qoran yahay "Soo-koobid". Kaarku had iyo jeer waa senti sax ah.

Maamulka alaabta

U gal maamule ahaan oo dooro Dejinta → Alaabta.

• Ku dar, wax ka beddel (magaca, qiimaha, kooxda, heerka canshuurta (btw) ee goobta lagu cuno iyo qaadashada, magaca rasiidka, koodka, dhammaaday) oo tirtir kooxaha alaabta iyo alaabta. Kooxaha iyo alaabtuba midab u gaar ah ayay yeelan karaan; alaab midab leh waxay shaashadda dalabka ku helaysaa badhan midab leh (qoraalku si toos ah ayuu u noqdaa cad ama madow si loo akhriyo).
• Kala horreynta ku beddel adigoo koox ama alaab ka jiidaya ≡. Waxay ku shaqaysaa jiiraha iyo farta tablet-ka. Isla kala horreyntaas ayaa kadib ka muuqata shaashadda dalabka; shaashadaha kaashka ee furan isla markiiba way is-cusboonaysiiyaan.
• Tirtiriddu alaabta waxay ka saartaa kaashka, laakiin dalabyadii hore iyo diiwaanka canshuurtu weli way yaqaannaan alaabta. Koox waxaad tirtiri kartaa kaliya marka ay madhan tahay.
• Doorashooyinka: fur alaab ama koox alaab oo hoosta "Doorashooyinka" ku dar kooxo doorasho, sida "Habka karinta" (hal sax ah, qasab), "Suugo" (ugu badnaan hal) ama "Dheeraad" (dhowr, oo leh ugu yaraan iyo ugu badnaan; ugu badnaan madhan = xad la'aan). Doorasho kasta waxay leedahay magac iyo qiime dheeraad ah (wuxuu noqon karaa taban, tusaale -0,50). Kooxaha doorashada ee koox alaab waxay khuseeyaan dhammaan alaabta kooxdaas, oo lagu daray doorashooyinka alaabta u gaarka ah. Kala horreynta ku beddel ▲▼. Tirtiridda had iyo jeer waa suurtagal: dalabyada iyo rasiidyada jira waxay iyagu kaydiyaan doorashooyinka la doortay. Server-ku sidoo kale wuxuu hubiyaa doorashooyinka qasabka ah iyo ugu badnaanta.
• Sawir alaab kasta: eeg Sawirrada alaabta.
• Qiimaha kiilo kasta, lambarka PLU iyo culeyska weelka (kaliya marka miisaanku shidan yahay): eeg Dejinta miisaanka. Calaamad la'aan alaabtu sidii caadiga ahayd xabbad ahaan ayay ahaanaysaa.

Sawirrada alaabta

Alaab kasta sawir ayay yeelan kartaa.

• Gelinta sawirka: Dejinta → Alaabta → dooro alaabta → Dooro sawir (tablet ama telefoon waxaad sidoo kale isla markiiba u isticmaali kartaa kamaradda). Sawirka browser-ka ayaa lagu yareeyaa ilaa ugu badnaan 512 × 512 pixel (JPEG, inta badan 20–80 kB) isla markiibana waa la kaydiyaa; Sawir kale wuu beddelaa, Tirtir sawirka wuu ka saaraa. Liiska alaabta sawir yar ayaa ka horreeya magaca. Kaliya ogolaanshaha Maamul alaabta; jpg, png iyo webp, ugu badnaan 512 kB.
• Waxa la muujinayo maamuluhu wuxuu ka doortaa Dejinta → Ganacsiga → Sawirrada alaabta, mid walba si gooni ah oo caadi ahaan waa dansan:
  • Sawirka alaabta ee badhamada shaashadda dalabka: sawirka xagga sare ee badhanka alaabta, magaca iyo qiimuhu hoostiisa.
  • Sawirka alaabta oo la socda alaabta shaashadda macmiilka: sawir yar oo ka horreeya saddar kasta oo shaashadda macmiilka (shaashadda macmiilka laftigeedu waa inay shidan tahay). Alaabta aan sawir lahayn sidooda ayay ahaanayaan; haddii ay dansan tahay, wax walba sidii hore ayay u shaqeeyaan.

Iskaanka barkoodka

Iskaanka barkoodka ee qalabka lacag-qaadka waxaad ku iskaan gareysaa alaab, koodhadh qiimo-dhimis, kaararka macmiilka iyo kaararka hadiyadda. Ka shid Dejinta → Iskaanka (tab ku xiga daabacayaasha iyo miisaanka; caadi ahaan dansan). Calaamadee waxa iskaanku ku sameeyo shaashadda dalabka:

• Alaab rasiidka ku dar: alaabta koodhkaas leh (Dejinta → Alaabta, meesha Koodh; tusaale barkoodka EAN ee baakadda). Haddii ay leedahay doorashooyin, menu ama qiimo kiilo kasta, marka hore waxaa furma daaqadda doorashada ama miisaanka, sida marka la taabto. Tan waxaa sidoo kale sameeya Iskaanka shaashadda dalabka ee Daabac calaamadaha; taasi sidii caadiga ahayd ayay u shaqaynaysaa.
• Koodh qiimo-dhimis rasiidka ku dar (haddii koodhadhka qiimo-dhimista shidan yihiin).
• Kaarka macmiilka: macmiilka lambarka kaarkaas leh ayaa rasiidka la geliyaa (haddii kaarka macmiilka shidan yahay). Haddii aad iskaan gareyso koodh aan la aqoon oo ku jira rasiid macmiil leh, qalabku wuxuu weydiinayaa in uu yahay kaarkiisa cusub.
• Kaarka hadiyadda ama kaarka horay-u-bixinta: qalabku wuxuu tusaa haraaga (haddii kaararka hadiyadda ee haraaga leh shidan yihiin). Lacag-bixintu waxay ka dhacdaa Bixi lacagta → Kaarka hadiyadda; halkaas sidoo kale waad ku iskaan garayn kartaa kaarka.

Qalabka lacag-qaadka marka hore wuxuu eegaa alaabta, kadib kaararka macmiilka, kaararka hadiyadda iyo koodhadhka qiimo-dhimista. Iskaanku wuxuu ka shaqeeyaa shaashadda dalabka, marka aadan joogin meel wax lagu qoro. Meel wax lagu qoro, koodhku si caadi ah ayuu ugu dhacaa meeshaas.

Tijaabada iskaanka: Dejinta → Iskaanka, iskaan kasta waxaad ku arkaysaa koodhka iyo waxa qalabku ka fahmay, xitaa haddii iskaanku weli dansan yahay. Haddii uusan shaqayn:

• Iskaanka u dhig kiiboodh (USB-HID), oo Enter ka dambeeya koodhka. Iskaanada badankood horey sidaas ayay u yihiin.
• Iskaan ku dhex dhisan (tusaale qalabka Sunmi) waxaad dejinta iskaanka qalabka ugu dejisaa gelinta kiiboodhka.
• Calaamadaha miisaanka TS6X (miisaan iyo qiimo) miisaanka laftiisa ayaa qabta, xitaa marka iskaanku shidan yahay.

Kiosk-ka iskaanka si gooni ah ayaad u dejisaa (Dejinta → Ganacsiga → Kiosk); eeg Kiosk is-adeeg ah.

Daabacaadda calaamadaha

Calaamadaha alaabta oo leh magaca, qiimaha iyo barkood, daabace calaamadeed (Brother, Dymo, Zebra ...) oo ku rakiban kombiyuutarka ama tablet-ka. Ka shid Dejinta → Ganacsiga → Daabac calaamadaha (caadi ahaan dansan). Halkaas waxaad sidoo kale ka doortaa qaabka calaamadda (38 × 25, 57 × 32, 62 × 29 ama 100 × 50 mm) iyo in qiimaha iyo barkoodku ku qornaadaan. Daabac tusaale wuxuu daabacaa hal calaamad tijaabo ah.

• Dejinta → Alaabta → (alaab) → Calaamadaha: dooro tirada oo riix Daabac.
• Iibsasho → (dalab la helay) → Daabac calaamadaha: alaab kasta inta calaamadood ee la helay (unugyada dalabka la helay × tirada unug kasta; walxaha maya). Ugu badnaan 500 calaamadood hal mar.
• Kaashku wuxuu furaa daaqadda daabacaadda: halkaas ka dooro daabacaha calaamadaha iyo cabbirka warqadda duubka. Calaamad kasta waa hal bog.
• Barkoodku waa koodka alaabta (Dejinta → Alaabta): 8 ama 13 lambar oo leh lambar hubin sax ah = EAN (12 lambar: lambarka hubinta ayaa lagu darayaa), haddii kale Code 128 (xarfo, lambarro iyo calaamado qoraal, ilaa 30 xaraf). Kood la'aan barkood ma jiro.
• Iskaanka shaashadda dalabka (sanduuq, caadi ahaan dansan): iskaanka barkoodka oo u shaqeeya sida kiiboodh ayaa ku daraya alaabta koodkaas leh, iyadoo la raacayo doorashooyinka caadiga ah (ikhtiyaarro, miisaan, xasaasiyad). Lama wada isticmaali karo miisaanka TS6X, kaas oo leh calaamado u gaar ah oo miisaan iyo qiime leh.
• Xuquuq: Maaraynta alaabta ama Maaraynta kaydka.

Dejinta miisaanka (A&D, Aclas, Adam Equipment, Avery Berkel, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Bizerba, Brecknell, CAS, Datalogic, Dibal, DIGI, Dini Argeo, Excell Precision, Gram, Ishida, Kern & Sohn, Mettler Toledo, Minebea Intec, Ohaus, Precia Molen, Precisa, Rice Lake, Rongta, Sartorius, Star Micronics, T-Scale, UWE, Wedderburn, Wintec, Zebra)

Tab u gaar ah Dejinta → Miisaanka (ogolaanshaha Deji ganacsiga, lacag-bixinta iyo daabacayaasha, caadi ahaan kaliya maamulaha; tabku had iyo jeer wuu jiraa, xitaa haddii miisaanku weli dansan yahay). Caadi ahaan waa dansan: markaas kaashku sidii hore ayuu u shaqeeyaa. Tabka ma arkaysid?

Raadin toos ah. Haddii aan weli waxba la dejin, khasnaddu si toos ah ayay u raadisaa marka qaybtan la furo (badhanka Raadi mar kale ayuu sameeyaa):

• khasnadda (server-ka) laftiisu ma waxay ku shaqaysaa miisaan Aclas ah oo PC ama AI ah (TS6X, TS3X, TS5EX/NX/GX, iS6X, iS2X, iR6X, Ti6X, iL8X; summadda/moodeelka qalabka: Windows iyadoo la marayo WMI, Android iyadoo la marayo getprop, Linux iyadoo la marayo DMI) oo Aclas Scale Module ma jawaabaa? Markaa miisaankaas waxaa loo diyaariyaa Qalabkan dushiisa, sidoo kale miisaanka calaamadaha; Linux-ka (Scale Module ma jiro) miisaanka ku dhex jira ee dekedda gudaha ah ee la helay (/dev/ttyS...) sida "TS6X (ku dhex jira)", oo moodeelka lagu daray;
• ma jiraa OS6X ku xiran dekedda COM/USB? Deked kasta waxaa lagu tijaabiyaa 9600, 4800, 2400 iyo 19200 baud: marka hore in yar dhegeysi (joogto ah), kadib dirista W (Toledo), haddii kalena Dialog 06 (9600, 7 databits, pariteet kisi ah: weydiinta xaaladda).

La helay = foomka ayaa lagu geliyaa badhanka Shid oo isticmaal: hal taabasho wuuna shaqeeyaa. (Raadintu waxay W u dirtaa deked kasta oo COM ah oo bannaan; dekedda mashquulsan, tus. mashiinka kaarka, waa laga boodaa.)

Dhammaan miisaannada Aclas. Miisaan kasta waxaad u doorataa moodeelka; khasnaddu markaa way garanaysaa sida loo xiri karo. Waxaa jira laba nooc:

• Qalabkan dushiisa (hal mar la dejiyo): khasnaddu waxay ku shaqaysaa dusha miisaanka (miisaan PC ama AI ah). Windows ama Android wuxuu ku miisaamaa Aclas Scale Module, deked, xawaare ama borotokool la'aan; Linux (Scale Module ma jiro) wuxuu maraa dekedda gudaha ee miisaanka (badanaa /dev/ttyS0 ama /dev/ttyS1), oo leh deked, xawaare iyo borotokool. Khasnad kasta hal kaliya ayaa ka jira; Raadintu si toos ah ayay u heshaa. Miisaan PC ama AI ah (TS6X, iS6X ...) had iyo jeer waa Qalabkan dushiisa: liiska hal mar kaliya ayuu geli karaa, moodeellada kale ee PC/AI markaa lama dooran karo. TS6X meel kale oo goobta ku yaal wuu daabici karaa calaamado (markaa shid kaliya Iskaan calaamadaha).
• Ku xiran (dhowr mar keliya): miisaanku wuxuu server-ka khasnadda kaga xiran yahay fiilo (RS232/USB), Bluetooth ama shabakadda. Inta loo baahdo (ugu badnaan 8), mid walba magac u gaar ah.

Hal liis, laba calaamadood. Miisaannada oo dhan waxay ku jiraan hal liis. Miisaan kasta waxaad u shiddaa waxa uu qabto: Ku miisaam khasnadda (khasnaddu waxay weydiisaa miisaanka marka la dalbanayo) iyo/ama Iskaan calaamadaha (miisaanku wuxuu daabacaa calaamad barcode leh oo khasnaddu iskaan garayso, wuxuuna khasnadda ka helaa PLU-yada). Miisaan PC ama AI ah sida TS6X labadaba wuu qaban karaa; miisaanka calaamadaha LS kaliya calaamado. Calaamaduhu waxay ka iman karaan hal miisaan oo goob kasta ah.

A&D, Adam Equipment, Avery Berkel, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Bizerba, Brecknell, CAS, Datalogic, Dibal, DIGI, Dini Argeo, Excell Precision, Gram, Ishida, Kern & Sohn, Mettler Toledo, Minebea Intec, Ohaus, Precia Molen, Precisa, Rice Lake, Rongta, Sartorius, Star Micronics, T-Scale, UWE, Wedderburn, Wintec iyo Zebra. Summadahan waxaa ku jira moodeellada inta badan la isticmaalo ee la hubiyay sida kaashku ula hadlo (weli la tijaabin = borotokoolka si toos ah ugama qorna il; kaashku wuxuu doortaa midka ugu macquulsan). Dhammaan waa ku xiran (dhowr mar keliya), ama miisaan tikidh oo kaashku iskaan gareeyo tikidhkiisa:

• A&D EK-i iyo HV-WP: miisaanka u deji stream (EK-i: prt 0; warshadda waxay ka dejisaa badhanka PRINT) kaashkana Joogto oo leh 2400 baud iyo 7E1 (sidaas ayuu A&D warshadda uga yimaadaa). Fariintu waa ST,+00512.00 g (US = wuu dhaqaaqayaa, OL = aad u culus).
• Adam Equipment Swift: miisaanka u deji joogto u dir PC (8N1); kaashku markaas wuxuu ku jiraa Joogto.
• Avery Berkel FX110, FX120 iyo FX131: miisaanka ka dooro borotokoolka Mettler Toledo 82/7 kaashkana u deji Weydiin (Toledo) oo leh 7E1 (9600 baud). Dialog 06 sidoo kale wuu shaqeeyaa. FX125 (oo leh shaashad qiime) ma yaqaan Toledo: halkaas Dialog 06. Kaashku si toos ah ayuu tan u diyaariyaa marka aad doorato moodeelka.
• Avery Weigh-Tronix 7820, 7829 iyo ZP900 iyo Brecknell 6702U, 6710U iyo 6720U: NCI, borotokoolka Weigh-Tronix. Kaashku wuxuu diraa W (sida Toledo oo kale), miisaankuna wuxuu ku jawaabaa miisaanka ( 1.234KG) iyo sadar xaaladeed; kaas oo sheegaya inuu dhaqaaqayo, inuu aad u culus yahay ama aad u fudud yahay. Kaashku wuxuu ku jiraa Weydiin (Toledo) oo leh 7E1 (9600 baud). USB wuxuu u shaqeeyaa sida deked COM oo farsamo ah. ZP900-ka kaashka u deji dekedda 2 (NCI). 67xxU-ga miisaanka waxaa sidoo kale lagu dejin karaa 8213 (SCP03).
• Balanzas Marques BM1000P TOP: dekedda COM ka dooro borotokoolka B (METTLER) iyo 9600 baud, 7 databits, parity siman (even); kaashku markaas wuxuu ku jiraa Weydiin (Toledo) oo leh 7E1.
• Baxtran TW, VW, XTA iyo XTA-P (miisaannada qiimaha; VW iyo XTA-P oo leh tiir): menu-ga RS232 ee miisaanka ka dooro borotokoolka Toledo, 9600 baud iyo 7 databits oo leh parity siman (even) (7E1); kaashku markaas wuxuu ku jiraa Weydiin (Toledo) oo leh 7E1. Kaashku si toos ah ayuu tan u diyaariyaa marka aad doorato moodeelka. CONT (miisaanku isagu ayaa dira) sidoo kale wuu shaqeeyaa: markaas kaashka u deji Joogto oo leh xawaare iyo databits isku mid ah. Ku xir fiilada RS232 (9 biin) ama fiilo USB-ilaa-RS232.
• Bizerba CS 300: Checkout-Dialog 06 (tilmaanta Bizerba): kaashku wuxuu diraa qiimaha kiiladii, miisaanka la hubiyay (calibrated) ayaa xisaabiya lacagta. Haddii miisaanku weydiiyo koodhadh hubin, waxaad ka helaysaa Bizerba ama alaab-qeybiyaha.
• CAS PD-II, PDN, PDI iyo PDS-B (PDS-B tusaale ahaan LRE): miisaanka ka dooro ECR type 2 (Toledo) kaashkana u deji Weydiin (Toledo) oo leh 7E1 (9600 baud).
• Datalogic Magellan 9300i, 9400i iyo 9800i: Scale Interface Type-ka dekedda miisaanka gaarka ah u deji Mettler Toledo 8217 kaashkana Weydiin (Toledo) oo leh 7E1.
• Dibal KS-400, D-POS 400, G-325 iyo PI-100: miisaanka ka dooro borotokoolka Checkout_Dialog06 (borotokoolka 24) iyo 9600 baud, 7 databits, parity kisi (odd) (nooca halbeegga 5); kaashku markaas wuxuu ku jiraa Dialog 06. D-POS 400 sidoo kale waxaa lagu xiri karaa USB.
• DIGI DS-781: miisaanka u deji Type B / amarka caadiga ah (gudbinta xogta 00011); kaashku wuxuu diraa ENQ wuxuuna dib u helaa miisaanka saafiga ah, taarada, qiimaha kiiladii iyo lacagta.
• Dini Argeo DFW, DGT iyo 3590E: dekedda taxanaha (serial) u deji dirid joogto ah (9600 8N1); kaashku markaas wuxuu ku jiraa Joogto.
• Excell Precision TPE (iyo jiilka 4aad AM4, FD4-P, FDP4-P, GE4, GEP4): wax-soo-saarka RS232 u deji joogto (9600 8N1); kaashku markaas wuxuu ku jiraa Joogto.
• Gram XFOC RS, XFOC+ RS iyo ZFOC RS: borotokoolka Gram (9600 8N1). Kaashku wuxuu diraa ENQ, miisaanku wuxuu ku jawaabaa ACK, kaashku wuxuu diraa DC1 miisaankuna wuxuu diraa miisaanka: SOH STX S/U/F teken gewicht eenheid BCC ETX EOT (S = deggan, U = dhaqdhaqaaqaya, F = cilad; BCC = XOR laga bilaabo xaaladda ilaa halbeegga). Ku xir RS232 ama fiilada USB ee Gram.
• Kern & Sohn RPB iyo RFC: miisaanka ku deji Prot = DLG-06 (isku xirka kaashku waa ikhtiyaarka 965-419); kaashku markaas wuxuu ku jiraa Dialog 06. RFE, IFB iyo EOC: dirid joogto ah (8N1), kaashkana Joogto.
• Mettler Toledo Ariva/Viva: miisaanka u deji borotokoolka Toledo (8217), kaashkana Weydiin (Toledo) oo leh Databits / isku-dheelitirka (parity) = 7E1 (Mettler: 9600 baud, 7 databits, parity siman (even); Ariva-da sidoo kale waxaa lagu xiri karaa USB sida deked COM oo farsamo ah). Kaashku si toos ah ayuu tan u diyaariyaa marka aad doorato moodeelka.
• Minebea Intec Signum, Combics, Midrics iyo Puro iyo Sartorius Entris iyo Quintix: SBI oo leh daabacaad toos ah (9600 8N1); kaashku markaas wuxuu ku jiraa Joogto. Fariintu waa N + 0.512 kg; haddii aysan cabbir lahayn, weli wuu dhaqaaqayaa.
• Ohaus Aviator 7000: dejinta miisaanka (tallaabada 20) ka dooro borotokoolka Dialog 06; kaashku markaas wuxuu ku jiraa Dialog 06. RS232 ama USB, iyadoo ku xiran fiilada.
• Ohaus Valor 7000, Ranger 3000/4000/7000 iyo Defender 3000 (miisaamid aan qiime lahayn): miisaanka u deji Auto Print Continuous (9600 baud, 8N1) kaashkana Joogto. Miisaanku wuxuu diraa 0.512 kg G; ? ka dib miisaanka waxay ka dhigan tahay inuu weli dhaqaaqayo. Ranger 7000 sidoo kale waxaa lagu xiri karaa Ethernet (dekedda TCP 9761).
• Precia Molen DP400, DPOS CR iyo C 210 (miisaannada ganacsiga waxay Dibal leedahay tan iyo 2025): Dialog 06 (9600 7O1), sida Dibal oo kale. Haddii C 210-ga uusan shaqeyn, isku day Weydiin (Toledo) oo leh 7E1.
• Precisa XB, XT, LS iyo LX: habka daabacaadda u deji CONTINUOUS iyo 9600 8N1, sadarka taariikh, waqti iyo ID la'aan; kaashku markaas wuxuu ku jiraa Joogto. Haddii aysan cabbir lahayn, miisaanku weli wuu dhaqaaqayaa.
• Rice Lake BenchPro BP-S (Toledo 8213) iyo BP-R (NCI): kaashku wuxuu ku jiraa Weydiin (Toledo) oo leh 7E1.
• Star Micronics mG-T iyo mG-S8200: RS232 ama USB (deked COM oo farsamo ah, oo leh driver-ka Star) oo ku jira Joogto.
• UWE ASEP: RS232 oo u socda PC/kaash, kaashkana Joogto (weli la tijaabin).
• Wedderburn TSDS983, TSDS781T iyo TSDS782T waa miisaanno DIGI ah oo leh lambar u gaar ah: DIGI (Type B), sida DIGI DS-781 oo kale. Haddii taasi aysan shaqeyn, isku day Weydiin (Toledo) oo leh 7E1.
• Wintec ScalePOS ACS-S60E: kaashku wuxuu ku shaqeeyaa ScalePOS-ka laftiisa; miisaanka ku dhex jira wuxuu ku jiraa COM6 (Windows) ama COM4 (Android), 9600 8N1. Dooro Joogto; haddii uusan waxba dirin, Raadi ayaa helaya borotokoolka saxda ah.
• Zebra MP7000 iyo MP72: dekedda RS232-AUX warshadda waxay ka dejisaa SASI (9600 7E1, kaashku wuxuu diraa W): kaashka Weydiin (Toledo) oo leh 7E1.
• Miisaannada tikidhada ee summadahan (Avery Berkel, Balanzas Marques, Bizerba, CAS, Dibal, DIGI, Ishida, Mettler Toledo, Precia Molen, Rongta, T-Scale, Wedderburn) waa nidaamyo madax-bannaan oo leh fayl PLU u gaar ah. Miisaanka ka shid Iskaan tikidhada oo deji isla koodhka baarka ee miisaanka (EAN-13, ka bilaabmaya 20–29, PLU iyo miisaan ama qiime). PLU-yada waxaad gelinaysaa miisaanka laftiisa ama software-ka summadda; U dir TS6X iyo Soo deji faylka PLU waxay jiraan oo keliya Aclas.

Isla liiskan wuxuu ku jiraa kaashka hoostiisa Dejinta → Miisaan → Dhammaan miisaannada (ACLAS_MODELLEN ee packages/shared/src/weegschaal.ts, oo leh summadda moodeel kasta).

Wax yar oo keliya buuxi: marka aad doorato moodeel, kaashku wuxuu diyaariyaa inta kale sida summaddu warshadda ka dejiso: isku xirka Deked COM / USB dekedda ugu horreysa ee banaan, 9600 baud (A&D: 2400) iyo borotokoolka summadda (Toledo: Aclas oo leh 8N1, iyo kuwa leh 7E1 Avery Berkel FX, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Brecknell, CAS, Datalogic, Mettler Toledo, Rice Lake iyo Zebra; Dialog 06: Avery Berkel FX125, Bizerba, Dibal, Kern & Sohn RPB/RFC, Ohaus Aviator iyo Precia Molen; DIGI Type B: DIGI iyo Wedderburn; Gram: Gram; Joogto: A&D, Adam Equipment, Dini Argeo, Excell Precision, Kern & Sohn-ka kale, Minebea Intec, Ohaus-ka kale, Precisa, Sartorius, Star Micronics, UWE iyo Wintec), iyo magac (tusaale OS6X, OS6X 2). Miisaan PC ama AI wuxuu noqdaa Qalabkan (tusaale TS6X (ingebouwd); Linux-ka dekedda gudaha /dev/ttyS0). Haddii wax khaldan yihiin, Raadi ayaa helaya dekedda, xawaaraha iyo borotokoolka saxda ah.

Qalabkan dushiisa (Aclas Scale Module): miisaanku wuxuu muujiyaa miisaanka sharci ahaan la cabbiray; khasnaddu waxay dirtaa qiimaha kiilada iyo miisaanka weelka (horay loo dejiyay) waxayna qaadataa qaddarka uu miisaanku xisaabiyo, sida Dialog 06.

• Android: app-ka Aclas ee AclasScaleDriver (com.aclas.aclasscaledriver) badanaa horay ayuu miisaanka ugu jiraa; haddii kale, ku rakib aclas-android/AclasScaleDriver.apk. App-ka HorecaPOS si toos ah ayuu ula hadlaa adeegga app-kaas, markaa looma baahna maktabad dheeri ah.
• Linux: Aclas ma laha Scale Module Linux ah. Kaliya dooro moodeelka (tus. TS6X): xiriirku markaa wuxuu noqdaa Qalabkan dushiisa (dekedda gudaha) ee /dev/ttyS0, 9600 baud, Toledo. Miisaanka ku dhex jira badanaa wuxuu ku jiraa /dev/ttyS0 ama /dev/ttyS1; Raadintu way tijaabisaa waxayna gelisaa dekedda, xawaaraha iyo borotokoolka saxda ah. Halkan sidoo kale hal mar kaliya ayuu geli karaa.

Software-ka Aclas wuxuu la socdaa kaashka: Scale Module-ka Windows (aclas-module), AclasScaleDriver-ka Android (aclas-android) iyo Aclas Sync SDK-ga Windows iyo Linux (aclas-sdk). Aclas ayaa noo oggolaatay inaan la qaybinno. Rakibayaasha Windows iyo Linux ayaa ku jira; wax gooni ah looma soo dejiyo lamana rakibo.

Bluetooth (tus. OS6X): marka hore isku xir miisaanka. Windows wuxuu ka dhigaa deked COM ah (Dejinta Bluetooth → Ikhtiyaarro Bluetooth oo dheeri ah → Dekedaha COM), Linux /dev/rfcomm0: geli dekeddaas. App-ka Android waxaad ku gelisaa cinwaanka Bluetooth (00:11:22:AA:BB:CC); app-ku hal mar ayuu oggolaansho u weydiistaa Qalabka u dhow wuxuuna ku xirmaa Bluetooth SPP.

Miisaannada AI (garashada badeecadaha): kamaraddu waxay badeecadda ku garataa barnaamijka Aclas ee miisaanka ku jira. Miisaamiddu waxay maraysaa Scale Module (qalabkan dushiisa) ama dekedda RS232; miisaannada calaamadaha AI garashada kadib waxay daabacaan calaamad barcode leh oo khasnaddu iskaan garayso (sida TS6X).

Aclas AI Recognition Plugin (miisaan AI ah oo khasnaddu ku shaqayso, tusaale iS6X oo Windows leh): plugin-ka Aclas wuxuu garanayaa badeecadda wuxuuna khasnadda ku qoraa barcode-keeda, sida iskaanar oo kale (Enter kadib); shaashadda dalabka ayaa badeecadda iyo miisaankeeda ku darta dalabka. Sidan ayaad u dejinaysaa:

• Miisaanka ka shid Iskaan calaamadaha adigoo isticmaalaya isla barcode-ka ku jira plugin-ka. Talo: wuxuu ku bilaabmaa 27, PLU 5 lambar, miisaan (Aclas nooca 17): markaa khasnaddu iyadu ayay ku xisaabisaa qiimaha kiilo kasta. Qiimaha (nooca 12, wuxuu ku bilaabmaa 22) sidoo kale waa suurtagal.
• Miisaankaas ka dami Ku miisaam khasnadda: plugin-ka iyo Scale Module isku mar ma gaari karaan miisaanka. Miisaanku wuxuu ka yimaadaa barcode-ka. Haddii plugin-ku ka jawaabo Raadi, khasnaddu waxay soo jeedinaysaa dejintan mana bilaabayso Scale Module. Koodh hawlgelin la'aan plugin-ku wuu miisaamaa oo xisaabiyaa qaddarka, laakiin ma garto badeecadaha.
• Plugin-ka laftiisa: barcode-ka ee Scale and Barcode Format Settings → Default Barcode Format (nooca 17), iyo dejinta daaqadda meesha uu plugin-ku gujiyo oo uu koodhka ku qoro. Taas u dooro meel bannaan oo shaashadda dalabka ah, ha ahaato badhan dushiis. Badeecadaha cusub ganacsigu laftiisa ayuu plugin-ka ku baraa miisaanka (tababarka AI).
• Sii badeecadaha la miisaamo lambar PLU oo PLU-yada u dir miisaanka (U dir TS6X ama faylka PLU); plugin-ku wuxuu ku garanayaa lambarka PLU.
• Khasnaddu waxay u oggolaataa plugin-ka inuu garto oo keliya inta shaashadda dalabka ay ku furan tahay miisaanka laftiisa (POST /aiplugin/resume, marka la xiro /aiplugin/suspend, dekedda 5003 ee miisaanka; markii ugu horreysay sidoo kale EmployeeMode: shaashadda macmiilka ee miisaanku ma muujiso badeecado). Khasnadaha iyo tablet-yada kale iyo bogga maamulka waxba kama dhacaan.
• Plugin-ku had iyo jeer wuxuu ku bilaabmaa Resume mana sheegi karo xaaladdiisa. Sidaas darteed shaashadda dalabku 30-dii ilbiriqsiba mar kale ayay soo dirtaa resume; haddii taasi timaado waayo (shaashaddu xiran tahay, plugin-ka ama miisaanka dib ayaa loo bilaabay), khasnaddu daqiiqad gudaheed ayay plugin-ka dhigtaa Suspend halkaasna ku haysaa.
• Plugin-ku wuxuu u baahan yahay koodh hawlgelin oo Aclas ah miisaan kasta (ku xiran lambarka taxanaha). Hadda wuxuu ku shaqeeyaa Windows; nooca Android ee Aclas ayaa soo socda (khasnaddu halkaas isla wax la mid ah ayay ku samaysaa).

Aclas OS6X (miisaanka POS ee khasnadda, RS232/USB; miisaannada kale ee ku xiran sidan oo kale ayay u shaqeeyaan):

• Hal miisaan ama ka badan (ugu badnaan 8), mid walba leh magac (tus. Miiska hore, Baarka) iyo xiriir u gaar ah: Dekedda COM / USB (COM3 Windows, /dev/ttyUSB0 Linux/Android) oo leh xawaaraha, ama shabakad iyadoo la marayo beddele taxane-ilaa-shabakad (cinwaan IP iyo dekedda TCP, tus. 4001).
• Borotokool: Weydiin (Toledo) = kaashku wuxuu diraa W miisaankuna wuxuu ku jawaabaa miisaanka (Toledo 8217, sida OS6X badanaa loo dejiyo; sidoo kale fariimaha xaaladda: aan degganayn/culays xad-dhaaf/ka hooseeya eber) ama Joogto = miisaanku isagaa had iyo jeer soo dira miisaanka (ST,GS, 0.512kg, US = aan degganayn) ama Dialog 06 (la hubiyay), eeg hoos, ama DIGI (Type B) = kaashku wuxuu diraa ENQ DIGI-guna wuxuu ku jawaabaa xaaladda, miisaanka saafiga ah, taarada, qiimaha kiiladii iyo lacagta (37 xaraf: <status> <toestand> CR 0<netto> CR 4<tarra> CR U<kiloprijs> CR T<bedrag> CR LF; bit-ka xaaladda 1 = deggan, bit 2 = ka hooseeya eber, bit 3 = aad u culus, bit 4 = aad u fudud), ama Gram = kaashku wuxuu diraa ENQ, wuxuu sugaa ACK, wuxuu diraa DC1 wuxuuna akhriyaa SOH STX <S/U/F> <teken> <gewicht> <eenheid> <BCC> ETX EOT. Miisaanka ku deji isla borotokoolka iyo isla xawaaraha. Databits / isku-dheelitirka (parity): 8N1 (Aclas, Adam Equipment, DIGI, Dini Argeo, Excell Precision, Gram, Kern & Sohn, Minebea Intec, Ohaus, Precisa, Sartorius, Star Micronics, UWE, Wedderburn, Wintec) ama 7E1 (A&D, Avery Berkel, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Brecknell, CAS, Datalogic, Mettler Toledo 8217, Rice Lake, Zebra); Dialog 06 had iyo jeer waa 7O1. Weydiin sidoo kale wuxuu akhriyaa NCI (Avery Weigh-Tronix, Brecknell, Rice Lake BP-R): W miisaanku wuxuu ugu jawaabaa LF 1.234KG CR LF S00 CR ETX; sadarka xaaladda (S + 2 ama 3 bytes) wuxuu sheegaa inuu dhaqaaqayo (byte 1 bit 0), inuu aad u fudud yahay (byte 2 bit 0) ama aad u culus yahay (byte 2 bit 1); ^^^^^ = aad u culus, _____ = aad u fudud.
• Dialog 06 (Checkout-Dialog 06, borotokoolka Yurub ee miisaan sharci ahaan la cabbiray oo khasnad ku xiran): khasnaddu waxay miisaanka u dirtaa qiimaha kiilada (iyo miisaanka weelka ee badeecadda); miisaanku wuu miisaamaa, qaddarka laftiisa ayuu xisaabiyaa wuxuuna shaashaddiisa (sharci ahaan la cabbiray) ku muujiyaa qiimaha kiilada, miisaanka iyo qaddarka. Khasnaddu waxay qaadataa miisaanka iyo qaddarka; daaqadda miisaamidda waxaa ku qoran "waxaa xisaabiyay miisaanka". Had iyo jeer 9600 baud, 7 databits, pariteet kisi ah, 1 stopbit (xawaaraha dejinta markaa ma xisaabsamo). Socodka: EOT STX 01 ESC <kiloprijs 6> ESC ETX (miisaanka weelka la socda: diiwaanka 03 oo leh 4 lambar oo garaam ah) → ACK; ENQ → STX 02 ESC 3 ESC <gram 5> ESC <kiloprijs 6> ESC <bedrag 6> ETX; NAK → EOT STX 08 ETX → STX 09 ESC <code> ETX (22 = weli diyaar ma aha, markaa 100 ms kadib mar kale; 20 = wuu dhaqdhaqaaqayaa; 21 = marka hore kor u qaad; 30/31 = aad u fudud; 32 = aad u culus; 11 = qiimaha ma saxna). Koodhadhka hubinta: miisaanno badan oo Dialog 06 ah mar mar (tus. 30-kii miisaamidba) waxay weydiistaan koodhadhka hubinta ee barnaamijka khasnadda (diiwaanka 11 → diiwaanka 10). Koodhadhkaas iyo sida loo xisaabiyo, soo-saaraha miisaanku wuxuu siiyaa kaliya alaab-qeybiyaha khasnadda. Ku geli Koodhadhka hubinta (lammaanayaal 4 xaraf oo hexadecimal ah, tus. 74AE 1B2C); khasnaddu way dirtaa marka miisaanku codsado. Haddii miisaanku ku xisaabiyo tiro isbeddesha (Z) oo koodhadh go'an aysan saxnayn, khasnaddu way sheegtaa; markaa ka codso alaab-qeybiyaha inuu miisaanka dejiyo hubintan la'aanteed, ama isticmaal Toledo.
• Miisaannadu waxay ku xiran yihiin kombiyuutarka ama qalabka uu ku shaqeeyo server-ka khasnaddu; dhammaan khasnadaha iyo tablet-yadu waxay ku miisaamaan server-ka khasnadda waxayna daaqadda miisaamidda ku doortaan miisaanka ay isticmaalayaan. Tijaabi hal mar ayuu miisaamaa.
• Shabakaddu meel kasta way ka shaqaysaa.
• Miisaanka sidoo kale gacanta ku qor: shidan = xitaa marka miisaan jiro miisaanka waa la qori karaa; OS6X la'aan had iyo jeer waa suurtagal.

Iskaan calaamadaha (calaamadda miisaanka: Aclas TS6X, miisaan kale oo PC ama AI ah, taxanaha LS ama LH15X; miisaan + daabacaha calaamadaha, mid goob kasta):

• Cinwaanka IP: waxaa loo baahan yahay kaliya U dir TS6X. Miisaamidda iyo iskaanka calaamaduhu la'aantiis way shaqeeyaan. Haddii khasnaddu ku shaqayso TS6X-ka laftiisa, madhan u daa: khasnaddu markaa nafteeda ayay u dirtaa (127.0.0.1). Haddii isla miisaanku sidoo kale khasnadda ku miisaamo, labada calaamadoodba waxay saaran yihiin isla miisaanka (Raadintu sidaas ayay u diyaarisaa).
• Iskaan calaamadaha: iskaan calaamadaha shaashadda dalabka. Deji sida barcode-ku u eg yahay, sida TS6X-ka oo kale: wuxuu ku bilaabmaa (20–29, caadi ahaan 28), tirada lambarrada PLU-ga (4, 5 ama 6) kadibna miisaanka oo garaam ah ama qiimaha oo senti ah, iyo lambarka hubinta (EAN-13). Dejinta hoosteeda waxaa ku yaal tusaale.
• Lambarrada PLU: Dejinta → Badeecadaha, badeecad la miisaami karo waxay helaysaa qiimaha kiilada, haddii loo baahdo miisaanka weelka iyo lambar PLU ah (gaar ah). Lambarka PLU waxaad ka doorataa liis (PLU ma leh, ka xiga ee bannaan, Lambar kale…); marka aad calaamadiso Qiimaha kiilada lambarka xiga ee bannaan horey ayuu u jiraa. Waxaa loo baahan yahay kaliya calaamadaha iyo PLU-yada TS6X: TS6X la'aan wuxuu ahaan karaa PLU ma leh.
• Si toos ah u dirista waxay ka shaqeysaa Windows iyo Linux; Android iyo macOS isticmaal faylka PLU. Rakibidda ugu horreysa, magacyada goobaha faylka PLU iyo koodhadhka aclas-plu.ps1 ka hubi buugga SDK ee miisaanka la keenay (hal meel oo la beddelo: ACLAS_PLU_KOLOMMEN ee packages/shared/src/weegschaal.ts).

Bogga maamulka: warbixinta loo diro bogga waxay leedahay shaqada Miisaan (A&D, Aclas, Adam Equipment, Avery Berkel, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Bizerba, Brecknell, CAS, Datalogic, Dibal, DIGI, Dini Argeo, Excell Precision, Gram, Ishida, Kern & Sohn, Mettler Toledo, Minebea Intec, Ohaus, Precia Molen, Precisa, Rice Lake, Rongta, Sartorius, Star Micronics, T-Scale, UWE, Wedderburn, Wintec, Zebra) oo leh shid/dami iyo miisaannada moodeel kasta (tusaale TS6X (op dit apparaat), 2x OS6X, PS1CX, Ariva-S, DS-781, LS6RX, 5 producten per kilo); ma jiraan cinwaanno IP, dekedo COM ama cinwaanno Bluetooth.

Sharciga cabbirka: miisaanka aad wax ku iibiso waa inuu sharci ahaan la cabbiray (heerka III, sida OS6X). Toledo/joogto khasnaddu waxay ku xisaabisaa miisaanka uu miisaanku bixiyo; Dialog 06 miisaanka la cabbiray laftiisa ayaa xisaabiya qiimaha.

Koodh: packages/shared/src/weegschaal.ts (borotokoollada, calaamadaha, faylka PLU), apps/pos-server/src/lib/weegschaal.ts iyo routes/weegschaal.ts; shaashadaha WeegschaalInstellingen.tsx iyo WeegDialoog.tsx.

Thuisbezorgd.nl / Takeaway.com

Dalabaadka Thuisbezorgd.nl si toos ah ayay khasnadda u soo galaan, dhexdhexaadiye la'aan (Deliverect, HubRise iwm. ma jiraan): Just Eat Takeaway JET Connect wuxuu la hadlaa bogga maamulka ee Pin Voordeel, khasnadduna halkaas ayay ka soo qaadataa fariimaheeda.

Beljamka madalku wuxuu ku magacaaban yahay Takeaway.com: isla shirkadda (Just Eat Takeaway) iyo isla isku-xirka. Ganacsi Beljam ah, shaashadaha, ogeysiisyada, warqadda jikada iyo bogga maamulka meel kasta waxaa ku qoran Takeaway.com halkii Thuisbezorgd.nl. Hoos Thuisbezorgd wuxuu u taagan yahay labadaba.

Maxaa bogga loo marayaa? Khasnaddu waxay u baahan tahay kaliya PORTAAL_URL iyo PORTAAL_SLEUTEL (eeg Bogga maamulka) waxayna samaysaa kaliya codsiyo dibadda u baxa.

Dejin (Dejinta → Madallada keenista → Thuisbezorgd.nl / Takeaway.com, ogolaanshaha Deji ganacsiga, lacag-bixinta iyo daabacayaasha; hore tan waxay ku jirtay Dejinta → Ganacsiga):

1. Shid Isticmaal Thuisbezorgd (isla markiiba ayuu dhaqan galaa, Kaydinta ka madax-bannaan).
2. Iska diiwaangeli Thuisbezorgd. Ganacsigu kadib wuxuu Thuisbezorgd (Partner Hub ama maamulaha akoonka) ku doortaa OptimumPOS / Pin Voordeel khasnad ahaan. JET markaa wuxuu bilaabaa kalfadhi onboarding ah; bogga ayaa raadiya khasnadda la diiwaangeliyay (koodhka boostada iyo magaca, haddii kale Pin Voordeel ayaa kalfadhiga gacanta ku xira bogga), wuxuu diraa qaabeynta, wuxuuna khasnadda weydiistaa menu-ga. Kadib isku-xirku wuu shaqo galaa.
3. Calaamadi badeecadaha lagu dalban karo Thuisbezorgd (koox kasta ama gooni gooni), haddii loo baahdo sharaxaad Thuisbezorgd loogu talagalay. Menu-ga (qiimaha, doorashooyinka sida modifiers, xasaasiyadaha, VAT) si toos ah ayuu u raacaa; PLU = id-ga badeecadda/doorashada. Isbeddel kasta oo kataloogga kadib, khasnaddu waxay 30 ilbiriqsi gudahood cusboonaysiisaa menu-ga; kaliya "dhammaaday"/"mar kale la heli karo" ayaa maraya API-ga helitaanka.
4. Saacadaha furitaanka Thuisbezorgd: gaar u ah keenista iyo qaadashada (tusaale 16:00-22:00, dhowr qaybood oo hakad lagu kala saaray). Waxaa lagu kaydiyaa badhanka Kaydi saacadaha furitaanka ee hoostiisa waxayna Thuisbezorgd ugu tagaan sidii service times marka isku xirku diyaar noqdo.
5. Si ku-meel-gaar ah u xiran / Mar kale furan (NL/BE ugu dambayn subaxda xigta 07:00 mar kale waa furan yahay).

Dalabaadka. Dalab wuxuu noqdaa dalab caadi ah oo aan miis lahayn (bezorgen ama afhalen, magaca kooxda TB <ordernummer>) oo leh qiimaha uu macmiilku bixiyay, iyo kharashka keenista/adeegga oo saf gooni ah iyo qiimo-dhimista Thuisbezorgd oo saf qiimo-dhimis ah; haddii wadartu weli aanay saxnayn, markaa saf "Farqiga Thuisbezorgd" ah. Warqadda jikada isla markiiba waxay u tagtaa jikada/baarka (waa la dami karaa). Khasnaddu ilbiriqsiyo gudahood ayay u xaqiijisaa bogga, kaas oo u sheega JET; haddii taasi aanay 3 daqiiqo gudahood ku guuleysan ama khasnaddu ay offline tahay, JET wuxuu helaa "fashilmay" ganacsiguna wuxuu dib ugu noqdaa Orderpad-ka.

Badhanka Thuisbezorgd ee baarka sare (oo leh tirada dalabaadka socda): liiska, macmiilka iyo cinwaanka, waqtiga diyaarinta/keenista iyo jadwalka (track & trace): la helay, keeniyaha oo u socda goobta, keeniyaha oo goobta jooga, oo u socda macmiilka, la keenay (JET ka yimid), iyo tallaabooyin gaar ah (diyaarin, diyaar, jidka ku jira/la keenay marka adiga keenayso, la qaaday). JET Connect khasnadda uma bixiyo khariidad toos ah oo keeniyaha ah; taas macmiilka ayaa ku arka app-ka Thuisbezorgd. Dalab cusub, joojin iyo "keeniyaha oo goobta jooga" waxay bixiyaan baar oranji ah iyo cod. Dhammaystir (online lagu bixiyay) wuxuu ku xisaabiyaa habka lacag-bixinta online; haddii macmiilku albaabka ku bixiyo, si caadi ah u bixi lacagta. Joojinta Thuisbezorgd waxay buriysaa dalabka waxayna daabacdaa warqad jiko oo ah "LA JOOJIYAY".

Koodh: apps/pos-server/src/lib/thuisbezorgd.ts, routes/thuisbezorgd.ts; shaashadaha ThuisbezorgdInstellingen.tsx iyo Thuisbezorgd.tsx. Dhinaca bogga: horecapos-portaal/src/thuisbezorgd.mjs (eeg README-ga bogga).

Tirinta bogga maamulka. Tirada dalabaadka Thuisbezorgd maalin kasta waxay raacdaa warbixinta bogga maamulka (verkoopTelling ee lib/portaal.ts): kuwa soo galay oo aan la joojin, maalinta ay soo galeen. Dalab Thuisbezorgd oo khasnadda lagu bixiyo (sidoo kale Dhammaystir (online lagu bixiyay)) halkaas mar kale laguma tiriyo qaadashada/keenista. Xogta Thuisbezorgd waxay ku jirtaa database-ka khasnadda, sidaas darteed si caadi ah ayay ugu jirtaa nuqul-kaydyada khasnadda.

Dukaan online iyo dalbasho online

Ganacsi kastaa wuxuu heli karaa dukaan online u gaar ah: bog dalbasho (iyo app) oo leh astaanta ganacsiga, loogu talagalay qaadasho, keenis, miiska ka dalbasho koodh QR ah iyo ballansasho, oo leh lacag bixin online (MultiSafepay ama Buckaroo) ama bixin marka la qaadanayo/la keenayo. Dukaanka online-ku waa mashruuc gooni ah, horecapos-webshop (Node.js, eeg README-ga halkaas), wuxuuna ku shaqeeyaa isla server-ka portalka maamulka.

Shidid iyo habayn waxaa lagu sameeyaa maamulka dukaanka online-ka: badhanka Maamul dukaanka online ee portalka macmiilka (milkiilaha) ama rakibaadda ku jirta portalka maamulka (Pin Voordeel). Halkaas waxaa ku jira shid/dami, cinwaanka webka (<zaak>.<webshopdomein> ama domain u gaar ah), astaanta (midabada, logo, sawirka madaxa, farta), saacadaha furitaanka iyo xilliyada qaadashada iyo keenista, aagga keenista (koodhadhka boostada, fogaan ama aag khariidadda ku yaal, oo leh kharash iyo ugu yaraan), lacag bixinta, koodhadhka qiimo dhimista, qoraallada, luqadaha, koodhadhka QR ee miisaska, ballansashada iyo app-ka (waxaa loo rakibi karaa PWA; app Android ah oo loo marayo Trusted Web Activity), iyo ogeysiisyada push (ikhtiyaari, si caadi ah waa dansan yihiin): martidu waxay bogga dalabkeeda ka shidaa ogeysiis, waxayna heshaa ogeysiis push marka dalabku diyaar yahay ama waddada ku jiro; qofkii doonaya wuxuu sidoo kale mararka qaarkood helaa dalacsiin, taas oo meheraddu ka dirto maamulka dukaanka online-ka (tabka Ogeysiisyada push). Wuxuu ka shaqeeyaa Android iyo kombiyuutarada (Chrome, Edge, Firefox, Samsung Internet), app-ka Android, iyo iPhone iyo iPad (iOS 16.4 ama ka cusub) marka martidu dukaanka online-ka ku darto shaashadda hore. Wax SMS ama iimayl ah lama diro, magac ama lambarna lama kaydiyo. Faahfaahinta waxay ku jirtaa README-ga dukaanka online-ka.

Menu. Kaashku si toos ah ayuu menu-ga u diraa: dhammaan alaabta firfircoon (aan kiilo lagu iibin), koox alaab kasta, oo leh qiimo, doorashooyin, xasaasiyado, dhammaaday iyo sawirka alaabta, iyo weliba miisaska iyo xogta ganacsiga, iyo kanaalada suuq-geynta ee shidan (calaamadda "dalabyo gaar ah helid" marka lacagta la bixinayo, eeg Suuq-geynta SMS iyo iimaylka). Taasi waxay dhacdaa marka la bilaabo, marka dukaanka online-ku shidmo, 30 ilbiriqsi gudahood isbeddel kasta oo kataloogga kadib iyo dhowr ilbiriqsi gudahood isbeddel kasta oo Dejinta → Ganacsiga kadib, sida suuq-geynta ama kaarka macmiilka (ama Hadda dir menu-ga). Alaab waxaa dukaanka online-ka laga saari karaa maamulka dukaanka online-ka (qari), ama database-ka adoo isticmaalaya artikel.webshop = false.

Dalabyada. Qaadasho iyo keenis waxay noqdaan dalab caadi ah oo miis la'aan ah (magaca kooxda WEB <bestelnummer>) oo leh qiimayaashii martidu aragtay, oo lagu daray kharashka keenista iyo kharashka macaamilka oo khad gooni ah iyo koodh qiimo dhimis oo khad qiimo dhimis ah; haddii wadartu weli aanay is waafaqin, waxaa la raaciyaa khad "Farqiga dukaanka online". Baqshiishka martida dakhli ahaan looma xisaabiyo: wuxuu ku yimaadaa Dhammaystir (online lagu bixiyay) baqshiish ahaan lacag bixinta dhexdeeda. Miiska ka dalbasho (koodh QR) waxay ku biirtaa xisaabta furan ee miiskaas (online lagu bixiyay: koox gooni ah oo miiskaas ah). Warqadda jikada isla markiiba waxay u socotaa jikada/baarka (waa laga dami karaa daaqadda Dukaan online). Kaashku ilbiriqsiyo gudahood ayuu ku xaqiijiyaa lambarka rasiidka; martidu markaas waxay heshaa "la helay" iyo iimayl. Haddii kaashku offline yahay, dukaanka online-ku dalab ma aqbalo (martidu isla markiiba way aragtaa) wuxuuna iimayl u diraa ganacsiga haddii dalab muddo dheer sugo. Ballamaha dukaanka online-ka waxay yimaadaan Ballamaha (keliya haddii ballansashadu kaashka ka shidan tahay). Haddii xad xilli kasta jiro (Keenis iyo xilliyo), dalabyada dukaanka online-ka ee waqti ku leh xilligaas waa la xisaabiyaa.

Beljamka (sanduuqa madow). Dalabka dukaanka online-ka isla markiiba wuxuu sanduuqa madow u aadaa dalab ahaan (signOrder), ka hor warqadda jikada, sida Dalbo ee kashiirka. Haddii taasi aysan suurtogal noqon, ma soo galo kashiirka oo dukaanka online-ka ayaa mar dambe dib u diraya. Waxa aan weli lagu tijaabin sanduuqa madow waa ka dansan yihiin menu-ga dukaanka online-ka (kaararka hadiyadda, koodhadhka qiimo-dhimista, deyn, qolka, menu-yada, doorashooyin qiime dheeraad ah leh, happy hour iyo baqshiish) waana la diidaa haddii dukaan online ah oo duug ah uu weli soo diro. Dhammee wuxuu hubiyaa baqshiishka, deynta iyo qolka sida kashiirka.

Qolka ku qor (xiriirka hoteelka, Dejinta → Hoteel → Is-adeeg → Dukaanka online-ka): menu-gu wuxuu helaa kamer: { maxBedrag }; dukaanka online-ku wuxuu diraa betaling.wijze = "kamer" oo wata kamer iyo achternaam. Kashiirku wuxuu martida ka hubiyaa barnaamijka hoteelka (ma aha miiska, ma aha kaarka hadiyadda) oo wuxuu la kaydiyaa dalabka; Dhammee (qolka ku qor) wuxuu lacagta ku xisaabiyaa qolka oo rasiidka wuxuu ku diiwaangeliyaa biilka hoteelka. Qaansheeg isku-geyn ah ee deynta: rasiidku markaas wuxuu u furan yahay shay ahaan.

Badhanka Dukaan online ee baarka sare (oo leh tirada dalabyada socda): liis, macmiil iyo cinwaan, waqtiga la rabo ama "sida ugu dhakhsaha badan", habka lacag bixinta iyo jadwalka waqtiga. Tallaabooyinka Waa la diyaarinayaa, Diyaar iyo Jidka ku jira martidu si toos ah ayay ugu aragtaa dukaanka online-ka (iyo iimayl, haddii ganacsigu rabo). Lagu xisaabiyay kaashka = La dhammeeyay; Jooji wuxuu baabi'iyaa oo keliya khadadka dalabkaas dukaanka online-ka, wuxuu daabacaa warqad jikada "LA JOOJIYAY", dalab online lagu bixiyayna dukaanka online-ka ayaa lacagta celiya. Yimid, ma iman (no-show) ama la joojiyay ee ballan sidoo kale waxay dib ugu noqotaa dukaanka online-ka. Dalab ama ballan cusub waxay keentaa baar oranji ah iyo cod.

Koodh: apps/pos-server/src/lib/webshop.ts, routes/webshop.ts; shaashadda Webshop.tsx. Dhinaca portalka: horecapos-portaal/src/webshop.mjs.

Khasnadda iyo dukaanka online waa isku mid (qayb kasta si gaar ah ayaa loo shidi karaa, caadi ahaan waa dansan; dukaan online ah oo hore wuu iska indhatiraa goobaha cusub). Waxa khasnadda ka shidan, sidoo kale dukaanka online ayay ka shaqeeyaan:

• Happy hour: dukaanka online wuxuu xisaabiyaa isla qiimaha khasnadda xilligaas (qiimaha caadiga ah oo laga xariiqay iyo magaca happy hour), sidoo kale xilli leh.
• Qaybaha maalinta iyo nooca dalabka (haddii ay shidan yihiin): dukaanka online wuxuu muujiyaa kaliya waxa hadda la iibin karo, marka qaadasho iyo keenis la doortana qiimaha iyo alaabta doorashadaas (miiska: goobta). Menu-gu wuxuu alaab kasta u helaa prijzen (afhalen, bezorgen) iyo nietBij, iyo liiska dagdelen.
• Menuyada: martidu waxay doorataa cuntooyinka (go'an iyo doorasho, oo leh fursadahooda); khasnadda waxay ku timaadaa saf menu ah oo cuntooyinku ka hooseeyaan, qiimaha menugana waa la qaybiyay (VAT cunto kasta waa sax). Cuntooyinka ku jira menu kaliya waxay raacaan sida menuArtikelen. Dukaan online duug ah oo aan doorasho lahayn: menugu wuxuu rasiidka ku yimaadaa sida alaab caadi ah, sidii hore.
• Kayd dhammaaday = la iibiyay oo dhammaaday, sidoo kale fursadaha doorashada ee leh walax dhammaaday.
• Xasaasiyadaha: dansan khasnadda = kuma jiraan dukaanka online.
• Kaarka macmiilka: martidu marka lacagta la bixinayo waxay dhibco ururin kartaa (lambarka taleefanka ama iimaylka); khasnaddu macmiilka waxay ku xirtaa dalabka, dhibcuhuna waxay ku darmaan marka lacagta la bixiyo (isticmaalkooda waxaa lagu sameeyaa goobta). Dukaanka online wuxuu muujiyaa hadhaaga.
• Kaararka hadiyadda (Dejinta → Ganacsiga → Kaararka hadiyadda → Ka iibi kaararka hadiyadda dukaanka online, kaliya kuwa hadhaaga leh): martidu waxay iibsataa kaar oo online ku bixisaa; khasnaddu waxay samaysaa kaarka, oo isla markiiba shaqeeya, koodhkuna wuxuu portalka u maraa dukaanka online (xaaladda iyo iimaylka). Haddii sidoo kale Kaarka hadiyadda oo ah hab lacag bixin shidan yahay, martidu marka ay qaadanayso waxay dooran kartaa "kaarka hadiyadda goobta".
• Koodhadhka qiimo-dhimista (Dejinta → Koodhadhka qiimo-dhimista, oo leh furaha Ganacsiga): koodh kasta khasnadda iyo/ama dukaanka online; isticmaalka labadaba waa loo wada tiriyaa.
• Hakin iyo mashquul: badhanka Dukaan online ee baarka sare: Hakin dukaanka online (oo leh qoraal martida) iyo Mashquul (daqiiqado dheeraad ah). Dhowr ilbiriqsi gudahood ayuu dukaanka online gaaraa.
• Ballan online oo leh xeerarka khasnadda (Dejinta → Ganacsiga → Ballamaha): ugu badnaan dad, maalmo horay, xilliga ballanta, ugu yaraan ka hor iyo waqtiyada maalin kasta oo toddobaadka ah.
• Keenis iyo xilliyo: eeg Dukaanka online wuxuu raacaa khasnadda qaybta Keenis iyo xilliyo.
• All-you-can-eat miiska (Dejinta → Ganacsiga → All-you-can-eat → Sidoo kale marka miiska laga dalbado koodhka QR): haddii xirmo miiska ku socoto, martidu waxay arkaysaa cuntooyinka xirmada oo ah Ku jira € 0, oo leh wareegyada, ugu badnaan qofkiiba, waqtiga sugitaanka iyo xadka waqtiga. Inta kale si caadi ah ayay u bixisaa; wax walba waxay galaan biilka miiska. Haddii xaaladda miisku hadda isbeddeshay, kaashku wuu diidaa dalabka, martiduna mar kale ayay dalbanaysaa.
• Deyn (Dejinta → Qaansheegyo → Bixinta deynta → Sidoo kale dukaanka online): eeg Dukaanka online ee Bixinta deynta.
• Liiska sugitaanka online (Dejinta → Ganacsiga → Liiska sugitaanka): eeg Liiska sugitaanka online ee Liiska sugitaanka ee martida aan ballanta lahayn.
• Upsell: "Wax kale ma rabtaa?" (ikhtiyaari, caadi ahaan dansan; Dejinta → Ganacsiga → Bixi lacagta → Upsell dukaanka online): dooro kooxaha alaabta (tusaale cabbitaanno, suugo, macmacaan) iyo immisa soo jeedin. Dukaanka online, dambiisha iyo lacag bixinta waxaa markaas ka muuqda alaab kooxahaas ka timid oo aan weli ku jirin dambiisha (kaliya waxa hadda la iibinayo, aan dhammaan oo aan lahayn doorasho qasab ah); martidu hal taabasho ayay ku darsataa. Koox lama dooran = dansan, sidii hore. Kiosk-ku wuxuu leeyahay upsell u gaar ah (eeg Kiosk is-adeeg ah).

Menuga dukaanka online taas darteed wuxuu leeyahay versie: 2 oo leh goobaha menuArtikelen, allergenenAan, happyhours, menus, klantenkaart, cadeaubon, kortingscodes, pauze, drukteMin, volgt, bezetting, reserveren.online, ayce, opRekening, wachtlijst iyo upsell. Xaqiijinta portalka waxaa intaas dheer ku jira cadeaubonnen (koodhadh), klant (dhibco) iyo plek (liiska sugitaanka).

Tirinta portalka maamulka. Qaadasho iyo keenis dukaanka online-ka waxaa loo tiriyaa si gooni ah (webshop, webshopGeannuleerd gudaha verkoopTelling), maalinta uu yimid, mar kalena laguma tiriyo qaadasho/keenis. Miiska ka dalbashadu waxay si caadi ah ugu tirsantaa miiska.

Bixinta kaarka iyo mashiinnada kaarka

Dejinta → Lacag-bixinta (maamulaha kaliya):

• Teerminaallada: teerminaal kasta magac, ID-ga teerminaalka iyo furaha API ee u gaarka ah oo laga keenay PinPortal (Klant → Bewerk klant → Overige → API Keys). Kaydinta kadib furaha waxaa muuqda dhammaadkiisa kaliya; weligiis dib uguma noqdo browser-ka. Tijaabi xiriirka ayaad ku hubisaa furaha iyo teerminaalka.
• Habka tijaabada: wuxuu ku dayanayaa teerminaal (±7 s kadib wuu guuleystaa; qaddar ku dhammaada 13 senti waa la diidaa). Waxtar u leh tijaabinta iyadoo aan mashiinka kaarka la haysan.

Haddii uu jiro ugu yaraan hal teerminaal oo leh furaha API (ama habka tijaabadu shidan yahay), Bixi lacagta → Pin / Bancontact wuxuu si toos ah teerminaalka ugu bilaabaa lacag-bixinta, qaddarka uu server-ku xisaabiyo.

Inta isku-xirku shidan yahay, server-ku wuxuu aqbalaa "pin" kaliya marka lacag-bixin teerminaal oo guuleysatay ay jirto oo ah isla dalabkaas iyo isla qaddarkaas. Codsiyadu, sida PHP-SDK-ga rasmiga ah, waxay u socdaan foom caadi ah, iyadoo API-ga kaydka (api-backup.pinvandaag.com) la isticmaalo haddii API-ga ugu weyn aanu jawaabin. Jawaab kasta oo API-ga ah waxay daaqadda server-ka kaga jirtaa [pin], taasoo waxtar u leh cilladaha. Lacag-bixin guuleysatay oo aan weli la habayn (tus. tablet-ka oo damay) waxaa la helaa marka xigta ee dalabkaas lacagtiisa la bixinayo.

Bakhshiish (pin, caddaan iyo kaarka hadiyadda)

Shaashadda lacag-bixinta, hab lacag-bixineed kasta waxaa ku yaal saf badhamada bakhshiishka: Midna, 5%, 10%, 15% (kor loogu soo gaabiyay 10 senti), Soo-gaabin (ilaa euro-ga dhan ee xiga) iyo Lacag kale. Pin-ka macmiilku wuxuu teerminaalka hal mar ku bixiyaa qaddarka + bakhshiishka; caddaanka bakhshiishku wuxuu ku xisaabsamaa haraaga iyo khaanadda khasnadda. Rasiidhka waxaa ku qoran qaddarka pin-ka lagu bixiyay iyo "oo ay ku jirto bakhshiish" hoostiisa; WADARTA iyo VAT-ku isma beddelaan, maxaa yeelay bakhshiishku dakhli ma aha. Warbixinta X/Z baqshiishku wuxuu ku qoran yahay hab-bixin kasta iyo sida "Wadarta baqshiishka".

Maamuluhu wuxuu badhamada bakhshiishka ku dejiyaa Dejinta → Ganacsiga → Bakhshiish: shidan/dansan, boqolleyda (ugu badnaan 4, tus. "5, 10, 15"), in badhanka "Soo-gaabin" uu ku jiro iyo hababka lacag-bixinta (pin, caddaan, kaarka hadiyadda) ee bakhshiish la oggol yahay. "Midna" iyo "Lacag kale" had iyo jeer way ku jiraan.

"Ka dhig …" had iyo jeer wuu jiraa, hab lacag-bixineed kasta, xitaa marka badhamada bakhshiishku dansan yihiin (dejin ma leh): macmiilku laftiisa ayuu biilka kor u soo gaabiyaa farqiguna waa bakhshiish. Waxaa jira badhamo leh euro-ga dhan ee xiga iyo qaddarrada isku dhafan ee xiga (tus. € 28,00 → 29, 30, 40; € 44,00 → 45, 50, 60) iyo Wadar kale si aad laftaada u qorto wadarta. Mar kale taabashada badhanka la doortay = ha soo gaabin. Ugu badnaan € 500 bakhshiish (isla xadka server-ka khasnadda).

Internet ma jiro

Khasnaddu waxay ku shaqaysaa shabakadda gudaha uma baahna internet; kaliya pin-ka isku-xirka ayaa u baahan. Haddii goobtu aanay internet lahayn, baarka sare waxaa ku qoran Internet ma jiro · pin gacanta (daqiiqad kasta waa la hubiyaa). Shaashadda lacag-bixinta markaa, iyo sidoo kale marka bilowga teerminaalku fashilmo, waxaa soo baxa badhanka Horey teerminaalka ayaa lagu bixiyay: qaddarka ku bixi teerminaalka laftiisa oo sidaas ku diiwaangeli.

Khariidadaha iyo miisaska

Dejinta → Khariidadaha miisaska (maamulaha kaliya):

• Ku dar khariidado miisas (tus. Hoolka, Barxadda, Qolka muraayadda), magac u beddel, tirtir oo kala horreynta ku beddel ◀ ▶.
• Ku dar miisas badhamada shabakadda kor ka xiga (wareeg, labajibbaarane, dheer, miis taagan) oo jiid meeshooda adigoo isticmaalaya jiirka ama farta. Geeska buluugga ah ee miiska la doortay ayaa weyneeya ama yareeya.
• Miis kasta deji magaca/lambarka, tirada dadka (kuraasta yaryar ee miiska ku wareegsan way xisaabsamaan) iyo qaabka; nuqul samee ama tirtir.
• Kiiboodhka: falaaruhu way dhaqaajiyaan (Shift = tallaabo weyn), Delete wuu tirtiraa.
• Isbeddelladu waxay dhaqan galaan kaliya kadib Kaydi; "Ka noqo" wax walba dib ayuu u celiyaa.
• Miis ama khariidad leh dalab furan lama tirtiri karo. Miisaska la tirtiray waxay ku kaydsan yihiin dalabaadkii hore.

U wareeji dejinta goob labaad

Dejinta → Soo-dejin/Dhoofin (maamulaha kaliya). Haddii aad hal goob si buuxda u habaysay, qaabeynta u dhoofi fayl .json ah kadibna ku soo deji khasnadda goobta labaad. Qayb kasta waa la dooran karaa:

• Badeecadaha: kooxaha, badeecadaha, qiimaha (sidoo kale nooc dalab kasta), VAT, doorashooyinka, menu-yada, happy hour-yada (xilli leh), qaybaha maalinta, xasaasiyadaha, maaddooyinka/tilmaamaha cuntada, kaararka shaambada, xirmooyinka all-you-can-eat iyo sawirrada badeecadaha.
• Khariidadaha miisaska: qolalka iyo miisaska.
• Dejinno kale: dhammaan ikhtiyaarrada ganacsiga, daabacayaasha (cinwaan IP la'aan), oggolaanshaha door kasta iyo xisaabaadka.

Weligood ma raacaan: magaca, cinwaanka, koodhka boostada, magaalada, taleefanka, iimaylka, lambarka VAT iyo safka dhammaadka rasiidhka ee ganacsiga, iimaylka warbixinta Z, teerminaallada pin-ka iyo furayaashooda, shaqaalaha iyo PIN-adooda, iyo dhammaan dakhliga, rasiidhada, macaamiisha iyo tirada kaydka.

Soo-dejintu si adag ayay u ilaalisan tahay: digniin weyn oo casaan ah, calaamad "Waan fahmay...", mar kale PIN-ka u gaarka ah ee maamulaha, dalabaad furan oo aan jirin, isla dalkii (heerarka VAT) iyo nuqul-kayd toos ah oo hore. Soo-dejintu waxay ku dhacdaa hal macaamil: haddii wax qaldamaan, waxba isma beddelaan. Badeecadaha, kooxaha, maaddooyinka iyo miisaska jira lama tirtiro ee waa laga saaraa khasnadda (sida Tirtirka), si rasiidhadii hore iyo warbixinnadu u sii saxnaadaan.

Ka soo dejin khasnad kale

U wareeg adigoon wax walba dib u qorin. Had iyo jeer waa la heli karaa (shid/dami la'aan): Dejinta → Soo dejin/dhoofin (maamulaha kaliya) waxaa ku jira qaybta Ka soo dejin khasnad kale.

• Maxay: alaabta (magac, qiimaha VAT ku jiro, VAT, koox, kood/PLU, kaydka) ama macaamiisha kaarka macmiilka (magac, telefoon, iimayl, dhibcaha, cinwaan, koodka boostada, magaalo; magaca hore iyo magaca dambe waa la isku daraa).
• Faylka: dhoofinta khasnaddaadii hore (Dobizzz/DoPos, Lightspeed, MplusKASSA, unTill, Tebi ...) ama liis adiga kuu gaar ah: CSV (; , tab ama |; UTF-8 ama Excel Nederlandays) ama Excel (.xlsx), xaashida koowaad, magacyada tiirarka sadarka koowaad. Fayl .xls ah oo duug ah marka hore u kaydi .xlsx ama CSV.
• Tusaale: khasnaddu tiirarka waxay ku aqoonsataa magacooda (Omschrijving, Verkoopprijs incl. BTW, BTW %, Omzetgroep, Artikelnummer, GSM, Spaarpunten ...) waxayna muujisaa 10-ka sadar ee ugu horreeya. Haddii tiir khaldan yahay, adigu dooro. Waxba isma beddelaan ilaa Soo dejin.
• Alaabta: qiimayaal sida 3,50, € 3,50 ama 1.234,50; VAT sida 21, 9%, 0,09, sare ama hoose (aan la garanayn ama bannaan: heerka aad doorato, caadi ahaan kan ugu sarreeya). Kooxaha alaabta ee aan wali jirin waa la abuuraa (koox la'aan: "La soo dejiyay").
• Kaydka alaabta (tiirka Voorraad, Stock, Aantal ...): haddii La soco kaydka alaabta shidan yahay (Dejinta → Ganacsiga), alaabtu waxay la socotaa kaydka, kaydkuna wuxuu noqonayaa tiradaas (tirin ku jirta taariikhda kaydka, sababta "La soo dejiyay"). Madhan: kaydku sidiisa ayuu ahaanayaa.
• Fayl tusaale ah (CSV): liis aad adigu buuxiso (Naam;Productgroep;Prijs;Btw;Voorraad;Code), tusaale ahaan Excel.
• Macaamiisha: dhibcaha waxaa lagu daraa sixid "Laga soo dejiyay khasnad kale" (taariikhda ayuu ka muuqdaa). Oggolaanshaha SMS ama iimaylka lama soo wareejiyo (GDPR): mar kale weydii. Marka hore shid kaarka macmiilka.
• Alaabta jirta (kood isku mid ah, ama kood la'aan magac isku mid ah) iyo macaamiisha (telefoon ama iimayl isku mid ah) waa laga boodaa, ama waa la cusboonaysiiyaa haddii aad calaamadiso (alaabta: magaca, qiimaha, VAT, kooxda iyo kaydka). Sadarrada faylka ku labanlaabmay hal mar ayaa la qaataa.
• Dhammaadka: inta cusub, la cusboonaysiiyay iyo laga booday, iyo sadar kasta waxa khaldanaa (tusaale qiime ma leh). Ugu badnaan 5000 sadar mar kasta. Diiwaanka waxay ku qoran tahay "Habaynta waa la soo dejiyay".

Luqadaha (42, oo ay ku jiraan Turki, Carabi, Darija, Berber, Boolish, Bulgaari, Hangeeri, Ruush, Seerbiyaan, Albaaniyaan, Faarsi, Tigrinya, Amxaari, Soomaali, Babiyamento, Sranantongo, Hindi, Urdu, Indooniisiyaan, Fiyetnaamiis, Suuriyaani-Aramayk, Shiinees iyo Yukreeniyaan)

Shaashad kasta, badhanka yar ee © ee midigta hoose agtiisa waxaa ku yaal badhan yar oo luqadda ah (tus. NL iyo calanka yar). Taabo si aad u furto liiska doorashada: luqaduhu waxay u kala horreeyaan sida alifbeetada, iyadoo magaca luqadda laftigeeda uu ka horreeyo calanka: Bahasa Indonesia (Indooniisiyaan), Čeština (Jeeg), Darija (Carabiga Marooko ee far Laatiin ah), Deutsch, English, Español, Français, Hrvatski (Kuroweeshiyaan), Italiano, Kurdî (Kurmancî), Latviešu (Latfiyaan), Lietuvių (Lituweeniyaan), Magyar (Hangeeriyaan), Nederlands, Papiamentu (Babiyamento), Polski, Português, Română, Shqip (Albaaniyaan), Slovenčina (Islofaakiyaan), Soomaali (Soomaali), Sranantongo, Srpski (Seerbiyaan, far Laatiin ah), Tarifit (Berberka Rif), Tiếng Việt (Fiyetnaamiis), Türkçe, kadib far Siriilik ah Български (Bulgaariyaan), Русский (Ruush) iyo Українська (Yukreeniyaan), kadib luqadaha far Carabi ah: اردو (Urdu), الدارجة (Darija), العربية (Carabi), دری (Dari), فارسی (Faarisi, Farsi), پښتو (Bashtuu) iyo کوردی (سۆرانی) (Kurdiga Soranî), kadib far Suuriyaani ah ܣܘܪܝܝܐ (Suuriyaani-Aaraami, Suryoyo), far Devanagari ah हिन्दी (Hindi), far Ge'ez ah ትግርኛ (Tigrinya) iyo አማርኛ (Amxaari), far Tifinagh ah ⵜⴰⵎⴰⵣⵉⵖⵜ (Tamazight, Berber), ugu dambeynna 中文（简体）(Shiinees, far la fududeeyay). Dhammaan shaashadaha, badhamada, ogeysiisyada iyo fariimaha khaladka ee server-ka khasnadda waa la turjumaa.

• Shaqaale kasta: luqadda la doortay waxaa lagu kaydiyaa shaqaalaha galay (gebruiker.taal). Haddii qof ku galo luqad kale, khasnaddu isla markiiba way beddeshaa. Qalabka laftiisa waxaa lagu xasuustaa luqaddii ugu dambeysay ee la isticmaalay, si shaashadda PIN-kuba horeba ugu jirto luqaddaas. Haddii aad doorato luqad (shaashadda PIN-ka ama adigoo galay) oo aad 10 daqiiqo gudahood (mar kale) gasho, doorashadaas ayaa mudnaan leh waxayna noqonaysaa luqadda shaqaalahaas. Beddelidda shaashadda dib ayay u rartaa; waad sii jiraysaa biilka furanna wuu sii furnaanayaa.
• Markii ugu horreysay qalab: haddii tablet ama kombiyuutar aanay weli luqad ku jirin, khasnaddu waxay ku bilaabataa luqadda la doortay markii la rakibayay. Haddii aan luqad la dooran, luqadda qalabka laftiisa (browser-ka ama nidaamka hawlgalka, sidoo kale app-ka Android), haddii taasi aanay ku jirinna Nederlands. Kadib qalab kasta wuxuu xasuustaa doorashadiisa.
• Yurubta Bari: Boolish, Jeeg, Islofaakiyaan, Hangeeriyaan, Rumaaniyaan, Bulgaariyaan, Kuroweeshiyaan (sidoo kale Bosniyaan), Lituweeniyaan, Latfiyaan, Yukreeniyaan iyo Ruush: luqadaha inta badan shaqaalaha soo-galootiga ah ee Yurubta Dhexe iyo Bari ee Nederland iyo Beljam.
• Balkan: Seerbiyaan (far Laatiin ah, sida inta badan Seerbiyaanka Nederland iyo Beljam ku nool ay u qoraan; sidoo kale Montenegro) iyo Albaaniyaan (Albaaniya, Kosofo iyo Waqooyiga Makadooniya).
• Geeska Afrika: Tigrinya (Eritreya) iyo Amxaari (Itoobiya), labaduba far Ge'ez ah, iyo Soomaali (far Laatiin ah).
• Iiraan: Faarisi (Farsi). Qalab ku dejisan Faarisiga Afgaanistaan (fa-AF) wuxuu helaa Dari, inta kalena Farsi.
• Nederlandka Kariibiyaanka iyo Suriname: Babiyamento (Papiamentu, higaadda Curaçao iyo Bonaire; sidoo kale Aruba) iyo Sranantongo.
• Aasiya: Hindi (Devanagari; sidoo kale Sarnami Hindustani), Urdu (midig ilaa bidix), Indooniisiyaan iyo Fiyetnaamiis (far Laatiin ah, sidoo kale rasiidka).
• Marooko: Darija (Carabiga Marooko, luqadda hadalka) far Carabi ah iyo far Laatiin ah labadaba (sida Nederlandeyaal badan oo Marooko ah ugu qoraan fariimaha), Carabiga caadiga ah agtiisa. Berber: Tarifit (Rif, far Laatiin ah; inta badan Nederlandeyaasha Marooko waxay ka yimaadeen Rif) iyo Tamazight-ka caadiga ah ee Marooko oo far Tifinagh ah.
• Midig ilaa bidix: Carabi (Carabiga caadiga ah), Urdu, Darija far Carabi ah, Dari iyo Bashtuu (Afgaanistaan), Faarisi (Farsi, Iiraan), Kurdiga Soranî (Ciraaq/Iiraan) iyo Suuriyaani-Aaraami (Suryoyo, far Suuriyaani ah). Qaddarrada, koodhadhka iyo badhamada lambarradu waxay ahaanayaan bidix ilaa midig. Kurdiga Kurmancî (Turkiga/Suuriya) wuxuu ku qoran yahay far Laatiin ah.
• Warqadda jikada (jikada/baarka): caadi ahaan waxay ku qoran tahay luqadda shaqaalaha dalabka gudbiya. Daabace kasta, Dejinta → Daabacayaasha → Luqadda warqadda jikada waxaa sidoo kale lagu dooran karaa luqad go'an (tus. tan kariyaha), far Laatiin ah: Nederlands, Čeština, Darija, Deutsch, English, Español, Français, Hrvatski, Italiano, Kurdî, Latviešu, Lietuvių, Magyar, Papiamentu, Polski, Português, Română, Shqip, Slovenčina, Soomaali, Sranantongo, Srpski, Tarifit, Tiếng Việt, Bahasa Indonesia ama Türkçe. Bulgaariyaan, Ruush iyo Yukreeniyaan waxay warqadda jikada ku soo baxaan qoraal Laatiin ah (daabacaha rasiidhku ma garanayo Siriilik). Carabi, Suuriyaani, farta Devanagari, Ge'ez iyo Tifinagh iyo Shiinees laguma daabici karo daabacaha rasiidhka: markaa Darija waxay ku soo baxdaa far Laatiin ah, Tamazight sida Tarifit, inta kalena Nederlands. Qoraallada go'an (MIIS, Marxalad, SUG in la sii daayo, SII DAA MARXALADDA, MAR DAMBE LA DAABACAY, Qaado, Miiska hore) waa la turjumaa; magacyada badeecadaha iyo faallooyinku sidii loo geliyay ayay ahaanayaan. Daabacayaashii ku dejisnaa Nederlands, hadda waxay raacaan shaqaalaha.
• Rasiidhka khasnadda (macaamiisha oo dhan): caadi ahaan Nederlands, kana madax-bannaan luqadda shaashadaha. Luqad kale waxaad ku doorataa Dejinta → Ganacsiga → Luqadda rasiidhka khasnadda (qoraalka hoose ee rasiidhka hoostiisa), kaliya luqadaha far Laatiin ah. Taasi waxay sidoo kale khusaysaa pro forma, rasiidhka soo-celinta, nuqulka, kaarka hadiyadda iyo rasiidhka iimaylka. Qaddarrada, koodhadhka VAT, lambarka VAT ee ganacsiga iyo safafka canshuurta (Beljam) isma beddelaan; qoraal gaar ah oo rasiidhka hoostiisa ah wuxuu ahaanayaa sida ganacsigu u qoro.
• Badeecadaha, kooxaha iyo doorashooyinku waxay leeyihiin magacyada uu ganacsigu geliyo; lama turjumo.
• Luqadda shaqaale kasta waxaad sidoo kale ku dejin kartaa Dejinta → Shaqaalaha.
• Hordhaca iyo buugga tilmaamaha sidoo kale waxay ku jiraan luqadahan oo dhan. Badhanka yar ee © waxay ku furmaan luqadda khasnadda; korka waxaad calammada ku dooran kartaa luqad kale (taasi waxba kama beddesho khasnadda).

Horumariyeyaasha: qoraal kasta oo muuqda wuxuu koodhka ugu jiraa vt('Nederlandse tekst') (apps/pos-web/lib/i18n.ts); qoraalka Nederlands ayaa ah furaha. Turjumaadaha waxay ku jiraan apps/pos-web/lib/vertalingen/<taal>.ts. Haddii turjumaad maqan tahay, khasnaddu waxay tusaa Nederlands; tijaabada i18n (pos-web) waxay hubisaa in qoraal kasta luqad kasta lagu turjumay iyo in meelaha {0} ay sax yihiin. Fariimaha server-ka khasnaddu waxay ahaanayaan Nederlands waxaana lagu turjumaa browser-ka (sidoo kale leh {0}, tus. magaca badeecad ee fariinta).

Deji daabacayaasha

Khasnad cusub ma laha daabacayaal. Gal adigoo ah maamule (demo: 1111) oo baarka sare ka dooro Dejinta.

• Daabacayaasha: ku dar daabacayaal inta goobtu leedahay (tus. kaashka, jikada, baarka, pizza), mid walba leh isku xir (badanaa shabakadda: ciwaanka IP iyo dekedda 9100) iyo ballaca warqadda. Rasiid tijaabo ayaad ku hubisaa inuu shaqaynayo. Korka waxaad ka doorataa daabacaha daabaca rasiidka kaashka iyo pro forma (oo fura khaanadda lacagta). Daabace kasta waxaad sidoo kale u doorataa luqadda warqadda jikada (eeg Luqadaha); rasiidka kaashku wuxuu ahaanayaa Nederlandes.
• Isku xirka daabace kasta:
  • Shabakad (ciwaanka IP): ciwaanka IP iyo dekedda (badanaa 9100). Had iyo jeer sidaas ayuu u shaqeeyay, sidaasna wuu u shaqaynayaa: daabacayaasha jira si toos ah ayay shabakadda ugu jiraan.
  • USB: Linux qalabka, tusaale /dev/usb/lp0. Android daabacaha USB ee qalabka ku xiran (fiilada OTG; madhan = daabacaha USB ee ugu horreeya). Windows iyo macOS waxaad doorataa Daabacaha nidaamka.
  • Taxane (COM / ttyUSB): deked COM (Windows), /dev/ttyUSB0 ama /dev/ttyS0 (Linux, Android) ama /dev/cu.… (macOS), oo leh xawaaraha (badanaa 9600, 19200 ama 38400 baud). Sidoo kale daabace Bluetooth ah oo Windows ama Linux ay u xiraan sida deked COM ama /dev/rfcomm0.
  • Bluetooth: barnaamijka HorecaPOS ee Android, oo leh ciwaanka Bluetooth ee daabacaha la isku xiray (tusaale daabace rasiid oo guurguura). Marka hore daabacaha ku isku xir dejinta Bluetooth ee Android.
  • Daabacaha nidaamka (Windows / CUPS): daabacaha sida Windows ama CUPS (Linux, macOS) u yaqaanaan, oo leh darawalkiisa gaarka ah ama sida Generic / Text Only. Rasiidku si cayriin ah (RAW) ayuu daabacaha ugu tagaa, darawalku qaabayn la'aan.
  • Ku dhex dhisan (Sunmi, iMin ...): daabacaha ku jira kaash Android ah laftiisa.
  • Raadi wuxuu muujiyaa daabacayaasha iyo dekedaha uu kaashku arko. Mid dooro, ciwaankana waa la buuxinayaa.
• Borotokool: ESC/POS (ku dhowaad dhammaan daabacayaasha rasiidka, sidoo kale daabacayaasha Star ee ku jira qaabka ESC/POS) ama Star (Star Line Mode). Star, kaashku isagaa rasiidka beddela; rasiidku isku si ayuu u muuqdaa.
• Shaashadda adeegga ee leh daabace u gaar ah: shaashad adeeg oo Android ah oo leh barnaamijka HorecaPOS (tusaale terminal gacmeed leh daabace Bluetooth guurguura ah, ama Sunmi loo isticmaalo shaashad adeeg) iskeed ayay wax u daabici kartaa. Ka diiwaangeli qalabka laftiisa (Dejinta → Daabacayaasha → Shaashadaha adeegga ee leh daabace u gaar ah) kadibna daabacaha ka dooro Ku xiran. Shaashadda adeeggu rasiidyadeeda waxay ka soo qaadataa kaashka; barnaamijka halkaas ku dhaaf isagoo furan. Haddii ay guuldareysato (barnaamijku waa xiran yahay, waxay ka baxsan tahay gaarka wifi-ga), warqadda jikadu waxay gashaa safka daabacaadda, sida daabace shabakadeed oo dansan. Ka saar diiwaanka qalabka wuxuu daabacayaasha dib ugu celiyaa kaashka laftiisa.
• Daabace koox / badeecad kasta: koox alaabeed kasta u dooro daabacaha ay warqadda jikadu ku soo baxayso. Badeecad kasta waad ku beddeli kartaa daabace u gaar ah ama "warqad jiko ma leh".

Badeecadaha isku midka ah marka la daabacayo waa la isku daraa: laba jeer 1x Cola waxay noqonaysaa 2x Cola, warqadda jikada iyo rasiidhka khasnaddaba. Kaliya badeecadaha leh doorashooyin iyo faallo isku mid ah ayaa la isku daraa.

Rakibaha Linux wuxuu isticmaalaha kaashka geliyaa kooxaha lp iyo dialout, si kaashku u isticmaali karo daabacayaasha USB iyo kuwa taxanaha ah.

Caawimaad ma u baahan tahay?

Optimum POS · 085 560 00 60 · support@optimumpos.nl · Isn–Jim 9:00–20:00, Sab–Axd 14:00–20:00