Wraz z przygotowaniami do obowiązkowego KSeF pojawiło się sporo zamieszania wokół adresów systemu. Jedni testują, inni ćwiczą w demo, a część firm już szykuje się do produkcji. Żeby to uporządkować, poniżej prezentujemy komplet aktualnych adresów wszystkich środowisk Krajowy System e-Faktur, z krótkim wyjaśnieniem, do czego każde z nich służy - czyli środowisko testowe, demo i produkcyjne w jednym miejscu.
Warto to jasno podkreślić, bo to najczęstsze źródło nieporozumień: w KSeF funkcjonują trzy całkowicie oddzielne środowiska. Każde z nich ma własne adresy, własne dane i własne przeznaczenie. Faktury wysłane do jednego środowiska nie są widoczne w pozostałych.
Pierwsze to środowisko testowe, używane głównie do sprawdzania integracji technicznej i poprawności komunikacji z API. Drugie to środowisko demonstracyjne, nazywane też demo lub przedprodukcyjnym, w którym można normalnie ćwiczyć wystawianie i odbieranie faktur, ale bez skutków podatkowych. Trzecie to środowisko produkcyjne, gdzie trafiają już prawdziwe faktury działające „na żywo”.
Jeżeli po wysłaniu faktury „nie widać jej w Aplikacji Podatnika”, to niemal zawsze oznacza, że sprawdzane jest inne środowisko niż to, do którego dokument został wysłany. Dlatego przy pracy z Krajowy System e-Faktur zawsze warto upewnić się, czy jesteśmy w TE, TR czy PRD.
To środowisko jest głównie dla integratorów i programistów. Służy do sprawdzania komunikacji z API, walidacji struktur, obsługi błędów i całej technicznej strony KSeF. Faktury wysyłane tutaj nie mają żadnych skutków podatkowych.
Adresy:
To środowisko, które w praktyce interesuje większość firm i biur rachunkowych. Można tu przećwiczyć realne scenariusze: wystawianie faktur, korekty, odbieranie dokumentów kosztowych, pracę na numerach KSeF. Dane są fikcyjne, ale zachowanie systemu bardzo zbliżone do produkcji.
Adresy:
Tu trafiają już prawdziwe faktury, z pełnymi konsekwencjami podatkowymi. Każdy dokument wysłany do tego środowiska jest oficjalną e-fakturą w KSeF. To środowisko działa na docelowych danych firm i kontrahentów.
Adresy:
Aplikacja Podatnika dostępna jest osobno dla każdego środowiska. To normalne i często mylące. Jeśli nie widzisz faktur, które wysłałeś, w 90% przypadków problemem jest po prostu sprawdzanie niewłaściwego środowiska. Za utrzymanie i rozwój tych systemów odpowiada Ministerstwo Finansów, dlatego adresy i podział na środowiska są wspólne dla wszystkich programów księgowych.
W Fakturowo.pl jasno widać, z którym środowiskiem KSeF aktualnie pracujesz. Możesz testować i ćwiczyć w DEMO, a potem płynnie przejść na produkcję bez zmiany sposobu wystawiania faktur. System obsługuje wysyłkę i odbiór dokumentów, kody QR, KSeF offline oraz aktualne struktury JPK.
Autoryzację KSeF wykonasz krok po kroku na stronie:
https://www.fakturowo.pl/ksef/autoryzacja
Dzięki temu nie musisz zgadywać, „gdzie jesteś” – wszystko jest jasno oznaczone, a faktury trafiają dokładnie tam, gdzie powinny.
Pierwsze to środowisko testowe, używane głównie do sprawdzania integracji technicznej i poprawności komunikacji z API. Drugie to środowisko demonstracyjne, nazywane też demo lub przedprodukcyjnym, w którym można normalnie ćwiczyć wystawianie i odbieranie faktur, ale bez skutków podatkowych. Trzecie to środowisko produkcyjne, gdzie trafiają już prawdziwe faktury działające „na żywo”.
Jeżeli po wysłaniu faktury „nie widać jej w Aplikacji Podatnika”, to niemal zawsze oznacza, że sprawdzane jest inne środowisko niż to, do którego dokument został wysłany. Dlatego przy pracy z Krajowy System e-Faktur zawsze warto upewnić się, czy jesteśmy w TE, TR czy PRD.
| Środowisko | API | Wizualizacja kodów QR | Aplikacja Podatnika |
|---|---|---|---|
| Środowisko testowe (TE) | https://api-test.ksef.mf.gov.pl | https://qr-test.ksef.mf.gov.pl | https://ap-test.ksef.mf.gov.pl |
| Środowisko demonstracyjne / przedprodukcyjne (TR) | https://api-demo.ksef.mf.gov.pl | https://qr-demo.ksef.mf.gov.pl | https://ap-demo.ksef.mf.gov.pl |
| Środowisko produkcyjne (PRD) | https://api.ksef.mf.gov.pl | https://qr.ksef.mf.gov.pl | https://ap.ksef.mf.gov.pl |
Środowisko testowe (TE) – typowe testy techniczne
To środowisko jest głównie dla integratorów i programistów. Służy do sprawdzania komunikacji z API, walidacji struktur, obsługi błędów i całej technicznej strony KSeF. Faktury wysyłane tutaj nie mają żadnych skutków podatkowych.
Adresy:
- API: https://api-test.ksef.mf.gov.pl
- Aplikacja do wizualizacji kodów QR: https://qr-test.ksef.mf.gov.pl
- Aplikacja Podatnika: https://ap-test.ksef.mf.gov.pl
Środowisko demonstracyjne / przedprodukcyjne (TR) – ćwiczenia „jak na żywo”
To środowisko, które w praktyce interesuje większość firm i biur rachunkowych. Można tu przećwiczyć realne scenariusze: wystawianie faktur, korekty, odbieranie dokumentów kosztowych, pracę na numerach KSeF. Dane są fikcyjne, ale zachowanie systemu bardzo zbliżone do produkcji.
Adresy:
- API: https://api-demo.ksef.mf.gov.pl
- Aplikacja do wizualizacji kodów QR: https://qr-demo.ksef.mf.gov.pl
- Aplikacja Podatnika: https://ap-demo.ksef.mf.gov.pl
Środowisko produkcyjne (PRD) – realne faktury i realne skutki
Tu trafiają już prawdziwe faktury, z pełnymi konsekwencjami podatkowymi. Każdy dokument wysłany do tego środowiska jest oficjalną e-fakturą w KSeF. To środowisko działa na docelowych danych firm i kontrahentów.
Adresy:
- API: https://api.ksef.mf.gov.pl
- Aplikacja do wizualizacji kodów QR: https://qr.ksef.mf.gov.pl
- Aplikacja Podatnika: https://ap.ksef.mf.gov.pl
Aplikacja Podatnika – trzy adresy, jedno narzędzie
Aplikacja Podatnika dostępna jest osobno dla każdego środowiska. To normalne i często mylące. Jeśli nie widzisz faktur, które wysłałeś, w 90% przypadków problemem jest po prostu sprawdzanie niewłaściwego środowiska. Za utrzymanie i rozwój tych systemów odpowiada Ministerstwo Finansów, dlatego adresy i podział na środowiska są wspólne dla wszystkich programów księgowych.
Jak to wygląda w praktyce w Fakturowo.pl
W Fakturowo.pl jasno widać, z którym środowiskiem KSeF aktualnie pracujesz. Możesz testować i ćwiczyć w DEMO, a potem płynnie przejść na produkcję bez zmiany sposobu wystawiania faktur. System obsługuje wysyłkę i odbiór dokumentów, kody QR, KSeF offline oraz aktualne struktury JPK.
Autoryzację KSeF wykonasz krok po kroku na stronie:
https://www.fakturowo.pl/ksef/autoryzacja
Dzięki temu nie musisz zgadywać, „gdzie jesteś” – wszystko jest jasno oznaczone, a faktury trafiają dokładnie tam, gdzie powinny.
