Proces wdrożenia
Jak działa KSEBridge – od instalacji do pierwszej wysyłki
KSEBridge to lekka warstwa integracyjna między Twoim programem fakturowym a KSeF. Zainstaluj, wklej token, wskaż folder – i gotowe. Nie musisz niczego przebudowywać ani angażować IT.
Krok po kroku
Jak przebiega cały proces?
Od pobrania instalatora do faktury z numerem KSeF – poniżej opisujemy każdy etap.
Instalacja i pierwsze uruchomienie
Pobierasz jeden plik instalatora (KSEBridge_Setup.exe), uruchamiasz go i po kilkudziesięciu sekundach aplikacja jest gotowa. Dane konfiguracyjne i baza faktur trafiają do %AppData%\KsefIntegrator – nic nie musisz konfigurować w systemie ani w serwerze.
Konfiguracja środowiska i tokena KSeF
W ustawieniach wybierasz środowisko (TEST lub PRODUKCJA) i wklejasz token KSeF. Token generujesz raz w portalu podatnika MF – cały proces trwa 5 minut. Wskaźnik w nagłówku aplikacji od razu potwierdza, czy połączenie z KSeF działa.
Wskazanie folderu z fakturami (Watch Folder)
Podajesz ścieżkę do folderu, do którego Twój program księgowy lub ERP eksportuje pliki XML albo PDF. KSEBridge automatycznie wykrywa nowe pliki i dodaje je do kolejki przetwarzania. Możesz też kliknąć „Skanuj / Importuj" i wskazać pliki ręcznie.
Walidacja przed wysyłką
Każda faktura jest walidowana wg schematu XSD Ministerstwa Finansów oraz logicznie (spójność VAT, format NIP, daty, sumy). Błędy są pokazywane z dokładnym wskazaniem wiersza, kolumny i ścieżki XPath – zanim cokolwiek trafi do KSeF. Dokumenty z błędami nie są wysyłane automatycznie, co chroni Cię przed odrzutami.
Wysyłka do KSeF i odbiór numeru
Dokumenty po walidacji trafiają kolejno do oficjalnego API KSeF MF. Po akceptacji faktura otrzymuje unikalny numer KSeF widoczny od razu w tabeli głównej. W nagłówku aplikacji kolorowe wskaźniki pokazują stan API, Worker i połączenie KSeF w czasie rzeczywistym.
Historia, audyt i faktury zakupowe
Każda operacja jest zapisywana w lokalnej bazie wraz z pełnym logiem zdarzeń. Zakładka „Historia operacji" pozwala odtworzyć dokładny przebieg każdej faktury. Zakładka „Faktury zakupowe" automatycznie pobiera z KSeF dokumenty od Twoich dostawców – możesz je filtrować, drukować i eksportować do PDF.
Skąd pobierać faktury?
Obsługiwane źródła i formaty
KSEBridge akceptuje dokumenty z wielu źródeł – bez zmiany Twojego obecnego systemu.
Folder Watch (automatyczny)
Wskazujesz katalog, do którego Twój system eksportuje pliki. KSEBridge monitoruje go w tle i automatycznie importuje każdy nowy plik XML lub PDF.
XML FA(3) – bezpośrednio
Pliki XML w formacie FA(3) MF są importowane bez konwersji. Walidacja XSD odbywa się na lokalnym schemacie – błąd widzisz przed wysyłką, nie po.
PDF z weryfikacją manualną
System konwertuje PDF do FA(3). Faktury oznaczone „Wymaga weryfikacji" możesz sprawdzić w podglądzie i zatwierdzić zaznaczeniem checkboxa przed wysyłką.
Import z Comarch Optima / CSV
Dedykowane mapowanie pól z Comarch Optima i importu CSV. Możliwość konfiguracji własnych reguł mapowania bez edytowania kodu.
Ręczne wystawienie faktury
Zakładka „Wystaw fakturę" pozwala wpisać lub wybrać dane nabywcy, pozycje, stawki VAT, formę płatności i wystawić fakturę bezpośrednio do KSeF bez żadnego pliku.
Korekty i zwroty
W zakładce „Moje faktury z KSeF" zaznaczasz fakturę i klikasz „Korekta do zera" lub tworzysz korektę częściową – KSEBridge generuje poprawny FA(3) z typem KOR/KOR_ZAL/KOR_ROZ.
Monitoring w czasie rzeczywistym
Jak śledzić status faktur?
KSEBridge pokazuje stan każdej faktury i całego połączenia z KSeF bez konieczności odświeżania stron ani logowania do portalu MF.
Wskaźniki w nagłówku aplikacji
Kolory wierszy w tabeli faktur
FAQ
Najczęściej zadawane pytania
Czy muszę zmieniać swój program fakturowy?
Nie. KSEBridge działa jako osobna aplikacja. Wystarczy, że Twój program eksportuje faktury do folderu w dowolnym formacie (XML FA(3) lub PDF). KSEBridge zajmie się resztą – walidacją, konwersją i wysyłką do KSeF.
Jak długo trwa wdrożenie?
Instalacja i pierwsze testy zajmują ok. 15–30 minut. Na środowisku testowym możesz wysyłać faktury bez limitu i bez opłat – po weryfikacji procesu przełączasz się na PRODUKCJĘ jednym kliknięciem w ustawieniach.
Co się dzieje, gdy KSeF odrzuci fakturę?
Wiersz w tabeli zmienia kolor na czerwony, a w kolumnie „Błąd" pojawia się pełny komunikat z KSeF. W panelu szczegółów możesz podejrzeć XML, poprawić błąd i kliknąć „Wyślij ponownie" – bez żadnego ręcznego eksportu.
Jak przejść ze środowiska testowego na produkcyjne?
Ustawienia → Środowisko KSeF → PRODUKCJA → wklej token produkcyjny → Zapisz. Aplikacja wymaga restartu. Po uruchomieniu plakietka w nagłówku zmienia się na czerwoną ramkę „PRODUKCJA".
Gdzie są przechowywane moje dane?
Wszystkie faktury i logi trafiają wyłącznie do lokalnej bazy SQLite na Twoim komputerze (%AppData%\KsefIntegrator) oraz do oficjalnego API KSeF MF. Do serwisu licencji KSEBridge wysyłane są wyłącznie anonimowe identyfikatory sesji – bez treści faktur.
Co zrobić, gdy coś nie działa i potrzebuję wsparcia?
W ustawieniach aplikacji kliknij „Eksport paczki diagnostycznej" – zostanie wygenerowany plik ZIP z logami i konfiguracją (bez danych wrażliwych). Prześlij go na admin@ksebridge.pl – odpiszemy w ciągu 24 godzin.
Gotowy, żeby spróbować?
30 dni testów i 300 faktur bez opłat. Żadnej karty kredytowej, żadnej umowy. Zaczynasz od razu po rejestracji.