Fachtura / Pomoc / Token KSeF
Jak wygenerować token KSeF
Token to „klucz”, którym Fachtura loguje się do KSeF w Twoim imieniu. Generujesz go raz, w urzędowej Aplikacji Podatnika KSeF, i wklejasz w aplikacji. Zajmuje to kilka minut.
Zanim zaczniesz
- Potrzebujesz sposobu logowania do Aplikacji Podatnika KSeF: profil zaufany, e-dowód, podpis kwalifikowany albo pieczęć kwalifikowana firmy.
- Jednoosobowa działalność: logujesz się jako właściciel firmy (Twój NIP). Spółka: osoba uprawniona do reprezentacji albo ktoś, komu nadała uprawnienia w KSeF.
- Najpierw możesz wszystko przećwiczyć na środowisku testowym MF – faktury z testu nie mają skutków podatkowych.
Krok po kroku
- Otwórz Aplikację Podatnika KSeF
Produkcja (prawdziwe faktury): ap.ksef.mf.gov.pl.
Test (ćwiczenia): ap-test.ksef.mf.gov.pl – na teście możesz zalogować się „uwierzytelnieniem testowym” dowolnym NIP-em. - Zaloguj się w kontekście swojej firmy
Wpisz NIP firmy i wybierz sposób logowania (profil zaufany, e-dowód, podpis lub pieczęć kwalifikowana).
- Przejdź do zarządzania tokenami
W menu wybierz sekcję z tokenami (np. „Tokeny” albo „Uwierzytelnianie → Tokeny”) i kliknij Generuj token. Nazwy przycisków w aplikacji MF mogą się nieznacznie różnić.
- Nadaj nazwę i uprawnienia
Nazwa np.
Fachtura – telefon. Zaznacz uprawnienia:- wystawianie faktur – potrzebne do wysyłania faktur i korekt,
- przeglądanie faktur – potrzebne do pobierania faktur z KSeF (przywracanie danych na nowym telefonie) i faktur kosztowych.
- Skopiuj token
Token pokazuje się tylko raz. Skopiuj go od razu (np. wyślij sam do siebie bezpiecznym kanałem albo wygeneruj go na telefonie i wklej od razu w Fachturze). Jeśli go zgubisz – wygenerujesz nowy.
- Wklej token w Fachturze
W aplikacji: Firma → Połączenie z KSeF. Wybierz środowisko (Produkcja albo Test MF – to samo, w którym wygenerowałeś token), wklej token, dotknij Sprawdź połączenie, a potem Zapisz.
Najczęstsze problemy
„Token KSeF nie ma potrzebnego uprawnienia” – token nie ma „przeglądania faktur” (pobieranie) albo „wystawiania faktur” (wysyłka). Wygeneruj nowy z obydwoma uprawnieniami.
Błąd logowania – sprawdź, czy NIP w Fachturze (Firma → Dane firmy) jest ten sam, w kontekście którego wygenerowałeś token, i czy środowisko się zgadza (token z testu nie działa na produkcji).
Środowisko testowe nie odpowiada – MF ma przerwy techniczne (zwykle 16:00–18:00). Spróbuj później.
Zgubiony telefon albo zmiana telefonu
- Zaloguj się do Aplikacji Podatnika KSeF i unieważnij stary token.
- Wygeneruj nowy token i wklej go w Fachturze na nowym telefonie.
- W Fachturze: Firma → Pobierz z KSeF – faktury wrócą z KSeF.