Integracja systemu ERP z KSeF — od czego zacząć

Krajowy System e-Faktur (KSeF) staje się standardem wystawiania faktur w Polsce. Firmy korzystające z systemów ERP — w tym Comarch ERP XL, Optima czy Altum — muszą zapewnić, że dokumenty sprzedaży trafiają do KSeF w sposób zgodny z prawem i bez zbędnych ręcznych czynności. Poniżej przedstawiamy praktyczne kroki, od których warto zacząć integrację.

1. Określenie zakresu i ścieżki integracji

Na wstępie warto ustalić, które dokumenty muszą trafiać do KSeF (faktury sprzedaży, korekty, faktury wewnętrzne itd.) oraz czy planujecie tylko wysyłkę do systemu, czy także odbieranie faktur zakupowych. Od tego zależy wybór ścieżki technicznej:

• Integracja natywna — rozszerzenie modułu faktur w ERP o wywołania API KSeF (np. usługa w C# / .NET wymieniająca dane z ERP i KSeF).
• Integracja przez middleware — osobna warstwa (aplikacja lub usługa) między ERP a KSeF, co ułatwia zmiany po stronie KSeF bez ingerencji w rdzeń ERP.
• Wykorzystanie gotowych modułów producenta — Comarch i inni dostawcy oferują lub będą oferować moduły do KSeF; warto sprawdzić dostępność i zakres dla swojej wersji ERP.

2. Certyfikacja i dostęp do KSeF

Aby system mógł komunikować się z KSeF, konieczna jest rejestracja w systemie oraz — w zależności od wybranej ścieżki — użycie certyfikatu kwalifikowanego lub profilu zaufanego (w środowisku produkcyjnym). W fazie testów wykorzystuje się środowisko sandbox KSeF oraz testowe certyfikaty. Warto zarezerwować czas na:

• rejestrację podmiotu w KSeF (jeśli jeszcze jej nie ma),
• konfigurację autentykacji (certyfikat, token),
• testy wysyłki i odbioru w sandbox przed przejściem na produkcję.

3. Mapowanie danych z ERP na format KSeF

Struktura e-faktury w KSeF jest zdefiniowana w ustawie i w specyfikacji technicznej (schemat XML/JSON). Dane z ERP — kontrahenci, pozycje, stawki VAT, numeracja — muszą być mapowane na ten format. Typowe kroki:

• Zdefiniowanie mapowania: które pola ERP odpowiadają którym polom struktury KSeF.
• Obsługa przypadków brzegowych: korekty, faktury zaliczkowe, różne waluty, zaokrąglenia.
• Walidacja przed wysłaniem (np. lokalnie lub w usłudze integracyjnej), żeby minimalizować odrzucenia po stronie KSeF.

4. Pierwsze faktury i monitoring

Po wdrożeniu integracji warto zacząć od ograniczonej grupy dokumentów (np. jednego rodzaju faktur lub jednego oddziału), włączyć logowanie żądań i odpowiedzi oraz monitorować statusy w KSeF. Dzięki temu szybko wychwycicie błędy mapowania lub autentykacji i dostosujecie proces przed pełnym uruchomieniem.

Integracja ERP z KSeF to inwestycja w zgodność z prawem i sprawną obsługę faktur. Dobrze zaplanowana ścieżka techniczna, certyfikacja i mapowanie danych pozwalają zakończyć projekt w kontrolowany sposób i uniknąć ostatniej chwili przed wejściem w życie obowiązku.