Nordlet

← Blog

Rozliczenie unijnego podatku VAT w czasie rzeczywistym dla programistów tworzących w Polsce

Rzetelne porównanie platform księgowo-podatkowych obsługujących polski i unijny VAT za pomocą interfejsów API, zestawów SDK i webhooków, z jasnym wskazaniem, co dokładnie oferuje każde z rozwiązań.

Nordlet Team · · 13 min. czytania

Polska zmieniła zasady gry w 2026 roku. Krajowy System e-Faktur stał się obowiązkowy w lutym dla największych przedsiębiorств, a w kwietniu dla niemal wszystkich pozostałych. Polską fakturą jest obecnie dokument XML w formacie FA(3) z identyfikatorem KSeF, a nie plik PDF. Do tego dochodzi plik JPK_V7M, który nie jest zwykłą deklaracją VAT z osobnym eksportem ewidencji, lecz jednym plikiem łączącym oba te elementy. Dostawca oprogramowania, który twierdzi, że obsługuje „polski VAT”, mając na myśli wyłącznie stawkę 23%, opisuje jedynie niewielki wycinek całego zagadnienia.

W tym artykule porównujemy platformy przeznaczone dla programistów, które obsługują unijny i polski VAT w czasie rzeczywistym, rozdzielamy obliczenia od księgowości i sprawozdawczości oraz wskazujemy, do jakich zastosowań faktycznie pasuje poszczególne rozwiązanie.

Co musi obejmować „zarządzanie unijnym podatkiem VAT w czasie rzeczywistym”

To określenie jest często nadużywane w odniesieniu do bardzo różnych produktów. Aby miało ono jakikolwiek sens, platforma musi realizować większość poniższych zadań w momencie tworzenia transakcji, faktury, rozliczenia lub wpisu w księdze rachunkowej:

  • Określać zasady opodatkowania VAT na podstawie danych transakcyjnych.
  • Uwzględniać aktualne przepisy krajowe oraz specyfikę produktów.
  • Obsługiwać Polskę oraz pozostałe kraje UE, w tym procedurę odwrotnego obciążenia (reverse charge) w obrocie B2B oraz opodatkowanie w miejscu konsumpcji w transakcjach B2C.
  • Udostępniać te możliwości za pośrednictwem interfejsu API, zestawu SDK lub webhooków.
  • Przechowywać dane na potrzeby rozliczeń VAT, unijnej procedury OSS, audytu oraz sprawozdawczości księgowej.

Pod pojęciem „czasu rzeczywistego” kryją się trzy różne funkcje:

  • Obliczenia w czasie rzeczywistym - podatek VAT jest wyliczany w momencie tworzenia transakcji lub faktury.
  • Księgowość w czasie rzeczywistym - transakcja, zapis w księdze oraz dane dotyczące VAT trafiają do ksiąg natychmiast.
  • Sprawozdawczość w czasie rzeczywistym - dane są przekazywane do organu podatkowego wkrótce po dokonaniu transakcji.

Większość produktów radzi sobie z pierwszym zadaniem. Niewiele z nich obsługuje wszystkie trzy. Polska znajduje się obecnie zdecydowanie w trzeciej kategorii: uwierzytelnianie faktur w KSeF oraz plik JPK_V7M będący połączeniem deklaracji i ewidencji sprawiają, że administracja skarbowa widzi szczegóły transakcji, a nie tylko sumy kontrolne.

Polskie i unijne przepisy kształtujące to porównanie

W Polsce obowiązuje stawka podstawowa 23%, stawki obniżone 8% i 5% oraz stawka 0% dla eksportu i wewnątrzwspólnotowej dostawy towarów, zgodnie z ustawą o podatku od towarów i usług (ustawa o podatku od towarów i usług). Limit rejestracji wzrósł 1 stycznia 2026 roku do 240 000 PLN z wcześniejszych 200 000 PLN. Ponieważ Polska posługuje się złotym, każda platforma zakładająca wszędzie kwoty w euro będzie wymagała reguł przeliczania i zaokrąglania, które przetrwają ewentualną kontrolę skarbową.

W przypadku kwalifikującej się wewnątrzwspólnotowej sprzedaży na odległość B2C oraz transgranicznych usług cyfrowych, unijny próg wynosi 10 000 EUR, co zostało określone na portalu One Stop Shop Komisji Europejskiej. Powyżej tej kwoty podatek VAT jest co do zasady odprowadzany zgodnie z przepisami państwa członkowskiego, w którym znajduje się klient. Procedura One Stop Shop pozwala firmie zarejestrować się w jednym państwie członkowskim i deklarować transgraniczny VAT B2C dla całej Unii Europejskiej, jednak nie zwalnia to z konieczności stosowania logiki podatkowej na poziomie pojedynczych transakcji.

Istnieje również zasada dotycząca platform handlowych (marketplace), która jest surowsza, niż spodziewa się większość zespołów. Zgodnie z artykułem 14a interfejs elektroniczny staje się uzniwanym dostawcą (deemed supplier) w przypadku sprzedaży na odległość towarów importowanych w przesyłkach o wartości nieprzekraczającej 150 EUR, a także odrębnie w przypadku towarów dostarczanych klientom unijnym o dowolnej wartości, jeżeli sprzedawca nie ma siedziby w Unii Europejskiej. Wytyczne Komisji Europejskiej dotyczące przepisów o VAT w handlu elektronicznym opisują oba te przypadki. Jeśli tworzysz platformę typu marketplace, zmienia to architekturę systemu, a nie tylko dodaje kolejne pole w bazie danych.

Krótki przegląd platform

Platforma Do jakich zastosowań pasuje najlepiej Możliwości w zakresie VAT w czasie rzeczywistym Zakres księgowości, OSS i sprawozdawczości Główny haczyk
Stripe Tax Produkty i platformy działające już na Stripe Oblicza VAT w momencie tworzenia transakcji (w tym dla Polski) Eksport danych do UE i OSS; brak polskiej księgi i brak samodzielnego składania deklaracji unijnych Opłacalna tylko wtedy, gdy Stripe jest już głównym operatorem płatności
Paddle Usługi SaaS i cyfrowe produkty do pobrania Oblicza VAT przy kasie na podstawie lokalizacji klienta Rejestruje, składa deklaracje i odprowadza podatek jako Merchant of Record Przejmuje rolę sprzedawcy (seller of record) wraz z obsługą faktur
Quaderno Mniejsze firmy SaaS i handel cyfrowy Oblicza podatek przy kasie, weryfikuje numery VAT Raporty podatkowe i ewidencja; automatyczne składanie deklaracji nie jest udokumentowane dla każdego planu Warstwa podatkowo-fakturowa, a nie pełna księga rachunkowa
Avalara AvaTax Korporacyjne systemy ERP i rozliczeniowe Określanie podatku w czasie rzeczywistym z aktualizowaną bazą przepisów Moduł VAT Reporting jest osobnym produktem w rodzinie Returns Zakres i cena dostosowane do wdrożeń korporacyjnych
Fonoa Tax Engine Duże platformy i marketplace'y Określanie podatku w czasie rzeczywistym w ponad 190 jurysdykcjach Deklaracje, e-fakturowanie i sprawozdawczość; weryfikacja numerów VAT to osobny produkt Brak publicznie dostępnego cennika
Nordlet Wbudowana księgowość wewnątrz platform i marketplace'ów Określa procedurę i stawki dla każdej transakcji, księgowane razem z wpisem w księdze Niezmienna księga podwójnego zapisu, wypłaty, dane OSS i IOSS, eksportowalny ślad audytowy Generuje plik XML JPK_V7M oraz strukturę KSeF FA(3); przesyłanie plików i sesje KSeF odbywają się poprzez mostek integracyjny

Stripe Tax: szybka ścieżka, gdy korzystasz już ze Stripe

Dla zespołów korzystających z płatności Stripe, modułu Billing lub Connect, Stripe Tax jest najbardziej dostępną warstwą obliczeniową działającą w czasie rzeczywistym. Dokumentacja omawia kwestie obliczania podatku VAT na całym świecie, korzystanie z interfejsu Tax API wraz z obiektami PaymentIntents, pobieranie podatku na fakturach oraz integrowanie usługi Tax z platformą Connect.

Ograniczenia Stripe są przedstawiane przez firmę wprost. W dokumentacji dotyczącej składania deklaracji wskazano: „Musisz samodzielnie składać deklaracje i odprowadzać podatek w każdym miejscu, w którym jesteś zarejestrowany”. Automatyczne składanie deklaracji jest oferowane w Stanach Zjednoczonych; w innych regionach Stripe współpracuje z partnerami, co oznacza, że unijną deklarację VAT składasz samodzielnie lub za pośrednictwem partnera, a nie poprzez Stripe Tax. Narzędzie to służy do obliczania i eksportu danych, a nie do prowadzenia pełnych ksiąg rachunkowych.

W przypadku wdrożenia w Polsce Stripe Tax kończy działania na długo przed dwoma elementami, które rzeczywiście zajmują najwięcej czasu: plikiem JPK_V7M oraz wysyłką do KSeF.

Paddle: powierzenie całej odpowiedzialności podatkowej komu innemu

Paddle reprezentuje zupełnie inną kategorię produktów. Działa jako Merchant of Record i przejmuje odpowiedzialność za „obliczanie, składanie deklaracji oraz odprowadzanie” podatku w miejscach, gdzie przebywają Twoi klienci. Oznacza to, że wylicza podatek VAT przy kasie, wystawia fakturę oraz zajmuje się rozliczeniami w Twoim imieniu. Dokumentacja dla programistów obejmuje bibliotekę Paddle.js, interfejsy API katalogu produktów, proces płatności (checkout) oraz webhooki, takie jak transaction.completed, który uruchamia się po osiągnięciu przez transakcję statusu completed i służy zazwyczaj do przyznawania dostępu po opłaceniu usługi.

Kompromis ma charakter strukturalny, a nie techniczny. Paddle staje się sprzedawcą rejestrowanym (seller of record), przez co tracisz kontrolę nad modelem handlowym, fakturowym i księgowym, jaki zachowałbyś przy własnym procesie płatności.

W przypadku produktów cyfrowych jest to czyste rozwiązanie problemu polskiego VAT-u od konsumentów. Nie rozwiązuje ono jednak żadnych obowiązków polskiej firmy w zakresie KSeF w odniesieniu do faktur krajowych.

Quaderno: warstwa podatková dla mniejszych biznesów cyfrowych

Quaderno to jedno z bardziej przejrzystych rozwiązań przyjaznych programistom, przeznaczone dla mniejszych firm cyfrowych, które chcą korzystać z usługi podatkowej niezależnej od jednego operatora płatności. Jego API udostępnia endpoint /tax_rates/calculate obliczający właściwą stawkę na podstawie adresu klienta i typu transakcji, endpoint /tax_ids/validate weryfikujący unijne numery VAT, a także zasoby do obsługi faktur, rachunków i korekt. Udokumentowana sekcja Connect z zasobami kont to element, na którym można zbudować platformę typu marketplace.

Ograniczeniem jest tu zakres działania. Quaderno to warstwa podatkowo-fakturowa, a nie system księgowy z niezmienną księgą podwójnego zapisu, a jego publiczne materiały nie potwierdzają automatycznego składania deklaracji w każdym planie i w każdym kraju. Kwestię odpowiedzialności za składanie deklaracji należy zawsze potwierdzić na piśmie.

Quaderno stanowi rozsądną warstwę płatniczą dla małego polskiego biznesu cyfrowego. Kwestie JPK_V7M i KSeF pozostają jednak poza jego zasięgiem.

Avalara oraz Fonoa: korporacyjne silniki podatkowe

AvaTax firmy Avalara realizuje kalkulację podatku w czasie rzeczywistym podczas płatności, fakturowania lub przetwarzania zamówień za pomocą interfejsów REST API i zestawów SDK. Warto zwrócić uwagę na podział produktów: moduł VAT Reporting funkcjonuje osobno w ramach pakietu Returns, co oznacza, że unijny proces zgodności z przepisami VAT to nie tylko samo „AvaTax” – należy dokładnie dobrać potrzebne moduły. Avalara udokumentowała ścieżkę rejestracji z 90-orokresowym okresem próbnym, podczas gdy komercyjny model produkcyjny jest skrojony pod duże przedsiębiorstwa.

Tax Engine od Fonoa deklaruje, że „oblicza prawidłowe traktowanie podatku pośredniego dla każdej transakcji w czasie rzeczywistym” za pośrednictwem wersji API obejmującej ponad 190 jurysdykcji. Istotny jest jeden szczegół architektoniczny: weryfikacja numerów podatkowych to osobny produkt Fonoa (Validate), a nie część Tax Engine. Jeśli więc dowód weryfikacji VIES ma dla Ciebie znaczenie, uwzględnij go w specyfikacji zamiast zakładać, że silnik go automatycznie zapewnia.

Polska to kraj, w którym korporacyjny silnik podatkowy uzasadnia swoją cenę, ponieważ zarówno KSeF, jak i pliki JPK są skomplikowane. Wciąż jest to jednak duży wydatek dla zespołu, który potrzebuje obsługi tylko jednego państwa.

Miejsce Nordlet: wynik kalkulacji VAT i zapis w księdze to ten sam rekord

Nordlet to interfejs API księgowości dla platform i marketplace'ów, które potrzebują ksiąg rachunkowych, wypłat, unijnych podatków oraz eksportowalnego śladu audytowego we własnym produkcie, zamiast aplikacji do fakturowania podpiętej do kasy.

Różnica architektoniczna polega na tym, że ustalenie podatku VAT oraz zapis księgowy należą do jednego systemu. Zapytanie POST /v1/reference/vat/resolve rozstrzyga kwestię opodatkowania na podstawie faktów dotyczących transakcji:

{
  "customerCountryCode": "PL",
  "customerIsBusiness": false,
  "supplyType": "digital"
}
{
  "scheme": "oss_union",
  "vatCountryCode": "PL",
  "reverseCharge": false,
  "deemedSupplier": false,
  "zeroRated": false,
  "rates": [
    { "category": "standard", "ratePercent": "23.00" },
    { "category": "reduced", "ratePercent": "8.00" },
    { "category": "reduced", "ratePercent": "5.00" }
  ],
  "legalBasis": "Directive 2006/112/EC art. 58 - taxable where the consumer resides; report via the Union OSS"
}

Po zmianie klienta na firmę z ważnym polskim numerem VAT, to samo wywołanie zwraca reverse_charge wraz z podstawą prawną Directive 2006/112/EC art. 44, 196 - VAT due by the customer (reverse charge). Ustawienie parametru actingAsMarketplace dla sprzedawcy spoza UE zwraca deemedSupplier: true na podstawie art. 14a(2). Podstawa prawna podróżuje razem z odpowiedzią, co stanowi kluczowy element w przypadku kontroli audytowej po latach.

Zamodelowano dziewięć schematów: domestic, intra_eu_b2b, reverse_charge, oss_union, ioss, marketplace_deemed, export, out_of_scope oraz sme_exempt. Próg sprzedaży na odległość wynoszący 10 000 EUR jest monitorowany, a nie domyślny – endpoint /v1/declarations/eu/distance-sales-threshold/get informuje o pozycji firmy względem limitu, zaś /v1/declarations/eu/oss/compute i /v1/declarations/eu/ioss/compute generują dane za okres rozliczeniowy, uwzględniając sekcję korekt dla poprzednich okresów. Stawki pochodzą z oficjalnego źródła TEDB Komisji Europejskiej wraz z datami ich wejścia w życie, a firmy mogą je nadpisywać dla poszczególnych krajów.

Wynik kalkulacji trafia bezpośrednio do niezmiennej księgi podwójnego zapisu z dołączonymi metadanymi VAT, dzięki czemu odpada konieczność przeprowadzania osobnego uzgadniania danych między silnikiem podatkowym a osobnym systemem ewidencji. Kwoty pieniężne są przechowywane jako ciągi znaków o stałej precyzji (decimal), nigdy jako liczby zmiennoprzecinkowe. Do dyspozycji są także: typowane zestawy SDK, webhooki takie jak sale_invoice.paid, obsługa nagłówka Idempotency-Key dla bezpiecznego ponawiania żądań, firmy testowe (sandbox), weryfikacja VIES zamrożona w momencie wystawienia faktury, obsługa wielu firm oraz blokowanie okresów rozliczeniowych zapobiegające cichej edycji zamkniętych miesięcy.

Polski zakres funkcjonalny jest najbardziej rozbudowany spośród krajów obsługiwanych przez Nordlet poza Litwą, choć nadal posiada pewne ograniczenia. Wywołanie /v1/declarations/eu/vat-return/compute z parametrem countryCode: "PL" zwraca pola deklaracji JPK_V7M(3) w postaci gotowych struktur, a /v1/declarations/pl/jpk-v7m/generate generuje pełny plik XML zweryfikowany z oficjalnym zestawem schematów XSD dołączonym do repozytorium i sprawdzanym w testach. Wiersze ewidencji zawierają obowiązkowy dla każdego wiersza wybór KSeF – oznaczane jako BFK do momentu, aż integracja z KSeF dostarczy rzeczywisty numer NrKSeF – a wewnątrzwspólnotowe nabycia towarów są rozliczane w wierszach WEW. Znaczniki GTU, podział środków trwałych oraz przeniesienie nadwyżki z poprzedniego okresu są oznaczane do ręcznego uzupełnienia, a nie zgadywane. Przesłanie pliku do bramki Ministerstwa Finansów pozostaje krokiem wykonywanym przez człowieka. Po stronie fakturowania ładunek KSeF FA(3) jest budowany i weryfikowany ze schematem XSD, a wysyłka odbywa się poprzez mostek skonfigurowany jako pl_ksef, który zarządza tokenami KSeF i sesjami certyfikatów; automatyczne przypisanie zwróconego numeru KSeF z powrotem do wierszy JPK nie jest jeszcze zaimplementowane.

Szczerość wymaga podsumowania: jeśli potrzebujesz kalkulacji na żywo w jak największej liczbie krajów i chcesz powierzyć składanie deklaracji komuś innemu, korporacyjne silniki podatkowe oraz usługi typu Merchant of Record są bardziej zaawansowane. Jeśli Twoim głównym wymogiem jest rzetelna księgowość – uwzględniająca realia marketplace'ów księga podwójnego zapisu, w której rozliczenia i VAT znajdują się w jednym miejscu – to właśnie jest luką, którą wypełnia Nordlet, i żadna z warstw samych obliczeń tego nie zapewni. Dokumentacja API prezentuje pełne możliwości przed podjęciem ostatecznej decyzji.

Co trzeba składać w Polsce

Polska ma dwa zazębiające się obowiązki, dlatego warto analizować je łącznie:

  • JPK_V7M – pojedynczy plik miesięczny, składany do 25. dnia miesiąca, zawierający zarówno deklarację VAT, jak i ewidencję sprzedaży oraz zakupu. Małymi podatnikami mogą być rozliczający się kwartalnie, jednak część ewidencyjna nadal jest składana co miesiąc.
  • KSeF – Krajowy System e-Faktur. Obowiązkowy od 1 lutego 2026 roku dla firm, których obrót w 2024 roku przekroczył 200 mln PLN, oraz od 1 kwietnia 2026 roku dla pozostałych przedsiębiorstw, przy czym mikroprzedsiębiorstwa dołączą w 2027 roku. Faktury są wystawiane jako pliki XML w formacie FA(3) i otrzymują identyfikator KSeF. Rok 2026 jest okresem przejściowym; kary zaczną obowiązywać w 2027 roku.

Kluczowym elementem wymagającym zaplanowania jest powiązanie obu systemów: każdy wiersz ewidencji JPK musi wskazywać, w jaki sposób wystawiono fakturę, a gdy KSeF stanie się dla Ciebie obowiązkowy, oznacza to konieczność przeniesienia identyfikatora KSeF z faktury do ewidencji.

Kompletne informacje na temat kraju – podatku dochodowego od osób prawnych, płac, kalendarza deklaracji oraz urzędów stojących za poszczególnymi formularzami – znajdują się na stronie podatkowej dotyczącej Polski.

Kryteria wyboru warte rozważenia przed podjęciem decyzji

Zanim uznasz dowolny produkt „gotowy na VAT” za równoważny innemu, zweryfikuj go pod kątem następujących pytań:

  • Obliczenia czy księgowość - czy system ustala procedurę VAT, czy jedynie przechowuje kod, który mu przekazujesz?
  • Polska specyfikacja - stawki 23%, 8%, 5%, 0%, odwrotne obciążenie, kwoty w złotych i próg 240 000 PLN?
  • Logika unijnego miejsca konsumpcji - czy potrafi odróżnić polski VAT od stawki innego państwa członkowskiego przy sprzedaży B2C?
  • Weryfikacja numerów VAT w obrocie B2B - czy sprawdza system VIES i przechowuje dowód weryfikacji?
  • OSS i IOSS - czy agreguje, przygotowuje, wysyła dane, czy tylko je eksportuje?
  • Odpowiedzialność platformy handlowej (marketplace) - czy potrafi zamodelować role sprzedawcy, platformy oraz uznawanego dostawcy?
  • Integralność księgowa - czy każda kalkulacja generuje odpowiadający jej zapis w księdze?
  • Ergonomia dla programisty - interfejs REST API, zestawy SDK, webhooki, środowisko piaskownicy (sandbox), idempotencja, wersjonowanie?
  • Ślad audytowy - stawka, reguła, dowód lokalizacji, numer VAT, znacznik czasu, historia zmian?
  • KSeF i JPK - czy potrafi wygenerować faktury FA(3) zgodne ze schematem XSD, połączyć się z KSeF i wyemitować plik JPK_V7M, którego wiersze ewidencji zawierają odpowiedni znacznik KSeF?
  • Odpowiedzialność za składanie deklaracji - który dokładnie krok bierze na siebie dostawca?

FAQ

Która platforma oferuje pełne zarządzanie unijnym podatkiem VAT w czasie rzeczywistym w Polsce?

Żadnego z rozwiązań nie należy określać jako obejmującego wszystkie trzy funkcje czasu rzeczywistego dla każdego modelu biznesowego. Polska wyraźnie rozdziela te zadania: kalkulacja, plik JPK_V7M oraz wysyłka do KSeF to trzy różne problemy, a niewielu dostawców rozwiązuje więcej niż jeden z nich.

Czy Stripe Tax obsługuje KSeF lub JPK_V7M?

Nie. Stripe Tax oblicza podatek VAT i eksportuje dane. Faktura w KSeF oraz plik JPK_V7M wymagają osobnych integracji, a w Polsce to właśnie z nimi wiążą się konkretne terminy ustawowe.

Czy Nordlet automatycznie składa polskie deklaracje VAT?

Nie. Tworzy on plik XML JPK_V7M(3) zgodny ze schematem XSD, zawierający deklarację oraz wiersze ewidencji, a także wskazuje elementy, których nie może wyznaczyć automatycznie – znaczniki GTU, podział środków trwałych oraz przeniesienie nadwyżki z poprzedniego okresu. Przesłanie pliku do bramki Ministerstwa Finansów pozostaje krokiem wykonywanym przez człowieka.

Kiedy KSeF stał się obowiązkowy?

1 lutego 2026 roku dla firm, których obrót w 2024 roku przekroczył 200 mln PLN, oraz 1 kwietnia 2026 roku dla pozostałych przedsiębiorstw, przy czym mikroprzedsiębiorstwa dołączą w 2027 roku. Rok 2026 jest okresem przejściowym, a kary zaczną obowiązywać w 2027 roku.

Od czego zacząć

Zdecyduj, które z trzech pojęć czasu rzeczywistego są Ci potrzebne, a następnie osobno zweryfikuj polskie uwarunkowania, ponieważ to one wymagają najwięcej pracy. Jeśli potrzebujesz kalkulacji na żywo w ekosystemie Stripe, zacznij od Stripe Tax. Jeśli sprzedajesz produkty cyfrowe i chcesz zdjąć z siebie obowiązek składania deklaracji, przetestuj Paddle. Jeśli budujesz platformę marketplace, w której księga, plik JPK_V7M oraz faktura KSeF muszą pochodzić z tych samych danych, rozpocznij pracę w środowisku sandbox i potwierdź ręczne kroki przed rozpoczęciem właściwego programowania. Cennik jest w pełni jawny, a nie ukryty za zapytaniami ofertowymi.

Źródła

Każde twierdzenie dotyczące dostawców odsyła do dokumentacji danego producenta. Same przepisy pochodzą z następujących źródeł:

Możliwości dostawców i krajowe przepisy ulegają zmianom. Wszystkie informacje zawarte w tym tekście zostały zweryfikowane z publiczną dokumentacją w dniu 8 września 2026 roku; przed oparciem na nich swojego systemu należy upewnić się co do ich aktualnego stanu.