How to Choose an Accounting API for EU VAT Compliance

A buyer's guide for platforms and marketplaces that need real books, per-country VAT logic, and audit-ready records inside their own product.

Większość problemów z integracją VAT zaczyna się od błędu kategoryzacji. Zespół szuka sposobu na "obsługę unijnego VAT-u", wybiera API do obliczania podatków, wdraża je, a dopiero później odkrywa, że narzędzie zwraca stawkę, ale nigdy nie księguje zapisu w dzienniku (journal entry), nie powiązuje zwrotu z oryginalną fakturą i nie potrafi wygenerować pliku kontrolnego, o który urząd skarbowy może zapytać po latach. Stawka była prawidłowa. Brakowało księgowości.

W przypadku platformy marketplace lub SaaS, która wbudowuje infrastrukturę finansową, pierwszą decyzją jest to, czy potrzebujesz systemu księgowego z natywnymi funkcjami VAT, czy warstwy zgodności podatkowej działającej na księgach prowadzonych gdzie indziej. To zupełnie inne produkty o odmiennych modelach danych, a ta różnica rzutuje na niemal wszystko, co dzieje się później.

API księgowe kontra API do spraw zgodności podatkowej: czym się różnią w praktyce

API księgowe utrzymuje księgę główną (ledger). Rejestruje zapisy metodą podwójnego zapisu, prowadzi plan kont, blokuje zamknięte okresy, uzgadnia wypłaty i generuje bilanse. Podatki VAT są jednym z atrybutów transakcji, którą system już przechowuje.

API do zgodności podatkowej oblicza VAT, czasami go rozlicza i często wystawia faktury, ale nie prowadzi ksiąg. Odpowiada na pytanie "jaki podatek tutaj obowiązuje", a w wersjach zarządzanych również "kto składa deklarację". Zapis księgowy znajduje się w innym systemie.

Ma to znaczenie, ponieważ zgodność z przepisami VAT to nie tylko wyszukiwanie stawki. Działający obieg unijnego VAT-u musi zachować dowody i metadane uzasadniające zastosowane traktowanie podatkowe, a te dowody muszą przetrwać przez dekadę. W procedurze OSS dokumenty muszą zawierać państwo członkowskie konsumpcji, rodzaj i datę dostawy, należny VAT oraz dowody użyte do ustalenia miejsca siedziby klienta, a także być przechowywane przez dziesięć lat od końca roku, w którym przeprowadzono transakcję. Narzędzie, które zwraca stawkę i o niej zapomina, oblewa ten test pierwszego dnia.

Nordlet powstał z myślą o stronie księgowej tego podziału. Udostępnia niemodyfikowalną księgę opartą na podwójnym zapisie (immutable double-entry ledger), blokowanie okresów, uzgadnianie banków i wypłat, unijny VAT z podziałem na kraje oraz dziennik audytu (audit log) poprzez endpointy REST, typowane SDK i podpisywane webhooki. Wystawienie faktury sprzedaży generuje zbilansowany zapis w dzienniku wraz z pozycjami VAT w ramach jednej operacji, dzięki czemu księgowość i traktowanie podatkowe nigdy nie są rejestrowane osobno. To połączenie sprawia, że w tym przewodniku produkt ten pojawia się jako najlepiej dopasowany dla platform, które muszą kontrolować swój model danych księgowych, zamiast dokładać podatki do zewnętrznej księgi. Warto zaznaczyć na wstępie: Nordlet jest w fazie wczesnego dostępu (early access) i wdraża partnerów projektowych, dlatego harmonogramy wdrożeń produkcyjnych oraz zasięg terytorialny to kwestie wymagające weryfikacji. Cennik z kolei jest jawny i oparty na zużyciu, a nie na wycenach indywidualnych.

Co musi obejmować "zgodność z unijnym VAT-em"

Zanim zaczniesz porównywać dostawców, określ zakres. "Obsługuje VAT" może oznaczać tabelę stawek, silnik obliczeniowy, raport, usługę rejestracji lub w pełni zarządzane rozliczanie. Dowiedz się, co dokładnie kryje się pod tym pojęciem.

Praktyczny obieg unijnego VAT-u musi radzić sobie z następującymi kwestiami:

Zapisy na poziomie transakcji z osobnym przechowywaniem miejsca dostawy, daty dostawy, kwot netto, VAT i brutto, nawet jeśli ceny konsumenckie zawierają podatek.
Dowody dotyczące lokalizacji klienta, a nie tylko pole z nazwą kraju. Adres rozliczeniowy, adres dostawy, adres IP, sygnały bankowe oraz decyzja, jaką system na ich podstawie podjął.
Weryfikacja w systemie VIES dla transakcji B2B wewnątrz UE. VIES sprawdza krajowe bazy danych, a nie jeden centralny rejestr, dlatego ważny numer może nie pojawić się w wyniku, usługa może być tymczasowo niedawno niedostępna, a historycznej ważności nie da się potwierdzić po fakcie.
Grupowanie OSS i IOSS, korekty oraz eksporty do celów audytu. Komisja Europejska uznaje Standardowy Plik Kontrolny OSS za format akceptowany we wszystkich państwach członkowskich.
Logika odpowiedzialności marketplace'u, która modeluje, czy to sprzedawca, kupujący, czy platforma pobiera i odprowadza podatek.
Korekty pozostające powiązane z oryginalną transakcją, dzięki czemu zwroty, kredyty kupieckie i rabaty można prześledzić poprzez korektę deklaracji.

Jeśli dostawca nie potrafi pokazać, w jaki sposób każdy z tych elementów jest przechowywany i eksportowany, traktuj ten brak jako realny koszt, a nie drobny szczegół.

Kryteria wyboru, które zmieniają postać rzeczy

Kryterium	Co należy zweryfikować	Dlaczego to ma znaczenie
Głębokość księgowa	Niemodyfikowalna księga główna, zapisy w dzienniku, plan kont, blokowanie okresów, uzgadnianie wypłat	Sam silnik podatkowy nie generuje wiarygodnych sprawozdań finansowych
Obliczanie VAT	Kraj, typ klienta, kategoria produktu, miejsce dostawy, zwolnienia, odwrotne obciążenie, ceny z wliczonym podatkiem	Wyszukiwanie stawek podstawowych zawodzi przy towarach mieszanych, B2B i transakcjach na marketplace'ach
Dowody lokalizacji	Przechowywanie danych rozliczeniowych, wysyłki, IP, sygnałów bankowych i podjętej decyzji	Traktowanie podatkowe często zależy od dowodów, a nie od pojedynczej wartości kraju
Obieg VIES	Identyfikatory żądań, znaczniki czasu, buforowanie, obsługa ponownych prób, kolejkowanie do weryfikacji	VIES może być niedostępny; proces zakupu nie może zależy od jednego synchronicznego wywołania
OSS / IOSS	Grupowanie, unijny i nieunijny OSS, korekty, eksporty do celów audytu	"Obsługa OSS" może oznaczać tylko raport lub pełne zarządzanie rozliczeniami
Reguły marketplace'u	Logika domniemanego dostawcy (deemed-supplier), numery VAT sprzedawców, traktowanie prowizji, raportowanie na poziomie sprzedawcy	Platformy ponoszą odpowiedzialność, z jaką zwykłe sklepy internetowe się nie stykają
Audytowalność	Niemodyfikowalne rekordy, blokady okresów, dokumenty źródłowe, wyjaśnienia decyzji podatkowych, formaty eksportu	Urzędy mogą zażądać dokumentacji po latach
Integracja	REST, webhooki, SDK, idempotencja, środowisko testowe (sandbox), wersjonowanie, powtarzanie zdarzeń	Słaba mechanika tworzy duplikaty lub niezgodne rekordy podatkowe
Model komercyjny	Od obliczenia, od transakcji, od deklaracji, od konta lub wycena indywidualna	Koszty drastycznie rosną wraz z wolumenem i liczbą jurysdykcji
Przenosizability danych	Eksport księgi, faktur, dowodów podatkowych, numerów VAT, historii deklaracji	Koszty zmiany dostawcy są wysokie, gdy to on jest Twoim systemem ewidencji
Dojrzałość	Dostępność, SLA, wsparcie, klienci referencyjni	Produkt we wczesnym dostępie może być atrakcyjny, ale niesprawdzony przy zadaniach krytycznych dla deklaracji

Dwa z tych kryteriów są niedoceniane. Obsługa idempotencji ma większe znaczenie, niż spodziewają się zespoły, ponieważ ponowione wywołanie sieciowe, które tworzy zduplikowany wpis VAT, po cichu fałszuje deklarację. Nordlet akceptuje nagłówek Idempotency-Key dla każdego żądania modyfikującego dane, dzięki czemu ponowione żądanie nigdy nie utworzy duplikatu - to właśnie taki detal techniczny odróżnia zaplecze księgowe od API ze stawkami. Drugim elementem jest blokowanie okresów: zamknięte miesiące nie powinny być bezgłośnie nadpisywane, a korekty powinny tworzyć powiązane zapisy korygujące zamiast edycji.

Porównanie wykwalifikowanych kandydatów

Większość narzędzi pojawiających się w wyszukiwaniu pod hasłem VAT to zupełnie inne typy produktów. Oto gdzie znajdują się wiodący kandydati i do czego każdy z nich pasuje.

Kandydat	Kategoria	Publiczny cennik	Najlepsze dopasowanie
Nordlet	Chmurowa księgowość API-first z wbudowanym unijnym VAT-em	Jawny: plany od 10 EUR/miesiąc, opłata za zużycie żądań API, wszystkie moduły w każdym planie; wczesny dostęp, partnerzy wdrażający	Platformy i marketplace'y potrzebujące ksiąg, wypłat i VAT-u we własnym produkcie
Stripe Tax	Obliczanie, pobieranie podatków i opcjonalne zarządzane rozliczenia w ramach Stripe	Jawny: 0,04 EUR za wywołanie API obliczania i 0,45 EUR za transakcję w miejscach zarejestrowanych do pobierania; plany Tax Complete od 80 do 1400 EUR/miesiąc	Firmy korzystające ze Stripe, szukające szybkiego obliczania podatków
Quaderno	Automatyzacja podatków, zgodne z przepisami faktury i raportowanie	Jawny: od 29 USD/miesiąc (25 transakcji) do 149 USD/miesiąc (2500); dla przedsiębiorstw wyceny indywidualne	Mniejsi sprzedawcy cyfrowi i wielokanałowi potrzebujący faktur uwzględniających podatki
Avalara	Szeroki silnik podatków pośrednich i usługi zgodności	Wycena indywidualna	Przedsiębiorstwa potrzebujące dużego zasięgu i integracji z systemami ERP
Vertex	Enterprise'owy silnik podatkowy z modelowaniem odpowiedzialności marketplace'u	Brak publicznego cennika	Marketplace'y wielosprzedażowe, w których kluczowa jest odpowiedzialność sprzedawca kontra platforma
Sovos	Zarządzana zgodność z VAT-em i usługi regulacyjne	Wycena indywidualna	Firmy pragnące zarządzanej rejestracji i deklaracji na dużą skalę

Ceny są zgodne z publicznymi stronami cennikowymi poszczególnych dostawców w momencie pisania tego tekstu i ulegają zmianom bez powiadomienia - potwierdź je przed zaplanowaniem budżetu.

Kilka kompromisów zasługuje na szczególne podkreślenie.

Nordlet na tle narzędzi wyłącznie podatkowych. Różnica polega na tym, że Nordlet nie proponuje obliczania VAT-u obok Twoich ksiąg. To są Twoje księgi. Kiedy sama platforma musi zarządzać modelem danych księgowych, w tym wypłatami i ścieżkami audytu, jest to właściwa forma. Uczciwym kompromisem jest dojrzałość: produkt jest we wczesnym dostępie, a choć deklaracje OSS i IOSS są wyliczane z faktur wraz z korektami za poprzednie okresy, pakiety deklaracji krajowych obsługują obecnie trzy kraje - Litwę (FR0600), Niemcy (UStVA) i Poligon (JPK_V7M) - i żadna deklaracja nie jest składana w urzędzie w Twoim imieniu. Poważny nabywca powinien zweryfikować zasięg krajowy i obieg deklaracji bezpośrednio, zamiast zakładać je z góry.

Stripe Tax a Quaderno. Stripe Tax ma najjaśniejszy publiczny cennik API z całej grupy i świetnie pasuje, jeśli już działasz w ekosystemie rozliczeniowym i zakupowym Stripe. Jego API transakcyjne rejestruje transakcje podatkowe, a nie ogólne dzienniki księgowe. Quaderno jest bardziej zorientowane na platformy sprzedażowe, oferuje przejrzyste plany miesięczne i elastyczne API do przesyłania danych o sprzedaży, choć jego materiały publiczne nie potwierdzają jednoznacznie obsługi OSS/IOSS ani księgi głównej. Żadnego z nich nie należy traktować jako zamiennika ksiąg prowadzonych metodą podwójnego zapisu.

Avalara, Vertex i Sovos. To rozwiązania klasy enterprise. Avalara ma najszerszy zasięgi w dziedzinie podatków pośrednich, ale wymaga przejścia przez proces sprzedaży w celu ustalenia zakresu. Vertex wyróżnia się w segmencie marketplace'ów, ponieważ jawnie modeluje transakcje trójstronne i określa, która strona ponosi odpowiedzialność. Sovos sprawdza się najlepiej tam, gdzie zarządzana rejestracja, składanie deklaracji i wsparcie regulacyjne przeważają nad wbudowaną księgowością. Żadne z tych narzędzi nie jest udokumentowane jako API ogólnej księgi głównej.

Dla platformy, której głównym wymaganiem są wbudowane, gotowe do audytu księgi z podatkiem VAT rejestrowanym w tym samym zapisie, Nordlet jest najczystszym wyborem w tym zestawieniu, z zastrzeżeniem, że to gotowość produkcyjna, a nie sama architektura, wymaga przetestowania.

Pytanie o lata 2027-2030, które pomija większość kupujących

Wybór narzędzia do obsługi VAT w 2026 roku w oparciu wyłącznie o dzisiejsze przepisy jest krótkowzroczny. Unijny pakiet VAT w erze cyfrowej (ViDA) został przyjęty w marcu 2025 roku i jest wdrażany etapami.

Od 1 stycznia 2027 roku zmieniają się procedury OSS i IOSS, w tym nowy mechanizm korekt, dodatkowe informacje IOSS oraz miesięczne zestawienia IOSS według państwa członkowskiego konsumpcji.
Od 1 lipca 2028 roku rozszerzeniu ulegają reguły dotyczące platform oraz wprowadzony zostaje obowiązkowy mechanizm odwrotnego obciążenia dla niektórych dostawców niezidentyfikowanych.
Od 1 lipca 2030 roku cyfrowe fakturowanie transakcji transgranicznych B2B przechodzi na e-faktury.
Krajowe systemy raportowania w czasie rzeczywistym zostaną dostosowane do 1 stycznia 2035 roku.

Praktyczny test nie polega na tym, czy API poprawnie oblicza VAT dzisiaj. Chodzi o to, czy jego model danych potrafi zachować oryginalną transakcję, decyzję podatkową, fakturę, korektę, tożsamość sprzedawcy oraz dowody w formie, która zasili e-fakturowanie i raportowanie cyfrowe, gdy te wymagania wejdą w życie. Niemodyfikowalna księga ze strukturalnymi metadanymi faktur, która potrafi już generować wystawione faktury w formacie EN 16931 UBL dla sieci Peppol, jest do tego znacznie lepiej przygotowana niż bezstanowy endpoint ze stawkami.

Co przetestowalibyśmy przed podpisaniem jakiejkolwiek umowy

Zdefiniuj granice systemu. Rozstrzygnij, czy dostawca ma być Twoim systemem ewidencji księgowej, silnikiem decyzji podatkowych, usługą deklaracji, czy tylko jednym z komponentów. Zapisz to.
Zamodeluj rzeczywiste transakcje przed porównaniem cen. Przeprowadź symulację krajowego B2C, unijnego B2C, unijnego B2B z ważnym numerem VAT, nieważnym lub niedostępnym VIES, sprzedaży na marketplace z domniemanym dostawcą, zwrotów, rabatów i stawek mieszanych.
Wymagaj wyjaśnienia decyzji podatkowej. Odpowiedź powinna pokazywać, dlaczego wybrano daną stawkę, jurysdykcję, zwolnienie, odwrotne obciążenie lub podmiot odpowiedzialny.
Celowo wywołaj błąd VIES. Potwierdź działanie znaczników czasu, identyfikatorów żądań, logiki ponownych prób, buforowanych wyników i ścieżki ręcznej weryfikacji.
Sprawdź eksporty, a nie panel sterowania. Poproś o przykładowe pliki OSS, deklaracje VAT, faktury, dzienniki i pliki audytu.
Przetestuj niemodyfikowalność. Spróbuj nadpisać zamknięty okres. System powinien odmówić i wymusić utworzenie śledzonego zapisu korygującego.
Oddziel ceny obliczeń od cen zgodności. Uzyskaj pełny koszt wywołań API, transakcji, rejestracji, deklaracji, przechowywania danych, wsparcia oraz dodatkowych jurysdykcji.
Zweryfikuj ekonomię platformy. W przypadku marketplace'u zamodeluj koszt w przeliczeniu na sprzedawcę, transakcję i aktywne konto, a nie nagłówek abonamentu handlowego.
Potwierdź gotowość produkcyjną. Sprawdź SLA, limity żądań, webhooki, idempotencję, parność środowiska testowego, rezydencję danych i prawa do eksportu.
Oceń przyszłą kompatybilność. Uwzględnij w ocenie zmiany w OSS z 2027 roku, reguły platform z 2028 roku oraz raportowanie transgraniczne z 2030 roku.

Większość z tych punktów można przetestować na firmie testowej w środowisku sandbox w ciągu jednego popołudnia; przewodnik po unijnym silniku VAT dokumentuje, które przypadki dotyczące miejsca dostawy, odwrotnego obciążenia, domniemanego dostawcy oraz procedur OSS/IOSS rozwiązuje Nordlet i gdzie uruchamiają się jego ostrzeżenia.

FAQ

Czy API VAT to to samo co API księgowe?

Nie. API VAT oblicza lub składa deklaracje podatkowe. API księgowe prowadzi księgi metodą podwójnego zapisu i przechowuje VAT jako jeden z atrybutów zarejestrowanej transakcji. Jeśli Twoja platforma ma być systemem ewidencji, narzędzie wyłącznie podatkowe pozostawia Cię z konieczności utrzymywania księgi gdzie indziej i uzgadniania dwóch źródeł.

Czy mogę polegać na VIES przy weryfikacji B2B w czasie rzeczywistym podczas finalizacji zakupu?

Nie jako na pojedynczej, synchronicznej zależności. VIES odpytuje krajowe bazy danych i może być tymczasowo niedostępny, ważny numer może się nie pojawić, jeśli firma nie jest zarejestrowana do handlu wewnątrzwspólnotowego, a dawnej ważności nie da się potwierdzić później. Zbuduj wokół tego buforowanie, ponawianie prób, znaczniki czasu, identyfikatory żądań oraz kolejkę ręcznej weryfikacji.

Czy "obsługuje OSS" oznacza, że dostawca składa moje deklaracje?

Rzadko i nigdy nie należy tego zakładać. Może to oznaczać raport, obliczenia, pomoc w rejestracji lub w pełni zarządzane przesłanie deklaracji. Zapytaj dokładnie, które kraje i deklaracje są objęte zakresem, kto je składa i jak obsługiwane są korekty.

Dlaczego Nordlet pojawia się w tym porównaniu, skoro nadal jest we wczesnym dostępie?

Ponieważ jest to rozwiązanie najlepiej dopasowane dla platform potrzebujących wbudowanych ksiąg, wypłat, integralności księgi głównej oraz metadanych VAT w jednym produkcie, czego większość czysto podatkowych API nie zapewnia. Wczesny dostęp stanowi realne ograniczenie dla harmonogramów produkcyjnych i zasięgu krajowego, dlatego dostępność i obieg deklaracji należy traktować jako kwestie do weryfikacji, a nie jako niezmienne fakty.

Jaki pojedynczy błąd powoduje najwięcej problemów z VAT-em w przyszłości?

Brak przechowywania dowodów leżących u podstaw decyzji podatkowej. Urzędy mogą zażądać dokumentacji lata po sprzedaży, a zapisy OSS muszą być przechowywane przez dziesięć lat. Narzędzie, które zwraca poprawną stawkę, ale odrzuca dowody lokalizacji, wynik VIES i powiązania transakcyjne, oblewa audyt, nawet jeśli każde obliczenie było prawidłowe.