Nowe środowisko testowe
Ministerstwo Finansów uruchomiło zaktualizowane środowisko testowe KSeF w wersji 2.0, które uwzględnia format faktury FA(2) oraz poprawione API. To dobry moment, aby rozpocząć testy.
Krok po kroku
- Zarejestruj się na platformie testowej KSeF (test.ksef.mf.gov.pl)
- Wygeneruj token autoryzacyjny w środowisku testowym
- Dostosuj oprogramowanie — upewnij się, że Twój system generuje faktury w formacie FA(2)
- Wyślij testowe faktury i zweryfikuj poprawność przetwarzania
- Przetestuj odbieranie faktur zakupowych z KSeF
Najczęstsze problemy
- Błędy walidacji schematu XML — szczególnie w polach dotyczących adresów
- Problemy z kodowaniem znaków polskich
- Timeout przy dużej liczbie faktur
Nasz zespół przeprowadził już testy dla kilkudziesięciu klientów. Chętnie pomożemy i Państwu.
Dodatkowe wskazówki
Przed rozpoczęciem testów warto przygotować zestaw reprezentatywnych faktur obejmujących różne scenariusze: faktury krajowe, eksportowe, zaliczkowe i korygujące. Pozwoli to na kompleksową weryfikację poprawności integracji. Szczególną uwagę należy zwrócić na obsługę faktur korygujących zbiorczych oraz na prawidłowe mapowanie pól adresowych kontrahentów zagranicznych, które generują najwięcej błędów walidacji.
Ministerstwo Finansów udostępnia również dokumentację techniczną API oraz przykładowe pliki faktur w formacie FA(2), które mogą posłużyć jako punkt wyjścia do testów. Warto wykorzystać te materiały do budowy zestawu testowego obejmującego różne typy transakcji. Regularne monitorowanie komunikatów Ministerstwa pozwoli na bieżąco reagować na zmiany w specyfikacji technicznej. Przedsiębiorcy korzystający z zewnętrznych dostawców oprogramowania powinni upewnić się, że ich systemy są aktualizowane zgodnie z najnowszą wersją schematu.
Zalecamy również przygotowanie procedur awaryjnych na wypadek niedostępności systemu KSeF. W przypadku awarii systemu centralnego podatnik ma możliwość wystawiania faktur w trybie offline, z obowiązkiem ich późniejszego przesłania do KSeF w ciągu 7 dni od przywrócenia dostępności systemu. Procedury te powinny być znane wszystkim pracownikom odpowiedzialnym za fakturowanie w firmie.
Nasze biuro organizuje regularne warsztaty praktyczne dotyczące testowania KSeF, podczas których uczestnicy mogą pod okiem ekspertów przejść cały proces integracji krok po kroku.