Integracje — POS, dostawa, komunikatory, API
Przegląd#
Cenaly integruje się z popularnymi systemami automatyzacji, platformami płatniczymi, usługami dostawy i komunikatorami. Pozwala to wbudować cyfrowe menu w istniejącą infrastrukturę lokalu.
Systemy księgowe i handlowe#
Obsługiwane systemy#
| System | Region | Typ integracji |
|---|---|---|
| Эвотор (smart-terminale) | 🇷🇺 Rosja | API, dwukierunkowa: katalog, stany magazynowe, zamówienia, zmiany kasowe, pracownicy |
| 1C:Accounting | 🇷🇺🇧🇾🇰🇿🇬🇪 WNP i Gruzja | OData: import nomenklatury i kontrahentów z 1C |
| WooCommerce (WordPress) | 🌍 Globalnie | API, dwukierunkowa: katalog, zamówienia, stany magazynowe |
| Saby Docs (SBIS EDO) | 🇷🇺 Rosja | EDO: dokumenty w obie strony, kontrahenci dociągani po danych z faktur przychodzących |
W Sklepie z aplikacjami są karty także tych systemów, dla których wymiana jest na razie tylko planowana — z oznaczeniem „Wkrótce”. Dla rynku rosyjskiego to ewidencja towarowa i kasy (MoySklad, iiko, r_keeper, StoreHouse 5, Quick Resto, Frontpad, Kontur.Market), Saby (SBIS) — karty Presto dla gastronomii i Retail dla sklepu — CRM (Bitrix24, amoCRM, RetailCRM, YCLIENTS), EDO (Diadok, Taxcom, „Moje delo”), platformy (Megamarket, Avito), marketing (Yandex Business, VK Reklama, Mindbox), lojalność (UDS), wyciągi bankowe (T-Bank, Tochka, Modulbank, Alfa-Bank, SberBusiness) i hh.ru. Do katalogu trafia tylko to, co ma publicznie opisane API — karta oznacza „zrobimy”, a nie „może będzie”.
Co jest synchronizowane#
- Katalog → przedmioty, ceny, kategorie; kierunek ustalasz sam (kto jest „główny” — Cenaly czy system zewnętrzny)
- Zamówienia → sprzedaż działa w obie strony: paragon Эвотор staje się zamówieniem w Cenaly, zamówienie Cenaly trafia na kasę
- Magazyn → stany magazynowe aktualizują się przy sprzedaży i przyjęciu, konflikt „dwóch gospodarzy” rozwiązuje ustawienie „master stanów magazynowych”
- Słowniki → kontrahenci, dostawcy, pracownicy
Konfiguracja (na przykładzie Эвотор)#
- W panelu Cenaly → Sklep z aplikacjami → zakładka „Po lokalizacjach” → karta Эвотор
- Skopiuj pokazany kod powiązania
- Zainstaluj aplikację cenaly w Эвотор.Market i wpisz ten kod w formularzu powiązania
- Wróć do panelu, podaj UUID sklepu (Panel Эвотор → Sklepy) i kliknij „Powiąż sklep”
- Skonfiguruj synchronizację: master stanów magazynowych, przyjmowanie zamówień cenaly na terminal, domyślna stawka VAT
- Wyślij katalog
Platformy dostawy#
Agregatory z gotową integracją#
Zamówienia przychodzą do wspólnego strumienia Cenaly, menu i stop-lista trafiają na platformę automatycznie:
| Platforma | Regiony | Co potrafi |
|---|---|---|
| Wolt | 🇫🇮🇩🇰🇬🇪 Europa, Kaukaz | Zamówienia, menu, stop-lista, pauza placówki, „inteligentny czas gotowania” według obciążenia kuchni |
| Glovo | 🇪🇸🇮🇹🇵🇱🇷🇴🇬🇪 Europa, Kaukaz, Afryka | Zamówienia, menu, stop-lista, pauza placówki, marki wirtualne |
| Deliveroo | 🇬🇧🇫🇷🇦🇪 Europa, Bliski Wschód | Zamówienia, menu, stop-lista |
| Яндекс Еда | 🇷🇺🇧🇾🇰🇿🇦🇲 WNP | Zamówienia, menu, stop-lista, pauza placówki |
Szczegółowe instrukcje: Wolt · Glovo · Яндекс Еда.
Inne platformy (Uber Eats, Bolt Food, Just Eat, foodpanda, talabat, Yemeksepeti, Trendyol GO, iFood, Rappi i jeszcze kilkadziesiąt) są w katalogu kanałów dostawy wewnątrz panelu — z warunkami podłączenia i kontaktami platformy, ale na razie bez gotowego konektora. Link do profilu lokalu na dowolnej z nich można dodać do karty lokalizacji, żeby pokazywał się gościom.
Oprócz katalogu usługi dostawy twojego kraju widać bezpośrednio w Sklepie z aplikacjami, w kategorii „Dostawa”: każda usługa ma swoją kartę, a na niej uczciwie pokazano stan gotowości — od „podłączamy dziś” do „znamy tylko z dokumentacji”. Z karty bez gotowego konektora można złożyć zgłoszenie: na ich podstawie decydujemy, który adapter piszemy następny.
Marketyplace towarowe#
W tej samej kategorii są karty marketyplaców towarowych — światowy katalog platform, na które sklep wysyła towary i z których odbiera zamówienia. Dobór też jest krajowy: widzisz nie całą listę, a te platformy, które przyjmują sprzedawcę z twojego kraju. Adaptery Ozon, Wildberries i Kaspi są napisane i podłączają się w trybie pilotażowym (karta tak mówi), u pozostałych karta działa jako zgłoszenie „Wkrótce”.
Zalety własnej dostawy#
Przez Cenaly można przyjmować zamówienia na dostawę bezpośrednio, z pominięciem agregatorów:
- 0% prowizji (agregatory biorą 15–30%)
- Pełna kontrola nad bazą klientów
- Możliwość dania klientowi rabatu i tak zarobienia więcej
Komunikatory#
Telegram#
- Mini App — pełne menu w Telegramie, otwierane przyciskiem „Menu” w czacie Twojego bota
- Kreator połączenia — Cenaly sam konfiguruje bota przez Telegram API: nazwę, opis, przycisk „Menu” i webhook; ręcznie pozostaje tylko utworzenie bota w @BotFather
- Bot wizyt i przypomnień — gość zapisuje się na przypomnienie o wizycie i potwierdza lub odwołuje ją przyciskiem bezpośrednio w czacie; właściciel otrzymuje powiadomienia o nowych wizytach w swoim Telegramie
Więcej: Telegram Mini App — przewodnik
WhatsApp#
- Przycisk zamówienia — gość kompletuje koszyk w menu QR i wysyła zamówienie jako gotową wiadomość w WhatsAppie (link wa.me, bez serwera i Business API)
- Duplikat w panelu administracyjnym — zamówienie jest równolegle rejestrowane w sekcji „Zamówienia” z kanałem WhatsApp
Więcej: Integracja z WhatsApp — przewodnik
Sprzęt#
Sprzęt jest podłączany przez Cenaly Hardware Bridge — niewielki program dla Windows lub Linux, który działa na komputerze kasy. Panel sam go znajduje i potrafi wysyłać polecenia nawet z innego urządzenia.
Drukarki paragonów#
Obsługiwana jest każda drukarka ESC/POS — to wspólny język drukarek paragonowych, którym posługują się Epson TM, Star Micronics, Xprinter, Rongta i dziesiątki innych.
| Połączenie | Jak to wygląda |
|---|---|
| Sieć (Ethernet / Wi-Fi) | Drukarka po adresie IP, port 9100 |
| USB | Przez drukarkę systemową (spooler) Windows lub Linux |
| COM / serial | Bezpośrednie połączenie przez port szeregowy |
Bridge sam otwiera szufladę na pieniądze, drukuje paragon testowy i potrafi drukować znaki spoza alfabetu łacińskiego jako obraz — tam, gdzie drukarka nie ma odpowiedniej strony kodowej (na przykład dla gruzińskiego).
Kasy fiskalne#
ATOL, Shtrih-M, Daisy, „Mercury”, „Pirit” — fiskalizacja paragonu, raporty X i Z, edytor cliché, stawki podatkowe. Więcej: Kasa i fiskalizacja.
Kitchen Display System (KDS)#
- Dowolny tablet lub Smart TV
- Działa przez przeglądarkę internetową
- Nie wymaga instalacji aplikacji
Inny sprzęt#
Skanery kodów kreskowych, wagi (żywa waga ze wskaźnikiem stabilności), wyświetlacze dla klientów, szuflady na pieniądze, kamery monitoringu.
Terminale płatnicze#
| Terminal | Region |
|---|---|
| SumUp | 🇪🇺 Europa |
| Square Terminal | 🇺🇸🇬🇧 USA, UK |
| Stripe Terminal | 🌍 Globalnie |
| Adyen | 🌍 Globalnie |
| Ingenico / Wincor (OPI) | 🇪🇺 Europa, połączenie lokalne |
| Terminal zgodny z Nexo | 🌍 Połączenie lokalne |
Jest też tryb „terminal zewnętrzny” — gdy płatność odbywa się na osobnym urządzeniu banku, a kasjer po prostu potwierdza wynik.
API i Webhooks#
Guest API — dla agentów AI i zewnętrznych serwisów#
Publiczne REST API (OpenAPI 3.1) bez autoryzacji: odczyt menu, złożenie zamówienia, sprawdzenie wolnych stolików i rezerwacja. Dokładnie te same operacje, które są dostępne dla gościa na stronie menu.
- Więcej: Guest API dla agentów AI
MCP Protocol#
Dla asystentów AI (Claude, ChatGPT, Cursor) dostępne są dwa serwery MCP. Gościnny — menu, zamówienia i rezerwacje w imieniu gościa, bez klucza (Guest API). MCP własnej centrali telefonicznej — dziennik połączeń, nagrywanie, dzwonienie jednym kliknięciem, przekierowanie i reguły połączeń po kluczu z „Telefonia → API i MCP” lub przez OAuth.
- Więcej: Telefonia → API i MCP
Webhooks#
Ustawienia → Zamówienia → Scenariusze (Flow): reguła „gdy wystąpiło zdarzenie i spełnione są warunki — wykonaj akcję”. Jedną z akcji jest wysłanie webhooka na Twój URL z treścią zamówienia.
Zdarzenia:
- Nowe zamówienie
- Płatność za zamówienie
- Zmiana statusu zamówienia
- Anulowanie zamówienia
Księgowość i rozliczenia#
| System | Format | Opis |
|---|---|---|
| 1C:Accounting | OData | Import asortymentu i kontrahentów z Twojej bazy informacyjnej |
| Evotor | API | Dokumenty kasy (sprzedaż, przyjęcie, spisanie, inwentaryzacja) stają się dokumentami magazynowymi Cenaly |
| Eksport danych | Archiwum ZIP, CSV | Ustawienia → Eksport danych: archiwum ustawień, katalogu, zamówień i opinii za wybrany okres; plus natychmiastowe wyeksportowanie katalogu do CSV |
Integracje marketingowe#
Liczniki i piksele (ustawiane dla każdej placówki)#
| Serwis | Przeznaczenie |
|---|---|
| Google Analytics 4 i Google Tag Manager | Śledzenie wyświetleń menu i zamówień |
| Yandex Metrica | Analityka internetowa |
| Meta Pixel | Retargeting na podstawie wyświetleń |
| VK, TikTok, Pinterest, Snapchat, X, LinkedIn | Piksele platform reklamowych |
| Matomo, Microsoft Clarity | Własna analityka i mapy kliknięć |
Wszystkie liczniki są podłączane tylko po wyrażeniu zgody przez gościa na cookies: analityczne — w kategorii „statystyka”, reklamowe — w kategorii „marketing”.
Linki do zewnętrznych platform#
Google Maps, Yandex Maps, TripAdvisor, Yelp, Foursquare, 2GIS, Instagram, Facebook i inne — adres profilu lokalu jest dodawany do karty placówki i pokazywany gościom.
8. Zarządzanie strefami dostawy#
Konfiguracja#
- Sekcja „Kurierzy” → blok „Strefy dostawy”
- Narysuj strefę na mapie (wielokąt)
- Dla każdej strefy ustaw:
| Parametr | Przykład |
|---|---|
| Nazwa | Centrum / Bliskie dzielnice / Przedmieścia |
| Koszt dostawy | Strefa 1: bezpłatnie, Strefa 2: 5₾, Strefa 3: 10₾ |
| Minimalna kwota zamówienia | 20₾ / 30₾ / 50₾ |
| Czas dostawy (ETA) | 20 min / 35 min / 50 min |
Tam też włącza się automatyczne przydzielanie zamówień między kurierami.
Własna dostawa vs agregatory#
- Własna: kurierzy lokalu, pełna kontrola, niższa prowizja
- Agregatory (Wolt, Glovo, Deliveroo, Yandex Eats): większy zasięg, ale prowizja 15–30%
- Hybrydowa: własna dostawa w bliskich strefach + agregatory w dalszych
9. SEO dla strony restauracji#
Automatyczna optymalizacja SEO#
Cenaly automatycznie generuje:
- Meta tagi: title, description dla każdej strony
- Schema.org: dane strukturalne (Restaurant, Menu, MenuItem)
- Open Graph: podgląd przy udostępnianiu w mediach społecznościowych
- Sitemap.xml: mapa strony dla wyszukiwarek
- Robots.txt: zasady indeksowania
Zalecenia#
- Podłącz Google Search Console do monitorowania
- Używaj własnej domeny (menu.yourrestaurant.com)
- Wypełnij szczegółowo opis lokalu (dla Google Maps)
- Dodaj zdjęcia — są indeksowane przez Google Images
- Włącz opinie — ocena wyświetla się w wynikach wyszukiwania