Wymagania KSeF - podręcznik?

[tpowalka]

cześć,
pytanie mam, czy API KSeF implementuje wymagania/założenia z podręcznika KSeF?

Bo nie ukrywam, że mam przypadek, gdzie KSeF zaakceptował fakturę, która wg podręcznika nie powinna istnieć i teraz jest problem. I nie wiem, czy to jest błąd API, czy nie.

[jacekkarczmarczyk]

Api nie sprawdza xmla poza samą zgodnością ze schemą, numerem faktury pod kątem duplikatu itp
Możesz wysłać fakturę, gdzie suma wartości wierszy nie będzie się zgadzać z wartością faktur, możesz wysłać fakturę z pozycjami z wyklulczającymi się stawkami vat (np 1, np 2, zw, 23, 0_wdt, 0_ex itp), możesz wysłać fakturę bez pozycji itp itd

[tpowalka]

@jacekkarczmarczyk dzięki za odpowiedź, ale mimo wszystko wolałbym poznać oficjalną odpowiedź zespołu wytwórczego API KSeF.

Twoja odpowiedź opisuje stan faktyczny implementacji - i ja też to wiem. Ale pytaniem jest: jak powinno być? Czy to co w podręczniku i przepisach to API sprawdza czy nie? Jeżeli nie, to czy powinno sprawdzać, czy nie?

Bo pamiętajmy, że KSeF to tylko część całego systemu. Jest jeszcze np. JPK. Można zatem zrobić takiego babola, którego nie da się potem odzwierciedlić w JPK. Faktury z KSeF nie wycofasz, noty nie zrobisz, a JPK wypełnić musisz.

[Artursz100]

W dokumentacji technicznej (oficjalnej) jest opis jakie elementy faktury podlegają weryfikacji - https://github.com/CIRFMF/ksef-docs/blob/main/faktury/weryfikacja-faktury.md W domyśle, wszystko co jest poza, nie podlega weryfikacji.

[kw-cirf]

Pozostaje mi tylko potwierdzić odpowiedzi @tpowalka i @Artursz100
Temat poruszony również w #703.

[tpowalka]

@k-wysocki-bl no fajnie, ale to nie jest nawet promil wymaganych walidacji. Ja mam problem z tym, że wystawca faktury zrobił korektę faktury i w korekcie zmienił NIP nabywcy.
Tak się szczęśliwie w tym przypadku złożyło, że zamienił miejscami nip odbiorcy (P3) i nabywcy (P2) więc odbiorca i nabywca widzą fakturę pierwotną i korektę.
Ale teraz wiele głów - księgowe - się zastanawia co z tym zrobić i jak to ująć w JPK oraz jak to będzie wyglądać w przyszłym roku jak na przelewach będą numery KSeF. Bo jest podejrzenie, że jak ktoś zapłaci nie za swoją fakturę (w tym przypadku korekta ma wartość zero) to zapali się gdzieś w KAS lampka "wymagana kontrola".
Zmiana NIPu jest opisana w podręczniku część 2 rozdział 1.6.4 - nie można zmienić NIPu, trzeba zrobić korektę do zera i nową fakturę.
Ja się pytam zatem po co nam jest ten podręcznik? Po co podręcznik stwierdza, że coś można, albo nie można zrobić? Moim zdaniem API powinno implementować logikę opisaną w przepisach i podręczniku, bo jeżeli tego nie robi i na dodatek nie można robić zmiany czy anulowania faktury wysłanej już do KSeF to właśnie dochodzimy do takiej patowej sytuacji.
A to jest tylko jeden z przykładów jakie babole są dzisiaj wpuszane do KSeF. Dzisiaj, gdy tylko najwięksi i chętni tworzą faktury.

Jestem ciekaw kto napisze algorytm weryfikujacy poprawność faktur po waszej stronie, bo nie wierzę, że Urzędnik (z całym szacunkiem, szanuję) będzie na tyle lotny, aby ręcznie weryfikować poprawność XMLi.

I na koniec - tak zadałem to pytanie przez formularz. Ale z mojego doświadczenia, spodziewam się po 3 tygodniach odpowiedzi w formie cytatu z podręcznika, która nic nie wniesie do rozwiązania problemu. A termin JPK lada moment. O ile za KSeF w tym roku kar nie ma, to za JPK są.

I na koniec 2 - technicznie, wyjdziecie na prostą, tak jak z PZ. Ale merytoryczna zawartość faktur... wystawcy nie potrafią nawet ról dobrze wybrać. Masakra jest.

Miłego dnia!

[MSOExo]

Przykład z życia - w fakturach przez 1.2.2026 nie było walidacji numeru NIP, w lutym wystawiana jest korekta ceny/ilości i KSeF 2.0 odrzuca fakturę bo nie pasuje cyfra kontrolna NIP.
Jeśli fakturę pierwotną KSeF przyjął to fakturę korygującą również powinien przyjąć bo w praktyce nie da się teraz wystawić korekty w KSeF z uwagi na wdrożenie walidacji NIP.

[tpowalka]

Kolejny przykład z życia to ja też mogę podać.
Cała część 4 podręcznika jest o JST i GV.
Jest nawet dedykowana rola w P3 "JST wystawca" (rola 7) i "JST odbiorca" (rola 8). - Po co? Skoro nie ważne jaką rolę ustawimy w P3 z NIPem jednostki podrzędnej JST to i tak ta faktura tam trafi.
A w praktyce jest jeszcze gorzej, bo już samo wpisanie NIPu jednostki podrzędnej w P3 przerasta możliwości wystawców. Ponad 30% faktur nie zawiera NIPu JST podrzędnej w P3. Przypadki ustawienia złej roli (8) pomijam.

[Artursz100]

Korygowanie faktur pierwotnych wystawionych przed wdrożeniem KSeF (01.02.2026) to istny koszmar.
Cała sekcja Podmiot1K i Podmiot2K jest kompletnie bez sensu. Jak można wymagać ustrukturyzowanych danych, skoro dane te nie były wcześniej ustrukturyzowane lub były, ale w inny sposób.

Numer NIP.
Błędny w numerach NIP są bardzo częste, podatnicy też często stosowali przedrostek PL w numerze NIP. Teraz jak trzeba wystawić korektę to nie można ponieważ faktura nie przechodzi walidacji lub zostaje odrzucona przez API.

Brak stawki NP
Stawka NP była często stosowana na fakturach. Teraz nie można jej stosować na fakturach, gdzie miejscem świadczenia jest Polska. Jak wiec skorygować taką fakturę np. skoro nie można wykazać wartości z pozycji faktury ponieważ nie ma takiej stawki.

To tylko dwa proste przykłady .. a jest tego znacznie więcej.

[Dzimmi]

Jest nawet dedykowana rola w P3 "JST wystawca" (rola 7) i "JST odbiorca" (rola 8). - Po co?

Rozbicie ma znaczenie w kontekście uprawnień.
Jak jestem wystawcą to mogę zalogować się w kontekście NIPu JST/GV i wysłać fakturę, gdzie w Podmiocie1 jest NIP jednostki nadrzędnej.
Mamy tak dla GV i dobrze to działa.

[tpowalka]

@Dzimmi może wyraziłem się niejasno. Jest JST Odbiorca(rola 8), ale jest też Odbiorca(rola 2). Po co? Logujesz się na nip i masz uprawnienia do faktury nieważne która rola jest wypełniona, ważne aby NIP się zgadzał.
Tak samo jest Wystawca faktury (rola 5) i JST wystawca (rola 7).

Wprowadzone są dedykowane role JST, jest podręcznik który mówi jak ich używać, ale równie dobrze można wstawić "zwykłe" role bo KSeF tego i tak nie weryfikuje.
Jedyne zastosowanie do wprowadzenia tych ról to dla mnie możliwość ukarania od przyszłego roku za wstawienie nie tej roli.

[Dzimmi]

Ogólnie chodzi o uprawnienia. GV ma specjalny model uprawnień (z JST nie testowałem) i role wystawca/odbioca GV mają duże znaczenie zarówno przy wysyłce jak i przy pobieraniu.
Zwykła rola 5 nie daje uprawnień do wysyłki jak logujemy się w kontekście podmiotu3. W GV logująć się na NIP członka grupy VAT mogę wysłać fakturę, gdzie jesteśmy w Podmiocie3 z rolą 9, co mocno ułatwia proces.

[tpowalka]

@Dzimmi masz rację przy wystawianiu, rozpędziłem się. Chodzi mi o odbieranie faktur. Nie wiem jak jest przy GV, ja obsługuję JST, ale prawdopodobnie tak samo.
Skoro do JST podrzędnego trafia np. faktura kosztowa, która ma jego nip w podmiot 3 w dowolnej roli, to po co stworzona została dedykowana rola JST odbiorca (8), jakby nie można było użyć po prostu Odbiorca (2)? Po co znacznik JST/GV przy podmiot 2?
Co jeżeli ktoś wpisze kilka podmiotów 3 o roli JST odbiorca z różnymi nipami? Tylko kwestia czasu, aż takie faktury przyjdą.

Spróbuj zamówić w x-kom, mediaexpert, czy jakimś innym sklepie internetowym jako JST lub GV. Praktycznie wszystkie obsługują umieszczenie dodatkowego odbiorcy na fakturze. Ale nie ma wyboru w jakiej roli chcesz go umieścić. Czyli pewnie idą w roli Odbiorca (2).
Masakra jest. Merytoryczna masakra. Technicznie na razie jakoś działa.
A w 2027 kara za to, że nie ustawiłeś P3 o roli 8 lub 10 tylko 2 i nie dałeś znacznika w P2 JST lub GV.

[Dzimmi]

Spotkałem się z wystawieniem na członka grupy VAT, gdzie rola jest dobra, nazwa dobra... nipu brak. I jak taki członek grupy ma to dobrze pobrać? :) zwłaszcza że różni członkowie są na różnych systemach. Niektórzy zrobili implementację chyba dopiero w styczniu ;)