Wszystkie artykuły
    Poradnik10 kwietnia 20266 min

    Jak wysyłać faktury do KSeF hurtowo — przewodnik krok po kroku

    Zespół FakturaFlowPraktycy automatyzacji KSeF dla biur rachunkowych w Polsce.

    Biura rachunkowe obsługujące dziesiątki klientów VAT stoją przed tym samym wyzwaniem: jak przesłać setki faktur do KSeF bez ręcznego klikania? Odpowiedź leży w automatyzacji — zbiorczym parsowaniu, paczkowaniu i wysyłce z jednego interfejsu.

    Dlaczego ręczna wysyłka nie skaluje się?

    Portal KSeF Ministerstwa Finansów pozwala wysłać pojedynczą fakturę XML lub niewielką paczkę. Dla biura rachunkowego, które co miesiąc procesuje 500–2 000 faktur od różnych klientów, logowanie się osobno dla każdego klienta i wgrywanie plików ręcznie zajmuje wiele godzin roboczo-godzin — a każda pomyłka oznacza ryzyko kary.

    Krok 1 — Zbierz tokeny KSeF od klientów

    Token KSeF to ciąg znaków, który klient generuje w Portalu Podatnika na stronie ksef.mf.gov.pl. Token pozwala Twojemu biuru wysyłać faktury w imieniu klienta bez konieczności podawania jego hasła. Każdy token jest powiązany z konkretnym NIP-em i zakresem uprawnień (np. tylko wysyłka lub pełny dostęp).

    W FakturaFlow wystarczy wkleić token raz w ustawieniach klienta — system szyfruje go i przechowuje bezpiecznie, gotowy do użycia przy każdej wysyłce.

    Krok 2 — Wgraj faktury jako PDF lub Excel

    Większość klientów biur rachunkowych nie wystawia faktur w systemie biura — dostarcza je jako skany PDF lub pliki Excel. FakturaFlow posiada wbudowany parser, który:

    • odczytuje dane z PDF (numer faktury, data, NIP nabywcy i wystawcy, pozycje, wartości),
    • importuje wiersze z Excela jako pozycje faktury,
    • automatycznie przypisuje fakturę do klienta w bazie na podstawie NIP.

    Jeśli parser nie rozpozna jakiegoś pola, faktura trafia do kolejki "do weryfikacji" — możesz ją uzupełnić ręcznie przed wysyłką.

    Krok 3 — Utwórz wysyłkę zbiorczą

    Po zweryfikowaniu faktur tworzysz "wysyłkę" — grupę faktur dla wybranego klienta, które mają trafić do KSeF razem. Możesz objąć jedną wysyłką faktury z całego miesiąca. System:

    1. konwertuje każdą fakturę do formatu XML FA(3),
    2. otwiera sesję wysyłki w API KSeF i przesyła faktury jedna po drugiej,
    3. uwierzytelnia sesję tokenem klienta (lub certyfikatem KSeF od lutego 2026 r.),
    4. czeka na potwierdzenie i pobiera UPO automatycznie.

    Krok 4 — Pobierz UPO i zarchiwizuj

    Urzędowe Poświadczenie Odbioru (UPO) to dokument XML, który KSeF zwraca po poprawnym przyjęciu paczki faktur. Zawiera numery referencyjne KSeF dla każdej faktury — są one dowodem, że faktura dotarła do systemu i jest prawnie skuteczna.

    W FakturaFlow UPO jest dostępne do pobrania na stronie wysyłki od razu po zakończeniu przetwarzania. Otrzymasz też email z potwierdzeniem — przydatny, gdy chcesz automatycznie archiwizować potwierdzenia.

    Ile czasu zajmuje cały proces?

    Dla doświadczonego użytkownika obsługa 50 faktur od jednego klienta zajmuje:

    • ~5 minut — wgranie plików PDF/Excel i weryfikacja parsowania,
    • ~1 minuta — utworzenie wysyłki i kliknięcie "Wyślij",
    • ~2–3 minuty — oczekiwanie na UPO od KSeF (czas zależy od obciążenia systemu MF).

    Łącznie: poniżej 10 minut zamiast godziny przy ręcznym procesowaniu.

    Najczęstsze błędy i jak ich unikać

    • Wygaśnięty token KSeF. Tokeny mają datę ważności. FakturaFlow wyświetla ostrzeżenie, gdy token klienta wygaśnie w ciągu 30 dni — warto poprosić klienta o jego odnowienie z wyprzedzeniem.
    • Nieprawidłowy NIP. NIP musi mieć dokładnie 10 cyfr bez myślników i spacji. Walidacja odbywa się przed wysyłką — błędny NIP jest flagowany od razu.
    • Brak wymaganych pól FA(3). Schemat FA(3) wymaga m.in. kodu waluty, stawki VAT dla każdej pozycji i daty sprzedaży. Parser stara się te pola wypełnić automatycznie, ale warto sprawdzić faktury przed wysyłką.

    Podsumowanie

    Hurtowa wysyłka faktur do KSeF to nie czarna magia — to kwestia właściwych narzędzi i dobrze ułożonego procesu. Zacznij od pilotażu z jednym klientem, sprawdź, czy UPO wraca poprawnie, a potem skaluj na całą bazę. Im wcześniej biuro opanuje ten proces, tym mniej stresu przy kontrolach skarbowych i zapytaniach od klientów.

    Wypróbuj za darmo

    Sprawdź swoją fakturę, zanim odrzuci ją KSeF

    Wgraj XML faktury w walidatorze FakturaFlow i zobacz konkretne błędy zanim plik trafi do Krajowego Systemu e-Faktur. Bez konta, bez instalacji, pliki nie opuszczają Twojej przeglądarki.

    Walidator XML FA(3) · Konwerter PDF → XML · 3 użycia dziennie za darmo