Wpina się w to, co już masz.
ERP, PIM, WMS, CRM, bramka płatnicza, kurier, KSeF, model językowy, wyszukiwarka, magazyn plików, tagi reklamowe i feedy produktowe - każdy z tych światów ma tu osobny, opisany punkt wejścia. Nie eksport do pliku raz na dobę, tylko API partnerskie, podpisane webhooki i szyfrowane konfiguracje dostawców.
- REST
- API partnerskie z żywym OpenAPI
- HMAC
- podpisane webhooki z ponawianiem
- 3
- bramki płatnicze w standardzie
- 4
- dostawcy modeli językowych
Trzy sposoby na podłączenie systemu
Nie ma jednej „integracji ze wszystkim”. Są trzy dobrze opisane mechanizmy, z których integrator wybiera to, czego potrzebuje.
Klucze API i API partnerskie
Token dostępowy z wąskim zakresem uprawnień, opcjonalnie przypięty do jednej organizacji i jednego kanału sprzedaży. Wszystko, co robi integracja, dzieje się na dedykowanej przestrzeni adresów dla partnerów.
- Zakresy osobno dla odczytu i zapisu katalogu oraz odczytu i składania zamówień
- Klucz przypięty do organizacji widzi jej ceny i limity - i nic ponad to
- Token pokazywany raz, w bazie zostaje wyłącznie jego skrót
- Próba wyjścia poza zakres kończy się odmową i wpisem w dzienniku audytu
Webhooki
Zdarzenia z platformy lecą do Twojego systemu w chwili, w której się dzieją - podpisane, ponawiane i możliwe do odtworzenia po awarii odbiorcy.
- Podpis HMAC-SHA-256 liczony z surowej treści żądania
- Do ośmiu prób z rosnącym odstępem i limitem czasu na próbę
- Nieudane doręczenia lądują w osobnym widoku z ręcznym ponowieniem
- Subskrypcję można zawęzić do zdarzeń jednej organizacji
Konfiguracje dostawców
Poświadczenia bramek, przewoźników, analityki czy CRM trzymane w panelu: zaszyfrowane, testowane przy zapisie i nigdy nie zwracane w postaci jawnej.
- Szyfrowanie AES-256-GCM, klucz trzymany poza bazą danych
- Test połączenia uruchamiany od razu przy zapisie konfiguracji
- Status i treść ostatniego błędu widoczne przy integracji
- Odczyt wyłącznie przez adapter, który faktycznie ich potrzebuje
Katalog integracji
Część z tych połączeń działa od razu po włączeniu modułu. Reszta to punkty wejścia, w które integrator wpina konkretny system - bez modyfikowania rdzenia platformy.
Płatności
Od przelewu tradycyjnego po bramkę kartową z 3-D Secure i zwrotami inicjowanymi z obu stron.
-
Stripe →
Pełna integracja bramki: karty, BLIK, Apple Pay i Google Pay, 3-D Secure, płatność wbudowana w kasę albo przekierowanie do Stripe Checkout, zapisane karty i zwroty inicjowane zarówno z platformy, jak i z panelu Stripe.
-
PayU →
Integracja z PayU GPO: BLIK, karty w formularzu PayU Secure Form, Apple Pay, Google Pay i pay-by-link, kasa w wariancie przekierowania albo wbudowanym, zapisane karty i BLIK One Click, powiadomienia weryfikowane podpisem OpenPayu i zwroty przez moduł reklamacji.
-
tpay →
Integracja z Merchant Open API tpay: BLIK, karty, przelewy bankowe, kasa z przekierowaniem albo na stronie sklepu, zapisane karty i BLIK One Click, powiadomienia podpisane JWS i zwroty przez moduł reklamacji.
-
Przelew bankowy
Zamówienie czeka na przelew, operator oznacza je jako opłacone w panelu, a status zamówienia zmienia się według Twoich reguł.
-
Płatność przy odbiorze
Odbiór osobisty i płatność gotówką, bez żadnej bramki po drodze.
-
Limit kupiecki
Płatność „na fakturę” w granicach limitu przyznanego organizacji, z atomową rezerwacją środków w chwili składania zamówienia.
-
Kolejne bramki
Bramki takie jak Przelewy24, PayPal czy Autopay dokłada się dokładnie tak, jak powstały Stripe, PayU i tpay: nowy moduł-adapter rejestruje sterownik i metodę płatności, a rdzeń platformy zostaje nietknięty.
Dostawa i logistyka
Przewoźnicy, nadania i stany magazynowe jako opisane punkty styku z systemami logistycznymi.
-
Adaptery przewoźników
Metody dostawy pochodzą z modułów-adapterów. Włączenie adaptera przewoźnika samo tworzy konfigurowalną metodę dostawy widoczną w kasie.
-
Nadania i śledzenie
Każda próba nadania to osobny rekord przesyłki z numerem u przewoźnika, statusem, powodem błędu i możliwością ponowienia bez ruszania zamówienia.
-
Systemy magazynowe
Wiele magazynów, rezerwacje i przypisania magazynów do kanałów są dostępne przez API i zdarzenia, więc to system WMS może pozostać źródłem prawdy o stanach.
ERP, PIM, WMS i CRM
Najważniejsza integracja w B2B: platforma i system, w którym firma faktycznie prowadzi biznes.
-
Comarch ERP Optima →
Najpopularniejszy ERP w polskich małych i średnich firmach. Kartoteki towarowe, stany, ceny i dokumenty sprzedaży spinamy adapterem opartym o API partnerskie i zdarzenia webhooków. Zakres i kierunek synchronizacji ustalamy na warsztacie.
-
Subiekt GT →
System handlowo-magazynowy Insertu, spotykany w hurtowniach i firmach handlowych. Produkty, stany magazynowe i zamówienia synchronizujemy przez API partnerskie, a dokumenty sprzedaży wracają do Subiekta w uzgodnionym formacie.
-
API partnerskie
Dedykowana przestrzeń adresów dla integratorów: lista i szczegóły produktów, drzewo kategorii, ceny i zamówienia. To jedyna powierzchnia przeznaczona dla systemów zewnętrznych, więc jej kontrakt jest stabilny.
-
Synchronizacja katalogu
Zapis produktów po numerze SKU dla systemów PIM oraz przyrostowe pobieranie zmian od podanego znacznika czasu, z paginacją kursorową dla dużych katalogów.
-
Wycena hurtowa
Jedno żądanie wycenia do dwustu pozycji dla konkretnej organizacji, z gwarancją, że kwota jest identyczna z tą, którą naliczy koszyk.
-
Idempotentne zamówienia
Zamówienia składane z kluczem idempotencji: powtórzenie tego samego żądania zwraca to samo zamówienie, nigdy drugie. To samo dotyczy równoległych powtórzeń.
-
Koperta uprawnień organizacji
Integracja nie może więcej niż kupujący z tej firmy. Obowiązują te same limity kredytowe, dozwolone metody płatności i dostawy oraz asortyment kanału - nie ma parametru omijającego reguły.
-
Zdarzenia biznesowe
Utworzenie zamówienia i zmiana jego statusu, zapytania ofertowe, rozliczenia płatności, zmiany limitu kupieckiego i zmiany produktów wychodzą jako wersjonowane zdarzenia webhooków.
E-faktury i księgowość
Dokumenty sprzedażowe zgodne z polskimi wymogami i gotowe do przekazania do systemu finansowo-księgowego.
-
KSeF →
Faktury i korekty wysyłane do Krajowego Systemu e-Faktur w formacie FA(3) przez trwałą kolejkę. Numer KSeF trafia na dokument, UPO jest do pobrania, a PDF dostaje kod QR do weryfikacji.
-
Faktury PDF
Proformy i faktury generowane po potwierdzeniu zamówienia, z własnym schematem numeracji i dostępem do plików przez API.
-
Wymiana z systemem FK
Zamówienia, faktury i płatności są dostępne przez API i webhooki, więc przekazanie dokumentów do systemu księgowego to kwestia adaptera, a nie zmiany w platformie.
Sztuczna inteligencja
Model językowy podłączasz na własnym kluczu - i sam decydujesz, czyj to model.
-
OpenAI (GPT) →
Modele GPT jako silnik asystenta w panelu, na Twoim własnym kluczu API i z modelem, który sam wskazujesz w konfiguracji.
-
Google Gemini →
Modele Gemini jako alternatywa dla GPT, konfigurowane w tym samym miejscu i tak samo wymienne bez zmian w kodzie.
-
Anthropic Claude →
Modele Claude do obsługi poleceń w języku naturalnym, wybierane z tej samej listy dostawców co pozostałe.
-
DeepSeek →
Modele DeepSeek dla wdrożeń, które szukają tańszego albo mniej zależnego od największych dostawców wariantu.
-
Wyszukiwanie semantyczne
Wyszukiwarka może liczyć embeddingi w dowolnym punkcie zgodnym z API OpenAI - również w Azure OpenAI albo w lokalnie uruchomionej Ollamie, jeśli dane nie mają opuszczać Twojej infrastruktury.
-
Współdzielone poświadczenia
Klucze zapisujesz raz, w formie zaszyfrowanej. Podmiana klucza w jednym miejscu działa od razu we wszystkich modułach, które z niego korzystają.
Wyszukiwanie
Silnik wyszukiwania jako osobny komponent, a nie zapytanie SQL z LIKE.
-
Meilisearch →
Indeks budowany osobno dla każdego kanału sprzedaży i aktualizowany zdarzeniami katalogu, obsługujący wyszukiwanie, filtrowanie po atrybutach i podpowiedzi w locie.
-
Tryb hybrydowy
Po włączeniu wyszukiwania semantycznego ten sam indeks łączy klasyczne dopasowanie fraz z dopasowaniem znaczeniowym, osobno dla każdego kanału.
Poczta i komunikacja
Wiadomości transakcyjne i masowe idą osobnymi kanałami, na dostawcach, których wybierasz.
-
SMTP
Dowolny serwer pocztowy jako nadawca wiadomości transakcyjnych, z poświadczeniami trzymanymi w zaszyfrowanej konfiguracji.
-
Amazon SES →
Wysyłka przez SES z osobnym zestawem poświadczeń, wybierana z tej samej listy co pozostali dostawcy.
-
SendGrid →
Wysyłka przez SendGrid na kluczu API, bez zmian w kodzie modułów, które wysyłają wiadomości.
-
Newsletter
Masowa wysyłka idzie własnym kanałem SMTP (SES SMTP, Mailgun albo dowolny inny relay), niezależnie od poczty transakcyjnej. Cały moduł można wyłączyć, jeśli korzystasz z zewnętrznego systemu mailingowego.
Analityka i reklama
Dane o zachowaniu kupujących zarówno u Ciebie, jak i w narzędziach, których używa marketing - z jedną, wspólną zgodą na cookies.
-
Google Analytics 4 →
Włącznik i identyfikator pomiaru osobno dla każdego kanału sprzedaży, Enhanced Ecommerce, konfigurowalne zdarzenia własne i opcjonalne tagowanie serwerowe.
-
Google Tag Manager →
Kontener GTM per kanał sprzedaży, ze stabilnym słownikiem zdarzeń handlowych na warstwie danych i Consent Mode v2. Po włączeniu tagowania serwerowego te same zdarzenia lecą z backendu do Twojego kontenera serwerowego - dokładnie raz, nigdy dwiema drogami naraz.
-
Meta Ads →
Piksel Meta per kanał sprzedaży ze standardowymi zdarzeniami handlowymi: ViewContent, AddToCart, InitiateCheckout, Purchase i Lead. Własne nazwy zdarzeń dokładasz obok standardowych, więc audyt B2B nie kosztuje Cię raportowania zakupów.
-
LinkedIn Ads →
Insight Tag per kanał sprzedaży i mapowanie akcji storefrontu na identyfikatory konwersji z Campaign Managera. Mapować można wyłącznie akcje, które platforma faktycznie emituje - nie ma pozycji, która nigdy nie zadziała.
-
Zgoda na cookies
Jeden baner i jedna zapisana decyzja obsługują wszystkie narzędzia naraz. Do momentu akceptacji nie leci żaden skrypt, cookie ani żądanie, a każde narzędzie włącza się i wyłącza niezależnie od pozostałych.
-
Własny rejestr zdarzeń
Zdarzenia storefrontu zbierane po Twojej stronie, z podsumowaniami w panelu - niezależnie od tego, czy zewnętrzne narzędzia analityczne są włączone.
Feedy produktowe i marketplace’y
Katalog kanału sprzedaży wystawiony w formacie, którego oczekuje porównywarka albo marketplace - bez ręcznego eksportu i bez arkusza na dysku.
-
Google Merchant Center →
Gotowy szablon XML na poziomie wariantu, z kompletem pól wymaganych przez Google. Plik leży pod stałym, tokenizowanym adresem, który Merchant Center pobiera samodzielnie według Twojego harmonogramu.
-
Katalog Meta →
Drugi gotowy szablon, w formacie katalogu produktowego Meta - ten sam mechanizm generowania, harmonogramu i publikacji co feed dla Google.
-
Marketplace’y
Szablony startowe dla Amazona, eBaya i Allegro (TSV i CSV) z identyfikatorem, ceną, dostępnością, linkiem i zdjęciem. Pola specyficzne dla danego konta dokładasz w edytorze szablonu - w tej wersji jest to plik do pobrania, a nie integracja z API marketplace’u.
-
Taksonomie produktowe
Kategorie Google i Meta wgrane razem z platformą (ponad 8,5 tys. węzłów, po polsku i angielsku), więc generowanie feedu nigdy nie zależy od dostępności serwerów dostawcy. Nowszą wersję taksonomii instaluje się nieaktywnie, a operator zatwierdza ją po podglądzie skutków.
-
Ceny i zawężanie feedu
Feed wycenia się netto albo brutto, z wybranego cennika albo z wyceny anonimowej kanału, a asortyment zawęża tym samym budowniczym reguł co promocje - z licznikiem trafień liczonym na tych samych cenach, które trafią do pliku.
-
Kontrola nad linkiem
Adres feedu można obrócić albo unieważnić ze skutkiem natychmiastowym, każde uruchomienie zapisuje diagnostykę pominiętych pozycji z eksportem do CSV, a nieudane generowanie powiadamia raz - przy wejściu w stan awarii, nie przy każdej próbie.
Pliki i infrastruktura
Komponenty, na których stoi platforma - standardowe, wymienne i możliwe do postawienia u siebie.
-
Amazon S3 →
Zdjęcia, dokumenty i załączniki trzymane w S3, z widocznością publiczną albo prywatną ustawianą osobno dla każdego zasobu.
-
Google Cloud Storage →
Ten sam model przechowywania plików na GCS, przełączany z poziomu ustawień, bez zmiany kodu.
-
Dysk lokalny
Wariant domyślny, wygodny przy wdrożeniach on-premise i w środowiskach deweloperskich.
-
PostgreSQL →
Baza, w której mieszka katalog, zamówienia, ceny i cała reszta danych - standardowa instalacja, którą możesz hostować u siebie.
-
Redis i kolejki zadań →
Cache sesji oraz kolejki obsługujące webhooki, wysyłkę e-maili, indeksowanie wyszukiwarki i wysyłkę do KSeF, z ponawianiem i widokiem nieudanych zadań.
Kanały sprzedaży
Marketplace, portal dystrybutora czy sprzedaż stacjonarna jako kolejne kanały tej samej platformy.
-
Portale dystrybutorów
Każde miejsce sprzedaży to osobny kanał z własnym asortymentem, cenami i treścią. Klucz API przypięty do organizacji i kanału obsługuje ruch integracji dokładnie na tych samych zasadach co kupujący.
-
Aplikacje i POS
Ten sam backend i to samo API obsługują aplikację mobilną (PWA) oraz sprzedaż stacjonarną, bez budowania równoległego systemu.
Czego możesz oczekiwać od każdej integracji
To są zasady wspólne dla całej warstwy integracyjnej, nie obietnice składane osobno przy każdym systemie.
Żywy kontrakt OpenAPI
Dokument OpenAPI generowany z kontraktów zapisanych w kodzie jest źródłem prawdy o każdym punkcie końcowym. Integrator nie zgaduje formatów i nie pracuje na nieaktualnym PDF-ie.
Powtórzenie nie tworzy duplikatu
Składanie zamówień wymaga klucza idempotencji, a odbiorcy webhooków dostają stabilny identyfikator zdarzenia, po którym odsiewają powtórki. Ponowne wysłanie nigdy nie dubluje zamówienia.
Cena z API to ta sama cena
Wycena pobrana przez API przechodzi przez ten sam silnik cen co koszyk i zamówienie. Zgodność jest do grosza, więc integracja nie generuje reklamacji.
Awarie są widoczne
Nieudane doręczenia webhooków mają własny widok w panelu i przycisk ponowienia, a nieudany test połączenia zostawia treść błędu przy konfiguracji integracji.
Sekrety nie wyciekają
Tokeny trzymane są wyłącznie jako skróty, konfiguracje dostawców są szyfrowane, wartości maskowane przy odczycie, a wpisy w dzienniku audytu redagowane.
Każde żądanie da się namierzyć
Odpowiedzi niosą identyfikator żądania - ten sam, który trafia do logów i do dziennika audytu. W zgłoszeniu wystarczy go podać, żeby odtworzyć całą ścieżkę.
Nie ma tu Twojego systemu?
To dobra wiadomość, bo właśnie o to chodzi. Lista integracji nie jest zamknięta: nowa bramka płatnicza, kurier, ERP czy system BI to kolejny moduł-adapter, który rejestruje się w platformie i dostaje własne ustawienia oraz uprawnienia. Rdzeń zostaje bez zmian, a kod stoi w Twoim repozytorium. Na warsztacie przechodzimy przez listę systemów, które faktycznie macie u siebie, i ustalamy, co wchodzi do pierwszego wdrożenia.
Sprawdźmy, co da się podłączyć u Ciebie
Umów bezpłatny warsztat. Przejdziemy przez Twój ERP, magazyn i procesy sprzedaży, i pokażemy, jak wygląda ścieżka integracji krok po kroku.