Cenaly Hardware Bridge — ობიექტის აღჭურვილობა

ბრაუზერს თავისთავად არ შეუძლია ჩეკების ბეჭდვა POS-პრინტერზე, ფულის უჯრის გახსნა ან სასწორიდან წონის წაკითხვა. ამ ამოცანას წყვეტს Cenaly Hardware Bridge — მცირე უფასო აპლიკაცია, რომელიც ყენდება სალაროს კომპიუტერზე, მუშაობს ფონურ რეჟიმში და აკავშირებს ადმინ პანელის/სალაროს გვერდს ობიექტის ლოკალურ აღჭურვილობასთან.

გახსნა: ადმინ-პანელი → აღჭურვილობა (admin.cenaly.ge).

რა უკავშირდება#

ბეჭდვის რიგი#

ხიდის მეშვეობით ბეჭდვა არ არის „გაგზავნე და იმედი გქონდეს“. ხიდს აქვს საკუთარი დავალებების რიგი განმეორებებით, რომელიც გადატვირთვასაც უძლებს: თუ პრინტერი გამორთეს ან ქაღალდი გათავდა, დავალება არ დაიკარგება და დაიბეჭდება მაშინ, როდესაც მოწყობილობა ჩაირთვება.

ამის გამო ბეჭდვას აქვს ხუთი განსხვავებული შედეგი და არა უბრალოდ „გამოვიდა/არ გამოვიდა“: დაიბეჭდა, მიღებულია რიგში (ქაღალდი ჯერ არ არის!), დაიბეჭდა ბრაუზერით, ბეჭდავს ფისკალური სალარო (იხ. ქვემოთ) და არ დაიბეჭდა. სალაროს ზედა ზოლში ჩანს რიგის ინდიკატორი მომლოდინე დავალებების რაოდენობით.

დავალებები იდემპოტენტურია: ერთი და იმავე დოკუმენტის ხელმეორედ გაგზავნა მეორე ქვითარს არ დაბეჭდავს.

ფისკალური რეგისტრატორი არ არის სათადარიგო ჩეკის პრინტერი. თუ ობიექტზე არ არის ცალკე ჩეკის პრინტერი, ხიდი არ დაბეჭდავს ჩვენს ჩეკს ფისკალური სალაროს მეშვეობით: ფისკალურ ჩეკს ის თავად ბეჭდავს, ხოლო ჩვენი დოკუმენტი სხვა ქაღალდია. სალარო ასეთ სიტუაციაში პირდაპირ აჩვენებს: „ჩეკს თავად ფისკალური სალარო ბეჭდავს“. რეგისტრატორის მეშვეობით დაშვებულია მხოლოდ სატესტო ბეჭდვა და პრეჩეკი — და მათზე იბეჭდება აღნიშვნა, რომ ეს არ არის ფისკალური დოკუმენტი.

დეტალები, პრინტერების მიბმა სადგურებთან და კოდური გვერდები კირილიცისა და ქართულისთვის — ბეჭდვა სამზარეულოსა და დარბაზში.

ხიდის დაყენება#

თუ ამ კომპიუტერზე ხიდი ვერ მოიძებნა, გვერდი მის დაყენებას შემოგთავაზებთ:

1. ჩამოტვირთეთ თქვენი ოპერაციული სისტემის ვერსია — Windows, Linux (x64) ან Linux (ARM64) (macOS დაგეგმილია). შესამოწმებლად მითითებულია SHA-256.
2. გაუშვით პროგრამა. Windows — ორჯერ დაწკაპუნებით: ხიდი ფონურ რეჟიმში გადადის (ხატულა სისტემურ პანელში) და მდგომარეობის გვერდს ხსნის. Linux — უფრო საიმედოა მისი მაშინვე ფონურ სერვისად დაყენება „მოწყობილობების“ გვერდზე მოცემული ერთსტრიქონიანი ბრძანებით (curl … | sudo … bash): ის კომპიუტერის ჩატვირთვისას იწყებს მუშაობას და თავისით ხელახლა ირთვება. ჩამოტვირთული ფაილის ხელით გაშვებაც (chmod +x და გაშვება) მუშაობს, მაგრამ ხიდი მხოლოდ ტერმინალის გახსნამდე მუშაობს და გადატვირთვის შემდეგ აღარ ჩაირთვება; Linux-ზე მდგომარეობის გვერდი თავად გახსენით — http://127.0.0.1:9100.
3. მდგომარეობის გვერდზე დარწმუნდით, რომ ხიდი გაშვებულია. ადმინისტრაციული პანელი იმავე კომპიუტერზე გახსენით, აირჩიეთ საჭირო ობიექტი და განყოფილება „მოწყობილობები“: ბრაუზერი ავტომატურად უკავშირდება.
4. დაბრუნდით ადმინისტრაციულ პანელში და დააჭირეთ „ხელახლა ძიებას“ — სალარო ამ კომპიუტერზე ხიდს თავად იპოვის და დაუკავშირდება.

თუ Windows ჩამოტვირთვისას ან გაშვებისას გაფრთხილებას აჩვენებს, ეს მოსალოდნელია: აირჩიეთ „შენახვა“, გაშვებისას კი „დაწვრილებით“ → „მაინც გაშვება“. Linux-ისთვის არის ფონურ სერვისად დაყენების ერთსტრიქონიანი ბრძანება.

როგორ წაშალოთ ხიდი კომპიუტერიდან (Linux). „მოწყობილობების“ გვერდის იმავე ერთსტრიქონიანი ბრძანებით, ოღონდ ქვებრძანებით — გვერდზე ის მოთავსებულია პუნქტში „Linux — ხიდის შეჩერება ან წაშლა“:

• … | sudo bash -s -- stop — სერვისის შეჩერება და ავტომატური გაშვების გამორთვა; ფაილები და პარამეტრები რჩება, ხელახლა ჩასართავად — start;
• … | sudo bash -s -- uninstall — სერვისისა და თავად პროგრამის წაშლა. პარამეტრები და სალაროს მიბმა რჩება, სკრიპტი კი აჩვენებს, სად ინახება ისინი;
• … | sudo bash -s -- uninstall --purge — იგივე, დამატებით პარამეტრების წაშლით: მოწყობილობების სია და ობიექტთან მიბმა. ამის შემდეგ სალაროს ხელახლა მიბმა დაგჭირდებათ;
• … | sudo bash -s -- status — მუშაობს თუ არა ხიდი და რა მისამართზე (თუ 9100 დაკავებულია, ხიდი შემდეგ თავისუფალ პორტს ირჩევს, 9109-მდე).

Windows-ზე ამისთვის არის ჩვეულებრივი „პროგრამების დაყენება და წაშლა“ (ჩანაწერი „Cenaly Bridge“) — დეინსტალატორი ავტომატურ გაშვებასაც აუქმებს.

Ubuntu-ს პაკეტი. Ubuntu 22.04, 24.04 და 26.04-ზე ხიდი cenaly-bridge პაკეტითაც ყენდება — amd64-ისა და arm64-ისთვის განკუთვნილი .deb დაყენების გვერდიდან ან ბრძანებით curl -fsSL https://cdn.cenaly.com/linux/install.sh | sudo bash -s -- bridge (cenaly.ru-ის ანგარიშისთვის — cdn.cenaly.ru). პაკეტი Cenaly-ის რეპოზიტორიას ამატებს და ხიდი Ubuntu-ს ჩვეულებრივ განახლებებთან ერთად ახლდება; წასაშლელად — sudo apt remove cenaly-bridge. წინა, ერთსტრიქონიანი ბრძანებით დაყენებული ვერსია ავტომატურად აითვისება: პარამეტრები და მიბმა რჩება, სერვისი ერთია. დაწვრილებით — პროგრამების დაყენება Ubuntu-ზე.

ხიდის კომპიუტერზე, სადაც ადმინისტრაციულ პანელს არ ხსნიან (სერვერი დამხმარე ოთახში, ცალკე კომპიუტერი პრინტერებთან), ავტომატური ძიებით მიბმა შეუძლებელია — ავტომატური მიბმა მუშაობს მხოლოდ ერთსა და იმავე კომპიუტერზე არსებულ ხიდსა და სალაროს გვერდს შორის. ასეთ შემთხვევაში მფლობელი ადმინისტრაციულ პანელში ქმნის მიბმის ერთჯერად კოდს (მოქმედებს 15 წუთი) და შეჰყავს ხიდის მდგომარეობის გვერდზე.

ხიდი თქვენს ბრენდთანაა მიბმული: სხვა ბრენდის დომენიდან ჩამოტვირთული ხიდი თქვენს ადმინისტრაციულ პანელს ვერ მოემსახურება. თუ ხიდი უკვე იმავე მფლობელის სხვა ობიექტზეა მიბმული, გვერდი ამას აჩვენებს და ერთი ღილაკით აქ გადმობმას შემოგთავაზებთ.

მიერთების სამი გზა#

«მოწყობილობების» განყოფილებიდან თანამშრომლის შესვლის კოდი ცალკე მექანიზმია. თუ PIN-ს ან კოდს ვადა გაუვიდა, შესაბამისი ღილაკით ახალი შექმენით.

მართვა და შემოწმებები#

როცა ხიდი მიერთებულია, გვერდზე ჩანს:

• მოწყობილობები — თითოეულის მდგომარეობის სია (მიერთებული / ყურადღება / შეცდომა / ვერ მოიძებნა);
• აღჭურვილობის შემოწმება — ბეჭდვის, სკანირებისა და წონის სწრაფი ტესტი;
• აღჭურვილობის პარამეტრები;
• აქტივობა — მოვლენების ლენტი (სკანი, წონა, ბეჭდვა) რეალურ დროში;
• განახლება — თუ ხიდის ახალი ვერსია გამოვიდა, აქედანვე შეგიძლიათ დაყენება.

პრინტერის დამატებისას აირჩიეთ დანიშნულება: ჩეკის, სამზარეულოს ან ეტიკეტების. როლი მოწყობილობის ბარათში ჩანს. ის ხიდის შიგნით დანიშნულებას ადგენს; ცალკე სამუშაო ადგილებს შორის აღჭურვილობის განაწილება სხვა დონის დაყენებაა. თუ პარამეტრების წაკითხვა ვერ მოხერხდა, ოსტატი გამეორებას შემოგთავაზებთ და არსებულ სიას შეინახავს.

ნაპოვნი აღჭურვილობა შეგიძლიათ გამორთოთ ან წაშალოთ. „გამორთვა“ მოწყობილობას ყველა პარამეტრით სიაში ტოვებს, მაგრამ დრაივერი არ გაეშვება: COM-პორტი თავისუფალია, გამოკითხვა არ მიმდინარეობს, როლი სხვა მოწყობილობას გადაეცემა — ერთი ღილაკით ისევ ჩაირთვება. „წაშლა“ (დადასტურებით) მოწყობილობას სამუდამოდ აქრობს და ხიდის შემდეგ გაშვებაზე ნაცნობი აღჭურვილობის ავტომატური აღება მას აღარ დააბრუნებს. ადრე დაყენებული, ახლა კი ძებნით ვერნაპოვნი აღჭურვილობა ცალკე ჯგუფად ჩანს — სხვაგვარად მისი მართვა შეუძლებელი იქნებოდა.

ანგარიშზე შეიძლება რამდენიმე ხიდი იყოს და თითოეულს როლი დაენიშნოს: უნივერსალური, აღჭურვილობა, კამერები ან ტელეფონია. წერტილის ხიდები ცალკე სიაშია — შეგიძლიათ გადაარქვათ და ნაგულისხმევი ხიდი დანიშნოთ.

მთელი ანგარიშის აღჭურვილობა და მუშაობა ღრუბლიდან#

„ამ კომპიუტერის“ ხიდის გარდა, გვერდზე წარმოდგენილია ანგარიშის აღჭურვილობის რეესტრი — ქსელის ყველა ობიექტის ხიდების, მოწყობილობებისა და კამერების გამჭოლი ცხრილი: ჩანს, რა სად დგას, ონლაინ რეჟიმშია თუ არა ხიდი და რომელ ობიექტებს ემსახურება მისი აღჭურვილობა. მოწყობილობის გადატანა შესაძლებელია სხვა ლოკაციაზე, თუ ხიდი ამ მომენტში ონლაინია; ოფლაინ ხიდის შემთხვევაში რეესტრი მხოლოდ აჩვენებს მონაცემებს, მაგრამ ცვლილებებს არ ახორციელებს.

რეესტრში თითოეული კომპიუტერისთვის იხსნება ბარათი „PC-ის დეტალები“: კომპიუტერის სახელი, IP და MAC, სისტემა, მოდელი, პროცესორი, მეხსიერება სლოტების მიხედვით, მყარი დისკები თავისუფალი ადგილითა და მდგომარეობით, ყველა მიერთებული აღჭურვილობა და ყველა COM-პორტი — მონიშვნით, რომელი პორტი ვის მიერ არის დაკავებული და რომელია თავისუფალი. ეს პირველი ადგილია, სადაც უნდა ჩაიხედოთ, როდესაც „პრინტერი იყო და ახლა აღარ ჩანს“ ან POS-ის კომპიუტერზე თავისუფალი ადგილი იწურება. მონაცემებს თავად ხიდი აგროვებს; ხიდის ძველი ვერსიის შემთხვევაში აღჭურვილობის სია შეიძლება ცარიელი იყოს — ასეთ დროს საკმარისია ხიდის განახლება.

ლოკალური არხის (ბრაუზერი ↔ ხიდი ამ კომპიუტერზე) გარდა, არსებობს ღრუბლოვანი არხიც: ბრძანება ხიდს სერვერის გავლით ეგზავნება, ამიტომ ქვითრის ამობეჭდვა ან პრინტერის შემოწმება შესაძლებელია სხვა მოწყობილობიდანაც — მაგალითად, ოფიციანტი საკუთარი ტელეფონიდან ბეჭდავს დახლთან მდგარ POS-ის პრინტერზე. გვერდზე ეს ჩანს როგორც „ღრუბლოვანი მიბმა“ ხიდთან და ღრუბლოვანი სატესტო ბეჭდვის ცალკე ღილაკი.

მეზობელი კომპიუტერის პრინტერზე ბეჭდვა. თუ პრინტერი ფიზიკურად სხვა კომპიუტერთან არის შეერთებული, სულაც არ არის აუცილებელი მისი ქსელში გაზიარება ან კაბელის გაყვანა. რეესტრში მოქმედება „სხვა PC-იდან ბეჭდვა“ ამ კომპიუტერზე ქმნის ბმულს სხვის პრინტერზე: ირჩევა მფლობელი კომპიუტერი, ობიექტი და სახელი, შემდეგ კი სტრიქონი მონიშნულია როგორც „ღრუბლის გავლით → მფლობელი PC“, ხოლო დავალებები იბეჭდება იმ კომპიუტერის რიგით. საერთო საქაღალდე, VPN და მოწყობილობების პირდაპირი ხილვადობა საჭირო არ არის — საკმარისია, რომ ორივე ხიდი ერთ ობიექტს ემსახურებოდეს.

POS-ის დისტანციური ეკრანი. იმავე გვერდიდან (და სამუშაო ჩათის მოწვევით) შესაძლებელია POS-ის კომპიუტერის ეკრანის ნახვა — მაგალითად, რათა საკუთარი თვალით ნახოთ, რას აჩვენებს POS. გადაწყვეტილებას ყოველთვის ის მხარე იღებს: სანამ მისი მფლობელი თავისთან არ ჩართავს დისტანციურ წვდომას, დაკავშირების ღილაკი არ არის, ხოლო თითოეული სეანსი მის ცალკე თანხმობას მოითხოვს — პარამეტრი „აღარ მკითხო“ განზრახ არ არსებობს. დათვალიერება და მართვა ორი განსხვავებული ნებართვაა, ხოლო ფანჯრის დახურვა გარანტირებულად ასრულებს სეანსს.

ყურადღება სჭირდება და განახლების დროა: ქსელის ყველა მოწყობილობა#

აღჭურვილობის რეესტრის ზემოთ არის ბლოკი „⚠️ ყურადღება სჭირდება“ — ანგარიშის ყველა ობიექტის მოწყობილობების პრობლემები ერთ სიაში, რათა ობიექტების სათითაოდ შემოვლა არ დაგჭირდეთ. სტრიქონში მითითებულია ობიექტი, მოწყობილობა (და რომელი ხიდით ჩანს), რა მოხდა და როდიდან. ზემოთ შეცდომებია, ქვემოთ — გაფრთხილებები; ყველაზე დიდხანს გაუმართავი მოწყობილობა უფრო მაღლაა.

სიაში ხვდება:

• ხიდი კავშირის გარეშე — მასთან ერთად მიუწვდომელია მისი პრინტერები, სალარო და სასწორი (სტრიქონში წერია, რამდენი მოწყობილობაა მასზე მიერთებული);
• პრინტერი, სალარო, სასწორი შეცდომით, სტატუსით „არ არის დაკავშირებული“ ან გაფრთხილებით — მიზეზის ტექსტით, როგორც მას სალაროსთან მყოფი ადამიანი ხედავს („ჩეკის ლენტი არ არის“, „პრინტერი არ პასუხობს“);
• კამერა, რომელსაც კავშირი არ აქვს, და კომპიუტერზე მიერთებული მოწყობილობა მოქმედი დრაივერის გარეშე;
• სალარო ან სამზარეულოს ეკრანი, რომელიც დიდი ხანია ღრუბელს არ დაკავშირებია, ასევე სალარო ჩანაწერებით, რომელთა შედეგი უცნობია;
• სარეკლამო ეკრანი, რომელმაც კავშირი შეწყვიტა ან ჩვენების შეცდომას იტყობინება.

უკავშირობის ზღვარი. მოწყობილობა, რომელმაც კავშირი ცოტა ხნის წინ შეწყვიტა (კომპიუტერი გადატვირთეს, ღამეა), პრობლემად არ ითვლება: ველში „კავშირი არ აქვს ამაზე მეტხანს“ აირჩიეთ 15 წუთი, 2 საათი (ნაგულისხმევი), 12 ან 24 საათი — არჩევანი ამ ბრაუზერში ინახება. ხიდის მიმდინარე შეტყობინებებზე („შეცდომა“, „არ არის დაკავშირებული“) ზღვარი არ მოქმედებს. ღილაკით „გამორთვა“ სამუშაოდან მოხსნილი მოწყობილობა და სალარო, რომელიც ჯერ არც ერთხელ დაკავშირებულა, სიაში არ ხვდება. ფილტრები „შეცდომები“ / „გაფრთხილებები“ და ობიექტის არჩევა სიას ავიწროებს.

ჩანართი „განახლების დროა“ თითოეული ხიდის ვერსიას ბოლო გამოქვეყნებულ ვერსიასთან ერთად აჩვენებს: „აქტუალურია“, „განახლების დროა“ ან „უცნობია“. ხიდები კავშირის არსებობისას თვითონ ახლდება — ჩამორჩენილი ხიდი, როგორც წესი, განახლების გამოსვლისას გამორთული იყო, ან ამ კომპიუტერზე ავტომატური განახლება გამორთულია; ასეთ შემთხვევაში იმ კომპიუტერზე გახსენით ხიდის გვერდი და დააჭირეთ „განახლება“ ან ხელახლა დააყენეთ ხიდი. 0.31.0-ზე ძველი ხიდი ღრუბელს თავის ვერსიას არ ატყობინებს — ის მონიშნულია როგორც „ძველი ხიდი — ვერსიას არ აგზავნის“. იქვე ჩანს სარეკლამო ეკრანები, რომელთა დამკვრელი ახალ ვერსიაზე ვერ გადადის.

იმავე ჩანართშია ინტერნეტის გარეშე მუშაობისთვის მომზადებული სალაროები და სამზარეულოს ეკრანები. Android-ის, Windows-ისა და Linux-ის აპი ღრუბელს თავის ვერსიას დაკავშირებისას ატყობინებს (სალაროში შესვლისას, სამზარეულოს ეკრანის დოკუმენტების განახლებისას), შეჯამება კი მას ამ პლატფორმის ბოლო გამოშვებას ადარებს. სტრიქონში ჩანს პლატფორმა, დაყენებული ვერსია და — თუ განახლების დროა — უახლესი ვერსიის ნომერი. როგორ განაახლოთ:

• Android — საიტიდან დაყენებული აპი თვითონ ახლდება; Google Play-დან დაყენებული — Play-ს მეშვეობით;
• Windows და Linux — ჩამოტვირთვების გვერდიდან ჩამოტვირთეთ ახალი ვერსია და ძველზე გადააყენეთ (სალაროს პარამეტრები და მონაცემები შენარჩუნდება).

ვებსალარო და სამზარეულოს ვებეკრანი მონიშნულია როგორც „ახლდება გვერდის ჩატვირთვისას“ — მათთვის არაფრის გაკეთებაა საჭირო. „აპის ძველი ვერსია — ვერსიას არ აგზავნის“ ნიშნავს, რომ მოწყობილობაზე აპის ისეთი ძველი ვერსიაა, რომელსაც საკუთარი ვერსიის შეტყობინება არ შეუძლია — განაახლეთ და სტრიქონში ნომერი გამოჩნდება. სალარო, რომელიც მომზადების შემდეგ არც ერთხელ დაკავშირებულა, მონიშნულია როგორც „არც ერთხელ დაკავშირებულა“.

ბლოკი ახალ შემოწმებებს არ ქმნის — ის აგროვებს იმას, რასაც ხიდები, სალაროები და ეკრანები უკვე აგზავნის. თუ რომელიმე ობიექტმა არ უპასუხა, სიის ზემოთ გამოჩნდება „ობიექტების ნაწილმა არ უპასუხა — სია შეიძლება არასრული იყოს“.

დაკავშირებული განყოფილებები#

• სალარო (POS) — სად გამოიყენება ქვითრების ბეჭდვა და ფულის უჯრა
• ქვითრები და დაბრუნება — ქვითრების ბეჭდვა და ხელახალი ბეჭდვა
• ფისკალიზაცია — ფისკალური პრინტერები და ონლაინსალაროები
• ბეჭდვა სამზარეულოსა და დარბაზში — სადგურები, სტიკერები, რიგი და კოდური გვერდები
• ასაწონი საქონელი და ეტიკეტები — სასწორებთან მუშაობა, საზომი ერთეულები და თაროს ეტიკეტები
• მოწყობილობები: რისი დაკავშირება შეიძლება — მოწყობილობების კლასების მიმოხილვა და მინიმალური კომპლექტები ფორმატების მიხედვით
• ტელეფონია: საკუთარი სატელეფონო სადგური — ტელეფონებსა და შლიუზებს მოწყობილობების ხიდი არ სჭირდება, ისინი ცალკე სისტემაში მუშაობს
• დანაკარგების კონტროლი — სარისკო ოპერაციების ვიდეოკლიპები ხიდის კამერიდან

ხშირად დასმული კითხვები#

საჭიროა თუ არა კოდის შეყვანა დაკავშირებისთვის?#

ჩვეულებრივ, არა: ხიდი ეშვება იმავე კომპიუტერზე, სადაც იხსნება POS, და ის თავად პოულობს მას ღილაკით «თავიდან ძებნა». კოდი საჭიროა მხოლოდ იმ კომპიუტერზე არსებული ხიდისთვის, სადაც ადმინპანელს არ ხსნიან, — ამ შემთხვევაში მფლობელი გასცემს ერთჯერად კოდს და შეჰყავს იგი ხიდის გვერდზე.

რომელ ოპერაციულ სისტემებზე მუშაობს ხიდი?#

Windows და Linux (x64 და ARM64). macOS-ის ვერსია დაგეგმილია.

აპარატურა არ ჩანს — რა შევამოწმოთ?#

დარწმუნდით, რომ ხიდი გაშვებულია (სტატუსის გვერდი), და დააჭირეთ «თავიდან ძებნა»-ს. თითოეული მოწყობილობის სტატუსი და სწრაფი შემოწმება ხელმისაწვდომია გვერდზე «აპარატურა». თუ მოწყობილობა არ გამოჩნდა, აპარატურის რეესტრში გახსენით ამ მანქანის ბარათი «PC-ის დეტალები»: იქ ჩანს მთელი აპარატურა, რომელსაც თავად კომპიუტერი ხედავს, და ყველა COM-პორტი მითითებით, თუ რით არის დაკავებული პორტი, — ეს, როგორც წესი, საკმარისია იმის გასაგებად, პრობლემა კაბელშია, პორტში თუ უცხო პროგრამაში, რომელსაც პორტი უკავია.