Krajowy system e-Faktur

Jest już wreszcie dostępna publicznie treść drugiej mojej interpelacji:
https://www.sejm.gov.pl/Sejm10.nsf/InterpelacjaTresc.xsp?key=DQ2BEG&view=S

Dopiero dziś niestety przesłana do MF (czyli odpowiedź do 26 stycznia).

Jednocześnie 30.12 pojawiła się odpowiedź do poprzedniej, ale na ten moment treść jeszcze nie jest opublikowana. Niemniej w środa prawdopodobnie będzie omawiana na posiedzeniu komisji Gospodarki i Rozwoju.

EDIT: JEst już odpowiedź: https://www.sejm.gov.pl/Sejm10.nsf/InterpelacjaTresc.xsp?key=DQ2DFV&view=S
DRAMAT! Podają bzdury, że faktury offline są po to, żeby wystawiać potwierdzenia transakcji, że wszytko jest opisane odnośnie IdWew, że wszystko jest cacy i w ogóle.

Moje komentarze do odpowiedzi

Odpowiedź na pytanie 4: MF twierdzi, że faktury w trybie offline24 wystawia się po to, żeby... nie dawać faktury tylko potwierdzenie transakcji. Dla mnie to zaprzeczenie sensu, bo potwierdzenie mogę wydać równie dobrze do faktury niewysłanej (tak ono działa).

Odpowiedź na pytanie nr 5: Jest totalnie niezgodna z prawdą - w dokumentacji technicznej nie ma żadnych reguł opisujących stosowanie IdWew, żadnej możliwości generowania i uniemożliwia w praktyce z poziomu programów jakiekolwiek sterowanie tym. Tymczasem MF pisze, że w podręczniku jest. Absolutna bzdura i nieznajomość własnych dokumentacji!

Odpowiedź na pytanie nr 6: przyznam, że chwycili za słówko "przetestować" i uczepili się tego, ignorując zupełnie, że absolutnie nikt nie ma możliwości wcześniej ani wykonania z oprogramowania zewnętrznego tego, co da się wykonać wyłącznie przez MCU, jak i nie ma możliwości sprawdzić, czy w ogóle jego oprogramowanie będzie się w stanie poprawnie zalogować na środowisko produkcyjne. Niestety, ale środowisko przedprodukcyjne niekoniecznie musi oddać realia, z jakimi przyjdzie się zmierzyć 1.02.

Odpowiedź na pytanie nr 7: Ponowne nierozumienie tematu. Scenariusz 1: Jeśli KSeF ulegnie awarii, a nie internet to jak osoba, która nie korzysta z oprogramowania może wystawić fakturę offline, skoro aplikacja jej tego uniemożliwi? A może każda awaria API ma wymusić awarię Aplikacji Podatnika?! Scenariusz 2: Jeśli u przedsiębiorcy ulega awarii oprogramowanie tak, iż nie jest w stanie on dokonać przesłania (przyczyn mogą być dziesiątki), to znaczy, że pomimo posiadania w tymże systemie faktury i możliwości eksportu XML, nie może on tego przesłać do KSeF. Raz jeszcze: pomimo działania KSeF i działania np. telefonu komórkowego z dostępem do internetu. MF w tej odpowiedzi totalnie nie dostrzega rzeczywistości.

Odpowiedź na pytanie nr 8: Tu trzeba by się odnieść do opisu sytuacji, która niestety nie znalazła się wprost w treści interpelacji, a dotyczy sytuacji, w których wykonanie korekty technicznej jest niemożliwe (np. przekroczenie dozwolonego rozmiaru wymaga zmiany treści faktury (skrócenia przykładowo opisów), czego zgodnie z wytycznymi zrobić nie można.

Odpowiedź na pytanie nr 9: Ten temat jest praktycznie non stop poruszany przez licznych integratorów - brak możliwości zakładania kont dla programów, a nie osób, sprawia, że konkretna osoba musi brać odpowiedzialność za działanie zupełnie autonomicznego i niezależnego programu, a konieczność odcięcia dostępu programowi musi oznaczać też pozbawienie tej osoby dostępu do KSeF, co jest zupełnie nielogicznym działaniem. W ten sposób wszelkie oprogramowanie zyskuje absolutnie zbyt szerokie uprawnienia i niejako wymusza utrzymywanie dostępu dla siebie, co może być łakomym kąskiem dla oszustów i cyberprzestępców.

Odpowiedź na pytanie nr 10: O ile mi wiadomo, to zadaniem KAS jest m.in. kontrola poprawności rozliczeń zgodnie z obowiązującą ustawą, a ta wciąż nakazuje rozliczanie się miesięczne. Skąd więc odpowiedź, że KAS wymaga teraz dziennej kontroli?! Natomiast to, kiedy będzie faktura udostępniona nabywcy to już zmartwienie przedsiębiorcy, a nie ministerstwa. Argument zupełnie absurdalny, szczególnie w kontekście tym, że API potrafi... nie dostarczać natychmiast faktury. Co więcej, MF ponownie ignoruje rzeczywistość, w której ktoś może być pozbawiony dostępu do internetu dłużej, niż 1 dzień.

Odpowiedź na pytanie nr 11: Jak czytamy, "KSeF wykorzystuje kwalifikowane wektory tożsamości (...) co pozwala jednoznacznie ustalić
tożsamość osoby lub podmiotu uwierzytelniającego się w systemie". Jest tylko jeden problem - poprzez API czy Aplikację Podatnika te dane nie są dostępne! I MF zupełnie zignorowało ten aspekt pytania.

Odpowiedź na pytanie nr 13 i 14: Czytamy, że "Prace techniczne przebiegają zgodnie z harmonogramem". Nie, prace w ogóle nie przebiegają zgodnie z harmonogramem, który zakładał 30 września udostępnienie działającego API. Tymczasem do 22 grudnia było ono wciąż zmienianie, a po dziś dzień występują problemy w działaniu. Więc jak można to nazywać zgodnością z harmonogramem? Wyprzedzenie, z jakim udostępniane sa narzędzia" absolutnie nie jest wystarczające do realnego wdrożenia i szkolenia przedsiębiorców w obsłudze KSeF z użyciem nie tylko narzędzi MF, ale także oprogramowania dostawców.

"Duzi" przedsiębiorcy rozsyłają do swoich dostawców pisma o KSeF, są tam różne wymagania.
Już się do tego przyzwyczaiłem, ale dziś dostałem zaskakujące pismo, w którym jedno z tych przedsiębiorstw napisało do wszystkich swoich dostawców, że od 1 lutego przestaje akceptować faktury PDF i papierowe. Jedyną fakturami, które będą od tego dnia akceptować, są te przesłane do KSeF (!).
Ciekawe, czy mając status "małego" przedsiębiorcy można "niezobowiązująco" wysłać w lutym i marcu kilka faktur do KSeF, a resztę - po staremu, poza KSeF?

Przez formularz kontaktowy jeszcze wysłałem zapytanie o treści:

W związku z odpowiedzią MF na interpelację nr 14035 dot. pytania nr 11, która brzmi: "W zakresie zapewnienia pełnej identyfikowalności źródła przesłania faktury informujemy, że KSeF wykorzystuje kwalifikowane wektory tożsamości (...), co pozwala jednoznacznie ustalić tożsamość osoby lub podmiotu uwierzytelniającego się w systemie. W przypadku korzystania z tokena KSeF lub certyfikatu KSeF – które są generowane bezpośrednio w systemie i przypisane do konkretnego identyfikatora (NIP/ PESEL/ Odcisk palca certyfikatu) – identyfikacja również jest pełna i jednoznaczna. Dzięki temu KSeF zapewnia kompletną rozliczalność operacji oraz możliwość ustalenia, kto wykonał dane działanie, w tym przesłał fakturę do systemu."
Proszę o wskazanie sposobu pozyskania takiej informacji z API i Aplikacji Podatnika w odniesieniu do wysłanych faktur.

Jestem ciekaw, ile podziękowań i zapewnień o analizie dostanę :)

Zachęcam zainteresowanych do zadawania podobnych pytań! :)

Dzień dobry koleżanki i koledzy. Czy działa wam może pobieranie "challenge" z produkcji?

% curl -X POST "https://ksef.mf.gov.pl/api/v2/auth/challenge" -H "Accept: application/json" -H "Content-Type: application/json" -H "Content-Length: 0"                                                 
{"exception":{"serviceCtx":"srvPRMFB","serviceCode":"C50318AC-5FBA-4B61-A4B5-0FC44B6BEC80","serviceName":"exception.handler","timestamp":"2026-01-05T14:02:55.393Z","exceptionDetailList":[{"exceptionCode":21180,"exceptionDescription":"Nieprawidłowe żądanie."}]}}

% curl -X POST "https://ksef-demo.mf.gov.pl/api/v2/auth/challenge" -H "Accept: application/json" -H "Content-Type: application/json" -H "Content-Length: 0"
{"challenge":"20260105-CR-3040E28000-0747A268A5-F0","timestamp":"2026-01-05T14:03:17.4165409+00:00","timestampMs":1767621797416}

Czy ja czegoś (oprócz tego, że błąd 21180 jest nieudokumentowany?) nie rozumiem?

No i drugie pytanie - jak w kontekście tego:

https://ksef.podatki.gov.pl/komunikaty-techniczne/zmiana-adresow-srodowisk-ksef-komunikat-dla-integratorow/

w szczególności:

15.12.2025 - udostępnienie nowych adresów (okres przejściowy)
Udostępnienie aktywnych adresów dla środowisk testowych oraz dla środowiska produkcyjnego.

rozumieć należy:

% nslookup
> server 8.8.8.8
Default server: 8.8.8.8
Address: 8.8.8.8#53
> api.ksef.mf.gov.pl
Server:		8.8.8.8
Address:	8.8.8.8#53

** server can't find api.ksef.mf.gov.pl: NXDOMAIN
> 

Tak się zastanawiam, czy w ogóle określanie kiedykolwiek parametru offlineMode na true ma sens ?

Załóżmy, że coś nie działa , daje klientowi fakturę z dwoma kodami qr, potem wysyłam tę fakturę za godzinę na przykład. Nie określam żadnego offlineMode. Faktura jest przyjęta i potem jak miałbym generować znowu wizualizację to juz jeden QRcode z numerem..

To samo jak wysyłam normalnie fakturę ale KSEF zamula, klient chce papier bo nie ma czasu. Daje mu (2 kody QR). Po pol godziny faktura przetworzona, ja wysłałem ja w trybie online a to ze zamulało to nie moja wina przecież wiec ona jest jako online w ksef

Jeśli wysyłka jest +1 od daty wystawienia to oni i tak ustawiają offineMode na true.. pytanie co to tak naprawdę zmienia ten tryb w praktyce?

Pomijając sytuacje ze coś nie działa a klient nie stoi Ci nad głową.. to wysyłasz fakturę jak już będzie działać i tyle.. wtedy w ogóle nie ma co się przejmować tym trybem.

Jakby ktoś chciał taką poszerzoną analizę dot. tego, co się dzieje z KSeF i odnoszącą się do moich interpelacji: https://www.dzyszla.pl/blog-1767695345.html

 "status": 400,
 "statusText": "OK",
 "ok": false,

https://github.com/CIRFMF/ksef-docs/issues/528

Ten system to mem ;)

Inne pytanie - bazowy URL zwraca "health status". Czy jest on gdziekolwiek udokumentowany i tylko nie umiem znaleźć? Czy to tylko po prostu tak sobie tam jest, ale nic nie znaczy?

Zapraszamy do testów: www.ksefservice.pl

W chwili obecnej działa już wystawianie faktur VAT oraz generowanie FA(3), a także generowanie PDF na podstawie plików FA(3).xml, moduł księgowości oraz generowanie JPK_V7M na podstawie pobranych faktur z KSeF.

Trwają intensywne prace nad systemem uprawnień dostępowych oraz kreatorem JPK dla modułu księgowości (narzędzie dla księgowych obejmujące bazę klientów oraz generowanie JPK na podstawie faktur zakupu i sprzedaży klienta pobranych z KSeF). Pozostałe funkcje są już testowane i stabilizowane, w tym moduły wsadowy oraz interaktywny API, które działa w pełni.

W module pobierania faktur z KSeF dodano obsługę korekt faktur już zgłoszonych do KSeF.
Poprawki zostały również wdrożone do kodów QR API.

Nie udzielałem się do tej pory, ale od dawna czytam ten wątek i dzięki Wam cała "zabawa" z KSeF stała się dużo łatwiejsza - tak więc wielkie dzięki. Tworzę najprostszą wersję, czyli osobny exe z obsługą poprzez "ministerialne" API. Wydawało mi się że mam już wszystko mniej więcej poogarniane (na ile to możliwe w tym całym bajzlu), okazało się jednak że przy pobieraniu faktur dostaję w twarz limitem - błąd 429. Najpierw pobieram listę faktur i dla każdej próbuję pobrać xml-a. Udaje się ok 10. Środowisko demo. Ktoś się z tym spotkał? Myślałem że limity będą rzędu kilkuset - kilku tysięcy a nie kilkunastu. Chyba że coś źle robię, ale tak jak pisałem na wstępie korzystam z ich API.

jest gdzieś może przy pobieraniu faktury jej data wystawienia w ksef ?

Przymierzam się do integracji z ksef w środowisku DEMO i zastanawia mnie czy certyfikat na PESEL powiązany z podmiotem wystawiony w MCU produkcyjnym zadziała na środowisku DEMO?
Dostaję zwrotkę 21115 nieprawidłowy certyfikat. Na PROD dostałem 21180 nieprawidłowe żądanie no ale tam api 2.0 jeszcze nie ma. Na środowisku TEST działam z certyfikatem na PESEL wystawionym na środowisku testowym i tam nie mam żadnych problemów.

Czy istnieje jakaś testowa pieczęć kwalifikowana przy pomocy której możliwe jest przetestowanie czy napisany kod uwierzytelniający działa jak należy?

Uwaga, aktualizacja dokumentacji! Wreszcie - po 3 miesiącach, aferach i interpelacji - ujawnili oficjalnie algorytm liczenia IdWew!
https://ksef-test.mf.gov.pl/docs/v2/index.html#tag/Nadawanie-uprawnien/paths/~1permissions~1subunits~1grants/post

W przyszłym tygodniu ma być też aktualizacja generatora PDF (https://github.com/CIRFMF/ksef-pdf-generator/issues/22#issuecomment-3718182990)

Nawiązując do twojego pytania: https://github.com/CIRFMF/ksef-docs/issues/116#issuecomment-3718380312
Moim zdaniem nadawaniem IdWew zajmuje się firma o danym NIPe. KSeF nie sprawdza nic oprócz może sumy kontrolne.
Jak zrobisz sobie bałagan to będziesz miał bałagan.

My chcemy np: pracownikom nadawać IdWew

Od paru dni przychodzą maile of firm jak ma wyglądać faktura w ksef z wymaganiami z kosmosu. Patrzę sobie jak to jest w implementacjach u dużych dostawców softu jak Comarch Optima i widzę że nawet jak się da to wystukać to trzeba to będzie robić przy każdej fakturze. Powiem szczerze że tych co pchają ten ksef i zezwolili na takie biurokratyczne ścierwo zdrowo powaliło. To analogiczna sytuacja jak z jakimiś indywidualnymi umowami RODO jakie firmy się częstują od paru lat. Jestem bardzo ciekawy jak to ma działać od lutego/kwietnia i po co to łajno forsować kiedy za parę lat to idze do kosza bo unia szykuje własny system. Oby dało się tych szkodników jeszcze powstrzymać bo nie wiedzą co czynią.

witam, dziś zaczęły mi wysłane na bramkę testową dokumenty przechodzić jako offline. coś się zmieniło w tym zakresie w ostatnim czasie?

czesc,
nie zwracaja mi sie faktury jak chce je odfiltrowac po POST /invoices/query/metadata - czy ktorys z Szanownych Panow ma jakis pomysl?
Faktury mam z ksef number (endpoint do pobrania pojedynczej faktury rowniez dziala) i pobrane upo do nich, wiec czemu ich nie widze?

zakladam ze wyslalem cos 7 stycznia, wiec filtruje od 6 do 8 stycznia...

wysylam accessToken oraz:

{
  "subjectType": "subject1",
  "dateRange": {
    "dateType": "issue",
    "from": "2026-01-06T17:21:08.022Z",
    "to": "2026-01-08T17:21:08.022Z"
  } 
}

No i co wynikło z posiedzenia komisji? (była na niej święta trójca, czyli dyrektorzy z MF, KAS i przedstawiciel AK)
https://www.sejm.gov.pl/sejm10.nsf/transmisje.xsp?unid=673E99BEB5ECCDECC1258D68003CA5F4#

• System jest fakultatywny, ale nie jest, bo jest obligatoryjny ale nieobowiązkowy, a właściwie to obowiązkowy, ale bez konsekwencji można nie dochowywać obowiązku, ale nie nazwą fakultatywnym, bo ludzie mają się bać
• Projekty ustaw były w czerwcu, więc mało co się do grudnia zmieniło, zatem wszystko jest ok
• W testowym systemie się 5 mln osób zalogowało... (Jak się logowałeś na 2 nipy, to się rozmnożyłeś)
• Wydano 100k certyfikatów z MCU (ciekawe, ile z nich będzie używanych)
• Ustawa niby nie neguje posługiwania się papierem z QR1 (106gb jak dobrze zapamiętałem)
• Będą filmiki nowe z instrukcjami
• Może zabronią pójścia urzędnikom na ferie
• Zmiany w API nie wymagały(!) zmiany w oprogramowaniu integratorów, bo to tylko usprawnienia (największa bzdura, jaka padła)
• Nie wybrzmiała nawet połowa wątpliwości i zarzutów

Zauważyłem dziś przy pobieraniu faktur paczkami że jedna faktura miała znaczniki tns i rozwaliło mi to parser

<tns:Faktura xmlns:tns="http://crd.gov.pl/wzor/2025/06/25/13775/" xmlns:etd="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2022/01/05/eD/DefinicjeTypy/">
<tns:Naglowek>
<tns:KodFormularza kodSystemowy="FA (3)" wersjaSchemy="1-0E">FA</tns:KodFormularza>
<tns:WariantFormularza>3</tns:WariantFormularza>
<tns:DataWytworzeniaFa>2025-12-30T00:00:00Z</tns:DataWytworzeniaFa>
</tns:Naglowek>

Reszta faktur tego nie miała

<Faktura xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://crd.gov.pl/wzor/2025/06/25/13775/" xsi:schemaLocation="http://crd.gov.pl/wzor/2025/06/25/13775/ http://crd.gov.pl/wzor/2025/06/25/13775/schemat.xsd">
<Naglowek>
<!-- prametr startowy @nrWierszaSprzedPoj= -->
<!-- prametr startowy @nabycieSrTr=0 -->
<!-- prametr startowy @pMarzy=0 -->
<!-- prametr startowy @krajDocelowy=PL -->
<!-- prametr startowy @ksefRodzajFaktury=VAT -->
<!-- prametr startowy @korWyst=0 -->
<!-- prametr startowy @korNab=0 -->
<!-- prametr startowy @odbiorca=0 -->
<!-- prametr startowy @platnik=0 -->
<!-- prametr startowy @dmsFormaPlatn=41 -->
<!-- prametr startowy @opisPlatn=0 -->
<KodFormularza kodSystemowy="FA (3)" wersjaSchemy="1-0E">FA</KodFormularza>
<WariantFormularza>3</WariantFormularza>
<DataWytworzeniaFa>2026-11-26T09:23:38.353</DataWytworzeniaFa>
<SystemInfo>System Ksenofont 2016</SystemInfo>
</Naglowek>

Cześć, mam pytanie dotyczące sposobu podejścia do generowania uprawnień.
Jeśli mam klientów, którzy wystawiają faktury innym podmiotom, to czy model nadawania uprawnień powinien wyglądać w ten sposób, że mój klient loguje się do KSeF i nadaje uprawnienia na mój NIP oraz generuje certyfikaty (jestem upoważniony do wystawiania faktur)?
Czy lepiej wybrać model, w którym certyfikaty są generowane bezpośrednio na NIP klienta?

Witam
W środowiskach test i demo widzę dwa klucze publiczne KsefTokenEncryption , SymmetricKeyEncryption
a w produkcji nie mogę tego znaleźć - widzę tylko jeden klucz pod adresem https://ksef.mf.gov.pl/security/pem
czy powinienem lepiesz poszukać ???

https://ksef.podatki.gov.pl/komunikaty-techniczne/prace-serwisowe-na-srodowisku-integracyjnym-i-przedprodukcyjnym-demo-krajowego-systemu-e-faktur-20/

Wiecie, które to środowisko integracyjne? Ja chyba zapytam w formularzu.

A w ogóle działa jeszcze? Ja co chwilę timeouty mam.

Cześć, czy istnieje jakiś endpoint, za pomocą którego można pobrać UPO według numeru KSeF faktury, jeśli nie znamy numeru referencyjnego sesji, pod którym faktura została wysłana do systemu? Nie znaleźliśmy takiego endpointu, więc chcę się tylko upewnić. Dzięki. ...

REQUEST POST https://api-demo.ksef.mf.gov.pl/v2/invoices/query/metadata?pageOffset=0&pageSize=100
Body: {"subjectType":"Subject2","dateRange":{"dateType":"Issue","from":"2025-12-31T23:00:00.000Z","to":"2026-01-08T23:00:00.000Z"}}
09-01-2026 13:17:07 RESPONSE POST https://api-demo.ksef.mf.gov.pl/v2/invoices/query/metadata?pageOffset=0&pageSize=100
09-01-2026 13:17:07 Status: 401 Niestety w zwrotce mam pusty content co to może być?

Macie może aders do schematu upo4.3?

działa wam lista faktur w apce przedprodukcyjnej ? mnie wywala błąd 500

W temacie

Czy do stwierdzenia czy faktura jest offline KSeF porównuje datę wystawienia z datą przesłania czy z datą przyjęcia faktury do KSeF - tj. z datą z numeru referencyjnego czy datą z numeru KSeF?