Skip to content

WooCommerce – instalacja brokera

Połączenie z WooCommerce

  1. Po uruchomieniu integratora przejdź do konfiguracji połączenia ze sklepem.
  2. Otwórz menu Program > Konfiguracja (F9).
  3. Przejdź do zakładki Połączenie ze sklepem. Pola Adres brokera i Klucz Secret zostaną uzupełnione po zainstalowaniu wtyczki brokera i skopiowaniu danych z jej konfiguracji.
  4. Zaloguj się do panelu administracyjnego WordPress (zaplecze sklepu wp-admin, na którym działa WooCommerce).
  5. Otwórz zakładkę Wtyczki i wybierz Dodaj wtyczkę.
  6. W kolejnym oknie wybierz opcję Wyślij wtyczkę na serwer.
  7. Następnie kliknij Wybierz plik.
  8. Zlokalizuj plik RtnetSubSync-WooCommerce_IonCube9-13.zip. Plik znajduje się w folderze instalacyjnym integratora. Domyślne lokalizacje instalacji to:
ERP (integrator) Lokalizacja do 06.2026 Lokalizacja od 07.2026
Subiekt GT / Subiekt nexo PRO / Navireo (SubSync) C:\Program Files (x86)\RTNET\SubSync C:\Program Files (x86)\Integratory.pl\SubSync
WAPRO Mag (WfSync) C:\Program Files (x86)\RTNET\WfSync C:\Program Files (x86)\Integratory.pl\WfSync
Optima (OpSync) C:\Program Files (x86)\RTNET\OpSync C:\Program Files (x86)\Integratory.pl\OpSync
Symfonia ERP/Handel (SymSyncPro) C:\Program Files (x86)\RTNET\SymSyncPro C:\Program Files (x86)\Integratory.pl\SymSyncPro
Choć nazwa pliku zawiera fragment „IonCube9-13”, paczka brokera jest kompatybilna także z nowszymi wersjami IonCube, w tym 14+.
Aktualna paczka brokera do pobrania również tutaj.
  1. Po wybraniu pliku kliknij Otwórz.
  2. Następnie kliknij Zainstaluj.
  3. Po zakończeniu instalacji naciśnij przycisk Włącz wtyczkę.
  4. Powinien pojawić się komunikat „Wtyczka została włączona”. Wyszukaj wtyczkę Integratory.pl - integracja dla WooCommerce i kliknij Ustawienia.
  5. W sekcji Połączenie ze sklepem kliknij Kopiuj do schowka, aby przenieść Adres brokera i Klucz Secret do konfiguracji integratora.
  6. Wróć do okna konfiguracji integratora. Powinien być widoczny komunikat potwierdzający poprawne połączenie, a pola Adres brokera i Klucz Secret powinny uzupełnić się automatycznie.
  7. Konfiguracja połączenia została zakończona pomyślnie. Możesz przejść do ustawień wtyczki i pozostałych parametrów konfiguracji.
Jeśli użycie opcji „Kopiuj do schowka” nie uzupełniło pól w integratorze, przyczyną może być praca przez pulpit zdalny (problem ze schowkiem) lub wcześniejsze uzupełnienie pól w integratorze. W takiej sytuacji skopiuj Adres brokera i Klucz Secret osobno z poziomu wtyczki i wklej je do integratora.
Jeśli podczas włączania wtyczki (punkt 11) pojawi się komunikat, że nie mogła zostać włączona, ponieważ spowodowałaby błąd krytyczny, oznacza to brak aktywnego rozszerzenia IonCube w usłudze hostingowej. Należy włączyć IonCube w panelu hostingu lub skontaktować się z administratorem serwera.
Posiadasz hosting w Home.pl? Sprawdź dodatkowe informacje.

Ustawienia wtyczki

Poza danymi połączenia wtyczka przygotowuje sklep do pracy z integratorem. W sekcji Ustawienia wtyczki Integratory.pl – integracja z WooCommerce włączysz dokumenty sprzedaży w PDF i pole NIP w formularzu zamówienia.

Dokumenty sprzedaży w PDF - po zaznaczeniu opcji Udostępniaj dokumenty sprzedaży w formacie PDF wtyczka dodaje kolumnę Dokument sprzedaży w Moje konto > Zamówienia oraz przycisk pobierania dokumentu na liście zamówień w panelu.

Przesyłanie dokumentów PDF z programu do sklepu opisujemy w artykule Przesyłanie faktur w PDF z Subiekta do sklepu.

Pole NIP w zamówieniu

WooCommerce w standardzie nie ma pola na numer NIP. Jeżeli integrator nie wie, z którego pola odczytać NIP, każde zamówienie traktuje jak zakup osoby prywatnej. Nawet zamówienie firmy trafi wtedy do ERP jako PA lub FD zamiast FS.

Jeżeli sklep ma już pole NIP dodane inną wtyczką, np. Flexible Checkout Fields, nie zaznaczaj tej opcji – w formularzu zamówienia pojawiłyby się dwa pola NIP. W integratorze wpisz wtedy nazwę meta-pola z tamtej wtyczki (sekcja Nazwa meta-pola z numerem NIP poniżej).

Jeżeli sklep nie ma pola NIP, dodaj je we wtyczce:

  1. Zaznacz opcję Dodaj pole NIP do danych płatnika w formularzu zamówienia. Pod opcją pojawią się ustawienia pola.
  2. W polu Nazwa meta-pola zostaw domyślną wartość _billing_nip. Pod tą nazwą NIP zostanie zapisany w zamówieniu i tę samą nazwę wpiszesz w integratorze. Dozwolone znaki: litery, cyfry, _ i -.
  3. Ustaw opcje pola:
    Opis pola - etykieta wyświetlana klientowi przy polu, domyślnie NIP:.
    Pole wymagane - klient musi podać NIP, aby złożyć zamówienie. Zaznacz tylko wtedy, gdy sklep sprzedaje wyłącznie firmom.
    Walidacja NIP - sprawdza poprawność numeru. Dla adresu w Polsce: 10 cyfr i suma kontrolna polskiego NIP (prefiks PL, spacje i myślniki są usuwane). Dla pozostałych krajów i numerów z innym prefiksem literowym (np. DE): wyłącznie cyfry i litery.
  4. Kliknij Zapisz ustawienia.

Pole NIP pojawi się w formularzu zamówienia oraz w Moje konto > Adres rozliczeniowy. Wpisany NIP jest widoczny w panelu zamówienia (z możliwością edycji), na stronie zamówienia klienta i w e-mailach.

Pole działa w klasycznym formularzu zamówienia (shortcode [woocommerce_checkout]). Jeżeli strona zamówienia w sklepie jest zbudowana z bloków WooCommerce, pole nie pojawi się w formularzu.

Podatki WooCommerce

Towary w ERP mają przypisane stawki VAT, które są częścią ceny. Bez naliczania podatków integrator nie przetworzy zamówień i nie zaktualizuje cen w sklepie.

Sekcja Podatki WooCommerce porównuje ustawienia sklepu z zalecanymi. Wtyczka nie zmienia ustawień WooCommerce – przy każdym z nich jest link Zmień w ustawieniach WooCommerce, który otwiera właściwą zakładkę. Wyjątkiem są stawki VAT: brakujące klasy i stawki dodaje przycisk Dodaj brakujące stawki.

Ustawienie Zalecana wartość Gdzie zmienić Dlaczego to ważne
Naliczanie podatków Tak WooCommerce > Ustawienia > Ogólne > Włącz podatki Bez naliczania podatków integrator nie przetworzy zamówień i nie zaktualizuje cen.
Ceny produktów wprowadzane netto Tak WooCommerce > Ustawienia > Podatek > Ceny wprowadzone z podatkiem: Nie, wprowadzę ceny bez podatku Wymagane do poprawnej interpretacji cen przez integrator.
Adres sklepu (kraj i kod pocztowy) Polska (PL) WooCommerce > Ustawienia > Ogólne > Adres sklepu Od kraju sklepu zależą naliczane stawki.
Stawki podatkowe dla Polski 23%, 8%, 5%, 0% przycisk Dodaj brakujące stawki Bez stawki podstawowej integrator nie przeniesie ceny z zawartym w niej podatkiem.
Zmiana podatków zmienia ceny w sklepie. Po włączeniu naliczania podatków dotychczasowe ceny stają się cenami netto, więc ceny sprzedaży rosną o wartość podatku. Jeżeli sklep już działa, zmieniaj ustawienia podatków tuż przed aktualizacją cen z integratora (krok 4) i bądź gotowy wykonać ją od razu.
  1. Sprawdź statusy ustawień. Status Tak oznacza ustawienie zgodne z zalecanym. Przy statusie Nie kliknij Zmień w ustawieniach WooCommerce, ustaw zalecaną wartość, zapisz zmiany i wróć do ustawień wtyczki.
  2. Sprawdź tabelę stawek pod Stawkami podatkowymi dla Polski. Status Jest oznacza, że klasa podatkowa i stawka istnieją w sklepie. Status Brak klasy oznacza, że w sklepie brakuje klasy podatkowej dla tej stawki.
  3. Jeżeli przy Stawkach podatkowych dla Polski widoczny jest status Nie, kliknij Dodaj brakujące stawki. Wtyczka doda brakujące klasy podatkowe i stawki dla kraju PL (wszystkie kody pocztowe i miejscowości, priorytet 1, obejmują wysyłkę). Istniejących stawek nie zmienia.
  4. Jeżeli sklep już działa, zaktualizuj ceny towarów z poziomu integratora: Import/eksport towarów > zaznacz towary > Aktualizuj w sklepie > zaznacz Ceny > Start.

Gdy wszystkie ustawienia mają status Tak, a stawki status Jest, podatki w sklepie są gotowe do integracji. Sprawdź w sklepie kilka produktów z różnymi stawkami VAT – cena na karcie produktu i w koszyku powinna być równa cenie brutto w programie ERP.

Instrukcja opisuje konfigurację dla Polski. Jeżeli sklep działa w innym kraju, ustaw właściwy adres sklepu i dodaj odpowiednie stawki ręcznie w WooCommerce > Ustawienia > Podatek.

Nazwa meta-pola z numerem NIP

Program > Konfiguracja (F9) > Ustawienia WooCommerce > Nazwa meta-pola z numerem NIP

W polu Nazwa meta-pola z numerem NIP wpisz dokładną nazwę meta-pola zamówienia (ordermeta), z którego integrator odczyta numer NIP.

 

Skąd pochodzi pole NIP w sklepie Co wpisać w integratorze
Pole NIP z wtyczki brokera (sekcja Ustawienia wtyczki powyżej) wartość z pola Nazwa meta-pola we wtyczce, domyślnie _billing_nip
Pole dodane inną wtyczką, np. Flexible Checkout Fields nazwa meta-pola z konfiguracji tej wtyczki
Brak osobnego pola – klient wpisuje NIP w drugiej linii adresu _billing_address_2

Po wprowadzonych zmianach zapisz OK.

Poradnik video