Krajowy system e-Faktur

Patrzę i nie widzę, czy da się jakoś odpytać API jakie ma uprawnienia token którym się zalogowałem ? token wygenerowany przez właściela jdg, interesuje mnie czy mam mam uprawnienie pobierania czy wysyłanie faktur

@SylwesterK napoczął tutaj : https://static.4programmers.net/Forum/Nietuzinkowe_tematy/355933-krajowy_system_e_faktur?p=2014062#id2014062
A jako, że było to chwilę temu to zapodam tutaj osobno.[ówcześni uczestnicy konwersacji (kolejność z komentarzy): @JacekKKKK , @zbynioh , @Dzyszla ]
Odnośnie sesji interaktywnej (środowisko TEST):

• otworzyłem sesję 27.02.2026 08:13...
• dodałem 5 FA3, które odrzucono
• dodałem 1 fakturę "na cacy" (dostała status 200 i ksefNumber)
• ... i w takim stanie zostawiłem - nie zamykałem jej
• DZIŚ w AP KSeF jest jako "Zakończona", a status sesji z API: 200; Sesja interaktywna przetworzona pomyślnie
• stan faktur został taki jaki był wczoraj (5 FA błędnych, 1 ok)
• i taki sam stan jest teraz po tym, jak została przez soft MF zamknięta
• czyli: jest na liście wystawionych faktur, można zobaczyć/pobrać UPO.
  Jeśli coś mogę od razu tam sprawdzić i podać, to piszcie teraz albo zamil..... ;)

Unikalność przy wysyłaniu faktury.
Na GH https://github.com/CIRFMF/ksef-docs/blob/main/faktury/weryfikacja-faktury.md napisano, że unikalność jest wg: Podmiot1, RodzajFaktury, P_2.
Ja wysłałem FA do KSeF (wczoraj), skopiowałem ją u siebie, czyli zmieniły się dane: P_2 (liczba w środku), DataWytworzenia i oczywiście P_1 na dzisiejszą datę (zrobiłem diff plików xml).
Wysyłam i dostaję 440 (w sesji jest rzeczywiście 1na błędna faktura).
Więc myślę - Czego nie zrozumiałem i co jest źle z mojej strony?
ALE się wyjaśniło!!!! numer wczorajszy "FA/1/TEST" a dzisiejszy...... "FA/?/TEST" !! - czyli olewają znaki nie alpha/num albo idzie do bazy przez like a nie "="?

EDIT: jak człowiek zmęczony to tak się często wygłupi - [ERRATA]: faktura z P_2="FA/?/TEST" jednak raz weszła a potem dopiero był "protest" z API

Hej

Jakie automatyczne kroki podejmujecie w sytuacji kiedy nie jest ogłoszona awaria ale ze względu np na brak netu nie możecie wysłać faktury? Powiedzmy że wysyłka się nie udaje i próbujemy do końca dnia przesłać fakturę bez powodzenia. Na następny dzień można, choć to już śmierdzieć zaczyna, próbować dosyłać dalej (offline24) ale załóżmy, że ciągle wysyłka zakończona niepowodzeniem. Dwa dni po wystawieniu to już nawet offline24 nie ratuje. Możecie podzielić się swoimi rozwiązaniami w tej kwestii? Wiadomo, że użytkownik zostaje poinformowany ale głupio tak zrzucić na podłogę daną fakturę i powiedzieć "sorry teraz to twoje zmartwienie ja fakturkę olewam"

Latarnia nie działa - czyli wojna, zamykamy KSeF?

Jak rozwiązać problem wpisywania w teminie płatności "zgodnie z umową", mam obsługę terminów opisowych ale tam trzeba podać 3 wartości. Jakieś pomysły?

Mamy kolejną aktualizację: https://github.com/CIRFMF/ksef-docs/releases/tag/2.2.0
Dla zainteresowanych - aktualizacja endpoint-ów dostępna także na moim GH: https://github.com/gmnevton/ksef-2_0-api_endpoints

TL;DR:

• nowy EP: /permissions/query/entities/grants
• EP: /auth/challenge zwraca clientIp
• odpowiedzi 401 Unauthorized i 403 Forbidden zwracają application/problem+json
• przywrócili niektóre additionalProperties

Jest jakiś endpoint zwracający wersję api? Albo jakaś magiczna opcja żeby w headerze ją dostać?

Szybkie pytanko o korekty faktór:

jak zerujemy fakturę to w sekcji przykład z przukłądu, dajemy wartości minusowe (czyli o ile zostało skorygowane), czy wpisujemy zero w (jak w przypadku wyzerowania) ?

	<FaWiersz>
		<NrWierszaFa>1</NrWierszaFa>
		<UU_ID>aaaa111133339990</UU_ID>
		<P_7>lodówka Zimnotech mk1</P_7>
		<P_8A>szt.</P_8A>
		<P_8B>1</P_8B>
		<P_9A>-162.60</P_9A>
		<P_11>-162.60</P_11>
		<P_12>23</P_12>
	</FaWiersz>

https://www.wnp.pl/rynki/znikajace-faktury-w-ksef-zaskakuja-firmy-ministerstwo-tlumaczy-co-z-tym-robic,1038080.html

Wie ktoś skąd się wzięło "W przypadkach, gdy faktura ma numer KSeF, system ją formalnie przyjął, a mimo to nabywca jej nie widzi, MF zaleca ponowne jej wysłanie, co powinno przywrócić pełną widoczność dokumentu."

Nie wiem na ile wiarygodny jest to portal ale chyba zastosowali bardzo duży skrót myślowy. Pozwalacie na ponowne wysłanie faktury jeśli macie już upo, nr ksef itd?

Stl86 napisał(a):

Wstawiał z Was ktoś

ZaplataCzesciowa.PlatnoscInna = 1
ZaplataCzesciowa.OpisPlatnosci = COS_DOWOLNEGO

chyba nie drukuje się ten opis w tym generatorze od nich..

Może ktoś potwierdzić ?

To zgłaszanie błędów..nawet nie wiem jak to zgłosić przez ten formularz, jako integrator nie ma opcji zgłoszenia błędu do Apki :) jako Podatnik nie widzę takiej opcji.. na github jak napisze to się zaraz "obrażą".

Stl86 napisał(a):

Wstawiał z Was ktoś

ZaplataCzesciowa.PlatnoscInna = 1
ZaplataCzesciowa.OpisPlatnosci = COS_DOWOLNEGO

chyba nie drukuje się ten opis w tym generatorze od nich..

Może ktoś potwierdzić ?

To zgłaszanie błędów..nawet nie wiem jak to zgłosić przez ten formularz, jako integrator nie ma opcji zgłoszenia błędu do Apki :) jako Podatnik nie widzę takiej opcji.. na github jak napisze to się zaraz "obrażą".

Dla certyfikatów KSeF wystawionych na podmiot zawsze zakładałem, że certyfikat zawiera atrybut

2.5.4.97 = VATPL-....

Dzisiaj pojawił się u użytkownika certyfikat z atrybutem

 2.5.4.97 = VATPL-... BR:PL-...

Kiedy może pojawić się BR:PL ? Czy to zależy od tego co jest w pieczęci kwalifikowanej?

Cześć, jak ustawiacie Podmiot3 jeśli faktura jest wystawiana z jednostki podrzędnej to rola takiego Podmiot3 jest 5 (Wystawca faktury)? A Odbiorca faktury może być kolejny z rolą 2 - jako zwykły Odbiorca?

czy ktoś już miał przypadek, że faktura zakupu ma nadany numer ksef, jest kod QR, ale nie można ją odebrać przez stronę qr... - to znaczy pojawia się info że faktura jest zarejestrowana, ale nie wpisując dane z faktury jest błąd - nie można też jej pobrać przez API ? faktury z 3.03.2026 więc już powinny się wygrzać na serwerach KSeF? albo może dostawcy się wkleił qr nie z tej faktury ?

Mamy fakturę pierwotną BEZ podmiotu 3 (bo ktoś zapomniał dodać).

Czy dozwolone jest wystawienie do niej faktury korygującej która doda brakujący podmiot 3 (w takim wypadku węzeł Podmiot3 będzie wypełniony, ale będzie brakowało Podmiot2K z jego ID)?

Czy może powinno się wyzerować taką fakturę i wystawić jeszcze raz z danymi podmiotu 3?

OVH wystawiło mi fakturę z jednym wierszem, a w nim: <NrWierszaFa>31349800</NrWierszaFa>. Ech... trzeba heurystykę wymyślać do korygowania tych co nawet XSD nie przeczytali.

Dzień dobry, czy na integracyjnym ustawiono limity jak na produkcji?

Często mam od 1 marca zwroty w stylu: Kod 429 Przekroczono limit 200 żądań na godzinę. Spróbuj ponownie po 151 sekundach dla akcji pobierania metadanych faktur

Taki problem: błąd w programie powoduje że do KSeF trafia faktura ze złym podsumowaniem (powiedzmy że ma wpisaną kwotę dla stawki, która nie występuje w żadnej pozycji na fakturze). KSeF nie przewiduje po prostu skasowania faktury, trzeba ją chyba wyzerować korektą. Ale program został poprawiony, i nie wygeneruje takiej korekty, w której jest jakaś kwota dla stawki, której nie było w żadnej pozycji. Nie ma więc możliwości wystawienia korekty zerującej. Co zrobić? Wydaje mi się że to błąd w założeniach KSeF że nie ma prostego anulowania faktur, i że nadaje się to do zgłoszenia jako "issue", ale chciałbym poznać najpierw wasze opinie.

Jak od strony KSeF wygląda kwestia samofakturowania czyli wystawiania faktury w imieniu innego NIPu na siebie (na swoj NIP)?

1. Trzeba się logować do kontekstu tego innego NIPu czy do swojego?
2. Te inne NIPy (podmioty) muszą nadać uprawnienie nam (na nasz NIP) na wystawianie faktur w ich imieniu?

Witam

Mam pytanie od klienta i nie jestem pewny co odpowiedzieć.
Klient - Gmina wystawia faktury z danymi: Sprzedawcą jest Gmina z NIP Gminy, a Wystawcą np Urząd Gminy (lub Zakład) ze swoim NIP.
Dla której jednostki (Sprzedawca czy Wystawca) powinny być utworzone certyfikaty KSEF w aplikacji podatnika dla pracownika, który wystawia z mojego programu fakturę?
Taki certyfikat jest powiązany z kontekstem NIP, wiec jeden trzeba wybrać.

Pozdrawiam wszystkich

Niech ktoś mi wytłumaczy jak chłopu na miedzy... Podmiot otrzymał fakturę z Podmiotem 3. Filtr meta danych ustawiony na subject3 oddaje zbiór pusty. Odwrotnie podobnie, tzn podmiot wystawił fakturę z Podmiotem 3, ale w meta danych dla Subject3 nic nie ma.

Kiedy faktura trafia do subject3 albo subjectauthorized???

Czy można pobrać numer ref. sesji w której dokument był wysłany do KSeF znając tylko numer KSeF?

Mam pytanie dotyczące wizualizacji pobieranych faktur przez API KSeF. Mianowicie, jak pobiera się fakturę z KSeF przez API, to z mojej wiedzy można pobrać tylko XML i później zwizualizować to na plik HTML lub na przykład PDF, używając pliku XSL/T. Natomiast pobierając faktury bezpośrednio z aplikacji podatnika, można je pobrać w formacie PDF. I szkopuł jest w tym, że wizualizacja, którą otrzymujemy po transformacie XSL, a ta, która jest pobierana z KSeF-u w formacie PDF, wygląda wizualnie po prostu inaczej. Ta pobrana z aplikacji podatnika jest dużo przyjemniejsza dla oka i lepiej ustrukturyzowana.Mam pytanie, czy można z KSeF przez API pobrać faktury, czy to w formacie XML czy PDF, ale żeby finalnie wyglądały tak samo, jak te pobrane bezpośrednio z aplikacji podatnika, zwizualizowane już w PDF?

Teoretyczne pytanie "czy spotkaliście się z czymś takim?". Boję, że na prima aprilis coś takiego dostanę:
W FaWiersz mamy P_9A (cenę netto) i P_10 (rabat kwotowy) do obliczania P_11 (wartość sprzedaży netto) używana jest różnica P_9A - P10 ale ta różnica nie jest explicite podana (nie ma pola "cena netto po rabacie")

Jednak wszyscy kochają rabat procentowy. Co jeśli ktoś wypełni fakturę w ten sposób:

• FaWiersz: P_9A = 100.00, NrWierszaFa = 1
• DodatkowyOpis: NrWiersza=1, Klucz="Rabat procentowy", Wartosc="15"
  i do obliczenia P_11 użyje ceny netto po rabacie = 85.00

Jeśli coś takiego jest dopuszczalne to całą walidację poprawności faktury można sobie wsadzić w mało nasłonecznione miejsce. Spotkaliście się z czymś takim?

Pytanie o pola P_11 i P_11A. Jest sobie kwota brutto 75.00zł, netto po zaokrągleniu wychodzi 60,98zł, VAT: 14,02zł
Ale: 60,98 * 1,23 daje 75,0054 po zaokrągleniu 75,01zł, dla netto 60,97 wychodzi 74,99 a ja musze miec równo 75.00zł

Czy w takich wypadkach wystawiacie fakturę z kwoty brutto tzn P_11A zamiast P_11? Czy może tak jak niżej? KSeF przyjmuje wszystko z tego co widze :)

<P_9A>60.98</P_9A>
<P_9B>75.00</P_9B>
<P_11>60.98</P_11>

Jest jakiś sposób na środowisku testowym, żeby otrzymać po przetworzeniu faktury status 500 lub 550?

Cześć,

Czy ktoś posiada przykładowy wzór Faktury RR albo wie, skąd można go pobrać?
Schemat mam już pobrany, ale chciałbym sprawdzić, czy poprawnie generuję Fakturę RR.

Cześć,

Czy spotkał się ktoś z Was z takim przypadkiem?
Mamy dwie polskie firmy. Firma A wystawia fakturę na rzecz Firmy B podając w swoim systemie zamiast numeru NIP wartość NIP UE Firmy B (KSeF elegancko rejestruje taki dokument). Niestety, z poziomu Firmy B nie idzie pobrać z KSeFu tej faktury.
Błąd pojawia się podczas uwierzytelnienia XAdESem, gdzie w Auth requeście musimy podać ContextIdentifier jako NipVatUe. Zgodnie z definicją tego pola jest pattern, który nie obsługuje kodu kraju = PL. Takim sposobem Firma B nie może się uwierzytelnić i następnie pobrać faktury. Mamy zatem fakturę w KSeFie, ale odbiorca nie może jej pobrać. Inną kwestią jest fakt, czy jest to poprawne księgowo, niemniej jednak faktura w KSeFie jest, ale pobrać jej nie idzie.

Pytanie w kwestii korekt, bo przerobiłem już temat korygowania danych podmiotu 2 lub 3. Ale co w przypadku gdy pierwotna fakura miała błędną datę sprzedaży bądź płatności, czyli pola P_6, P_6_Od, P_6_Do czy TerminPlatnosci? Ponoć dotąd załatwiano to notą ksiegową. W podręczniku ksef nic o tym nie znalazłem...

Testowo20 napisał(a):

Cześć,

Czy ktoś posiada przykładowy wzór Faktury RR albo wie, skąd można go pobrać?
Schemat mam już pobrany, ale chciałbym sprawdzić, czy poprawnie generuję Fakturę RR.
@rafdeer: Masz może jakiś wygenerowany XML który przechodzi walidacje ?

Taką wpuszcza. BTW odnośnie api trzeba pamiętać, że 30, marca znów się zmieni i przy otwieraniu sesji zamiast RR będzie FA_RR (https://github.com/CIRFMF/ksef-docs/issues/726)

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Faktura xmlns="http://crd.gov.pl/wzor/2026/03/06/14189/">
  <Naglowek>
    <KodFormularza kodSystemowy="FA_RR (1)" wersjaSchemy="1-1E">FA_RR</KodFormularza>
    <WariantFormularza>1</WariantFormularza>
    <DataWytworzeniaFa>2026-03-12T13:35:22Z</DataWytworzeniaFa>
  </Naglowek>
  <Podmiot1>
    <DaneIdentyfikacyjne>
      <NIP>1542169575</NIP>
      <Nazwa>rolniq</Nazwa>
    </DaneIdentyfikacyjne>
    <Adres>
      <KodKraju>PL</KodKraju>
      <AdresL1>rolnicza 1</AdresL1>
    </Adres>
  </Podmiot1>
  <Podmiot2>
    <DaneIdentyfikacyjne>
      <NIP>7335255579</NIP>
      <Nazwa>Domyślny sprzedawca</Nazwa>
    </DaneIdentyfikacyjne>
    <Adres>
      <KodKraju>PL</KodKraju>
      <AdresL1>ul. Sprzedawcowa</AdresL1>
      <AdresL2>00-000 Sprzedawcowo</AdresL2>
    </Adres>
  </Podmiot2>
  <FakturaRR>
    <KodWaluty>PLN</KodWaluty>
    <P_4A>2026-03-12</P_4A>
    <P_4B>2026-03-12</P_4B>
    <P_4C>sd/3/2026</P_4C>
    <P_11_1>3500</P_11_1>
    <P_11_2>245</P_11_2>
    <P_12_1>3745</P_12_1>
    <P_12_2>trzy tys. siedemset czterdzieści pięć PLN zero gr.</P_12_2>
    <RodzajFaktury>VAT_RR</RodzajFaktury>
    <FakturaRRWiersz>
      <NrWierszaFa>1</NrWierszaFa>
      <P_5>surowe frytki aka kartochle</P_5>
      <P_6A>kg</P_6A>
      <P_6B>500</P_6B>
      <P_6C>a</P_6C>
      <P_7>3</P_7>
      <P_8>1500</P_8>
      <P_9>7</P_9>
      <P_10>105</P_10>
      <P_11>1605</P_11>
    </FakturaRRWiersz>
    <FakturaRRWiersz>
      <NrWierszaFa>2</NrWierszaFa>
      <P_5>surowy popcorn aka qqrydza</P_5>
      <P_6A>kg</P_6A>
      <P_6B>400</P_6B>
      <P_6C>a</P_6C>
      <P_7>5</P_7>
      <P_8>2000</P_8>
      <P_9>7</P_9>
      <P_10>140</P_10>
      <P_11>2140</P_11>
    </FakturaRRWiersz>
    <Platnosc>
      <FormaPlatnosci>1</FormaPlatnosci>
      <RachunekBankowy1>
        <NrRB>PL78109024023774931911279398</NrRB>
        <NazwaBanku>banq rolnika</NazwaBanku>
      </RachunekBankowy1>
      <RachunekBankowy2>
        <NrRB>PL44109024023458628838425744</NrRB>
        <NazwaBanku>banq S.A.</NazwaBanku>
      </RachunekBankowy2>
    </Platnosc>
  </FakturaRR>
  <Stopka>
    <Rejestry>
      <KRS>1234567890</KRS>
    </Rejestry>
  </Stopka>
</Faktura>