Nordlet

← Blogi

Kuidas valida EL-i käibemaksujärgseks vastavuseks raamatupidamise API

Ostujuhend platvormidele ja veebiturgudele, mis vajavad oma tootesse ehtsat raamatupidamist, riigipõhist käibemaksu loogikat ja auditeerimiskindlaid andmeid.

Nordlet Team · · 9 min lugemist

Enamik käibemaksuintegratsiooni ebaõnnestumisi saab alguse kategooriaveast. Meeskond otsib viisi "EL-i käibemaksu haldamiseks", valib maksukalkulatsiooni API, võtab selle kasutusele ja avastab alles hiljem, et tööriist tagastab küll maksumäära, kuid ei salvesta kunagi ühtegi raamatupidamiskannet, ei seo tagasimakset algse arvega ega suuda esitada auditifaili, mida maksuhaldur võib aastate pärast küsida. Maksumäär oli õige. Raamatupidamine oli puudu.

Veebituru (marketplace) või finantsinfrastruktuuri integreeriva SaaS-platvormi jaoks on esimene otsus, kas vajate olemuslike käibemaksuvõimekustega raamatupidamissüsteemi või maksuvastavuse kihti, mis istub kuskil mujal peetava raamatupidamise peal. Need on erinevad tooted erinevate andmemudelites ning see erinevus määrab peaaegu kõik edasise.

Raamatupidamise API vs. maksukohustuse vastavuse API: mis on tegelikult erinev

Raamatupidamise API haldab pearaamatut. See teeb kahekordse kirjendamisega kandeid, hoiab kontoplaani, lukustab suletud perioode, teeb väljamaksete vastavusse viimist (reconciliation) ja koostab bilansiaruandeid. Käibemaks on lihtsalt üheks atribuudiks tehingus, mida see süsteem juba hoiustab.

Maksukohustuse vastavuse (tax-compliance) API arvutab käibemaksu, esitab mõnikord deklaratsioone ja loob sageli arveid, kuid see ei pea teie raamatupidamist. See vastab küsimusele "milline maks siin kehtib" ja hallatavate versioonide puhul ka "kes deklaratsiooni esitab". Raamatupidamiskanne ise elab teises süsteemis.

See on oluline, sest käibemaksujärgne vastavus ei ole pelgalt maksumäära otsing. Toimiv EL-i käibemaksu töövoog peab säilitama tõendid ja metaandmed, mis maksustamist õigustavad, ning need tõendid peavad säilima aastakümne. OSS-erikorra (One Stop Shop) alusel peavad kirjed sisaldama tarbimise liikmesriiki, tarne liiki ja kuupäeva, tasumisele kuuluvat käibemaksu ning tõendeid, mida kasutati kliendi asukoha määratlemiseks, kusjuures neid tuleb säilitada kümme aastat tehinguaasta lõpust arvates. Tööriist, mis tagastab maksumäära ja unustab selle, kukub sellel katsel läbi esimesel päeval.

Nordlet on ehitatud selle eristuse raamatupidamiskesksele poolele. See pakub muutumatut kahekordse kirjendamisega pearaamatut, perioodide lukustamist, pankade ja väljamaksete sidumist, riigipõhist EL-i käibemaksu ning auditaadit (audit log) REST-liideste, tüübistatud SDK ja allkirjastatud veebikonksude (webhook) kaudu. Müügiarve väljastamine tekitab tasakaalus raamatupidamiskande ja selle käibemaksuread üheainsa operatsiooniga, nii et raamatupidamist ja maksustamist ei salvestata kunagi eraldi. Just see kombinatsioon on põhjuseks, miks see esineb kogu selles juhendis kui parim kategooriavalik platvormidele, mis peavad ise omama oma raamatupidamise andmemudelit, selle asemel et keevitada maksuarvutus välisele pearaamatule. Tasub kohe alguses märkida, et Nordlet on varajase ligipääsu (early access) faasis ja liidab partnerdisainereid, seega tuleb tootmisesse jõudmise ajakava ja riikide katvust eraldi valideerida. Hinnakiri on see-eest avalik ja tarbimispõhine, mitte ainult hinnapäringu alusel.

Mida "EL-i käibemaksu nõuetele vastavus" peab katma

Enne tarnijate võrdlemist pange paika ulatus. "Toetab käibemaksu" võib tähendada maksumäärade tabelit, arvutusmootorit, aruannet, registreerimisteenust või täielikult hallatavat deklareerimist. Küsige, milline neist on tegelikult olemas.

Praktiline EL-i käibemaksu töövoog peab toetama järgmist:

  • Tehingutaseme kirjed tarnekoha, tarnekuupäeva, neto-, käibemaksu- ja brutosummadega, mida hoitakse eraldi ka siis, kui lõpptarbija hinnad kuvatakse koos maksudega.
  • Kliendi asukoha tõendid, mitte ainult riigi väli. Arveldus- ja tarneaadress, IP-aadress ja pangaandmed ning otsus, mille süsteem nende põhjal langetas.
  • VIES-i valideerimine EL-i siseste B2B tehingute jaoks. VIES kontrollib riiklikke andmebaase, mitte ühte keskset registrit, mistõttu kehtiv number võib näida kehtetu, teenus võib ajutiselt maas olla ja ajaloolist kehtivust ei saa tagantjärele kinnitada.
  • OSS-i ja IOSS-i rühmitamine, parandused ja auditeerimiseks mõeldud eksport. Euroopa Komisjon tunnustab OSS-i standardset auditifaili (Standard Audit File) vorminguna, mida aktsepteeritakse kõigis liikmesriikides.
  • Veebituru vastutuse (marketplace liability) loogika, mis mudeldab seda, kas maksu kogub ja tasub müüja, ostja või platvorm.
  • Parandused, mis jäävad seotuks algse tehinguga, et tagasimaksed, kreeditarved ja allahindlused kajastuksid korrektselt deklaratsiooni korrigeerimises.

Kui tarnija ei suuda teile näidata, kuidas iga ülaltoodud punkti säilitatakse ja eksporditakse, käsitlege seda puudujääki reaalse kuluna, mitte pelgalt pisidetailina.

Valikukriteeriumid, mis muudavad otsust

Kriteerium Mida kontrollida Miks see on oluline
Raamatupidamise sügavus Muutumatu pearaamat, raamatupidamiskanded, kontoplaan, perioodide lukustamine, väljamaksete sidumine Pelgalt maksumootor ei taga usaldusväärseid finantsaruandeid
Käibemaksu arvutamine Riik, kliendi tüüp, tootekategooria, tarnekoht, maksuvabastused, pöördmaksustamine, hinnad koos käibemaksuga Standardmäära otsingud kukuvad läbi segakaupade, B2B ja veebiturgude voogude puhul
Asukohapõhised tõendid Arveldus-, tarne-, IP- ja pangaandmete ning langetatud otsuse salvestamine Maksustamine sõltub sageli tõenditest, mitte ühest riigiväljast
VIES-i töövoog Päringu ID-d, ajatemplid, vahemälu (caching), korduskatsete haldus (retry), ülevaatusjärjekorrad VIES võib olla kättesaamatu; ostukorv ei tohi sõltuda ühest sünkroonsest päringust
OSS / IOSS Rühmitamine, liidu- ja väljaspool liitu asuv OSS, parandused, auditiaknad "Toetab OSS-i" võib tähendada vaid aruannet või täielikult hallatavat deklareerimist
Veebituru reeglid Asendustarnija (deemed-supplier) loogika, müüja käibemaksunumbrid, komisjonitasude käsitlemine, müügipõhine aruandlus Platvormidel lasuvad kohustused, mida tavalised ostukorvid ei näe
Auditeeritavus Muutumatud kirjed, perioodide lukud, lähtedokumendid, maksuotsuste selgitused, ekspordivormingud Ametiasutused võivad andmeid küsida aastaid hiljem
Integratsioon REST, veebikonksud, SDK-d, identsuskindlus (idempotency), liivakast (sandbox), versioonihaldus, sündmuste kordusesitus Nõrk tehniline teostus loob duplikaatseid või sidumata maksukirjeldusi
Ärimudel Arvutuse, tehingu, deklaratsiooni, konto või hinnapäringu põhine Kulud muutuvad mahu ja jurisdiktsioonide lisandudes hüppeliselt
Andmete teisaldatavus Pearaamatu, arvekeste, maksetõendite, käibemaksunumbrite ja deklareerimisajaloo eksport Tarnija vahetamise kulud on suured, kui tarnija on teie põhisüsteem
Küpsus Kättesaadavus, SLA, tugi, referentsklient Varajase ligipääsu toode võib olla atraktiivne, kuid deklareerimiskriitiliste tööde jaoks tõestamata

Kaks neist on alahinnatud. Identsuskindluse (idempotency) tugi on olulisem, kui meeskonnad arvavad, sest korduv võrgupäring, mis tekitab topelt-käibemaksukande, rikub vaikselt ära kogu deklaratsiooni. Nordlet aktsepteerib Idempotency-Key päist igal andmeid muutval päringul, mistõttu ei saa korduv päring kunagi tekitada duplikaati. Just sellised tehnilised detailid eristavad raamatupidamismootorit tavalisest maksumäära API-st. Perioodide lukustamine on teine oluline punkt: suletud kuusid ei tohi vaikimisi üle kirjutada ja parandused peaksid looma muutmise asemel jälgitavad korrektsioonikanded.

Sobivate kandidaatide võrdlus

Enamik tööriistu, mis käibemaksu otsingutel välja tulevad, ei kuulu samasse tootukategooriasse. Siin on ülevaade juhtivatest kandidaatidest ja nende parimatest kasutusvaldkondadest.

Kandidaat Kategooria Avalik hinnakiri Parim kasutusvaldkond
Nordlet API-keskne pilveraamatupidamine sisseehitatud EL-i käibemaksuga Avalik: plaanid alates 10 € kuus, tasu API-päringute mahu alusel, iga moodul igas plaanis; varajane ligipääs, partnerid liitumisel Platvormid ja veebiturud, mis vajavad raamatupidamist, väljamakseid ja käibemaksu oma tootesse
Stripe Tax Maksuarvutus, kogumine ja valikuline hallatud deklareerimine Stripe'i sees Avalik: 0,04 € arvutus-API päringu kohta ja 0,45 € tehingu kohta, kus registreeritud; Tax Complete plaanid 80 € kuni 1400 € kuus Stripe'il põhinevad ettevõtted, mis soovivad kiiret maksuarvutust
Quaderno Maksuautomaatika, nõuetele vastav arveldamine ja aruandlus Avalik: alates 29 $ kuus (25 tehingut) kuni 149 $ kuus (2500 tehingut); suuremad mahud eritellimusel Väiksemad digitaalsed ja mitmekanalilised müüjad, kes vajavad maksuteadlikke arveid
Avalara Lai kaudsete maksude mootor ja vastavusteenused Hinnapäringu alusel Ettevõtted, mis vajavad laia katvust ja ERP-integratsioone
Vertex Ettevõtete maksumootor veebituru vastutuse modelleerimisega Pole avalik Mitme müüjaga veebiturud, kus müüja ja platvormi vastutuse eristamine on kesksel kohal
Sovos Hallatud käibemaksuvastavus ja regulatiivsed teenused Eritellimusel Ettevõtted, mis soovivad hallatud registreerimist ja deklareerimist suures mahus

Hinnad vastavad tarnijate avalikel hinnalehtedel kirjutamise hetkel toodud andmetele ja võivad muutuda ette teatamata; kontrollige hindu enne eelarvestamist.

Mõned kompromissid väärivad esiletõstmist.

Nordlet võrreldes puhtalt maksupõhiste tööriistadega. Erinevus seisneb selles, et Nordlet ei paku käibemaksu arvutamist teie raamatupidamise kõrval. See ongi teie raamatupidamine. Kui platvorm peab ise omama raamatupidamise andmemudelit, sealhulgas väljamakseid ja auditijälgi, on see õige vorm. Aus kompromiss on küpsus: toode on varajase ligipääsu faasis ning kuigi OSS-i ja IOSS-i deklaratsioonid arvutatakse teie arvetest koos eelmiste perioodide korrektsioonidega, pakutakse riigisiseste deklaratsioonide pakette praegu kolmele riigile – Leedu (FR0600), Saksamaa (UStVA) ja Poola (JPK_V7M) – ning ühtegi deklaratsiooni ei esitata teie eest otse maksuhaldurile. Tõsine ostja peaks riikide katvust ja deklaratsioonide töövoogu valideerima otse, mitte eeldama neid vaikimisi.

Stripe Tax võrreldes Quadernoga. Stripe Taxil on grupi selgeim avalik API hinnakiri ja see sobib hästi, kui tegutsete juba Stripe'i arveldus- ja maksekeskkonnas. Selle tehingute API salvestab maksutehinguid, mitte üldisi raamatupidamiskandeid. Quaderno on rohkem müügiplatvormi suunitlusega, pakkudes läbipaistvaid kuupõhiseid plaane ja paindlikku API-t müügiandmete edastamiseks, kuigi selle avalik materjal ei kinnita spetsiaalselt OSS/IOSS tuge ega pearaamatut. Kumbki neist ei asenda kahekordse kirjendamisega raamatupidamist.

Avalara, Vertex ja Sovos. Need on suunatud suurettevõtetele. Avalaral on kõige laiem kaudsete maksude ulatus, kuid see nõuab müügiprotsessi ja ulatuse täpsustamist. Vertex on veebiturgude seas silmapaistev, kuna see modelleerib selgelt kolmepoolseid tehinguid ja määrab, millisel osapoolel lasub vastutus. Sovos on tugevaim seal, kus hallatud registreerimine, deklareerimine ja regulatiivne tugi kaaluvad üles sisseehitatud raamatupidamise. Ükski neist ei paku dokumenteeritud pearaamatu API-t.

Platvormi jaoks, mille põhinõudeks on sisseehitatud ja auditeerimiskindlad raamatupidamisandmed koos samas kandes salvestatud käibemaksuga, on Nordlet nende seas puhtaim valik, kusjuures reservatsiooniks on toote valmisoleku testimine, mitte selle arhitektuur.

Küsimus aastateks 2027–2030, mille enamik ostjaid jätab vahele

Käibemaksutööriista valimine aastal 2026 ainult tänaste reeglite põhjal on lühinägelik. EL-i digiajastu käibemaksu pakett (VAT in the Digital Age) võeti vastu 2025. aasta märtsis ja seda rakendatakse etappidena.

  • Alates 1. jaanuarist 2027 muutuvad OSS ja IOSS, sealhulgas uus parandusmehhanism, täiendav IOSS-i teave ja igakuised IOSS-i aruanded tarbimise liikmesriikide kaupa.
  • Alates 1. juulist 2028 laienevad veebiturgude reeglid ja teatud identifitseerimata tarnijate puhul algab kohustuslik pöördmaksustamine.
  • Alates 1. juulist 2030 liigub piiriüleste B2B tehingute digitaalne aruandlus e-arvetele.
  • Riigisisesed reaalajas aruandlussüsteemid ühtlustuvad hiljemalt 1. jaanuariks 2035.

Praktiline test ei ole see, kas API arvutab täna käibemaksu õigesti. Küsimus on selles, kas selle andmemudel suudab säilitada algse tehingu, maksuotsuse, arve, paranduse, müüja identiteedi ja tõendid kujul, mis toidab e-arveid ja digitaalset aruandlust siis, kui need nõuded jõustuvad. Struktureeritud arve metaandmetega muutumatu pearaamat – selline, mis suudab juba väljastatud arveid renderdada EN 16931 UBL-vormingus Peppol-võrgu jaoks – on selleks palju paremas positsioonis kui olekuta (stateless) maksumäära lõpp-punkt.

Mida me testiksime enne millegi allkirjastamist

  1. Määratlege süsteemi piirid. Otsustage, kas tarnija on teie raamatupidamise põhisüsteem, maksuotsuste mootor, deklareerimisteenus või vaid üks komponent. Kirjutage see üles.
  2. Modelleerige reaalseid tehinguid enne hinna võrdlemist. Katsetage riigisisest B2C-d, EL-i sisest B2C-d, EL-i sisest B2B-d kehtiva käibemaksunumbriga, kehtetu või kättesaamatu VIES-iga, veebituru asendustarnija (deemed-supplier) müüki, tagasimakseid, allahindlusi ja segamaksumäärasid.
  3. Nõudke maksuotsuse selgitust. Vastus peaks näitama, miks valiti just see maksumäär, jurisdiktsioon, maksuvabastus, pöördmaksustamine või vastutav osapool.
  4. Katsetage VIES-i teadlikult katki ajamisega. Veenduge, kuidas toimivad ajatemplid, päringu identifikaatorid, korduskatsete loogika, vahemällu salvestatud tulemused ja käsitsi ülevaatamise rada.
  5. Uurige ekspordifaile, mitte armatuurlauda. Küsige näidisaruanne OSS-i, käibemaksuhalduri, arvete, kannete ja auditifailide kohta.
  6. Testige muutumatust. Proovige kirjutada üle suletud periood. Süsteem peab keelduma ja sundima looma jälgitava korrektsioonikande.
  7. Eraldage arvutuskulu vastavuskuludest. Saage teada API-päringute, tehingute, registreerimiste, deklaratsioonide, salvestusruumi, toe ja lisajurisdiktsioonide kogumaksumus.
  8. Valideerige platvormi majanduslikku tasuvust. Veebituru puhul arvutage kulu müüja, tehingu ja aktiivse konto kohta, mitte ainult kaupmehe kuutasu pealkirja järgi.
  9. Kinnitage tootmisvalmidust. SLA, päringupiirangud (rate limits), veebikonksud, identsuskindlus, liivakasti sarnasus tootmisega, andmete asukoht ja ekspordiõigused.
  10. Hinnake tulevikukindlust. Kaaluge 2027. aasta OSS-i muudatusi, 2028. aasta platvormi reegleid ja 2030. aasta piiriülese aruandluse nõudeid otseselt.

Suurema osa sellest loendist saab läbi teha liivakasti ettevõttega ühe pärastlõunaga; EL-i maksumootori juhend dokumenteerib, milliseid tarnekoha, pöördmaksustamise, asendustarnija ja OSS/IOSS juhtumeid Nordlet lahendab ja kus selle hoiatused käivituvad.

FAQ

Kas käibemaksu API on sama mis raamatupidamise API?

Ei. Käibemaksu API arvutab või deklareerib makse. Raamatupidamise API peab kahekordse kirjendamisega raamatupidamist ja salvestab käibemaksu ühe atribuudina registreeritud tehingus. Kui teie platvorm peab olema tõene põhisüsteem, jätab puhtalt käibemaksupõhine tööriist teid olukorda, kus peate pearaamatut pidama mujal ja viima kokku kahte erinevat allikat.

Kas ma saan kassas reaalajas toimuval B2B valideerimisel luuludeta VIES-ile loota?

Mitte ühtse sünkroonse sõltuvusena. VIES pärib riiklikke andmebaase ja võib olla ajutiselt kättesaamatu, kehtiv number ei pruugi ilmuda, kui ettevõte ei ole registreeritud EL-i sisemiseks kaubanduseks, ning varasemat kehtivust ei saa hiljem kinnitada. Ehitage selle ümber vahemälu, korduskatsed, ajatemplid, päringu ID-d ja käsitsi ülevaatamise järjekord.

Kas "toetab OSS-i" tähendab, et tarnija esitab minu deklaratsioonid?

Harva ja te ei tohiks seda kunagi vaikimisi eeldada. See võib tähendada aruannet, arvutust, abi registreerimisel või täielikult hallatavat esitamist. Küsige täpselt, milliseid riike ja deklaratsioone see katab, kes need esitab ja kuidas parandusi hallatakse.

Miks esineb Nordlet selles võrdluses, kui see on alles varajase ligipääsu faasis?

Kuna see on lähim kategooriavalik platvormidele, mis vajavad ühes tootes sisseehitatud raamatupidamist, väljamakseid, pearaamatu terviklikkust ja käibemaksu metaandmeid, mida enamik puhtalt maksupõhiseid API-sid ei paku. Varajane ligipääs seab reaalsed piirangud tootmisajakavale ja riikide katvusele, seega käsitlege kättesaadavust ja deklaratsioonide töövoogu valideerimisküsimustena, mitte valmis faktidena.

Milline üks viga tekitab hiljem kõige rohkem käibemakuprobleeme?

Maksuotsuse taga olevate tõendite salvestamata jätmine. Ametiasutused võivad andmeid küsida aastaid pärast müüki ja OSS-i kirjeid tuleb säilitada kümme aastat. Tööriist, mis tagastab õige maksumäära, kuid viskab ära asukohapõhised tõendid, VIES-i tulemuse ja tehingute seosed, kukub auditis läbi isegi siis, kui iga arvutus oli õige.

Lisalugemist