Poradnik AIOMIX

WooCommerce i Comarch Betterfly — integracja faktur krok po kroku

Jak połączyć WooCommerce z Comarch Betterfly przez API? Proces tworzenia dokumentów roboczych, autoryzacja i testy Betterfly Connect.

4 listopada 2026 4 min czytania AIOMIX

Ręczne przepisywanie danych z zamówienia WooCommerce do programu fakturowego zajmuje czas i sprzyja pomyłkom. Integracja z Comarch Betterfly może ograniczyć tę pracę, ale wymaga jasnego rozróżnienia pomiędzy utworzeniem dokumentu roboczego a wystawieniem zatwierdzonej faktury. To szczególnie ważne w sklepach z różnymi stawkami podatkowymi, zwrotami i wieloma metodami płatności.

Jak powinien wyglądać przepływ danych z WooCommerce do Betterfly?

  1. Zamówienie: WooCommerce zapisuje produkty, kwoty, dane nabywcy, podatki, dostawę i status płatności.
  2. Warunek przekazania: administrator wybiera zdarzenie, po którym dane mają trafić do systemu fakturowego. Nie każda zmiana statusu oznacza nowe zamówienie.
  3. Dokument roboczy: integracja przekazuje odpowiednio odwzorowane pozycje, dane kontrahenta oraz podstawowe informacje potrzebne do przygotowania dokumentu.
  4. Weryfikacja: sprzedawca sprawdza dokument w Betterfly i zatwierdza go zgodnie z własnym procesem księgowym.
  5. Zwrot informacji: sklep może otrzymać status dokumentu, jeżeli przewiduje to wdrożona integracja.

Nie zakładaj, że samo przekazanie zamówienia tworzy prawidłową, zatwierdzoną fakturę. Nie wszystkie integracje obejmują też synchronizację magazynu, cen, klientów lub pełny obieg korekt.

Jak działa publiczne API Comarch Betterfly?

Zgodnie z dokumentacją Comarch Betterfly publiczne API korzysta z HTTPS, wymienia dane w formacie JSON i używa uwierzytelniania OAuth 2.0. Dostęp nie musi być automatycznie aktywny na każdym koncie. Administrator konta składa wniosek o udostępnienie API w sekcji zarządzania kontem, a po uzyskaniu dostępu przygotowuje dane połączenia i rejestruje aplikację.

Przed zakupem wtyczki integracyjnej sprawdź aktualne uprawnienia swojego konta, warunki udostępniania API i możliwość wykonania testowego połączenia. Oficjalna baza dokumentacji API zawiera osobne materiały m.in. dla kontrahentów, produktów i faktur sprzedaży.

Jakie błędy mogą pojawić się przy automatycznym przygotowywaniu faktur?

Problem Na co zwrócić uwagę
Podwójny dokument Ponowne wywołanie synchronizacji po opóźnieniu lub zmianie statusu zamówienia
Nieprawidłowy nabywca Brak danych firmowych, niepoprawne mapowanie pól lub pomyłka w identyfikatorze
Różnica w kwotach Rabat, koszty wysyłki, zaokrąglenia, waluta i stawki VAT
Brak dokumentu Odmowa dostępu, utrata autoryzacji API, limit lub błąd serwera
Zwrot zamówienia Zmiana kwoty i potrzeba odrębnej procedury wystawienia korekty
Status nieaktualny Opóźnienie synchronizacji albo brak ponownej próby po błędzie

Co przetestować na kopii sklepu?

  1. Zamówienie od osoby fizycznej i zamówienie od firmy, bez używania realnych danych klientów podczas testów.
  2. Jeden produkt, kilka produktów oraz pozycje z różnymi stawkami VAT.
  3. Rabat kwotowy i procentowy, koszt dostawy oraz przypadek darmowej wysyłki.
  4. Zmianę statusu zamówienia i ponowne uruchomienie synchronizacji — bez tworzenia duplikatu dokumentu.
  5. Odmowę autoryzacji i tymczasową niedostępność API, z czytelnym komunikatem o błędzie.
  6. Zamówienie anulowane lub zwrócone; ustal, czy obsługa korekty jest częścią wdrożenia, czy osobnym procesem.
  7. Sprawdzenie danych roboczego dokumentu przez sprzedawcę przed zatwierdzeniem.

Oficjalna dokumentacja API płatności Betterfly pokazuje, że system rozróżnia typy i statusy płatności. W WooCommerce również należy odróżniać zamówienie oczekujące na wpłatę od opłaconego: przydatny jest poradnik WooCommerce dotyczący statusów i problemów z zamówieniami.

Betterfly Connect: zakres, który warto sprawdzić przed zakupem

Betterfly Connect to autorska wtyczka AIOMIX pomagająca integrować WooCommerce z Comarch Betterfly w zakresie tworzenia dokumentów roboczych z zamówień i synchronizacji informacji o statusie faktury. Sprzedawca nadal weryfikuje i zatwierdza dokument w Betterfly. Opis ten nie oznacza pełnej integracji magazynów, cenników, dokumentów korekt czy wszystkich funkcji księgowych. Konto, pakiet i dostęp do API Comarch stanowią osobną usługę dostawcy.

Integracja i bezpieczeństwo zmian w sklepie

Instalację testuj poza witryną produkcyjną. Wykonaj kopię danych, sprawdź zgodność z WooCommerce HPOS oraz używanym sposobem finalizacji zakupów. Przy większym sklepie nie ograniczaj testów do pojedynczego zamówienia: zweryfikuj też obsługę błędów i ponownych prób. Pomocne będą artykuły o HPOS i Checkout Blocks oraz checklista testów QA dla wtyczek WooCommerce.

FAQ

Czy samo zainstalowanie Betterfly Connect aktywuje API Comarch?

Nie. Dostęp do publicznego API Comarch Betterfly zależy od uprawnień i warunków zewnętrznego konta, które trzeba sprawdzić u dostawcy.

Czy dokument roboczy jest już wystawioną fakturą?

Nie należy traktować tych pojęć jako równoważnych. Opisany proces pozostawia etap kontroli i zatwierdzenia w Betterfly.

Czy integracja automatycznie synchronizuje magazyn?

Nie wynika to z prezentowanego zakresu Betterfly Connect. Integracja dotyczy przygotowania dokumentu roboczego i statusu; dodatkowe procesy wymagają osobnego potwierdzenia.

Powiązane tematy
Masz konkretny projekt?

Sprawdźmy, jaki zakres strony ma sens dla Twojej firmy.

Opisz krótko, czym zajmuje się firma i czego potrzebujesz. Dobierzemy zakres bez dokładania funkcji, których nie wykorzystasz.

Zapytaj o wycenę

AIOMIX używa obecnie tylko mechanizmów technicznych potrzebnych do działania strony. Nie uruchamiamy cookies analitycznych ani reklamowych. Więcej o cookies.