Fakturownia API z PrestaShop i WooCommerce - od połączenia do faktury

Wybierz zakres, który chcesz uruchomić

Integracja powinna przenieść dane właściwego zamówienia do dokumentu i pozwolić sprawdzić wynik. Zacznij od jednego sklepu i jednego systemu księgowego. Dla gotowych połączeń zobacz PrestaShop z Fakturownią lub WooCommerce z Fakturownią.

Przed startem ustal, kto wystawia dokumenty obecnie. Jeżeli robi to już wtyczka lub drugi integrator, określ granicę próby i unikaj dwóch wykonawców tej samej operacji. Rodzaj dokumentu, moment wystawienia oraz stawki uzgodnij z księgowością.

Dostęp API po obu stronach

Fakturownia udostępnia interfejs do pracy z dokumentami. Jej oficjalna dokumentacja API opisuje token konta, tworzenie faktur, pobieranie dokumentów i wysyłkę e-mail. Sprawdzono 7 września 2026 r. Token znajdziesz w ustawieniach konta w części Integracja. Wprowadź go w konfiguracji połączenia; nie wklejaj go do publicznego URL-a, zrzutu ani zgłoszenia.

Dostęp po stronie sklepu sprawdź osobno. PrestaShop opisuje webservice API jako sposób dostępu z zewnętrznej aplikacji. Włączenie API i przydzielenie uprawnień nie potwierdzają jeszcze zgodności wszystkich rozszerzeń sklepu. Dla WooCommerce sprawdź klucze REST API, adres sklepu i uprawnienia wymagane przez połączenie NavyFlame.

Po podłączeniu odszukaj ustalone zamówienie w panelu. Sprawdź jego źródło, identyfikator i kwoty. Jeśli go brakuje, najpierw wyjaśnij dostęp i zakres pobierania danych, zanim skonfigurujesz dalszą automatyzację.

Dane do dokumentu: kontroluj także rabat i dostawę

Przygotuj przykład odpowiadający swojej sprzedaży. Nie ograniczaj próby do pojedynczego produktu bez dodatkowych kosztów. Poniższe liczby są fikcyjnym wzorem listy kontrolnej, nie wynikiem klienta.

Zweryfikuj walutę, stawki podatku i zaokrąglenia na swoim dokumencie. Sprawdź, czy adres faktury różni się od dostawy. Przy wariantach produktów porównaj właściwą nazwę i ilość, a nie tylko ogólną nazwę towaru.

Ustaw regułę i potwierdź rezultat

W NavyFlame przejdź do reguł fakturowania dla właściwego połączenia. Ustal warunki wystawienia, zachowanie dla B2B/B2C i wyzwalacz. Otwórz demo procesu sklepu, aby poznać widoki na danych przykładowych.

W rzeczywistej próbie zanotuj identyfikator zamówienia oraz numer dokumentu. Sprawdź jego treść również po zalogowaniu do Fakturowni. Jeżeli proces obejmuje wysyłkę e-mail lub zewnętrzne raportowanie dokumentu, odbierz te etapy oddzielnie. Status utworzenia dokumentu nie potwierdza dostarczenia ani przyjęcia przez kolejny system.

Co robić, gdy wynik jest niepewny

Przerwane połączenie może oznaczać, że nie otrzymano odpowiedzi, chociaż operacja została wykonana. Przed ponowieniem odszukaj dokument i jego powiązanie z zamówieniem. Dla błędnych danych popraw przyczynę zamiast powtarzać tę samą próbę bez zmian.

Do diagnostyki zapisz czas, identyfikator zamówienia, status i treść komunikatu pozbawioną sekretów. Jeżeli tworzysz własne oprogramowanie, potrzebujesz także obsługi powtarzających się zdarzeń, niejednoznacznych odpowiedzi, limitów API i powiązań dokumentów. Sama możliwość wykonania żądania tworzącego fakturę nie stanowi kompletnej integracji.

Próba odbiorowa przed rozszerzeniem zakresu

Sprawdź zamówienie opłacone, nieopłacone, anulowane, z rabatem, kosztem dostawy i danymi firmy. Potwierdź, że wyjątek jest widoczny i ma ustalony sposób obsługi. Zakres korekt, zwrotów i historii oceniaj jako osobne wymagania, a nie automatyczny skutek podłączenia konta.

Po takim odbiorze rozszerz zakres na kolejne zamówienia. Zapisz ustawienia oraz osobę odpowiedzialną za wyjątki. Warunki własnej próby w NavyFlame znajdziesz w aktualnej ofercie.