Pierwsza konfiguracja

Po zainstalowaniu BizFlow NH wykonaj poniższe kroki, aby wysłać pierwszą fakturę testową do KSeF.

Checklist

Zmień hasło administratora

Zaloguj się danymi domyślnymi (admin@bizflownh.dev / Admin123!), a następnie natychmiast zmień hasło w ustawieniach profilu.
Dodaj firmę i skonfiguruj połączenie z SAP

Przejdź do Ustawienia —> Organizacja, kliknij Dodaj firmę. Konfiguracja firmy składa się z trzech zakładek:
- Dane firmy — nazwa, NIP, adres, kod pocztowy, miasto, kraj, email kontaktowy
- Połączenie SAP — Service Layer URL, baza danych, typ bazy (HANA/MSSQL), użytkownik, hasło + przycisk Testuj połączenie. Osobna sekcja: bezpośrednie połączenie do bazy danych (connection string, użytkownik, hasło) — używane przez profile mapowania z typem źródła danych SQL
- Integracja KSeF — przełącznik AutoSend, Webhook URL, środowisko KSeF, certyfikaty/enrollment/token, status sesji, test połączenia KSeF
W zakładce Połączenie SAP wypełnij adres Service Layer, nazwę bazy danych, użytkownika i hasło, a następnie kliknij Testuj połączenie — powinien pojawić się zielony status.
Wgraj lub zarejestruj certyfikat KSeF

Przejdź do zakładki Integracja KSeF i:
- Wgraj plik PFX z hasłem (certyfikat pobrany z portalu KSeF), lub
- Uruchom proces enrollment (automatyczne wygenerowanie i rejestracja certyfikatu), lub
- Wprowadź token ręcznie (alternatywa do szybkich testów)
Zaimportuj lub utwórz profil mapowania

Przejdź do Ustawienia —> Profile mapowania i:
- Zaimportuj gotowy profil JSON (np. OINV_FA3_SERVICE_LAYER_FULL.json), lub
- Utwórz nowy profil od zera
Wyślij fakturę testową

Przejdź do SAP —> Faktury sprzedaży w sidebar dashboardu:
- Ustaw zakres dat i kliknij wyszukaj
- Znajdź fakturę na liście i kliknij w nią, aby otworzyć szczegóły
- Kliknij przycisk Wyślij do KSeF (widoczny gdy AutoSend jest wyłączony)
- Obserwuj zmianę statusu: badge zmienia się z Sending na Sent, a następnie na Accepted
Alternatywnie, możesz przetestować mapowanie bez wysyłki: przejdź do Ustawienia —> Profile mapowania —> [profil] —> zakładka XML Preview, wprowadź DocEntry i sprawdź wygenerowany XML.
Zweryfikuj w portalu KSeF

Po wysłaniu faktura otrzyma status Accepted i numer KSeF. Możesz zweryfikować ją w portalu:
- Test: https://ksef-test.mf.gov.pl
- Demo: https://ksef-demo.mf.gov.pl
- Produkcja: https://ksef.mf.gov.pl

Najczęstsze problemy na starcie

Problem	Rozwiązanie
Błąd połączenia z SAP	Sprawdź czy Service Layer działa i jest dostępny z serwera BizFlow NH
Certyfikat odrzucony	Upewnij się, że certyfikat jest dla właściwego środowiska (test/demo/prod) i NIPu
Faktura odrzucona przez KSeF	Sprawdź XML w podglądzie — najczęściej brakujący NIP lub błędna stawka VAT
Brak danych w podglądzie	Sprawdź źródła danych w profilu mapowania — zapytanie SQL lub OData może być błędne