Testowanie integracji CONREGO z KSeF (środowisko testowe)
Ten poradnik wyjaśnia, jak przetestować integrację systemu CONREGO z Krajowym Systemem e-Faktur (KSeF), czyli jak sprawdzić wystawianie faktur w CONREGO w taki sposób, aby pojawiały się one również w KSeF - bez użycia prawdziwych danych i bez skutków prawnych.
Instrukcja dotyczy wyłącznie środowiska testowego KSeF.
Krok 1. Wejście do środowiska testowego KSeF
Wejdź na stronę środowiska testowego KSeF: https://ap-test.ksef.mf.gov.pl/web//
Następnie wybierz: Logowanie → Uwierzytelnij się w Krajowym Systemie e-Faktur
Krok 2. Potwierdzenie pracy w środowisku testowym
Zaznacz wymagane oświadczenie.
W środowisku testowym zawsze używaj wyłącznie fikcyjnych, zanonimizowanych danych (np. testowych numerów NIP, nazw firm, danych adresowych)
Krok 3. Wybór metody logowania
Wybierz pierwszą opcję: „Zaloguj się uwierzytelnieniem testowym”
To najprostszy sposób logowania do środowiska testowego KSeF.
Krok 4. Logowanie do KSeF (dane testowe)
Wprowadź dane do logowania - może to być:
- właściwy dla Twojej działalności numer NIP,
- lub fikcyjny NIP, na przykład wygenerowany za pomocą strony https://generuj.co.pl/.
W CONREGO sekcji Dane sprzedawcy upewnij się, że numer NIP jest identyczny jak ten użyty podczas logowania do testowego KSeF i generowania tokena.
To warunek konieczny poprawnego działania integracji.
Krok 5. Generowanie tokena dostępowego w KSeF
Po zalogowaniu przejdź do:
Tokeny → Generuj token
- Wpisz nazwę tokena (np. „CONREGO test”)
- Zaznacz uprawnienia:
- wystawianie faktur
- przeglądanie faktur
- Kliknij Generuj token
Krok 6. Skopiowanie tokena
Skopiuj wygenerowany token i zapisz go w bezpiecznym miejscu.
Bardzo ważne
- Token można skopiować tylko jeden raz.
- Po zamknięciu okna nie będzie możliwości jego ponownego odczytania.
- Token będzie potrzebny do integracji z CONREGO.
Krok 7. Konfiguracja KSeF w CONREGO
Przejdź do panelu administracyjnego CONREGO i otwórz: Konfiguracja → Integracje → Integruj fakturowanie
- Wybierz jedną integrację fakturowania - KSeF.
- Wklej wygenerowany token KSeF
- Wybierz środowisko testowe
- Zapisz zmiany
Krok 8. Efekt integracji - co się zmienia?
Od tego momentu:
- każda faktura końcowa i faktura korygująca wystawiona w CONREGO będzie automatycznie widoczna również w środowisku testowym KSeF,
- na każdej fakturze wystawionej w CONREGO pojawi się numer KSeF przypisany do dokumentu.
Ważna informacja o środowisku testowym KSeF
Jeśli użyjesz prostych, przykładowych numerów NIP (np. 1111111111, 2222222222), pamiętaj, że:
- z tych samych danych mogli korzystać inni użytkownicy,
- w środowisku testowym możesz widzieć obce testowe faktury oraz tokeny.
Jest to normalne zachowanie środowiska testowego i nie oznacza błędu integracji.