Zrzuty ekranu
Co daje integracja z WooCommerce?
Pakiet Max. Są dwa niezależne sposoby pracy — można używać jednego albo obu:
- Wtyczka WordPress — sklep sam wystawia fakturę w Mobilnej Fakturze, gdy zamówienie zmieni status na wybrany, i może wysłać ją klientowi e-mailem.
- Połączenie przez REST API — w panelu pobierasz listę zamówień ze sklepu i wystawiasz do nich faktury (pojedynczo albo zbiorczo); to samo połączenie służy do synchronizacji stanów magazynowych.
Menu: Sklepy → WooCommerce (Lista zamówień, Plugin WordPress). Ustawienia połączenia: przycisk Ustawienia na liście zamówień albo Ustawienia → Integracje → WooCommerce.
Sposób 1: wtyczka WordPress
Instalacja
- W panelu: Sklepy → WooCommerce → Plugin WordPress → Pobierz plugin (ZIP) (albo przycisk Pobierz plugin WordPress nad listą zamówień).
- W WordPress: Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer → wybierz plik ZIP → Zainstaluj teraz → Włącz wtyczkę.
Konfiguracja
W WordPress: WooCommerce → Ustawienia → zakładka mobilna-faktura.pl.
| Pole | Co wpisać |
|---|---|
| Włącz integrację | zaznacz, aby wtyczka wystawiała faktury |
| Login / Hasło | dane logowania do mobilna-faktura.pl |
| Klucz API | klucz WebAPI z ustawień konta (Ustawienia → Integracje → Ustawienia WebApi) |
| Typ dokumentu | np. Faktura VAT, Rachunek |
| Numeracja od / Format numeracji | numer początkowy i format, np. FV/{NR}/{ROK} (zmienne: {NR}, {ROK}, {MIESIAC}, {DZIEN}) |
| Status wyzwalający | status zamówienia, po którym powstaje faktura (np. „Zrealizowane”) |
| Wysyłaj e-mail | wyślij fakturę klientowi e-mailem |
Na dole jest przycisk Testuj połączenie. Zapisz ustawienia.
Sprawdzenie: złóż testowe zamówienie, zmień jego status na wyzwalający i sprawdź, czy faktura pojawiła się na Liście dokumentów w panelu.
NIP nabywcy
Wtyczka nie dodaje pola NIP do formularza zamówienia. Przekazuje NIP na fakturę, jeśli sklep zapisuje go w polu zamówienia billing_nip (np. inną wtyczką do NIP-u).
Sposób 2: połączenie przez REST API
Klucze API w WooCommerce
W WordPress: WooCommerce → Ustawienia → Zaawansowane → REST API → dodaj klucz z uprawnieniami Odczyt/Zapis (zapis jest potrzebny do wysyłania stanów). Skopiuj Consumer Key i Consumer Secret.
Ustawienia w panelu
- Ustawienia → Integracje → WooCommerce (albo Ustawienia nad listą zamówień).
- Wpisz Adres URL sklepu, Consumer Key i Consumer Secret, wybierz statusy zamówień do pobierania.
- Testuj połączenie → Zapisz ustawienia.
Pobieranie zamówień i faktury
- Sklepy → WooCommerce → Lista zamówień.
- Ustaw daty Od i Do oraz Statusy → Pobierz zamówienia.
- Wystaw fakturę ikoną przy zamówieniu albo zaznacz kilka (Zaznacz wszystkie / Odznacz wszystkie) → Wystaw faktury dla zaznaczonych.
Kolumna Faktura pokazuje Wystawiona przy zamówieniach już zafakturowanych — przy wystawianiu zbiorczym są pomijane, więc druga faktura do tego samego zamówienia nie powstanie.
Synchronizacja stanów magazynowych (Max)
Zmiany stanu w Mobilnej Fakturze są wysyłane do sklepu, dzięki czemu WooCommerce nie sprzedaje towaru, którego już nie ma. Wymaga połączenia przez REST API.
Jak to uruchomić
- W ustawieniach WooCommerce w panelu kliknij Dopasuj produkty po SKU. Warunek: kod towaru w Mobilnej Fakturze = SKU produktu w sklepie.
- Zaznacz Włącz auto-sync stanów do WooCommerce i zapisz.
- Opcjonalnie Wyślij wszystkie stany teraz — jednorazowa wysyłka wszystkich dopasowanych stanów.
Od tej pory każda zmiana stanu trafia do kolejki i jest wysyłana do sklepu w ciągu kilku minut.
Do sklepu trafia liczba całkowita, zaokrąglona w dół (7,9 → 7). Przy towarach na kilogramy czy metry stan w sklepie może być niższy niż w panelu — celowo, żeby nie sprzedać towaru, którego nie ma.
Co aktualizuje stan
Dokumenty magazynowe (WZ, PZ i inne), przesunięcia MM, inwentaryzacja oraz faktura sprzedaży — o ile w Ustawienia → Pozostałe → Ustawienia WZ i PZ stany są aktualizowane wraz z drukami.
Kierunek synchronizacji
Stany idą z Mobilnej Faktury do sklepu. Zamówienia płyną w drugą stronę, więc sprzedaż w sklepie zdejmuje stan w panelu dopiero po wystawieniu do niej faktury.
⚠️ Towar bez odpowiednika w kartotece. Jeśli zamówienie zawiera produkt, którego nie ma w panelu, pozycja zostanie dopasowana po nazwie albo założona jako nowy towar — ale jego stan nie będzie synchronizowany, dopóki nie nadasz mu kodu równego SKU ze sklepu.
💡 Ta sama synchronizacja działa dla Shopify, Allegro i PrestaShop. BaseLinker pobiera tylko zamówienia, bez stanów.
Rozwiązywanie problemów
„Nie można połączyć ze sklepem”
- Sprawdź adres sklepu (z
https://). - Upewnij się, że REST API jest włączone w WooCommerce i klucze są aktywne.
Wtyczka nie wystawiła faktury
- Sprawdź, czy zaznaczone jest Włącz integrację i czy zamówienie przeszło na Status wyzwalający.
- Kliknij Testuj połączenie w ustawieniach wtyczki.
„Błąd autoryzacji”
- Wygeneruj nowe klucze API i sprawdź ich uprawnienia (Odczyt/Zapis).