# Konektor Sellsy PrestaShop: dokumentacja
> Kompletny przewodnik po konektorze Sellsy dla PrestaShop 8 i 9: instalacja, utworzenie dostępu API Sellsy v2, konfiguracja, synchronizacja klientów, zamówień, faktur, płatności i korekt, cron oraz rozwiązywanie problemów.
- Strona:
- Język: pl
- Zaktualizowano: 2026-07-30
- Inne języki: [fr](https://www.datafirefly.com/documentation/connecteur-sellsy-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/connecteur-sellsy-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/connecteur-sellsy-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/connecteur-sellsy-prestashop/index.md), [it](https://www.datafirefly.com/it/documentation/connecteur-sellsy-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/connecteur-sellsy-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/connecteur-sellsy-prestashop/index.md)
- Indeks:
## Prezentacja
Konektor Sellsy od DataFirefly łączy Twój sklep PrestaShop z **Sellsy**, francuskim rozwiązaniem SaaS do CRM, fakturowania i zarządzania. Automatycznie synchronizuje klientów, produkty, zamówienia, faktury, płatności i korekty z PrestaShop do Sellsy przez **API Sellsy v2**. Synchronizacja jest jednokierunkowa: PrestaShop → Sellsy.
Zgodność z PrestaShop 8.0 do 9.x, multisklep. Interfejs administracyjny po francusku i angielsku.
## Instalacja
1. W panelu administracyjnym PrestaShop przejdź do _Moduły > Menedżer modułów_.
2. Kliknij _Załaduj moduł_ i prześlij plik `dfsellsy.zip`.
3. Po instalacji kliknij _Konfiguruj_.
Moduł tworzy dwie tabele (`dfsellsy_link` dla powiązań PrestaShop ↔ Sellsy, `dfsellsy_log` dla dziennika) oraz zakładkę „Sellsy Connector" w menu Moduły.
## Utworzenie dostępu API w Sellsy
Konektor korzysta z uwierzytelniania OAuth2 (client credentials) API v2.
1. W Sellsy otwórz _Menu > Ustawienia > Portal deweloperski_.
2. W zakładce _API V2_ kliknij _Utwórz dostęp API_.
3. Wybierz współpracownika powiązanego z dostępem (najlepiej administratora, aby mieć wszystkie uprawnienia) i zaznacz potrzebne scope'y (klienci, dokumenty, katalog, płatności).
4. Zapisz, a następnie skopiuj **Client ID** i **Client Secret**.
Client Secret jest wyświetlany tylko raz. Zachowaj go w bezpiecznym miejscu, zanim opuścisz stronę Sellsy.
## Konfiguracja modułu
Na stronie konfiguracji modułu wypełnij:
- **Client ID** i **Client Secret**: dane OAuth2 utworzone w Sellsy. Zostaw pole secret puste, aby zachować już zapisaną wartość.
- **Synchronizuj klientów**: tworzy/aktualizuje kontrahenta Sellsy przy rejestracji i aktualizacji klienta.
- **Synchronizuj zamówienia**: przekształca zamówienia w dokumenty Sellsy.
- **Typ dokumentu Sellsy dla zamówień**: faktura lub zamówienie zakupu.
- **Wyzwalacz synchronizacji zamówień**: przy potwierdzeniu płatności lub przy zatwierdzeniu zamówienia.
- **Zatwierdzaj dokumenty Sellsy**: automatycznie zatwierdza faktury i korekty po utworzeniu (w przeciwnym razie pozostają w Sellsy jako szkice).
- **Rejestruj płatności**: zapisuje wpłaty PrestaShop na fakturze Sellsy (tylko w trybie faktury).
- **Synchronizuj zwroty jako korekty**: tworzy korektę Sellsy przy każdej korekcie PrestaShop i wiąże ją z fakturą pierwotną.
- **Synchronizuj produkty**: wypycha katalog do pozycji Sellsy.
Użyj przycisku _Testuj połączenie API_, aby zweryfikować dane dostępowe przed włączeniem synchronizacji.
## Synchronizacja klientów
Przy rejestracji lub aktualizacji klienta moduł tworzy albo aktualizuje kontrahenta Sellsy. Klienci z wypełnionym polem „firma" stają się w Sellsy **firmami** (z numerem SIRET, jeśli dostępny), pozostali **osobami prywatnymi**. Wyszukiwanie po adresie e-mail zapobiega duplikatom, a główny adres rozliczeniowy jest przekazywany przy utworzeniu.
## Synchronizacja zamówień
W zależności od wybranego wyzwalacza zatwierdzone lub opłacone zamówienie staje się dokumentem Sellsy zawierającym pozycje produktowe, koszty wysyłki i rabaty koszykowe (jako pozycja ujemna). Stawki VAT PrestaShop są automatycznie mapowane na podatki Sellsy. Każde zamówienie jest synchronizowane tylko raz (idempotencja).
## Faktury, zatwierdzanie i płatności
Gdy typem dokumentu jest „faktura":
- jeśli opcja _Zatwierdzaj dokumenty_ jest aktywna, faktura jest zatwierdzana automatycznie po utworzeniu;
- jeśli opcja _Rejestruj płatności_ jest aktywna, każda wpłata PrestaShop jest zapisywana na fakturze bez duplikatów, łącznie z płatnościami częściowymi i wielokrotnymi;
- jeśli zamówienie zostało utworzone przy zatwierdzeniu, a płatność nadejdzie później, moduł rejestruje tylko nowe wpłaty na istniejącej fakturze.
## Korekty przy zwrotach
Przy wygenerowaniu korekty w PrestaShop moduł tworzy korektę Sellsy na podstawie zwracanych pozycji (produkty i wysyłka), zatwierdza ją, jeśli opcja jest aktywna, a następnie wiąże z fakturą pierwotną, o ile ta istnieje po stronie Sellsy.
## Synchronizacja produktów
Synchronizacja produktów jest opcjonalna. Po włączeniu produkty są wypychane do katalogu Sellsy przy tworzeniu i aktualizacji. Możesz też uruchomić synchronizację masową ze strony „Sellsy Connector" (przetwarzanie partiami po 20).
## Zadania zaplanowane (cron)
Wbudowany cron pozwala nadrobić to, co mogłoby umknąć hookom działającym w czasie rzeczywistym. Zaplanuj adresy wyświetlane na stronie konfiguracji:
- `.../module/dfsellsy/cron?token=TWOJ_TOKEN&job=orders`
- `...&job=customers`
- `...&job=products`
- `...&job=retry` (ponawia encje z błędem, jeszcze niepowiązane)
Parametr `limit` (domyślnie 20, maks. 100) kontroluje rozmiar partii na wykonanie.
## Dziennik synchronizacji
Strona „Sellsy Connector" wyświetla filtrowany dziennik (po encji i statusie) każdej operacji, wraz z komunikatem zwróconym przez Sellsy w razie błędu. Przycisk _Ponów błędy_ ponawia nieudane operacje jednym kliknięciem.
## Rozwiązywanie problemów
- **„Połączenie nieudane"**: sprawdź Client ID / Client Secret oraz czy potrzebne scope'y są zaznaczone w Sellsy.
- **Błąd pola dokumentu (HTTP 422)**: niektóre konta Sellsy mają specyficzne wymagania (adnotacje e-fakturowania, pola obowiązkowe). Sprawdź komunikat w dzienniku, aby zidentyfikować problematyczne pole.
- **Duplikaty kontrahentów**: moduł wyszukuje po adresie e-mail przed utworzeniem; upewnij się, że e-mail klienta jest wypełniony.
- **Nic się nie synchronizuje**: sprawdź, czy odpowiednie opcje są aktywne, i przetestuj połączenie API.