Soneta enova365 – KSeF – integracja i wdrożenie to jedna z najczęściej realizowanych przez nas usług konfiguracyjnych w ostatnim czasie. Krajowy System e-Faktur wymaga w enova365 poprawnego skonfigurowania modułu Handel oraz komunikacji z bramką KSeF – zarówno w środowisku testowym, jak i produkcyjnym.
W praktyce najwięcej problemów sprawiają: autoryzacja (token lub podpis kwalifikowany/pieczęć firmowa), ustawienia operatora usługi sieciowej oraz mapowanie pól faktury na strukturę logiczną FA(2)/FA(3). Poniżej opisujemy, jak krok po kroku wdrażamy i diagnozujemy integrację KSeF w enova365.
Na czym polega integracja enova365 z KSeF
Moduł Handel w enova365 komunikuje się z Krajowym Systemem e-Faktur poprzez dedykowany operator usługi sieciowej, który odpowiada za wysyłkę i odbiór faktur ustrukturyzowanych w formacie XML zgodnym ze schemą FA. Integracja obejmuje trzy warstwy: uwierzytelnienie w systemie KSeF, mapowanie danych z dokumentów handlowych enova365 na strukturę logiczną faktury oraz obsługę statusów przetwarzania (numer KSeF, UPO, ewentualne odrzucenia).
Konfiguracja krok po kroku
1. Autoryzacja w KSeF
W enova365 autoryzację można oprzeć na tokenie KSeF wygenerowanym w systemie testowym lub produkcyjnym Ministerstwa Finansów, albo na podpisie kwalifikowanym / pieczęci elektronicznej firmy. Sprawdzamy, czy token jest aktywny i przypisany do właściwego NIP-u oraz czy certyfikat użyty do podpisu nie utracił ważności.
2. Środowisko testowe przed produkcyjnym
Każde wdrożenie zaczynamy od środowiska demo KSeF, aby zweryfikować poprawność mapowania danych – w szczególności GTU, kodów procedur, danych kontrahenta i pozycji faktury – zanim dokumenty trafią do środowiska produkcyjnego.
3. Harmonogram wysyłki
W enova365 wysyłka do KSeF może odbywać się automatycznie (zadanie cykliczne) lub ręcznie z poziomu rejestru faktur sprzedaży. Diagnozujemy, czy zadanie automatyczne jest aktywne i czy nie jest blokowane przez brak uprawnień operatora.
Najczęstsze błędy i ich diagnostyka
- Odrzucenie faktury przez KSeF z kodem błędu walidacji schemy – sprawdzamy logi odpowiedzi i porównujemy z wymaganiami struktury FA.
- Brak połączenia z bramką KSeF – weryfikujemy dostęp do internetu, ustawienia proxy oraz certyfikat TLS używany przez stację.
- Faktura wysłana, ale brak numeru KSeF – sprawdzamy status w kolejce wysyłki i ewentualne opóźnienia po stronie systemu Ministerstwa Finansów.
- Nieprawidłowe dane kontrahenta blokujące wysyłkę – weryfikujemy uzupełnienie NIP i adresu w kartotece kontrahenta.
Co obejmuje nasza usługa
Podczas wdrożenia konfigurujemy autoryzację, testujemy wysyłkę próbnych faktur w środowisku demo, mapujemy pola specyficzne dla branży klienta (np. GTU, MPP) oraz uruchamiamy harmonogram automatycznej wysyłki. Po wdrożeniu produkcyjnym monitorujemy pierwsze partie dokumentów, aby wyłapać ewentualne odrzucenia i szybko je skorygować.
Kiedy warto zgłosić się do serwisu
Jeśli integracja KSeF w Twojej instalacji enova365 zwraca błędy walidacji, faktury nie są wysyłane automatycznie albo certyfikat wygasł i trzeba go odnowić, pomożemy zdiagnozować przyczynę i przywrócić poprawną komunikację z systemem.
