Nordlet

← All features

Nordlet d'fhorbróirí feidhmchlár

Cuir sonrascadh, comhtheastacht chuntasaíochta agus tuairisciú cánach san Aontas Eorpach le do bhogearraí trí aon API JSON amháin, SDKanna cló-chriticiúla, rabhcháin (webhooks), freastalaí MCP agus cuideachtaí seascain (sandbox).

Cruthaíonn go leor feidhmchlár teagmhais airgid: íocann ordú, athnuaitear síntiús, eisítear aisíocaíocht. Caithfidh gach ceann de na teagmhais seo a bheith le feiceáil i leabhair chuntasaíochta na cuideachta.

Is bogearraí cuntasaíochta é Nordlet a dearadh le cur chuige API ar dtús. Tá gach rud a dhéanann an feidhmchlár gréasáin ar fáil freisin trí aon API JSON amháin. Seolann d'fheidhmchlár na teagmhais, agus coinníonn Nordlet na leabhair agus ullmhaíonn sé na tuairiscí cánach.

Cad a dhéanann Nordlet

  • Nochtann sé gach gníomh mar POST /v1/{module}/{resource}/{action} le corp JSON, mar shampla /v1/sales/invoices/create.
  • Fíoraíonn sé gach iarratas le eochair API a bhaineann le cuideachta amháin. Tá raonta feidhme (scopes) ag baint le gach eochair, amhail sales:read nó sales:write, lena gcuirtear teorainn lena bhfuil le déanamh aici.
  • Glacann sé le méideanna mar shreangáin deachúla, gan iad a athrú go huimhreacha snámhphointe, ionas nach gcailltear aon cent de bharr slánaithe.
  • Glacann sé le ceanntásc Idempotency-Key ar gach athrú. Má dhéantar iarratas arís leis an eochair chéanna, tugtar an chéad fhreagra ar ais seachas an obair a dhéanamh faoi dhó. Ciallaíonn dí-thionchar (idempotency) go mbíonn an éifeacht chéanna ag iarratas athchฯmar agus atá ag aon iarratas amháin.
  • Tugann sé gach earráid ar ais i bhformáid chomhroinnte amháin.
  • Ligeann sé 300 iarratas in aghaidh an nóiméid in innéacs gach eochair API.
  • Taifeadann sé gach athrú i loga iniúchta (audit log).

Pléitear gach ceann de na rialacha seo go mion sa treoir maidir le comhionannais API.

Leabhair a fhanann cruinn

  • Sannann eisiúint sonrasc uimhir leanúnach gan bhearnaí, seiceann sé go bhfuil an tréimhse chuntasaíochta oscailte, agus postálann sé an iontráil irise (journal entry) sa idirbheart bunachar sonraí céanna.
  • Caithfidh gach postáil a bheith cothrom. Seiceann an bunachar sonraí féin é seo nuair a shábháiltear an t-idirbheart.
  • Ní féidir doiciméid eisithe agus cláraithe a scriosadh. Déantar cluiche banc mícheart a chealú le hiontráil droim ar ais, seachas an ceann sean a chur in eagar. Is é seo a chiallaíonn leabhar mór dothuaslagtha (immutable ledger).

SDKanna, MCP agus rabhcháin

  • Gineann SDKanna cló-chriticiúla ón sainmhíniú OpenAPI céanna do TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift agus Rust. Go dtí go bhfoilsítear SDK, suiteálann tú é ón stór foinseach aige. Féach ar an treoir SDKanna.
  • Tá bailiúchán Postman a chuimsíonn gach críochphointe ar fáil.
  • Ligeann an freastalaí MCP d'aitheantóir AI amhail Claude Code cuardach a dhéanamh san API agus é a ghlaoch le d'eochair API. Is iarratas gnáth API é gach gairm leis na raonta feidhme agus na teorainneacha céanna.
  • Cuireann rabhcháin (webhooks) in iúl do d'fheidhmchlár nuair a tharlaíonn rud éigin, mar shampla sale_invoice.issued nó sale_invoice.paid. Síneann gach seachadadh le síniú HMAC ionas gur féidir leat a sheiceáil gur tháinig sé ó Nordlet. Déantar iarratas eile ar sheachadtaí ar thrífheidh ar feadh thart ar 24 uair an chloig.

Tástáil le cuideachtaí seascain

  • Cruthaigh cuideachta le isSandbox: true, nó cuir tic sa bhosca seascain nuair a bhunaíonn tú cuideachta san fheidhmchlár.
  • Oibríonn cuideachta seascain díreach mar chuideachta fhíor: na modúil céanna, an API céanna.
  • Tá sé marcáilte go soiléir mar shonraí tástála, agus ní féidir cuideachta fhíor a athrú go cuideachta seascain nó a mhalairt.
  • Téann tuairiscí agus ríomhshonrasc de chuid cuideachta seascain chuig seirbhísí tástála na n-riarachán.
  • Déantar úsáid i gcuideachta seascain a thomhas agus a mHilleadh díreach mar úsáid i gcuideachta fhíor.

Siúlann an treoir thosaithe tríd an gcéad eochair API, an chéad sonrasc agus an timthriall iomlán.

FAQ

An féidir le feidhmchlár amháin freastal ar roinnt cuideachtaí?

Is féidir. Baineann gach eochair API le cuideachta amháin, agus mar sin cruthaíonn tú eochair in aghaidh na cuideachta. Tá an companyId den chuideachta lena mbaineann sé i gceann gach seachadta rabhcháin, ionas gur féidir le glacadóir amháin freastal ar roinnt cuideachtaí.

An éigean dom na tuairiscí cánach a thógáil dom féin?

Ní éigean. Tógann Nordlet na tuairiscí ó na leabhair. I gcás gach tuairisce, seolann sé é, tógann sé comhad a uaslódálann tú, nó taispeánann sé figiúirí a chuireann tú isteach, ag brath ar an tír. Liostaíonn tábla tacaíochta tuairiscithe gach cás.

Gaolmhar