Płatność online, potwierdzenie i faktura w KSeF bez ręcznej pracy. Wspólny moduł rozliczeń, który działa produkcyjnie w XL8, Koncertuj i Zadomo.
Działa produkcyjnie w trzech aplikacjach: XL8, Koncertuj i Zadomo.
Własny projekt Localize.pl, a nie realizacja dla klienta.
Aplikacja, która przyjmuje płatności online w Polsce, po każdej udanej płatności musi wystawić poprawną fakturę FA(3) w KSeF. Nie może jej wystawić dwa razy ani wystawić jej wtedy, gdy płatność nie doszła.
Zamiast pisać to trzy razy, zbudowaliśmy jeden moduł dla trzech aplikacji.
Identyfikator płatności działa jak klucz, który nie pozwala wystawić faktury dwa razy, a numer faktury jest zajmowany w jednej, niepodzielnej operacji. Ponowione powiadomienie z bramki albo równoległe zadanie w tle nie wystawią drugiej faktury.
Moduł porównuje kwotę z bramki z pozycjami faktury. Przy niezgodności faktura nie powstaje.
Faktury dla firmy nie da się zbudować z ręcznie wpisanych danych: kod wymaga wyniku weryfikacji NIP, więc wersja bez niej po prostu się nie skompiluje.
Faktury dla firm i konsumentów oraz korekty, także ze stawkami w sprzedaży zagranicznej (WDT, eksport, odwrotne obciążenie), sprawdzane względem oficjalnego schematu XSD.
Integracja Autopay przyjmuje powiadomienia ITN z weryfikacją podpisu i obsługuje zwroty. O statusie płatności decyduje serwer bramki, a nie przekierowanie w przeglądarce.
| Technologia | Rola |
|---|---|
| TypeScript, Node.js | Moduł KSeF bez zależności zewnętrznych w czasie działania |
| KSeF 2.0 (API v2), FA(3), XSD | Wystawianie i walidacja faktur |
| Autopay | Płatności, powiadomienia ITN i zwroty |
| Testy automatyczne | Faktury dla firm i konsumentów, korekty, ponowienia |
Moduł KSeF i integracja Autopay działają produkcyjnie w XL8, Koncertuj i Zadomo. Moduł KSeF jest wspólnym, wersjonowanym pakietem z testami automatycznymi, a integracja Autopay ma osobną implementację w każdej z aplikacji. Przykłady na tej stronie nie zawierają prawdziwych danych firm ani nabywców.
Stan na 28 września 2026.
Opowiedz o swoim procesie. Sprawdzimy, czy podobne podejście ma u Ciebie sens.
Umów konsultację→