Fakturownia API z PrestaShop i WooCommerce - od połączenia do faktury
Jak przygotować integrację sklepu z Fakturownią i sprawdzić dokument: dostęp API, dane zamówienia, rabat, dostawa, reguły oraz obsługa niepewnego wyniku.
30 cze 20264 min
Poradnik
Faktury z Allegro przez NavyFlame - konfiguracja i kontrola wyniku
Jak sprawdzić drogę zamówienia Allegro do Fakturowni: dane nabywcy, warunek wystawienia, dokument, błędy i dostarczenie. Praktyczna lista odbioru.
Jaki wynik chcemy uzyskać
Celem jest dokument powiązany z właściwym zamówieniem, wystawiony zgodnie z uzgodnioną regułą i widoczny w systemie księgowym. Sam status połączonego konta lub pobranie zamówienia nie wystarczają do odebrania takiego procesu.
Przykładowa ścieżka to Allegro z Fakturownią. Poniższa instrukcja pokazuje kolejność kontroli. Rodzaj dokumentu i wymagania podatkowe dla własnej sprzedaży ustal ze swoją księgowością. Nie każda sprzedaż ma ten sam sposób dokumentowania.
1. Przygotuj konta i zakres próby
Po uruchomieniu NavyFlame otwórz Integracje i podłącz Allegro przez autoryzację konta. Sprawdź, czy wybrane zostało właściwe konto sprzedawcy. Dla Fakturowni przygotuj domenę konta i token API, wprowadzany w konfiguracji połączenia.
Do pierwszej próby wybierz ustalony zakres. Spisz identyfikator zamówienia, datę, status płatności, kwoty i oczekiwany dokument. Jeżeli sprzedaż obsługuje już inny integrator, ustal, który system może wystawiać dokument dla tej próby, aby nie powstały dwa.
2. Porównaj dane zamówienia
Dokumentacja zamówień Allegro opisuje dane zamówienia i zwraca uwagę, że zdarzenia mogą wystąpić wielokrotnie. Identyfikator zamówienia jest więc istotniejszy niż liczba otrzymanych powiadomień. Źródło sprawdzono 7 września 2026 r.
W NavyFlame sprawdź konkretne zamówienie: pozycje, ilości, walutę, dostawę, dane nabywcy i żądanie faktury. Adres dostawy i dane do dokumentu mogą pełnić różne role. Nie zakładaj, że każdy brakujący lub błędny wpis zostanie automatycznie naprawiony przez integrator.
3. Ustaw warunek wystawienia
W części fakturowania wybierz reguły dla właściwej automatyzacji. Ustal, dla których zamówień ma powstać dokument i co uruchamia wystawienie, na przykład potwierdzenie płatności. Sprawdź zachowanie dla B2B oraz B2C i wybrany system księgowy.
Wysyłka do KSeF jest osobnym zakresem konfiguracji. Samo połączenie Allegro, utworzenie dokumentu czy zaznaczenie opcji nie jest potwierdzeniem przyjęcia dokumentu przez zewnętrzny system. Sprawdź ustawienia, wymagane uprawnienia i końcowy status tam, gdzie proces się wykonuje.
4. Odbierz wynik na jednym przykładzie
Poniższa tabela to przykład kontrolny na fikcyjnych wartościach, a nie rezultat wdrożenia klienta.
| Pole | Przykład wejścia | Co porównać z dokumentem |
|---|---|---|
| Produkt | 2 sztuki po 50 zł brutto | Ilość i 100 zł wartości pozycji |
| Dostawa | 10 zł brutto | Ujęcie dostawy i jej wartość |
| Razem | 110 zł brutto | Suma dokumentu i waluta |
| Nabywca | Dane z sekcji faktury zamówienia | Właściwa osoba lub firma, adres i identyfikator podatkowy |
| Powiązanie | Identyfikator zamówienia | Numer dokumentu i brak drugiego dokumentu dla tej samej próby |
Stawkę VAT i sposób zaokrągleń sprawdź zgodnie z konfiguracją sprzedaży. Następnie otwórz Fakturownię i potwierdź numer oraz dane utworzonego dokumentu. Jeżeli do procesu należy e-mail, zobacz status jego wysyłki i sprawdź odbiór na kontrolowanym adresie.
5. Oddziel utworzenie, dostarczenie i błąd
API Fakturowni opisuje tworzenie dokumentu i wysyłanie go e-mailem jako odrębne operacje. Zapis faktury nie dowodzi, że odbiorca dostał wiadomość. Dokumentacja sprawdzona 7 września 2026 r.
Przy błędzie zachowaj identyfikator zamówienia, komunikat i czas próby. Sprawdź, czy dokument nie powstał mimo przerwanego połączenia. Usuń przyczynę przed ponowieniem. Bez tej kontroli ponowne ręczne wystawienie może dodać dokument, który już istnieje.
Po udanej próbie sprawdź także zamówienie nieopłacone, anulowanie, dostawę z rabatem oraz błędne dane. Dopiero wtedy rozszerz zakres automatyzacji. W przewodniku demo poznasz widoki panelu bez podłączania kont i bez wystawiania rzeczywistych dokumentów.
Najczęściej zadawane pytania
Nie. Wystawienie dokumentu zależy od skonfigurowanej reguły, danych zamówienia i systemu księgowego. Obowiązki dokumentowania sprzedaży ustal ze swoją księgowością.
Nie. Potwierdź osobno status przetwarzania, numer dokumentu w systemie księgowym i zgodność kwot. Jeżeli proces obejmuje wysyłkę dokumentu, sprawdź również jej wynik.
Nie. Demo pokazuje panel z przykładowymi danymi. Próba na własnym koncie wymaga jego podłączenia w rzeczywistym środowisku i odpowiedniej konfiguracji.
Konfiguracja krok po kroku
Dla zestawów opisanych w tym artykule mamy rozpisaną instrukcję połączenia.
Powiązane artykuły
Jak zacząć z NavyFlame - pierwsze kroki
Krótki przewodnik dla nowych użytkowników: rejestracja, wybór planu, okres próbny, uruchomienie panelu i sprawdzenie pierwszej automatyzacji.
31 maj 20265 min
Automatyzacja faktur w e-commerce: reguły, kontrola i pomiar czasu
Jak połączyć sklep z fakturowaniem, sprawdzić dokument i zmierzyć czas obsługi? Praktyczna lista do próby na własnych zamówieniach.
26 kwi 20266 min
Sprawdź proces przed uruchomieniem
Demo korzysta z danych przykładowych. Próbę na własnych kontach zacznij dopiero po sprawdzeniu planu, karty i warunków triala.
Sprawdź aktualną ofertę