Krajowy system e-Faktur

W nawiązaniu do tego tematu: https://github.com/CIRFMF/ksef-api/issues/853
Nie dziwią Was takie tematy? Po pierwsze - chyba w Polsce wszyscy pogodzili się ze sposobem autoryzacji i potrzebami przerzucania tokenów/certyfikatów do programów. A przynajmniej u mnie nikt nie dopytywał o zmianę tego procesu.
Po drugie - ilość zagranicznych dostawców łączących się do KSeF jest większa, niż przypuszczałem. Opłaca się zagranicznym firmom tak dostarczać oprogramowanie skrojone (lub możliwe do skrojenia) pod polskie przepisy? Chyba, że to chodzi o odbiorców faktur, ale trochę w to wątpię, że oni by nie mogli wymóc dotychczasowego przesyłania faktur w PDF/EDI.

Spotkał się ktoś z takim komunikatem.
Bład 21181 -Nie można wyeksportować paczki faktur dla wybranego podmiotu (Subject2) i zalogowanego identyfikatoru kontekstu (InternalId). Jakich uprawnien nie nadali podmiotowi podrzędnemu?

Skoro w ksef-pdf-generator najnowsza wersja to 1.1.31 to skąd klient na fakturze ma taki dopisek ? - to faktura wygenerowana w Aplikacji Podatnika KSeF - ale jak ją sciągam przez QR to na pdf mam właśnie 1.1.31

Witam

Jak za pomocą API w KSeF można uzyskac idetyfikator zbiorczy
https://ksef.podatki.gov.pl/informacje-ogolne-ksef-20/numer-ksef-i-zbiorczy-identyfikator/

Czy ktoś rozumie ideę oraz przepływ danych dla tych identyfikatorów zbiorczych?

1. Przyjmijmy, że wystawiam 2 faktury "do zapłaty". Wysyłam do KSeF,
2. Używam endpointu https://api-test.ksef.mf.gov.pl/docs/v2/index.html#tag/Identyfikatory-zbiorcze/paths/~1collective-identifiers/post i wystawiam identyfikator zbiorczy w którym podaję płatność za każdą z tych faktur z osobna
3. System nabywcy pobiera 2 nowe faktury z KSeF... i co dalej? Jak ma teraz sprawdzić czy i na ile wystawiono identyfikator zbiorczy z płatnością?

Żeby skorzystać z endpointu https://api-test.ksef.mf.gov.pl/docs/v2/index.html#tag/Identyfikatory-zbiorcze/paths/~1collective-identifiers~1invoices/post musi znać identyfikator.

Natomiast endpoint https://api-test.ksef.mf.gov.pl/docs/v2/index.html#tag/Identyfikatory-zbiorcze/paths/~1collective-identifiers~1query/post zwraca listę identyfikatorów, ale bez informacji jakich numerów KSeF dotyczą.

Witam

W rzadowej aplikacji TEST KSef nie ma jeszcze IZ ?

Czyli IZ generuje tylko odbiorca. A sprzedawca widzi te numery IZ ?

Paweł

N1ebieski napisał(a):

Czy ktoś rozumie ideę oraz przepływ danych dla tych identyfikatorów zbiorczych?

1. Przyjmijmy, że wystawiam 2 faktury "do zapłaty". Wysyłam do KSeF,
2. Używam endpointu https://api-test.ksef.mf.gov.pl/docs/v2/index.html#tag/Identyfikatory-zbiorcze/paths/~1collective-identifiers/post i wystawiam identyfikator zbiorczy w którym podaję płatność za każdą z tych faktur z osobna
3. System nabywcy pobiera 2 nowe faktury z KSeF... i co dalej? Jak ma teraz sprawdzić czy i na ile wystawiono identyfikator zbiorczy z płatnością?

Żeby skorzystać z endpointu https://api-test.ksef.mf.gov.pl/docs/v2/index.html#tag/Identyfikatory-zbiorcze/paths/~1collective-identifiers~1invoices/post musi znać identyfikator.

Natomiast endpoint https://api-test.ksef.mf.gov.pl/docs/v2/index.html#tag/Identyfikatory-zbiorcze/paths/~1collective-identifiers~1query/post zwraca listę identyfikatorów, ale bez informacji jakich numerów KSeF dotyczą.

@N1ebieski: Nie sprzedawca wystawia IZ tylko odbiorca. Podaje za jakie numery KSef płaci i ile za każdy.
Musi podać tylko numery KSEF jednego sprzedawcy dla jednego IZ .
Skoro sprzedawca wystawił faktury w KSeF wię na PEWNO ma te numery u siebie.
No to poprawia rozliczenia w księgowości.
I jest dokumentacja !!!
Paweł

Pytanie odnośnie identyfikatorów zbiorczych:
Mamy sprzedawcę i nabywcę. Wystawione pięć faktur: trzy podstawowe i dwie korekty in minus (sorry ale nie będę numerami ksef operował):
FV001 (należność: 100PLN)
FV002 (należność: 120PLN)
FV003 (należność: 150PLN)
KOR001 (dotyczy FV002, należność: -20PLN)
KOR002 (dotyczy FV003, należność: -50PLN)
I teraz dwa scenariusze płacenia/generowania IZ:

Scenariusz 1:
Nabywca uwzględnia wszystkie faktury. W tej sytuacji generuje identyfikator deklarując pięć składowych wartości payment.amount odpowiednio 100, 120, 150, -20, -50 po czym robi przelew na 300PLN

Scenariusz 2:
Nabywca zapłacił za faktury podstawowe. Wygenerował IZ dla trzech faktur deklarując wartości składowe payment.amount 100, 120, 150 i zrobił przelew na 370PLN
Sprzedawca ogarnia korekty i zwraca kasę do nabywcy, czyli musi zrobić przelew na 70PLN. Czy sprzedawca deklarując wartości payment.amount w IZ deklaruje kwoty 20, 50 czy może -20, -50 (tak jak by to nabywca zrobił)? Obstawiam, że suma wartości payment.amount musi się zgadzać z kwotą przelewu, więc pewnie będzie 20 i 50 prawda?

Z góry przepraszam jeżeli powtarzam pytanie, ale nie mogę znaleźć.
W sytuacji kiedy faktura została wystawiona na 433PLN, a powinna być na 100EUR da się to zrobić w KSeF korektą? W Aplikacji podatnika nie wiem jakbym miał to wyklikać...
Edit:
oczywiście docelowo będę budował XML, a w AP tylko chciałem sprawdzić jakby to wyglądało

Nie poddaję w wątpliwość, tylko dopytuję: Czy ktoś może potwierdzić, że ten komentarz:

    Czy używanie IZ jest w ogóle wymagane? Czy przy przelewie za dwie faktury (albo za fakturę i korektę in minus) mogę po prostu podać dwa numery KSeF ID?
Nie musisz używać IZ, możesz podać w tytule przelewu nawet 3 numery ksef.

jest zgodny z przepisami, które mają wejść od 1. stycznia? Jeśli tak (wiadomo, że po czasie się jakieś interpretacje US pojawią itd) to jak daleko sięga ta dowolność?

Można podać w tytule IZ plus zwykły nr ksef? Albo jeszcze bardziej zamotać, np: przelew B2B za moje faktury w ksef nie musi być wykonany z konta firmowego, więc wykonam go z konta żony, która swoją drogą ma do zapłacenia swoją fakturę B2C, której nie ma w ksef... więc w tytule podam IZ moich faktur i numer P_2 z faktury żony.
Poza długością tytułu przelewu jest jakaś granica ;)?

Pytanie co byście zrobili w takiej sytuacji:
Klient wystawił fakture w programie, na 2 pozycje, powiedzmy że obie na 100 PLN czyli faktura w sumie 200 PLN
Wkradła się błąd w danych (to pomijam bo nie ma znaczenia) i fa wygenerował się błędnie. Tzn. weszła jedna pozycja za 100 PLN, ale podsumowanie (P_13_1,P14_1,P_15) są na pełną kwotę faktury.
Co najlepsze odbiorca faktury zapłacił za całość.
Ja bym mówiąc szczerze poprawił dane w programie FK (aby do jpk poszła całość) i nie bawił się w korekty. Bo w sumie faktura ma "błąd techniczny", więc cięzko wystawić korektę dodając tą jedną pozycję bo wyjdzie kwota do zapłaty. Czy nawet wyzerowanie powodowałoby, że ta faktura musialby mieć inną wartość na pozycji niż w pierwotnej.

Może ktoś podać jakieś ID zbiorcze z systemu ksef-test? Chce sprawdzić czy zwracają jakieś komunikaty gdy się podaje IZ podmiotu do którego nie ma się uprawnień. Niestety jak się podaje losowy IZ to po prostu zwracają pusta listę faktur w metodzie rozkodowujej IZ na faktury KSeF.

Trochę z innej beczki niż IZ i korekty, ale z tego samego podwórka. Robiąc integrację zauważyłem, że najwięcej błędów u klientów bierze się nie z XML-a, tylko z kroku wcześniej: czy ten dokument w ogóle ma iść do KSeF i jak go dostarczyć. Klasyka: faktura dla firmy z DE/US wysyłana „poza KSeF, bo zagranica” (a powinna być w KSeF i tylko udostępniona poza, art. 106gb ust. 4), próg 10k traktowany jak zwolnienie tylko dla nievatowców, paragon z NIP po 1.01.2027.

Wyciągnąłem tę logikę do osobnego serwisu: POST /v1/check z danymi transakcji → ksef_required, delivery (ksef / outside_ksef), reason, matched_rule, assumptions[] (co przyjął, gdy czegoś nie podałeś). Reguły to dane (JSON + mały DSL), nie kod: tier hard (ustawa) → reguły klienta → tier soft → fallback, i odpowiedź zawsze mówi, która reguła zadecydowała. Zestaw bazowy z artykułami ustawy jest publiczny pod GET /v1/rules/base. Jawnie nie modeluję art. 145l (1.02–31.03.2026), bo API nie zna sprzedaży z 2024.

Docs (OpenAPI 3.1): https://czyksef.pl/docs — Free 1000 req/mies., bez karty. Stack: Fastify + SQLite. Nie wystawia i nie wysyła faktur, to tylko decyzja.

Szukam przypadków, które rozstrzyga źle albo których nie obsługuje (najem prywatny? procedury szczególne poza OSS/IOSS?). Narzędzie pomocnicze, nie porada podatkowa.

Jakie podejście od strony wydajności/limitów api przyjęliście w kwestii dekodowania IZ? Na bieżąco pobieracie nowe IZ i je dekodujecie czy dopiero jak jest jakiś potrzebny (przy imporcie wyciągów czy coś) to na żywo go ogarniacie?
Ten pierwszy sposób teoretycznie zmniejsza szansę na utknięcie z dekodowaniem ze względu na limity requestów ale zakłada, może i słusznie, że ktokolwiek generował IZ robił to rozsądnie i na 1 użyty identyfikator nie wygenerował 10 śmieciowych IZ, których nie użył. Pobierając i dekodując przyrostowo IZ nie będzie sytuacji, że przy imporcie wyciągów mamy nagle ileś tysięcy IZ i "Pani Halinko spokojnie proszę iść na kawkę bo teraz będziemy dekodować"

Kompletna pierdoła ale akurat builda z testami puściłem i nie chce mi się wstawać od kompa to sobie pisze. Odnośnie https://github.com/CIRFMF/ksef-api/issues/808#issuecomment-5524868009
Kto już robił importy wyciągów to pewnie wie: trzeba się bawić w odpowiednie join'owanie elementów tytułu. W zależności od formatu jaki dostajemy zwykle tytuł jest w kilku polach. Jeżeli w tytule ktoś poda trzy numery ksef to bankowo będzie trzeba tytuł łączyć kolejno z kilku elementów. I czasem trzeba połączyć ze spacją (albo jakimś tam separatorem) a czasem bez ;) Jeśli zawsze zrobi się joina ze spacją to można niechcący połamać numer ksef:

9512479714-20240403-A3F89B2E2CFC-29 5261234567-20260504-A1B2C3D4E5F6-7 8 9876543210-20260716-4C2F8A1B9E0D-3B

rafdeer napisał(a):

No to dziś claude sobie regexpy popisze

Nie mam pewności ale przy okazji https://github.com/CIRFMF/ksef-api/issues/864 dopytam: czy w open-api.json są wszystkie możliwe kody błędów wylistowane? Gdzieś ostatnio ten temat się pojawił. Trafiliście na jakiś kod, którego nie ma w specyfikacji?

Do tych co używają tej biblioteki ksef-pdf-generator. I co robicie z tą wersją 1.1.39 ?
@Dzyszla @N1ebieski

Aha - chyba wybory idą...
https://crn.pl/aktualnosci/kary-za-ksef-odroczone-do-konca-2027-roku/
Czy to tylko dla tych najmniejszych firm czy dla wszystkich jest/będzie wydłużony okres "bez kar"?

Gdzieś mi umknęło w natłoku - https://www.podatki.biz/artykuly/ksef-i-jpk-korekta-blednych-danych-podmiotu-trzeciego_55_61915.htm - to teraz już podmiot3 można dowolnie zmieniać jednak? Jak do tej kwestii podchodziliście i podchodzicie obecnie?