Integracja WooCommerce z iFirmą: konfiguracja i testy

Integracja może przenosić zamówienia, dane nabywcy, produkty i informacje o płatności, a dostępny zakres zależy od używanego połączenia. Oficjalna strona iFirmy opisuje import zamówień z WooCommerce, automatyzację fakturowania oraz księgowania, a także możliwość wystawienia faktury po opłaceniu zamówienia, oznaczenia jej jako opłaconej i wysłania e-mailem. Stan informacji producenta: 10.2026, integracja WooCommerce z iFirmą.

Nie zakładaj, że każda wtyczka oferuje identyczne dokumenty i reguły. Sprawdź w dokumentacji konkretnego rozwiązania, czy obsługuje potrzebne faktury, rachunki, korekty, zwroty, logi i automatyczne ponowienia.

Tabela odpowiada na pytanie, które elementy przepływu warto potwierdzić przed wyborem integracji. Zakres zależy od konkretnej wtyczki lub konfiguracji.

Tabela pozwala zebrać wymagania przed instalacją, ale dostawca powinien potwierdzić je dla wybranego wariantu.

Wybierz połączenie, które obsługuje wymagane dokumenty, reguły wystawiania i kontrolę błędów. Sama nazwa "integracja z iFirmą" nie określa, czy zamówienia są importowane do iFirmy, czy dokument jest wystawiany z poziomu sklepu ani kto pomaga przy problemach.

Przed zakupem zapytaj dostawcę:

• Jakie typy dokumentów są obsługiwane i czy można ustawić ich automatyczne wystawianie?
• Które statusy zamówień uruchamiają dokument i czy regułę można zmienić?
• Czy integracja przekazuje adres rozliczeniowy, NIP, walutę, rabat, dostawę i stawki podatku?
• Czy ponowienie żądania rozpoznaje wcześniej utworzony dokument?
• Gdzie znaleźć logi i kto odpowiada za wsparcie?
• Jak dostawca sprawdza zgodność po aktualizacji WooCommerce lub wtyczki?

Porównaj też aktualne warunki i opłaty bezpośrednio u iFirmy oraz autora wybranej wtyczki. Nie przenoś limitów ani zasad z jednego rozwiązania na inne połączenie.

Jeśli zamówienia pochodzą z kilku kanałów, integracja sprzedaży z BaseLinkerem może porządkować ich dalszy obieg. Przed wyborem ustal, które systemy i reguły fakturowania mają znaleźć się w tym przepływie.

Przed połączeniem przygotuj dane sprzedawcy, ustawienia podatków i dostęp wymagany przez wybraną integrację. Jeżeli wtyczka korzysta z API, postępuj zgodnie z jej instrukcją dotyczącą uprawnień i kluczy; nie przekazuj kluczy w niezabezpieczonych zgłoszeniach ani publicznych logach.

Przed konfiguracją sprawdź:

1. Czy dane firmy, waluta i stawki podatkowe są spójne w obu systemach.
2. Gdzie WooCommerce zapisuje adres rozliczeniowy, NIP i adres e-mail.
3. Jakie statusy nadają zamówieniom bramka płatnicza, dostawa i sklep.
4. Czy dokumenty z innych kanałów sprzedaży używają tej samej numeracji.
5. Jakie wersje WordPressa, WooCommerce i wtyczki są zainstalowane.

WooCommerce udostępnia w danych zamówienia między innymi adresy, pozycje, kwoty, podatki i status. Dokumentacja REST API opisuje strukturę tych pól, ale nie przesądza, które z nich odczyta konkretna wtyczka: pola zamówienia WooCommerce REST API.

Zalecamy wykonać kopię bazy danych i najpierw skonfigurować integrację na środowisku testowym, ponieważ błędne mapowanie może wpływać na dokumenty wystawiane w sklepie.

Mapowanie przypisuje dane zamówienia WooCommerce do pól nabywcy i pozycji dokumentu w iFirmie. Zacznij od sprawdzenia, czy integracja używa danych rozliczeniowych jako danych nabywcy i skąd pobiera NIP.

Tabela pokazuje przykładowe przypisania i kontrolę, która pozwala wykryć typowe błędy. Porównuj dokument z zapisanym zamówieniem testowym.

Sprawdź osobno rabat i koszt dostawy, ponieważ integracja może przekazywać je jako osobne pozycje albo uwzględniać w cenie. Zasady rozliczenia podatku i dokumentowania rabatów uzgodnij z osobą odpowiedzialną za księgowość.

Zachowuj identyfikator zamówienia WooCommerce i identyfikator dokumentu iFirmy w danych integracji lub logu. Powiązanie ułatwia sprawdzenie, czy ponowne żądanie dotyczy tego samego zamówienia.

Dokument może powstawać po opłaceniu zamówienia, po osiągnięciu określonego statusu albo po ręcznym zatwierdzeniu, zależnie od funkcji i konfiguracji integracji. Oficjalna strona iFirmy podaje, że po opłaceniu zamówienia system może automatycznie wystawić fakturę, oznaczyć ją jako opłaconą i wysłać klientowi e-mailem; nie jest to uniwersalny wymóg ręcznego zatwierdzania. Stan informacji producenta: 10.2026, integracja WooCommerce z iFirmą.

Tabela pomaga dobrać zdarzenie wyzwalające dokument do procesu obsługi zamówienia. Sprawdź, jak bramka płatnicza zmienia status, zanim włączysz automatyzację.

Dla anulowania i zwrotu ustal osobny proces korekty. Status "refunded" w WooCommerce nie oznacza sam w sobie, że właściwy dokument księgowy został wystawiony. Dokumentacja WooCommerce rozdziela status zamówienia od szczegółów obsługi zwrotu: dane zamówienia WooCommerce.

Test wykonaj na środowisku testowym albo na kontrolowanym zamówieniu, którego dokument możesz sprawdzić bez zakłócania bieżącej sprzedaży. Przed testem ustal, czy integracja tworzy rzeczywiste dokumenty w iFirmie i jak oznaczyć testowe zamówienia.

Przejdź przez przypadki testowe:

1. Zamówienie bez NIP i zamówienie z NIP.
2. Produkt z każdą stawką podatkową używaną w sklepie.
3. Zamówienie z rabatem, dostawą i kilkoma pozycjami.
4. Zamówienie opłacone oraz zamówienie z płatnością oczekującą.
5. Anulowanie, zwrot i uzgodniony proces korekty.
6. Kontrolowane ponowienie żądania po błędzie.

Po każdym przypadku porównaj dane nabywcy, pozycje, wartości, podatek i status dokumentu. Zapisz identyfikatory zamówienia oraz dokumentu i komunikat błędu. Przed ponowieniem synchronizacji sprawdź w iFirmie, czy dokument już istnieje.

Diagnozę zacznij od statusu zamówienia i logu wtyczki, a potem sprawdź, czy dokument został już zapisany w iFirmie. Zakres dostępnych logów i osobę odpowiedzialną za wsparcie określa dostawca używanej integracji.

Tabela łączy objaw z pierwszym sprawdzeniem, które pomaga zawęzić przyczynę. Wyszukaj dokument przed ponowieniem żądania, aby ograniczyć ryzyko duplikatu.

Przed zgłoszeniem do wsparcia przygotuj numer zamówienia, czas zdarzenia, status, nazwę i wersję wtyczki, komunikat błędu oraz identyfikator dokumentu, jeśli istnieje. Usuń z logów klucze API i zbędne dane osobowe.

Koszt połączenia zależy od wybranej wtyczki, zakresu konfiguracji, liczby wyjątków oraz testów i utrzymania zgodności. Aktualne opłaty sprawdź bezpośrednio w cenniku iFirmy lub u autora wtyczki, ponieważ warunki różnych połączeń mogą się różnić.

Do wyceny przygotuj liczbę sklepów, typy dokumentów, statusy zamówień, stawki podatku, bramki płatnicze, proces zwrotów, zasady numeracji oraz wymagania dotyczące logów. Uwzględnij też testy po aktualizacji WooCommerce i wtyczki.

Perspektywa KC Mobile: stabilność automatyzacji zależy od jednoznacznego warunku wystawienia dokumentu i powiązania dokumentu z zamówieniem. Gdy fakturowanie ma współpracować z zamówieniami z kilku kanałów, wdrożenie BaseLinkera dla sprzedaży wielokanałowej warto ocenić jako część całego przepływu.

• Jak zintegrować zamówienia ze sklepu internetowego z systemem księgowym?
• Integracja Inter Cars ze sklepem internetowym: jak działa i co sprawdzić przed wdrożeniem
• Allegro i WooCommerce: jak działa Wysyłam z Allegro i Smart?
• Integracja e-commerce z archiwizacją dokumentów księgowych