Tuairisciú Cánach Breisluacha (CBL) de réir Tíre agus Bailíochtú VIES a Uathoibriú

Tionscnaíonn formhór na fabhtanna CBL i gcód ardáin ó thoimhdean amháin: gurb ionann toradh VIES bailí agus an deis an díolachán a shermhír a nialasú (zero-rate). Ní hionann, agus nuair a thógtar córas ar an ngearrchiorcad sin, gintear tuairisceáin a bhreathnaíonn go maith go dtí go n-fiafraíonn iniúchóir cén fáth ar cuireadh díolúine idir-AE i bhfeidhm gan fianaise iompair nó taifead comhsheasmhach ar áit an tsoláthair. Is sa Bhearna idir "tseiceann an uimhir CBL amach" agus "caitheann go cuí leis an soláthar seo" a théann an chuid is mó de na comhtháthuithe amú go ciúin.

Taispeánann an treoir seo conas tuairisciú CBL de réir tíre agus bailíochtú VIES a uathoibriú le API cuntasaíochta scamall, ag baint úsáide as API cuntasaíochta Nordlet mar chomhthéacs cur chun feidhme. Is é an sprioc córas a ghabhann an fhianaise cheart ag an nóiméad díachais, a chuireann iontrálacha leabharmhír do-athraithe suas, agus a ghineann sonraí atá réidh le haghaidh tuairisceáin grúpáilte de réir scéime agus Ballstáit, gan iomláin a athchruthú i scarbhileog níos déanaí.

Cad a insíonn VIES duit i ndáiríre, agus cad nach n-insíonn sé duit

Is é VIES an Córas Malartaithe Faisnéise CBL AE (EU VAT Information Exchange System). Nuair a chuireann tú cód tíre agus uimhir CBL isteach, ceistíonn sé an bunachar sonraí náisiúnta ábhartha i bhfíor-am agus tugann sé le fios cé acu a bhfuil an fhaisnéis CBL sin bailí nó neamhbhailí. Sin é an raon feidhme iomlán. Dearbhaíonn sé go bhfuil uimhir cláraithe agus, i gcás ina dtacaíonn an Ballstát leis, gníomhachtaithe le haghaidh trádála idir-AE.

Ní bhunaíonn sé an kar um dhíolúine a thabhairt d'iompar idirphobail. Tá an Coimisiún Eorpach soilér faoi seo. Is píosa fianaise amháin i measc roinnt é freagra VIES bailí. Ní mór duit fós a dheimhniú gurb é an custaiméir an faighteoir iarbhír, go gcáileoidh an soláthar mar sholáthar idir-AE, go bhfuil fianaise iompair nó seolta ann, agus go bhfuil an abairt mhalartaithe muirir (reverse-charge) riachtanach ar an sonrasc.

Mar sin, is é an chéad chinneadh dearaidh ná ceann struchtúrach: coinnigh stádas VIES agus cóireáil CBL i réimsí ar leith. Ná ceangail viesStatus: valid go díreach le zeroRated: true riamh. An nóiméad a chuingríonn tú an dá choincheap sin, caillfidh tú an cumas chun cóireáil a chosaint nuair a cheistítear an fhianaise.

Réamhriachtanais mus a scríobhtar cód comhtháthaithe

Sula nglaotar ar aon phointe foirceann (endpoint), sainmhínigh raon feidhme an méid atá á thuairisciú agat. Is cuid leadránach í seo agus costasach í a scipeáil.

• Na tíortha ina bhfuil an gnó bunaithe nó ina bhfuil bunaíochtaí seasta aige
• Na tíortha ina bhfuil clárúcháin CBL aige
• Cibé an ndíolann sé earraí, seirbhísí, seirbhísí digiteacha, nó meascán díobh
• Cibé an idirbhearta B2B, B2C, nó an dá cheann atá i gceist
• Cibé an mbainistíonn sé úsáid as clárúcháin intíre, OSS, IOSS, muirear droim ar ais (reverse-charge), nó rialacha soláthraí measta an mhargaidh
• Na hauthaic a chaithfidh an API a tháirgeadh: sonraí tuairisceáin intíre, sonraí OSS/IOSS, cláir sonrasc cosúil le i.SAF na Liotuáine, iontrálacha leabharmhíre amháin, nó pálastaí do sholáthraí comhdhlúthaithe alseach

Tá sé seo tábhachtach toisc nach nglacann OSS le gach idirbheart. Is gnách go mbaineann seirbhísí a sholáthraítear i dtír ina bhfuil bunaíocht ag an ngnó le tuairisceán intíre na tíre sin, seachas le tuairisceán OSS. Déan bunaíochtaí a mhúnlú ar leith ón tús nó déanfaidh tú na soláthairtí sin a mhestreoiriú ag am comhdhlúthaithe.

Ná hardchódáil ráta CBL amháin in aghaidh an tíre ach oiread. Tá rátaí caighdeánacha, laghdaithe, sárlaghdaithe, páirceála, nialasacha agus tiomnaithe táirgí san AE, agus athraíonn siad. Is é údarás cánach na tíre sin an fhoinse iontaofa le haghaidh táirge shonrach i gComhstát sonrach, agus cuireann TEDB an Choimisiúin forbhreathnú trasteorann ar fáil. Taifead an fhoinse agus an leagan atá taobh thiar de gach cinneadh ráta ionas nach ndéanfaidh nuashonrú ar thábla rátaí níos déanaí athscríobh ciúin ar an gcaoi a n-éiríonn le seaniosbheart.

Múnlú an chinneadh cánach, ní hamháin an ráta

Is é croílár comhtháthaithe marthanach ná sraith catagóir cánach a shuíonn idir táirgí agus rátaí. Mapaigh táirgí chuig catagóirí, catagóirí chuig cóid chánach sonracha don tír, agus ansin chuig rátaí a bhfuil éifeacht dáta acu:

product/service
    → tax category
    → country-specific tax code
    → effective-dated rate and treatment

Is é an leagan neamhshábháilte a fhágann go dtarlaíonn drift i dtuairisciú ná product SKU → 21% VAT. Tá rátaí éagsúla ag an táirge céanna i dtíortha éagsúla, agus is féidir le ráta athrú i lár na tréimhse. Molann treoir chomhlíonadh CBL Nordlet féin VAT compliance guidance an mhapáil bhunaithe ar chatagóirí seo go díreach seachas táirgí a cheangal go díreach le céatadáin.

Ba chóir go mbeadh tacsanomaíocht do chatagóirí cánach cobhsaí agus inmheánach: earraí ar a ngearrtar an ráta caighdeánach, earraí ar a ngearrtar ráta laghdaithe, seirbhísí a sholáthraítear go leictreonach, seirbhísí gnáthaimh, soláthar díolmhaithe, soláthar nialas-ráta, muirear droim ar ais B2B idir-AE, díolachán fad-raoin idir-AE, iompórtáil IOSS, idirbheart soláthraí measta. Imíonn gach rud thíos an tsrutha as an tacsanomaíocht seo.

Bailíochtú VIES mar shreabhadh fianaise asincrónach

Nochtann an tseirbhís oifigiúil VIES comhéadan SOAP/WSDL a ghlacann le cód tíre dhá litir agus uimhir CBL. Tá tábhacht ag baint lena lochtanna doiciméadaithe maidir le láimhseáil earráidí: ionchur neamhbhailí, teorainneacha comhtharlaithe domhanda agus Ballstáit, neamh-infhaighteacht seirbhíse, neamh-infhaighteacht Ballstáit, agus teorainneacha ama. Caith le sraitheanna mar thorthaí ar leith, seachas mar bhuicéad "theipthe" amháin.

Seo mar a bhreathnaíonn sreabhadh a sheasann faoi ualach agus iniúchadh:

1. Déan an ID CBL a normalú: cuir an réimír i gceannlitreacha, bain spásanna nó poncaíochtaí ceadaithe, agus coinnigh an luach bunaidh a chuir an t-úsáideoir isteach ar leithligh.
2. Bailíochtaigh an cód tíre agus cruth na huimhir go háitiúil sula gcaitear glao líonra.
3. Cuir an uimhir normalaithe chuig VIES.
4. Stóráil an ID normalaithe, stampaí ama an iarratais agus an fhreagra, an stát bailí/neamhbhailí/gan phróiseáil, an freagra amh, aon earráid seirbhíse, IDanna an chustaiméara agus an tsonraisc, agus cinneadh an fheidhmchláir.
5. Taisce torthaí rathúla ar feadh tréimhse shainmhínithe doiciméadaithe.
6. Ath-iarr teipeanna teicniúla neamhbhuan le cúlú (backoff).
7. Ródú cásanna gan réiteach nó contrártha chuig athbhreithniú láimhe.
8. Athbhailíochtaigh nuair a bhíonn toradh taiscithe as dáta nó roimh idirbheart ina bhfuil an fhianaise ábhartha.

Seiceann Nordlet uimhir CBL AE nuair a chuirtear custaiméir leis agus déanann sé é a athsheiceáil roimh shonrascú nuair a bhíonn an toradh roimhe sin as dáta, rud arb é an t-iompar ar mhaith leat a mhacasamhlú cibé an nanglaíonn an seiceáil san ardán nó i do chód féin.

An rialach ríthábhachtach: ná déan checkout a chomhshrónú le VIES. Ní uimhir neamhbhailí é briseadh seirbhíse. Má théann VIES as feidhm le linn díolacháin, coinnigh an t-idirbheart le haghaidh athbhreithniú nó sannaigh stát sealadach dó. Gineann blocáil checkout ar uainiú seirbhíse Coimisiúin ticéad tacaíochta, agus tá sé níos measa custaiméir maith a aicmiú go mícheart mar dhuine neamhbhailí.

Stádas bailíochtaithe a scaradh ó chóireáil

Nuair a bhíonn toradh VIES agat, tá níos mó oibre le déanamh ag an inneall cinntí. Stóráil iad seo mar réimsí ar leith:

{
  "viesStatus": "valid",
  "vatTreatment": "intra_eu_b2b_reverse_charge",
  "evidenceStatus": "reviewed",
  "placeOfSupply": "DE"
}

Mus a gcuirtear muirear droim ar ais nó díolúine i bhfeidhm, ba chóir don inneall a thástáil cé acu an é an custaiméir an faighteoir go hionann, an bhfuil tír an chustaiméara agus an réimír CBL comhsheasmhach, an gcáilíonn an soláthar mar idir-AE, an mbaineann rialacha speisialta áit an tsoláthair, an bhfuil fianaise iompair ann, an bhfuil an díoltóir ag gníomhú mar sholáthraí measta, agus an bhfuil an abairt riachtanach ar an sonrasc. Ní solas yaş é stádas VIES bailí nach gcomhlíonann aon cheann de na tástálacha eile seo.

Cinneadh CBL do-athraithe a chruthú tráth sonrascaithe

Nuair a ghintear an sonrasc, seasmhaigh an cinneadh iomlán in éineacht leis, ní hamháin an ráta deiridh:

invoice
  ├─ line tax category
  ├─ place of supply
  ├─ VAT scheme
  ├─ country-specific rate
  ├─ rate-table version
  ├─ VIES evidence reference
  ├─ location-evidence references
  ├─ legal-basis reference
  └─ marketplace-role flags

Éilíonn rialacha sonrascaithe an AE sonraí soláthraí agus custaiméara, uimhir shonraisc, cur síos, méid inchánach, ráta CBL, méid CBL, agus aon fhaisnéis mhuirir droim ar ais nó díolúine. Teastaíonn tagairt shoiléir don bhunsunrasc ó nótaí creidmheasa agus leasuithe.

Tá leabharmhír Nordlet do-athraithe, agus mar sin tarlaíonn ceartúcháin trí iontrálacha nua amhail nótaí creidmheasa nó iontrálacha droim ar ais seachas eagarthóireacht ar taifid iata. Tóg do thomhaltóir timpeall an mhúnla sin fiú más féidir le do stóráil a scríobh thar rud éigin go teicniúil. Scriosann eagarthóireacht ar shonrasc iata an nasc idir an comhdhlúthú bunúsach agus an ceartúchán, rud arb é an líneacht é go díreach a leanann iniúchóir.

Postáil, webhookanna, agus neamhspleáchas ordaithe (idempotency)

Postálann díolachán iontrálacha cuntasaíochta iontrála dúbailte a chosnaíonn an t-idirbheart tráchtála agus an dliteanas CBL roinnte de réir tíre agus scéime. D'fhéadfadh díolachán intíre postáil:

Dr Accounts receivable / payment clearing
    Cr Revenue
    Cr VAT payable - DE - domestic

Postálann díolachán muirir droim ar ais B2B idir-AE ioncam gan CBL aschuir agus tagairt d'fhianaise an mhuirir droim ar ais. Is leatsa an chairt chuntais iarbhír; is é an rud atá tábhachtach ná go bhfanann na toisí tuairiscithe ceangailte le gach postáil: Ballstát, scéim, catagóir cánach, ráta, tréimhse, bunsonrasc, agus líneacht cheartúcháin.

Tiomáin athruithe stáit le webhookanna seachas vótaíocht (polling). Scaoileann Nordlet imeachtaí mar sale_invoice.paid, síníonn sé seachadtaí, agus déanann sé iarracht arís le cúlú. Tabhair eochair neamhspleáchais chinntitheach do gach scríbhinn:

sale:{platform_order_id}:invoice:{invoice_version}

Caithfidh do thomhaltóir a bheith neamhspleách freisin. Is féidir le webhook teacht faoi dhó, teacht go déanach, vagy tine tar éis don bhun-iarratas éirí go rathúil cheana féin. Fíoraigh sínithe, taifead IDanna imeachtaí, coraintínigh imeachtaí mí-shraithe, próiseáil trí scuaine bhuana, agus comh-réitigh stát webhook i gcoinne an API ar sceideal. Mura bhfuil obair déanta agat le webhookanna sínithe agus eochracha neamhspleáchais roimhe seo, is anseo a chónaíonn na fabhtanna dúbailte-iontrála is subtle.

Grúpáil le haghaidh OSS agus táirgeadh onnmhairí atá réidh le haghaidh tuairisceáin

Le haghaidh idirbheart OSS incháilithe, déan sonraí leabharmhíre a ghrúpáil de réir scéime, Ballstát an tomhaltais, cineál soláthair, catagóir ráta, ráta, méid inchánach, méid CBL, Ballstát seolta nó bunaíochta, airgeadra, agus tréimhse cheartúcháin.

Scarann tuairisceán scéim an Aontais soláthairtí de réir Ballstáit an tomhaltais agus déanann sé idirdhealú idir seirbhísí ón mBallstát aitheantais, seirbhísí ó bhunaíochtaí seasta eile, agus earraí a seoladh ó Bhallstáit éagsúla. Tuairiscíonn sé méideanna inchánacha agus CBL ar leithligh do rátaí caighdeánacha agus laghdaithe. Fanann soláthairtí díolmhaithe agus nialas-ráta amach as tuairisceán OSS go hiomlán.

Roinnt sonraí oibriúcháin a ghlacann daoine:

• Tá tréimhsí OSS an Aontais agus neamh-Aontas ráithiúil; tá IOSS míosúil. Tá tuairisceáin agus íocaíocht dlite faoi dheireadh na míosa dár gcionn.
• Teastaíonn tuairisceán nialasach do gach tréimhse fiú nuair nach ndearnadh aon soláthairtí ábhartha. Gineann seicliosta tréimhse agus cruthaigh tuairisceán nialas-luach go huathoibríoch.
• Déantar tuairisceáin OSS in euro, ag baint úsáide as ráta tagartha BCE ar an lá deiridh den tréimhse chánach i gcás inar gá comhtompú. Stóráil airgeadra na foinsí, ráta FX, dáta an ráta, méid comhtompaithe, agus modh.

Ba chóir go dtiocfadh onnmhairí ón leabharmhír iata, ní ó scarbhhileog taobh riamh. Caillfidh iomláin scarbhhileog ceartúcháin, tíortha seolta, rátaí, agus fianaise. Tá an méid seo a leanas in onnmhairiú: tréimhse tuairisceáin, scéim, Ballstát an tomhaltais, tír seolta, catagóir soláthair, ráta, méideanna inchánacha agus CBL, airgeadra agus ráta FX curtha i bhfeidhm, méideanna ceartúcháin na tréimhse reatha agus na tréimhse roimhe sin, IDanna bunsonrasc, tagairtí do nótaí creidmheasa, agus iomláin chomh-réitigh.

Bí beacht faoin méid a sheachadann an API anseo. Ríomhann Nordlet tuairisceáin OSS agus IOSS ó shonrasc agus ón leabharmhír lena n-áirítear ceartúcháin tréimhse roimhe sin, seachadann pacáistí tuairisceáin intíre don Liotuáin (FR0600), an Ghearmáin (UStVA) agus an Pholainn (JPK_V7M), agus gineann sé cláir i.SAF atá réidh le VMI don Liotuáin. Sin sonraí atá réidh le haghaidh tuairisceáin. Ní dhéanann glaonna API amháin tuairisceán CBL gach tíre a chomhdú trí gach geata náisiúnta, agus ní chuirtear aon tuairisceán faoi bhráid údaráis thar do cheann. Coinnigh cuntasaíocht, giniúint tuairisceáin, onnmhairiú, comhdú geata, agus dearbhú íocaíochta mar stáit ar leith i do chóras. Déanann treoir inneall CBL AE EU VAT engine guide doiciméadú ar na cásanna a réitíonn an inneall agus cá n-imríonn a chuid rabhaidh.

An tréimhse a ghlasáil

Tar éis athbhreithniú agus ceadú, déan sonrasc a chomh-réiteach le hiontrálacha leabharmhíre, déan iarmhéideanna CBL an leabharmhíre a chomh-réiteach leis an tset sonraí tuairisceáin, onnmhairigh an tuairisceán, taifead na tagairtí comhdaithe agus íocaíochta, agus ansin glasáil an tréimhse. Blocálann Nordlet postálacha chuig mí iata, lena n-áirítear tríd an API. Téann ceartúcháin tar éis glasála isteach i dtréimhse níos déanaí le hionchuir shoiléire chuig an mbundiciméad agus an tréimhse tuairisceáin lena mbaineann.

Módanna teipe coitianta agus conas iad a sheachaint

Mód teipe	Cén fáth a tharlaíonn sé	Maolú
Ag caitheamh le toradh VIES bailí mar rud leordhóthanach le haghaidh nialas-ráta	Ní bhunaíonn VIES cearta díolúine	Stóráil fianaise custaiméara, soláthair, iompair, agus sonrasc in éineacht leis an toradh
Ag caitheamh le toradh neamhbhailí mar chruthúnas nach bhfuil clárú ann	B'fhéidir nach bhfuil an uimhir gníomhachtaithe le haghaidh trádála idir-AE, nó d'fhéadfadh go mbeadh moill ar an mbunachar sonraí	Déan idirdhealú idir neamhbhailí, gan phróiseáil, agus teip theicniúil; ródú díospóidí chuig athbhreithniú
Ag déanamh checkout comhshrónach le VIES	Teorainneacha comhtharlaithe, teorainneacha ama, briseadh	Bailíochtú asincrónach, taisce gearrthéarmach, cúlú, stáit sealadacha
Taisceadh torthaí go deo	Athraíonn stádas clárúcháin agus gníomhachtaithe	Stóráil stampaí ama agus éag; athsheiceáil roimh shonrascú nuair a bhíonn siad as dáta
Mapáil táirgí go díreach chuig céatadáin CBL	Braitheann rátaí agus díolúintí ar thír agus ar dháta	Táirge chuig catagóir chuig cód tíre chuig ráta le héifeacht dáta
Athchruthú OSS ó scarbhileoga	Fágann iomláin ar lár ceartúcháin, tíortha seolta, fianaise	Díorthaigh ón leabharmhír do-athraithe le toisí ar gach iontráil
Seirbhísí bunaíochta intíre a chur san áireamh in OSS	Baineann seirbhísí áirithe leis an tuairisceán intíre	Déan bunaíochtaí a mhúnlú ar leith, ródú de réir scéime mus comhdhlúthaítear
Tuairisceáin nialasacha a fhágáil ar lár	Éilíonn OSS tuairisceán gach tréimhse	Gineann seicliosta agus cruthaigh tuairisceáin nialas-luach go huathoibríoch
Eagarthóireacht ar shonrasc iata le ceartú	Scriosann sé an nasc idir comhdú agus ceartú	Úsáid nótaí creidmheasa agus iontrálacha droim ar ais i dtréimhse níos déanaí

An rud a dhéanfaimis ar dtús

Dá mbeimis ag tús an chomhtháthaithe seo amárach, thógfaimis an tsraith catagóir cánach agus taifead cinntí CBL sula dteagmímis le haon phointe foirceann tuairisceáin. Faigh an tacsanomaíocht cobhsaí, faigh táirgí mapáilte chuig catagóirí, agus faigh an taifead cinntí ag gabháil comharthaí amh tíre móide an chúis a roghnaíodh áit an tsoláthair. Braitheann gach rud eile - VIES, postáil, grúpáil OSS, onnmhairiú - ar an mbunmhúnla sin a bheith ceart.

Ansin chuirfimis VIES suas mar chéim fianaise asincrónach leis na ceithre stát scartha, agus rithfimis é i gcoinne cuideachta sandbox le feistis do na cásanna gránna (teorainneacha ama, torthaí gan phróiseáil, réimíreanna mί-mheaitseáilte) mus ligfí aice le táirgeadh é. Is féidir na módanna teipe thuas a sheachaint go hiomlán beagnach má iompraíonn an model sonraí fianaise agus toisí tuairiscithe ón gcéad phostáil.

FAQ

An ciallaíonn freagra VIES bailí gur féidir liom díolachán B2B idir-AE a shermhír a nialasú?

Ní hionann. Dearbhaíonn VIES go bhfuil uimhir CBL cláraithe agus, i gcás inar tacaíodh leis, gníomhachtaithe le haghaidh trádála idir-AE. Braitheann an ceart chun soláthar idirphobail a dhíolmhú ar fhianaise bhreise: gurb é an custaiméir an faighteoir iarbhír, cruthúnas iompair nó seolta, áit cheart an tsoláthair, agus an abairt sonrasc riachtanach. Stóráil toradh VIES mar ionchur amháin, ní mar an cinneadh.

An cheart do bhailíochtú VIES checkout a bhlocáil?

Ní cheart. Is féidir le VIES dul as feidhm nó bualadh le teorainneacha comhtharlaithe, agus ní hionann briseadh agus uimhir neamhbhailí. Bailíochtaigh go hhasincrónach, taisce torthaí rathúla ar feadh tréimhse doiciméadaithe, déan iarracht arís ar theipeanna neamhbhuan, agus coinnigh cásanna débhríocha le haghaidh athbhreithniú le stát sealadach seachas an díolachán a theip.

An féidir le API cuntasaíochta scamall mo thuairisceáin CBL a chomhdú go huathoibríoch?

Is féidir leis sonraí atá réidh le haghaidh tuairisceáin a ghiniúint grúpáilte de réir scéime agus Ballstáit, ríomhte ón leabharmhír do-athraithe le ceartúcháin san áireamh. Braitheann sé ar an táirge agus ar an tír an ndéanann sé comhdú freisin trí gach geata comhdaithe náisiúnta. Ríomhann Nordlet tuairisceáin OSS agus IOSS, seachadann pacáistí tuairisceáin intíre don Liotuáin, an Ghearmáin agus an Pholainn, agus gineann sé cláir i.SAF atá réidh le VMI don Liotuáin, ach ní chuireann sé aon rud faoi bhráid údaráis chánach thar do cheann. Caith le cuntasaíocht, giniúint tuairisceáin, onnmhairiú, comhdú geata, agus íocaíocht mar stáit ar leith seachas a thoimhdean go ndéanann glao amháin comhdú i ngach áit.

Conas a dhéanaim cοrtúcháin a láimhseáil tar éis tréimhse a ghlasáil?

Postáil iad i dtréimhse ina dhiaidh sin le tagairtí soiléire chuig an mbundiciméad agus an tréimhse tuairisceáin lena mbaineann. Blocálann Nordlet postálacha nua chuig mí iata, lena n-áirítear tríd an API, agus mar sin sruthann ceartúcháin trí nótaí creidmheasa nó iontrálacha droim ar ais seachas eagarthóireacht. Cosnaíonn sé seo an líneacht idir an comhdú bunúsach agus an coigeartú.

Tuilleadh léitheoireachta

• Comhlíonadh CBL AE a uathoibriú le API cuntasaíochta scamall
• API cuntasaíochta scamall a chomhtháthú in ardán SaaS
• Seiceáil uimhir CBL (VIES), An Coimisiún Eorpach