Manual di HorecaPOS

E manual aki tin tres parti: promé pa e personal (sirbishi), despues pa e manager i finalmente pa e administradó. Kada parti ta sigui riba esun anterior: un manager por hasi tur loke e sirbidó por hasi, i e administradó por hasi tur kos.

Kiko bo ròl por hasi eksaktamente, e administradó ta konfigurá na Ajustenan → Derecho. Si bo no ta mira un boton, bo ròl no tin derecho riba dje (ainda).

E manual aki ta den e kaha tambe: tok riba e boton © abou na banda drechi di kada pantaya i skohe Manual, òf habri http://<kassa-pc>:3000/handleiding. Wak tambe e introdukshon i e dokumentashon di API.

Parti 1 · Personal

Kuminsá

Drenta. Habri e kaha riba e kaha, tablet òf telefòn i pone bo pincode (4 te 8 sifra). Despues bo ta mira e plano di mesa.

Habri un mesa. Tok riba un mesa. Un mesa liber ta haña un òrdu nobo; na un mesa okupá bo ta sigui ku e òrdu ku tin kaba. Ariba bo ta kambia entre e salanan (por ehèmpel Sala i Terras). Pa e mostrador bo ta usa Benta lihé, pa òrdu pa hiba Pa hiba.

Pidi. Skohe un grupo di produkto i primi riba e produktonan. Nan ta aparesé riba e resibu na banda robes. Si bo ke, skohe promé e kurso (1 = mesora, 2 i 3 ta warda te ora bo yama nan). Primi riba Manda òrdu: e bonnan di òrdu ta bai kushina i bar. Tanten bo no a primi riba Manda òrdu ainda, bo por kita liñanan sin problema.

Paga. Primi riba Paga, skohe Pin / Bancontact, Kontant òf Bon di regalo, si bo ke un propina, i konfirmá. Ora bo paga ku karchi, e pago ta kuminsá outomátikamente riba e terminal di pago. E resibu ta wòrdu imprimí; bo por mand'é pa e-mail tambe.

Sera sesion. Sera bo sesion ora bo kaba, pa ningun otro hende traha bou di bo nòmber. Despues di 8 ora bo sesion ta sera outomátikamente.

No tin internet? E kaha ta sigui traha normal. Si ariba ta para No tin internet · paga ku karchi manualmente, anto drenta e suma riba e terminal di pago mes i skohe den e pantaya di pago Pagá kaba riba e terminal.

Vários grupo na un mesa

Na un mesa por sinta varios grupo, kada un ku su mes kuenta i su mes resibu.

• Primi riba un mesa: liber = òrdu nobo; un grupo = mesora e grupo ei; varios grupo = skohe promé, òf + Grupo nobo (nòmber por keda bashí).
• Den e pantaya di òrdu, ariba bo ta mira e bara di grupo: kambia entre e gruponan, + Grupo, Nòmber di grupo (p.e. "Jansen") i Parti / move.
• Parti / move: skohe pa kada liña kuantu ta bai (na 3× Pils, p.e. 1) i na kua grupo, òf traha un grupo nobo. Asina bo ta move algu ku ta riba e kuenta robes, òf bo ta parti despues "kada un ta paga su mes parti". Si un grupo keda bashí, e ta disparsé.
• Vários parti un biaha: ku + Un parti mas bo ta prepará un parti i skohe e siguiente (por ehèmpel piská i un Dry Martini pa mesa 2, e resto pa mesa 35). Un parti por bai tambe pa + Otro mesa (aya un grupo nobo). Ku Move tur kos ta bai un biaha. ½ ta parti un liña na dos, tambe un mitar boter (0,667 ta bira 2 × 0,3335).
• Uni: tur kos di un òf mas otro mesa (òf grupo na e mesa aki) riba e kuenta aki, un biaha.
• Bélgika: parti òf uni un biaha ta un kambio di mesa na e kaha preta, manera FOD ke (UC242, UC251, UC252, UC4119bis). Si despues di manda òrdu bo kita algu òf duna deskuento riba un liña ku a wòrdu ordená kaba, esei ta bai huntu ku e siguiente mensahe di e mesa ei (òrdu, kuenta provishonal, kambio di mesa) i si no den e benta: e liña bieu negativo i e liña nobo positivo (UC226, UC4102, UC4104, UC4107, UC4110).
• Riba e pantaya di mesa un bolita oraño ta mustra kuantu grupo tin; e suma ta e total di tur grupo.
• Resibu di kaha i bon di kushina ta mustra "Mesa 5 - grupo 2" òf "Mesa 5 - Jansen".

Parti kuenta ora di kobra

Paga ta traha manera semper: Tur na un biaha. Den e pantaya di pago awor bo por parti e kuenta tambe, ku e botonnan bou di Bèk i Paga (asina nan ta keda semper na bista, sin swipe):

• Parti igual: skohe ku − i + entre kuantu persona (standard e kantidat di invitado, òf 2 si e kasa no ta registrá persona). E pantaya ta mustra e suma pa persona; kada un ta paga su parti ku pin, kèsh òf karchi di regalo (ku propina si bo ke). Despues di kada parti e ta konta bou ("ainda 3 persona"); esun último ta paga eksaktamente e resto.
• Suma propio: un hende ta paga un suma fiho (p.e. € 20); e resto ta keda habrí.
• Pa produkto…: ta habri Parti / move pa pone produktonan riba un kuenta separá i paga esei apart (manera ariba).

Un pago parsial ta registrá solamente e pago; e kuenta ta keda habrí i den e pantaya di òrdu ta para "pagá kaba … · ainda habrí …". E resibu (ku tur pago riba dje) ta sali na e último pago, manera ora bo paga normal. Pago ku karchi via e konekshon ta pa eksaktamente e suma parsial. Si a paga un parti kaba, no por move liña mas pa otro grupo ni agregá deskuento mas; kita liña ta posibel solamente si tin sufisiente habrí ainda. Kada pago parsial ta drenta den e registro.

Benta lihé i pa hiba (sin mesa)

Ariba na banda drechi di e pantaya di mesa bo ta haña Benta rápido i Pa hiba. Tur dos ta habri mesora un òrdu sin mesa. Benta rápido ta benta na mostrado (BTW pa kome aki); Pa hiba ta usa e tarifa di BTW pa hiba di kada produkto. Ku "Nòmber di kliente" bo ta pone un nòmber; esei ta para riba e resibu ("Pa hiba – Jansen") i ariba riba e bon di òrdu. Òrdunan habrí sin mesa ta para bou di e botonnan di área ("Sin mesa: Pa hiba #12 – Jansen"), pa bo haña nan bek. Si bo bai bek sin bende nada, e òrdu bashí ta disparsé outomátikamente.

Bo por aktivá òf desaktivá tur dos boton pa negoshi na Konfigurashon → Negoshi, mesora bou di tema kla/skur (standard aktivá). Desaktivá = boton skondí; òrdunan sin mesa ku ta habrí kaba ta keda visibel.

Entrega i bloke di ora

Òrdunan ku bo mes ta tuma na e kaha, por ehempel pa telefòn òf na mostrador, ku e mesun reglanan ku e tienda online: zonanan di entrega i un máksimo kantidat di òrdu pa bloke di ora. Aktivá na Ajuste → Negoshi → Entrega i bloke di ora, mesora bou di e botonnan Benta lihé i Pa hiba (standard desaktivá).

• Boton Entrega riba e pantalla di mesa (banda di Pa hiba): drenta nòmber, telefòn i adrès (ku Drenta adrès lihé aktivá: buska kódigo postal i número di kas). E kaha ta buska e zona di entrega i ta mustra e kosto di entrega, e mínimo i "grátis for di". Si e adrès ta keda pafó di e zonanan, no ta posibel.
• Zonanan di entrega: pa kódigo postal (serie i kódigo postal sòlo, p.e. 5000-5049, 5051, 5052 AB), den un radio den km for di e negoshi (den liña reta) òf un área riba e mapa ku bo mes ta dibuhá. Radio i área ta funshoná djis ku adrès den Hulanda (ubikashon via PDOK). Pa kada zona: kosto di entrega, mínimo, grátis for di i minüt ekstra; e promé zona di ariba ku ta pas, ta konta, p'esei bo por kombiná e tiponan (p.e. promé algun kódigo postal, despues un área, despues un radio pa e resto). Ningun zona konfigurá = entregá tur kaminda, sin kosto ni mínimo. E zonanan di e tienda online bo ta konfigurá aparte (maneho di tienda online).
• Área riba e mapa: na un zona di entrega skohe e tipo Área riba e mapa i despues Dibuhá riba e mapa. Klek riba e mapa pa pone punto (por lo ménos 3); hala un punto pa move'é, klek riba un punto pa kit'é i hala e bolita meimei di un rant pa pone un punto entre nan. E mapa ta mustra tambe e zonanan di radio i e negoshi. E pedasonan di mapa ta bini di OpenStreetMap, p'esei pa e mapa bo mester di internet; pa e entrega mes nò (fuera di buska e adrès). Si no por buska e adrès, e kas ta avisá esei en bes di "pafó di e zonanan di entrega".
• Kosto di entrega ta aparesé komo liña "Kosto di entrega" riba e òrdu i ta wòrdu kalkulá di nobo despues di kada kambio (grátis for di, sin produkto = sin kosto), mientras ainda no a paga nada. Bou di e mínimo no por kobra; e pantalla di òrdu ta mustra kuantu mas ta falta, ku e boton Tòg pa hiba (kosto di entrega i mínimo ta kai afó).
• Ora: Mas lihé posibel (awor + tempu di entrega, plus e minüt ekstra di e zona) òf un bloke di ora di awe. Si tin orario di Thuisbezorgd, nan ta konta aki tambe.
• Máksimo pa bloke di ora (0 = sin máksimo; bloke di ora di 5 te 60 minüt): pa Pa hiba i Entrega huntu; òrdunan di tienda online den e kaha tambe ta konta. Si tin un máksimo, Pa hiba tambe ta pidi un ora i bo no por skohe bloke di ora yen. Dos kaha ku ta tuma e último lugá na mesun momento: un so ta hañ'é.
• Riba e bon di trabou tin adrès, nòmber, telefòn i ora; den "Sin mesa" i ariba riba e bon di trabou por ehempel "Entrega – 18:30 Jansen".

Ekstenshonnan (tur standard desaktivá; sin e konfigurashonnan aki tur kos ta funshoná eksaktamente manera ariba):

• Orario propio pa hiba i entrega (pa dia di siman, p.e. 16:00-21:00 òf 11:30-14:00, 17:00-22:00; despues di mei anochi ta permití: 17:00-01:00; bashí = e dia ei será). Desaktivá = manera promé (e oranan na Thuisbezorgd, si tin, sino henter dia).
• Dianan será (p.e. 25-12-2026, 26-12-2026): e ora ei no tin pa hiba ni entrega.
• Ordená di antemano: 0 (solamente awe, manera promé) te 14 dia. Den e bentana Entrega/Pa hiba bo ta skohe promé e dia; un dia mas despues ta para riba e bon di kushina promé ku e ora.
• Ocupá: asina tantu minüt ekstra na "mas lihé posibel" (kaha i tienda online). Tambe por pone lihé ku e boton Tienda online den e baranka ariba.
• Adrèsnan Belga (kódigo postal di 4 sifra): na un radio òf zona riba e mapa e kaha ta buska e ubikashon via OpenStreetMap (Nominatim; kaya i lugá ta nesesario).
• E tienda online ta sigui e kaha: e kaha ta guia. E tienda online ta usa e ora ei e zonanan di entrega, ora di entrega i di hiba, e bloke di ora, e máksimo pa bloke di ora, e orario (si nan ta konfigurá aki), dianan será i dianan di antemano di e kaha, i ta konta e òrdunan aseptá na e kaha den e bloke di ora. Desaktivá = e tienda online tin su mes konfigurashon (maneho di tienda online), manera promé. Aktivá òf desaktivá pa hiba/entrega ta keda di e tienda online.

Kódigo: lib/bezorgen.ts, routes/bezorgen.ts, BezorgDialoog.tsx, BezorgInstellingen.tsx, BezorgKaart.tsx i lib/kaart.ts (e mapa, sin pakete ekstra; e mesun kódigo ta den e tienda online komo public/kaart.js).

Telefonia: rekonosé kliente na un òrdu pa telefon

Konfigurashon → Telefonia (standard desaktivá; desaktivá ta warda tur kos). Dos switch apart:

• Buska kliente riba number di telefon na entrega i pa hiba: si bo tek e number den e pantaya di entrega, e kaha ta mustra e kliente ku adrès i e òrdunan anterior; Tuma over e datonan ta yena nòmber, e-mail i adrès. Ta funshoná tambe sin sentral di telefon.
• Rekonosementu di number: ora un kliente yama, e sentral di telefon (òf e aparato, e FRITZ!Box, e modem òf e telefon Android) ta reportá e number. Riba e pantayanan ta aparesé un aviso ku ken ta yama: nòmber, adrès, e último òrdunan (ku e plato i e suma, tambe di e tienda online, Thuisbezorgd i e plataformanan di entrega), e total i un reservashon. Ku Tuma òrdu di entrega òf Tuma òrdu pa hiba e pantaya di entrega ta habri ku tur kos kaba yená (ku Entrega i blòki di tempu na); e òrdu ta bai serka e yamada i e aviso ta disparsé riba tur pantaya. Boton 📞 den e bara ariba: e yamadanan di e último 24 ora. Por pag'é pa kada pantaya (Mustra avisonan riba e pantaya aki).

E kaha ta buska den e karchi di kliente, e òrdunan di entrega i pa hiba di e kaha, e tienda online, Thuisbezorgd, e plataformanan di entrega i e reservashonnan. Numbernan ta wòrdu igualá (+31 6 1234 5678, 0031612345678 i 06-12345678 ta meskos; tambe numbernan belga).

Kon e number ta drenta (mas na mes momento ta posibel; e mesun yamada ta konta un biaha):

E kontesta ta kontené esun ku ta yama, tambe komo contact (firstname, lastname, phone, email, address) pa un sjabloon CRM di 3CX. Yamadanan ku ta sali i yamadanan interno no ta wòrdu mustrá; Solamente e liñanan aki ta limitá na sierto liña òf aparato. Yamadanan ta wòrdu borá despues di e periodo di warda (standard 30 dia, AVG). Yamada di test ta hasi manera un number ta yama.

Kòdigo: apps/pos-server/src/lib/telefonie.ts, routes/telefonie.ts, packages/shared/src/telefonie.ts; pantaya Telefonie.tsx, BezorgDialoog.tsx; Android android-app/native/java/Beller*.java. Buki di registro: Telefonia.

Entregadó propio: viahe, entrega di plaka i track & trace

Pa negoshi ku entregadó propio. Aktivá e na Konfigurashon → Negoshi → Entrega → Entregadó propio (standard desaktivá). No mester app pa e entregadó: e entregadó ta usa un página den e browser di su mes telefòn (ken ku ke, ta usa e app Optimum Bezorger: wak App di entregadó aki bou).

Krea un viahe. Den e kasa tin e boton Viahe (ku e kantidat di entrega ku ainda mester sali plus e viahenan ku ta na kaminda).

1. Na Kla pa entregá marka e òrdunan ku ta bai. Esakinan ta e òrdunan di entrega for di e kasa, e tienda online i Thuisbezorgd (djis entregá bo mes; esnan ku un entregadó di Thuisbezorgd nò).
2. Skohe e entregadó (un empleado) i e sèn chikí ku ta bai kuné (standard e suma di e konfigurashon), i primi Krea viahe.
3. Un kódigo QR ta aparesé. E entregadó ta skan e ku su mes telefòn i ta mira pa kada adrès e nòmber, e adrès ku un boton Ruta (navegashon), Yama, e komentario, e ora deseá i loke mester kobra. Tin un kalkuladó di sèn chikí (kliente ta duna € 50 → bèk € 31,50). No mester login. Kompartí e link djis ku e entregadó: ken ku tin e link, ta mira e adresnan di e viahe akí. Ku Kódigo QR pa e entregadó bo ta krea un link nobo; e bieu no ta traha mas.
4. Primi Sali ora e entregadó ta bai. E sèn chikí ta sali for di e kashi (plaka sali, ku e motibu). E kliente ta haña mensahe ku e òrdu ta na kaminda:
   • pa un òrdu for di e kasa via sms i/òf e-mail, si Mensahe pa kliente ta aktivá (wak Entrega i bloke di ora);
   • pa e tienda online manera konfigurá den e tienda online (mail, sms òf mensahe push);
   • pa Thuisbezorgd via Thuisbezorgd.

Si e viahe no a sali ainda, e por wòrdu kanselá ainda.

1. Na kaminda e entregadó ta primi pa kada adrès Entregá, kèsh, Entregá, pin (un aparato di pin propio) òf Entregá (pagá kaba). E kasa ta mira esei mesora. Si e entregadó no por avisá, por hasi esei tambe den e kasa. Bèk den e negoshi e entregadó ta primi Mi ta bèk den e negoshi.

Entrega di plaka. Despues di e viahe bo ta primi Kobra (derecho Manehá kashi di plaka):

• Pa kada òrdu bo ta skohe kèsh, pin na porta, pagá kaba òf no entregá (bèk). Loke e entregadó a avisá ta yená kaba.
• E kasa ta kobra kada òrdu ku un suma habrí, sin resibu nobo (e kliente tin e resibu kaba; print di nobo por na Resibunan). Un òrdu ku no a wòrdu entregá ta sali for di e viahe i ta keda habrí, pa e por bai riba un siguiente viahe.
• Bo ta mira loke ta spera: e sèn chikí plus loke a risibí kèsh. Yena loke e entregadó ta entregá, òf konta e pa biyete i moneda (Konta pa biyete i moneda). E kasa ta mustra si e ta kuadra, òf kuantu tin di mas òf di menos.
• E sèn chikí ta bolbe den e kashi (plaka drenta). E diferensia ta keda na e viahe i den e buki di registro, i ta bolbe tambe komo diferensia di kaha den e rapòrt Z.

Track & trace (pa aktivá separá den e konfigurashon). E kliente ta haña ora e òrdu ta na kaminda un link pa un página di sigui riba e portal. E link ta den e sms òf e-mail, i den e tienda online riba e página di status (Sigui bo entregadó). Riba e página di sigui tin:

• si e òrdu ta wòrdu prepará, ta na kaminda òf a wòrdu entregá;
• e ora ku ta spera: for di e lugá di e entregadó pasando e adresnan ku ta bini promé, sino e ora deseá;
• kuantu adrès tin ainda promé (sin mustra otro adrès);
• ku E entregadó en bibo riba e mapa tambe e entregadó, e negoshi i e adrès propio riba un mapa (OpenStreetMap). E entregadó mes ta aktivá kompartí lugá riba su telefòn (Kompartí mi lugá). E lugá ta wòrdu manda djis tanten e página ta habrí; e página ta tene e pantaya sendé.

E páginanan ta den e idioma di e telefòn (tur idioma di e portal). Den e kasa bo ta mira na e viahe ki ora e lugá a wòrdu manda pa último biaha (ku un link pa e mapa).

Privasidat. E portal ta warda e datonan di un viahe (nòmber, adrès, número di telefòn, e lugá) djis tanten e viahe ta kore. Ora di kobra tur kos ta wòrdu kitá, sino despues di 24 ora. E kliente ta mira djis su mes òrdu. E lugá di e entregadó ta visibel djis durante e viahe, i no mas apenas e entregadó ta bèk.

Planifikashon di viahe (opshonal)

Aktivá esaki na Konfigurashon → Negoshi → Entrega → Planifikashon di viahe (standart desaktivá; ta funshoná ku entregadó propio). Den e bentana Viahe anto tin e boton Proponé viahe. E kaha ta kombiná e òrdunan ku ainda mester bai den viahe:

• òrdunan ku ta serka di otro i kuyo oranan deseá ta kai den e bentana di tempu (standart 30 minüt) ta bai huntu;
• te e máksimo kantidat di adrès pa viahe (standart 4), mientras e viahe (bai, tur adrès i bin bèk na e negoshi) no ta dura mas largu ku e máksimo (standart 45 minüt);
• pa kada viahe e mihó òrden, e distansia (km), e tempu di biahe bai i bini i pa kada adrès e yegada spera si sali awor. Si esei ta mas lat ku e ora deseá, ta para mas lat ku pidí serka.

Ku Usa e viahe aki bo ta marka e òrdunan ei, den e òrden ei; skohe e entregadó i primi Krea viahe. Na un viahe ku ainda no a sali, Mihó òrden ta poné e adrèsnan den e òrden di mas lihé (tambe riba e telefòn di e entregadó). Na kada viahe tin e distansia i e tempu di biahe.

Konfigurashon: adrès pa viahe, kuantu tempu un viahe por dura, e ventana di tempu, e velosidat di e entregadó (baiskel ~15, scooter ~25, outo ~35 km/ora den stat) i e minüt pa adrès (parker, bati bel, paga; standard 2). E sifranan aki e gerente tambe por konfigurá: den e bentana Viahe ku e boton Konfigurá planifikashon di viahe (permiso Konfigurá planifikashon di viahe, standard na pa e gerente; por kambia na Konfigurashon → Permisonan). Pone planifikashon di viahe na òf paga i e servisio di ruta (adrès, yabi di API) ta keda serka e atministradó.

Distansia i tempu di biahe, pa e atministradó skohe:

• Kálkulo (standart): den liña reta bes 1,35 (faktor di bira) ku e velosidat di e entregadó. Ta funshoná sin internet i sin kuenta.
• OSRM: ruta riba kaminda via un server di OSRM. Yena e adrès (https://, òf http:// den bo propio red). E server di demostrashon públiko (https://router.project-osrm.org) ta solamente pa de bes en kuando; pa uso diario, instalá bo propio server di OSRM òf tuma un proveedor.
• OpenRouteService: ruta riba kaminda ku bo propio kódigo API (grátis pa krea na openrouteservice.org, ku un máksimo pa dia). E adrès ta standart https://api.openrouteservice.org i por kambia pa bo propio server. E yabi ta keda riba e kaha; e pantayanan ta mustra solamente ku e ta yená.

Ku Test bo ta purba e servisio. Si e servisio no ta funshoná, e planifikashon ta bolbe na e kálkulo i ta bisa esei. Un adrès kuyo ubikashon no ta konosí (sin kódigo postal i number di kas válido) ta bai den e proposishon bou di sin ubikashon konosí i no ta wordu planiá. E eksportashon di konfigurashon ta hiba e konfigurashon, pero no e yabi.

Kódigo: lib/ritplanning.ts.

App di entregadó (opshonal)

Aktivá e na Konfigurashon → Negoshi → Entrega → App di entregadó (standard desaktivá; ta funshoná ku entregadó propio i e portal di maneho). Kada entregadó ta konektá su propio telefòn anto un biaha, en bes di skan un QR-code pa kada viahe:

1. Bou di Telefòn konektá skohe e entregadó (un empleado), si bo ke e nòmber di e telefòn, i primi Konektá telefòn.
2. Un QR-code ta aparesé. E entregadó ta skan esaki den e app Optimum Bezorger (boton Konektá), òf ku e kámara di e telefòn: anto e página ta habri den e browser. Esaki ta funshoná tambe sin app i por bai riba e pantaya prinsipal.
3. E konekshon ta keda válido te ora bo revok'é; e telefòn no ta mira nada mas mesora. Un konekshon nobo pa e mesun empleado ta reemplasá esun bieu (por ehempel ku un telefòn nobo).

Den e app òf riba e página tin tur su propio viahenan (kada viahe ku e kaha ta traha pa e entregadó akí), ku e mesun botonnan ku na un viahe: Ruta, Yama, pa kobra ku kalkuladó di sèn chikí, Entregá i Mi ta bèk den e negoshi. Por aktivá apart:

• Kohe òrdu bo mes: e entregadó ta mira e entreganan ku ainda mester bai den un viahe, ta marka loke ta bai kuné i ta primi Hiba kuné. E kaha ta traha e viahe (òf ta pone nan aden si e entregadó ei tin un viahe ku no a sali ainda); e sèn chikí standard ta bai kuné. Loke otro hende a kohe kaba, no por mas.
• Sali bo mes: Sali den e app ta hasi meskos ku den e kaha (sèn chikí for di e kashi, e klientenan ta haña mensahe).
• Mapa en bibo: na Viahe tin e boton Mapa ku e negoshi, tur entregadó ku ta na trabou i e adresnan ku ainda mester wòrdu entregá. E entregadó mes ta pone Na trabou aktivá i desaktivá. E app ta pasa e lugá tambe ku e pantaya pagá (Android: un notifikashon den e bara tanten e kompartimentu ta aktivá); e página web solamente tanten e ta habrí. Sin e konfigurashon akí e lugá ta wòrdu kompartí solamente durante un viahe ku track & trace.

E app pa Android ta den Google Play i riba e página di download di e portal (/download/). Un version pa iPhone ta kla, pero ta bini solamente ora tin un kuenta di desaroyadó di Apple; te e tempu ei iPhonenan ta usa e página web. Na un viahe ku e entregadó a kohe e mes ta para kohé pa e entregadó mes den e app.

Kódigo: lib/bezorgersapp.ts, den e portal src/volgen.mjs i e app den e repo horecapos-bezorger.

Den e buki di registro ta keda ken a krea un viahe, laga sali, avisá entregá i kobra, ku e sumanan. Desaktivá: no tin boton Viahe; viahe i konfigurashon ta keda wardá.

Riba e portal: /bezorger/<sleutel> i /volg/<code>. Kódigo: lib/bezorgers.ts, routes/bezorgers.ts, Bezorgers.tsx i den e portal src/volgen.mjs.

Aviso pa tempu di preparashon muchu largu

Un order pa hiba òf pa entrega ku ta kla mas lat ku primintí: e kaha ta mir'é i avis'é, i por manda kliente mesora un despensa, eventualmente ku un vale di krédito. Aktiv'é na Konfigurashon → Negoshi → Entrega → Aviso pa tempu di preparashon muchu largu (standard desaktivá).

• Kua ordernan: pa hiba i pa entrega ku un ora primintí, for di e kaha (entrega i periodonan di tempu), e tienda online i Thuisbezorgd.nl / Takeaway.com.
• Tardá: tantu minüt (standard 10) despues di e ora primintí ainda no kla òf na kaminda. Kla òf na kaminda ta: tur kos kla riba e pantalla di kushina, e status kla òf na kaminda den e tienda online òf na Thuisbezorgd, e mensahe ✉ Kla / ✉ Na kaminda na kliente, òf pagá. E kaha ta chèk tur minüt.
• Aviso: boton Tardá den e bara ariba ku e kantidat (ku zonido ora tin un nobo), ku pa kada order e ora primintí i kuantu minüt e ta tardá. Un order ta disparsé di su mes ora e ta kla òf na kaminda, òf ku Atendí; bou di esei tin esnan di e último 24 ora, ku ki ora nan tabata kla. Tur kos ta den e buki di registro.
• Tienda online: e página di status di e kliente ta mustra ku e ta tarda mas, ku e ora nobo ku ta spera.
• Na Thuisbezorgd esei no ta posibel (e kliente ta di Thuisbezorgd): einan solamente e aviso. Un teksto propio ta posibel; {naam}, {zaak}, {code}, {korting} i {geldig} ta wòrdu yená.
• Vale di krédito (solamente ku Kódigonan di deskuento aktivá): huntu ku e despensa un kódigo di deskuento personal pa e siguiente order (p.e. SORRY-7K4Q2M), un monto òf porshento, pa usa un biaha, válido tantu dia, na kaha i den e tienda online. E kódigonan no ta den e lista di Kódigonan di deskuento. Si e manda faya, e kódigo ta kaduká. Ku e boton den e kaha solamente ku e derecho Duna deskuento.
• Desaktivá: e avisonan i e kódigonan duná ta keda wardá (tambe den e back-up); e konfigurashon ta bai huntu den e eksportashon di konfigurashon.

Kódigo: lib/telaat.ts, routes/telaat.ts, TeLaat.tsx i packages/shared/src/telaat.ts.

E boton Manda òrdu: kiko e ta hasi i ki ora bo tin mester di dje

Primi riba un produkto i primi riba Manda òrdu ta dos paso diferente:

• Primi riba produkto ta pone e produkto mesora riba e kuenta (na banda robes den e lista), komo nobo. Ta bo so ta mir'é: kushina i bar no sa nada di dje ainda. Un liña nobo ta manera un borador: kita, kambia kantidat òf opshon ainda ta posibel sin problema, sin storno.
• Manda òrdu ta manda tur liña nobo un biaha: e bonnan di trabou ta bai na e printernan di kushina i bar (i e pantaya di kushina), despues e liñanan ta keda pidí. Kita nan ta posibel ainda djis ku un Storno (derecho storno). Riba e boton ta para kuantu liña nobo ta kla, p.e. Manda òrdu (3); si no tin liña nobo, e boton ta gris.

Pakiko dos paso? Na mesa bo ta tuma henter e òrdu (bebida, entrada, kuminda prinsipal), ta ahustá algu si e kliente kambia di idea, i despues bo ta mand'é un biaha pa kushina, ku un bon pa kada stashon en bes di un bon pa kada produkto. Asina kushina por kuminsá kaba, hopi promé ku ta paga.

Kiko mas ta pasa ku Manda òrdu:

• Kursonan: kurso 1 ta bai mesora pa kushina; kurso 2, 3 i 4 ta bai kune komo WARDA i kushina ta kuminsá djis ora bo yama e kurso ei (wak Kursonan).
• Rònde: kada biaha ku bo Manda òrdu ta un rònde; ↻ Un otro rònde ta traha riba esei.
• Stòk ta baha i un tap dosifiká ta wòrdu liberá.
• All-you-can-eat: si ta muchu, muchu trempan òf muchu lat pa e arreglo, e kasa ta puntra promé si ta pèrmití tòg.
• Bèlgika (GKS 2.0): e liñanan ta bai promé komo pro forma na e kaha preto; si esei no ta logra, nada no ta bai pa kushina i nan ta keda nobo.
• No tin konekshon: e òrdu ta wòrdu wardá i ta bai pa kushina apenas konekshon bolbe. Printer pagá: òrdu ta sigui tòg, e bon di trabou ta drenta e fila di print (wak Printer di kushina pagá òf no tin pantaya di kushina).

Kobra mesora tambe ta posibel. Si bo primi Kobra miéntras ainda tin liña nobo riba e kuenta, e kasa ta manda nan outomátikamente promé, pa kushina i bar semper haña nan bon. Pues na bar òf pa hiba bai bo no mester primi Manda òrdu promé: primi e produkto i Kobra mesora. Si e òrdu outomátiko ei no logra (no tin konekshon, liña di all-you-can-eat, kaha preto), e pantaya di kobra ta keda sera i bo ta mira pakiko.

Bo ta preferá pa bar no haña bon ora bo kobra mesora? Na Konfigurashon → Negoshi → Òrdu i kobra, aktivá Kobra direkto sin bon di trabou. Asina ta solamente loke bo manda ku Manda òrdu ta bai kushina i bar; loke bo kobra mesora no ta haña bon di trabou.

Boton Kobra grandi òf chikitu

Ku e kashi Boton grandi "Kobra" marká, e pantaya di òrdu ta mustra un boton Kobra grandi mesora bou di e produktonan ordená: hanchu, haltu i ku e suma riba dje, pa bo por primi lihé. Si un parti di e kuenta a wòrdu pagá kaba, e boton ta mustra loke ta keda habrí. E boton chikitu abou banda di Manda òrdu ta disparsé e ora ei.

Ku e boton grandi, e botonnan den e pantaya di kobra tambe ta grandi: Kobra (na Pin, Vale di regalo i e otro métodonan di pago) i na Kèsh Paga eksakto i Kobra ta hanchu i haltu, fásil pa primi, asta ku dede sushi (por ehèmpel na un kachero). E métodonan di pago ta un tiki mas grandi i e botonnan di propina un tiki mas chikitu, pa tur kos keda riba pantaya.

Na un instalashon nobo e kashi ta pagá: e ora e boton chikitu abou banda di Manda òrdu i un pantaya di kobra ku botonnan normal. Bo ta preferá grandi? Den Ajustenan → Negoshi, mesora bou di tema kla/skur, marka Boton grandi "Kobra". Un kaha ku tabata na uso kaba ta keda ku loke e tabatin. E skoho ta konta pa tur kaha i tablèt di e negoshi.

Pone produkto komo "kabá" (bendí kompletamente)

Den e pantaya di òrdu tur hende por primi largu riba un produkto (òf klek ku e boton drechi di mouse) i skohe Kabá (bendí tur). E produkto ta bira gris i no por pidi e mas riba ningun kaha. Na e mesun manera bo ta pon'é bek ku Disponibel atrobe. Kada kambio ta keda den e registro. E atministradó ainda por hasi esaki tambe na Konfigurashon → Produktonan. E server di kaha tambe ta rechasá un produkto ku ta riba "kabá" ("Cola" a kaba), asina tambe for di un tablet ku no a haña e kambio ainda òf òrdunan wardá offline; e tablet ei ta mustra anto "No por a manda".

Pantaya di kushina (KDS)

Banda di (no na lugá di) e printernan di bon di òrdu, kushina òf bar por usa un pantaya. Habri riba un tablet/pc den kushina http://<kassaserver>:3000/keuken, drenta ku un pin i skohe e stashon: esakinan ta e mesun nòmbernan ku e printernan (kushina, bar, ...), pues riba e pantaya ta para eksaktamente loke lo a sali riba e bon di òrdu ei. "Tur" ta mustra tur stashon.

• Un bon pa kada òrdu, esun mas bieu promé, ku mesa/pa hiba, number i kuantu tempu e ta warda kaba (oraño despues di 10, kòrá despues di 20 minüt).
• Kursonan ta para separá; un kurso ku no a wòrdu yamá ainda ta gris ku "TA WARDA pa yama". Stornonan ta tachá.
• Primi riba un liña pa marké kla, òf riba Kla pa henter e bon. E personal ta haña anto den e bara ariba "Kushina: Mesa 5 ta kla". Ku Konfigurashon → Negoshi → Pantaya di kushina → Zonido pa e personal (standard desaktivá) e kaha ta duna tambe un pip ("ding-dong", sin archivo di zonido). E navegador ta permití zonido solamente despues di e promé toke riba e pantaya; subi e volume di e tablet.
• Trese bek ta mustra loke a wòrdu marká kla den e último ora; loke bo a kita pa eror por bin bek asina.

E pantaya ta aktualisá su mes mesora. Bon di òrdu ta sigui imprimí; esnan ku no ta usa e pantaya no ta nota nada.

Pantalla di kushina: manda, órden i kurso

Konfigurashon → Printernan → Pantalla di kushina. Kada parti ta aktivá apart, standard desaktivá; desaktivá ta warda tur kos.

• Manda entre stashonnan, por ehempel friu → kayente → entrega. Pa kada stashon bo ta pone un siguiente stashon fiho; riba e bon tin anto un boton → kayente (i semper Manda pa… pa skohe otro stashon). Solamente e reglanan habrí di e stashon ei ta bai. Un stashon no mester tin printer: yena stashonnan manera entrega na Stashonnan sin printer. Kla (i e aviso na atendensia) ta bin solamente na e último stashon. Riba "Tur" ta pará serka un regla mandá unda e ta awor. Kada paso ta pará serka e regla i den e logbook.
• Reordená: hala bon (mouse) òf move nan ku ◀ ▶ (touchscreen). E órden ta konta pa kada stashon i pa tur pantalla di e stashon ei; bon nobo ta bin na final.
• Siguiente kurso for di pantalla di kushina: serka un bon ku un kurso ku ta warda tin Pidi kurso 2. Atendensia ta haña anto "Kushina ta pidi kurso 2 pa Mesa 5" (ku zonido) i ta yama manera semper; riba e pantalla di kushina ta pará "Kurso 2 pidí · n min" te ora e kurso a wordu yamá. Òf skohe Yama: anto e pantalla di kushina ta yama e kurso mes, ku e bon di trabou "YAMA KURSO 2", meskos ku e boton den e kas.

Printer di kushina pagá òf sin pantaya di kushina

E kaha semper ta sigui traha, tambe si e printer di kushina òf di bar ta paga (òf e papel a kaba, òf e kabel ta lòs) i tambe sin pantaya di kushina:

• Pidi semper ta sigui. E liñanan ta para mesora riba pidí, e kuenta ta korekto i bo por paga normal. E printernan ta wòrdu yamá tur na mes momento i kada printer ta haña maksimo mas o ménos 4 sekonde: un printer ku ta paga no ta laga e otronan (ni e personal) warda largu.
• Fila di imprenta. Un bon di òrdu ku no por a wòrdu imprimí ta bai den e fila di imprenta. E server di kaha ta purba atrobe kada 30 sekonde, pa un kuarto di ora; apenas e printer traha atrobe e ta sali, ku ariba IMPRIMÍ DESPUES. Si un siguiente bon riba e printer ei logra atrobe, e bonnan ku ta warda ta sali mesora despues.
• Despues di un kuarto di ora e ta stop di purba atrobe outomátikamente; Imprimí atrobe awor ainda ta posibel.
• Pantaya di kushina. Si e òrdu ta riba e pantaya di kushina, kushina ta mir'é einan tambe ora e printer ta paga. Esnan ku no ta usa pantaya di kushina no ta pèrdè nada: e kaha nunka ta warda riba "Kla" di kushina.
• E fila ta solamente den e memoria di e server di kaha (despues di un reinisio e ta bashí).
• Tambe e resibu di kaha: si esei no logra, a paga tòg (e kaha ta avisá "imprimí a faya") i despues bo por imprimí un kopia na Resibunan.

Kurso (entrada, plato prinsipal ...)

E botonnan di kurso ta aparesé solamente ora nan ta nesesario: asina tin un menú (produkto kompuesto) riba e òrdu, òf ora tin algu kaba den kurso 2 te 4. Ku produktonan normal, manera un cola, bo no ta mira nan i tur kos ta bai mesora pa kushina. No tin nada pa konfigurá.

Bou di e lista di òrdu ta para Kurso 1 2 3 4. Standart kurso 1 ta aktivá i tur kos ta traha manera semper: "Manda òrdu" ta manda tur kos mesora pa kushina, sin título di kurso riba e bon di òrdu. Si bo skohe kurso 2 (òf mas haltu) promé ku bo primi produktonan, anto:

• nan ta bai kaba ora di "Manda òrdu" pa kushina, bou di "-- Kurso 2 · TA WARDA pa yama --", pa kushina por prepará;
• den e lista di òrdu ta para "Kurso 2 · ta warda" ku un boton Yama;
• ora bo Yama, kushina ta haña un bon " YAMA KURSO 2 " ku loke mester traha awor.

Kurso 1 semper ta bai mesora. Si kurso 2 a wòrdu yamá kaba, un plato ku bo pidi despues den kurso 2 tambe ta bai mesora.

Alergeno pa produkto

Standart desaktivá: anto no ta mira alérgeno na ningun kaminda. Aktivá via Konfigurashon → Negoshi → Yena i mustra alérgeno pa produkto.

• Konfigurashon → Produktonan: pa kada produkto marka e 14 alérgeno di EU (glúten, krustáseo, webu, piská, pinda, soya, lechi, nuez, seleri, mostaza, semia di sesam, sulfito, lupino, molusko). Den e lista di produkto e abreviashonnan ta para tras di e nòmber.
• Pantaya di òrdu: riba kada boton di produkto e abreviashonnan ta para chikitu (p.e. Gl Me), i e boton ⚠ Alérgeno den e bara di grupo ta mustra pa kada produkto di e grupo skohí e alérgenonan kompleto, ku e splikashon di e abreviashonnan.
• Kambionan di alérgeno ta drenta den e registro (bieu → nobo). Si e opshon ta desaktivá, alérgenonan yená kaba ta keda wardá.

All-you-can-eat

Standart desaktivá. Aktivá na Konfigurashon → Negoshi → All-you-can-eat (solamente e atministradó). Bo ta traha un òf mas paket, p.e. Piská, Karni i Sushi, kada un ku:

• un nòmber (ta sali riba e resibu: "Piská adulto", "Piská mucha");
• un preis pa adulto i pa mucha (BTW inkluí) i e tarifa di BTW (standart NL LAAG, BE B);
• e kuminda ku ta pertenesé na dje (€ 0): henter grupo di produkto i/òf produkto individual (tambe for di otro grupo, p.e. papita frita na Piská i tambe na Karni);
• un límite di tempu na minüt (0 = ningun);
• ronda: maksimo tantu kuminda pa persona pa ronda (0 = sin límite) i minimo tantu minüt entre dos ronda (0 = ningun);
• un rekargo pa desperdisio pa pida (0 = ningun).

Ku ↑ ↓ bo ta pone e órden. Esei ta konta si un kuminda ta pertenesé na mas ku un paket: anto e ta bai na esun mas ariba ku e grupo a skohe. Eliminá ta kita un paket pa mesanan nobo; mesanan ku ta kore kaba ta keda ku nan liñanan di preis (ménos persona ainda por, mas no).

Na mesa:

• Riba e pantaya di òrdu, ariba di e bon tin + All-you-can-eat. Skohe pa kada areglo e kantidat di adulto i mucha; meskla ta permití (p.e. 2× Piská i 2× Karni). E preis ta bini komo liña riba e kuenta; nan no ta bai kushina. E kantidat di persona di e grupo ta bira e total ku ta partisipá (si e kasa ta registrá persona).
• E bara ta mustra pa kada paket: persona, tempu ku ta resta (kòrá si e tempu a pasa), kua ronda e ta ku e maksimo, i kuantu tempu ainda te e siguiente ronda. Kuminda ku ta pertenesé na dje ta para riba e botonnan komo AYCE i riba e resibu ku e etiket AYCE pa € 0. Tur loke no ta pertenesé na ningun paket skohí (bebida, dessert ...) ta keda pagá manera normal.
• Manda òrdu: kada biaha "Manda òrdu" ku kuminda grátis ta un ronda, pa paket (solamente e paketnan ku tin kuminda di nan aden). Loke a wòrdu primí offline i mandá despues no ta wòrdu bloká.
• Kambia: ahustá kantidat pa paket. Ménos persona ta konta komo storno (derecho "storno"). Pone un paket na 0 (òf Stop pa tur) ta posibel tanten ainda no tin kuminda di e paket ei riba e kuenta.
• Rekargo (solamente si un paket skohí tin rekargo pa desperdisio): skohe kantidat (i e paket, si tin mas di un); "Rekargo pa desperdisio × kantidat" ta bin riba e kuenta.
• Paga, parti, deskuento i e resibu ta traha manera semper: e preisnan di paket, e rekargo i e bebida ta liña normal ku nan mes BTW.
• Si e atministradó desaktivá all-you-can-eat miéntras tin grupo ainda ta kome, kuminda primí nobo ta kosta atrobe e preis normal; loke ta riba e kuenta kaba ta keda.
• Den e tienda online (opshonal, standard desaktivá): ku Tambe ora di ordená na mesa via e kódigo QR (tienda online) e kliente ku ta ordená na un mesa ku un paket ta mira e kumindanan ku ta pertenesé n'e paket komo Inkluí pa € 0, ku ariba e situashon (persona, ronda, tempu). Kada òrdu ta un ronda, ku e mesun reglanan ku Manda òrdu; tin muchu, muchu trempan òf muchu lat, e tienda online ta rechas'é mesora. Bebida i otro kuminda e kliente ta paga normal; tur kos ta bai riba e kuenta di e mesa. Desaktivá = e tienda online ta kobra e preisnan normal, manera ántes.

Vale di regalo

Dos switch na Konfigurashon → Negoshi → Bon di regalo:

• Bon di regalo komo metodo di pago ora di paga: standart aktivá, manera e tabata semper. Desaktivá = e boton Bon di regalo no ta aparesé ora di paga (ni na Sèn bek via na un retorno), i e server di kaha ta rechasá pago ku bon di regalo.
• Bende bon di regalo ku saldo: standart desaktivá. Aktivá:
  • Riba e pantaya di òrdu tin e boton Bon di regalo: skohe e suma (€ 10, 25, 50, 100 òf otro suma) i laga e kaha traha un kòdigo, òf skan e kòdigo di un karchi imprimí di antemano. E bon ta bin komo liña riba e kuenta (kòdigo di BTW BON: no ta benta, no tin BTW, no ta bai kushina). Einan bo por konsultá saldo tambe pa un kliente.
  • Despues di paga e bon ta aktivá i e printer di resibu ta imprimí un bon di regalo ku e suma, e kòdigo i un kòdigo QR.
  • Usa: ora di paga skohe Bon di regalo i skan òf tek e kòdigo (boton Saldo ta mustra e saldo). E suma ta bai for di e saldo. Si e saldo ta ménos ku e kuenta, henter e saldo ta bai komo pago parsial i bo ta paga e resto ku karchi òf kontant. E saldo por wòrdu usá na partinan.
  • Laga kòdigo bashí = bon di regalo sin kòdigo, manera promé (p.e. un bon bieu di papel).
  • Raport → Bon di regalo (derecho Maneha bon di regalo, standart manager i atministradó): buska riba kòdigo, saldo habrí, historia pa bon, bloká (pèrdí/hurtá) i korigí saldo ku un motibu. Esaki ta drenta den e registro.
  • Raportnan: bon di regalo bendí no ta konta komo benta i ta para apart (Bon di regalo bendí); e sèn risibí sí ta para na e metodonan di pago. Loke ta wòrdu pagá ku un bon di regalo ta benta normal (ku BTW) na e metodo di pago Bon di regalo.
  • Kontabilidat: bon bendí ta bai krédito i bon usá débito riba e kuenta Bon di regalo (saldo di kliente).
  • Un bon di regalo bendí por bai bek via Resibunan → Retorno, tanten e no a wòrdu usá ainda (saldo = balor). Despues di e retorno e bon ta anulá (saldo 0, bloká; ta para den e historia di e bon). Si e a wòrdu usá kaba (parsialmente), bo ta pone e saldo na 0 na Raport → Bon di regalo i bo ta paga e resto bek apart. Deskuento riba un bon di regalo no ta posibel.

Krédito rekargabel (opshonal)

Pa klup, kantina di deporte, sentro di hubentut i evento: un vale di regalo ku saldo ta bira un karchi rekargabel. Aktivá na Konfigurashon → Negoshi → Krédito rekargabel, bou di e valenan di regalo (standard desaktivá; ta funshoná solamente si Bende valenan di regalo ku saldo ta aktivá).

• Karchi òf brasalète: bende un vale di regalo ku Karchi printá di antemano i skan e karchi (un lektor NFC/RFID ku ta funshoná komo teklado, òf un kódigo di bara). E número di e karchi ta e kódigo e ora ei; kuné e kliente ta paga meskos ku ku un vale di regalo.
• Rekargá: pantalla di òrdu → Vale di regalo → Rekargá krédito: skan e vale òf karchi i yena e monto. E ta bai komo liña riba e kuenta (kódigo di BTW BON: no ta benta, no tin BTW, meskos ku un vale di regalo bendí) i despues di kobra e ta riba e saldo. Den e historia di e vale ta para Rekargá.
• Saldo máksimo pa vale òf karchi (standard € 500, por pone te € 5.000).
• Paga restu bèk (marka, standard desaktivá; derecho Manehá kashi di plaka): despues di Konsultá saldo ta aparesé Paga restu bèk. E saldo ta bai na € 0 i e monto ta aparesé komo sèn for di e kashi riba e rapòrt X i Z (Tegoed terugbetaald …).
• Un rekarga por bai bèk via Resibunan → Retorno miéntras e saldo ta ainda mínimo e monto ei; e vale òf karchi ta keda válido.
• Rekargá na e kiosko (opshonal): wak Kiosko di outoservisio.

Valenan di kuminda

Solamente pa negoshi na Bélgika, standard desaktivá: Konfigurashon → Negoshi → Kobra → Valenan di kuminda. Vale di kuminda ta un benefisio salarial: e dunadó di trabou ta pone nan riba un karchi di e trahadó (Edenred, Monizze òf Pluxee). E kliente ta paga kuné riba e terminal di pago normal; no tin mester di konekshon ku e emisornan.

• Aktivá: na kobra tin e boton Vale di kuminda. Skohe e emisor (solamente e emisornan ku e negoshi ta aseptá) i laga e kliente tene e karchi kontra e terminal di pago, meskos ku ora di paga ku karchi. Sin konekshon ku e terminal: e kliente ta paga riba e terminal di pago mes i bo ta tok Kobra.
• Sin propina i sin sèn chikí ku vale di kuminda. Si e saldo ta muy abou, e kliente ta paga e resto otro manera (e kuenta ta keda habri te ora tur kos ta pagá).
• Solamente pa sierto kategoria (opshonal, p.e. kuminda pero no alkohol): e ora ei ku vale di kuminda por paga máksimo e monto di e produktonan ei riba e kuenta. E pantaya di kobra ta bisa kuantu; e resto e kliente ta paga otro manera.
• Riba e resibo: Vale di kuminda Pluxee (ku e emisor despues).
• Rapòrt Z i rapòrt X: pa kada emisor un liña propio (Vale di kuminda Edenred, … Monizze, … Pluxee).
• Kontabilidat: pa kada emisor un kuenta di buki general propio (Valenan di kuminda Pluxee (pa risibí) etc., standard 416100, 416200 i 416300), pasobra e plaka ta bini di e emisor i no di e banko di e terminal di pago.
• Nesesario: un akuerdo ku kada emisor kuyo vale bo ta aseptá, i un terminal di pago ku ta aseptá e karchinan aki (pregunta esei na e proveedor di e terminal di pago).

Moneda stranhero

Kobra kèsh den otro moneda, por ehèmpel turista britániko òf merikano, òf den e region di frontera ku frank suiso. Standard desaktivá: Konfigurashon → Negoshi → Kobra → Moneda stranhero. Agregá e monedanan (CHF, CZK, DKK, GBP, HUF, NOK, PLN, SEK, TRY, USD) ku un tipo di kambio pa kada moneda: kuantu euro bo ta kobra pa 1 unidat (p.e. 1 GBP = € 1,15).

• Yená bo mes: un tipo di kambio fiho; ahustá esaki bo mes ora e kambia.
• En bibo (ECB): e tipo di kambio di dia di Banko Sentral Oropeo (tipo di kambio di referensia, tur dia di trabou rond di 16:00; grátis, sin kuenta). Ku un rekargo den porshento (0-20) e tipo di kambio ta baha asina tantu, pa e negoshi no paga e kambio su mes. E kaha ta buska e tiponan di kambio su mes si nan ta mas bieu ku 6 ora; Aktualisá awor ta buska nan mesora. Sin internet e último tipo di kambio ta keda.
• Aktivá: ora di kobra tin e boton Moneda stranhero. Skohe e moneda; e kaha ta mustra kuantu e ta den e moneda ei. Yena kuantu e kliente ta duna: e kaha ta kalkulá esei i ta duna e sèn chikí na euro. Si e kliente no ke nada bèk, marka Sèn chikí ta propina: e sèn chikí ta bin komo propina riba e resibu, na Bèlgika den e moneda ei (GKS 2.0, UC296).
• Si e kliente ta duna ménos ku e monto kompleto, ta un parti; e resto e ta paga otro manera.
• Riba e resibu: e moneda, e monto i e tipo di kambio, i e sèn chikí na euro.
• Rapòrt X i Z: pa kada moneda un liña separá (Moneda stranhero GBP, na euro), i serka e kashi di plaka kiko tin den e kashi den e moneda ei. E sèn chikí na euro ta bai for di e plaka ku ta warda den e kashi; e monedanan mes bo ta konta aparte.
• Kontabilidat: ta konta komo kèsh (kaha), na euro.

Botonnan ekstra na òrdu i kobra

Botonnan pa loke no tur negoshi mester. Tur ta desaktivá standart; aktivá pa boton na Konfigurashon → Negoshi → Òrdu i kobra (derecho Konfigurá negoshi, pago i printer). Desaktivá = e boton no ta na ningun kaminda den e kaha i e server di kaha ta rechasá e akshon. Na Hulanda tur kos ta traha sin kaha preta; na Bèlgika un boton ta traha solamente ora e funshon ei a wòrdu tèst ku e kaha preta (serka e boton ta pone si esei no ta e kaso ainda).

Ora di habri un mesa:

• Registrá kantidat di persona: e pregunta "Kuantu persona?" na un mesa liber, e personanan riba e plano i den e pantaya di òrdu, i invitadonan den e rapòrtnan. Mira Kantidat di persona.

Ora di òrdu (pantaya di òrdu, pa loke bo tok despues):

• Suma produktonan meskos (sin boton, standard aktivá): si bo primi riba e mesun produkto atrobe (mesun opshonnan, ainda no a manda òrdu), e kantidat ta subi en bes di un liña nobo: 4 Cola riba un liña ku e preis biaha 4. Ku − un ta bai afó atrobe, tambe si a manda òrdu kaba (storno di un). Ku un nota, stul òf pa hiba, e ta keda un liña apart; loke a manda òrdu kaba ta keda un liña apart (un ronda nobo).
• − i + (promé ku e preis riba kada liña): − ta kita un, + ta pone un mas (mesun produkto, opshon i nota; si Suma produktonan meskos ta pagá, un liña nobo). Ainda no ordená i na 0: e liña ta bai. Ordená kaba: un ménos ta un storno, e liña ei ta keda ku un strepi dor di dje (pa kushina i e raportnan); un mas ta bira un liña nobo ku ainda mester wòrdu ordená. Primi riba e preis mes no ta kita nada mas. Na un menu solamente −.
• Pa hiba (solamente kome aki): e invitado ta hiba e produkto aki, p.e. un boter di awa òf un dessert. E liña ei ta haña e BTW di pa hiba (na Bèlgika label C), e resto di e kuenta e BTW di kome aki. Riba e resibu ta pone hiba serka e liña.
• Stul (na un mesa): tok sigui pa stul 1, 2, 3 ...; e liñanan ta haña e number di stul ei (tambe riba e bon di kushina). Na Bèlgika kada liña ta bai ku e sentro di kosto di e stul (CHAIR, UC4123) pa e kaha preta. Un biaha mas despues di stul 12 = atrobe sin stul.
• Tuma bèk: e siguiente produkto ta bin ku -1, p.e. un boter òf glas bashí (depósito). Esei ta posibel solamente pa produktonan ku Por bolbe (depósito) (Konfigurashon → Produktonan). Si henter e kuenta ta negativo (solamente depósito bèk, sin benta), Kobra ta bira un debolbementu: kèsh bèk òf ku pin (debolbé riba e terminal mes). Na Bèlgika komo debolbementu (REFUND, UC4108 i UC4114).
• Kambia SPV: e invitado ta paga un produkto òf menu ku un single purpose voucher (un vale djis pa e produkto ei, p.e. "1 menu all-in"). Tok riba Kambia SPV i despues riba e produkto riba e resibu: e ta bin ku -1 (mesun preis i BTW, na un menu ku e partinan), ku SPV serka. No ta bai kushina; kita ta posibel manera normal. Un produkto di vale bo ta bende di antemano komo produkto normal; marka SPV (vale) na Konfigurashon → Produktonan. Na Bèlgika e liña ta bai na e benta komo VOUCHER pa e kaha preta (UC271).
• Deduší avans: wak aki bou.
• Preis habrí (no ta boton, pa produkto): na un produkto ku Preis habrí e kaha ta puntra e preis, p.e. e plato di dia òf un avans.

Ora di kobra:

• Kobra direkto sin bon di trabou (no ta un boton): standart Kobra ta manda òrdu promé di loke ainda no a wòrdu ordená, pa kushina i bar semper haña nan bon (wak E boton Manda òrdu). Aktivá: loke bo kobra mesora sin primeru primi Manda òrdu no ta haña bon di trabou, por ehempel na bar kaminda bo mes ta kohe e kos. Loke a wòrdu ordená kaba no ta kambia.
• Kobra separá (na un mesa, na Parti kuenta): skohe kiko un invitado ta paga awor, tambe un parti di un liña (½ pa mitar boter). Esei ta bira un parti propio ku bo ta kobra mesora; e resto ta keda riba e kuenta, sin parti e kuenta promé òf move e pa un otro grupo. Deskuento na porsentahe riba henter e resibu ta bai kuné proporshonalmente. Bèk sin paga = tur kos atrobe riba e kuenta. Na Bèlgika e benta ta riba e lugá di e mesa, sin kambio di mesa (UC4103bis, UC4104).
• Invitado a bai sin paga (derecho Sera sin pago, standart solamente gerente i atministradó): e kuenta ta wòrdu sera komo benta sin pago, ku un motibu den e buki di registro. Riba e reporte X i Z i den e resumen di dia e ta komo No pagá (invitado a bai); den e diario pa inkobrabel (standart 4985 / 643000). Na Bèlgika un benta sin pago (UC4109).

Despues (Resibunan):

• Korigí preis (derecho Korigí preis di un resibu, standart solamente gerente i atministradó): e preis di un resibu kobrá no tabata korekto, p.e. 50% deskuento en bes di 5%. E kaha ta traha un resibu nobo sin mesa ku e liñanan di e resibu bieu bèk (negativo, kontra loke a wòrdu pagá e ora ei) i e mesun produktonan atrobe kontra e preis normal. Duna e deskuento korekto einan i kobra e diferensia (òf paga bèk si e preis nobo ta mas abou). E resibu bieu ta keda manera e tabata; un biaha pa resibu, i no si algu a bai bèk kaba. Na Bèlgika e liñanan bieu ta bai kuné komo CORRECTION (UC4116).

Kódigo: apps/pos-server/src/lib/kassaopties.ts, routes/kassaopties.ts; pantaya KassaOpties.tsx. Buki di registro: Konfigurashon kambiá, SPV kambiá, Korigí resibu, No pagá.

Deduší avans

Un avans (pago di antemano, p.e. pa un fiesta òf un reservashon) bo ta bende komo un produkto normal ku Avans aktivá (Konfigurashon → Produktonan; semper tin un preis habrí). Traha un pa kada tarifa di BTW si e avans mester ta pa tarifa (p.e. Avans kuminda i Avans bebida), òf un produkto si e ta un parti di e oferta. E invitado ta paga e avans di antemano i ta haña un resibu.

Aktivá: Konfigurashon → Negoshi → Òrdu i kobra → Deduší avans (standart desaktivá). Na e kobro final bo ta tok riba Deduší avans den e pantaya di òrdu i yena e number di resibu di e avans. E kaha ta pone e liñanan di avans di e resibu ei ku un kantidat negativo riba e kuenta (mesun produkto, preis i BTW). Loke a wòrdu deduší kaba, no por un biaha mas. Si e avans ta mas ku e kuenta, e invitado ta haña e diferensia bèk (debolbé). Na Bèlgika e liñanan deduší ta bai komo debolbementu (REFUND) pa e kaha preta (UC4110, UC4111, UC4113). Buki di registro: Avans deduší.

Bòn pa e-mail

Standart desaktivá. Aktivá via Konfigurashon → Negoshi → Resibu tambe pa e-mail.

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

Reinisiá e kaha despues di yena esaki. Despues, na Paga ta aparesé e kampo Manda resibu pa e-mail tambe (opshonal): laga bashí = imprimí so manera semper; yena un adrès di e-mail = e mesun resibu (ku spesifikashon di BTW i reglanan fiskal) ta bai tambe pa e-mail na e kliente, ku e nòmber di e negoshi komo remitente.

• E adrès di e-mail no ta wòrdu wardá; den e registro ta para solamente "resibu N mandá pa a***@domein.nl" i si e a logra.
• Si manda e-mail no logra (p.e. datonan di login robes), e resibu ta pagá i imprimí normal; e mensahe ta bisa kiko a bai robes.
• No ta posibel na un pago parsial (parti kuenta): e resibu ta bin na e último pago, pues ei bo ta yena e adrès.
• Manda despues: na Resibunan, banda di un resibu tin e boton Manda e-mail (derecho Imprimí kopia di un resibu). Esei ta manda e resibu ku KOPIA riba dje, meskos ku un kopia imprimí (na Bélgica registrá komo kopia).
• No tin mester di paketnan ekstra: e kaha mes ta papia ku e server di e-mail (STARTTLS riba 587, TLS riba 465).

Reservashon

Aktivá na Konfigurashon → Negoshi → Reservashon (standard desaktivá). Einan bo ta konfigurá tambe kuantu minüt di antemano un mesa reservá ta aparesé riba e plano (standart 60) i e durashon standart di un reservashon (standart 120 minüt).

• Boton Reservashon den e bara ariba: resúmen pa dia (◀ ▶), ku kantidat di reservashon, persona i no-show. + Reservashon nobo: nòmber, telefòn, e-mail, persona, fecha, ora, durashon, mesa (por despues) i komentario. Ta e personal ta hasi e reservashon; reservá online no tin (ainda).
• Si tin un reservashon kaba riba e mesun mesa den e periodo ei, e kaha ta avisá esei; "Warda tòg" ta posibel.
• Konfirmashon pa e-mail (marka, òf despues "Manda e-mail") si tin un adrès di e-mail i un server di e-mail (SMTP_HOST, mira Resibu pa e-mail).
• Riba e plano un mesa liber reservá ta pòrpi ku "R 19:30 Jansen (4)". Si bo primi riba dje: "Jansen a yega" ta habri e mesa ku 4 persona i "Jansen" komo nòmber di grupo; "Otro kliente" ta habri e mesa normal.
• Den e resúmen: A yega (ta habri e mesa; sin mesa bo ta skohe un promé), Kambia, No-show, Kanselá i Pone bek. Tur kos ta keda den e registro.
• Reservashon di plataforma online: wak Plataforma di reservashon aki bou.

Konekshon di kaha ku TheFork: mesa habri ora di yega, kuenta ta bai bek

Ku e POS-API di TheFork e kaha ta traha huntu ku TheFork Manager (standard desaktivá), ademas di buska e reservashonnan aki riba. Pone na serka Konfigurashon → Plataforma di reservashon → Konekshon di kaha ku TheFork; ta bai via e portal di maneho.

• Si bo pone un invitado den TheFork Manager riba Yegá òf Na mesa, den kaha e mesa ku mesun nòmber ta habri, ku kantidat di invitado i un nota: nòmber, alergia i dieta, pago adelantá, oferta/deskuento i punto (Yums). Si tin un òrdu habrí kaba riba e mesa ei, e ta wòrdu konektá. No tin mesa ku e nòmber ei: un aviso, i den Plataformanan bo ta skohe e mesa.
• Despues di paga e kuenta ta bai na TheFork (total i liña ku nòmber, grupo di produkto, kantidat i suma); TheFork ta pone e reservashon anto riba Bai. Ora di paga partí, un kuenta ku e total. Si e no logra, e kaha ta purba di nobo kada kuarto di ora (dos dia), òf ku Manda di nobo den Plataformanan.
• Konektá: e kaha ta mustra un kódigo di konekshon; yena esaki den TheFork Manager (Integrashon → kaha). E id di restaurant di TheFork (Customer-id) e atministradó ta yena, òf e ta bini su mes ku e promé òrdu.
• Marka: habri mesa outomátikamente, nòmber, alergia i pago adelantá komo nota, kuenta pa TheFork.
• Kondishon: Pin Voordeel tin e yabi di API di TheFork (solamente pa partner) i a registrá e kaha einan komo POS (boton den e portal di maneho); TheFork ta pone e konekshon live despues di un seshon di prueba.

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

Lista di espera pa walk-ins

Pa kliente sin reservashon ku ta warda pa un mesa. Aktivá na Konfigurashon → Negoshi → Lista di espera (walk-in) (standard desaktivá). Ta visibel solamente si e SMS via CM.com ta konfigurá; si no, e lista di espera no ta aparesé na ningun kaminda den e kaha (ni den e konfigurashon). E ta traha separá di e reservashonnan: tambe si nan ta desaktivá. Einan tin tambe e teksto di e SMS (bashí = "Halo {naam}, bo mesa na {zaak} ta kla. Por fabor reportá na e personal?"; {naam}, {zaak} i {personen} ta wòrdu yená).

• Boton Lista di espera den e bara ariba, ku e kantidat di hende ku ta warda (oraño si tin hende ta warda). + Na lista di espera: nòmber, telefòn (pa e SMS), persona, e tempu di espera mensioná i un deseo (teras, stul di mucha).
• E lista ta na órden di registrashon, ku kuantu tempu un hende ta warda kaba (kòrá si e ta dura mas largu ku mensioná) i ariba e kantidat di hende ku ta warda, persona i e tempu di espera promedio di awe.
• Si e SMS no logra, e motibu ta para banda di dje. Manda SMS atrobe ta posibel.
• Pone sinta: skohe e mesa; e kasa ta habri e ku e kantidat di persona (si e kasa ta registrá persona) i e nòmber komo nòmber di grupo (meskos ku un reservashon ku ta yega).
• Bai (a bai òf a kansela) i Pone bek. Bou di e lista ta para ken a sinta òf a bai awe, ku kuantu tempu nan a warda.
• Privacidat: number di telefòn ta wòrdu borá despues di un dia; ken ku ainda ta riba e lista despues di 12 ora, ta sali outomátikamente. Registrá, yama (ku solamente e último 3 sifranan di e number) i sinta ta keda den e registro.
• Dikon no na Reservashon? Un reservashon ta pa despues (fecha, ora, mesa di antemano); e lista di espera ta pa awor (órden, tempu di espera, SMS ora e mesa ta liber). Pesei e tin su mes switch i boton, ku e mesun "habri mesa" manera na un reservashon.
• Online riba e lista di espera (opshonal, standard desaktivá; solamente ku e tienda online): ku Kliente por registrá nan mes tambe via e tienda online e tienda online tin Lista di espera (i tin un kódigo QR p'e na porta, den e maneho di tienda online na Mesanan i QR). E kliente ta yena nòmber, telefòn, persona i un deseo i ta mira su lugá live. Den e kaha e ta den e lista ku online; yama, sinta i bai manera semper, i e kliente ta mir'é tambe riba su telefòn (e por kansela ei tambe).

Karchi di kliente / punto di spar

Aktivá na Konfigurashon → Negoshi → Karchi di kliente / punto (standard desaktivá; e ora bo no ta mira nada di dje na ningun parti). Einan bo ta konfigurá tambe: punto pa euro (0 = solamente karchi di stempel), despues di kuantu punto tin un rekompensa i kuantu euro deskuento e rekompensa ei ta.

• Na kaha, ariba e resibu ta para "+ Karchi di kliente": buska e kliente riba nòmber òf number di telefòn, òf traha un kliente nobo (nòmber, opshonal telefòn i e-mail). Despues e nòmber ku e saldo di punto ta para riba e resibu.
• Kambia punto: ku sufisiente punto "Kambia 100 punto: € 5 deskuento"; ku un karchi di stempel yen "Kòfi Grátis" (e kòfi ei mester ta riba e resibu). Esei ta bira un liña di deskuento; tur hende por kit'é atrobe.
• Punto i stempel ta wòrdu agregá i kitá solamente ora di paga: punto riba e suma despues di deskuento (sin bon di regalo bendí), stempel pa kada pida di un produkto ku karchi di stempel (e produkto grátis no ta konta).
• Riba e resibu di kaha: spar, kambiá, saldo i e estado di e karchinan di stempel.
• Raport → Kliente (derecho Maneha karchi di kliente): buska kliente, kambia datonan, korigí punto (ku motibu), historia, i eliminá (AVG: nòmber, telefòn i e-mail ta bai; e historia ta keda anónimo). Abou e karchinan di stempel pa produkto (p.e. 10 kòfi = 1 grátis).
• Un retorno no ta kansela punto spar outomátikamente; korigí nan si ta nesesario na Raport → Kliente.
• Karchi di kliente ku un number (opshonal): na Reporte → Klientenan → (kliente) yena e number di karchi (òf skan e karchi den e kampo ei). Ku e skaner di kódigo di bara, un skan di e karchi ei ta konektá e kliente na e resibu, na e kasa i na e kiosko. Buska riba e number di karchi tambe ta posibel na + Karchi di kliente.

Perfil di kliente: VIP, deseonan di dieta i preferensianan (opshonal)

Aktivá na Konfigurashon → Negoshi → Perfil di kliente, bou di e karchi di kliente (standard desaktivá; ta funshoná solamente si e karchi di kliente ta aktivá). Despues:

• Riba e pantaya di òrdu, bou di e kliente konektá, ta para "+ Perfil di kliente": marka VIP, skohe deseonan di dieta (vegetariano, vegano, peskatariano, halal, kosher) i alergianan (e 14 alergeno), i skirbi preferensianan (p.e. "mesa fiho banda di bentana", máksimo 300 karakter). Despues nan ta para na e kliente riba e pantaya di òrdu, alergianan na kolo kòrá. Bo por kambia nan tambe na Reporte → Klientenan → (kliente) → Perfil di kliente.
• Si bo primi un produkto ku un alergeno di e kliente (wak Alergeno pa produkto), e kasa ta puntra promé si e mester bai tòg. Solamente loke ta yená na e produkto; si bo tin duda, semper puntra e kushina.
• Un VIP ta haña un ★ riba e plano: na un kuenta habrí i na e reservashon mustrá di e kliente ei. Ora e klientenan di un reservashon yega, e kasa ta konektá e kliente di e reservashon ku e kuenta.
• Deseonan di dieta i alergianan (i VIP) ta bai riba e bon di kushina pa kushina i bar: GAST: VIP · Vegetarisch · allergie: Noten.
• Deseonan di dieta i alergianan ta datos di salú: yena nan solamente ku pèrmit di e kliente. Den e registro ta para solamente ku e perfil a kambia, no e deseonan mes. Kita e kliente ta kita e perfil di kliente tambe.

Faborito / boton lihé

Standart desaktivá. Konfigurashon → Negoshi → Favorito / boton rápido:

• Mas bendí: na prinsipio di e bara di grupo e boton ★ Favorito ku e 12 produktonan ku a bende mas den e último 14 dianan (ta aktualisá outomátikamente). E pantaya di òrdu ta habri riba e favoritonan.
• Skohe bo mes: riba e pantaya di òrdu primi largu riba un produkto (òf klek drechi) i skohe ★ Favorito (boton rápido); un biaha mas = kita. Derecho Maneha produkto. Tur kaha ta mira esaki mesora.
• Primi, opshon, menu, happy hour i "kabá" ta traha riba e favoritonan eksaktamente meskos ku den e gruponan normal.

Un ronda mas

Riba e pantaya di òrdu tin e boton ↻ Un ronda mas (apenas tin algu riba e kuenta, asta si no a pidi e ainda). Un toke ta pone e último ronda (tur loke a bai na un biaha ku "Manda òrdu", òf loke bo a primi djis awor) un biaha mas komo liña nobo; despues simplemente Manda òrdu. E preisnan ta esnan di awor (tambe happy hour).

• Primi largu (òf klek drechi): skohe bo mes. Ku ◀ ▶ bo ta bai na rondanan anterior, pa produkto aktivá/desaktivá (p.e. kita marka di e kuminda) i e kantidat ku − / +. Opshon i komentario ta bai kuné.
• Produkto ku a kaba i menu no ta bai kuné (menu bo ta primi apart). Ta traha tambe sin konekshon.
• E liñanan ta wordu agregá manera nan ta riba e kuenta: ku Suma produktonan meskos kendí, un liña pa kada produkto (2 Cola); pagá, kada liña separá (2 biaha 1 Cola).

Tempu na mesa riba e plano

Riba kada mesa okupá ta para ⏱ 45m · 12m: kuantu tempu e mesa ta okupá kaba i kuantu tempu pasá a primi algu pa último biaha (primi i tene riba e mesa, òf pone e mouse riba dje, pa e oranan eksakto). Si no a pidi nada pa un ratu, e mesa ta haña un rant oraño: bai wak un ratu. Kuantu minüt bo ta konfigurá na Konfigurashon → Negoshi → Tempu di mesa (standart 20, 0 = sin rant oraño). Si no a primi nada ainda, e ta konta for di ora a habri e mesa.

Si tin varios grupo (kuenta propio) na un mesa, tin un liña pa kada grupo, p.e. G1 ⏱ 50m · 12m i Jansen ⏱ 10m (e nòmber di grupo, si no e number di grupo). Un grupo ku ta keda trankil muchu largu ta haña un etiket oraño i e mesa un rant oraño.

Move mesa kompleto

Den e pantaya di òrdu tin Move mesa. Skohe e lugá (por ehèmpel Terras) i un mesa: tur grupo di e mesa ta bai huntu, kada un ku su mes kuenta. Si bo skohe un mesa okupá, e mesanan ta uni (e gruponan ta bin aserka). Si bo ke move djis un parti, usa manera promé Parti / move. Si tur kos mester ta riba un kuenta, usa Uni.

Sigui traha offline (tablet sin wifi)

Si e konekshon entre un tablet i e server di kaha kai (wifi riba teras, server ta paga un ratu), un bara hel ta aparesé i e tablet ta sigui traha ku e último mesanan, produktonan i òrdunan habrí wardá:

• habri mesa, primi produkto i Manda òrdu ta wòrdu wardá riba e tablet (tambe si e reinisiá) i ta para den e lista di òrdu ku un rant di puntu ("no mandá ainda");
• apenas e konekshon bolbe, tur kos ta bai na órden pa e server i solamente anto e bon di òrdu ta bai kushina. Kada paket tin un yabi, pues nada no ta drenta dobel. Si otro hende a habri e mesa entretantu, e produktonan ta bai na e òrdu ei;
• paga, deskuento, parti i asina mas ta posibel solamente ku konekshon; "Paga" ta warda te ora tur kos di e mesa ei a wòrdu mandá.

Kantidat di persona

Opshonal i standard pagá: Konfigurashon → Negoshi → Ordená i paga → Registrá kantidat di persona. Pagá = mas tiki toke posibel: un mesa liber ta habri ku un toke, no tin persona na ningun parti, i rapòrt, dashboard i e resumen di dia no ta mustra invitado ni gasto pa invitado.

Sendé: si bo toka un mesa liber, e kasa ta puntra ku kuantu persona (boton grandi 1-8, òf tek'é; "Salta" = 1). Riba e plano, na un mesa okupá ta para "3/4 pers." (persona/lugá, hel si tin mas hende sintá ku lugá). Den e pantaya di òrdu bo ta kambi esaki ku e boton "3 pers." den e bara di grupo; ku vários grupo e mesa ta suma tur grupo huntu.

Sin persona tur kos ta keda traha: Parti igual na pagamentu ta kuminsá na 2, all-you-can-eat mes ta puntra e kantidat di adulto i mucha, i reservashon i e lista di spera ta warda nan mes kantidat di persona (e mesa ta habri anto sin persona).

Registro HACCP

Tur negoshi di horeca mester vigilá i registrá siguridat di kuminda: na Hulanda segun e Hygiënecode voor de Horeca (kontrol pa NVWA), na Bélgika segun e outokontrol di FAVV (guia G-023). Pone Registro HACCP na Ahuste → Lei i reglanan (standard pagá).

• Punto di midi (atministradó): p.e. kamber friu, frizer, tene kayente, temperatura interno despues di kushiná, laga baha friu atrobe i risibimentu di mercancia, ku un mínimo i/òf máksimo na °C i kuantu biaha (tur dia, dos biaha pa dia, tur siman òf ora di uso). Agregá lista standard ta poné un kuminsamentu (friu te 7 °C, na Bélgika te 4 °C; frizer te -18 °C; tene kayente for di 60 °C; kushiná for di 75 °C).
• Limpiesa i kontrol: tarea pa dia, siman (posiblemente riba un dia fiho) òf luna, ku lugá i instrukshon, p.e. desinfektá tabla di kòrta, filter di vèt, kontrol di plaga, kontrolá termómetro.
• Registrá (tur hende ku a drenta): boton HACCP den e bara ariba, ku e kantidat ku awe ainda ta habrí. Yena temperatura, òf marka un tarea (Hasí òf No a logra). Si un temperatura ta pafó di e límite, mester tin un medida korektivo (p.e. "porta a sera, produkto a bai den sushi"). Registronan no por wòrdu kambiá; un fout bo ta korigí ku un registro nobo.
• Resúmen (derecho Entrada pa periodo): pa periodo tur registro, e kantidat di desviashon i e registronan perdí pa dia; komo CSV (Excel) òf pa imprimí / komo PDF warda pa un kontrol.

Sistema di tap i flowmeter

Kada tap ku un kompyuter di tap òf flowmeter ta report ta bai riba e resibu, pa nada "no lek" afó. Aktivá esaki na Konfigurashon → Sistema di tap (standard paga).

• Fuentenan (atministradó): e kòmpiuter di tap òf e sistema di medidó di flou. Skohe e marka; e kasa ta yena un konfigurashon standard. For di Hulanda i Bélgika: Van Duijnen Horeca (outomatisashon di tap, Dashbar), Beconet (Multi-Tap), TapSystems, Horecatechniek Nederland, Heineken SmartDispense, WeissBeerger / AB InBev i BarTrack; ademas Gruber, Addimat, WMF / Hogatron (E-Protokoll), Drinkotec (ex-Hartec), , Berg, Easybar, Azbar, Scanabar, PourMyBeer, iPourIt, BeerBoard, US BeerSAVER, Bevchek, Capton/BarVision, Kegtron, Kegbot Kegboard, un "tap inteligente" òf un sistema propio. Bo por konektá di sinku manera (Kegboard: mira Tap dosifiká i Kegboard aki bou):
  • Kamponan: kraan (òf tap, plu), ml (òf cl, liter, volume ku eenheid) òf porties, id (mesun tap dos biaha = registrá un biaha), tijdstip, tafel, bediening; un tap, un lista òf { "taps": [...] }.
  • Network (TCP): e kasregister ta konektá ku e kompyuter di tap (adrès i pòrt) òf ta skucha mes riba un pòrt.
  • Pòrt serial: pòrt COM òf USB-serial, 1200–115200 baud, 8N1, 7E1 òf 7O1.
  • Pa network i serial bo ta pone e forma di mensahe (un mensahe pa liña, òf STX … ETX ku opshonalmente un kontrol XOR i ACK/NAK bèk) i e patron di un mensahe, ku e partinan kraan òf plu i si ta nesesario ml, cl, liter, porties, tafel, bediening i id (p.e. kraan;ml òf solamente un PLU pa glas). E suplidónan ta duna nan formato eksakto solamente na instaladónan; puntra e suplidó di e kompyuter di tap. Tap di prueba ta manda un tap manera e kompyuter di tap lo a hasi.
• Kranchinan (atministradó): pa kada kranchi òf PLU e produkto i kon e ta bai riba e resibu: pa glas (glas na ml; un tap di 520 ml ku glas di 250 ml = 2 glas; for di 50% ta konta un glas) òf pa liter (preis di e produkto ta e preis pa liter; riba e resibu p.e. "Pils 0,33 l" pa e suma korekto).
• Riba e resibu: si e kompyuter di tap ta report un mesa, e tap ta bai mesora riba e order habrí di e mesa ei. Si no, e ta keda na Tapá: den e pantaya di order e baranan "… biaha tapá sin resibu" ta aparesé; skohe e tapnan i primi Riba e resibu aki. E liñanan ta mesora ordená (no ta bai bon di trabou mas na bar) i e stock ta baha. E boton Tapá den e baranan ariba ta mustra tur loke ainda no tin resibu.
• Rechasá (derecho Storno): lababu, kibrá, purba, personal, grátis òf otro (ku splikashon); esei ta drenta den e logbuk. Muchu tiki pa un glas (p.e. lababu) mester wòrdu rechasá.
• Resumen (derecho Benta pa periodo): pa kranchi tapá, riba e resibu, rechasá (pa motibu), kanselá i ainda habrí, na liter, ku e porshento bendé, i komo CSV.
• Tapnan reportá no por wòrdu kambiá (solamente atendí).

Tap dosifiká i Kegboard

Ku tap dosifiká un kranchi ta habri djis despues ku e glas a wòrdu registrá na kasa, i djis pa e kantidat ei. Asina nada no ta wòrdu tapá ku no ta riba e bon. E ta funshoná djis si e sistema di tap ta prendí, i bo ta prende e pa kranchi (standard apagá).

• Pa kranchi (atministradó, Konfigurashon → Sistema di tap → Kranchinan): marka Tap dosifiká i skohe kuantu tempu e kranchi por keda habri despues di registrá (10–600 sekonde, standard 120). Na Kegboard bo ta yena tambe e relè (vàlvula magnétiko). Tap dosifiká ta posibel djis pa glas.
• Registrá: na Manda òrdu (òf na Kobra direkto) e kasa ta traha pa kada liña di bon ku e produkto ei un libramentu (kantidat di glas × glas na ml) i ta mand'é pa e kòmpiuter di tap. E tap ku ta drenta despues ta pertenesé na e liña di bon ei. Pues e no ta bini un biaha mas riba e bon, ni na Tapá. Un tap sin libramentu ta bai normal na Tapá.
• Storno di e liña promé ku a tapa: e kranchi ta sera atrobe. Un libramentu ku no a wòrdu tapá na tempu ta vense; e kranchi nunka no ta habri mas lat.
• Libramentunan den e pantaya di òrdu (un bara riba e bon): mira kiko ta kore, Stop i Libra atrobe. Libra atrobe ta posibel djis si ainda no a tapa nada, pues nunka no ta libra nada ekstra. Libramentu di tèst (atministradó) ta libra un glas sin bon; esei ta bai den e lòg.
• Kon e libramentu ta yega na e kòmpiuter di tap:
  • Kegboard (Kegbot, open source, ESP32 ku medidó di flou i vàlvula magnétiko; protokòl kompletamente públiko): e kasa ta duna un grant pa e kranchinan ku e produkto ei, e relènan i e kantidat. E bord ta sera e kranchi su mes ora e kantidat yega òf e tempu kaba.
  • Red/serial: un òrdu di libramentu ku bo por konfigurá ku {kraan}, {ml}, {porties}, {sec} i {id} (p.e. V{kraan};{ml}), mandá den e formato di mensahe di e fuente (liña òf STX … ETX ku XOR). Opshonalmente tin un òrdu di stop. E provedor ta duna e òrdu ekso.
• Konektá Kegboard: na + Fuente skohe e marka Kegbot Kegboard. E bòrchi ta presentá su mes na e fuente; klek riba Permití (òf Rechasá). E bòrchi ta haña un biaha un yabi propio, ku e kas ta warda solamente komo hash. Un otro aparato òf un yabi robes no ta kambia nada na un bòrchi konektá; si e bòrchi a pèrdè su yabi, usa promé Kòrta konekshon. E fuente ta mustra e firmware, e mididónan i e relenan di e bòrchi. E kranchinan ta e número di mididó (0, 1 …). Un karchi na e bòrchi ta wòrdu rechasá: pago ta sosodé na e kas. Si e sistema di tap ta pagá, e bòrchi ta warda su mensahenan i ta mand'é despues.
• Na e fuente bo ta ahustá despues di kuantu sekònde sin flow e kranchi ta sera (5–300, standard 30). Pa kada kranchi bo ta yena e número di mididó, e relè (válvula magnétiko) i kuantu tempu e kranchi por keda habrí despues di marka.

Manehá músika for di kaha

E personal ta manehá e músika for di e pantaya di toka di e kaha, asina no tin mester di un pantaya apart na bar. Aktiv'é na Konfigurashon → Negoshi → Pantaya i manehamentu → Manehá músika for di kaha (standard desaktivá). Anto e boton Músika ta aparesé den e bara ariba: pa kada fuente (p.e. Bar i Terras) Toka, Pausa, Siguiente, Anterior, Mas duru, Mas suave i un slider pa e volumen, ku loke ta tokando awor. Bek na kaha ta sera e panel. Desaktivá: e fuentenan ta keda wardá.

• Playlist (Sonos, Bluesound i VLC): e fila ku loke ta tokando awor. Primi riba un kansion pa toka e; ku Ahustá bo ta kita kansionnan (✕), pone nan mas ariba òf mas abou (↑ ↓; Sonos i Bluesound) òf bashí e playlist. Ku Skohe otro músika bo ta toka un favorito di Sonos (p.e. un stashon òf kanal di Tunify) òf lista di tokamentu, òf un preseleshon di BluOS.
• Riba un pantaya apart: e mesun manehamentu i e playlist grandi riba http://<kassaserver>:3000/muziek, p.e. riba un di dos monitor banda di e kaha òf un tablet riba bar (si bo a drenta kaba riba e mesun aparato, sino ku un kódigo PIN).
• Riba un tablet òf telefòn: un QR code ku e adrès di e pantaya apart ei den e red di e negoshi. Un empleado ta skèn e ku su mes tablet òf telefòn (riba e red wifi di e negoshi) i ta drenta ku su mes kódigo PIN; ku Logout e ta sera atrobe. Wak Di dos pantaya riba un tablet òf telefòn.

E atministradó ta agregá e fuentenan ku + Fuente di músika, ta skohe kon e ta konektá i ta test'é ku Test:

• Soundtrack (soundtrack.io): via e API públiko, ku un token di API (pidi na Soundtrack) i un zona di zonido (Karga zonanan). Toka, pausa, siguiente, volumen i loke ta tokando.
• Sonos: e adrès IP di e boks (den un grupo: e boks ku ta guia e grupo). Ta traha ku tur kos ku ta toka riba e Sonos, p.e. Tunify, Spotify òf radio.
• Bluesound (BluOS): e adrès IP di e toko; ta traha tambe ku tur kos ku ta toka riba dje, p.e. Tunify.
• VLC riba e kompiuter di músika: aktivá e interfas di web (Herramentnan → Preferensia → Mustra tur → Interfas → Interfas prinsipal: Web, ku un kontraseña na Lua); e adrès IP (si ta nesesario ku :poort, standard 8080) i e kontraseña.
• Kompiuter di músika propio (adrès di web): pa un kompiuter òf boks di músika ku un adrès di web pa kada boton; GET òf POST, i {volume} (0-100) den e adrès pa e volumen. Sin adrès pa Mas duru/Mas suave e kaha ta pone e volumen paso pa paso.
• Webplayer di e pakete di músika: e adrès di web di e webplayer òf página di manehamentu (p.e. e webplayer di Tunify òf Media Tools) ta habri den e kaha ora bo primi e boton Músika; si e servisio no por den un otro pantaya, usa Habri den un bentana apart.

E kaha ta papia for di e server ku e tokonan, pesei nan mester ta den e mesun network ku e kaha (Soundtrack via internet). Tur hende ku a drenta por manehá; pa konfigurá bo mester e derecho Konfigurá negoshi, pago i printer. E token i e kontraseña nunka no ta bolbe mustra riba pantaya ni den e buki di registro; den e buki di registro ta keda registrá solamente e konfigurashon (aktivá/desaktivá, fuentenan), no kada boton. E eksportashon di konfigurashon ta inkluí solamente aktivá/desaktivá (e fuentenan ta pertenesé na un solo negoshi).

Di dos pantaya riba un tablet òf telefòn

E músika i e kámaranan por tambe riba e mes tablet òf telefòn di un empleado, komo di dos pantaya banda di e kaha. Den e bentana Músika òf Kámaranan tin e boton Riba un tablet òf telefòn: e ta mustra un QR code ku e adrès, p.e. http://192.168.1.20:3000/muziek òf .../camera.

1. Pone e tablet òf telefòn riba e red wifi di e negoshi.
2. Skèn e QR code ku e kámara (òf tipiá e adrès den e browser).
3. Drenta ku bo mes kódigo PIN. Bo ta mira solamente loke bo tin permiso pa mira: e músika tur hende, e kámaranan solamente ku e derecho Mira imágen di kámara.
4. Kla: Logout na banda drechi ariba. Si e login a vense (p.e. e tablet a keda sin usa un anochi), e pantaya ta pidi e kódigo PIN atrobe.

Tip: pone e página riba e pantaya prinsipal di e tablet (den e browser: Agregá na pantaya prinsipal), anto e ta habri manera un app.

P'esei e kaha ta pidi e adrès IP di e kompiuter di kaha den e red (si e kompiuter tin mas di un, p.e. wifi i kabel, bo ta skohe e red). Riba e portal di maneho (kaha for di leu) ta e adrès di e portal. E kaha mes ta traha e QR code, sin internet.

Konektá tabletnan: ku un boton na e tablet (opshonal)

Mas fásil ainda: konektá un tablet un biaha, anto e kaha ta manda e músika òf e kámaranan ku un boton na e tablet ei. Aktivá esaki na Konfigurashon → Negoshi → Pantaya i manehamentu → Tabletnan komo di dos pantaya (standard desaktivá).

1. Riba e tablet: habri http://<kassaserver>:3000/tablet (na e konfigurashon tin Riba un tablet òf telefòn ku e kódigo QR), log in ku un kódigo PIN i duna e tablet un nòmber, p.e. Tablet Bar. Konektá.
2. Riba e kaha: den e bentana Músika òf Kámaranan awor tin e boton Na Tablet Bar (ku un puntu bèrdè ora e tablet ta prendí). Primi riba dje: e tablet ta habri e pantaya ei di su mes. Ku músika, e fuente skohí ta bai kuné (p.e. Terras).
3. Riba e tablet: Sera ta bai bèk na warda; Deskonektá e tablet aki ta kita e konekshon.

Laga e página riba e tablet habrí; si e tablet ta pagá òf ta drumi, e ta habri e pantaya apenas e ta prendé atrobe. E tablet ta keda log in komo e empleado ku a log in riba dje: manda i mira e kámaranan ta posibel solamente ku e permiso Mira imágen di kámara. E atministradó ta mira na e konfigurashon kua tablet ta konektá i si nan ta prendí, i por duna nan un otro nòmber òf kita nan. E tablet ta warda su mes yabi; e kaha ta warda solamente un hash di esei. Desaktivá: e tabletnan konektá ta keda wardá. Den e logbook ta pará ken a konektá, kambia nòmber di òf kita un tablet.

Pantaya di yamamentu pa hende ku ta bin buska

Un pantaya pa e klientenan ku na banda robes Den preparashon i na banda drechi Kla, ku number grandi, manera na un snek òf fastfood. Aktivá esaki na Konfigurashon → Negoshi → Pantaya i manehamentu → Pantaya di yamamentu pa hende ku ta bin buska (standart desaktivá).

No tin mester di konektá: habri riba un tv ku browser (smart-tv, stick òf mini-pc), un tablet òf un di dos monitor e adrès di e kaha ku /oproep, por ehèmpel http://192.168.1.20:3000/oproep. Na e konfigurashon i den e bentana Yama tin e botonnan Riba un pantaya apart i Riba un tablet òf telefòn (kódigo QR ku e adrès). No tin mester di drenta: e pantaya ta mustra number so. Toka e pantaya un biaha, anto e browser por hasi zonido.

Kiko ta sali riba dje:

• òrdu pa hiba for di e kaha, e tienda online i Thuisbezorgd (i si bo ke tambe òrdu na mostrador sin mesa, ku benta lihé), di e último 12 ora;
• apenas algu a ser manda pa kushina òf bar (òf e tienda online ta riba den preparashon): e number ta para na Den preparashon;
• Kla ta bai outomátikamente ora e pantaya di kushina indiká ku henter e òrdu ta kla òf e òrdu di tienda online ta riba kla. E number ta flikker un ratu i e pantaya ta duna un ding-dong;
• un number kla ta keda tantu minüt manera a konfigurá (standart 10), òf te ora e ta Buská;
• bestelnan di e kiosko (wak Kiosko di outoservisio) ta semper aparesé apenas nan ta pagá òf lo wòrdu pagá na kaha, tambe ku "mi ta kome akinan", ku e number pa kohe di nan bon;
• si bo ke, tambe bestellingnan pa bezorgdónan di Thuisbezorgd, Uber Eats, Deliveroo i HubRise (marka Tambe bestellingnan pa bezorgdónan …): ku e número di bestelling di e plataforma i e nòmber di e plataforma bou di dje, pa e bezorgdó mira ora su bestelling ta kla. Buská ta avisá e plataforma e ora tambe ku e bezorgdó tin e (meskos ku den e bentana di e plataforma).

E número: na e webshop, Thuisbezorgd i e plataformanan di entrega, e número di bestelling ku e gas òf bezorgdó tin kaba; sino e número pa buska (1 te 999). E ta print grandi riba e resibo, ku e splikashon ku e número ta aparesé riba e pantaya ora e bestelling ta kla (den e idioma di e resibo).

Opshonal (standard paga, den e ahuste):

• Anunsiá e number ku stem: ora tin un number nobo kla, e pantaya ta bisa por ehèmpel "Nummer 42…" den e idioma skohí (hulandes, ingles, alemán, franses, spaño, italiano, portugues, polaco, turko òf arabir). E stem ta bini for di e browser di e pantaya i ta zona diferente pa kada aparato; despues di habri, toka e pantaya un biaha. Despues di e zonido di bèl, si e zonido tambe ta na.
• Status di bestelling riba telefòn: bou di e number pa kohe riba e bon ta aparesé un kódigo QR. E gas ta skan'é, ta mira su number i e status (bestel, ta prepará, kla, kohe) i ta haña un aviso ora e bestelling ta kla. Esaki ta bai via e portal di maneho, p'esei e kaha mester ta konektá kuné. No pa e webshop i Thuisbezorgd (nan tin nan mes status) i no pa e kiosko (e tin su mes ahuste).

Den e kaha tin e boton Yama (ku e kantidat ku ainda ta den preparashon):

1. Kla ta pone un number kla ku man (sin pantaya di kushina, òf si esei ta mas lihé). Na un òrdu di e tienda online òf Thuisbezorgd e status ta kambia kuné, pues e kliente tambe ta haña mensahe.
2. Bèk ta pon'é atrobe na Den preparashon.
3. Buská ta kit'é for di e pantaya (ku Bolbe atras).

Na e konfigurashon bo ta skohe tambe si e promé nòmber ta para banda di e number (standart nò, pa privasidat) i si e pantaya ta duna zonido. Desaktivá: no tin boton Yama i no tin number di buska riba e resibu; e konfigurashon ta keda warda. Den e buki di registro ta para ken a pone kiko ku man riba kla, bèk òf buská.

Marka drenta i sali

Standart marka ora ta desaktivá: anto e no ta visibel na ningun kaminda den e kaha (no tin boton den e bara ariba, no riba e pantaya di login, no tin tab Ora di trabou). Aktiv'é via Konfigurashon → Negoshi, bou di Marka entrada i salida di personal:

• Desaktivá: no usa. Si bo paga marka entrada i salida despues, e no ta wòrdu mirá na ningun parti mas, pero e oranan ku a wòrdu marka kaba ta keda wardá (nada no ta wòrdu kitá); si bo sende e atrobe, nan ta einan atrobe.
• Aktivá: empleadonan por marka entrada i salida. Despues di login e kaha ta puntra si bo ke marka entrada (No awor ta permití). Den e bara ariba ta para anto Marka entrada òf Den sirbishi 17:02; primi riba esei pa marka salida.
• Obligatorio: despues di login promé marka entrada, si no bo no por usa e kaha. Marka salida ta sera bo sesion mesora.

Ken ku no ta usa e kaha (p.e. kushina) ta marka ora riba e pantaya di login: primi Marka entrada / salida i drenta bo pin. Esei ta kambia entre entrada i salida, sin login.

Si marka ora ta aktivá, e atministradó ta mira na Konfigurashon → Ora di trabou:

• ken ta den sirbishi awor (i por marka salida pa un hende ku a lubida);
• e oranan trahá pa empleado pa periodo, ku tur turno, i un download komo CSV (ora tambe komo number desimal pa atministrashon di salario);
• ahustá òf agregá turno (primi riba un turno, òf + Agregá turno). Kada kambio ta drenta ku e oranan bieu i nobo den e registro.

Na Bélgica kada marka entrada i salida ta wòrdu notifiká tambe na e kaha pretu (zwarte doos). Si esei no ta alkansabel, e marka ora no ta pasa (meskos ku paga). Si esaki ta kumpli eksaktamente ku e registrashon di personal Belga, ainda mester wòrdu konfirmá.

Pesa i etiket (balansa)

Si e balansa ta aktivá (Konfigurashon → Balansa), produktonan por tin un preis pa kilo. Tur otro produkto ta keda simplemente pa pida.

• Pesa: primi riba un produkto ku preis pa kilo (e boton ta mustra p.e. 12,95/kg). E bentana Pesa ta mustra e peso di e balansa (p.e. un Aclas OS6X, òf e balansa riba kua e kaha mes ta kore) live; bèrdè = stabil. Pone e produkto riba e balansa i primi riba Agregá apenas e peso ta stabil. E preis ta preis pa kilo × peso (rondá na sèn); un bak (tara) di e produkto ta bai for di dje outomátikamente. Si e produkto tin opshon, esakinan ta bin despues.
• Mas balansa: si tin mas balansa, bo ta skohe ariba den e bentana riba kua bo ta pesa. Kada kaha/tablet ta kòrda su skoho.
• Ku man: si no tin balansa (òf si e ta permití ku man), tek e peso: 0,512 òf 1,2 ta kilo, 512 òf 512 g ta gram.
• Etiket di e TS6X: skan e kòdigo di bara di e etiket ku e skèner di kòdigo di bara riba e pantaya di òrdu (skan simplemente, no mester tin nada habrí), òf primi riba Etiket i skan òf tek e 13 sifranan. E produkto (PLU) i e peso ta bin for di e etiket. Si tin un preis riba e etiket, e kaha ta kobra eksaktamente e preis ei.
• Riba e pantaya, e resibu di kaha i e pantaya di kliente e peso ta para banda di dje, p.e. Gehakt 6,63 ku bou di dje 0,512 kg x € 12,95/kg; riba e bon di òrdu 0,512 kg Gehakt. Parti, move i retorno ta bai na kilo.
• Un produkto pisá ta posibel solamente ku konekshon ku e server di kaha (e peso ta bin via e server di kaha).

Uber Eats, Deliveroo i HubRise

Ademas di Thuisbezorgd.nl / Takeaway.com, òrdu di Uber Eats (Hulanda i Bélgika), Deliveroo (solamente Bélgika; Deliveroo a sali for di Hulanda na fin di 2022) i tur loke ta riba HubRise (entre otro Uber Eats, Deliveroo, Just Eat/Takeaway.com i app di òrdu mas chikitu) tambe ta drenta den kaha. Kada plataforma por pone na separá serka Konfigurashon → Plataformanan di entrega (standard desaktivá; desaktivá ta warda tur kos). E tab ta mustra pa kada plataforma den kua pais e ta traha i ta spièrta si e no ta traha den e pais di e negoshi.

• Pone na, anto Drenta na Uber Eats i konektá tienda (e negoshi ta drenta ku su mes kuenta di Uber Eats). Si e kuenta tin mas tienda, yena e id di tienda (store id) i drenta di nobo. Uber Eats mester aprobá Pin Voordeel promé komo partner p'esei.
• Deliveroo: direkto, via e portal. Yena e site-id (location id) i e id di marka (brand id). Sin tablet (standard): e kaha ta aseptá òf rechasá; ku tablet: e negoshi ta aseptá riba e tablet i e portal ta avisá so si e òrdu ta den kaha.
• HubRise: e kaha ta buska e òrdunan su mes (kada 20 sekònde, no mester portal).
• Pa plataforma: aseptá outomátikamente, bon di kushina mesora na kushina/bar i (Uber Eats, Deliveroo) manda menú outomátikamente despues di un kambio i Manda menú awor. Riba e menú tin e produktonan ku ta marká bou di Produkto riba e menú di Uber Eats i Deliveroo, ku opshon; bendí kompletamente ta bai tambe.

Òrdu. Un òrdu ta bira un òrdu normal (bezorgen òf afhalen, nòmber di grupo <platform> <nummer>) ku e preisnan di e plataforma: produkto rekonosé na e id (for di e menú), e kódigo òf e number PLU, deskonosí = un liña separá ku e preis di e plataforma (i un aviso); kosto di entrega, rekargo i deskuento komo liña propio; si e total toch no ta kuadra, un liña "Diferensia". E bon di kushina ta bai mesora na kushina/bar. Boton Plataformanan den e bara ariba (ku e kantidat di òrdu kurante; oraño si tin algu pa aseptá): aseptá òf rechasá (ku motibu), den preparashon, kla, na kaminda, entregá òf buská, kanselá, i Kaba (pagá online). Loke e plataforma konosé ta bai bek (Uber Eats: aseptá, rechasá, kanselá; Deliveroo: aseptá, rechasá, den preparashon, kla, buská; HubRise: tur status). Si e negoshi mes ta entregá (entrega propio), e òrdu ta den Viahe tambe, i salida i entregá ta bai su mes na e plataforma. Un kanselashon di e plataforma ta laga e òrdu vense. Si e kaha no ta konektá ku e portal pa mas ku 2 minüt, e portal ta rechasá un òrdu nobo di Uber Eats i ta bisa Deliveroo (ku tablet) ku e no a logra, pa e negoshi mir'é riba e tablet.

Kódigo: apps/pos-server/src/lib/bezorgplatforms.ts, routes/bezorgplatforms.ts; pantaya Bezorgplatforms.tsx. Banda di portal: horecapos-portaal/src/platforms.mjs. Buki di registro: Plataformanan di entrega (na/paga, konfigurashon, òrdu). Tur kos ta bai den e back-upnan di e kaha.

Plataformanan mas chikitu na Hulanda i Bélgika (Homie, Hebtrek, sneleten.nl, Bistroo ...) no tin konekshon di kaha públiko; si nan ta riba HubRise, nan ta traha via HubRise. Ademas: mira e backlog.

Outomat di plaka (sistema di kèsh será)

Standard desaktivá: kèsh ta funshoná manera semper. Ku un sistema di kèsh será, e personal no ta mishi ku e kèsh: e kliente òf empleado ta pone e plaka den e outomat, kende ta konta, kontrolá pa plaka falsu i duna sèn chikí bèk.

• Outomatnan ku kua e kaha mes ta komuniká:
  • CashDro (3, 4+, 5, 7, S Compact; NuKassa, KluisKassa): via e red (web service). Aktivá riba e CashDro Web Integration i traha un usuario propio pa e kaha.
  • Cashmatic (SelfPay 460/860/1060; na Bélgika Xpos): via e red (porta 50301) ku un usuario di e Cashmatic.
  • Azkoyen Cashlogy (POS1000, POS1500): via e CashlogyConnector riba un PC di Windows banda di e outomat (porta 8092).
  • CashKeeper: via CKMonitor riba un PC di Windows (porta 16501).
  • Glory CASHINFINITY (CI-5, CI-10, CI-10X; tambe via Cikam): via e kontrol (FCC) di e outomat. Ainda beta: laga Glory òf bo dealer chek e promé konekshon.
  • Eksterno: otro software ta manehá e outomat i ta komuniká ku e kaha (manera Cikam, ImaCash pa 25 marka, e software di CashGuard/StrongPoint (Merlin), PayComplete (SUZOHAPP), Gunnebo SafePay òf marka franses manera CashMag).
  • Outomat di prueba: sin hardware, pa praktiká òf mustra. Ku Test konekshon bo ta kontrolá adrès i login. Pone e outomat den bo propio red (nunka habrí na internet) i usa un usuario propio pa e kaha, no un atministradó.
• Kobra ku Kèsh: Paga na e outomat di plaka ta kuminsá e pago pa e suma (rondoná pa kèsh si esei ta aktivá, plus propina; ora di parti e kuenta, e parti). E pantaya ta mustra kiko a hinka i kiko ta bin bèk; e kaha ta kobra solamente ora e outomat avisá kla. Kanselá = e outomat ta duna e plaka bèk. Si e outomat no por a duna tur e sèn chikí (muchu tiki muntanan), e ta mustra kuantu mester sali for di e kashi di plaka. Un pago eksitoso ku ainda no a ser kobrá (p.e. tablet a paga) ta ser hañá bèk na e òrdu ei.
• Kèsh solamente via e outomat (standard aktivá): e server di kaha ta aseptá kèsh solamente ku un pago eksitoso na e outomat pa eksaktamente e òrdu i e suma ei. Desaktivá = tambe kèsh normal den e kashi.
• Kashi di plaka (Reporte → Kaha, permiso Maneha kaha di plaka): Konsultá kantidat (pa kada muntu i papel di plaka, na Cashmatic, Cashlogy, Glory i e outomat di prueba), Paga for ku motibu (p.e. sèn chikí pa e kashi), Yena i Saka sobrá (sèn chikí ta keda; na Cashmatic). Esperá den e kashon di kaha no ta konta e plaka den e outomat (esei ta aparte bou di dje: Den e outomat di plaka), pero sí e sèn chikí ku mester a sali for di e kashi.

E boton ©

Abou na banda drechi di kada pantaya (pin, plano, pidi i kushina) tin un boton chikitu ©. E ta habri e datonan di OptimumPOS: logo, adrès, telefòn, e-mail i website. E ikono ta lokal den e app i p'esei ta traha tambe sin internet. E mesun ikono ta e ikono di e app (tab i pantaya di inisio).

Parti 2 · Manager

Kuminsá

Un manager standart por hasi tur loke e personal por, i ademas, entre otro, duna deskuento, hasi retorno, sera e dia, maneha e laha di kaha i mira e registro i e stòk. Esei ta mayoria bou di e boton Raport:

• Estado intermedio (X): e benta te awor, sin sera e dia.
• Laha di kaha: sèn inisial, sèn aden/afó i habri e laha.
• Sera dia (Z): na final di e dia; despues un dia nobo ta kuminsá.
• Raport Z anterior, Benta pa periodo i Dashboard.
• Registro, Bon di regalo i Kliente.

Stòk

Standard pagá. Sende na Ajustenan → Negoshi → Tene kuenta di stòk. Pagá = no ta mustra niun kaminda den e kaha.

• Pa kada produkto bo ta skohe na Ajustenan → Produkto → (produkto) → Stòk:
  • No: manera semper;
  • Pa produkto: kada benta ta rebaha 1 (p.e. bòter, lata), ku un nivel di aviso pa "kasi kabá";
  • Via ingrediente: un resèt, p.e. hamburger = 1 pan + 150 g karni + 1 tayada di keshi. Kada benta ta rebaha e ingredientenan.
• Ajustenan → Stòk (derecho Maneha stòk, standard manager i administradó):
  • Produkto i Ingrediente: e stand, ku kabá / kasi kabá; filter "solamente (kasi) kabá" i eksport pa CSV.
  • Pa kada produkto òf ingrediente bo ta registrá Risibí (+) (entrega), Konta (=) (kantidat kontá ta bira e stand nobo) òf Saka (−) (kibra, vensé; motibu ta obligatorio).
  • Krea ingrediente ku unidat (st, g, kg, ml, cl, l, porshon, bòter, barí) i nivel di aviso.
  • Historia: tur kambio (benta, storno, risibí, konta, saka) ku ken i ki ora. Akshonnan di atministrashon ta bai den e registro tambe.
• E rebahamentu ta sosodé na Tuma òrdu (òf na kobra pa loke a kobra direktamente). Un storno ta konta bek. Parti i move no ta konta dobel. Na menú, e kumindanan ta rebaha, no e liña di menú. Retorno (bòn di krédito) no ta konta bek (loke a hiba bek mayoria biaha no por bende mas); registr'é si bo ke komo risibí.
• Si e stòk ta kabá (òf un ingrediente no ta alkansa pa un biaha mas), e produkto ta bira bendí kompletamente riba tur kaha outomátikamente. Ora e ta kasi kabá, ainda N ta riba e boton di produkto. Despues di un risibí òf konta, bo por pidié mesora atrobe. E server di kaha tambe ta rechasá e produkto e ora ("Pils" a kaba (stòk 0)), pues tambe for di un tablet ku no tabata sa esei ainda.
• E stòk por baha bou di 0 (p.e. dos tablet na mes momento, òf òrdu offline); e konta ta kore esei.
• Lista di òrdu: Ajustenan → Stòk → Lista di òrdu. Pa produkto (pa produkto) i pa ingrediente bo ta konfigurá banda di e nivel di aviso tambe yena te i e proveedor. Riba e lista di òrdu tin tur kos ku ta na òf bou di e nivel di aviso (sin nivel di aviso: na 0), pa proveedor, ku komo sugerensia yena te − stand. Bo por kambia e kantidatnan i marka/kita marka. Despues Imprimí (printer di bòn), Kopia (pa e-mail òf WhatsApp), Eksport (CSV), i despues di e entrega Entregá: registrá komo risibí (ta registrá tur kos un biaha). Ku e marka ariba bo ta mira tambe loke no a kaba ainda, pa pidi ekstra.
• Opshon di eskoho: na un grupo di eskoho (Ajustenan → Produkto → Opshon di eskoho) tin e boton Stòk. Pa kada eskoho, duna e ingredientenan pa pida, p.e. Keshi ekstra = 1 tayada di keshi, Patata = 150 g patata. Si nan skohe e opshon, e ingredientenan ei ta baha pa pida (tambe si e produkto mes no ta tene stòk; na storno nan ta bolbe). Si un ingrediente a kaba, e eskoho ta mustra riba e kaha komo (kabá) i bo no por skohe.

Pidi na suplidónan

Standard desaktivá. Aktivá na Konfigurashon → Stòk → Pidi na suplidónan (solamente ku Tene kuenta di stòk aktivá). Desaktivá = e lista di òrdu ta funshoná manera semper.

• Suplidónan (tab Suplidónan): skohe un for di e lista òf traha bo propio suplidó. E lista tin mayoristanan i cash & carry (Sligro, Sligro-ISPC/Sligro-M, HANOS, Makro, De Kweker, Horeca Totaal, Van Zon, zegro, Lekkerland), foodservice (Bidfood i Bidfood Belgium, Solucious, Chefs Culinar, Java, Q-Food, Agora Culinair, VHC Jongens/Kreko/Actifood, Hocras, Van Hoeckel ...), mayoristanan di bebida (De Klok, Henk Smit, Horesca, De Monnik, Hansen, Dranken Geers ...), brouwerijnan i refresko (Heineken via Sligro, AB InBev/BEES, Alken-Maes, Haacht, Duvel Moortgat, Martens, Coca-Cola, Spadel, Grolsch, Bavaria), suplidónan di produkto fresku (Van Gelder, Driessen, FiliusKaas, Bakkers Brigade, Rungis ...), non-food (Bunzl, Takeaware, Supplierz), e tienda di biña online Vinify.nl i plataformanan di òrdu (Apicbase, Exact Horeko, Growzer, inOne, Cuisin.io, OrderXL). Solamente suplidónan di e pais di e negoshi ta aparesé. Si bo skohe un, e manera di pidi, e dokumento i e kolumnan ta bon kaba; na kada suplidó ta para kon bo ta pidi einan.
• Pa suplidó: number di kliente, pidi via:
  • E-mail: e òrdu komo e-mail (ku tabel) na e adrès di e-mail pa òrdu, opshonalmente un kopia, ku e lista di òrdu komo anekso: CSV, Excel, CSV pa Care4Fresh (hopi mayorista di produkto fresku), UBL 2.1 Order (Peppol BIS Order), EANCOM ORDERS (D96A na Hulanda, D01B/HO2C na Bélgika) òf cXML. Kontestanan ta yega na e adrès di e-mail di e negoshi.
  • Dokumento: e kaha ta traha e dokumento, bo ta upload'é den e tienda online di e suplidó (p.e. Bunzl Snel bestellen: artikel;aantal, Takeaware: SKU,Quantity). Señal di separashon, liña di título i kolumnan ta konfigurabel (artikel, ean, omschrijving, aantal, eenheid, prijs, totaal; ku artikel=SKU bo ta duna e título un nòmber propio).
  • Konekshon (cXML): un cXML OrderRequest ku number di kliente i sekreto kompartí na e adrès di òrdu di e suplidó, manera sistemanan di kompra ta manda na Sligro, HANOS i Bidfood. Adrès, number di kliente i sekreto bo ta haña di e suplidó (Sligro: koppelingen@sligro.nl). E sekreto nunka ta bai bèk na e pantaya.
  • Na tur dos konekshon bo por pone tambe un nòmber di usuario i kontraseña (Basic) i header ekstra (un pa liña, p.e. X-Api-Key: ...).
  • Upload (SFTP/FTPS): e kaha mes ta pone e archivo (EANCOM, UBL, CSV, Excel ...) den un mapa riba e server di e suplidó, manera hopi mayorista ta aseptá òrdu di EDI. SFTP (SSH), FTPS (eksplísito riba porta 21 òf implísito riba porta 990) òf, solamente den bo mes red, FTP. Drenta ku kontraseña òf yabi SSH (OpenSSH, PEM òf PuTTY .ppk; ed25519, ECDSA òf RSA). Traha yabi ta traha un pa di yabi den e kaha; e yabi públiko bo ta manda pa e suplidó. Test konekshon ta drenta i buska e mapa. E marka di dede di e server SFTP ta wòrdu registrá na e promé konekshon i despues ta wòrdu kontrolá (un otro server no ta haña e kontraseña); na FTPS ku un sertifikado propio bo ta fiha e marka di dede di e sertifikado. No tin mester di software ekstra.
  • Imprimí: e òrdu riba e printer di bòn, pa pasa pa telefòn.
• Kontraseña, yabi, token i header nunka ta bolbe riba e pantaya (laga bashí = keda, Kita = kita afó).
• Pidi konekshon: na un suplidó e kaha ta prepará un e-mail pa un konekshon (cXML, EDI via SFTP/FTPS, UBL/Peppol òf e API propio di e suplidó) ku e datonan di e negoshi (nòmber, adrès, número di BTW, número di kliente, GLN) i loke ta nesesario; na EDI ku e yabi públiko. Adaptá i manda; un kopia i e kontestanan ta bai na e adrès di e-mail di e negoshi. E fecha di e petishon ta para na e suplidó. Na Sligro e ta bai na koppelingen@sligro.nl, sino bo ta yena e adrès di bo manager di kuenta.
• Un suplidó propio (no for di e lista) por hasi tur kos ménos loke e suplidó mes mester ofresé: e-mail, archivo i imprimí ta funshoná semper; un konekshon òf upload solamente ku e datonan di e suplidó ei.
• Dianan di pidi i entrega: dianan di pidi, ora límite, tempu di entrega (e fecha di entrega deseá riba e pedido) i un suma mínimo di pedido. Outomátiko: riba e dianan di pidi for di e ora ei e kaha mes ta prepará un pedido komo konsepto (bo ta kontrolá e) òf ta manda e mesora (pa e-mail, upload òf konekshon; bou di e suma mínimo di pedido solamente prepará komo konsepto). Un biaha pa dia pa suplidó.
• Pa produkto (Konfigurashon → Produktonan → (produkto) → Stòk, na Pa produkto) i pa ingrediente: Pidi na (e suplidó), number di òrdu serka e suplidó ei, EAN, pa empake (krat di 24 = 24), e nòmber di e empake i e preis di kompra pa empake. E nivel di aviso ta e momento pa pidi; kompletá te kuantu mester tin despues.
• Òrdu di kompra (tab Òrdu di kompra):
  • Proposishon di òrdu pa suplidó: tur loke ta riba òf bou di e nivel di aviso. Loke ya ta pidí i ainda no a yega (na kaminda) ta konta, pa bo no pidi nada dobel. Proposishon = kompletá te − stòk − na kaminda (sin kompletá te: te e nivel di aviso), rondoná pa ariba na empakenan kompleto. Ahustá kantidatnan i Traha òrdu.
  • Un òrdu ta promé prepará: kantidatnan, liñanan suelto (sin produkto, p.e. servètnan), nota i fecha di entrega ainda por kambia. Despues Manda (na e manera di e suplidó òf e biaha aki na otro manera). Si e faya (p.e. e suplidó ta rechasá), e motibu ta para banda di dje i bo por purba di nobo.
  • Risibí: pa liña e kantidat risibí (ta para kaba riba e kantidat pidí); e stòk ta subi pa empake (2 krat di 24 = 48), ku e òrdu den e historia.
  • Kada dokumento (CSV, Excel, UBL, EANCOM, cXML) tambe por download apart.
• Mandá, faya, risibí i kanselá ta drenta den e buki di registro. E Lista di òrdu normal ta keda funshoná; si un produkto tin un suplidó for di e lista, e ta aparesé einan bou di e nòmber ei.

Maneho di review

Lesa i kontestá review di Google i Trustpilot den e kaha. Aktivá na Konfigurashon → Punto i review → Maneho di review (standard desaktivá; e ora bo no ta mira nada di dje na ningun parti). Lesa i kontestá na Reporte → Review (derecho Lesa i kontestá review, standard tambe pa e manager). Si bo pag'é, e konekshonnan i e reviewnan ta keda wardá.

• Despues kada negoshi ta primi Konektá ku Google so i ta drenta ku e kuenta di Google mes di e perfil di negoshi. Un kódigo di Places por wòrdu reglá sentralmente tambe (e gastunan ta pa kuenta di e suplidó anto). Trustpilot ta pa kada negoshi: kada negoshi tin su mes kuenta di Trustpilot Business (e API ta bini ku un abonamentu ku mester paga), i for di dje ta bini e kódigo, e sekreto i e business user ID. Den e kaha, serka kada manera ta para "Ken ta regla esaki?".
• App di e suplidó (via e portal di kliente): si e app di Google i/òf e app di Trustpilot di e suplidó ta den e portal di kliente (wak e README di horecapos-portaal, "Reviews: apps van de leverancier"), e atministradó ta skohe na Login i kódigo pa App di e suplidó (standard pa un konekshon nobo si e portal tin e app). E negoshi ta primi Konektá ku Google òf Drenta ku Trustpilot i ta drenta ku su mes kuenta; e kaha ta warda su mes te ora e login kaba (kada 3 sekonde, máksimo 15 minüt) i ta buska e tokens un biaha na e portal. Renobá tambe ta bai via e portal. No tin mester di client-ID, secret òf kódigo API den e kaha; pa Trustpilot si e dominio i, pa kontestá, e business user ID. Lesamentu públiko di Trustpilot ta bai e ora ei via e kódigo di e portal. Ta rekerí PORTAAL_URL i PORTAAL_SLEUTEL. Bo mes app òf kódigo API ta sigui funshoná manera aki bou.
• Di ken e reviewnan ta: nan ta keda riba e Google Business Profile propio i e página di Trustpilot propio di e negoshi, i e kaha ta warda nan djis den su mes base di datos di kaha. Kontestanan ta aparesé bou di e nòmber di e negoshi. E portal ta pasa e login so (den memoria, máksimo 15 minüt, por buska un biaha so) i no ta warda reviewnan ni tokens; e nòmber di e app di e suplidó ta aparesé so riba e pantaya di permiso.
• Registrá bo mes: na kada plataforma tin un link pa traha bo mes un Google Business Profile (business.google.com/create) òf un kuenta di Trustpilot Business (business.trustpilot.com), i na Trustpilot un link pa e plannan (business.trustpilot.com/plans). Registrá i paga ta sosodé na e plataforma mes; no tin API pa esei.
• Despues Konektá ku Google i drenta ku e kuenta ku ta maneha e Business Profile. Un sukursal den e perfil = skohé mesora; mas = skohe den e kaha.
• Google Places (lesa so): ku e Place ID i un kódigo API di Places API (òf GOOGLE_PLACES_API_KEY): e promedio, e kantidat di review i e 5 review mas relevante. Asina bo no por kontestá.
• Trustpilot Business (lesa i kontestá): kódigo API i sekreto API di un aplikashon den Trustpilot Business (Integrations → API; òf TRUSTPILOT_API_KEY i TRUSTPILOT_API_SECRET), e dominio di e negoshi (e kaha ta buska e business unit) i, pa kontesta, e business user ID di esun ku ta kontestá.
• Trustpilot públiko (lesa so): kódigo API so.
• E kaha ta buska kada 30 minüt (i mesora despues di konektá; Buska awor). E adrès di e-mail i e number di òrdu di e kliente (ku Trustpilot ta manda) e kaha no ta warda.
• Reporte → Review: promedio, kantidat pa strea, sin kontesta i no lesá; filtrá pa plataforma, strea, sin kontesta i no lesá. Pa kada review Kontestá (maksimo 4000 karakter; tur hende por les'é), Kambia kontesta, Kita kontesta i Lesá. Un review nobo òf kambiá ta no lesá. Den e buki di registro tin review_beantwoord i review_antwoord_weg.
• Deskonektá ta warda e reviewnan buská.

Marketing pa sms i e-mail

Mensahe na klientenan di e karchi di kliente ku a duna pèrmit pa esei. Sin karchi di kliente niun di e dos no por wòrdu aktivá.

• Pèrmit pa kliente i pa kanal: na un kliente nobo na e kasa tin e markanan "Kliente ke risibí akshon pa sms" i "... pa e-mail" (standart pagá). Na Reporte → Klientenan bo ta mira i kambia e pèrmit (ku e fecha ku el a wòrdu duná) i un dia di aña (solamente dia i luna). Dal afó: kita e marka i warda.
• Menu aktualisá mesora: si bo aktivá òf desaktivá marketing òf e karchi di kliente, e kaha ta manda e menu di nobo pa e tienda online den algun sekonde (djis si algu a kambia), pa e marka aparesé òf no mesora.
• Permiso via e tienda online: si e negoshi tin un tienda online, na kobra tin e marka "Mi ke risibí oferta pa e-mail/sms" (djis e kanalnan ku ta aktivá; standart desaktivá). Ora un òrdu asina drenta, e kaha ta buska e kliente pa número di telefòn (sino adrès di e-mail), ta krea e kliente si ta nesesario i ta registrá e permiso ku e fecha. Un número òf adrès ku ta falta serka un kliente eksistente ta wòrdu kompletá; den e logbook tin klant_toestemming ku fuente webshop.
• Reporte → Marketing (derecho Maneha karchi di kliente): ariba ta mustra kuantu kliente a duna pèrmit pa sms i pa e-mail.
• Akshonnan (un biaha): nòmber, sms òf e-mail, (tópiko,) teksto ku {naam}, {zaak} i {punten}, i si bo ke solamente klientenan ku no a bin pa un tempu òf ku tin por lo ménos asina tantu punto. Mira ta mustra na kuantu kliente e ta bai, e mensahe manera e kliente ta hañ'é i e kantidat di sms pa kliente. Manda tèst na bo mes número òf adrès. Despues Manda: e kasa ta manda den fondo (máksimo 1000 pa biaha) i ta konta kiko a wòrdu mandá i kiko a faya. Niun hende no ta haña e mesun akshon dos biaha; si e kasa stòp na mitar, Sigui manda ta sigui serka esnan ku ainda no a haña nada.
• Manda via Mailchimp òf Klaviyo (ku un konekshon ku un lista skohí, mira abou): na un akshon pa e-mail bo ta skohe na Manda via e kaha (su mes server di e-mail, manera ariba) òf Mailchimp òf Klaviyo. Anto e kaha ta aktualisá e lista promé (dalmentu afó, punto) i ta krea un kampaña ei pa eksaktamente e klientenan skohí ku ta riba e lista (Mailchimp: un grupo fiho riba e audience; Klaviyo: un lista propio pa e akshon), i ta mand'é ku e remitente standard di e audience òf e kuenta. {naam} i {punten} Mailchimp/Klaviyo ta yena pa kada kliente; e link pa dal afó di e servisio ta bou. No tin límite di 1000 pa biaha ni kódigo di deskuento personal ({code}). Si e no logra, e akshon ta keda un konsepto ku e mensahe banda di dje. E tab Marketing ta eksistí tambe si solamente e konekshon ta aktivo (anto solamente akshon via Mailchimp/Klaviyo; Manda tèst ta posibel ku e server di e-mail di e kaha). Mensahe outomátiko e kaha semper ta manda mes; den Mailchimp/Klaviyo bo ta traha nan komo Customer Journey òf Flow. Yabi di Klaviyo: tambe derecho di skirbi pa Campaigns i Templates (ken a drenta kaba: drenta atrobe).
• Komo mensahe push via e webshop (si Mensahe push ku oferta ta aktivá den e atministrashon di webshop): na Manda pa medio di skohe Mensahe push (webshop komo app), ku un título (máksimo 60 karakter) i un teksto kòrtiku (máksimo 200 karakter; solamente {zaak} ta wordu yená, pasobra e webshop no sa ken e kliente ta). E kaha ta manda e promoshon via e portal di maneho pa e webshop, i esaki ta mand'é pa e klientenan ku a aktivá Oferta komo notifikashon einan; tok riba dje ta habri e menu di e webshop. Despues di algun sekònde e promoshon ta mustra kuantu a yega. Máksimo 3 pa dia, huntu ku loke e negoshi ta manda den e maneho di e tienda; si no, e promoshon ta keda un konsepto ku e motibu serka. E tab Marketing ta presente tambe si solamente esaki ta aktivá (sin karchi di kliente òf marketing pa e-mail). No tin kódigo di deskuento òf selekshon (dia, punto); pa tèst: na bo mes telefòn, aktivá Oferta komo notifikashon den e webshop.
• Outomátiko: un mensahe di aña (riba e dia di aña, un biaha pa aña) i "nos ta extrañá bo" (despues di asina tantu dia sin bishita, un biaha kada biaha ku e kliente ta keda leu). Aktivá/pagá pa mensahe; nan ta sali solamente durante dia (10:00–20:00).
• Kódigo di deskuento personal (opshonal, pa kada mensahe òf promoshon; solamente si Kódigonan di deskuento ta aktivá na Konfigurashon → Negoshi): kada kliente ta haña su mes kódigo, p.e. TERUG-7K4Q2M (dia di aña JARIG-…, promoshon ACTIE-…), na porshento òf un suma fiho, si bo ke ku un suma mínimo di òrdu, pa usa un biaha, válido pa e kantidat di dia skohé despues di manda (standard 30) i na e kaha i/òf den e tienda online. Pone {code} i {geldig} den e teksto unda bo ke nan; si no, e kaha ta pone bou di e mensahe "Uw kortingscode: … (10% korting, aan de kassa of in de webshop, geldig t/m …)". Mira i Manda tèst ta mustra un kódigo di ehèmpel (TERUG-VOORBEELD, no ta funshoná). Si e mandamentu faya, e kódigo no ta wòrdu krea. Na e promoshon ta mustra kuantu kódigo a wòrdu duná i usá.
• Dal afó ta bou di kada mensahe: na un sms "Ke dal afó? Yama ... òf bis'é na bo siguiente bishita", na un e-mail un link pa dal afó na e adrès di e-mail di e negoshi (tambe e boton Dal afó den Gmail i Outlook). Un kontesta riba e e-mail ta bai na e negoshi.
• Privasidat (AVG): solamente klientenan ku pèrmit i un número òf adrès; no tin número ni adrès den e buki di registro, sí pa akshon kuantu a wòrdu mandá i kuantu a faya. Si bo kita un kliente, e ta disparsé tambe for di e lista di manda.
• Kosto: e sms'nan ta bai via bo mes kuenta di CM.com (mas ku 160 karakter = mas sms pa kliente). Gmail i otro server di e-mail tin un límite pa dia; si bo tin hopi kliente, manda den parti.

Propina pa trahadó

Na Ajustenan → Negoshi → Propina (solamente si "Mustra botonnan di propina na kobra" ta sendé) bo ta skohe kon e propina pa trahadó ta sali riba e resultado intermedio (X), e rapòrt Z (bòn i e-mail) i Benta pa periodo (tambe den e CSV):

Sentnan sobrá ta bai na esun mas serka di e siguiente sent, pa e total semper kuadra. Ta un resumen: e kaha no ta paga nada (esei por ku "Plaka for di laña"). Rapòrt Z bieu ta keda manera nan tabata.

Rapòrt Z pa e-mail

Pone un biaha so na Ajustenan → Negoshi → Manda rapòrt Z pa e-mail na e adrès di e-mail di e administradó (mas adrès: koma meimei, maksimo 3). Despues di Sera e dia e rapòrt Z ta bai outomátikamente na e adrès ei, banda di e bòn imprimí. Bashí = no manda, manera semper.

• E mandamentu di e-mail ta sosodé na fondo, pa un server di e-mail pòkpòk no stroba e sera di dia.
• A faya òf bo mester di dje un biaha mas: Rapòrt → Rapòrt Z anterior → (rapòrt) → Manda e-mail atrobe (ku KOPIE riba dje).

Resumen di e dia (opshonal)

Si tin un adrès na Manda rapòrt Z pa e-mail na, bou di dje ta para e marka Ku un resumen kòrtiku di e dia ariba den e e-mail (standard desaktivá). Aktivá = ariba den e e-mail di e rapòrt Z algun liña na idioma simpel, solamente for di e datos propio di e kasa (no AI, nada no ta sali pafó):

• benta, resibunan i kliente i e gasto pa resibu, kompará ku e mesun periodo un siman promé (na porsentahe); si no tabatin nada e tempu ei, esei ta para tambe;
• e 5 produkto di mas bendí, i loke ta sobresalí: produktonan ku a bende por lo ménos 3 mas òf ménos ku siman pasá;
• e kantidat di stornonan (kompará ku siman pasá) i e ora di mas trabou (resibunan i benta).

E rapòrt Z mes (resibu i e-mail) ta keda eksaktamente meskos. Ehempel di awe ta mustra e resumen for di e último sera di dia te awor. E resumen ta na Hulandes, meskos ku e e-mail di e rapòrt Z.

Dashboard

Tab Dashboard den Rapòrt (derecho Benta pa periodo), solamente pa lesa:

• Benta pa ora komo gráfiko: e dia skohé (blou) banda di mesun dia siman pasá (gris). Awe ta wòrdu kompará ku siman pasá te mesun ora, pa e porsentahe ta honesto. Ku ◀ ▶ òf e fecha bo ta skohe un otro dia.
• Blòki: benta (± % kompará ku siman pasá), bòn i promedio pa bòn, gasto promedio pa gas (solamente na sitio; pa hiba/entrega no ta konta) pa e dia ei i pa e periodo skohé.
• Top 10 produkto i ora di mas drùk den e último 7, 28 òf 90 dianan. Ora di mas drùk ta un mapa di kalor dia di siman × ora (benta promedio pa dia habrí) ku e tres oranan di mas drùk ariba, práktiko pa e rooster.

Vale di regalo bendí no ta konta komo benta, deskuento i kabes di menú no ta den e top 10 (manera den e otro rapòrtnan). Un dia ta kore di 00:00 te 24:00.

Reportenan ekstra

Tres tab ekstra den Reporte, kada un por aktivá apart via Konfigurashon → Negoshi → Maneho i reporte → Reportenan ekstra (standart desaktivá: e ora ei no tin tab). Nan ta pidi e mesun derecho ku Benta pa periodo i ta solamente pa lesa. Periodo: e siman aki, siman pasá, e luna aki, luna pasá, e último 90 dianan, e aña aki òf skohe bo mes (máksimo un tiki mas ku un aña).

• Menu engineering: pa produkto kuantu biaha e ta bendí (parti di tur pida bendí) kompará ku kuantu e ta produsí pa pida (márgen = preis di benta sin impuesto menos e preis di kosto). Kada produkto ta haña un klasifikashon: Strea (populár i hopi márgen: laga'é asina), Kabai di trabou (populár, poko márgen: subi e preis un tiki òf hasi'é mas barata), Rompekabes (poko bendí, hopi márgen: pon'é mas den bista) i Kachó (poko bendí, poko márgen: kit'é for di e menu òf remplas'é). Populár = por lo ménos 70% di un parti igual; hopi márgen = por lo ménos e márgen promedio pa pida bendí. E preis di kosto ta bin for di Apicbase (Konfigurashon → Resèt), sino for di e preis di kompra di e produkto (preis di kompra pa empake dividí dor di e kantidat pa empake), sino for di e resèt di ingredientenan ku un preis di kompra (Stòk). Produktonan sin preis di kosto ta apart abou. Opshonal pa kategoria (?groep=).
• Akshon i kódigo: pa kódigo di deskuento, pa akshon di Marketing (e kódigonan personal huntu) i pa happy hour: kuantu biaha usá (resibo; na un happy hour tambe e pidanan), kuantu deskuento, e benta i e promedio pa resibo.
• Desperdisio: kiko a wòrdu kitá for di e stòk (Konfigurashon → Stòk, Kita for di stòk (−)), pa motibu (lèter grandi i espasio no ta importá) i pa produkto òf ingrediente, ku e balor na preis di kosto; i kiko a wòrdu kanselá despues ku e tabata mandá kaba pa kushina òf bar, ku e balor di benta i di kosto.

Deskuento

Un manager òf administradó ta mira den e pantaya di òrdu banda di e total e boton % Deskuento:

• riba e bòn kompleto òf riba un liña;
• komo porsentahe (10, 15, 20, 25, 50, 100% = grátis, òf yena bo mes) òf komo montante fiho;
• semper ku un motibu (Personal, Kliente fiel, Keho, Promoshon, Uso propio òf tek bo mes).

E deskuento ta bin komo su propio liña riba e bòn ("Deskuento 10%", ku e motibu bou di dje) ku mesun tarifa di btw, pa e total i e spesifikashon di btw kuadra. Riba e bòn kompleto e deskuento ta wòrdu repartí pa tarifa di btw. Kita: tok riba e montante di e liña di deskuento. Si un liña ku su propio deskuento wòrdu kanselá, e deskuento ta kai afó tambe. Si bo kita un produkto for di un resibu ku deskuento na porsentahe riba henter e resibu, e kaha ta kalkulá e deskuento ei atrobe riba loke ta sobra (na Bèlgika UC226); un monto fiho ta keda i ta wòrdu repartí atrobe riba e liñanan ora di kobra. Si pa motibu di 100% deskuento no tin nada pa paga, bo ta sera ku "Sera (nada pa paga)". Deskuento ta den e registro, i den e rapòrt X/Z i e resumen di periodo komo "di kual deskuento". Na retorno di un bòn ku deskuento, e deskuento ta bai kuné proporshonalmente.

Kódigonan di deskuento (opshonal)

Kódigo ku deskuento riba henter e resibu, por ehempel pa un akshon (ZOMER10). Aktivá na Konfigurashon → Negoshi → Kódigonan di deskuento (standard desaktivá); e kódigonan bo ta traha na Konfigurashon → Kódigonan di deskuento (derecho Maneha produkto):

• deskuento na porshon òf un monto fiho, eventualmente ku un monto mínimo di òrdu, válido for di/te i máksimo asina tantu biaha (bashí = sin límite);
• pa kódigo: na e kaha i/òf den e tienda online (e kaha ta manda e kódigonan huntu ku e menu; e uso ta konta pa kaha i tienda online huntu).

Riba e pantalla di òrdu tin e boton Kódigo di deskuento (tur hende por drenta un kódigo; e negoshi a traha e kódigo di antemano). E deskuento ta bin komo liña "Kódigo di deskuento CODE" riba e resibu, partí riba e tarifanan di BTW; un kódigo pa resibu, i no mas si a paga (parsialmente) kaba. Si bo kita e liña atrobe òf si e òrdu wòrdu kanselá, e uso no ta konta mas. Kita un kódigo usá ta desaktivá e (e rapòrtnan ta keda kuadra). Tur kos ta den e buki di registro (Kódigo di deskuento). Kódigo: lib/kortingscodes.ts, routes/kortingscodes.ts, Kortingscodebeheer.tsx, KortingscodeDialoog.tsx.

Nan no ta aparesé den e lista na Konfigurashon → Kódigonan di deskuento (e kantidat pa promoshon sí, na Reporte → Marketing) i nan ta pasa pa e tienda online miéntras nan ta válido i no usá.

Rapòrt i sera di dia

Boton Rapòrt den e bara ariba:

• Resultado intermedio (X): benta, btw, manera di pago, pa grupo i e laña di kaha desde e último sera di dia. Por imprimí tambe. No ta sera nada.
• Sera e dia (Z) (manager òf administradó): konta e laña di kaha (e diferensia ku plaka di salida + kèsh ta mustra), yena plaka di salida pa e siguiente dia, sera. E rapòrt Z ta haña un número konsekutivo, ta wòrdu wardá i imprimí riba e printer di bòn. No ta posibel miéntras tin òrdu habrí. Opshonal: Konta pa moneda i biyete (yudansa pa konta) ta yena e montante kontá pa bo; e konta pa moneda/biyete ta sali tambe riba e rapòrt Z. Tek e total bo mes ta traha manera semper.
• Laña di kaha (manager òf administradó, opshonal):
  • Plaka for di laña (deposit na banko, gasto, propina pagá) òf plaka den laña (sèn chikí) ku montante i motibu. E laña ta habri i un bòn ku liña pa firma ta sali pa warda serka e plaka (por paga esaki). E ta konta den spera den e laña i ta riba e rapòrt X i Z pa liña.
  • Yena òf korigí Plaka di salida di awe (normalmente bo ta yena esei na e sera di dia pa e siguiente dia).
  • Habri laña sin benta, ku motibu.
  • Tur kos ta bai den e registro. Si bo no ta usa esaki, e sera di dia ta traha eksaktamente manera promé (plaka di salida + kèsh = spera den e laña).
• Bou di e benta tin e kantidat di gas (personanan di e òrdunan kobrá) i e promedio pa gas, tambe riba e rapòrt X/Z imprimí.
• Benta pa periodo (manager òf administradó): awe, ayera, e siman aki/pasá, e luna aki/pasá, e aña aki òf skohe bo mes di-te. Ta mustra benta, btw, manera di pago, propina, gas, grupo di produkto, pa dia i pa trahadó. Ku Eksportá (Excel/CSV) bo ta haña un archivo pa e kontabilista (punto-koma i koma desimal, ta habri direktamente den Excel na Hulandes).
• Rapòrt Z anterior: lista ku benta i diferensia di kaha; habri i imprimí un kopia (ku "KOPIE" riba dje).

Eksport pa kontabilidat

Reporte → Benta pa periodo → Eksportashon kontabilidat (diario) (derecho Benta pa periodo) ta traha un CSV ku un asiento di diario pa dia, kla pa lesa den e-Boekhouden, Exact, SnelStart, Twinfield etc. (via nan importashon di CSV/memorial), òf un di e formatonan abou (UBL, XAF i kla pa 14 programa).

Pa dia un dokumento (KASSA-JJJJMMDD) ku semper ta kuadra (debe = haber):

Retorno i deskuento ta den e bònnan kaba i ta rebaha e benta. Kolumna: Fecha; Dokumento; Hùrnal; Kuenta; Deskripshon; Debe; Haber; Kódigo di btw; Btw-% (punto-koma, koma desimal). Despues di download, e kaha ta bisa si tin dia ku no ta kuadra òf ku tin un diferensia mas grandi ku rondeo.

Banda di e boton bo ta skohe e formato (e navegador ta kòrda e skohementu). E mesun diario, pero formatiá asina ku e programa por lesa e direktamente. E lista ta mustra solamente e formatonan pa e pais di e negoshi (Konfigurashon → Negoshi), promé e estándarnan (CSV, UBL, XAF), despues e programanan segun alfabèt:

Resumen: kua programa di kontabilidat di kua manera

Pa segmento, segun alfabèt. NL/BE = den ki pais e programa ta funshoná: na Konfigurashon → Kontabilidat → Programa di kontabilidat bo ta mira solamente e programanan pa e pais di e negoshi (programanan hulandes no ta funshoná na Bélgika i al revés). Live = e kasa ta registrá kada dia su so (skohe na Konfigurashon → Kontabilidat → Programa di kontabilidat); riba petishon = tin un API, pero promé e ta pidi un registrashon komo socio òf aprobashon serka e proveedor (laga nos sa). Archivo = e formato na Eksportashon kontabilidat. Unda tur dos ta posibel, bo por usa tur dos. E lista ta den packages/shared/src/boekhoudcatalogus.ts i ta aparesé tambe na Konfigurashon → Kontabilidat.

Laga e kontadó chek e promé importashon. E formato ta den packages/shared/src/journaalexport.ts (ku tèst).

Ajustenan → Kontabilidat (derecho Konfigurá negoshi, pago i printer): kódigo di hùrnal (standard MEM) i e kuenta di lèdger pa kada parti. Bashí = kuenta di ehèmpel (NL: 8000/8010/8020 benta, 1500/1510 btw, 1000 kaha, 1100 pin; BE: 7000xx benta, 451000 btw, 570000 kaha). Laga e kontabilista yena e kuentanan real.

Konekshon ku programa di kontabilidat

Konekshonnan live ku Acumulus, AFAS Profit, Microsoft Dynamics 365 Business Central, Exact Online, Horus, Moneybird, Odoo, QuickBooks Online, SAP Business One, Silvasoft, SnelStart, Twinfield, Xero, Yuki i Zoho Books. Despues di kada dia e kasa ta registrá e mesun asientonan ku e eksport aki riba (benta i BTW pa tarifa, métodonan di pago, propina, rondeo, laña i diferensia di kaha) komo asiento di memorial den e programa skohí, ku e diario i e kuentanan di buki general di Konfigurashon → Kontabilidat. Semper ta aktivá maksimo un programa.

• E lista ta dividí pa segmento (Empresanan chikí i mediano i trahadónan independiente, Internashonal, Enterprise i kadenanan) i ta mustra solamente e programanan ku ta funshoná den e pais di e negoshi; e server ta refusá un programa di un otro pais (400) i no ta registrá kuné (409). Mesora bou di esei e atministradó ta haña eksaktamente e kamponan di e programa ei; konektá i e lista di dianan registrá ta bou di e kuentanan di buki general, i bou di esei e resumen di tur programa pa e pais aki. Si durante e aktualisashon tabata tin dos aktivá (den un version mas bieu esei tabata posibel), Exact Online ta keda aktivá i e otro programa ta bai desaktivá.

• OAuth (Horus, QuickBooks, Twinfield, Xero, Zoho): registrá un app un biaha serka e programa.
• Pa algun programa e kamponan di e API no por wòrdu konfirmá kompletamente for di e dokumentashon públiko (entre otro Horus, Zoho Books, e señal na Business Central i e struktura na SAP Business One): semper laga e kontador kontrolá e promé asiento.
• Exact Online: ta registrá e asientonan komo asiento di memorial den e atministrashon skohí.
  • Skohe na Konfigurashon → Kontabilidat → Programa di kontabilidat → Exact Online (standard Desaktivá). Bélgika: e kasa ta usa outomátikamente start.exactonline.be.
  • Konfigurashon → Kontabilidat → Exact Online: Konektá ku Exact Online ta habri e login di Exact; despues ta pone ku kua atministrashon e kasa ta konektá. Na Diario yena e kódigo di un diario di memorial den Exact (p.e. 90) i sigurá ku e kuentanan di buki general ta eksistí den Exact.
  • Ki ora: mesora despues di Sera dia i despues kada ora, pa tur dia ku a pasa (te ku ayera) desde Registrá desde (standart e dia di konektá; e dianan anterior e kontadó tin kaba). Kada dia un biaha; dianan sin benta ta wòrdu saltá. Registrá awor ta posibel semper.
  • Fout (un kuenta no ta eksistí den Exact, e dia no ta kuadra, no tin internet) ta pará ku e motibu na e dia ei; e kasa ta purba atrobe mas despues, i e dianan siguiente ta warda te ora e logra (asina e órden ta keda bon). Den e buki di registro: "exact_geboekt".
  • E BTW ta riba e kuentanan di buki general di BTW (sin kódigo di BTW, meskos ku den e eksport). Laga bo kontadó chek e promé registronan.
  • Exact: un konekshon ta keda traha mientras e kasa ta us'é (kada 10 minüt un token nobo, kada biaha un refresh token nobo). Si e a wòrdu retirá òf no a wòrdu usá pa demasiado largu, e kasa ta pidi pa Konektá atrobe. Deskonektá ta kita e tokennan; loke a wòrdu registrá ta keda.
• AFAS Profit: número di ambiente (p.e. 12345; produkshon, tèst òf aseptashon), e token di un app-connector ku e UpdateConnector FiEntries i e número di atministrashon (standard 1). Diario = e kódigo di un diario di memorial den AFAS (p.e. 90).
• Diario = número òf nòmber di un diario di memorial; si tin un diario di memorial so, e kasa ta tume esei. Kuentanan di buki general mester ta número.
• Twinfield: drenta ku OAuth. Sin e app ei e kasa no por konektá. E kasa ta buska e cluster i e administrashon (bashí = e promé); diario = e kódigo di un memorial (p.e. MEMO). Ta registrá definitivamente (destiny="final").
• Yuki: yabi di API di e atministrashon (Yuki → Konfigurashon → Webservices); atministrashon bashí = e promé di e yabi ei. Ta registrá un memorial (GeneralJournal); Yuki no ta usa kódigo di diario.
• Ki ora: mesora despues di Sera dia i kada ora, pa tur dia ku a pasa desde Registrá desde (standard e dia di konektá; ku un otro programa atrobe desde e dia ei). Kada dia un biaha pa programa; dianan sin benta ta wòrdu saltá; si tin un eror, e motibu ta na e dia ei i e dianan despues ta warda. Registrá awor ta posibel semper. Den e logbook: "boekhoudpakket_geboekt".
• Yabi i token nunka ta bai na e pantaya (laga bashí ora di konektá atrobe = keda). Riba e kopia di e kasa na e portal no ta wòrdu registrá nada.

Auditfile di kaha (XAA)

Pa negoshinan hulandes, na Reporte → Benta pa periodo banda di e eksportashon kontabilidat tin e boton Auditfile di kaha (XAA): e XML Auditfile Afrekensystemen 3.2 di Belastingdienst (outoridat di belasting hulandes) i e XML Platform (SRA) pa e periodo skohí (maksimo un poko mas di un aña; derecho Benta pa periodo). Esei ta e archivo ku Belastingdienst ta rekomendá pa entregá e datonan di un kaha na un kontrol òf na e kontadó; e reglanan ta den e Handreiking voor een betrouwbaar afrekensysteem (Guia pa un sistema di kaha konfiabel) (docs/xaa).

Den e archivo (auditfile_kassa_<van>_tm_<tot>.xml, skema docs/xaa/XmlAuditfileAfrekensystemen3.2.xsd):

• datonan básiko: e negoshi (nòmber, number di BTW, adrès), e kódigonan di BTW, tur empleado (ku ròl i fecha di kreashon; plus SYSTEEM pa loke e kaha mes ta hasi, manera webshop i konekshonnan) i tur artíkulo ku nan grupo;
• susesonan: tur kos for di e buki di registro den e periodo (drenta i sali, kashi di plaka habrí, sera di dia, konfigurashon i preis kambiá, storno, deskuento, retorno, kopia di resibu, marka entrada i salida ...) i e habrimentu di e dia di kaha ku e fondo di kaha, kada un ku e kódigo di Belastingdienst (18001 drenta, 18003 kashi, 18006 kambio di instalashon, 18008 reporte Z, otro 18999);
• transakshonnan di kaha: kada resibu (benta, retorno i proforma, ku e number di resibu, e empleado i e status fiskal si esei no ta na òrdu) ku tur liña (artíkulo, grupo, kantidat, preis, BTW; tambe deskuento, vale di regalo, títulonan di menu i liñanan kanselá promé ku pago, esakinan ku montante 0), e BTW pa tarifa, e rondamentu, e pagonan pa manera di pago (kèsh, pin, vale di regalo, online; propina separá) i e plaka ku drenta/sali for di e kashi di plaka.

Montantenan ta positivo ku C (benta, risibimentu) òf D (retorno, pago afó); oranan na ora hulandes ku offset. Tur yave ta e id-nan for di e base di datos sin rayita, pues bo por haña nan bèk den e kaha.

Firma (kapítulo 6 di e spesifikashon): si Optimum POS a instalá un sertifikado, e auditfile ta bini firmá den un ènvelop (XML Signature) i e archivo ta yama …_ondertekend.xml; si no, e ta un auditfile simpel, i e kaha ta indiká esei ora di deskargá.

Paga riba kuenta

Kliente komersial (un kompania ku ta laga buska lunch tur siman, un hotèl, un asosiashon) ta kumpra riba kuenta i ta paga despues, ku un faktura. Aktiv'é na Konfigurashon → Fakturanan → Paga riba kuenta (solamente ku Fakturanan aktivá; standard pagá).

• Klientenan: na Reporte → Riba kuenta bo ta registrá e kliente komersial ku e datonan pa e faktura (nòmber, adrès, number di BTW, number di KvK/kompania, Peppol-ID, e-mail), si bo ke un límite (kuantu por ta pendiente máksimo) i un plaso di pago propio (sino esun di e fakturanan), i si e faktura ta wòrdu mandá mesora.
• Kobra: manera di pago Riba kuenta, skohe e kliente (ku loke ta pendiente kaba i e límite). E resibu ta un benta normal: entrada i BTW riba e dia ei, na Bélgika normal via e kaha pretu (zwarte doos), riba e resibu "Riba kuenta". E kaha ta traha mesora e faktura (UBL/Peppol i pa imprimí) ku e monto ku ainda ta pendiente i e fecha di vensementu, i ta mand'é manera konfigurá na e fakturanan (e-mail, Peppol via Billit/Storecove/Banqup òf e adrès propio). Riba kuenta ta un monto pa e resto di e kuenta (promé paga un parti otro manera ta permití), sin propina; bende un vale di regalo no por riba kuenta. Riba e límite e kaha ta nenga.
• Paga: e kliente ta paga den e negoshi ku kèsh, pin òf vale di regalo (Reporte → Riba kuenta → Pago risibí; tambe un parti). Esei no ta un benta nobo ni un resibu nobo: kèsh ta drenta komo plaka den laña (e laña ta habri), tur kos ta riba X i Z bou di Risibí riba kuenta. Si tur kos ta pagá, e faktura ta riba "pagá". Pago online no ta inkluí.
• Transferí: si tin un IBAN na Datonan riba e faktura, e ta aparesé riba e faktura (i den e UBL), ku "Por paga tambe den e negoshi". Si e kliente a transferí, bo ta registr'é ku Pago risibí → Transferí (banko): no den e laña, pero si riba X i Z bou di Risibí riba kuenta. Sin IBAN e ta bisa "Pa paga den e negoshi". Na Bélgika un referensia strukturá (+++123/4567/89012+++, for di e number di faktura) ta aparesé riba e faktura i den e UBL, pa e banko mand'é kuné.
• Banko: registrá transferensianan na faktura sin tek atrobe, mira abou.
• Krédito (plaka di antemano): na Reporte → Riba kuenta → Depositá krédito bo ta pone plaka di antemano riba e kuenta di un kliente, kèsh (e laña ta habri) òf ku pin, p.e. pa un seri di lunch. Na e siguiente benta riba kuenta e krédito ta bai promé for di e faktura; si tin mas riba e faktura, e resto ta keda habrí. E krédito ta serka e kliente (krédito € ...), riba X i Z bou di Risibí riba kuenta (Krédito depositá, Ku krédito di e kliente) i den e diario komo risibí di antemano (standart 1640 / 460000). Na Bèlgika e deposito ta bai komo plaka aden (signMoneyInOut) pa e kaha preta (UC4100).
• Faktura kolektivo (pa kliente, standard pagá): ku Un faktura pa tur resibu e kliente no ta haña faktura ainda na un benta riba kuenta. E resibu ta keda habrí na e kliente (Tiket ku ainda no ta faktura, ta konta pa e límite) i por wòrdu pagá kaba. Ku Traha faktura kolektivo (por ehèmpel na fin di luna) tur resibu habrí ta bin riba un faktura, kada liña ku e number di resibu su dilanti; loke a wòrdu pagá kaba ta aparesé komo pagá. Un retorno pa e kuenta ta aparesé komo liña negativo. Pagá = manera semper un faktura pa kada benta. Na Bélgika un faktura ku tur resibu na e kaha preta (signInvoice, UC4121 i UC4122).
• Bèlgika: si e kliente paga un benta riba kuenta despues (kèsh, pin, vale di regalo òf transferí), e kaha ta reportá esei komo korekshon di pago riba e resibu: for di krédito di kliente pa e manera di pago real (signPaymentCorrection, UC4118).
• Resumen: fakturanan pendiente ku e fecha di vensementu (atrasá na kòrá), pa kliente e fakturanan i pagonan. Na Konfigurashon → Fakturanan un kolumna Pendiente.
• Kontabilidat: den e diario e benta riba kuenta ta bai na Debitornan (standard 1300 na Hulanda, 400000 na Bélgika; por konfigurá na Konfigurashon → Kontabilidat) i e pago di kas, pin, vale di regalo of banko (standard 1050 / 550000) na debitornan. XAA: manera di pago "Riba kuenta".
• Derecho: Kobra riba kuenta i risibí pago riba kuenta (standard atendensia nò, gerente sí). Tur kos ta den e logbook.
• Pagá: e klientenan, fakturanan i pagonan ta keda wardá (tambe den e back-up); e switch ta bai kuné den e eksportashon di konfigurashon, e klientenan nò (nan ta pertenesé na un negoshi).
• Den e tienda online (opshonal, standard desaktivá): ku Tambe den e tienda online kliente komersial ta ordená online riba kuenta (buska i entregá). Na Reporte → Riba kuenta bo ta traha pa kada kliente un kódigo di kliente i bo ta dun'é na e kliente; e kaha ta warda solamente un version enkriptá, p'esei bo ta mir'é un biaha so. Kódigo di kliente nobo = esun bieu no ta funshoná mas; Kita kódigo di kliente = e kliente ei no por ordená online riba kuenta mas. E tienda online ta respetá e límite. Den e ventana Tienda online bo ta kaba un òrdu asina ku Kaba (riba kuenta): kobra riba kuenta, ku e faktura mesora.

Banko: registrá transferensianan na faktura

Na Reporte → Riba kuenta → Banko e kaha ta buska pa kada entrada e faktura riba kuenta korespondiente:

• Lesa estado di kuenta: e archivo for di bo banko na internet, komo CAMT.053 (XML, tur banko na Hulanda i Bélgika), MT940 (.sta/.940) òf CODA (.cod, Bélgika). Solamente entradanan; lesa un estado dos biaha no ta duna liña dòbel.
• Buska: riba e number di faktura òf e referensia strukturá den e deskripshon (sigur), sino riba e monto (i e nòmber): e ora ei ta un proposishon. Kada liña bo por registrá (na e proposishon òf un otro faktura), ignorá òf despues registrá tòg. Registrá = Transferí (banko) riba e fecha di banko, nunka mas ku loke ta habri; no den e laña.
• Konekshon ku banko (PSD2, opshonal): na Konfigurashon → Fakturanan → Konekshon ku banko e kaha mes ta buska kada ora e entradanan via Enable Banking (banko na Hulanda, Bélgika i resto di Europa). Skohe e banko i drenta na e banko (kuenta komersial); e permiso ta bale 180 dia, despues konektá atrobe. Deskonektá ta retirá e permiso; e entradanan ta keda. Sin kontrakt ku Enable Banking esaki ta traha solamente pa bo mes kuentanan (restricted production).
• Registrá outomátiko (standard desaktivá): un entrada ku sigur ta pertenesé na un faktura, e kaha ta registr'é mesora (tambe ora di lesa).
• Permiso: registrá ku Kobra riba kuenta i risibí pago riba kuenta; konfigurá e konekshon ku banko ku Konfigurá negoshi, pago i printer. Lesa, konektá, buska i registrá ta keda den e buki di registro.
• Desaktivá: ku paga riba kuenta desaktivá e kaha no ta buska nada; e entradanan i e konekshon ta keda wardá (tambe den e back-up).

Imágen di kámara den e kaha

Tur imágen di kámara di e negoshi riba un página, sin pantaya òf app apart. Aktivá esaki na Konfigurashon → Negoshi → Pantaya i manehamentu → Imágen di kámara den e kaha (standard desaktivá). Anto e boton Kámaranan ta aparesé den e bara ariba pa esnan ku tin e permiso Mira imágen di kámara (standard gerente i atministradó; na Konfigurashon → Permisonan bo por aktivá esaki tambe pa atendensia). Tur kámara ta banda di otro; primi riba un kámara pa imágen grandi. Desaktivá: e sistemanan di kámara ta keda wardá.

Tambe komo pantaya apart: Riba un pantaya apart ta habri http://<kassaserver>:3000/camera (p.e. un monitor tras di bar), i Riba un tablet òf telefòn ta mustra un QR code: un empleado ta skèn e ku su mes tablet òf telefòn i ta drenta ku su mes kódigo PIN (tambe einan solamente ku e derecho Mira imágen di kámara). Riba un pantaya smal e kámaranan ta bou di otro. Wak Di dos pantaya riba un tablet òf telefòn.

E atministradó ta agregá e sistemanan di kámara ku + Sistema di kámara, ta test nan ku Test i ta skohe pa kada kámara e nòmber i si e ta riba e página:

• Hikvision, Dahua, Axis i Reolink: un kámara òf grabadó (NVR) den e network: e adrès IP (si ta nesesario ku :poort), un usuario (preferibelmente solamente pa mira) i e kanalnan, p.e. 1-8 òf 1,3,5. Login ku Basic òf Digest; https ku un sertifikado propio ta permití.
• Synology Surveillance Station: e adrès di e NAS (standard porta 5000, ku https 5001) i un usuario; Buska kámaranan ta buska e kámaranan ku nan nòmber.
• UniFi Protect: e adrès di e konsola (https) i un kuenta lokal; Buska kámaranan.
• ONVIF: kualke kámara òf grabadó ku ONVIF (p.e. Hanwha, Bosch, Uniview, Annke); Buska kámaranan ta buska e adrès di potrèt pa kada fuente di video.
• Adrès di web propio: un potrèt (JPEG), un stroom MJPEG òf un adrès rtsp://.
• Página web di e sistema di kámara (p.e. Frigate, Blue Iris òf go2rtc): ta habri den e kaha ora bo primi e boton Kámaranan (òf den un bentana apart).

Sin ffmpeg: e potrèt.

Privasidat: e kaha ta buska e imágennan na e sistema di kámara i ta pasa nan djis dilanti; nada no ta wòrdu wardá (no tin grabashon, no tin cache). Usuarionan i kontraseñanan ta keda riba e server i nunka no ta bolbe den pantaya òf den e buki di registro. Den e buki di registro ta keda anotá ken a mira e kámaranan. E página ta pidi e imágennan mes ku un yabi (bálido pa 12 ora, miéntras e empleado ta drentá), pasobra un imágen den e browser no por manda un token. E eksportashon di konfigurashon ta tuma solamente aktivá/desaktivá.

Registro di akshonnan delikado

Rapòrt → Registro (manager òf administradó) ta mustra ken a hasi kiko i ki ora.

• Skohe un periodo (awe, ayera, e siman aki, e luna aki/pasá òf skohe bo mes di-te), kiko bo ke mira (standard Akshon delikado, òf p.e. solamente storno i deskuento, òf Tur) i si bo ke un trahadó so.
• Ariba pa trahadó: kantidat i montante di storno (kitá despues di tuma òrdu), deskuento i retorno, i kuantu biaha e laña a habri sin benta, plaka for di laña, kopia di bòn, pro forma i pago ku pin manual. Tok riba un nòmber pa mira solamente e trahadó ei. Tambe e kantidat di biaha ku a drenta un pincode robes.
• Bou di esei kada akshon ku ora, ken, kiko i un deskripshon fásil pa lesa (p.e. "2x Cola kitá despues di tuma òrdu € 5,60 · mesa 4 · motibu: kliente no a ke").
• Download (CSV) pa Excel.

Kiko ta wòrdu registrá: stornonan, deskuentonan (i kita nan), retornonan, kopia di resibu, pro forma, pin manual, habri laché, plaka aden/afó di laché, plaka di salida, sera dia, move liñanan òf mesanan, sera ordernan bashí, kambia preis/nòmber/BTW di produkto, produktonan nobo òf eliminá, kambia personal i konfigurashon, ahustá oranan di trabou, drenta i sali, kódigo PIN robes i marka entrada i salida. Ku pago riba kuenta tambe: klientenan, bentanan i pagonan riba kuenta, lesa estado di kuenta di banko, e konekshon ku banko i baha for di banko. Ku e aviso pa tempu di preparashon muchu largu: ordernan tardá i despensanan mandá. Ku Mailchimp òf Klaviyo: konektá, skohe lista, deskonektá i dalmentu afó di einan. Ku manehá músika: aktivá/desaktivá i agregá, kambia i kita fuentenan di músika. Ku imágen di kámara: ken a mira e kámaranan (maksimo un biaha pa mitar ora pa empleado), aktivá/desaktivá i e sistemanan di kámara. Ku detekshon: kada alerta, su atendementu i e aktivá i desaktivá.

Detekshon: fraude i desviashon

Konfigurashon → Detekshon. Dos parti, kada un por aktivá separá i standard nan ta pagá; pagando nan ta warda tur alerta i konfigurashon. Ken ku tin e derecho Konfigurá detekshon por konfigurá (standard e manager i e administradó); ken ku por mira e buki di registro por mira i atendé e alertanan. E kaha ta chèk kada 5 minüt (i ku Chèk awor); no riba e kaha di sombra.

Detekshon di fraude i hurto (pa empleado, pa dia di trabou for di 05:00), kada regla por aktivá òf pagá separá ku su mes límite:

• stornonan despues di pro forma: kitá despues ku e kliente a mira e kuenta kaba;
• stornonan, deskuentonan i retornonan: for di asina tantu biaha, òf huntu for di un montante (0 = no riba montante);
• kashi habrí sin benta (boton Habri kashi);
• resibu habrí hopi largu: pidí pero despues di asina tantu minüt ainda no pagá.

Aviso di desviashon, kompará ku e mesun dia di siman i e mesun ora den e último simannan (standard 4; dianan sin benta no ta konta, por lo ménos dos dia pa kompará):

• benta te awor mas ku e margen mas abou (i/òf mas haltu) ku normal, djis for di un benta normal di un montante fihá;
• tempu di kushina (resibu pa kushina te kla riba e pantaya di kushina) di e último ora riba e margen, òf riba un kantidat fiho di minüt;
• stornonan di awe riba e margen, djis for di un kantidat mínimo.

Kada alerta ta bini un biaha (pa regla, empleado i dia; e tempu di kushina maksimo un biaha pa ora) i ta bai na:

• e kaha: boton Alertanan (n) den e bara ariba ku e alertanan di e último dia, siman òf 30 dia; Atendí ku un nota. Otro pantaya ta haña djis un avisito sin nòmber;
• mensahe push ku ntfy (app grátis; ntfy.sh òf bo mes server, topic i si mester un token), Pushover (API-token di e app i e user key) òf Telegram (token di e bot i e chat-id);

Pa kada kanal tin un boton Mensahe di prueba. Tokennan i yabinan ta keda riba e kaha (e pantayanan ta mira djis si nan ta yená). Un alerta no ta prueba: wak e resibu i e buki di registro i papia ku e empleado.

Bòn: kopia i retorno (bòn di krédito)

Boton Bòn den e bara ariba:

• Lista di e bònnan desde e último sera di dia, òf e último 7 dianan; un bòn mas bieu bo ta buska ku su número.
• Imprimí kopia: mesun bòn ku "KOPIE" riba dje (na Bélgika ku e blòki FDM di e bòn original). Ta wòrdu registrá den e registro.
• Retorno / bòn di krédito (manager òf administradó): skohe pa liña kuantu ta bin bek, un motibu i kon e plaka ta bai bek (kèsh, pin, vale di regalo, otro). E bòn bieu ta keda sin kambio: un bòn di krédito nobo ta bin aserka ku su propio número den e hùrnal (tipo di ticket retour, montante negativo, na Bélgika komo NR pa e FDM). Nunka por bai bek mas ku a bende. Den rapòrt X i Z e retorno ta konta komo benta negativo.
• Serka CCV òf un otro terminal: promé paga bek riba e terminal mes i despues marka "Ya pagá bek riba e terminal".
• Kèsh ku rondeo na 5 sent: e montante pa duna bek tambe ta wòrdu rondeá.
• Bèk riba e kuenta (benta riba kuenta): si e resibu tabata riba kuenta di un kliente komersial, bo ta skohe Riba kuenta. E monto ta bai for di e faktura habrí i e kaha ta traha mesora un nota di krédito (den UBL un CreditNote, tipo 381, ku un referensia na e faktura; na Bèlgika firmá ku signInvoice, UC4122). Mas ku loke ta habrí riba e faktura no por bai bèk riba e kuenta; paga e resto bèk kèsh òf ku pin. E nota di krédito ta na Fakturanan i bo ta manda e manera un faktura.

Kashi di plaka ku sensor i kashi pa empleado

Standard desaktivá. Konfigurá na Konfigurashon → Pago → Kashi di plaka.

• Sensor: hopi kashi ta avisá via e printer di bòn si nan ta habrí òf será (ESC/POS DLE EOT 1, porta DK pin 3). Esei ta posibel solamente ku un printer di bòn via e red. Tok Midi: kashi será i Midi: kashi habrí; si tin diferensia, bo ta tuma over e posishon korekto (altu = habrí òf abou = habrí). Ningun diferensia = e kashi (òf kabel) aki no tin sensor. Ningun kontesta di e printer = deskonosí, nunka "será".
  • No kobra miéntras e kashi ta habrí: e server di kaha ta rechasá anto un kobro nobo ku "E kashi di plaka ta habrí ainda".
• Kashi propio pa kada empleado: un printer di bòn por habri dos kashi (kashi 1 i kashi 2). Skohe pa kada empleado su kashi; e kaha ta habri anto, na kobra kèsh, plaka den/for di e kashi i Habri kashi, e kashi di esun ku ta registrá. Na Reporte → Kaha ta aparesé anto Kashi pa empleado: fondo di kaha pa empleado, kèsh (sin e outomat di plaka), esperá, Konta i e diferensia pa persona (den e buki di registro komo ladetelling). E sera di dia normal ta keda meskos.
• Test kashi 1 i Test kashi 2 ta habri e kashi pa kontrolá.
• Habri kashi sin benta (ku motibu) ta semper drenta kaba den e buki di registro i den e auditfile di kaha (XAA), manera Belastingdienst (e Servisio di Impuesto Hulandes) ta eksigí (eksepshonnan manera "no sale").

Parti 3 · Administradó

Kuminsá

Instalá. Bo ta instalá HorecaPOS ku e programa di instalashon pa bo sistema, ku bo ta haña riba e página di download di OptimumPOS: Android (app), Windows (programa di instalashon), macOS (instalador pa Mac ku Apple Silicon i Intel), Linux (instalador gráfiko, òf e pakete .deb òf .rpm), Raspberry Pi (instalador gráfiko òf .deb pa un Raspberry Pi 3, 4 òf 5 ku Raspberry Pi OS di 64-bit) i Chromebook (e app di Android for di Google Play). Skohe pa tur usuario pa un server di kaha ku tablet i e pantaya di kushina ta konektá kuné, òf solamente pa mi pa solamente un kaha riba e aparato ei. E instalador ta pone tur loke ta nesesario, tambe e database, i ta hasi un back-up tur anochi. Pa aktualisá, instalá e vershon nobo: bo datonan ta keda. E programa di instalashon ta start den e idioma di bo kompiuter (si no, Ingles); na Windows i Linux bo por skohe un otro idioma riba e promé pantaya. E kaha ta start despues mesora den e idioma ei. E paketenan .deb i .rpm i e app di Android ta sigui e idioma di e sistema, i si no, Hulandes.

E administradó ta konfigurá e kaha via Ajustenan. Einan tin tab manera Negoshi, Personal, Derecho, Ora di trabou, Produkto, Happy hour, Stòk, Plano, Pago, Printer, Kontabilidat, Back-up, Import/eksport i Database. Kua tab un manager ta mira tambe, ta dependé di e derechonan.

Base di datos. Na Konfigurashon → Base di datos (solamente e atministradó) bo ta skohe entre MySQL / MariaDB, e base di datos integrá i PostgreSQL; ora bo kambia, tur dato ta bai kuné (wak Base di datos). Si Optimum POS a konfigurá un adrès fiho kaba durante instalashon, ta e adrès ei ta konta i no tin kamponan pa yena. Si no, bo mes ta yena Server, Pòrt, Base di datos, Usuario i Kontraseña. E kasa ta warda nan su mes, despues ta mustra nan yená atrobe i semper bo por kambia nan ku Kambia datonan di MySQL/MariaDB òf Kambia datonan di PostgreSQL. Laga e kontraseña bashí ke men: keda ku e kontraseña wardá (pa e mesun usuario). E instaladó i un aktualisashon no ta kambia nada na DATABASE_URL ni na e base di datos skohí.

Kontabilidat

Tur kos pa kontabilidat ta na Konfigurashon → Kontabilidat. Yena huntu ku bo kontador e diario i e kuentanan di buki general. Bo ke pa e kasa registrá e benta di dia kada dia su so? Anto skohe bo programa mas ariba na Programa di kontabilidat, tambe Exact Online: bo ta mira solamente e programanan ku ta funshoná den e pais di bo negoshi. Mesora bou di esei bo ta yena e datonan di e programa ei i konektá. Pa programanan kaminda bo ta drenta (manera Exact Online, Twinfield òf Xero) bo ta yena promé e app: client-ID i sekreto di client. Si Optimum POS a fiha e programa òf un dato durante e instalashon, bo no ta mira e opshon òf e kampo ei. Einan tin tambe un resumen di tur programa: kuales por konektá live i kuales ta haña un archivo. Un archivo bo ta traha na Reporte → Benta pa periodo → Eksportashon kontabilidat: skohe e formato di bo programa, òf UBL (Peppol), XAF òf un resumen di dia. Semper laga bo kontador kontrolá e promé asiento òf importashon.

Pa un negoshi hulandes tin tambe Auditfile di kaha (XAA) einan: e XML Auditfile Afrekensystemen di Belastingdienst ku tur resibu, liña, pago i suseso di e kaha pa e periodo skohí. Bo ta duna esaki na bo kontadó òf, na un kontrol, na Belastingdienst.

Salario i planifikashon

Si bo personal ta traha ku marka entrada i salida, abou na Konfigurashon → Oranan di trabou bo ta haña Salario i planifikashon, den dos bloke. Na Atministrashon di salario bo ta skohe bo programa di salario òf (na Bélgika) bo sekretariado sosial, i bo ta yena pa kada empleado su number di empleado den e programa ei. Despues bo ta traha pa un periodo e archivo ku e oranan trahá i e benta pa empleado, i bo ta importá esaki den bo programa di salario. Na Planifikashon di personal bo ta skohe bo sistema di planifikashon: ku Deputy, Dyflexis i Shiftbase e benta ta bai kada ora outomátikamente, ku e otronan bo ta traha un archivo di benta. Asina bo ta mira den bo planifikashon e gastonan di salario banda di e benta. Si bo ta traha sin marka entrada i salida, bo por manda e benta tòg na bo planifikashon: e ora ei esei ta abou na Konfigurashon → Kontabilidat, na Benta pa bo planifikashon. Si Optimum POS a pone algu fiho durante e instalashon, bo no ta mira e skogencia òf e kampo ei.

Back-up

E kasa ta traha tur anochi outomátikamente un backup, i semper promé ku un update. Na Konfigurashon → Backup bo ta mira tur backup (ki ora, pa ken òf outomátiko, tamaño) i ku Traha backup bo mes ta traha un. Si e último backup ta di mas ku dos dia pasá, un aviso kòrá ta aparesé: tuma kontakto ku Optimum POS.

Restourá ta posibel ku e boton Restourá serka un backup. Tur loke a pasa ná e backup ei ta pèrdè. Bo mester marka esei i drenta bo mes kode PIN atrobe. E kasa ta traha promé un backup di seguridat di e situashon aktual i despues ta saka tur hende. Na Bélgika esaki no ta posibel for di e kasa (e kontadónan di e kaha pretu ta sigui kore); einan Optimum POS ta hasié.

Base di datos

Na Konfigurashon → Base di datos (solamente e atministradó) bo ta mira unda e kasa ta warda su datos. Ariba bo ta mira e base di datos aktual ku programa, version, tabelnan, fila i adrès òf map. Pa e personal i e tabletnan, e kasa ta traha meskos ku kualke base di datos. Riba Windows, macOS, Linux i Raspberry Pi bo ta skohe entre tres base di datos:

• MySQL / MariaDB: un programa separá di base di datos (MySQL 8.0 òf mas nobo, MariaDB 10.6 òf mas nobo), por ehèmpel riba un server òf NAS ku bo tin kaba. E ora ei tur datos ta den tabelnan normal den MySQL òf MariaDB, lesabel pa bo mes programa di rapòrt òf BI. E kasa ta kalkulá eksaktamente meskos ku PostgreSQL.
• Integrá (PGlite): ta den e kasa mes, bo no mester instalá nada. E mihó eskoho pa mayoria negoshi, i e base di datos riba Android i Chromebook.
• PostgreSQL: un programa separá di base di datos riba e PC di kasa òf otro kaminda den e network.

Ki ora MySQL òf MariaDB? Si bo negoshi tin un server MySQL òf MariaDB kaba, si bo atministradó di IT ta traha kuné, òf si bo ke lesa e datos den bo mes rapòrtnan, Excel òf programa di BI. Si bo tin duda, skohe integrá: e ta traha mesora.

Kiko bo mester pa MySQL òf MariaDB?

• MySQL 8.0 òf mas nobo, òf MariaDB 10.6 òf mas nobo, ku por wòrdu yegá for di e server di kasa.
• Un base di datos propio pa e kasa (òf pa e kasanan di un kadena), ku e set di karakter utf8mb4.
• Un usuario di base di datos ku por traha, kambia, kambia nòmber i kita tabelnan den e base di datos ei (CREATE, ALTER, DROP, INDEX, SELECT, INSERT, UPDATE, DELETE), por ehèmpel asina:

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

Si MySQL òf MariaDB ta kore riba otro kompiuter, pone den e último dos liña e adrès IP di e server di kasa na lugá di localhost.

Kambia pa MySQL / MariaDB:

1. Bou di Adrès di MySQL/MariaDB yena e kamponan: Server (standart localhost), Pòrt (standart 3306), Base di datos (standart horecapos), Usuario i Kontraseña; meskos pa MariaDB. Si e adrès ta konfigurá kaba, e kamponan ta yená kaba; si bo laga e kontraseña bashí, e kontraseña wardá ta keda (pa e mesun usuario). E kasa ta warda e adrès su mes; si Optimum POS a konfigurá un adrès fiho kaba, ta e adrès ei ta konta i no tin kamponan. Si e kasa ta traha kaba riba MySQL/MariaDB, bo ta kambia e datonan despues ku Kambia datonan di MySQL/MariaDB. Un konekshon enkriptá Optimum POS ta konfigurá pa bo.
2. Tòka Test konekshon: bo ta mira e programa i e version, òf pakiko e no ta funshoná.
3. Tòka Kambia pa MySQL/MariaDB, marka ku bo ta komprondé i yena bo mes PIN.

Kambia ta funshoná den tur direkshon entre e tres base di datos, i tur datos ta bai kuné:

1. E kasa pa un ratu no ta aseptá petishon (normalmente ménos ku un minüt); despues e tabletnan ta sigui so.
2. Promé e kasa ta traha un back-up di e situashon aktual (na Konfigurashon → Back-ups).
3. Tur kos ta bai den e base di datos nobo i e kasa ta konta pa kada tabel si tur kos ta eksaktamente einan.
4. Solamente ora tur kos ta kuadra, e kasa ta sigui riba e base di datos nobo. Empleadonan ku ta drenta ta keda drenta.

Si algu no ta bai bon, nada no ta kambia i e kasa ta sigui traha riba e base di datos bieu. E base di datos bieu ta keda, p'esei bo por bolbe semper. Datos di kasa ku tabata den e base di datos nobo di MySQL/MariaDB òf PostgreSQL kaba ta wòrdu remplasá. Na Bélgika tambe esaki ta posibel: e kontadónan di e kaha pretu ta pasa eksaktamente.

Back-ups i restourá ta funshoná meskos ku tur tres base di datos (Konfigurashon → Back-ups). Un back-up di un base di datos bo por restourá den kualke otro, tambe un back-up di PostgreSQL den MySQL òf MariaDB.

Kiko tin den MySQL òf MariaDB? Kada tabel di e kasa, ku e mesun nòmber i kolumnanan (oranan na UTC). Kada tabel ta haña e kolumna di yabi ekstra _hp_sleutel, i den e tabelnan di yudansa _horecapos_stand, _horecapos_kolom, _horecapos_reeks i _horecapos_wijziging (registro di kambio, ta wòrdu wardá 14 dia) e kasa ta tene e situashon, e tiponan di kolumna, e kontadónan i e kambionan. Otro programanan ta lesa e datos; ta e kasanan so ta skirbi.

Asina e ta funshoná: e kasa ta kalkulá den un kopia di trabou lihé riba e server di kasa i ta skirbi kada kambio den MySQL/MariaDB den e mesun paso. Si esei no ta bai bon, e kambio no ta tuma lugá i e kasa ta mustra un fout; p'esei tene MySQL/MariaDB alkansabel. Ora e kasa start, e ta lesa tur kos for di MySQL/MariaDB.

Vários kasa riba un base di datos. Meskos ku PostgreSQL, vários kasa por usa e mesun base di datos MySQL/MariaDB, por ehèmpel kada negoshi di un kadena ku su mes server di kasa. Kambionan ta sosodé un despues di otro i kada kasa ta tuma promé loke e otronan a hasi, p'esei nada no ta perde ora kambio ta pasa na mesun momento. Si un kasa restourá un back-up òf un kasa ku un version mas nobo aktualisá e base di datos, e otro kasanan ta lesa tur kos di nobo so; p'esei aktualisá tur kasa na mesun tempu. Un kasa ku tabata pagá mas ku 14 dia ta lesa tur kos di nobo ora e start.

Durante instalashon bo ta skohe tambe e base di datos: MySQL / MariaDB, integrá (rekomendá) òf PostgreSQL ku su adrès. Si no por yega na dje, e kasa ta instalá ku e base di datos integrá; despues bo por kambia aki. Na un aktualisashon e eskoho ta keda.

Konektá tablet i pantaya

• Riba kada tablet/kasa, habri e adrès di e server di kasa, p.e. http://192.168.1.20:3000, i pone esaki komo atahu riba e pantaya di inisio (Chrome: Toevoegen aan startscherm).
• Pantaya di kushina: http://192.168.1.20:3000/keuken.
• Pantaya di kliente (dirigí na e kliente, opshonal): http://192.168.1.20:3000/klantscherm, wak Pantaya di kliente.
• E pantayanan ta haña e server di kasa outomátikamente (mesun adrès, pòrt 4000).

Pantaya pa kliente

Un pantaya na kasa ku ta dirigí na e kliente. E kliente ta mira mas o ménos loke a wòrdu pidí i hopi kla e monto i kon ta paga. E no tin kontrol: e pantaya ta sigui solamente loke e kasa ta hasi. Standard pagá; sende via Konfigurashon → Negoshi → Pantaya di kliente. Riba un kòmpiùter di kasa ku dos pantaya, e kasa ta sende e outomátikamente e promé biaha; si bo paga e despues, e ta keda pagá. Sin pantaya di kliente (pagá, òf no tin un kologá) tur kos ta traha eksaktamente manera semper: e kasa ta manda e imágen den fondo i e personal nunka ta nota un eror òf un pantaya ku falta.

Loke e kliente ta mira:

• Trankil (ningun hende ta pagando): e nòmber di e negoshi i un teksto di bonbiní propio (Konfigurashon → Negoshi; bashí = "Bon biní").
• Pidi: e produktonan ku kantidat i monto (liña igual huntu, un menu komo un liña ku e partinan chikitu bou di dje, deskuento komo un liña), i grandi e tòtal. Loke a paga kaba ora di partí e pago ta bou di dje. Ku Konfigurashon → Negoshi → Potrèt di produkto → riba e pantaya di kliente tin un potrèt chikitu serka kada produkto.
• Paga: e método di pago (Pin, Kèsh, Bon di regalo), e propina i grandi Pa paga. Kèsh: loke e kliente ta duna i loke e ta haña bèk, apenas esei ta yená na kasa. Pin: "Sigui e instrukshonnan riba e mashin di pin".
• Danki: despues di paga, algun sekònde "Danki!" ku e monto pagá (kèsh: loke e kliente ta haña bèk), despues atrobe e pantaya trankil.

Konektá, na dos manera (tur dos ta wòrdu konfigurá riba e aparato mes):

• Di dos monitor na e kòmpiùter di kaha (Windows, Linux/Raspberry Pi, macOS): outomátikamente. Ora di drenta i despues di instalashon, e kaha ta pone e pantaya di kliente kompletamente riba e pantaya mas chikitu ku no ta e pantaya prinsipal (si nan ta mesun grandi, esun mas na man drechi); riba Windows semper riba un otro pantaya ku esun di e kaha (e kaha ta riba e pantaya di toke i tambe ta habri su mes ora di prende). Tamaño i posishon ta bini di e sistema, pues tur formato ta funshoná. Sin di dos pantaya nada no ta pasa. Riba Windows un pantaya di kliente sera ta bolbe di su mes; riba Linux i macOS e atajo HorecaPOS pantaya di kliente den e menu ta poné bon atrobe. Riba Windows e ta habri den e modo kiosko di Chrome (òf Edge): pantaya kompleto, sin bara di título i sin bara di tarea (sera ku Alt+F4). E ta sigui e kaha riba e mesun kòmpiùter sin kódigo di konekshon.
  • Den kualke browser, primi largu no ta habri e menu di browser niun kaminda i no ta sali ningun pregunta pa tradusí e página.
  • Kaha sera = pantaya di kliente sera. Si e software di kaha para (Rekomensá, un aktualisashon, e kaha a para òf a wòrdu kitá), e pantaya di kliente tambe ta sera despues di poko mas ku 10 sekònde; ora e kaha ta kore atrobe, e ta bolbe su mes. Riba Windows e ta sera tambe si bo sera solamente e bentana di e kaha. Bou di Wayland (Linux) e kaha no por sera e bentana su mes.
  • Pantaya di kliente a sera pa eror? Riba Windows e ta bolbe su mes despues di algun sekònde, miéntras e kaha ta habri i e di dos pantaya ta konektá.
  • Semper un solo pantaya di kliente. Riba Windows e pantaya di kliente ta solamente den e modo kiosko riba e di dos pantaya. Un pantaya di kliente den e bentana di e kaha (por ehèmpel restorá pa Edge despues di un kòrtamentu di koriente, òf habrí ku e boton den e kaha) ta sera su mes denter di algun sekònde; e pantaya di kliente korekto ta tuma su lugá anto.
  • Ningun hende no a drenta = solamente e bonbiní. Si e kaha ta riba e pantaya di kódigo PIN (tambe despues di un rekomensamentu òf sali), e pantaya di kliente ta mustra solamente e teksto di bonbiní, nunka e kuenta di promé.
  • Na Windows bo por tambe paga e habrimentu outomátiko ku e marka Pantaya di kliente outomátiko ... den e instalador.
  • Na Linux e kaha ta move e bentana ku wmctrl (e ta bini huntu ku e pakete). Bou di Wayland (por ehèmpel Raspberry Pi OS ku labwc) esei no ta posibel: pone e pantaya di kliente bo mes un biaha riba e di dos pantaya (e browser ta kòrda esei), òf skohe X11 den raspi-config. Na macOS e Mac ta pidi permiso e promé biaha na Aksesibilidat.
  • Ku man: Ahustenan → Negoshi → Pantaya di kliente → Habri pantaya di kliente (di dos monitor). Den Chrome i Edge (tambe riba un Chromebook) e boton ta pone e bentana mesora riba e pantaya di kliente (e promé biaha e browser ta pidi permiso); un klek riba e pantaya di kliente ta hasié kompletamente grandi. Den otro browser: lastr'é i primi F11.
• Kaha Android ku un pantaya di kliente inkorporá (por ehèmpel Sunmi D2/T2) òf un monitor via HDMI/USB-C: tambe outomátikamente. Asina e app ta riba un kaha, e pantaya di kliente ta aparesé riba e di dos pantaya; konektá i deskonektá ta funshoná mesora.
• Sunmi T1 mini / T2 mini ku e displèy chikitu di teksto (2 liña): e app ta mustra e suma outomátikamente: Total, Pa paga, ku plaka kèsh Bùelta, despues di paga Danki! i ora e ta trankil e nòmber di e negoshi. E pantaya di kliente mester ta sendé.
• iPad (pantaya di operashon) ku un pantaya eksterno via HDMI/USB-C òf AirPlay: e app ta pone e pantaya di kliente outomátikamente riba e pantaya ei (prepará; e app di iOS no a sali ainda).
• Chromebook: komo pantaya di operashon den Chrome, e boton Habri pantaya di kliente (di dos monitor) ta funshoná manera ariba. Den e app di Android e pantaya di kliente ta aparesé outomátikamente riba e di dos pantaya asina ChromeOS pasa e pantaya ei pa app di Android; si e no hasi esei, usa un aparato apart ku kódigo di konekshon.
• Aparato separá (tablet òf un PC propio banda di e kasa): habri http://<kassaserver>:3000/klantscherm. E pantaya ta mustra abou na banda drechi un kode di konekshon di 6 karakter. Yena esaki na kasa na Konfigurashon → Negoshi → Pantaya di kliente → Konektá. Deskonektá ta pone e pantaya bèk riba e kode di konekshon. E konekshon ta wòrdu wardá pa kasa (den e browser di e kasa ei), p'esei kada kasa por tin su mes pantaya di kliente.

E pantaya di kliente no ta pidi kode PIN (no tin nada pa opera) i ta mustra solamente e imágen di e kasa na kua e ta konektá. E imágen ta solamente den e memoria di e server di kasa; despues di un restart e pantaya ta bashí te ku e siguiente kambio. E konfigurashon (sendé/pagá i teksto di bonbiní) ta bai huntu ku e backup i ku Importá/eksportá (Otro konfigurashon).

Resibo digital via QR (opshonal)

Standart desaktivá. Aktivá via Konfigurashon → Negoshi → Kushina i pantalla di kliente → Resibo digital (e opshon ta aparesé ora e pantalla di kliente ta wardá komo aktivá). Despues di paga, na Danki! tin un kódigo QR; e ora ei e ta keda 45 sekonde na pantalla en bes di algun sekonde. E kliente ta skan'é ku su mes telefòn i ta mira e resibo, eksaktamente manera e resibo di papel (mesun teksto, na un kaha Belga tambe ku e blòki FDM). Riba e telefòn e por imprimí e resibo, warda'é komo pdf òf baha'é komo archivo di teksto.

• E ta pasa via e portal di maneho: https://kassa.<portaal>/__bon/<kassa>/<sleutel>. P'esei e kaha mester ta konektá ku e portal; si no, no ta sali kódigo QR i nada no ta kambia.
• E yabi ta kasual i imposibel pa rei, i ta funshoná 30 dia. Despues e kaha ta kit'é outomátikamente. E portal no ta warda nada.
• Ta funshoná ku un di dos monitor i ku un pantalla di kliente separá. E resibo di papel i e resibo pa e-mail ta keda funshoná normal.

Pantaya di kliente den reposo: presentashon di diapositiva (opshonal)

Standart desaktivá. Aktivá via Konfigurashon → Negoshi → Kushina i pantalla di kliente → Pantaya di kliente den reposo. Si no tin kuenta riba e pantalla di kliente, e diapositivanan ta kambia (standart kada 8 sekonde, por ahustá di 4 te 60):

• Akshonnan: e happy hournan (si happy hour ta aktivá), ku e deskuento, e dianan i oranan i e produktonan òf gruponan; esnan di awor ta bin promé, ku "Awor!".
• Produktonan destaká (máksimo 12, por ehempel nobo riba e menu), ku preis i (si potrèt di produkto riba e pantalla di kliente ta aktivá) e potrèt. Un produkto ku a bende kompletamente e pantalla ta salt'é.
• E karchi di spar: punto pa euro, e rekompensa i e karchinan di stèmpel (solamente si e karchi di kliente ta aktivá).
• Teksto propio: máksimo 5, kada un ku su mes diapositiva (por ehempel "Nobo for di djabierne: nos menu di verano").

Sin diapositiva e pantalla di kliente ta mustra e pantalla di bon bini, manera semper.

Happy hour

Standard pagá. Sende via Konfigurashon → Negoshi → Usa happy hour; despues e tab Konfigurashon → Happy hour ta aparesé.

• Pa happy hour: nòmber (ta bai riba e resibu), dianan, di–te (por pasa mei anochi, p.e. 23:00–01:00), deskuento na % òf un preis fihá, i pa kua kategoria i/òf produkto separá.
• Den e periodo ei, e kasa ta kalkulá outomátikamente e preis di happy hour ora di tek (nunka mas karu ku normal; ku un preis fihá, opshonnan ta wòrdu sumá manera normal). Riba e boton di produkto e preis bieu ta tachá ku e preis nobo i HH; den e òrdu i riba e resibu tin e nòmber di e happy hour. Loke a tek kaba ta keda ku su preis.
• Oferta di dia: marka Henter dia (00:00–24:00) i skohe e dia(nan), p.e. tur djamars spareribs pa un preis fihá.
• Temporada: marka Djis den un temporada (tur aña) i skohe di i te ku (dia i luna, p.e. 1 yüni te ku 31 ougùstùs; pasa kambio di aña ta permití, p.e. 1 desèmber te ku 28 febrüari). Pafó di e temporada e happy hour no ta konta.
• Kambionan ta bai den e registro.

Partinan di dia i temporada

Standard pagá. Sende via Konfigurashon → Negoshi → Partinan di dia i tipo di òrdu → Produkto pa parti di dia i temporada; despues e tab Konfigurashon → Partinan di dia ta aparesé. Si bo paga'é, tur produkto ta semper na benta atrobe i e partinan di dia ta keda wardá.

• Pa parti di dia: nòmber (p.e. Desayuno, Lunch, Sena, Menu di zomer), dianan, di–te (por pasa mei anochi; Henter dia = 00:00–24:00), si bo ke un temporada (tur aña, dia i luna), i kua kategoria i/òf produkto separá ta pertenesé na dje.
• Produkto i kategoria ku ta den un òf mas parti di dia, ta na benta djis ora un di e partinan di dia ei ta kore; loke no ta den ningun parti di dia, ta semper na benta. E pantaya di òrdu ta mustra djis loke ta na benta awor i ta kambia so ora un parti di dia kuminsá òf terminá; e server ta rechasá e resto ("awor no ta na benta, djis na Desayuno").
• E tienda online ta mustra i kobra e mesun produktonan (na e momentu di ordená).
• Un otro preis riba un dia òf den un temporada ta un happy hour (oferta di dia, mira ariba).
• Menu pa lokal: kada kaha (sukursal) tin su mes produkto, partinan di dia i preis.
• Kambionan ta bai den e registro.

Produkto i preis pa tipo di òrdu

Standard pagá. Sende via Konfigurashon → Negoshi → Partinan di dia i tipo di òrdu → Produkto i preis pa tipo di òrdu. Si bo paga'é, tur kaminda e preis normal ta konta atrobe i tur kos ta na benta tur kaminda; e preisnan yená ta keda wardá.

• Na Konfigurashon → Produktonan pa produkto: Preis pa hiba i Preis pa entrega (bashí = e preis normal) i Bendé pa (pa kome aki, pa hiba, entrega; mínimo un). Na un kategoria tambe Bendé pa, pa tur produkto den e kategoria ei.
• Na un òrdu pa hiba òf entrega, e pantaya di òrdu ta mustra e preis di e tipo di òrdu ei i djis loke ta wòrdu bendé eiden; e server ta kobra e preis ei i ta rechasá e resto. Happy hour, menu i opshon ta kalkulá ku e preis ei.
• E tarifa di BTW pa hiba (na e produkto) ta separá di esaki, manera semper.
• E tienda online ta mustra na bini buska i entrega e preis i produktonan di e opshon ei (ora bo kambia, e página di menu ta karga di nobo), i na mesa esnan di pa kome aki.
• Eksportashon i importashon di e konfigurashon (Konfigurashon → Importá/eksportá) ta inkluí e preisnan pa tipo di òrdu, "bendé pa", e partinan di dia i e temporada di happy hour.

Menú

Standard pagá. Sende via Konfigurashon → Negoshi → Usa menu.

• Un menu ta un produkto normal (ku e preis di menu) kaminda bo ta konfigurá partinan bou di Konfigurashon → Produkto → (produkto) → Menu:
  • fihá: semper e produkto aki (p.e. "Bebida: Biña di kas");
  • na eskoho: skohe 1 (òf mas) for di un kategoria, eventualmente limitá na sierto produkto (p.e. "Plato prinsipal: skohe 1 for di Plato prinsipal").
  • Pa parti e tanda (1 = mesora, 2/3 = warda te ora di yama).
• Ora bo tek e menu, bo ta skohe e platonan pa kada parti. Pa kada plato (tambe e fihá) bo por skohe e opshonnan manera ku un produkto separá (manera di kushiná, keshi ekstra; opshon obligatorio mester ta skohí) i un nota. Preis ekstra di opshon ta bin riba e preis di menu. E menu ta bin komo un liña ku e platonan (i nan opshonnan) bou di dje.
• E platonan ta bai komo liña separá na kushina/bar (bon di kushina i pantaya di kushina), den nan mes tanda. E liña di menu mes nò.
• Pa BTW, e preis di menu ta wòrdu partí riba e partinan segun proporshon di nan preis normal, asina kuminda i bebida kada un tin e tarifa korekto. Riba e resibu tin e menu ku e preis tòtal i e platonan bou di dje.
• Si e menu mes tin opshon (p.e. tamaño), bo ta skohe esakinan ariba den e bentana di menu. Nan ta serka e liña di menu riba e resibu, i serka kada plato di e menu riba e bon di kushina i e pantaya di kushina komo "(menu)".
• Kita/storno ta pa henter menu (tek riba e liña di menu).
• Parti / move: skohe e liña di menu; e platonan ta bai kuné. Ku 2× mesun menu bo por move 1 tambe (kabes i platonan ta wòrdu partí).
• Sin konekshon bo por tek menu manera normal; nan ta wòrdu wardá riba e tablet i mandá apenas e konekshon bolbe (manera produkto separá).
• Happy hour por konta tambe pa un menu.

Resèt i preis di kosto (Apicbase)

Konekshon ku Apicbase (resèt, preis di kosto, stòk i kompra) via e Generic POS API di Apicbase (standard desaktivá, kada parti aparte aktivá òf desaktivá). Konfigurá na Konfigurashon → Resèt (derecho Konfigurá negoshi, pago i printernan). E kaha mes ta papia ku Apicbase (solamente tráfiko saliente, no ta nesesario portal).

1. Konektá (tur kos pa yena dor di e atministradó), na un di tres manera:
   • Pega token: den Apicbase Library Settings → API Settings → New token → Service Account Token (scopes accounts, library, sales); pega e access token i refresh token;
   • Drenta ku e propio API-app di e negoshi (client-id i client secret for di API Settings): Drenta Apicbase, i pega e kódigo ku Apicbase ta mustra despues;
   • Un token vensí (despues di 7 dia) e kaha ta renobá outomátikamente ku e refresh token.
2. Outlet: Buska Outlets i skohe e outlet di e negoshi aki. E kaha ta pone e POS einan riba Generic POS API ku su mes location-id (por yena; standart HORECAPOS-…, úniko pa kada kaha).
3. Aktivá, ku checkbox:
   • Produktonan, gruponan i opshonnan pa Apicbase: kategorianan, produktonan (PLU = e number PLU di e produkto, si no e kódigo, si no e id), opshonnan komo modifiers, ku preis i BTW. Outomátiko despues di kada kambio (despues di un minüt) i tur dia. Despues den Apicbase bo ta konektá kada produkto di kaha ku un resèt;
   • Kada resibu pagá pa Apicbase: esun di mas bieu promé, máksimo 100 pa biaha, den un kuartu di ora despues di pago (i kada 5 minüt). Deskuento ta wòrdu partí riba e liñanan; montonan habrí, kargo di empake desechabel i depósito ta komo produkto separá den Apicbase; produktonan pisá komo 1 pida ku e monto total. Si e no logra, e kaha ta para (Apicbase ke e resibunan na órden) i ta purba atrobe despues: e pago no ta nota nada. Ora di aktivá bo ta skohe for di ki dia (standart for di awor);
   • Buska preis di kosto pa porshon bèk (kada 6 ora): pa kada resèt konektá e food cost (ingredientenan i pèrdida), ku gastu di personal, e preis di benta i e márgen segun Apicbase. Kalkulá ku e suplidó di mas barata, e último preis ordená òf e balor promedio di stòk;
   • Tuma preis di benta di Apicbase (standart desaktivá): pone e preis di benta di produktonan konektá den e kaha (ta keda registrá den e buki di registro).
4. Abou: Preis di kosto pa produkto ku preis di kosto, preis di kosto ku personal, preis den kaha, preis di kosto % i márgen. Botonnan Manda katálogo awor, Manda resibunan awor i Buska preisnan di kosto awor.

Kódigo: apps/pos-server/src/lib/apicbase.ts, routes/apicbase.ts; pantaya Apicbase.tsx. Buki di registro: Apicbase. Kondishon: e módulo API di Apicbase. Pa e app di Pin Voordeel pa tur kliente: sosiedat i sertifikashon serka Apicbase (wak e backlog). Dokumentashon: https://developers.apicbase.com/docs/generic-pos-api-guide

Software di hotel: pone riba e kamber

Pa un restorant òf bar na un hotel: pone e kuenta riba e kamber di un invitado. Standart desaktivá: Konfigurashon → Hotel (derecho Konfigurá negoshi, pago i printer).

• Un lista ku tur software di hotel (Software di hotel ku e hotel ta usa). Konekshonnan integrá:
  • Mews (Connector API: client token i access token, e service di e restorant i pa kada tarifa di BTW e kódigo di BTW di Mews), apaleo (bo mes app ku client-id i client secret, e property-id; pa kada tarifa di BTW si ta nesesario e tipo di BTW) i Cloudbeds (yabi di API i property-id), kada un ku un ambiente di tèst i un ambiente real;
  • Oracle OPERA Cloud (OHIP), protel (protel I/O), RoomRaccoon, Booking Experts, Amadeus (XMLPOS), VIPS, Stayntouch, Clock PMS+, Guestline (Rezlynx), Hotelogix, eviivo, Little Hotelier, Shiji i Infor HMS (Databridge). Despues di skohe, ta aparesé eksaktamente e kamponan ku ta pertenesé na e software di hotel ei (yabi, id di hotel, si ta nesesario e adrès di nan API i pa kada tarifa di BTW nan kódigo), ku un splikashon kòrtiku di kiko bo ta pidi na e proveedor. E konekshonnan aki a wòrdu traha segun e dokumentashon di e proveedornan; laga e proveedor konfirmá e konekshon i purba promé ku Test konekshon i un resibu;
  • un demo (kuater suite, kamber 4 te 7) pa purba;
  • Sirvoy, komo mitar konekshon i solamente ku Sirvoy Pro. Sirvoy no tin API pa un kaha pone algu riba un reservashon, ni ku un archivo (e import di CSV ta traha solamente reservashon nobo). Asina e kaha ta konosé e invitadonan (kamber, nòmber, yegada, salida): buska na Riba e kamber, i e outoservisio na e kiosko i den e tienda online ta traha normal. E resibu no ta drenta Sirvoy di su mes: despues di kobra e ta na Konfigurashon → Hotel bou di Ainda pa pone den Sirvoy, ku e kamber, e invitado, e number di resibu i e suma pa tarifa di BTW. E hotel ta pon'é ku man komo èkstra riba e reservashon i ta klek riba Ta aden (bai bèk ku Ainda nò). Mester:
    1. preferiblemente un kaha ku ta konektá ku e portal di maneho: anto e adrès ta pasa via e portal (https://<portaal>/hotel/<kassa-id>/sirvoy?sleutel=...) i no tin mester di habri un port den e hotel. Sino e kaha mes mester ta alkansabel for di internet via https (domein propio ku sertifikado òf port forwarding; Sirvoy ke TLS 1.2 òf mas haltu) i bo ta yena e adrès ei;
    2. E adrès ta wòrdu mustrá un biaha so; e kaha ta warda solamente e hash. Traha un adrès nobo = esun bieu no ta traha mas;

Sirvoy ta manda algu solamente ora un reservashon kambia: reservashonnan di promé ku e konekshon e kaha ta konosé solamente despues di un kambio den Sirvoy. Mensahenan por yega den otro òrdu; un mensahe mas bieu (generatedAt) ku loke e kaha tin kaba ta wòrdu saltá. Den e hotel = no kanselá i no check-out, check-in òf yegada awe òf mas tempran, i salida awe òf mas lat. Test konekshon ta bisa kuantu reservashon a drenta.

Tur software di hotel ta di kumpra na Hulanda i/òf Bèlgika. Test konekshon ta kontrolá e datonan. Kódigo pa kada konekshon: apps/pos-server/src/lib/pms/<naam>.ts.

• Outoservisio (standart desaktivá): e invitado di hotel mes ta pone su òrdu riba su kamber, na e kiosko i/òf den e tienda online (pa hiba i entrega, no ora di ordená na mesa). E ta yena su number di kamber i su fam; e kaha ta kontrolá serka e software di hotel si e invitado ei ta keda awor den e kamber ei. Ku un máksimo pa kada òrdu (standart € 150), i despues di 5 purba robes den un kuarto di ora promé bai na mostrador. E mensahe nunka ta bisa ken ta keda den un kamber.
• Kobra: si e konekshon ta aktivá, tin e manera di pago Riba e kamber. Buska e invitado pa nòmber òf number di kamber (solamente invitadonan ku ta keda den e hotel awor) i tok riba Pone riba kamber .... E kaha ta registrá e resibu pa tarifa di BTW riba e kuenta di hotel di e invitado; e invitado ta paga ora di check-out.
• Bèlgika: si e òrdu ta na mesa kaba serka e kaha preta, e ta bai promé for di e mesa pa e kamber (signCostCenterChange pa ROOM, UC4101); e resibu ta bai komo krédito di kamber (ROOM_CREDIT) pa e kaha preta.
• Si registrá den e software di hotel no ta bai (no tin internet), e benta ta eksistí tòg i e registro ta komo Faya na Konfigurashon → Hotel, ku Atrobe.
• Reportenan i kontabilidat: Riba e kamber (hotel) ta un manera di pago propio riba e reporte X i Z, den e resumen di dia i e auditfile (XAA).

Kódigo: apps/pos-server/src/lib/hotel.ts, routes/hotel.ts, e konekshonnan den lib/pms/, katálogo packages/shared/src/hotelcatalogus.ts; pantaya Hotel.tsx. Buki di registro: Hotel. Sekretonan (tokens) ta solamente den e base di datos, nunka riba e pantaya.

Maneho di biña ku Vinify

Konfigurashon → Maneho di biña (standard desaktivá; desaktivá ta warda tur kos). Vinify ta tene kuenta di e bodega di biña, e karta di biña i e stòk i ta e fuente prinsipal di e biñanan. Segun e eksigensianan di POS di Vinify, e kasa ta ofresé un API ku kua Vinify por:

Drenta, tur tres manera ku Vinify konosé (e atministradó ta aktivá kua):

1. API-id i API-yabi (X-Api-Id i X-Api-Key, òf Authorization: Bearer <id>:<sleutel>);
2. API-yabi i API-secret ku un firma: X-Api-Key, X-Timestamp i X-Signature = hex HMAC-SHA256(secret, <timestamp>\n<METHODE>\n<pad met query>\n<sha256 van de body>), máksimo 5 minüt bieu.

E kasa ta krea e yabi i e secret (mustrá un biaha); e pantayanan ta mira so si nan ta yená. Alkansabel via e portal na https://<portaal>/vinify/<kassa-id>/... (ningun pòrt habri den e negoshi; e adrès ta den Konfigurashon → Maneho di biña). Kua produkto ta biña: loke Vinify ta krea, plus e gruponan ku bo marka. Si Vinify duna un adrès pa manda benta, e kasa mes ta manda nan tambe (push, ku un token): despues di kada risibu pagá i kada 5 minüt loke ainda no a logra. Vinify ta aktivá e konekshon ku HorecaPOS (hello@vinify.no). Tur kos den e buki di registro. No konfundí ku Vinify.nl, un tienda di biña online: e ta serka e suplidónan (Pidi na suplidónan).

Drenta adrès lihé ku kódigo postal i número di kas

Aktivá na Konfigurashon → Negoshi → Drenta adrès lihé (standard desaktivá; solamente pa un negoshi na Hulanda). Tipiá kódigo postal i número di kas (tambe ku lèter òf adishon, p.e. 12A òf 12-1) i primi Buska adrès: kaya, número di kas, kódigo postal i lugá ta wòrdu yená. Si tin mas adrès riba e número ei (12, 12A, 12B), bo ta skohe esun korekto. Despues bo por ainda kambia tur kos bo mes.

• Na e datonan di e negoshi (Konfigurashon → Negoshi, ariba di e adrès).
• Na un kliente di e karchi di kliente: na e kasa na un kliente nobo i na Reporte → Klientenan. Pa esei klientenan ta haña un adrès (opshonal): kaya i número di kas, kódigo postal i lugá.
• E adrèsnan ta bin for di e Locatieserver di PDOK, ku ta grátis (e adrèsnan ofisial di Hulanda, BAG): no tin mester di kuenta ni yabi, sí di internet. Sin internet òf pa un adrès belga bo ta tipiá e adrès simplemente bo mes.

Aviso ora tin un vershon nobo

Sende na Konfigurashon → Negoshi → Aviso di update (standard desaktivá).

• Kasa aktualisá: si e server di kasa a haña un update miéntras un tablet ainda tin e pantayanan bieu habrí, ariba ta para "E kasa a wòrdu aktualisá (version …)" ku Renobá. E tablet ta chek kada 5 minüt, ora e pantaya bolbe ta visibel i despues di un restart di e server.
• Update disponibel: si e kasa ta konektá ku e portal di maneho (PORTAAL_URL/PORTAAL_SLEUTEL) i NIEUWSTE_VERSIE ta yená einan, esun ku mag maneha konfigurashon ta mira "Update disponibel: version …" (ku e splikashon for di UPDATE_NOTITIE). Despues ta skonde e aviso riba e tablet ei te ora tin un version mas nobo. Aktualisá ta bai manera semper ku scripts\windows\update.cmd (wak Update).

Plataforma di reservashon

Reservashon di TheFork, Formitable, Zenchef, Resengo (Bélgica so), OpenTable (Hulanda so), PlanPanther, RestoManager i Aqqo (Hulanda so) ta drenta outomátikamente den e kasa i riba e plano di sala. Pone aan na Konfigurashon → Plataforma di reservashon (standart ta af). Ta funshoná solamente si Reservashon ta aan.

• Pais di e negoshi: bo por skohe solamente plataforma ku ta funshoná den e pais di e negoshi (Resengo solamente den Bélgica, OpenTable i Aqqo solamente den Hulanda). E server ta kontrolá esei tambe.
• Varios plataforma na mes tempu: bo por konektá varios plataforma banda di otro, por ehempel TheFork i Formitable. Dos plataforma nunka ta haña e mesun mesa den e mesun tempu; anto e di dos reservashon ta drenta sin mesa.
• + Konektá plataforma: skohe e plataforma i yena e datos. Sekreto (Client secret, yabi di reportá bek) nunka ta aparesé den e resumen; laga bashí = tene, Bora = kita.
• TheFork (API B2B públiko): Restaurant-UUID, Client ID i Client Secret (pidi na TheFork). Si e kasa kansela, e ta kansela na TheFork tambe.
• Formitable, Zenchef, Resengo, OpenTable, PlanPanther, RestoManager, Aqqo: nan API ta solamente pa partner òf no ta públiko (PlanPanther, RestoManager i Aqqo: un konekshon ku kasa ta bai den kombersashon ku nan). Evento di Formitable (booking.created, .changed, .canceled, .checkin, .checkout) ta wòrdu rekonosé.
• Riba e plano di sala: si un mesa den e kasa tin e mesun nòmber ku e mesa di e plataforma i e ta liber den e periodo ei, e reservashon ta bai na e mesa ei; si no, sin mesa (skohe esaki na yegada). Un reservashon ku drenta atrobe ta wòrdu aktualisá, no dòbel. Den e resumen ta para "via TheFork".
• Status: si e plataforma kansela òf reportá un no-show, e kasa ta tum'é over. Loke den e kasa a yega kaba, ta keda yegá.
• Reportá bek (no-show bek): yena un adrès di reportá bek (por ehempel di bo servisio di integrashon). E kasa ta manda kada kambio for di e kasa (yegá, no-show, kanselá, pagá ku suma) komo JSON: { platform, id, status, statusEn, bedrag, valuta, tafel, tijdstip, gemeldOp } (suma na sèn, solamente ora pagá), ku Authorization: Bearer <terugmeld-sleutel> si bo yen'é. Si e no logra, e kasa ta purba atrobe kada minüt i e fout ta para na e plataforma. Loke a bini di e plataforma mes no ta wòrdu mandá bek.
• Reservashon di prueba: ta traha un reservashon manera e plataforma lo a mand'é.
• Kita: e konekshon i e yabi ta bai; e reservashonnan ta keda.
• Tur kambio ta den e logbuk (sin sekreto).

Programa di lealtat i review

Dos switch apart na Konfigurashon → Punto i review (tur dos standard desaktivá; e ora bo no ta mira nada di nan na ningun parti). Si bo paga nan, e konfigurashonnan i loke a sosodé kaba ta keda wardá.

Programa di lealtat di otro plataforma: e kliente ta spar punto na Joyn (Bélgika) i/òf Piggy (Leat; Hulanda i Bélgika). Esaki ta apart di e karchi di kliente di e kaha mes; esei por ta aktivá banda di dje.

• Mas na mes momento: na Bélgika Piggy i Joyn por ta na huntu, kada un ku su propio datonan (skohe e plataforma, yena, Warda; Kambia i Eliminá pa kada plataforma). E gas ta haña pa kada programa un kòdigo QR propio riba e bon, un link propio den e bon manda pa e-mail i un boton propio den e tienda online, i ta spar pa kada programa un biaha pa òrdu. Loke tabata konfigurá kaba ta sigui funshoná normal.
• QR code riba e resibu: despues di kobra, bou di e resibu tin un QR code ku "Skan i spar punto na ...". Den e resibu pa e-mail tin un link, i den e tienda online (pa hiba i entrega) un boton riba e pagina di òrdu i un link den e e-mail di konfirmashon. Un òrdu ta duna punto un biaha so: resibu, e-mail i tienda online ta usa e mesun kodigo úniko (e number di e òrdu). "QR code riba e resibu imprimí" bo por paga; e e-mail i e tienda online ta keda haña e link.
• Piggy, manera "QR code i link": yena e adrès di bo portal di kliente di Piggy, e Shop UUID i e Account secret (Piggy Business Dashboard). Ta funshoná sin internet: e kaha ta traha e link mes.
• Piggy, manera "Pone mesora": yena tambe un personal access token (Piggy → Marketplace → Private App). Si e kaha manda e resibu pa e-mail i e kliente ku e adrès di e-mail ei ta miembro kaba, e kaha ta pone e puntonan mesora; riba e resibu anto tin "Punto pusá na Piggy". E kaha nunka no ta traha un miembro nobo; no ta miembro (òf no tin e-mail) = e QR code.
• Joyn, manera "QR code i link": ku e partner key, shop reference i e shared secret di Joyn (pidi nan via api-integration@joyn.be). Ta funshoná sin internet. E QR code ta válido 2 ora.
• Joyn, manera "Via e API": ku e shop API key (aktivá e konekshon den e portal di komersiante di Joyn). Ora di kobra e kaha ta pidi Joyn un kodigo di punto. Kambia punto ta bai manera semper riba e Joyn-iPad.
• Traha un link di ehempel: ta kontrolá si e datonan ta korekto (un link di € 10; habri é solamente pa wak).
• Solamente e plataformanan di e pais di e negoshi por wòrdu kohé; e sekretonan ta solamente den e base di datos i nunka no ta parse riba e pantaya (laga bashí = keda manera ta).

Pidi review: despues di e bishita un e-mail ku un boton pa Google i/òf Trustpilot.

• Algun ora despues (por ahustá, standard 3) e kliente ta risibí e e-mail, den e idioma di e resibu.
• Tienda online: pa hiba i entrega e tienda online mes ta manda e e-mail, algun ora despues ku e òrdu a kaba den e kaha, den e idioma di e kliente.
• Google: pega e link di review for di bo Business Profile (Google → bo Business Profile → Pidi review, https://g.page/r/.../review) òf yena e Place ID.
• Trustpilot: yena e dominio di bo negoshi (e boton ta bai na trustpilot.com/evaluate/<domein>). Si bo tin na Trustpilot un adrès di invitashon (Automatic Feedback Service, ...@invite.trustpilot.com), yena esei tambe: e e-mail anto ta bai den BCC pa Trustpilot, ku e nòmber, e adrès di e-mail i e number di resibu invisibel, i Trustpilot mes ta manda e invitashon (anto no tin boton di Trustpilot di bo mes). Solamente Trustpilot ku adrès di invitashon: e kaha ta manda e-mail solamente na Trustpilot.
• No muchu biaha: e mesun kliente (adrès di e-mail) ta haña maksimo un pregunta pa periodo (standard 90 dia; 0 = tur biaha). Pa esei e kaha ta warda solamente un hash di e adrès; e adrès di e-mail mes ta bai apenas e e-mail a wòrdu mandá (si e no lográ, despues di tres purba, i si no despues di 14 dia).
• QR code riba e resibu (opshonal): tambe un QR code pa un review bou di e resibu imprimí.
• Ehempel di e e-mail i Kita e-mail ku ta warda (e adrèsnan ta bai mesora). E buki di registro ta mustra review_gevraagd ku a***@domein.nl.
• Google i Trustpilot ta prohibí duna un rekompensa pa un review i pidi solamente kliente kontentu ("review gating"). P'esei e kaha ta pidi tur hende meskos i no ta duna nada bèk pa un review.
• Lesa i kontestá review den e kaha: wak Maneho di review aki bou.

Konekshon ku Mailchimp i Klaviyo

Bo klientenan di e karchi di kliente den bo mes programa di e-mail: na Konfigurashon → Negoshi → Mailchimp i Klaviyo (bou di e marketing pa sms i e-mail). No tin swich: sin konekshon ku un lista skohé no ta pasa nada.

• Konektá: ku un kódigo API (Mailchimp: Profile → Extras → API keys; Klaviyo: un kódigo privá pk_… ku derecho di skirbi pa Lists, Profiles, Subscriptions, Events, Campaigns i Templates). E sekreto di client i e kódigo nunka ta bolbe aparesé riba pantaya (laga bashí = keda ku esun ku tin). Despues bo ta skohe e lista (Mailchimp: audience).
• Klientenan: ken ku a duna pèrmit pa e-mail ta bai na e lista (skirbí), ku nòmber, fam, telefòn, aniversario i punto (Mailchimp: kampo PUNTEN, e kaha mes ta krea esaki; Klaviyo: propiedat punten). Pèrmit retirá, adrès di e-mail kambiá òf kliente eliminá: dal afó. Ta solamente loke a kambia ta bai atrobe. Ku un konekshon, e kaha (i e marka "oferta" den e tienda online) ta pidi un kliente nobo tambe pèrmit pa e-mail, i bo por kambi'é na Reporte → Klientenan, tambe sin e mes marketing pa e-mail.
• Dal afó: ken ku dal afó den Mailchimp òf Klaviyo, no tin pèrmit pa e-mail mas den e kaha tampoko (buki di registro: "dal afó den Mailchimp"). Ken ku a dal afó su mes, e kaha no ta skirbi'é atrobe.
• Ordernan: kada resibu pagá di un kliente riba e lista ta bai kuné komo evento (Mailchimp: bestelling, ku suma, number di resibu i kantidat; Klaviyo: Placed Order, ku e balor den euro). Ku esei bo ta traha e-mail outomátiko den e programa di e-mail, por ehempel despues di e promé order òf si un hende no a bini pa un luna. Resibunan di promé ku bo a skohe e lista no ta bai kuné.
• Akshonnan: na Reporte → Marketing bo ta manda un akshon tambe via Mailchimp òf Klaviyo (wak Marketing pa sms i e-mail); e kaha ta krea e kampaña ei anto i ta mand'é.
• Aktualisá: kada 5 minüt, òf ku Aktualisá awor. Deskonektá: e ta bai for di e kaha; den Mailchimp i Klaviyo tur kos ta keda. E yabinan ta den e base di dato (sí den e back-up, no den e eksportashon di konfigurashon).

Kódigo: lib/mailinglijst.ts, routes/mailinglijst.ts i MailingKoppelingen.tsx.

BI i eksportashon di dato

E dato di benta pa Power BI, Looker Studio, Excel, Google Sheets, Tableau, Qlik Sense, Metabase, un servisio di BI (por ehempel YourBI, BI4Horeca òf Moore DRV) òf bo propio data warehouse. Aktivá na Konfigurashon → BI i eksportashon di dato (standard desaktivá). Lesa so: via un konekshon nada no por kambia den e kaha. Ningun dato di kliente.

• Dato: resibu (tambe nota di krédito), produkto bendí (liña di resibu), pago, entrada pa dia, entrada pa ora, storno, produkto, empleado (sin pinkode) i ora trahá. Suma na euro ku punto komo señal desimal, ora segun e ora di e negoshi.
• + Konekshon: skohe e pakete i e manera. Kada pakete por un òf mas manera; bo por tin vários konekshon na mes momento (tambe pa e mesun pakete).
• E pakete ta buska e dato su mes (API): e kaha ta duna un biaha so un yabi pa lesa so. Periodo ku ?van=&tot= (AAAA-MM-DD) òf un adrès fiho ku ?periode= (vandaag, gisteren, 7d, 30d, 90d, 365d, week, maand, vorigemaand, jaar); maksimal 366 dia, maksimal 200.000 liña. E yabi den Authorization: Bearer, X-Sleutel òf ?sleutel=.
• Via e portal: si e kaha ta konektá ku e portal di kliente, e mesun adrès ta funshoná tambe for di pafó di e negoshi, sin habri un port: https://<portaal>/bi/<kassa-id>/<gegevens>?periode=90d&formaat=csv&sleutel=.... Asina e servisio di Power BI ta aktualisá e segun planifikashon (sin gateway) i Google Sheets por buska e ku =IMPORTDATA("...") (tambe e fuente pa Looker Studio). E kaha ta mustra e adrès na e konekshon.
• Resumen di kadena via e portal di kliente (vários negoshi): un adrès i un yabi pa tur bo kahanan huntu. Den kada kaha ku mester partisipá, aktivá Resumen di kadena via e portal di kliente (bou di e switch di BI) i traha un yabi den e portal di kliente na Mi kahanan → BI pa tur bo negoshi. Anto: https://<portaal>/bi/keten/<gegevens>?periode=90d&formaat=csv&sleutel=hpk_.... E portal ta buska e datonan na kada kaha i ta kombiná nan, ku kassaId i zaak riba kada liña. Kahanan ku ta offline òf ku no ta partisipá ta aparesé den ontbrekend (JSON) i den e header X-Ontbrekend. E kaha mes no mester un yabi propio pa esaki; paga esaki den e kaha òf den e portal di kliente ta stop esaki.
• Ku un token, e ta bai komo Authorization: Bearer i tin un firma den X-HorecaPOS-Handtekening (sha256= HMAC di e kontenido). Si e no logra, e kaha ta purba di nobo tur minüt; nada no ta bai dobel. Ku for di e ta manda tambe resibu mas bieu.
• E kaha ta entregá archivo: tur dia (na un ora, e dia promé; dia faltá ta wòrdu rekuperá) òf tur ora (awe te awor), komo CSV (koma, òf punto-koma pa Excel hulandes) òf JSON, pa un mapa riba e kompiuter di kaha (por ehempel un mapa di OneDrive òf SharePoint pa Power BI òf Excel), un server FTP(S) òf SFTP òf pa e-mail. Nòmber di archivo: horecapos_<gegevens>_<datum>.csv.
• Manda tèst (push) i Eksportá awor (archivo) na e konekshon.
• Baha bo mes: skohe dato, periodo i formato.
• Plantilla di Power BI (.pbit): un raport kla pa Power BI Desktop, ku Baha plantilla di Power BI serka BI i eksportashon di dato. Promé traha un konekshon API (Power BI). Den e modelo: un tabla pa set di dato ku e tiponan korekto, un kalènder (aña, luna, siman, dia di siman), relashon (fecha → kalènder, liña di bon → produkto, ora trahá → empleado) i medida (benta inkl. i eksl. BTW, BTW, tip, bon, invitado, promedio pa bon i pa invitado, kantidat bendí, benta di produkto, pagá, storno, ora trahá, benta pa ora trahá). Tres página: Resumen (sifra prinsipal, benta pa dia, dia di siman i ora, manera di pago), Produkto (pa grupo i pa produkto) i Personal (ora i benta pa empleado). Via e portal e servisio di Power BI ta aktualisá e tambe segun planifikashon.
• Sekreto (token, kontraseña, yabi) nunka no ta aparesé den e resumen; laga bashí = keda, Kita = bai. Tur kos ta den e logbuk (sin sekreto).

Salario i planifikashon

Ku Marka entrada i salida sende (Konfigurashon → Negoshi) bo ta haña abou na Konfigurashon → Oranan di trabou Salario i planifikashon (derecho Maneha konfigurashon), den dos bloke separá. Si e markamentu ta paga, no tin ora: e ora ei solamente e bloke Planifikashon di personal (e benta, live òf komo archivo di benta) ta abou na Konfigurashon → Kontabilidat, bou di e título Benta pa bo planifikashon:

• Atministrashon di salario (payroll): skohe e programa di salario òf (Bélgika) e sekretariado sosial, yena su kamponan i pa kada empleado su number di empleado den e programa ei. Despues bo ta traha pa un periodo e archivo ku e oranan trahá (turnonan será, pa empleado pa dia di marka entrada) i e benta pa empleado (sin BTW, loke e a kobra): kla pa usa pa Loket.nl (Variabele gegevens, total pa empleado durante e periodo, liña di enkabesamentu aanslnr;persnr;ploeg;<looncomponent>) i SD Worx Bélgika (Tijdsregistratie, poshonnan fiho, pa empleado pa dia), sino e lista di ora (CSV: Fecha; Number di empleado; Nòmber; Ora; Benta sin BTW). Empleadonan sin number di empleado no ta drenta e archivo di Loket òf SD Worx; e kaha ta bisa ken nan ta.
• Planifikashon di personal (WFM): skohe e sistema di planifikashon. Manda di nobo ta sobreskribí. Ademas e lista di benta (CSV pa dia i ora, sin i ku BTW) i pa Strobbo e archivo di Excel pa Importeer omzet.
• Solamente programanan ku ta funshoná den e pais di e negoshi, pa grupo i segun alfabèt; e server ta rechasá un programa di otro pais (400).
• Yabi i token nunka ta bai riba pantaya.
• Ta afektá e kontabilidat: e gastonan di salario e programa di salario ta registrá den kontabilidat, e benta e kaha ta registrá (Konfigurashon → Kontabilidat). AFAS Payroll i Exact Online Loon ta den mesun ambiente ku e kontabilidat di AFAS i Exact.
• Riba e kopia di e kaha riba e portal esaki no ta posibel (e kaha den e negoshi ta hasié).
• Di algun programa e API no ta públiko òf ta solamente pa partner (entre otro Loket, Nmbrs, Nostradamus, Employes, Shyfter, Planday, Eitje): nan ta riba petishon; te ora ei e archivo. E formato di SD Worx i Strobbo ta sali for di nan dokumentashon: laga kontrolá e promé importashon.

Eksigenshanan legal na Bélgika i Hulanda

Loke e lei ta eksigí i loke HorecaPOS ta hasi p'esei (laga bo kontador konfirmá kiko ta aplika pa bo negoshi):

Lei i reglanan

Ahustenan → Lei i reglanan (atministradó; e asistente di BTW tambe ku e derecho Maneha produktonan). Tur kos ta af pa default; sin e ahustenan aki e kasa ta funshoná manera semper.

• Kontrol di edat alkohòl (18+): marka na Produktonan Tin alkohòl (of usa e asistente di BTW). Na buska i entregá ku alkohòl ta parse "18+" riba e bon di trabou, e bon di kasa i den e pantaya di òrder. Den e webshop e kliente mes ta konfirmá ku e tin 18 aña of mas (e kaha no ta marka di antemano) i e ta mira ku nan ta kontrolá e edat na entrega.
• Rekargo di empake desechabel (Hulanda): pa kada produkto un suma (preis indikativo: bèker € 0,25, bakchi di kuminda € 0,50, bakchi chikí € 0,05). Na buska i entregá e kasa mes ta pone un liña "Rekargo di empake desechabel" riba e bon (ku e BTW di e produkto); e ta bai outomátikamente huntu ku e produktonan (e base di datos ta tene kuenta di dje, tambe despues di skrap, move of un otro tipo di òrder) i e ta aparte den e entrada. Na sitio no tin rekargo. Thuisbezorgd.nl i e webshop ta kobra nan propio rekargo.
• Depósito (Hulanda): pa produkto (€ 0,15 blèki/bòter, € 0,25 bòter grandi), liña "Depósito" sin BTW, solamente na buska i entregá.
• Kèsh € 3.000 of mas (Hulanda, desde 1-1-2026 prohibí pa merkansia): na buska i entregá un mensahe na ora di paga i na e outomat di plaka; e empleado por konfirmá (p.e. catering komo servisio), esei ta drenta den e logbuk. Kome i bebe na sitio ta un servisio: no tin mensahe.
• Asistente di BTW: pa kada produkto e tipo (kuminda, bebida sin alkohòl, bebida ku alkohòl, kuminda sin preparashon, otro; prome un suposishon riba base di e nòmber i e grupo). E kasa ta mustra e tarifa korekto na sitio i pa hiba (Bélgika desde 1-3-2026: kuminda i refresko 12%, tambe pa hiba; alkohòl 21%; kuminda sin preparashon 6%. Hulanda: 9% i 21%) i ta aplik'é, mesora of for di un fecha.
• Planiá kambio di BTW: un produkto pa un otro tarifa, of (solamente Hulanda) un tarifa ku un porsentahe nobo, for di un fecha. E kasa ta ehekut'é riba e dia ei mes (ta wak kada kuarto di ora, i na ora di sende).

Fakturanan (obligatorio entre kompanianan na Bélgika) ta na Fakturanan pa klientenan komersial. Ainda pa hasi: GKS 2.0, puntra kon e sertifikashon ta para (mira docs/backlog-concurrenten.md).

Fakturanan pa klientenan komersial

Konfigurashon → Fakturanan (atministradó; af pa default): aktivá Fakturanan pa klientenan komersial (UBL / Peppol). Si e ta aktivá, bou di dje bo ta haña Paga riba kuenta, e Datonan riba e faktura, e Servisionan di Peppol, e Konekshon ku banko (ku paga riba kuenta) i e lista ku tur faktura. Na Bélgika e-fakturashon entre kompanianan ta obligatorio desde 1-1-2026.

• Faktura pa kliente komersial: Bon → skohe e bon → Faktura. Yena e kliente (of skohe un kliente anterior); e kasa ta traha un faktura ku number (p.e. F2026-0001, ta subi pa aña), komo UBL segun Peppol BIS Billing 3.0 i komo faktura pa imprimí of warda komo PDF. Manda pa e-mail (tur dos komo anekso, opshonal un kopia pa e kontador), via Billit na e red di Peppol (BILLIT_API_KEY, BILLIT_PARTY_ID), via Storecove (STORECOVE_API_KEY, STORECOVE_LEGAL_ENTITY_ID; e risibidó ta sali for di e Peppol-ID di e kliente, p.e. 0208 → BE:EN, 0106 → NL:KVK, sino pa e-mail via Storecove) of via Banqup di Unifiedpost (BANQUP_CLIENT_ID, BANQUP_CLIENT_SECRET, BANQUP_SPACE_ID; BANQUP_SANDBOX=1 pa e ambiente di prueba; Banqup ta kontrolá e UBL i ta entreg'é mes), na un adrès propio (FACTUUR_HTTP_URL, p.e. un programa di kontabilidat of otro servisio di Peppol) of baha. Un faktura pa kada bon; e bon ta pagá kaba, pues "pagá". Number di KvK/kompania, IBAN, Peppol-ID, prefiho i plaso di pago na Datonan riba e faktura. Tur faktura abou na e tab (derecho Entrada pa periodo).
• Yabinan, sekretonan i headers nunka no ta wòrdu mustra (solamente "yená"; laga bashí = keda ku esun aktual, Kita = kita afó) i no ta wòrdu registrá den e logbook (solamente kua kampo a kambia). Nan ta den e base di dato (vestiging.peppol_gegevens): sí den back-ups, no den e eksportashon di konfigurashon.

Kiosko di outoservisio

Gasnan ta bestel nan mes na un pilar òf tablet, manera den un restorant di fast food, i ta paga na kaha òf ku karchi na e kiosko. E pantayanan di bestel ta parti di e kaha mes, p'esei e menu, preisnan, opshonnan, menunan, happy hours, partinan di dia, fotonan, alergenonan, idiomanan i e bon ta bini for di e kaha i no mester wòrdu ahustá na ningun otro lugá. Riba e kiosko ta kore e app PinPortal Kiosk 2 (Android, tambe Sunmi, i Windows, Linux i macOS), ku ta mustra e página i ta imprimí e bon. Standard ta paga.

Pone na i konfigurá (atministradó): Konfigurashon → Negoshi → Pantaya i manehamentu → Kiosko di outoservisio.

• Skohe kiko e gas por skohe: Kome aki i/òf Pa hiba (pa hiba ta usa e preis pa hiba i e tarifa di BBO pa hiba, si nan ta konfigurá).
• Teksto di bon bini, despues di kuantu sekònde sin toka e kiosko ta bai bèk na kuminsamentu (e kanaster ta bira bashí) i kua grupo di produkto ta riba e kiosko (nada marká = tur).
• Algu mas ku esaki?: marka grupo di produkto (p.e. bebida, dushi); na e kanaster e kiosko ta sugerí e ora un par di produkto for di nan.
• Pago, pa kada kiosko (wak Agregá i konektá un kiosko):
  • Na kaha (standard, manera e kiosko bieu): e gas ta bestel, ta haña un number pa kohe i ta paga na kaha. No tin mester di terminal di pago na e kiosko.
  • Ku karchi na e kiosko: e gas ta paga na e terminal di pago serka e kiosko.
  • E gas ta skohe: na kaha òf ku karchi. Si e kiosko no tin terminal di pago, e ta paga na kaha.
• Pa kushina (ora di paga na kaha): mesora despues di bestel na e kiosko (standard), òf te ora ku a paga na kaha.
• Bon: riba e printer di e kiosko (standard), riba e printer di bon di e kaha, òf sin bon (solamente e number riba pantaya). Ora di paga na kaha, e kiosko ta imprimí un papel ku e number i no pagá ainda; e bon ta sali ora di kobra na kaha.
• Status di bestelling riba telefòn (opshonal, standard paga): riba e bon di e kiosko i riba e último pantaya ta aparesé un kódigo QR. E gas ta skan'é, ta mira su number i e status (bestel, ta prepará, kla) i ta haña un aviso ora e bestelling ta kla. Esaki ta bai via e portal di maneho, p'esei e kaha mester ta konektá kuné.
• Alkohòl i produkto pa kilo nunka no ta riba e kiosko: sin personal no por kontrolá edat i no tin pesadó.
• Skaner di kódigo di bara (opshonal, standart tur kos desaktivá): marka kiko un skan na e kiosko por hasi:
  • un produkto den e kanaster (e kódigo di e produkto);
  • un kódigo di deskuento;
  • un karchi di kliente (e gas ta spar punto);
  • un vale di regalo òf karchi di saldo komo pago. Si tin sufisiente saldo, e bestelling ta pagá mesora. Sino e vale ta paga un parti i e gas ta paga e resto ku pin òf na e kasa (e ora ei esei ta permití tambe na un kiosko ku pin so). Despues di un pago parsial asina e gas no por kanselá mas; e bestelling ta aparesé den e kasa komo Kiosko … · number.

E skaner mes bo ta konfigurá na e kiosko: den e aplikashon PinPortal Kiosk 2 na maneho → Skaner di kódigo di bara (komo teklado, e skaner integrá òf un pòrt COM), ku un tèst di skaner. Un skaner ku ta traha manera teklado ta funshoná tambe sin e aplikashon.

• Rekargá krédito (opshonal, standard desaktivá; ta funshoná solamente si krédito rekargabel ta aktivá): anto riba e pantaya di inisio di e kiosko ta para Rekargá krédito. E gas ta skan su karchi òf vale (òf ta tipiá e kódigo), ta mira e saldo i ta skohe un monto. Bo ta konfigurá e montonan bo mes (1 te 6, standard € 10, € 20 i € 50). Pago ta bai manera e kiosko ta konfigurá: ku karchi, òf na kaha ku e number pa kohe. Despues di kobra e monto ta riba e saldo. Un rekarga asina no ta bai kushina, no ta aparesé riba e pantaya di yamamentu i no ta haña kódigo QR. E saldo máksimo di krédito rekargabel ta konta aki tambe.
• Riba mi kamber (konekshon di hotel, standart desaktivá; Konfigurashon → Hotel → Outoservisio): e ora ei serka e makutu tin Pone riba mi kamber. E invitado di hotel ta yena number di kamber i fam; si esei ta kuadra ku un invitado ku ta keda awor den e kamber ei, e òrdu ta bai kushina i e ta keda pagá riba e kamber (wak Software di hotel: pone riba e kamber).
• Bèlgika (kaha preta): loke no a wòrdu tèst ainda ku e kaha preta ta desaktivá outomátikamente na e kiosko (vale di regalo òf saldo komo pago, karga saldo, kódigo di deskuento, menu, opshon ku preis ekstra, happy hour), meskos ku na kaha.

Agregá i konektá un kiosko

1. Na Kioskonan hinka un nòmber (p.e. Kiosko entrada) i skohe Agregá kiosko. Bo ta haña un kódigo di konekshon di 6 sifra (bálido 30 minüt).
2. Skohe na e kiosko kon e gas ta paga: standard na kaha. Si ta un kiosko ku terminal di pago, skohe ku karchi òf e gas ta skohe, i skohe e terminal di pago di e kiosko aki (for di Konfigurashon → Pago).
3. Habri e página di kiosko riba e kiosko:
   • den e negoshi: den e app bou di manehamentu → Vast adres e adrès ku ta na e konfigurashon, p.e. http://192.168.1.20:3000/kiosk;
   • òf via e portal di manehamentu (https, tambe si e kiosko no ta den e mesun red): konektá e adrès di kiosko ku ta na e konfigurashon na e kódigo di kiosko di e app, meskos ku e kiosko bieu.
4. Hinka e kódigo di konekshon riba e kiosko. Kla: e kiosko ta kòrda su mes klave. Konektá atrobe ta duna un kódigo nobo; Kita ta deskonektá e.

Na kada kiosko bo ta mira si e ta online.

Asina e gas ta bestel

1. Pantaya di kuminsamentu ku e teksto di bon bini; e gas ta skohe su idioma (tur idioma di e kasa) i ta toka pa bestel.
2. Kome aki òf pa hiba.
3. E menu pa grupo di produkto, ku potrèt, e preis (ku happy hour), alérgeno i loke a kaba. Produkto ku opshon òf un menu ta habri e bentana di skohe.
4. E kanaster: kambia kantidat i si bo ke Algu mas ku esaki?.
5. Bestel (paga na kaha): e gas ta mira su number pa kohe grandi riba pantaya ku e suma, ta haña e papel i ta paga na kaha. Den e kaha e bestelling ta habri komo Kiosko Entrada · 42 (e number ku e gas ta bisa); kobra manera semper. Despues e ta aparesé komo pagá riba e pantaya di yamada i ta bai kushina si esei tabata djis despues di pago.
6. Paga ku karchi: e kaha ta manda e suma na e terminal di pago di e kiosko aki (e mesun konekshon di pago ku na kaha). Si e no ta logra, e gas por purba atrobe òf kanselá (òf, si e por skohe, tòg paga na kaha). Te ora e pago a logra, e bestelling ta bai kushina i ta wòrdu kobrá. E gas ta mira su number pa kohe grandi riba pantaya i ta haña e bon.
7. Despues di algun sekònde e kiosko ta bai bèk na e komienso.

Na falla: aviso i modo di emergensia (den e app di kiosko, maneho → Bij storing; standart desaktivá). Si e kiosko no por alkansá e kaha, ta keda mustra Even gesloten. Dos ekstra:

• Teams, Slack, Discord, ntfy, Home Assistant, Make òf Zapier), i hersteld ora tur kos ta bolbe traha. Ku Testmelding sturen bo ta kontrolá e adrès.
• Modo di emergensia: e kiosko ta warda un menu simpel ku e página di kiosko ta pasa: produktonan sin opshon òf menu kombiná, ku e preis pa kome aki (òf pa hiba, si esei ta e úniko opshon).
  • Si e kaha ta fuera pa un tempu (standart 60 sekònde), e invitado ta ordená for di esei.
  • E invitado ta paga ku karchi òf na e mostrador. Paga ku karchi ta posibel solamente si Pinbetaling ta aktivá den e app.
  • Ta sali dos resibu di emergensia: un pa e invitado (N1, N2 …) i un pa e mostrador/kushina. Riba nan ta para ku esaki no ta un resibu di kaha.
  • Ora e kaha bolbe, e página di kiosko ta pone e ordernan di emergensia den e kaha komo Nood N… <kiosk>. Nan no ta bai kushina (esei tabatin e resibu di emergensia kaba) i nan no ta riba e pantaya di yamamentu.
  • Pagá ku karchi i e mesun suma ku den e kaha: kobrá komo Pagá ku karchi manualmente. Si no (paga na e mostrador, òf un otro suma) e order ta keda habrí pa e atendensia.
  • Tur kos ta den e buki di registro.
• Bélgika: ku e sistema di kaha registrá (GKS, kaha pretu) tur benta mester pasa mesora via e kaha i e FDM. P'esei e modo di emergensia probablemente no ta permití; puntra esaki promé. E app di kiosko ta aktivá e den Bélgika solamente despues di un konfirmashon ekstra, i e kaha ta duna un spièrtamentu na e kiosko.

Den e kaha un bestelling di e kiosko ta un bestelling normal (pa hiba òf pa kome aki, ku e nòmber Kiosko Entrada) riba nòmber di e trahado Kiosk. E kaha ta traha esaki su mes; ningun hende no por drenta kuné. No pon'é inaktivo, sino e kiosko no por bestel. Bestelnan di e kiosko ta den e reportnan, den Bon i riba e pantaya di yamada. Un bestelling ku no wòrdu kompletá na e kiosko (no bestel òf no pagá ku karchi) ta kaduká su mes despues di 30 minüt.

Paga ku karchi ta den modo di prueba (Konfigurashon → Pago)? E ora e kiosko no ta kobra di bèrdat; útil pa purba. Sin internet no por paga ku karchi; e kiosko ta bisa e ora ku por bestel na e mostrador.

Falla: si e kaha no ta alkansabel, e app di e kiosko ta mustra "Será un ratu" i ta sigui su mes. Si e kiosko ta kore via e portal di maneho i internet kai, e app por kambia pa e kaha den e red lokal (den e app: maneho → Ekstenshon → Na falla, usa e red lokal); e kiosko mes ta pasa e adrès ei.

Pone of: e kiosko ta bisa ku e ta será pa un ratu. E kioskonan i e konfigurashon ta keda wardá. Den e lòg ta keda na/of, e konfigurashon, kioskonan agregá i kitá, konekshon i bestellingnan kanselá.

Bòrchi di menu digital

E menu ku preis riba un tv (òf otro monitor ku un browser), direkto for di e kaha. Standart desaktivá; aktivá via Konfigurashon → Negoshi → Pantaya i manehamentu → Bòrchi di menu digital. Despues habri riba e tv http://<kassaserver>:3000/menubord (òf e boton Riba un pantaya apart / Riba un tablet òf telefòn ku e kódigo QR). Sin login i sin konekshon.

• Pa kategoria e produktonan ku preis, den e òrdu di e kaha. Skohe bo mes kua kategorianan (i den ki òrdu), 1 te 4 kolòm, skur òf kla, un título propio (bashí = e nòmber di e negoshi), potrèt di produkto i alergeno.
• Semper korekto: e bòrchi ta pidi e menu kada 10 sekonde (i mesora na un kambio), pues un produkto ku a bende kompletamente (tachá ku Bendí kompletamente, òf kitá for di e bòrchi), un stòk bashí, un happy hour (preis di akshon ku e preis normal tachá, i e nòmber i ora di fin ariba) i e partinan di dia (solamente loke ta na benta awor) ta aparesé korekto outomátikamente.
• Si tur kos no ta kabe riba e pantalla, e paginanan ta kambia (standart kada 12 sekonde, por ahustá di 5 te 120).

Personal i pincode

Konfigurashon → Personal (solamente atministradó): agregá empleado, kambia nòmber, ròl i kode PIN, i pone inaktivo.

• Ròlnan: mesero (pidi, paga, reporte X), manager (ademas deskuento, retorno, sera dia, kaha di plaka i registro) i atministradó (tur kos, tambe tur Konfigurashon). Esei ta e standard; loke mesero i manager mag hasi por wòrdu adaptá (wak Permiso pa ròl).
• Kode PIN di 4 te 8 sifra, úniko entre e empleadonan aktivo. Kode PIN ta solamente kodifiká (hash) den e base di datos i no por wòrdu lesá bèk.
• Realmente kita no ta posibel (resibu i registro ta referí na e empleado); inaktivo = no por drenta mas.
• Semper ta keda por lo ménos un atministradó aktivo.
• Otro ròl, kode PIN nobo òf inaktivo: seshonnan aktivo di e empleado ei ta wòrdu terminá mesora.
• Bélgika: opshonal e number di registro nashonal pa e registro di personal.
• Idioma: e idioma di e pantayanan pa e empleado aki (òf "Idioma di e aparato"). Despues di drenta, e kasa ta mesora den e idioma ei; e empleado por kambi'é tambe ku e banderita abou na banda drechi (wak Idioma).
• Konseho: remplasá e kode PIN di demo 1111 i 2222 promé ku e kasa bai live.

Login ku un karchi (opshonal)

Standard desaktivá. Aktivá: Konfigurashon → Personal, marka Login ku un karchi (NFC, RFID òf iButton). Nesesario: un lektor di karchi USB ku ta funshoná manera teklado (pa karchi NFC òf RFID, kadena di yabi, brasalete òf yabi iButton). Un lektor asina ta "tipa" e número di e karchi i ta primi Enter; no tin mester di driver òf konekshon.

• Konektá: tok riba e empleado, despues Konektá karchi i tene e karchi kontra e lektor. Un karchi ta pertenesé na un empleado so. Kita karchi si e a pèrdè.
• Login: riba e pantaya di login tene e karchi kontra e lektor. E kódigo PIN ta keda funshoná normal tambe.
• Marka entrada i salida (si esei ta aktivá): riba e pantaya di login Marka entrada / salida i e karchi kontra e lektor.
• E número di e karchi ta solamente sifrá (hash) den e base di datos, meskos ku e kódigo PIN. Empleadonan inaktivo no por login ni ku nan karchi.
• Desaktivá: login solamente ku e kódigo PIN, manera semper. Karchinan konektá ta keda wardá.

Derecho pa ròl

Konfigurashon → Permiso (solamente atministradó): pa ròl, marka loke mesero i manager mag hasi. Standard tur kos ta eksaktamente manera ariba (manera e kasa semper a hasi); un kaha ku ta diferente tin koló.

• E atministradó semper mag tur kos. Kambia personal i permiso ta keda semper solamente pa e atministradó (sino un hende por duna su mes mas permiso).
• Boton i tab ku un ròl no mag, ta skondí pa e ròl ei; e server di kasa ta kontrolá esaki tambe. Si un manager haña p.e. Maneha produkto, e ta mira e boton Konfigurashon ku solamente e tab Produkto.
• Kambionan ta konta mesora riba tur kasa i ta bai den e registro. Bèk na standard ta pone tur kos manera e tabata.

Datonan di e negoshi

Konfigurashon → Negoshi (solamente atministradó): nòmber, adrès, kódigo postal, lugá, telefòn i number di BTW di e sukursal. Esakinan ta ariba riba kada resibu i pro forma. Tambe e teksto abou riba e resibu por wòrdu konfigurá aki (vários liña ta permití; bashí = sin teksto; standard "Danki i te otro biaha!"), i bou di dje e idioma di e resibu (standard Hulandes; wak Idioma). Un ehèmpel di e resibu ta kambia live huntu. Despues di warda, e siguiente resibu ta usa mesora e datonan nobo. E pais i e datonan fiskal (GKS) a propósito no por wòrdu kambiá aki. Na Bélgika e number di BTW ta obligatorio. Ku e kaha Rondoná pago kèsh na 5 sèn (standard desaktivá) e tòtal ta wòrdu rondoná ora di paga kèsh (€ 6,62 → € 6,60, € 6,63 → € 6,65); e diferensia ta para komo "Rondoná" riba e resibu. Pin ta keda semper eksakto te e sèn.

Maneha produkto

Drenta komo atministradó i skohe Konfigurashon → Produkto.

• Agregá, kambia (nòmber, preis, kategoria, tarifa di BTW pa kome aki i pa hiba kas, nòmber riba e resibu, kode, bendí kaba) i kita kategoria i produkto. Kategoria i produkto por haña nan mes koló; un produkto ku koló ta haña un boton di koló riba e pantaya di òrdu (teksto outomátikamente blanku òf skur pa por lesa bon).
• Kambia e órden dor di hala un kategoria òf produkto na ≡. Esaki ta traha ku mouse i ku dede riba un tablet. Despues eksaktamente e órden ei ta riba e pantaya di òrdu; pantayanan di kasa habrí ta aktualisá nan mes mesora.
• Kita ta saka un produkto for di e kasa, pero òrdu bieu i e diario fiskal ta keda konosé e produkto. Un kategoria bo por kita solamente si e ta bashí.
• Opshon: habri un produkto òf kategoria i bou di "Opshon" agregá gruponan di opshon, manera "Manera di kushiná" (eksaktamente un, obligatorio), "Salsa" (maksimo un) òf "Ekstra" (vários, ku mínimo i maksimo; maksimo bashí = sin límite). Kada opshon tin un nòmber i un preis ekstra (por ta negativo, p.e. -0,50). Gruponan di opshon di un kategoria ta konta pa tur produkto den e kategoria ei, ademas di e opshonnan propio di e produkto. Órden ku ▲▼. Kita ta semper posibel: òrdu i resibu eksistente ta warda e opshonnan skohí nan mes. E server ta kontrolá opshon obligatorio i e maksimo tambe.
• Potrèt pa produkto: wak Potrèt di produkto.
• Preis pa kilo, number PLU i tara (solamente si e balansa ta sendé): wak Konfigurá balansa. Sin marka, un produkto ta keda pa pida manera normal.

Potret di produkto

Kada produkto por haña un potrèt.

• Pone potrèt: Konfigurashon → Produkto → skohe e produkto → Skohe potrèt (riba un tablet òf telefòn esaki por tambe direkto ku e kámara). E potrèt ta wòrdu redusí den e browser te maksimo 512 × 512 pixel (JPEG, mayoria biaha 20–80 kB) i wardá mesora; Otro potrèt ta remplas'é, Kita potrèt ta kit'é. Den e lista di produkto tin un potrèt chikitu promé ku e nòmber. Solamente ku e permiso Maneha produkto; jpg, png i webp, maksimo 512 kB.
• Mustra e atministradó ta skohe na Konfigurashon → Negoshi → Potrèt di produkto, separá for di otro i standard pagá:
  • Potrèt di produkto riba e botonnan di e pantaya di òrdu: e potrèt ariba riba e boton di produkto, ku e nòmber i preis bou di dje.
  • Potrèt di produkto serka e produktonan riba e pantaya di kliente: un potrèt chikitu promé ku kada liña riba e pantaya di kliente (e pantaya di kliente mes mester ta sendé tambe). Produkto sin potrèt ta keda manera nan ta; si e ta pagá, tur kos ta traha eksaktamente manera promé.

Skaner di kódigo di bara

Ku un skaner di kódigo di bara na e kasa bo ta skan produktonan, kódigonan di deskuento, karchinan di kliente i valenan di regalo. Aktivá na Konfigurashon → Skaner (tab banda di e printernan i e balansa; standart desaktivá). Marka kiko un skan ta hasi riba e pantaya di òrdu:

• Produkto riba e resibu: e produkto ku e kódigo ei (Konfigurashon → Produktonan, kampo Kódigo; p.e. e kódigo di bara EAN di e empake). Ku skohonan, un menu òf un preis pa kilo, promé e bentana di skohe òf e balansa ta habri, meskos ku ora bo tek. Esaki Skan riba e pantaya di òrdu na Imprimí etiketnan ta hasi tambe; esei ta keda funshoná manera semper.
• Kódigo di deskuento riba e resibu (si Kódigonan di deskuento ta aktivá).
• Karchi di kliente: e kliente ku e number di karchi ei ta bai riba e resibu (si e karchi di kliente ta aktivá). Si bo skan un kódigo deskonosí na un resibu ku un kliente, e kasa ta puntra si ta su karchi nobo.
• Vale di regalo òf karchi di saldo: e kasa ta mustra e saldo (si valenan di regalo ku saldo ta aktivá). Pago ta na Kobra → Vale di regalo; einan bo por skan e vale tambe.

E kasa ta buska promé na e produktonan, despues na e karchinan di kliente, e valenan di regalo i e kódigonan di deskuento. Skan ta funshoná riba e pantaya di òrdu, ora bo no ta den un kampo di input. Den un kampo di input e kódigo ta bai simplemente den e kampo ei.

Tèst di skaner: na Konfigurashon → Skaner bo ta mira pa kada skan e kódigo i kiko e kasa ta hasi kuné, tambe si e skaner ainda ta desaktivá. Si e no ta funshoná:

• Pone e skaner riba teklado (USB-HID), ku un Enter despues di e kódigo. Na mayoria skaner esei ta asina kaba.
• Un skaner integrá (p.e. di un kasa Sunmi) bo ta pone den e konfigurashon di skaner di e aparato riba input di teklado.
• E etiketnan di e balansa TS6X (peso i preis) e balansa mes ta hasi, tambe ku e skaner aktivá.

Na e kiosko bo ta konfigurá e skaner apart (Konfigurashon → Negoshi → Kiosko); wak Kiosko di outoservisio.

Imprimí etiketnan

Etiket di artíkulo ku e nòmber, e preis i un kódigo di bara, riba un printer di etiket (Brother, Dymo, Zebra ...) instalá riba e kòmpiuter òf tablet. Aktivá na Konfigurashon → Negoshi → Imprimí etiketnan (standard desaktivá). Einan bo ta skohe tambe e formato di e etiket (38 × 25, 57 × 32, 62 × 29 òf 100 × 50 mm) i si e preis i e kódigo di bara ta bai riba dje. Imprimí un ehempel ta imprimí un etiket di prueba.

• Konfigurashon → Produktonan → (produkto) → Etiketnan: skohe e kantidat i Imprimí.
• Kompra → (òrdu risibí) → Imprimí etiketnan: di kada produkto tantu etiket kuantu a yega (unidat di òrdu risibí × kuantu pa unidat di òrdu; no ingredientenan). Máksimo 500 etiket na un biaha.
• E kasa ta habri e dialogo di imprimí: skohe einan e printer di etiket i e formato di papel di e ròl. Kada etiket ta un página.
• E kódigo di bara ta e kódigo di e produkto (Konfigurashon → Produktonan): 8 òf 13 sifra ku un sifra di kontrol korekto = EAN (12 sifra: e sifra di kontrol ta wòrdu agregá), sino Code 128 (lèternan, sifranan i tékennan di puntuashon, te 30 karakter). Sin kódigo no tin kódigo di bara.
• Skan riba e pantaya di òrdu (marka, standard desaktivá): un skaner di kódigo di bara ku ta traha manera un teklado ta agregá e produkto ku e kódigo ei, ku e skohonan normal (opshonnan, balansa, alergia). No huntu ku e balansa TS6X, ku tin su mes etiketnan ku peso i preis.
• Derecho: Manehá produktonan òf Maneha stòk.

Konfigurá e balansa (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 propio Konfigurashon → Balansa (permiso Konfigurá negoshi, pago i printer, standard solamente e atministradó; e tab ta semper presente, tambe si e balansa ainda ta pagá). Standard pagá: anto e kasa ta traha eksaktamente manera promé. Bo no ta mira e tab?

Ta buska su mes. Si ainda no tin nada konfigurá, e kasa ta buska su mes ora bo habri e parti aki (e boton Buska ta hasi esaki atrobe):

• e kasa(server) mes ta kore riba un balansa di pc òf balansa AI di Aclas (TS6X, TS3X, TS5EX/NX/GX, iS6X, iS2X, iR6X, Ti6X, iL8X; marka/modelo di e aparato: Windows via WMI, Android via getprop, Linux via DMI) i e Aclas Scale Module ta kontestá? Anto e balansa ei ta keda prepará komo Riba e aparato aki, i e balansa di etiketa tambe; riba Linux (sin Scale Module) e balansa integrá riba e port interno haña (/dev/ttyS...) komo "TS6X (integrá)", huntu ku e modelo;
• tin un OS6X konektá na un port COM/USB? Kada port ta wòrdu purba ku 9600, 4800, 2400 i 19200 baud: promé skucha un ratu (kontinuo), despues manda W (Toledo), i si no Dialog 06 (9600, 7 databits, paridat impar: puntra pa e status).

Haña = poné den e formulario ku e boton Aktivá i usa: un toke i e ta funshoná. (Buska ta manda un W na kada port COM liber; un port ku ta okupá, por ehempel pa e terminal di pin, ta wòrdu salta.)

Tur balansa di Aclas. Pa kada balansa bo ta skohe e modelo; asina e kasa sa kon e por wòrdu konektá. Tin dos tipo:

• Riba e aparato aki (konfigurá un biaha): e kasa ta kore riba e balansa (balansa di pc òf balansa AI). Ku Windows òf Android e ta pisa via e Aclas Scale Module, sin port, velosidat òf protokòl; ku Linux (sin Scale Module) via e port interno di e balansa (mayoria biaha /dev/ttyS0 òf /dev/ttyS1), ku port, velosidat i protokòl. Tin solamente un di esaki pa kada kasa; Buska ta haña e su mes. Un balansa di pc òf balansa AI (TS6X, iS6X ...) ta semper Riba e aparato aki: e por ta den e lista un biaha so, e otro modelonan di pc/AI no por wòrdu skohé mas. Un TS6X na otro lugá den e negoshi sí por imprimí etiketa (anto aktivá solamente Skèn etiketa).
• Konektá (mas di un pa mes tempu): e balansa ta konektá ku un kabel (RS232/USB), Bluetooth òf e red na e server di kasa. Tantu ku ta nesesario (máksimo 8), kada un ku su mes nòmber.

Un lista, dos marka. Tur balansa ta den un lista. Pa kada balansa bo ta aktivá loke e ta hasi: Pisa na kasa (e kasa ta puntra pa e peso ora di pidi) i/òf Skèn etiketa (e balansa ta imprimí un etiketa ku kódigo di bara ku e kasa ta skèn, i ta risibí e PLU'nan di e kasa). Un balansa di pc òf balansa AI manera e TS6X por hasi tur dos; un balansa di etiketa LS solamente etiketa. Etiketa por bini di un balansa pa negoshi so.

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 i Zebra. Di e markanan aki e modelonan di uso komun ta inkluí, di kua ta sigur kon e kasa ta komuniká ku nan (pa tèst = e protokòl no ta literalmente den un fuente; e kasa ta skohe loke ta mas lógiko). Tur konektá (vários na mes momento), òf komo balansa di etiket di kua e kasa ta skan e etiket:

• A&D EK-i i HV-WP: pone e balansa riba stream (EK-i: prt 0; for di fábrika e ta riba e tekla PRINT) i e kasa riba Kontinuo ku 2400 baud i 7E1 (asina A&D ta for di fábrika). E mensahe ta ST,+00512.00 g (US = ta move, OL = muchu pisá).
• Adam Equipment Swift: pone e balansa riba kontinuo na pc (8N1); e kasa ta keda anto riba Kontinuo.
• Avery Berkel FX110, FX120 i FX131: skohe riba e balansa e protokòl Mettler Toledo 82/7 i pone e kasa riba Pidi (Toledo) ku 7E1 (9600 baud). Dialog 06 ta funshoná tambe. E FX125 (ku display di preis) no konosé Toledo: einan Dialog 06. E kasa ta prepará esaki outomátikamente ora bo skohe e modelo.
• Avery Weigh-Tronix 7820, 7829 i ZP900 i Brecknell 6702U, 6710U i 6720U: NCI, e protokòl di Weigh-Tronix. E kasa ta manda W (meskos ku Toledo), e balansa ta kontestá ku e peso ( 1.234KG) i un liña di status; esei ta bisa si e ta move, si e ta muchu pisá òf muchu liviano. E kasa ta riba Pidi (Toledo) ku 7E1 (9600 baud). USB ta funshoná komo porta di COM virtual. Ku e ZP900, pone e kasa riba porta 2 (NCI). Ku e 67xxU, riba e balansa 8213 (SCP03) tambe ta posibel.
• Balanzas Marques BM1000P TOP: skohe na e porta di COM e protokòl B (METTLER) i 9600 baud, 7 bit di dato, paridat par; e kasa ta keda anto riba Pidi (Toledo) ku 7E1.
• Baxtran TW, VW, XTA i XTA-P (balansa di preis; VW i XTA-P ku pilar): den e menu RS232 di e balansa skohe e protokòl Toledo, 9600 baud i 7 bit di dato ku paridat par (7E1); e kasa ta keda anto riba Pidi (Toledo) ku 7E1. E kasa ta prepará esaki outomátikamente ora bo skohe e modelo. CONT (e balansa mes ta manda) ta funshoná tambe: pone e kasa anto riba Kontinuo ku e mesun velocidat i bit di dato. Konektá ku e kabel di RS232 (9 pin) òf un kabel di USB pa RS232.
• Bizerba CS 300: Checkout-Dialog 06 (e spesifikashon di Bizerba): e kasa ta manda e preis pa kilo, e balansa kalibrá ta kalkulá e suma. Si e balansa pidi kódigo di kontrol, bo ta haña nan di Bizerba òf di e proveedor.
• CAS PD-II, PDN, PDI i PDS-B (e PDS-B entre otro na LRE): skohe riba e balansa ECR type 2 (Toledo) i pone e kasa riba Pidi (Toledo) ku 7E1 (9600 baud).
• Datalogic Magellan 9300i, 9400i i 9800i: pone e Scale Interface Type di e porta di pisa separá riba Mettler Toledo 8217 i e kasa riba Pidi (Toledo) ku 7E1.
• Dibal KS-400, D-POS 400, G-325 i PI-100: skohe riba e balansa e protokòl Checkout_Dialog06 (protokòl 24) i 9600 baud, 7 bit di dato, paridat impar (tipo di parameter 5); e kasa ta keda anto riba Dialog 06. E D-POS 400 por konektá tambe via USB.
• DIGI DS-781: pone e balansa riba Type B / òrdu standard (data transmission 00011); e kasa ta manda ENQ i ta haña bèk peso neto, tara, preis pa kilo i suma.
• Dini Argeo DFW, DGT i 3590E: pone e porta serial riba manda kontinuamente (9600 8N1); e kasa ta keda anto riba Kontinuo.
• Excell Precision TPE (i e 4e generashon AM4, FD4-P, FDP4-P, GE4, GEP4): pone e salida RS232 riba kontinuo (9600 8N1); e kasa ta keda anto riba Kontinuo.
• Gram XFOC RS, XFOC+ RS i ZFOC RS: protokòl Gram (9600 8N1). E kasa ta manda ENQ, e balansa ta kontestá ACK, e kasa ta manda DC1 i e balansa ta manda e peso: SOH STX S/U/F teken gewicht eenheid BCC ETX EOT (S = stabil, U = ta move, F = fout; BCC = XOR di status te ku e unidat). Konektá ku RS232 òf ku e kabel di USB di Gram.
• Kern & Sohn RPB i RFC: pone riba e balansa Prot = DLG-06 (e konekshon pa kasa ta opshon 965-419); e kasa ta keda anto riba Dialog 06. RFE, IFB i EOC: manda kontinuamente (8N1), e kasa riba Kontinuo.
• Mettler Toledo Ariva/Viva: pone e balansa riba e protokòl di Toledo (8217) i e kasa riba Pidi (Toledo) ku Bit di dato / paridat = 7E1 (Mettler: 9600 baud, 7 bit di dato, paridat par; e Ariva por konektá tambe via USB komo porta di COM virtual). E kasa ta prepará esaki outomátikamente ora bo skohe e modelo.
• Minebea Intec Signum, Combics, Midrics i Puro i Sartorius Entris i Quintix: SBI ku imprimí outomátikamente (9600 8N1); e kasa ta keda anto riba Kontinuo. E mensahe ta N + 0.512 kg; sin unidat e peso ta move ainda.
• Ohaus Aviator 7000: skohe den e konfigurashon di e balansa (paso 20) e protokòl Dialog 06; e kasa ta keda anto riba Dialog 06. RS232 òf USB, dependiendo di e kabel.
• Ohaus Valor 7000, Ranger 3000/4000/7000 i Defender 3000 (pisa sin preis): pone e balansa riba Auto Print Continuous (9600 baud, 8N1) i e kasa riba Kontinuo. E balansa ta manda 0.512 kg G; un ? despues di e peso ta nifiká ku e ta move ainda. E Ranger 7000 por konektá tambe via Ethernet (porta di TCP 9761).
• Precia Molen DP400, DPOS CR i C 210 (e balansanan komersial ta di Dibal desde 2025): Dialog 06 (9600 7O1), meskos ku Dibal. Si e no ta funshoná ku e C 210, purba anto Pidi (Toledo) ku 7E1.
• Precisa XB, XT, LS i LX: pone e modo di imprimí riba CONTINUOUS i 9600 8N1, sin fecha, ora i ID riba e liña; e kasa ta keda anto riba Kontinuo. Sin unidat e peso ta move ainda.
• Rice Lake BenchPro BP-S (Toledo 8213) i BP-R (NCI): e kasa ta riba Pidi (Toledo) ku 7E1.
• Star Micronics mG-T i mG-S8200: via RS232 òf USB (porta di COM virtual, ku e driver di Star) riba Kontinuo.
• UWE ASEP: RS232 pa pc/kasa, e kasa riba Kontinuo (pa tèst).
• Wedderburn TSDS983, TSDS781T i TSDS782T ta balansa di DIGI bou di un number propio: DIGI (Type B), meskos ku e DIGI DS-781. Si esei no ta funshoná, purba anto Pidi (Toledo) ku 7E1.
• Wintec ScalePOS ACS-S60E: e kasa ta kore riba e ScalePOS mes; e balansa integrá ta riba COM6 (Windows) òf COM4 (Android), 9600 8N1. Skohe Kontinuo; si e no ta manda nada, Buska ta haña e protokòl korekto.
• Zebra MP7000 i MP72: e porta RS232-AUX ta for di fábrika riba SASI (9600 7E1, e kasa ta manda W): e kasa riba Pidi (Toledo) ku 7E1.
• Balansa di etiket di e markanan aki (Avery Berkel, Balanzas Marques, Bizerba, CAS, Dibal, DIGI, Ishida, Mettler Toledo, Precia Molen, Rongta, T-Scale, Wedderburn) ta sistema independiente ku nan mes archivo di PLU. Sende Skan etiket na e balansa i pone e mesun kódigo di bara ku riba e balansa (EAN-13, kuminsando ku 20–29, PLU i peso òf preis). Bo ta pone e PLU-nan riba e balansa mes òf ku e software di e marka; Manda na TS6X i Baha archivo di PLU ta disponibel solamente pa Aclas.

E mesun lista ta den e kasa bou di Konfigurashon → Balansa → Tur balansa (ACLAS_MODELLEN den packages/shared/src/weegschaal.ts, ku e marka pa modelo).

Yena mas tiki posibel: si bo skohe un modelo, e kasa ta prepará e resto kaba manera e marka ta pon'é for di fábrika: konekshon Porta di COM / USB riba e promé porta liber, 9600 baud (A&D: 2400) i e protokòl di e marka (Toledo: Aclas ku 8N1, i ku 7E1 Avery Berkel FX, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Brecknell, CAS, Datalogic, Mettler Toledo, Rice Lake i Zebra; Dialog 06: Avery Berkel FX125, Bizerba, Dibal, Kern & Sohn RPB/RFC, Ohaus Aviator i Precia Molen; DIGI Type B: DIGI i Wedderburn; Gram: Gram; Kontinuo: A&D, Adam Equipment, Dini Argeo, Excell Precision, e otro Kern & Sohn, Minebea Intec, e otro Ohausnan, Precisa, Sartorius, Star Micronics, UWE i Wintec), i un nòmber (p.e. OS6X, OS6X 2). Un balansa di PC òf di AI ta bira Riba e aparato aki (p.e. TS6X (integrá); riba Linux riba e porta interno /dev/ttyS0). Si algu no ta korekto, Buska ta haña e porta, velocidat i protokòl korekto.

Riba e aparato aki (Aclas Scale Module): e balansa ta mustra e peso kalibrá; e kasa ta manda e preis pa kilo i e tara (komo tara previo) i ta tuma over e montante ku e balansa ta kalkulá, meskos ku ku Dialog 06.

• Android: e app di Aclas AclasScaleDriver (com.aclas.aclasscaledriver) normalmente ta riba e balansa kaba; si no ta asina, instalá aclas-android/AclasScaleDriver.apk. E app di HorecaPOS ta papia direktamente ku e servisio di e app ei, pues no tin mester di un biblioteka ekstra.
• Linux: Aclas no tin Scale Module pa Linux. Simplemente skohe e modelo (por ehempel TS6X): e konekshon ta bira Riba e aparato aki (port interno) riba /dev/ttyS0, 9600 baud, Toledo. E balansa integrá mayoria biaha ta riba /dev/ttyS0 òf /dev/ttyS1; Buska ta purba nan i ta poné e port, velosidat i protokòl korekto. Aki tambe e por ta den e lista un biaha so.

Software di Aclas ta bini huntu ku e kaha: e Scale Module pa Windows (aclas-module), AclasScaleDriver pa Android (aclas-android) i e Aclas Sync SDK pa Windows i Linux (aclas-sdk). Aclas ta permití nos dualo huntu. E instaladónan pa Windows i Linux ta inkluí nan; no tin nada pa download òf instalá aparte.

Bluetooth (por ehempel e OS6X): promé kopla e balansa. Windows ta traha un port COM di dje (Ajuste di Bluetooth → Mas opshon di Bluetooth → Port COM), Linux /dev/rfcomm0: yena e port ei. Den e app di Android bo ta yena e adrès di Bluetooth (00:11:22:AA:BB:CC); e app ta pidi un biaha pèrmit pa Aparato serka i ta konektá via Bluetooth SPP.

Balansa AI (rekonosementu di produkto): e kámara ta rekonosé e produkto den e software di Aclas riba e balansa. Pisa ta funshoná via e Scale Module (riba e aparato aki) òf e port RS232; balansa di etiketa AI ta imprimí despues di rekonosé un etiketa ku kódigo di bara ku e kasa ta skèn (manera ku e TS6X).

Aclas AI Recognition Plugin (balansa AI ku e kasa riba dje, por ehempel e iS6X ku Windows): e plugin di Aclas ta rekonosé e produkto i ta tek su kódigo di bara den e kasa, meskos ku un skèner (ku Enter despues); e pantaya di òrdu ta pone e produkto ku e peso riba e òrdu. Asina bo ta konfigurá esaki:

• Sende Skèn etiketa na e balansa ku e mesun kódigo di bara ku den e plugin. Rekomendashon: ta kuminsá ku 27, PLU 5 sifra, peso (Aclas tipo 17): e kasa ta kalkulá anto mes ku e preis pa kilo. Ku e preis (tipo 12, ta kuminsá ku 22) tambe ta posibel.
• Pone Pisa na kasa afó pa e balansa ei: e plugin i e Scale Module no por yega na e balansa na mes momento. E peso ta sali for di e kódigo di bara. Si e plugin kontestá ora di Buska, e kasa ta proponé e konfigurashon aki i e no ta start e Scale Module. Sin kódigo di aktivashon e plugin ta pisa i ta kalkulá e montante, pero e no ta rekonosé produkto.
• Den e plugin mes: e kódigo di bara na Scale and Barcode Format Settings → Default Barcode Format (tipo 17), i den e konfigurashon di bentana e punto kaminda e plugin ta klek i ta tek e kódigo. Skohe pa esaki un lugá bashí den e pantaya di òrdu, no riba un boton. Produkto nobo e negoshi mes ta siña e plugin riba e balansa (training di AI).
• Duna e produktonan ku ta wòrdu pisá un number PLU i manda e PLU-nan na e balansa (Manda pa TS6X òf e archivo di PLU); e plugin ta rekonosé riba number PLU.
• E kasa ta laga e plugin rekonosé solamente miéntras e pantaya di òrdu ta habrí riba e balansa mes (POST /aiplugin/resume, ora di sera /aiplugin/suspend, port 5003 riba e balansa; e promé biaha tambe EmployeeMode: e pantaya pa kliente di e balansa no ta mustra produkto). Riba otro kasa i tablet i via e portal di maneho nada no ta pasa.
• E plugin ta start semper den Resume i no por pasa su estado. P'esei e pantaya di òrdu ta manda tur 30 sekonde atrobe resume; si esei no ta yega (pantaya será, plugin òf balansa a start di nobo), e kasa ta pone e plugin den ménos di un minüt riba Suspend i ta tene e einan.
• E plugin ta pidi un kódigo di aktivashon di Aclas pa kada balansa (vinkulá na e number di serie). Awor e ta funshoná riba Windows; e vershon di Android di Aclas ta bini (e kasa ta hasi meskos aya).

Aclas OS6X (balansa POS na kasa, RS232/USB; asina e otro balansanan konektá tambe ta funshoná):

• Un òf mas balansa (máksimo 8), kada un ku un nòmber (por ehempel Toonbank, Bar) i su mes konekshon: Port COM / USB (COM3 riba Windows, /dev/ttyUSB0 riba Linux/Android) ku e velosidat, òf red via un konvertidó serial-pa-red (adrès IP i port TCP, por ehempel 4001).
• Protokòl: Pidi (Toledo) = e kasa ta manda W i e balansa ta kontestá ku e peso (Toledo 8217, manera e OS6X normalmente ta poné; tambe e mensahenan di status no stabil/sobrekarga/bou di sero) òf Kontinuo = e balansa mes ta manda e peso kontinuamente (ST,GS, 0.512kg, US = no stabil) òf Dialog 06 (kalibrá), mira aki bou, òf DIGI (Type B) = e kasa ta manda ENQ i e DIGI ta kontestá ku status, peso neto, tara, preis pa kilo i suma (37 karakter: <status> <toestand> CR 0<netto> CR 4<tarra> CR U<kiloprijs> CR T<bedrag> CR LF; kondishon bit 1 = stabil, bit 2 = bou di sero, bit 3 = muchu pisá, bit 4 = muchu liviano), òf Gram = e kasa ta manda ENQ, ta warda riba ACK, ta manda DC1 i ta lesa SOH STX <S/U/F> <teken> <gewicht> <eenheid> <BCC> ETX EOT. Pone e mesun protokòl i e mesun velocidat riba e balansa. Bit di dato / paridat: 8N1 (Aclas, Adam Equipment, DIGI, Dini Argeo, Excell Precision, Gram, Kern & Sohn, Minebea Intec, Ohaus, Precisa, Sartorius, Star Micronics, UWE, Wedderburn, Wintec) òf 7E1 (A&D, Avery Berkel, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Brecknell, CAS, Datalogic, Mettler Toledo 8217, Rice Lake, Zebra); Dialog 06 ta semper 7O1. Pidi ta lesa tambe NCI (Avery Weigh-Tronix, Brecknell, Rice Lake BP-R): riba W e balansa ta kontestá LF 1.234KG CR LF S00 CR ETX; e liña di status (S + 2 òf 3 byte) ta bisa si e ta move (byte 1 bit 0), si e ta muchu liviano (byte 2 bit 0) òf muchu pisá (byte 2 bit 1); ^^^^^ = muchu pisá, _____ = muchu liviano.
• Dialog 06 (Checkout-Dialog 06, e protokòl Europeo pa un balansa kalibrá na un kasa): e kasa ta manda e preis pa kilo (i e tara di e produkto) na e balansa; e balansa ta pisa, ta kalkulá e montante su mes i ta mustra preis pa kilo, peso i montante riba su mes display (kalibrá). E kasa ta tuma over peso i montante; den e bentana di pisa ta para "kalkulá pa e balansa". Semper 9600 baud, 7 databits, paridat impar, 1 stopbit (e velosidat den e ajuste no ta konta anto). Proseso: EOT STX 01 ESC <kiloprijs 6> ESC ETX (ku tara: rekòrt 03 ku 4 sifra gram) → 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 = no ta kla ainda, anto atrobe despues di 100 ms; 20 = ta move; 21 = promé hisa; 30/31 = muchu liviano; 32 = muchu pisá; 11 = preis no ta válido). Kódigo di kontrol: hopi balansa Dialog 06 ta puntra de bes en kuando (por ehempel kada 30 pisamentu) pa e kódigonan di kontrol di e software di kasa (rekòrt 11 → rekòrt 10). E fabrikante di e balansa ta duna e kódigonan ei i kon nan ta wòrdu kalkulá solamente na e proveedor di kasa. Yena nan na Kódigo di kontrol (pa di 4 karakter heksadesimal, por ehempel 74AE 1B2C); e kasa ta manda nan ora e balansa puntra pa nan. Si e balansa ta kalkulá ku un number kambiante (Z) i pues kódigo fiho no ta kuadra, e kasa ta avisá esei; anto pidi e proveedor pa konfigurá e balansa sin e kontrol aki, òf usa Toledo.
• E balansanan ta konektá na e pc òf e aparato kaminda e server di kasa ta kore; tur kasa i tablet ta pisa via e server di kasa i ta skohe den e bentana di pisa kua balansa nan ta usa. Tèst ta pisa un biaha.
• Red ta funshoná tur kaminda.
• Tambe tek e peso na man: aktivá = tambe ku un balansa por tek e peso; sin OS6X esaki ta semper posibel.

Skèn etiketa (marka na e balansa: Aclas TS6X, un otro balansa di pc òf balansa AI, e seri LS òf e LH15X; balansa + printer di etiketa, un pa negoshi):

• Adrès IP: solamente nesesario pa Manda pa TS6X. Pisa i skèn etiketa ta funshoná sin. Si e kasa ta kore riba e TS6X mes, laga e bashí: e kasa ta manda anto na su mes (127.0.0.1). Si e mesun balansa ta pisa na kasa tambe, tur dos marka ta na e mesun balansa (Buska ta prepará esei asina).
• Skèn etiketa: skèn etiketa riba e pantaya di pidi. Konfigurá kon e kódigo di bara ta parse, meskos ku riba e TS6X: ta kuminsá ku (20–29, standart 28), kantidat di sifra pa e PLU (4, 5 òf 6) i despues e peso na gram òf e preis na sèn, plus e sifra di kontrol (EAN-13). Bou di e ajuste tin un ehempel.
• Number PLU: na Ajuste → Produkto un produkto ku ta wòrdu pisá ta haña un preis pa kilo, eventualmente un tara i un number PLU (úniko). Bo ta skohe e number PLU for di un lista (Sin PLU, siguiente liber, Otro number…); ora bo marka Preis pa kilo e siguiente number liber ta einan kaba. Solamente nesesario pa e etiketa i PLU'nan di e TS6X: sin TS6X e por keda Sin PLU.
• Manda direktamente ta traha riba Windows i Linux; riba Android i macOS usa e archivo PLU. Na e promé instalashon, kontrolá e nòmbernan di kampo di e archivo PLU i e kódigonan den aclas-plu.ps1 kontra e manual di SDK di e balansa entregá (un lugá pa adaptá: ACLAS_PLU_KOLOMMEN den packages/shared/src/weegschaal.ts).

Portal di maneho: e notifikashon na e portal tin e funshon Balansa (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) ku sendé/pagá i kua balansa pa modelo (p.e. TS6X (op dit apparaat), 2x OS6X, PS1CX, Ariva-S, DS-781, LS6RX, 5 producten per kilo); sin adrès di IP, porta di COM òf adrès di Bluetooth.

Lei di kalibrashon: un balansa ku bo ta bende kuné mester ta kalibrá (klase III, manera e OS6X). Ku Toledo/kontinuo e kasa ta kalkulá ku e peso ku e balansa ta duna; ku Dialog 06 e balansa kalibrá mes ta kalkulá e preis.

Kódigo: packages/shared/src/weegschaal.ts (protokòl, etiketa, archivo PLU), apps/pos-server/src/lib/weegschaal.ts i routes/weegschaal.ts; pantaya WeegschaalInstellingen.tsx i WeegDialoog.tsx.

Thuisbezorgd.nl / Takeaway.com

Pedido di Thuisbezorgd.nl ta yega direktamente den e kasa, sin intermediario (no Deliverect, HubRise òf algu asina): Just Eat Takeaway JET Connect ta papia ku e portal di maneho di Pin Voordeel, i e kasa ta buska su mensahenan einan.

Na Bélgika e plataforma yama Takeaway.com: e mesun kompania (Just Eat Takeaway) i e mesun konekshon. Pa un negoshi Belga tur kaminda den e pantayanan, mensahenan, riba e bon di trabou i den e portal di maneho ta para Takeaway.com en bes di Thuisbezorgd.nl. Aki bou Thuisbezorgd ta para pa tur dos.

Pakiko via e portal? E kasa tin mester solamente di PORTAAL_URL i PORTAAL_SLEUTEL (wak Portal di maneho) i ta hasi solamente petishonnan saliente.

Konfigurá (Konfigurashon → Plataformanan di entrega → Thuisbezorgd.nl / Takeaway.com, permiso Konfigurá negoshi, pago i printer; promé esaki tabata serka Konfigurashon → Negoshi):

1. Aktivá Usa Thuisbezorgd (ta bai mesora, apart di Warda).
2. Registrá na Thuisbezorgd. Despues e negoshi ta skohe na Thuisbezorgd (Partner Hub òf account manager) OptimumPOS / Pin Voordeel komo kasa. JET ta start anto un seshon di onboarding; e portal ta buska e kasa registrá (riba kódigo postal i nòmber, si no Pin Voordeel ta kopla e seshon na man den e portal), ta manda e konfigurashon i ta pidi e kasa pa e menu. Despues e konekshon ta bai live.
3. Marka e produktonan ku por wòrdu pidi via Thuisbezorgd (pa grupo òf apart), eventualmente ku un deskripshon pa Thuisbezorgd. E menu (preis, opshonnan komo modifier, alergeno, BTW) ta bai automátikamente; PLU = id di e produkto/e opshon. Despues di un kambio den e katálogo e kasa ta aktualisá e menu den 30 sekònde; solamente "kaba"/"disponibel atrobe" ta bai via e API di disponibilidat.
4. Oranan di habri Thuisbezorgd: separá pa entrega i pa hiba (p.e. 16:00-22:00, varios blòki ku un koma). Nan ta wòrdu wardá ku e boton Warda oranan di habri bou di dje i ta bai komo service times na Thuisbezorgd apenas e konekshon ta kla.
5. Sera temporalmente / Habri atrobe (na NL/BE habri atrobe mas lat e siguiente mainta 07:00).

Pedido. Un pedido ta bira un pedido normal sin mesa (bezorgen òf afhalen, nòmber di grupo TB <ordernummer>) ku e preisnan ku e kliente a paga, plus kosto di entrega/kosto di servisio komo su mes liña i deskuento di Thuisbezorgd komo liña di deskuento; si e total tòg no ta kuadra, anto un liña "Diferensia Thuisbezorgd". E bon di trabou ta bai mesora na kushina/bar (por desaktivá). E kasa ta konfirmá den sekòndenan na e portal, ku ta avisá JET; si esei no ta logra den 3 minüt òf e kasa ta offline, JET ta haña "faya" i e negoshi ta bai bèk riba e Orderpad.

Boton Thuisbezorgd den e bara di riba (ku kantidat di pedido ku ta kore): lista, kliente i adrès, ora di kla/entrega i e liña di tempu (track & trace): risibí, repartidó na kaminda pa e negoshi, repartidó na e negoshi, na kaminda pa e kliente, entregá (di JET), plus pasonan propio (ta prepará, kla, na kaminda/entregá si bo ta entregá bo mes, buská). Un mapa live ku e repartidó JET Connect no ta ofresé na e kasa; esei e kliente ta mira den e app di Thuisbezorgd. Pedido nobo, kanselashon i "repartidó na e negoshi" ta duna un bara oraño i un zonido. Kaba (pagá online) ta kobra ku manera di pago online; si e kliente ta paga na porta, anto simplemente kobra. Un kanselashon di Thuisbezorgd ta laga e pedido kaduká i ta imprimí un bon di kushina "KANSELÁ".

Kódigo: apps/pos-server/src/lib/thuisbezorgd.ts, routes/thuisbezorgd.ts; pantaya ThuisbezorgdInstellingen.tsx i Thuisbezorgd.tsx. Banda di portal: horecapos-portaal/src/thuisbezorgd.mjs (wak README di e portal).

Konteo den e portal di maneho. E kantidat di pedido di Thuisbezorgd pa dia ta bai kuné den e notifikashon na e portal di maneho (verkoopTelling den lib/portaal.ts): yegá i no kanselá, riba e dia ku e a yega. Un pedido di Thuisbezorgd ku ta wòrdu kobrá den e kasa (tambe Kaba (pagá online)) no ta konta einan atrobe na pa hiba/entrega. E datonan di Thuisbezorgd ta den e base di dato di kasa i pues ta bai simplemente kuné den e back-upnan di e kasa.

Tienda online i òrdu online

Kada negoshi por haña su mes tienda online: un sitio di òrdu (i app) den su mes estilo pa pa hiba, entrega, pidi na mesa ku un kódigo QR i reservá, ku pago online (MultiSafepay òf Buckaroo) òf pago na ora di buska/entrega. E tienda online ta un proyekto separá, horecapos-webshop (Node.js, wak e README einan), i ta kore riba e mesun server ku e portal di maneho.

Aktivá i konfigurá ta sosodé den e maneho di tienda online: boton Maneha tienda online den e portal di kliente (doño) òf na e instalashon den e portal di maneho (Pin Voordeel). Einan tin aktivá/desaktivá, e adrès web (<zaak>.<webshopdomein> òf un domein propio), estilo (koló, logo, potrèt di kabes, tipo di lèter), orario i bloke di ora pa pa hiba i entrega, zona di entrega (kódigo postal, radio òf un área riba e mapa, ku kosto i mínimo), pago, kódigo di deskuento, teksto, idioma, kódigo QR pa e mesanan, reservashon i e app (instalabel komo PWA; un app di Android via un Trusted Web Activity), i mensahe push (opshonal, standard desaktivá): e kliente ta aktivá un notifikashon riba e página di su òrdu i ta risibí un mensahe push ora e òrdu ta kla òf na kaminda; esnan ku ke ta risibí tambe di bes en kuando un oferta, ku e negoshi ta manda for di e maneho di tienda online (tab Mensahe push). Ta funshoná riba Android i kompiuter (Chrome, Edge, Firefox, Samsung Internet), den e app di Android, i riba iPhone i iPad (iOS 16.4 òf mas nobo) si e kliente pone e webshop riba e pantaya prinsipal. No ta manda SMS ni e-mail i no ta warda nòmber ni number. Detayenan den e README di e webshop.

Menu. E kaha ta manda e menu outomátikamente: tur produkto aktivo (no pa kilo), pa grupo di produkto, ku prijs, opshon, alergeno, agotá i e potrèt di produkto, plus e mesanan i e datonan di e negoshi, i kua kanal di marketing ta aktivá (pa e marka "risibí oferta" na kobra, wak Marketing pa sms i e-mail). Esei ta pasa na ora di start, ora e tienda online wòrdu aktivá, den 30 sekonde despues di un kambio den e katalogo i den algun sekonde despues di un kambio na Ajuste → Negoshi, manera marketing òf e karchi di kliente (òf ku Manda menu awor). Bo por tene un produkto fuera di e tienda online den e maneho di tienda online (skonde), òf den e base di datos ku artikel.webshop = false.

Òrdunan. Pa hiba i entrega ta bira un òrdu normal sin mesa (nòmber di grupo WEB <bestelnummer>) ku e preisnan ku e kliente a mira, plus kosto di entrega i kosto di transakshon komo liña propio i un kódigo di deskuento komo liña di deskuento; si e total tòg no ta kuadra, ta bin un liña "Diferensia tienda online". E propina di e kliente no ta konta komo entrada: e ta bin na Kaba (pagá online) komo propina den e pago. Pidi na mesa (kódigo QR) ta bai na e kuenta habrí di e mesa ei (pagá online: komo grupo propio na e mesa ei). E bon di trabou ta bai mesora pa kushina/bar (por desaktivá den e bentana Tienda online). E kaha ta konfirmá den sekonde ku e número di resibu; e kliente ta haña "risibí" i un e-mail. Si e kaha ta offline, e tienda online no ta tuma òrdu (e kliente ta mira esei mesora) i ta manda e-mail na e negoshi si un òrdu keda warda muchu largu. Reservashonnan di e tienda online ta bin den Reservashonnan (djis si reservashon ta aktivá den e kaha). Si tin un máksimo pa bloke di ora (Entrega i bloke di ora), òrdunan di tienda online ku un ora den e bloke ei ta konta tambe.

Bèlgika (kaha preta). Un òrdu di tienda online ta bai mesora komo òrdu (signOrder) na e kaha preta, promé ku e bon di kushina, meskos ku Manda òrdu na kaha. Si esei no ta logra, e no ta drenta e kaha i e tienda online ta mand'é di nobo despues. Loke no a wòrdu tèst ainda ku e kaha preta ta desaktivá den e menu pa e tienda online (vale di regalo, kódigo di deskuento, riba kuenta, riba e kamber, menu, opshon ku preis ekstra, happy hour i propina) i ta wòrdu rechasá si un tienda online bieu manda esaki tòg. Kompletá ta kontrolá propina, riba kuenta i riba e kamber meskos ku e kaha.

Riba e kamber (konekshon di hotel, Konfigurashon → Hotel → Outoservisio → Den e tienda online): e menu ta haña kamer: { maxBedrag }; e tienda online ta manda betaling.wijze = "kamer" ku kamer i achternaam. E kaha ta kontrolá e invitado serka e software di hotel (no na mesa, no ku vale di regalo) i ta warda e serka e òrdu; Kompletá (riba e kamber) ta kobra riba e kamber i ta registrá e resibu riba e kuenta di hotel. Faktura kolektivo pa riba kuenta: e resibu ta keda habri komo un posto.

Boton Tienda online den e bara ariba (ku kantidat di òrdu den proseso): lista, kliente i adrès, ora deseá òf "mas lihé posibel", manera di pago i e liña di tempu. E pasonan Den preparashon, Kla i Na kaminda e kliente ta mira en bibo den e tienda online (i pa e-mail, si e negoshi ke). Kobrá den e kaha = Kompletá; Kanselá ta kansela djis e liñanan di e òrdu di tienda online ei, ta imprimí un bon di trabou "KANSELÁ", i e tienda online ta devolvé e plaka di un òrdu pagá online. Yegá, no-show òf kanselá serka un reservashon ta bai bek na e tienda online tambe. Un òrdu òf reservashon nobo ta duna un bara oranje i un zonido.

Kódigo: apps/pos-server/src/lib/webshop.ts, routes/webshop.ts; pantalla Webshop.tsx. Banda di portal: horecapos-portaal/src/webshop.mjs.

Kaha i tienda online igual (kada parti por wòrdu aktivá aparte, standard desaktivá; un webshop mas bieu ta ignorá e kamponan nobo). Loke ta aktivá den e kaha ta funshoná tambe den e tienda online:

• Happy hour: e tienda online ta kobra e mesun preis ku e kaha na e momentu ei (preis normal tachá i e nòmber di e happy hour), tambe ku un temporada.
• Partinan di dia i tipo di òrdu (si nan ta aktivá): e tienda online ta mustra djis loke ta na benta awor, i na bini buska i entrega e preis i produktonan di e opshon ei (na mesa: pa kome aki). E menu ta haña pa produkto prijzen (afhalen, bezorgen) i nietBij, i e lista dagdelen.
• Menu: e kliente ta skohe e kumindanan (fiho i di skohe, ku nan opshonnan); den e kaha e ta bin komo liña di menu ku e kumindanan bou di dje i e preis di menu partí (BTW pa kuminda ta kuadra). Kumindanan ku ta pertenesé solamente na un menu ta bai komo menuArtikelen. Un tienda online bieu sin opshon: e menu ta bin komo produkto normal riba e resibu, manera promé.
• Stòk kabá = bendí kompletamente, tambe opshonnan ku un ingrediente ku a kaba.
• Alergeno: desaktivá den e kaha = no den e tienda online.
• Karchi di kliente: e kliente por spar punto ora di paga (riba number di telefòn òf e-mail); e kaha ta konektá e kliente na e òrdu, e puntonan ta bin aserka ora di kobra (kambia ta sosodé den e negoshi). E tienda online ta mustra e saldo.
• Valenan di regalo (Konfigurashon → Negoshi → Valenan di regalo → Bende valenan di regalo den e tienda online, solamente ku saldo): e kliente ta kumpra un vale i ta paga online; e kaha ta traha e vale, ku ta aktivo mesora, i e kódigo ta bai bèk via e portal na e tienda online (status i e-mail). Si Vale di regalo komo método di pago tambe ta aktivá, e kliente por skohe ora di hiba pa "ku un vale di regalo den e negoshi".
• Kódigonan di deskuento (Konfigurashon → Kódigonan di deskuento, ku e switch na Negoshi): pa kódigo na e kaha i/òf den e tienda online; e uso ta konta pa tur dos huntu.
• Pousa i ocupá: boton Tienda online den e baranka ariba: Pousa tienda online (ku un teksto pa e kliente) i Ocupá (minüt ekstra). Ta yega den e tienda online den algun sekonde.
• Reservashon online ku e reglanan di e kaha (Konfigurashon → Negoshi → Reservashonnan): máksimo persona, dia di antemano, bloke di ora, mínimo di antemano i e oranan pa dia di siman.
• Entrega i bloke di ora: mira E tienda online ta sigui e kaha na Entrega i bloke di ora.
• All-you-can-eat na mesa (Konfigurashon → Negoshi → All-you-can-eat → Tambe ora di ordená na mesa via e kódigo QR): si tin un paket ta kore na e mesa, e kliente ta mira e kumindanan ku ta pertenesé n'e komo Inkluí pa € 0, ku e rondanan, e máksimo pa persona, e tempu di espera i e límite di tempu. E resto e ta paga normal; tur kos ta bai riba e kuenta di e mesa. Si e situashon na mesa a kambia djis, e kaha ta rechasá e òrdu i e kliente ta ordená atrobe.
• Riba kuenta (Konfigurashon → Fakturanan → Paga riba kuenta → Tambe den e tienda online): wak Den e tienda online na Paga riba kuenta.
• Online riba e lista di espera (Konfigurashon → Negoshi → Lista di espera): wak Online riba e lista di espera na Lista di espera pa walk-ins.
• Upsell: "Algu mas ku esaki?" (opshonal, standard desaktivá; Konfigurashon → Negoshi → Kobra → Upsell den e tienda online): skohe e kategorianan (p.e. bebida, salsa, dushi) i kuantu sugerensia. Den e tienda online e ora ei, na e kanaster i na kobra, ta aparesé produkto for di e gruponan ei ku ainda no ta den e kanaster (solamente loke ta na benta awor, no bendí kompletamente i sin opshon obligatorio); e kliente ta agregá nan ku un toke. Ningun grupo skohé = desaktivá, manera promé. E kiosko tin su mes upsell (wak Kiosko di outoservisio).

P'esei e menu pa e tienda online tin versie: 2 ku e kamponan menuArtikelen, allergenenAan, happyhours, menus, klantenkaart, cadeaubon, kortingscodes, pauze, drukteMin, volgt, bezetting, reserveren.online, ayce, opRekening, wachtlijst i upsell. E konfirmashon na e portal tin ademas cadeaubonnen (kódigo), klant (punto) i plek (lista di espera).

Konteo den e portal di maneho. Pa hiba i entrega via e tienda online ta konta aparte (webshop, webshopGeannuleerd den verkoopTelling), riba e dia ku e òrdu a drenta, i no un biaha mas na pa hiba/entrega. Pidi na mesa ta konta normal na mesa.

Pago ku pin i terminal di pago

Ajuste → Pago (solamente atministradó):

• Terminal: pa kada terminal un nòmber, e ID di terminal i e kódigo API propio for di PinPortal (Kliente → Editá kliente → Otro → API Keys). Despues di warda, solamente e final di e kódigo ta visibel; e nunka ta bai bèk na e browser. Ku Tèst konekshon bo ta kontrolá kódigo i terminal.
• Modo di tèst: ta imitá un terminal (despues di ±7 s logra; un montante ku ta terminá riba 13 sèn ta wòrdu rechasá). Útil pa tèst sin terminal di pago.

Si tin por lo ménos un terminal ku kódigo API (òf modo di tèst ta aktivá), Kobra → Pin / Bancontact ta start e pago outomátikamente riba e terminal, pa e montante ku e server ta kalkulá.

Miéntras e konekshon ta aktivá, e server ta aseptá "pin" solamente ku un pago di terminal lográ pa eksaktamente e pedido ei i e montante ei. E petishonnan ta bai meskos ku den e PHP-SDK ofisial komo formulario normal, ku e API di reserva (api-backup.pinvandaag.com) si e API prinsipal no ta kontestá. Kada kontesta di e API ta para ku [pin] den e bentana di server, útil ora di problema. Un pago lográ ku ainda no a wòrdu prosesá (p.e. tablet a para), ta wòrdu haña bèk ora di e siguiente kobransa di e pedido ei.

Propina (pin, kèsh i bon di regalo)

Den e pantaya di kobra tin pa kada manera di pago un rei di boton di propina: Niun, 5%, 10%, 15% (rondoná pa ariba na 10 sèn), Rondea (te e siguiente euro kompleto) i Otro montante. Ku pin e kliente ta paga montante + propina na un biaha riba e terminal; ku kèsh e propina ta konta den e kambio i den e laria di kasa. Riba e risibu ta para e montante pagá ku pin ku "di kua propina" bou di dje; e TOTAL i e BTW ta keda meskos, pasobra propina no ta benta. Den e rapòrt X/Z e propina ta parse pa manera di pago i komo "Total di propina".

E atministradó ta konfigurá e botonnan di propina na Ajuste → Negoshi → Propina: aktivá/desaktivá, kua porsentahe (máksimo 4, p.e. "5, 10, 15"), si e boton "Rondea" ta eiden i ku kua manera di pago (pin, kèsh, bon di regalo) propina ta posibel. "Niun" i "Otro montante" ta semper eiden.

"Hasi'é …" ta semper eiden, ku kada manera di pago, tambe si e botonnan di propina ta desaktivá (sin ajuste): e kliente ta rondea e kuenta pa ariba su mes i e diferensia ta propina. Tin boton ku e siguiente euro kompleto i e siguiente montantenan rondo (p.e. € 28,00 → 29, 30, 40; € 44,00 → 45, 50, 60) i Otro total pa tek e total bo mes. Toka atrobe riba e boton skohé = no rondea. Máksimo € 500 propina (mesun límite ku e server di kasa).

Sin internet

E kasa ta funshoná den e red lokal i no tin mester di internet; solamente pago ku pin via e konekshon sí. Si e negoshi no tin internet, den e bara di riba ta para Sin internet · pin na man (kontrolá kada minüt). Den e pantaya di kobra anto ta aparesé, i tambe despues di un start fayá riba e terminal, e boton Pagá kaba ku pin riba e terminal: paga e montante riba e terminal mes i registrá e asina.

Plano i mesa

Ajuste → Plano (solamente atministradó):

• Agregá plano (p.e. Sala, Teras, Seru), kambia nòmber, kita i kambia órden ku ◀ ▶.
• Agregá mesa ku e botonnan riba e rèster (rondo, kuadrá, largu, mesa di para) i hala nan ku e mouse òf dede na nan lugá. E skina blou di un mesa skohé ta hasi e mas grandi òf mas chikí.
• Pa kada mesa konfigurá nòmber/number, kantidat di persona (e stulnan rondó di e mesa ta konta) i forma; dupliká òf kita.
• Ku teklado: flecha ta move (Shift = paso mas grandi), Delete ta kita.
• Kambionan ta konta solamente despues di Warda; "Deshasí" ta pone tur kos bèk.
• Un mesa òf plano ku un pedido habrí no por wòrdu kitá. Mesanan kitá ta keda wardá den pedidonan bieu.

Pasa konfigurashon over pa un di dos negoshi

Ajuste → Importá/Eksportá (solamente e atministradó). Si bo a konfigurá un negoshi kompletamente, eksportá e konfigurashon na un archivo .json i importá esei den e kasa di e di dos negoshi. Pa kada parti bo por skohe:

• Produkto: grupo, produkto, preis (tambe pa tipo di òrdu), BTW, opshon, menu, happy hour (ku temporada), partinan di dia, alergeno, ingrediente/resèt, karchi di stèmpel, e paketenan di all-you-can-eat i e potrètnan di produkto.
• Plano: sala i mesa.
• Otro ajuste: tur opshon di e negoshi, printer (sin adrès IP), derecho pa ròl i kontabilidat.

Nunka no ta bai kuné: nòmber, adrès, kódigo postal, lugá, telefòn, e-mail, number di BTW i liña final di risibu di e negoshi, e adrès di e-mail pa e raport Z, terminal di pin i nan kódigo, personal i kódigo PIN, i tur benta, risibu, kliente i kantidat di stòk.

Importá ta hopi protehá: un spièrta grandi kòrá, un marka "Mi ta komprondé...", atrobe e kódigo PIN propio di e atministradó, sin pedido habrí, mesun pais (tarifa di BTW) i di antemano outomátikamente un back-up. E importashon ta sosodé den un transakshon: si algu bai robes, nada no ta kambia. Produkto, grupo, ingrediente i mesa eksistente no ta wòrdu bora, pero kitá for di e kasa (manera ku Kita), pa risibu i raport bieu keda kuadra.

Importá for di otro kasa

Kambia sin tin ku tipiá tur kos di nobo. Semper disponibel (sin swich): na Konfigurashon → Importá/eksportá (solamente e atministradó) tin e parti Importá for di otro kasa.

• Kiko: produktonan (nòmber, preis ku BTW, BTW, grupo, kódigo/PLU, stòk) òf klientenan di e karchi di kliente (nòmber, telefòn, e-mail, punto, adrès, kódigo postal, lugá; nòmber i fam ta wòrdu poné huntu).
• Archivo: un eksport di bo kasa anterior (Dobizzz/DoPos, Lightspeed, MplusKASSA, unTill, Tebi ...) òf bo mes lista: CSV (; , tab òf |; UTF-8 òf Excel-hulandes) òf Excel (.xlsx), e promé fòi, ku e nòmbernan di kolom riba e promé liña. Un archivo .xls bieu, warda esei promé komo .xlsx òf CSV.
• Ehèmpel: e kasa ta rekonosé e kolomnan na nan nòmber (Omschrijving, Verkoopprijs incl. BTW, BTW %, Omzetgroep, Artikelnummer, GSM, Spaarpunten ...) i ta mustra e promé 10 liña. Si un kolom no ta korekto, skohe bo mes. Nada no ta kambia te ora bo primi Importá.
• Produktonan: preis manera 3,50, € 3,50 òf 1.234,50; BTW manera 21, 9%, 0,09, haltu òf abou (deskonosí òf bashí: e tarifa ku bo skohe, standart esun mas haltu). Kategorianan ku ainda no ta eksistí ta wòrdu krea (sin grupo: "Importá").
• Stòk (kolom Voorraad, Stock, Aantal ...): si Tene kuenta di stòk ta sendé (Ajustenan → Negoshi), e produkto ta tene kuenta di stòk i e stòk ta bira e kantidat ei (un konteo den historia di stòk, motibu "Importá"). Bashí: e stòk ta keda manera e ta.
• Archivo di ehempel (CSV): un lista pa bo mes yena (Naam;Productgroep;Prijs;Btw;Voorraad;Code), por ehempel den Excel.
• Klientenan: punto ta wòrdu agregá komo korekshon "Importá for di otro kasa" (visibel den e historia). Pèrmit pa sms òf e-mail no ta pasa (AVG): bo ta pidi esei atrobe. Aktivá e karchi di kliente promé.
• Produktonan eksistente (mesun kódigo, òf sin kódigo mesun nòmber) i klientenan (mesun telefòn òf e-mail) ta wòrdu saltá, òf aktualisá si bo marka esei (na produkto: nòmber, preis, BTW, grupo i stòk). Liñanan dobel den e archivo ta wòrdu tumá un biaha so.
• Despues: kuantu nobo, aktualisá i saltá, ku pa kada liña kiko no tabata korekto (p.e. sin preis). Máksimo 5000 liña pa biaha. Den e buki di registro e ta pará komo "Konfigurashon importá".

Idioma (42, entre otro Turko, Arabe, Darija, Berber, Polako, Búlgaro, Húngaro, Ruso, Serbio, Albanes, Persa, Tigrinya, Amhariko, Somali, Papiamentu, Sranantongo, Hindi, Urdu, Indonesio, Vietnamita, Arameo Siriako, Chines i Ukraniano)

Banda di e boton © abou na banda drechi tin riba kada pantaya un boton ku e idioma (p.e. NL i e bandera). Toka riba dje pa e menu di skohe: e idiomanan ta na órden alfabétiko, ku e nòmber den e idioma mes promé ku e bandera: Bahasa Indonesia (Indonesio), Čeština (Cheko), Darija (Arabe Marokano na lèter latino), Deutsch, English, Español, Français, Hrvatski (Kroata), Italiano, Kurdî (Kurmancî), Latviešu (Leton), Lietuvių (Lituano), Magyar (Húngaro), Nederlands, Papiamentu (Papiamentu), Polski, Português, Română, Shqip (Albanes), Slovenčina (Eslovako), Soomaali (Somali), Sranantongo, Srpski (Serbio, na lèter latino), Tarifit (Berber di Rif), Tiếng Việt (Vietnamita), Türkçe, despues na lèter siríliko Български (Búlgaro), Русский (Ruso) i Українська (Ukraniano), despues e idiomanan na lèter árabe: اردو (Urdu), الدارجة (Darija), العربية (Arabe), دری (Dari), فارسی (Persa, Farsi), پښتو (Pashto) i کوردی (سۆرانی) (Kurdo Soranî), despues na lèter siriako ܣܘܪܝܝܐ (Arameo Siriako, Suryoyo), na lèter devanagari हिन्दी (Hindi), na lèter ge'ez ትግርኛ (Tigrinya) i አማርኛ (Amhariko), na Tifinagh ⵜⴰⵎⴰⵣⵉⵖⵜ (Tamazight, Berber), i komo último 中文（简体）(Chines, lèter simplifiká). Tur pantaya, boton, mensahe i mensahe di eror di e server di kasa ta wòrdu tradusí.

• Pa empleado: e idioma skohé ta wòrdu wardá serka e empleado ku a hasi login (gebruiker.taal). Si un hende hasi login ku otro idioma, e kasa ta kambia mesora. Riba e aparato mes e último idioma usá ta keda wardá, pa asina tambe e pantaya di kódigo PIN ta den e idioma ei kaba. Si bo skohe un idioma (riba e pantaya di kódigo PIN òf ora bo ta login) i bo hasi login (atrobe) den 10 minüt, e eskoho ei tin prioridat i e ta bira e idioma di e empleado ei. Kambia ta karga e pantaya di nobo; bo ta keda login i e kuenta habrí ta keda habrí.
• Promé biaha riba un aparato: si riba un tablet òf pc no tin idioma ainda, e kasa ta start den e idioma ku a wòrdu skohé ora di instalá. Si no a skohe idioma, e idioma di e aparato mes (browser òf sistema operativo, tambe den e app di Android), i si esei no ta den e lista, na Hulandes. Despues kada aparato ta kòrda su mes eskoho.
• Europa Oriental: Polako, Cheko, Eslovako, Húngaro, Rumano, Búlgaro, Kroata (tambe pa Bosnio), Lituano, Leton, Ukraniano i Ruso: e idiomanan di mayoria migrante laboral di Europa Sentral i Oriental na Hulanda i Bélgika.
• Balkan: Serbio (na lèter latino, manera mayoria Serbio na Hulanda i Bélgika ta skirbi e; tambe pa Montenegrino) i Albanes (Albania, Kòsovo i Masedonia di Nort).
• Kachu di Áfrika: Tigrinya (Eritrea) i Amhariko (Etiopia), tur dos na lèter ge'ez, i Somali (na lèter latino).
• Iran: Persa (Farsi). Un aparato den e Persa di Afganistan (fa-AF) ta haña Dari, e resto Farsi.
• Hulanda Karibe i Surinam: Papiamentu (Papiamentu, ortografia di Kòrsou i Boneiru; tambe pa Aruba) i Sranantongo.
• Asia: Hindi (Devanagari; tambe pa Sarnami Hindustani), Urdu (di drechi pa robes), Indonesio i Vietnamita (lèter latino, tambe riba e resibu).
• Marokano: Darija (Arabe Marokano, e idioma papiá) na lèter árabe i tambe na lèter latino (manera hopi Hulandes Marokano ta skirbi den app), banda di e Arabe standart. Berber: Tarifit (di Rif, na lèter latino; mayoria Hulandes Marokano ta bini for di Rif) i Tamazight Marokano Standart na lèter Tifinagh.
• Di drechi pa robes: Arabe (Arabe standart), Urdu, Darija na lèter árabe, Dari i Pashto (Afganistan), Persa (Farsi, Iran), Kurdo Soranî (Irak/Iran) i Arameo Siriako (Suryoyo, na lèter siriako). Montante, kódigo i e tekla di sifra ta keda di robes pa drechi. Kurdo Kurmancî (Turkia/Siria) ta na lèter latino.
• Bon di kushina (kushina/bar): standart den e idioma di e empleado ku ta pasa e pedido. Pa kada printer bo por skohe tambe na Ajuste → Printer → Idioma di e bon di kushina un idioma fiho (p.e. esun di e kòki), na lèter latino: 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 òf Türkçe. Búlgaro, Ruso i Ukraniano ta sali riba e bon di kushina na transkripshon latino (e printer di risibu no konosé siríliko). Lèter árabe, siriako, devanagari, ge'ez i Tifinagh i Chines no por riba un printer di risibu: anto Darija ta sali na lèter latino, Tamazight komo Tarifit i e resto na Hulandes. E tekstonan fiho (MESA, Tanda, WARDA pa yama, YAMA TANDA, IMPRIMÍ DESPUES, Pa hiba, Toonbank) ta wòrdu tradusí; nòmber di produkto i komentario ta keda manera nan a wòrdu drenta. Printernan ku tabata riba Hulandes, ta sigui e empleado.
• Risibu di kasa (pa tur kliente): standart Hulandes, apart di e idioma di e pantayanan. Otro idioma bo ta skohe na Ajuste → Negoshi → Idioma di e risibu di kasa (djis bou di e teksto abou di e risibu), solamente idioma na lèter latino. Esei ta konta tambe pa pro forma, risibu di retorno, kopia, bon di regalo i e risibu pa e-mail. E montantenan, kódigo di BTW, e number di BTW di e negoshi i e reglanan fiskal (Bélgika) ta keda meskos; un teksto propio abou di e risibu ta keda manera e negoshi ta tek e.
• Produkto, grupo i opshon ta yama manera e negoshi ta drenta nan; nan no ta wòrdu tradusí.
• E idioma pa empleado bo ta konfigurá tambe na Ajuste → Personal.
• Introdukshon i manual ta disponibel tambe den tur e idiomanan aki. Via e boton © nan ta habri den e idioma di e kasa; ariba bo ta skohe ku e banderanan un otro idioma (esei no ta kambia nada den e kasa).

Pa desaroyadó: kada teksto visibel ta den e kódigo komo vt('Nederlandse tekst') (apps/pos-web/lib/i18n.ts); e teksto Hulandes ta e yabi. E tradukshonnan ta den apps/pos-web/lib/vertalingen/<taal>.ts. Si un tradukshon falta, e kasa ta mustra e Hulandes; e tèst i18n (pos-web) ta kontrolá ku kada teksto ta tradusí den kada idioma i ku e lugánan {0} ta kuadra. Mensahenan di e server di kasa ta keda Hulandes i ta wòrdu tradusí den e browser (tambe ku {0}, p.e. un nòmber di produkto den e mensahe).

Konfigurá printer

Un kasa nobo no tin niun printer. Hasi login komo atministradó (demo: 1111) i skohe Ajuste den e bara di riba.

• Printernan: agregá tantu printer ku e negoshi tin (p.e. kaha, kushina, bar, pizza), kada un ku un konekshon (mayoria biaha e red: adrès IP i pòrt 9100) i hanchura di papel. Ku Resibu di test bo ta kontrolá si e ta funshoná. Ariba bo ta skohe kua printer ta print e resibu i pro forma (i ta habri e kashi di plaka). Pa kada printer bo ta skohe tambe e idioma di e bon di kushina (wak Idioma); e resibu ta keda Hulandes.
• Konekshon pa kada printer:
  • Red (adrès IP): adrès IP i pòrt (mayoria biaha 9100). Asina e tabata funshoná semper, i asina e ta sigui funshoná: printernan eksistente ta riba red outomátikamente.
  • USB: riba Linux e aparato, por ehempel /dev/usb/lp0. Riba Android e printer USB pegá na e aparato (kabel OTG; bashí = e promé printer USB). Riba Windows i macOS bo ta skohe Printer di sistema.
  • Serial (COM / ttyUSB): un pòrt COM (Windows), /dev/ttyUSB0 òf /dev/ttyS0 (Linux, Android) òf /dev/cu.… (macOS), ku e velosidat (mayoria biaha 9600, 19200 òf 38400 baud). Tambe pa un printer Bluetooth ku Windows òf Linux ta konektá komo pòrt COM òf /dev/rfcomm0.
  • Bluetooth: den e app di HorecaPOS riba Android, ku e adrès Bluetooth di e printer parhá (p.e. un printer di resibu móbil). Konektá e printer promé den e konfigurashon di Bluetooth di Android.
  • Printer di sistema (Windows / CUPS): e printer manera Windows òf CUPS (Linux, macOS) ta konos'é, ku su mes driver òf komo Generic / Text Only. E bon ta bai krudo (RAW) pa e printer, sin formato di e driver.
  • Integrá (Sunmi, iMin ...): e printer den un kaha di Android mes.
  • Buska ta mustra e printernan i pòrtnan ku e kaha ta mira. Skohe un i e adrès ta yená.
• Protokòl: ESC/POS (kasi tur printer di resibu, tambe printernan Star den modo ESC/POS) òf Star (Star Line Mode). Ku Star e kaha mes ta kombertí e bon; e bon ta mira meskos.
• Pantalla di atendé ku su mes printer: un pantalla di atendé di Android ku e app di HorecaPOS (p.e. un terminal di man ku un printer móbil di Bluetooth, òf un Sunmi komo pantalla di atendé) por print su mes. Registr'é riba e aparato mes (Konfigurashon → Printernan → Pantalla di atendé ku nan mes printer) i skohe na e printer Konektá na. E pantalla di atendé ta buska su bonnan na e kaha; laga e app habrí einan. Si e no ta logra (app será, pafó di alkanse di wifi), un bon di kushina ta bai den e fila di print, meskos ku ora un printer di red ta apagá. Kita registro di e aparato ta pone e printernan bek riba e kaha mes.
• Printer pa grupo / produkto: pa kada grupo di artíkulo skohe riba kua printer e bon di kushina ta sali. Pa kada produkto bo por kambia esei ku su mes printer òf "sin bon di kushina".

Produkto igual ta wòrdu uní ora di imprimí: dos biaha 1x Cola ta bira 2x Cola, riba e bon di kushina i riba e risibu di kasa. Solamente produkto ku e mesun opshon i komentario ta bai huntu.

E instalador di Linux ta pone e usuario di e kaha den e gruponan lp i dialout, pa e kaha por usa printernan USB i serial.

Bo mester yudansa?

Optimum POS · 085 560 00 60 · support@optimumpos.nl · djaluna–djabièrnè 9:00–20:00, djasabra–djadumingu 14:00–20:00