Nowość w Macopedii: Maco POS Agent, czyli drukarka fiskalna w kasie Odoo

Wprowadzamy nowy produkt: Maco POS Agent. Łączy kasę działającą w przeglądarce z drukarką fiskalną podłączoną do komputera sklepu. Dziś obsługuje kasę Odoo 18, 19 i 20 (Point of Sale), w wersji Community i Enterprise, oraz drukarki Posnet Online. Integracje z Magento 2, Shopware, WooCommerce i Shopify udostępnimy wkrótce.

Aktualizacja z 19 października 2026: agent obsługuje też drukarki etykiet (Zebra GK420d, Bixolon XD5-40d) i terminale płatnicze. Piszemy o tym w sekcjach Drukarki etykiet i Płatność kartą.

Szczegóły, cennik i lista drukarek są na stronie produktu Maco POS Agent. Tutaj opowiadamy, skąd się wziął i jak wygląda w pracy.

Jaki problem rozwiązuje Maco POS Agent?

Przeglądarka nie potrafi sama rozmawiać z drukarką podłączoną przez USB. Sklep, który sprzedaje w kasie Odoo, a musi drukować paragony fiskalne, miał do tej pory trzy wyjścia: drogi dodatek do kasy, osobny program kasowy albo kasę związaną z jednym dostawcą sprzętu.

Maco POS Agent zamyka tę lukę. Agent działa na tym samym komputerze co kasa. Kasa wysyła do niego paragon, a agent drukuje go protokołem producenta drukarki i odsyła numer paragonu do Odoo.

Jak to wygląda przy kasie?

Kasjer pracuje w zwykłej kasie Odoo. Jedyna zmiana to kontrolka stanu drukarki w górnym pasku.

Paragon drukuje się w chwili zatwierdzenia płatności. Gdy drukarka nie może drukować, na przykład skończył się papier, kontrolka zmienia kolor jeszcze przed płatnością. Próba zatwierdzenia kończy się komunikatem po polsku, a zamówienie zostaje otwarte. Po wymianie papieru kasjer klika „Zatwierdź” jeszcze raz.

W zamówieniu na zapleczu Odoo zapisują się dane paragonu: stan, numer paragonu, numer dokumentu, numer unikatowy drukarki i czas wydruku.

Dlaczego paragon nie wydrukuje się dwa razy?

To była dla nas najważniejsza część projektu. Podwójny paragon to dla sklepu korekta i tłumaczenie się przed klientem, a brak paragonu przy zamkniętej sprzedaży to problem z fiskusem.

Każde zlecenie ma identyfikator zamówienia i trafia do dziennika agenta, zanim cokolwiek pójdzie do drukarki. Dzięki temu:

• powtórne kliknięcie „Zatwierdź” albo ponowna wysyłka po zerwanym połączeniu nie drukuje drugiego paragonu,
• po zerwanej łączności w trakcie wydruku agent pyta drukarkę o wynik i sprawdza licznik paragonów, zamiast ponawiać wydruk w ciemno,
• błąd w połowie paragonu anuluje transakcję i nic nie zostaje na drukarce,
• po awarii komputera agent sam rozstrzyga przerwane zlecenia,
• suma paragonu jest równa sumie zamówienia co do grosza, bo rabaty są wliczone w cenę pozycji.

Kasa działa też bez internetu. Kasa Odoo pracuje offline, a agent i drukarka są na tym samym komputerze. Zamówienia z numerami paragonów trafiają do Odoo po powrocie połączenia.

Aplikacja agenta

Agenta instalujesz sam: program jest przygotowany do samodzielnej instalacji, bez programisty i bez wizyty serwisanta. Działa jako usługa Windows, a całą konfigurację daje aplikacja z ikoną w zasobniku systemowym. Nie trzeba edytować żadnych plików. Pulpit pokazuje stan stanowiska, drukarki, nasłuchu zleceń i monitoringu.

W aplikacji wybiera się model drukarki i sposób połączenia (USB, RS-232, LAN, Wi-Fi albo Bluetooth). Przycisk „Testuj połączenie” rozpoznaje model, wersję oprogramowania i numer unikatowy drukarki. Stąd też robi się wydruk testowy, wpłatę i wypłatę z kasy oraz raport dobowy.

Drukarki etykiet

Ten sam agent obsługuje drukarki etykiet, i to kilka na jednym stanowisku: na przykład osobną na cenówki przy ladzie i osobną na magazynie. Pierwsze obsługiwane modele to Zebra GK420d i Bixolon XD5-40d. Podłączysz je przez USB, sieć LAN albo port szeregowy.

Etykietę przygotowuje Odoo, na tych samych szablonach, których sklep już używa. Agent przekazuje ją na właściwą drukarkę. Z zaplecza Odoo drukujesz w ten sposób etykiety produktów i cenówki, a także etykiety magazynowe: partie, numery seryjne, paczki i lokalizacje. W kasie kasjer zaznacza produkt i drukuje jego etykietę jednym przyciskiem.

Drukarkę dodaje się w aplikacji agenta: nazwa, krótki kod, model i sposób połączenia. Odoo dowiaduje się o niej sam i od razu przypisuje do niej etykiety produktów. Agent wgrywa też do drukarki czcionkę z polskimi literami. Wbudowana czcionka drukarek Zebra gubi ą, ę, ś, ł i ż w wyśrodkowanych nazwach, więc „Masło” wychodziło jako „Maso”.

Każda drukarka ma własną kolejkę. Brak etykiet albo otwarta głowica nie wstrzymuje paragonów i odwrotnie. Paragony fiskalne można też wyłączyć w ustawieniach Odoo: agent obsługuje wtedy same drukarki etykiet, na przykład na magazynie.

Płatność kartą

Agent łączy kasę Odoo także z terminalem płatniczym na stanowisku. Kasjer wybiera płatność kartą, a kwota z zamówienia trafia na terminal. Wynik płatności, kod autoryzacji i końcówka karty wracają do zamówienia w Odoo. Zwrot w kasie trafia na terminal jako zwrot na kartę klienta.

Działa tu ta sama zasada co przy paragonach. Płatność o danym identyfikatorze trafia na terminal co najwyżej raz. Gdy połączenie zerwie się w trakcie płatności, agent nie wysyła jej drugi raz, tylko pyta terminal o wynik. Odświeżenie strony kasy też nie gubi płatności.

Sposób komunikacji z terminalem zależy od operatora płatności, a nie od producenta urządzenia. Dlatego przy zamówieniu pytamy, z którym operatorem pracuje sklep.

Centrala widzi wszystkie kasy

Co kilkadziesiąt sekund agent wysyła do Odoo sygnał ze stanem drukarki i listą wydrukowanych paragonów. Centrala widzi w Odoo wszystkie stanowiska: ostatni sygnał, stan drukarki, numer unikatowy i wersję agenta. Stanowisko, które przestało się zgłaszać, jest oznaczone jako niedostępne.

Odoo porównuje też wydrukowane paragony z zamówieniami. Paragon bez zamówienia albo z inną kwotą trafia do wyjaśnienia.

Z czym działa i ile kosztuje?

Pierwsza rodzina drukarek to Posnet Online. Na urządzeniach sprawdziliśmy stacjonarną Thermal XL2 Online i mobilną Temo Online, którą podłączysz przez USB, Wi-Fi albo Bluetooth. Obsługujemy też przenośną Trio Online. Thermal HD Online jest w przygotowaniu, a kolejnych producentów dodajemy, gdy potrzebują ich nasi klienci.

Agent działa z Odoo 18, 19 i 20 w obu wersjach, Community i Enterprise, z aplikacją Point of Sale. Drukarki etykiet i terminale płatnicze wymagają Odoo 20. Potrzebny jest komputer z Windows 10 lub 11 i przeglądarka Chrome lub Edge. Dodatkowy sprzęt, taki jak IoT Box, nie jest potrzebny.

Na życzenie przygotujemy agenta dla Odoo starszego niż 18, a dla kas na Linuksie i macOS możemy przygotować osobną wersję agenta.

Maco POS Agent sprzedajemy na licencji dożywotniej, bez abonamentu: 1 999 zł netto za pierwsze stanowisko i 999 zł netto za każde kolejne. W cenie jest bieżąca wersja agenta i modułu Odoo oraz 30 dni wsparcia zdalnego przy uruchomieniu. Drukarki etykiet i terminal płatniczy na stanowisku obsłużysz bez dopłaty do licencji.

Co dalej?

Ten sam agent i ta sama drukarka obsłużą kolejne systemy. Agent ma otwarte, wersjonowane API, więc integracje z Magento 2, Shopware, WooCommerce i Shopify to kolejne moduły, a nie nowy produkt. Zgodność z tymi systemami podamy razem z ich dostępnością.

Sprzedajesz w Odoo i potrzebujesz drukarki fiskalnej w kasie? Albo planujesz sprzedaż stacjonarną obok sklepu internetowego? Napisz do nas: pokażemy agenta na żywo i dobierzemy licencje do Twoich sklepów. Jeśli dopiero wybierasz system, zobacz, jak prowadzimy wdrożenia Odoo.