Integracje sklepów w ksefservice.pl – jak podłączyć swój sklep (ShopGold i kolejne platformy) krok po kroku
Do tej pory każda integracja sklepu z ksefservice.pl (Allegro, Empik Marketplace, Erli.pl) opierała się na osobnym mechanizmie dopasowanym do konkretnej platformy. Teraz wprowadzamy zakładkę „Integracje sklepów" — wspólne miejsce w panelu, w którym podłączasz swój sklep niezależnie od tego, na jakim silniku działa, a system sam wie, jak z nim rozmawiać. Pierwszą obsługiwaną platformą jest ShopGold, kolejne będą dochodzić bez zmiany sposobu, w jaki korzystasz z panelu.
Jak to działa od strony technicznej — w skrócie
W przeciwieństwie do integracji opartych o REST API (jak Allegro), niektóre platformy sklepowe — w tym ShopGold — udostępniają dane zamówień w modelu plikowym: na serwerze Twojego sklepu umieszczany jest niewielki plik „konektora", który odczytuje zamówienia bezpośrednio z bazy danych sklepu i udostępnia je do pobrania przez ksefservice.pl. To ten sam model integracji, jaki stosuje np. BaseLinker.
Dzięki temu nie musisz nic zmieniać w konfiguracji swojego sklepu poza jedną rzeczą: wgraniem gotowego pliku, który dla Ciebie generujemy.
Konfiguracja krok po kroku
- Zaloguj się do panelu ksefservice.pl i przejdź do zakładki „Integracje sklepów".
- Wybierz platformę z listy dostępnych providerów (na start: ShopGold). Każda platforma ma swój dedykowany formularz konfiguracyjny — pola dopasowują się automatycznie do wybranego providera.
- Pobierz plik konektora wygenerowany specjalnie dla Twojej integracji. Plik zawiera już wstawione unikalne dane: identyfikator konektora, hasło komunikacji i sekret HMAC (do podpisywania zapytań) — nie musisz nic w nim ręcznie edytować.
- Wgraj plik na serwer swojego sklepu — zwykle przez FTP/panel hostingowy, do katalogu głównego instalacji sklepu (dokładną lokalizację znajdziesz w instrukcji dołączonej do pliku, dopasowanej do wybranej platformy).
- Zapisz konfigurację w panelu — po wgraniu pliku system automatycznie sprawdzi połączenie z konektorem i potwierdzi, że widzi dane sklepu.
- Ustaw zasady wystawiania dokumentów — kiedy ma powstać faktura (np. po zmianie statusu zamówienia na „opłacone"), jakie stawki VAT stosować domyślnie, czy obsługiwać też paragony dla klientów detalicznych.
Od tego momentu ksefservice.pl cyklicznie odpytuje plik konektora o nowe i zmienione zamówienia, generuje odpowiedni dokument (fakturę FA(3) lub paragon) i wysyła go do KSeF — dokładnie tak samo, jak przy integracjach opartych o API.
Co widzisz w panelu po podłączeniu
- listę wszystkich podłączonych sklepów wraz ze statusem połączenia (aktywne / wymaga uwagi),
- historię pobranych zamówień i wystawionych do nich dokumentów, z zabezpieczeniem przed podwójnym przetworzeniem tego samego zamówienia,
- możliwość podłączenia więcej niż jednego sklepu do tego samego konta — przydatne, jeśli prowadzisz kilka sklepów lub obsługujesz klientów jako biuro rachunkowe.
Bezpieczeństwo połączenia
Komunikacja między ksefservice.pl a plikiem konektora na Twoim serwerze jest zabezpieczona hasłem komunikacyjnym oraz podpisem HMAC — dzięki temu nawet znajomość samego adresu URL konektora nie wystarczy do odczytania danych zamówień bez znajomości sekretu wygenerowanego wyłącznie dla Twojej integracji.
Dlaczego architektura ma znaczenie dla Ciebie
Zakładka „Integracje sklepów" została zaprojektowana tak, by dodawanie kolejnych platform (poza ShopGold) nie wymagało zmiany sposobu, w jaki korzystasz z panelu — nowa platforma pojawi się po prostu jako kolejna opcja do wyboru, z własnym formularzem konfiguracyjnym, ale w tym samym, znajomym procesie. Jeśli dziś korzystasz z platformy, której jeszcze nie obsługujemy, warto śledzić zmiany — lista wspieranych sklepów będzie się rozszerzać.
Podsumowanie
Podłączenie sklepu do automatycznego fakturowania KSeF sprowadza się teraz do kilku kroków w panelu i jednego pliku wgranego na serwer sklepu — bez pisania integracji, bez znajomości API platformy, bez ręcznego przepisywania zamówień.
Prowadzisz sklep na ShopGold i chcesz go podłączyć? Skontaktuj się z nami lub sprawdź zakładkę Integracje sklepów bezpośrednio w panelu.
