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?
- Zamówienie: WooCommerce zapisuje produkty, kwoty, dane nabywcy, podatki, dostawę i status płatności.
- Warunek przekazania: administrator wybiera zdarzenie, po którym dane mają trafić do systemu fakturowego. Nie każda zmiana statusu oznacza nowe zamówienie.
- Dokument roboczy: integracja przekazuje odpowiednio odwzorowane pozycje, dane kontrahenta oraz podstawowe informacje potrzebne do przygotowania dokumentu.
- Weryfikacja: sprzedawca sprawdza dokument w Betterfly i zatwierdza go zgodnie z własnym procesem księgowym.
- 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?
- Zamówienie od osoby fizycznej i zamówienie od firmy, bez używania realnych danych klientów podczas testów.
- Jeden produkt, kilka produktów oraz pozycje z różnymi stawkami VAT.
- Rabat kwotowy i procentowy, koszt dostawy oraz przypadek darmowej wysyłki.
- Zmianę statusu zamówienia i ponowne uruchomienie synchronizacji — bez tworzenia duplikatu dokumentu.
- Odmowę autoryzacji i tymczasową niedostępność API, z czytelnym komunikatem o błędzie.
- Zamówienie anulowane lub zwrócone; ustal, czy obsługa korekty jest częścią wdrożenia, czy osobnym procesem.
- 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.
