Integracja WooCommerce, PrestaShop, Shopify i Allegro z Mantrego

Integracja WooCommerce PrestaShop w Mantrego (oraz Shopify i Allegro) pobiera z Twojego sklepu zamówienia i pozycje zamówień, żeby raport sprzedaży mógł stać obok kosztów reklam i ruchu. Mantrego tylko czyta dane. Do każdego sklepu tworzysz klucz z uprawnieniem odczytu, wpisujesz go w koncie integracji i przypisujesz konto do klienta.

Sprawdzone w wersji 0.6.2, 2026-10-07. Panele sklepów zmieniają się, więc nazwy poleceń mogą się nieco różnić.

Zanim zaczniesz

• Rola Właściciel organizacji. Członek nie dodaje kont integracji.
• Sklep musi działać pod publicznym adresem HTTPS: bez adresu IP, bez portu innego niż standardowy, bez loginu w adresie, bez znaków ? i #. Wpisz sam adres strony głównej, na przykład https://twojsklep.pl. Adresy panelu administracyjnego (na przykład /wp-admin, /admin, /wp-json) są odrzucane.
• Limit planu: Free pozwala na 3 konta integracji.

Kroki ogólne

1. Wejdź w Integracje. W sekcji Dodaj połączenie wybierz kartę platformy i kliknij Dodaj konto.
2. Wpisz Nazwa połączenia i wybierz Klient.
3. Wypełnij pola platformy (opis niżej) i kliknij Zapisz połączenie.
4. Kliknij Sprawdź. Konfiguracja sama nie oznacza działającego połączenia.
5. Kliknij Synchronizuj. Opcjonalnie zaznacz Synchronizuj automatycznie w tle i ustaw Odstęp synchronizacji (minuty).
6. Otwórz Analityka, zakładka Sprzedaż.

WooCommerce

1. W panelu sklepu wejdź w WooCommerce, Ustawienia, Zaawansowane, REST API i wybierz Dodaj klucz. Wpisz opis, wybierz użytkownika i ustaw Uprawnienia na Odczyt.
2. Skopiuj klucz klienta (zaczyna się od ck_) i sekret klienta (cs_). Sekret widać tylko raz, więc zapisz go od razu.
3. WooCommerce wymaga, aby bezpośrednie odnośniki (Ustawienia, Bezpośrednie odnośniki) nie były ustawione na „Plain".
4. W Mantrego wpisz Adres sklepu WooCommerce, Klucz klienta WooCommerce i Sekret klienta WooCommerce.

Mantrego czyta zamówienia z ostatnich 60 dni (do 5 stron po 100), pozycje zamówień, sumy zwrotów zamówień i pierwsze 100 produktów z katalogu.

PrestaShop (8.1 i nowszy)

1. W panelu sklepu wejdź w Parametry zaawansowane, Webservice. Włącz usługę Webservice i kliknij Dodaj nowy klucz.
2. Nadaj kluczowi uprawnienie odczytu (metoda GET) dla zasobów orders i currencies.
3. W Mantrego wpisz Adres sklepu PrestaShop (adres strony głównej, bez katalogu panelu) i Klucz Webservice PrestaShop.

Mantrego czyta zamówienia w formacie JSON, z datami w strefie czasowej sklepu. Nie ma kanału zwrotów, więc wartość zwrotów pozostaje pusta. Zamówienia opłacone rozpoznaje po znaczniku ważności, a własne statusy zachowuje po numerze.

Shopify

1. Mantrego potrzebuje tokenu dostępu Admin API z uprawnieniem read_orders. Wpisz Domena sklepu Shopify w postaci nazwa-sklepu.myshopify.com (bez https:// i bez /admin) oraz Token dostępu Admin API Shopify (zaczyna się od shpat_).
2. Uwaga: według dokumentacji Shopify nowe aplikacje niestandardowe tworzy się w Dev Dashboard, a starsze (utworzone przed 1 stycznia 2026) można nadal zarządzać z panelu sklepu. Tokeny z przepływu client credentials wygasają po 24 godzinach, a Mantrego ich nie odnawia. Trwały token działa tylko wtedy, gdy masz taki od starszej aplikacji niestandardowej.

Mantrego czyta zamówienia z 60 dni, do 5 stron po 100, od najnowszych. Przy ponad 500 zamówieniach w okresie najstarsze są pomijane. Wartość pozycji to kwoty pierwotne, a wartość zamówienia to aktualna kwota. Błąd odpowiedzi GraphQL przerywa synchronizację, bez ukrytego częściowego sukcesu.

Allegro (zamówienia)

1. Zarejestruj aplikację w portalu dla deweloperów Allegro (apps.developer.allegro.pl) i uzyskaj token dostępu z uprawnieniem allegro:api:orders:read.
2. W Mantrego wybierz kartę Allegro / zamówienia i wpisz Token dostępu Allegro.

Według dokumentacji Allegro token dostępu jest ważny 12 godzin, a Mantrego nie odnawia go samo, więc musisz wklejać nowy token. Mantrego czyta formularze zamówień i pozycje z 60 dni (do 5 stron po 100). Nie zapisuje danych kupującego, adresów ani płatności. Wartość zamówień ze statusem gotowe lub wysłane to kwota do zapłaty, a nie rozliczenie.

Co raport pokazuje, a czego nie

• Sprzedaż to wartość zamówień opłaconych, z podatkiem i dostawą. Zamówienia anulowane i nieudane są wyłączone z sum.
• Zwroty pokazywane są osobno i mogą być nieznane (PrestaShop i Allegro ich nie dostarczają).
• Mantrego nie liczy zysku, marży ani przychodu netto, nie przelicza walut i nie wykrywa duplikatów zamówień między platformami. Jeśli podłączysz kilka źródeł sklepu, raport ostrzeże, że zamówienia mogą się powtarzać.
• Brakujących danych nie zastępuje zerem. Opis liczenia znajdziesz w poradniku Jak czytać raporty.

Rozwiązywanie problemów

• Adres sklepu jest odrzucany. Zacznij od https://, podaj publiczną domenę, bez portu, ścieżek panelu, znaków ? i #. Dla Shopify użyj nazwa-sklepu.myshopify.com.
• Sprawdź kończy się błędem uprawnień. Klucz musi mieć odczyt zamówień (WooCommerce: Odczyt, PrestaShop: GET na orders i currencies, Shopify: read_orders, Allegro: allegro:api:orders:read).
• Allegro lub Shopify przestały działać po kilku godzinach. Token wygasł. Wklej nowy w Ustawieniach konta.
• Synchronizacja trwa, ale brakuje zamówień. Zakres to 60 dni i 5 stron po 100. Przy większym ruchu dane są częściowe, co widać w zakładce Źródła danych.
• Poprzednie dane zostały po nieudanej synchronizacji. To zamierzone: nieudana strona nie zastępuje poprzedniej migawki, a błąd jest oznaczony.

Ograniczenia

• Tylko odczyt, nigdy zapis do sklepu.
• Nie są obsługiwane: Allegro Ads, Amazon, eBay, Magento, BigCommerce, Shoper, IdoSell, Baselinker.
• Adresy sklepów są sprawdzane pod kątem bezpieczeństwa: HTTPS, publiczna domena, bez przekierowań.
• Dostęp do danych zależy od uprawnień kluczy u dostawcy. Mantrego ich nie rozszerza.

Powiązane artykuły

• Jak czytać raporty: filtry, porównanie okresów, widoki i CSV
• Jak podłączyć Google Ads i Meta Ads
• Sprzedaż ze sklepu i wydatki na reklamy w jednym raporcie
• KPI e-commerce do raportu: wartość zamówień, AOV, zwroty i ROAS
• Cennik