Przewodnik testów online w środowisku demo KSeF
Środowisko demo KSeF (https://ksef-demo.mf.gov.pl) to bezpieczne miejsce do testowania wszystkich funkcji systemu przed uruchomieniem produkcyjnym. UWAGA KRYTYCZNA: Nigdy nie wysyłaj testowych faktur do środowiska produkcyjnego - każda faktura tam wystawiona rodzi obowiązek podatkowy! Środowisko demo jest identyczne jak produkcja, ale dane testowe są automatycznie usuwane co 30 dni.
Kroki do wykonania
1. Zaloguj się do środowiska demo
Wejdź na https://ksef-demo.mf.gov.pl i zaloguj się używając certyfikatu KSeF, podpisu kwalifikowanego lub Profilu Zaufanego. W środowisku demo możesz używać tych samych metod uwierzytelnienia co w produkcji. Upewnij się, że deklarujesz prawidłowy kontekst (NIP Twojej firmy testowej).
2. Test 1: Wystawienie faktury w sesji interaktywnej
Wystaw pojedynczą fakturę przez interfejs webowy lub API:
- Wypełnij wszystkie wymagane pola zgodnie ze strukturą FA(3)
- Uzupełnij dane sprzedawcy i nabywcy, pozycje faktury, kwoty, VAT
Po wysłaniu zweryfikuj:
- Czy otrzymałeś numer KSeF (format: NNN-NNNNNNNNNN-NNNNNNNNNN-NN)?
- Czy otrzymałeś UPO (Urzędowe Poświadczenie Odbioru)?
- Czy UPO zawiera identyfikator faktury?
3. Test 2: Wystawienie paczki faktur w sesji wsadowej
Przygotuj paczkę 3-5 faktur testowych i wyślij je jednocześnie w sesji wsadowej. To symuluje masowe wystawianie faktur, np. na koniec miesiąca.
Sprawdź:
- Czy system prawidłowo przetwarza wszystkie faktury w paczce?
- Czy każda faktura otrzymuje osobny numer KSeF?
- Czy UPO wsadowe zawiera informacje o wszystkich fakturach?
- Czy paczka została przetworzona w ciągu kilku sekund?
4. Test 3: Pobranie faktury zakupowej
Jeśli masz dostęp do dwóch firm testowych, wystaw fakturę z jednej na drugą. Następnie zaloguj się jako nabywca i pobierz tę fakturę zakupową.
Sprawdź:
- Czy system automatycznie pokazuje faktury wystawione na Twój NIP?
- Czy możesz je wyszukiwać po dacie/numerze/kontrahencie?
- Czy możesz pobrać plik XML oraz UPO?
To kluczowy test obiegu faktury pomiędzy firmami.
5. Test 4: Wystawienie faktury korygującej
Wystaw fakturę korygującą do jednej z wcześniej wystawionych faktur. Faktura korygująca musi zawierać odniesienie do numeru KSeF faktury pierwotnej (pole FaKorygowana).
Sprawdź:
- Czy system akceptuje korektę?
- Czy numer KSeF jest przypisany?
- Czy faktura korygująca jest powiązana z oryginałem w archiwum?
Przetestuj zarówno korekty ilościowe (zmiana ilości/ceny), jak i wartościowe.
6. Test 5: Faktura dla konsumenta (bez NIP)
Wystaw fakturę dla konsumenta (osoby fizycznej nieprowadzącej działalności). W polu nabywcy nie podawaj NIP – wypełnij tylko imię, nazwisko i adres.
Sprawdź:
- Czy system akceptuje taką fakturę (od KSeF 2.0 to jest możliwe)?
- Czy otrzymujesz numer KSeF i UPO?
- Jak taka faktura jest oznaczona w systemie?
Pamiętaj: Konsument NIE zobaczy tej faktury w swoim KSeF – musisz mu ją dostarczyć inną drogą (email, papier).
7. Test 6: Faktura dla podmiotu zagranicznego
Wystaw fakturę dla kontrahenta zagranicznego (np. niemieckiej firmy). Zamiast NIP użyj numeru identyfikacji podatkowej z innego kraju UE (np. DE123456789 dla Niemiec).
Sprawdź:
- Czy KSeF akceptuje zagraniczny numer VAT?
- Czy faktura jest prawidłowo oznaczona jako transakcja międzynarodowa?
- Czy UPO zawiera wszystkie dane?
Pamiętaj: Taka faktura nie będzie widoczna dla kontrahenta w jego systemie – musisz mu ją przekazać bezpośrednio.
8. Weryfikacja wyników testów
Po zakończeniu wszystkich testów, sprawdź listę wystawionych faktur w panelu demo. Każda faktura powinna mieć:
- Numer KSeF
- Status „Zaakceptowana"
- Datę wystawienia
- UPO
Dodatkowo zweryfikuj:
- Pobierz kilka UPO i sprawdź, czy zawierają podpis elektroniczny MF
- Przetestuj wyszukiwanie faktur – po numerze KSeF, dacie, kontrahencie
Upewnij się, że wszystkie 6 scenariuszy zakończyło się sukcesem przed przejściem do testów offline.