Import faktur i wysyłka do KSeF

[bennetsadyba]

Cześć,
na wstępie mega dziękuję, że miałeś chęci ogarnąć taki skrypt 👍 zaoszczędzi mi to tonę czasu!
Ja generuję paczkę ok 1400 faktur, zamierzam je zaimportować do skryptu i wysłać do KSeF-u za jednym razem.
Myślisz, że skrypt poradzi sobie z wysyłką "na raz"? Czy trzeba się spodziewać problemów?
Wysyłka faktur jest "w pętli" + otrzymanie UPO czy jakoś inaczej jest to rozwiązane?
Jak wygląda wysyłka w przypadku błędu walidacji pojedyńczej faktury po stronie KSeF? - cała wysyłka się zatrzyma czy tylko dana faktura "wypadnie"?

[toudi]

o kurdę - nigdy nie próbowałem aż tak ogromnej ilości faktur - program miał być w założeniu dla mikro i małych przedsiębiorców :D

tu jest kilka zazębiających się kwestii. po pierwsze są dwa tryby wysyłki - wsadowa (batch) i interaktywna. w interaktywnej jest tak że wysyłasz faktury jedna za drugą i jak jedna się wywali to wtedy musisz poprawić tylko tą jedną. we wsadowej pakujesz je do archiwum i wysyłasz raz (czyli jest tylko 1 request). w starym ksef było tak że jak jedna się wywaliła to nie przechodziła cała paczka. czy jest tak teraz - nie mam pojęcia :(

po zakończonej wysyłce program zapisuje numer sesji do pliku. upload przewiduje też tryb synchroniczny (czyli czeka na przetworzenie sesji) ale dla ponad 1000 faktur to na bank potrwa. wtedy używasz komendy sync i ona pobiera UPO i nadane numery KSeF

teraz to co najistotniejsze - obowiązują limity dla requestów do API których mój program póki co nie respektuje - więc prawdopodobnie coś się wywali

najlepiej byłoby gdybyś sobie to najpierw przetestował na środowisku testowym (flaga -t)

[bennetsadyba]

wiedziałem o tych trybach - odpuściłem sobie tryb wsadowy bo, dokładnie tak jak piszesz, jak wywali się jedna faktura to cały plik zostaje odrzucony. Co więcej walidacja pliku kończy się na pierwszym błędzie więc w najgorszym przypadku (przy wielu błędach) szukuje się niezła rzeźba :) Widziałem dobry art na ten temat, mogę podesłać.

Biorę pod uwagę tylko tryb interaktywny. Czas wykonania nie ma dla mnie większego znaczenia, pod warunkiem, że skrypt nie potrzebuje nadzoru.
Ja właśnie trochę o te limity pytam - widziałem, że ktoś już podnosił tu ten temat przy pobieraniu faktur, ale jak rozumiem wysyłka też jest nimi obarczona.

[bennetsadyba]

stan na 22.11.2025 dla pobierania interaktywnego:

Endpoint req/s req/min req/h
Otwarcie sesji interaktywnej POST /sessions/online 10 30 120
Wysłanie faktury * POST /sessions/online/{referenceNumber}/invoices 10 30 180
Zamknięcie sesji interaktywnej POST /sessions/online/{referenceNumber}/close 10 30 120

Przy limicie 120 req/h to już widzę, że muszę się polubić z wysyłką wsadówą :)
Czy Twój skrypt obsługuje taką wsadową wysyłkę?

[toudi]

tak, obsługuje - podajesz flagę --upload.batch. najpierw musisz zaimportować faktury komendą import - ten etap masz już za sobą ?

[maryush]

Czekajcie, wtrącę się w środek Waszej rozmowy, czy tryb wsadowy nie miał w 2.0 działać właśnie tak, że wrzucasz paczkę i jak wypieprzy się na jednej z faktur to kolejne przelatuje dalej? Po to są one jako osobne pliki xml w pakiecie wrzucane afaik. To pierwsza rzecz, druga rzecz, limity na bank będą problemem - to to z czym sam walczę obecnie i w drugim wątku mam głupie pomysły na rozwiązanie (u mnie jest masowe pobieranie :P), ale wracając do tematu.

Wysyłkę pakietem testuje kolega, ma tam innego typu problem, prawdopodobnie jest związany z uprawnieniami nadanymi przez podmiot, bo nie może upo pobrać, samo wysłanie nie wiemy czy przeszło prawidłowo, paczka była mała - raptem 2 faktury (testowo) i prawdopodobnie się wysłała.

Zaczynam coraz bardziej zastanawiać się, czy nie jest jednak rozsądnie zrobić kroków jak pisałem, u mnie lista, iteracja osobno po liście z zapisem po każdej fakturze, tu lista wysyłkowa, paczka, wysłanie i iteracja z możliwością ograniczenia ilości dla upo - w sumie i przy sync i przy pobraniu faktur i przy pobraniu upo może być ten sam switch --limit N i może to by jakoś rozwiązało na szybko kwestię limitów zapytań bez ogromnej zmiany w programie samym?

@bennetsadyba 120 to jest bzdura raczej w tym momencie (zmieniali limity, są inne niż w dokumentacji...), obecnie przy odbiorze/sync masz 16 req na minutę, jak za często to zrobisz masz info o banie bo maksymalnie możesz 20 zapytań zrobić na godzinę!

time=2026-02-06T15:01:23.978+01:00 level=DEBUG msg=response body="{\"status\":{\"code\":429,\"description\":\"Too Many Requests\",\"details\":[\"Przekroczono limit 20 żądań na godzinę. Spróbuj ponownie po 1902 sekundach.\"]}}"

[toudi]

@bennetsadyba sorry za późną odpowiedź. od momentu kiedy napisałeś wyłapałem sporo błędów, ale (co bardziej istotne) doimplementowałem obsługę pobierania faktur przez tryb eksportu (1 request który pobiera paczkę zip) oraz doimplementowałem obsługę rate limitingu (jeszcze nie wszystkie requesty są poprawnie oflagowane ale dodam to niedługo)

gdybyś miał dodatkowe pytania - daj znać