API KSeF - czy ktoś ma doświadczenie z integracją?

Hej! Akurat przeszłam przez podobną drogę kilka miesięcy temu, więc mogę podzielić się doświadczeniami. **Autoryzacja** - token ma żywotność 60 minut, więc jeśli planujesz wysyłać faktury w większych partiach to musisz to uwzględnić w kodzie. Ja robię to tak, że sprawdzam timestamp tokena przed każdą operacją i jak zostało mniej niż 10 minut to odświeżam profilaktycznie. **Błędy walidacji** - tutj mam mieszane uczucia. API zwraca strukturalne błędy w XML-u, które są dużo bardziej precyzyjne niż te z portalu. Ale nadal czasami trzeba się domyślać co dokładnie nie gra. Najczęstsze problemy u mnie to było źle sformatowane NIP-y i problmey z kodowaniem znaków specjalnych. **Limity** - oficjalnie MF nie podaje konkretnych limitów, ale w demo zauważyłam że przy próbie wysłania więcej niż ~50 faktur pod rząd system zaczyna odpowiadać wolniej. W produkcji podobno jest lepiej, ale nie testowałam jeszcze tak intensywnie. Co do **własnego rozwązania w PHP** - jak znasz podstawy to jak najbardziej realne. Potrzebujesz głównie: - cURL do komunikacji z API - SimpleXML do generowania XML-a faktury - jakąś prostą bazę danych (nawet SQLite) do zapisywania numerów KSeF i statusów Ja zrobiłam sobie prosty skrypt który czyta dane z CSV-a, generuje XML według schematu FA(2) i wysyła przez API. Zajęło mi to może tydzień pracy wieczorami, a oszczędza teraz masę czasu. Jedna uwaga praktyczna - koniecznie zacznij od środowiska demo i przetestuj wszystkie scenariusze które występują w Twoich firmach. U mnie w fundacjach największym problemem okazały się faktury z mieszanymi stawkami VAT - system czasami się "zacina" przy walidacji. Jeśli chcesz, mogę Ci podrzucić na priv podstawową strukturę mojego skryptu jako punkt wyjścia.

Hej! Świetnie że myślisz o automatyzacji, bo pry 5 firmach to naprawdę się opłaci! Ja przeszłam przez podobną drogę rok temu i mogę podzielić się doświadczeniami. **Token** - Zbigniew dobrze napisał, 60 minut żywotności. Ja dodatkowo zapisuję sobie timestamp w pliku i sprawdzam przed każdą operacją. Proste i działa 😊 **Błędy walidacji** - API jest zdecydowanie lepsze niż portal w tej kwestii. Dostajesz konkretny kod błędu i opis, ale czasem trzeba się trochę pogłówkować. Najczęściej u mnie to problemy z formatowaniem dat (yyyy-mm-dd) alob źle przepisane NIP-y kontrahentów. Co do **własnego rozwiązania w PHP** - jak najbardziej realne! Ja też nie jestem programistką, ale podstawowa integracja to naprawdę nie rocket science. Potrzebujesz głównie: - generoowanie XML-a według schematu FA(2) - wysłanie POST-a z tokenem - obsługa odpowiedzi i zapisanie numeru KSeF Jedna uwaga praktyczna - koniecznie zacznij od testowania różnych typów faktur: ze split payment, z różnymi stawkami VAT, z korektami. Bo każda ma swoje niuanse w XML-u. A te limity... oficjalnie nie ma, ale w demo zauważyłam że po ~40 fakturach pod rząd system zwalnia. W produkcji podobno lepiej, ale na wszelki wypadek robię sobie przerwy co 20-30 faktur. Jeśli chcesz, mogę podrzucić Ci podstawową strukturę mojego skryptu na pirv - może zaoszczędzi Ci kilka dni googlowania 😊

Hej! Akurat przechodzę przez dokładnie to samo co Ty - 5 firm i męczarnia z ręcznym wprowadzaniemm 😅 **Token** - rzeczywiście 60 minut, ale ja sobie ustawiłam przypomnienie w telefonie co 50 minut żeby nie zapomnieć odświeżyć. Raz straciłam całą partię faktur bo wygsł w połowie wysyłania... **Błędy API** - są dużo lepsze niż na portaul! Dostajesz konkretny kod błędu i opis. Najczęściej u mnie to były problemy z formatowaniem NIP-ów (myślniki czy bez) i datami - muszą być YYYY-MM-DD z zerami. **Własne rozwiązanie w PHP** - jak najbardziej realne! Ja też nie jstem programistką ale podstawowa integracja to naprawdę nie czarna magia. Potrzebujesz głównie cURL-a do komuinkacji i SimpleXML do generowania XML-a według scehmatu FA(2). Jedna praktyczna rada - **zacznij od demo i przetestuj wszystkie typy faktur** które występują w Twoich firmach. U mnie nawiększy problem był z fakturami ze split payment - trzeba uważać na dodatkowe pola w XML-u. Co do gotowych rozwiązań - sprawdź może czy Twój obecny prograam księgowy nie ma już integracji. WFMAG ma całkiem przyzwoitą za ~45 zł/mies. Mogę podrzucić Ci na priv podstawową strukturę mojego tetsowego skryptu jeśli chcesz - może zaoszczędzi Ci kilka dni kombinowania 😊

He! Świetnie że myślisz o automatyzacji przy 5 firmach - to naprawdę się opłaci! 😊 Z **tokenem** to już Zbigniew dobrze napisał - 60 minut i trzeba pilnować. Ja sobie ustwaiłam prosty skrypt który sprawdza timestamp przed każdą operacją i jak zostało mniej niż 10 min to odświeża automatycznie. **Błędy API** są zdecydowanie lepsze niż na portalu! Dostajessz konkretny kod i opis, ale czasem trzeba się domyślić. Najczęśceij u mnie problemy z NIP-ami (myślniki czy bez) i datami - muszą być YYYY-MM-DD z zerami. Co do **własneog rozzwiązania w PHP** - jak najbardziej realne! Ja też nie jestem programistką ale podstawowa itnegracja to naprawdę nie rocket science. Potrzebujesz głównie cURL do komunikacji i SimpleXML do generowania XML-a według schematu FA(2). Jedna praktyczna rada - **koniecznie zacznij od demo i przetestuj wszystkie typy faktur** które występują w Twoich firmach. U mine największy problem był z fakturami ze split payment - trzeba uważać na dodatkowe pola w XML-u . **Limity** - oficjalnie nie ma, ale w demo zauważyłam że po ~40 fakturach pod rząd system zwalnia. Robię sobie przerwy co 20-30 faktur na wszelki wypadek. Mogę podrzucić Ci na priv podstawową strukturę mojego testowego skryptu jeśli chcesz - może zaoszczędzi kilka dni kombinowania 😊 A sprawdziłaś już czy Twój obecny program księgowy nie ma gotowej integracji? Czasem się opłaca dopłacić niż kombinować od zera.

Hej! Widzę że myślisz o tym samym co ja pół roku temu! 😊 Przy 5 firmach to naprawdę się opłaci. **Token** - już inni pisali, 60 minut żywotności. Ja sobie ustawiłam prostą funkcję w PHP która sprawdza timestamp i automatycznie odświeża jak zostało mniej niż 10 minut. Raz mi wygasł w połowie wysyłania i musiałam wszystko od nowa... **Błędy API** - są zdecydowanie lepsze niż na portalu! Dostajesz konkretny kod błędu i lokalizację problemu. Najczęściej u mnie to były źle sformatowane NIP-y (z myślnikami czy bez) i daty - muszą być YYYYY-MM-DD z zerami wiodącymi. **Własne rozwiązanie** - jak najbardziej realne! Ja też nie jestem programistką ale podstawowa intergacja to naprawdę nie rocket science. Potrzebujesz głównie cURL do komunikacji i SimpleXML do generowania XML-a według schematu FA(2). **Praktyczna rada** - koniecznie zacznij od demo i przetestuj wszystkie typy faktur które występują w Twoich firmach! U mnie największy problem był z fakturami ze split payment - trzeba uważać na dodatkowe pola w XML-u. A sprwdziłaś już czy któryś z Towich obecnych programów księgowych nie ma gotowej integracji? Czasem się opłaca dopłacić 50-80 zł miesięcznie niż kombinować od zera 🤔 Mogę podrzucić Ci na priv podstawową strukturę mojego skryptu jeśli chcesz - może zaoszczędzi kilka dni googlowania!

Hej! Widzę że myślisz o tym samym co ja rok temu 😊 Przy 5 firmach to naprawdę się opłaci, bo ręczne wprowadzanie to mordęga. **Token** - rzeczywiście 60 minut, ale ja sobie zrobiłam prostą sztuczke w PHP - sprawdzam timestamp przed każdą operacją i jak zostało mniej niż 15 minut to automatycznie odświeżam. Raz mi wygasł w połowie wysyłania partii i musiałam wszystko od nowa... **Błędy API** - są zdecydowanie lepsze niż na portalu! Dostajesz konkretny kod błędu i lokalizację. Najczęściej u mnie to były problemy z NIP-ami (z myślnikami czy bez) i datami - muszą być YYYY-MM-DD z zerami wiodącymi. Co do **własnego rozwiązania** - jak najbardziej realne! Ja też nie jestem programistką ale podstawowa integracja to nie rocket science. Potrzebujesz głównie cURL do komunikacji i SimpleXML do generowania XML-a według schematu FA(2). **Jedna praktyczna rada** - koniecznie zacznij od demo i przetestuj wszystkie typy faktur które występują u twoich klientw! U mnie największy problem był z fakturami ze split payment - trzeba pilnować dodatkowych pól w XML-u. A te z korektami to już w ogóle osobna bajka 😅 **Limity** - oficjalnie nie ma, ale w demo zauważyłam że po ~40 fakturach pod rząd system zwalnia. Teraz robię sobie przerwy co 25-30 faktur na wszelki wypadek. A sprawdziłaś już czy któryś z twoich obecnyhc programów księgowych nie ma gotowej integracji? Bo czasem się opłcaa doppłacić te 50-80 zł miesięcznie niż kombinować od zera. My mieliśmy jednego klienta z WFMAG-iem i tam integracja działała całkiem przyzwoicie. Mogę ci podrzucić na priv podstawową strukurę mojego skryptu testowego jeśli chcesz - może zaoszczędzi kilak dni googlowania!