Pierwsza konfiguracja

This content is not available in your language yet.

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