Wprowadzenie
Integrację z KSeF testujesz w środowisku testowym (api-test.ksef.mf.gov.pl), gdzie każde zgłoszenie nie ma skutku prawnego ani podatkowego. Sandbox Notaly wysyła dokumenty do TEST KSeF z użyciem testowych poświadczeń platformy i daje Ci trzy darmowe faktury testowe, dzięki czemu sprawdzisz XML FA(3) i cały przepływ, zanim w ogóle zbliżysz się do produkcji.
Po co najpierw testować
KSeF (Krajowy System e-Faktur) to krajowa platforma e-fakturowania prowadzona przez Ministerstwo Finansów. Faktura produkcyjna jest dokumentem prawnym, więc pomyłka bywa kosztowna do odwrócenia. Środowisko testowe istnieje po to, żebyś mógł popełniać te błędy bezpiecznie: API ma ten sam kształt, schemat FA(3) jest ten sam, ale wynik nie ma skutku podatkowego i nigdy nie trafia do prawdziwego nabywcy ani do urzędu.
Co daje sandbox
Sandbox Notaly zdejmuje z Ciebie koszt pierwszego testu KSeF. Uwierzytelnia się testowymi poświadczeniami platformy, więc na start nie potrzebujesz tokenu produkcyjnego. Dostajesz trzy darmowe faktury testowe w TEST KSeF; platforma używa stałego testowego NIP sprzedawcy (2745013933) dla wysyłanych dokumentów, dzięki czemu Twoje dane testowe są odseparowane od jakiegokolwiek prawdziwego rejestru podatnika.
Kontrole do wykonania
Przejdź przez cały przepływ od końca do końca — to właśnie tam wychodzą błędy integracji:
- Poprawność XML. Upewnij się, że dokument FA(3) generowany przez Twój kod przechodzi walidację względem oficjalnego XSD, zanim zostanie wysłany.
- Wysłanie. Wyślij fakturę i potwierdź, że wchodzi w stan wysłana, zamiast odpaść na lokalnej walidacji (422 to walidacja po stronie Notaly, a nie odpowiedź KSeF).
- Akceptacja. Sprawdź wynik: zaakceptowana faktura zwraca numer KSeF i UPO (urzędowe poświadczenie odbioru).
- Webhooki. Zweryfikuj, że Twój endpoint odbiera podpisane zdarzenie i że adres PDF przychodzi w zdarzeniu invoice.accepted.
- Błędy. Wyślij celowo jeden wadliwy dokument i potwierdź, że błąd jest pokazywany w sposób, na który możesz zareagować.
TEST a produkcja
Sandbox to nie podgląd Twojej produkcyjnej tożsamości. Gdy przechodzisz na produkcję, podłączasz własny token KSeF w Connect KSeF, a na fakturach pojawia się Twój prawdziwy NIP sprzedawcy. Trzy darmowe faktury sandboxowe to jazda próbna, a nie rabat na wolumen produkcyjny.
FAQ
Czy środowisko testowe KSeF ma jakikolwiek skutek prawny? Nie. Dokumenty wysłane do środowiska TEST nie są prawdziwymi fakturami i nie niosą żadnych skutków podatkowych ani prawnych.
Ile faktur testowych mogę wysłać w sandboxie Notaly? Trzy. Plan sandbox obejmuje trzy darmowe faktury testowe w środowisku TEST KSeF.
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