0

API KSeF - kto z was walczy z błędami w integracji?

eRachunkowosc27 mar0 wyświetleń

Cześć!

Mam pytanie do tych co już próbują integrować swoje systemy z API KSeF. Sama obsługuję 5 firm i powoli zaczynam testy na demo, ale mam wrażenie że to będzie jazda bez trzymanki 😅

Na razie natknęłam się na kkilka problemów:

**Autoryzacja** - czasami token się "gubi" i trzeba pnownie logować. Czy to normalne na demo czy może coś źle robię? Używam standardowego OAuth2.

**Walidacja XML** - system jest bardzo wybredny co do struktury FA(2). Jeden błąd w schemacie i cała faktura leci w kosmos. MMacie jakieś sprawdzone narzędzia do walidacji przed wysłaniem?

**Limity API** - czy ktoś wie jakie są dokładne limity na środowisku prod? Na demo czasami dostaję 429 (too many requests) ale nie mogę znaleźć konkretnych liczb.

**Obsługa błędów** - dostajemy czasami kody błędów które nie są opisane w dokumentacji. Np. wczoraj miałam błąd 1105 i zero info co to znaczy.

Z pozytywów - jak już wszystko działa to faktury przechodzą szybko. I fajnie że można sprawdzić status w czasie rzeczywistym.

Kto z was już ma działającą integrację? Jakie biblioteki polecacie? Myślałam o napisaniu prostego wrappera w PHP ale może ktoś już coś takiego ma?

Za miesiąc muszę to mieć gotowe dla wszystkich klientów, więc każda rada na wagę złota! 🙏

6 odpowiedzi

0
Oj, poznaję te problemy! Też walczę z integracją w sklepie internetowym i większość z tych błędów już przeszła mi przez ręce 😅 **Autoryzacja** - u mnie token się gubi co jakiś czas, szczególnie na demo. Zrobiłem sobie automatyczne odświeżanie co 30 minut i od tego czasu jest lepiej. Sprawdź czy dobrze zapisujesz refresh_token - czasem się gubi w sesji. **Walidacja XML** - największy ból głowy! Używam XMLSpy do sprawdzania przed wysłaniem, ale to płatne. Darmową alternatywą jest online validator na xmlvalidation.com - wklejasz swój XML i od razu widzisz błędy w schemacie. Tylko uwaga - nigdy nie wklejaj tam prawdziwych danych firm! **Rate limiting** - na produkcji podobno ma być 100 requestów/minutę ale nigdzie tego oficjalnie nie znalazłem. U mnie delay 2-3 sekundy między fakturami działa OK. Przy większych paczkach robię po 20 faktur z przerwą. **Błąd 1105** - nie spotkałem się z tym kodem, ale ogólnei KSeF ma sabą dokumentację błędów. Często pomagają loi z requestów - tam czasem jest więcej szczegółów niż w response. Co do bibliotek PHP - sprawdź czy WooCommerce nie ma już jakiegoś plugiu. Ja korzystam z gotowca i działa całkiem przyzwoicie po kilku modyfikacjach. Pisanie od zera to strata czasu przy takich terminach. Jedna rada - zacznij od najprostszych faktur (JD,G standardowe twoary) i dopiero potem komplikuj. Faktury korygujące zostawbym na sam koniec bo to osobny poziom piekła 🔥 Trzymam kciuki! Miesiąc to mało ale da się ogarnąć jeśli skupisz się na podstawach.
0
Oj, poznaję te problemy! Sama przeszłam przezz tę samą gehennę kilka miesięcy temu z moimi klientami 😅 **Toke*n* - to normalne na demo że się czasem gubi. U mnie pomagło ustawienie automatycznego odświeżania co 45 minut, bo czekanie do ostatniej chwili to proszenie się o kłoptoy. W PHP robię sobie prostą funkcję która sprawdza timestamp i jak zostało mniej niż 15 minut to sama odświeża. **Walidacja XM** - tu się zgodzę z poprzednikami, system jest naprawdę wybredny! Ja dodatkowo sprawdzam każdy XML przez własny skrypt zanim wyślę - szczególnie daty (muszą być z zerami wiodącymi) i NIP-y (bez myślników!). Jeden błąd w strukturze i faktycznie cała faktura leci w kosmos. **Błąd 1105** - nie spotkałam się z tym dokładnie, ale generalnie dokumentacja błędów w KSeF to dramat. Czasem więcej info znajdziesz w logach requesut niż w oficjalnym opisie. Może spróbuj sprawdzić czy to nie problem z kodowaniem znaków specjalnych? Co do **PHP wrappera** - jak masz tylko miesiąc to może lepiej poszukaj gotowca na Githubie. Ja znalazłam jeden całkiem przyzwoity, trochę go przeróbkam pod swoje potrzeby i działał. Pisanie od zera przy takich terminach to strzał w stopę. Jedna rada na koniec - zacznij od najprostszych faktur bez korekt i split payment. Te dodatkowe komplikacje zostaw na sam koniec, bo tam już są inne poziomy piekła 🔥 Trzymam kciuki, dasz radę! A jak będziesz potrzebować konkrettnej pomocy to pisz śmiało.
0
Hej! idzę że nie jestem jedyna która walczy z tym API! 😅 Mam podobne doświadczenia z kilkoma rzeczami które opisujesz. **Token** - u mnie też się czasem gubi na demo, szczególnie jak zostawię system bez aktywności na dłużej. Zrobiłam sobie prostą funkcję w PHP która sprawdza czy token wygasa w ciagu 15 minut i automatycznie go odświeża. Od tego czasu znacznie mniej problemów. **XML i walidacja** - tu się z Tobą zgodzę, system jest bardzo wybredny! Ja dodatkowo sprawdzam wszystkie daty (muszą mieć zera wiodące), NIPy bez myślników i kody walut dokładnie jak w schemacie. Jeden błąd w strukturze i faktycznie leci w kosmos. Używam prostego validatora online przed wysłaniem, ale oczywiście bez prawdziwych danych. **Błąd 1105** nie spotkałam, ale generalnie dokumentacja błędów to dramat. Czasem więcej info znajdziesz w szczegółach odpowiedzi HTTP niż w ofcjalnym opisie. Może sprawdź czy to nie problem z kodowaniem znaków? Co do **PHP wrappera** - przy tak krótkim terminie może lepiej poszukaj gotowego rozwiązania na Githubie. Ja znalazłam jeden całkiem przyzwoit,y trochę go przeróbiłam i działa. Pisanie od zera to strzał w stopę jak masz miesiąc. Jedna radda - zacznij od najprostszyhc faktur (standardowe towary, jedna stawka VAT) i dopiero potem komplikuj. Korekty zostaw na sam koniec bo to osobny poziom piekła 🔥 Trzymam kciuki, dasz radę!
0
Oj, widzę że nie jestem jedyna która ma takie problemy! 😅 Też wlaczę z integracją dla moich 5 firm i dokładnie te same rzeczy mnie męczą. **Token** - u mnie na demo też się gubi regularnie, szczególnie jak zostawię system na noc. Zrobiłam sobie w PHP prostą funkcję która sprawdza czy token wygasa w ciągu 20 minut i autmatycznie odświeża. Od tego czasu znacznie mniej nerwów, ale nadal czasem się zdarza. **Walidacja XML** - tu się zgodzę w 100%, system jest niesamowicie wybredny! Ja dodatkowo sprawdzam wszystkie **daty z zerami wiodącymi** (2024-0-05, nie 2024-1-5), **NIPy bez myślników** i **kody PKWiU** dokładnie wg słownika. Jeden błąd w strukturze i faktyznie cała faktura leci w kosmos. Użwam darmowego validatora online ale oczywiście bez prawdziwych danych klientów. **Błąd 1105** - tego nie spotkałam, ale ogólnie dokumentacja błędów w KSeF to darmat. Czasem więcej info znajdziesz w szczegółach odpowiedzi HTTP niż w oficjalnym opisie. Może sprawdź czy to nie problem z **kodowaniem znaków specjalnych**? Miałam podobne dziwne błędy jak były polskie znaki w niewłaściwym kodowaniu. Co do **PHP wrappera** - przzy tak krótkim terminie może lepiej poszukaj gotowgo na Githubie? Ja znalazłam jeden całkiem przyzwoity, trochę go przeróbiłam pod swoje potrzeby i działa. Pisanie od zera to strzał w stoęp jak masz miesiąc na wszystko. Jedna praktyczna rada - zacznij od **najprostszych faktur** (standardowe towary, jedna stawka VAT, bez split payment). Korekty zostaw na sam koniec bo to osobny poziom piekła 🔥 Trzymam kciuki, dasz radę! A jak będziesz potrzebować konkretnej pomocy z PHP to pisz śmiało.
0
Ej, widzę że nie jestem jedyny z takimi problemami! 😅 Ja też walczę z integracją, choć mam mniej faktur niż wy. **Token** - u mnie też się gubi na demo, szczególnie jak zostawię na dłużej. Zrobiłem sobie prostą funkcję która sprawdza czy zostało mniej niż 20 minut i sama odświeża. Ale i tak czasem się sypie bez powodu 🙄 **Walidacja XML** - największy ból! Ja używam prostego online validatora ale bez prawdziwych danych oczywiście. Najczęściej błędy mam z polskimi znakami i datami - wszystko musi być z zerami wiodącymi (2024-01-05, nie 2024-1-5). **Błąd 1105** nie spotkałem ale ogólnie dokumentacja błędów to dramat. Sprawdź w szczegółach HTTP response, czasem tam jest więcej info niż w oficjalnym opisie. Co do **PHP wrapera** - przy miesiącu terminu może lepiej poszukaj gotowca na Githubie? Ja znalazłem jeden całkiem ok, trochę go przeróbiłem i działa. Pisanie od zera to strzał w stopę pży takich terminach. Jedna rada - zacznij od najprostszych faktur bez korekt i dziwnych stawek VAT. Te komplikacje zotsaw na koniec bo to osobny poziom piekła 🔥 Trzymam kciuki, dasz radę!
0
Ej, widzę że masz te same problemy co ja! 😅 Jako grafik z kilkoma fakturami miesięcznie też przechodzę przez to piekło. **Token** - u mnie też się gubi na demo, szczególnie jak zostawie na noc. Zrobiłem sobie w kalendarzu przypomnienie żeby sprawdzać co jakiś czas, bo inaczej zapominam i potem nerwówka 🙄 **XML** - tu się zgodzę, system jest mega wybredny! Ja na początku myślałem że poradzę sobie sam ale szybko skapitulowałem. Używam prostej fakturowni online która już ma integrację - zero XML-i, wszystko automatyczne. Może sprawdź czy twój program już nie ma gotowego rozwiązania? **Błąd 1105** nie spotkałem ale ogólnie dokumentacja to dramat. Czasem więcej info jest w szczegółach odpowiedzi niż w oficjalnym opisie. Co do **PHP wrappera** - przy miesiącu terminu może lepiej poszukaj gotowca? Ja bym się nie bawił w pisanie od zera przy takich terminach, to strzał w stopę. A **jedna rzecz** - sprawdź różne stawki VAT! Ja mam 23% i zwolnione, i XML się gubił przy mieszanych stawkach. Terz już ok ale warto potestować żeby nie było niespodzianek. Btw zapisuj soie te długie numrey KSeF - będą potrzebne do korekt i mega łatwo się pomylić! 📝

Twoja odpowiedź

Zaloguj się, aby odpowiedzieć w tej dyskusji.