Wprowadzenie
Środowisko testowe KSeF (api-test.ksef.mf.gov.pl) to sandbox Ministerstwa Finansów, w którym wysyłasz faktury w formacie FA(3) bez dotykania danych produkcyjnych. Działa na tym samym schemacie FA(3) i z tym samym cyklem statusów, więc to bezpieczne miejsce, by sprawdzić XML, uwierzytelnienie i obsługę statusów przed startem. Sandbox Notaly jest podpięty do KSeF TEST i obejmuje trzy darmowe faktury testowe.
Po co jest TEST
KSeF to krajowa platforma e-fakturowania Ministerstwa Finansów. Środowisko TEST odwzorowuje produkcyjne API: generujesz token testowy, otwierasz sesję, wysyłasz zaszyfrowaną fakturę FA(3) i odczytujesz status z UPO albo kodem odrzucenia. Ponieważ schemat jest identyczny, faktura, która przechodzi w TEST, z dużą pewnością przejdzie też w produkcji — dlatego nie warto pomijać tego kroku.
TEST a produkcja
Oba środowiska są rozdzielone: mają inne adresy i inne dane dostępowe, a faktura testowa nie ma skutku produkcyjnego ani podatkowego. Schemat FA(3) jest ten sam, więc wartość TEST nie tkwi w „danych próbnych", lecz w wyłapywaniu błędów schematu, uwierzytelnienia i obsługi statusów, zanim kosztują Cię realną fakturę klienta.
Jak testować z Notaly
Załóż konto w sandboxie — token KSeF nie jest potrzebny: sandbox wysyła faktury do KSeF TEST na danych testowych Notaly, więc w payloadzie użyj NIP sprzedawcy 2745013933. Potem wyślij fakturę testową przez POST /invoices; Notaly wygeneruje XML FA(3), zwaliduje go wobec oficjalnego XSD, uwierzytelni się w KSeF TEST i zwróci status oraz UPO przez webhook. Dostajesz trzy darmowe faktury testowe — to wystarczy, żeby potwierdzić payloady, dane NIP i obsługę webhooków od początku do końca.
Co sprawdzić przed startem
Upewnij się, że identyfikatory sprzedawcy i nabywcy oraz pozycje faktury są poprawne i że umiesz odczytać z webhooka zarówno status akceptacji (z UPO), jak i odrzucenia. Gdy przepływ testowy działa, przejdź na płatny plan i podłącz własny produkcyjny token KSeF w Connect KSeF (NIP + token); gdy produkcja zostanie uruchomiona, Notaly skieruje Twoje faktury do produkcyjnego KSeF — a sandbox zostaw na staging.
Zastrzeżenie
Notaly nie jest doradcą podatkowym, księgowym ani prawnym. Ten artykuł ma charakter informacyjny, nie stanowi porady podatkowej i może być nieaktualny. Ponosisz odpowiedzialność za własne rozliczenia VAT; w razie potrzeby skonsultuj się z wykwalifikowanym księgowym.
Źródła
Źródło: www.podatki.gov.pl