Nordlet

← All features

Nordlet għall-iżviluppaturi tal-apps

Żid il-fatturazzjoni, iż-żamma tal-kotba u d-dikjarazzjonijiet tat-taxxa tal-UE mas-software tiegħek permezz ta' JSON API waħda, SDKs ittajpjati, webhooks, server tal-MCP u kumpaniji sandbox.

Bosta apps jiġġeneraw tranżazzjonijiet finanzjarji: ordni titħallas, abbonament jiġi mġeddad, rifużjoni tinħareġ. Kull waħda minn dawn l-avvenimenti trid tispiċċa fil-kotba tal-kumpanija.

Nordlet hija software tal-kontabilità mibni l-ewwel nett fuq l-API (API-first). Dak kollu li tagħmel il-web app huwa disponibbli wkoll permezz ta' JSON API waħda. L-app tiegħek tibgħat l-avvenimenti, u Nordlet iżżomm il-kotba u tħejji d-dikjarazzjonijiet tat-taxxa.

X'jagħmel Nordlet

  • Jesponi kull azzjoni bħala POST /v1/{module}/{resource}/{action} b'korp f'format JSON, per eżempju /v1/sales/invoices/create.
  • Jawtentika kull talba b'API key li tappartjeni lil kumpanija waħda. Kull key ikollha l-permessi (scopes) tagħha, bħal sales:read jew sales:write, li jillimitaw dak li tista' tagħmel.
  • Jaċċetta l-ammonti bħala string ta' deċimali, qatt biex ikunu numri b'floating-point, sabiex ma tintilef l-ebda ċenteżmu minħabba l-arrotondar.
  • Jaċċetta header Idempotency-Key fuq kull bidla. Tentattiv mill-ġdid bl-istess key jirritorna l-ewwel tweġiba minflok ma jerġa' jagħmel ix-xogħol darbtejn. L-idempotenza (idempotency) tfisser li talba ripetuta tħalli l-istess effett b'talba waħda.
  • Irritorna kull żball f'format wieħed maqsum.
  • Jippermetti 300 talba fil-minuta għal kull API key.
  • Irreġistra kull bidla f'reġistru tal-verifika (audit log).

Il-gwida dwar il-konvenzjonijiet tal-API kopri kull waħda minn these rules fid-dettall.

Kotba li jibqgħu korretti

SDKs, MCP u webhooks

  • L-SDKs ittajpjati huma ġenerati mill-istess deskrizzjoni OpenAPI għal TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift u Rust. Sakemm jiġi ppubblikat SDK, tinstallah mir-repożitorju tas-sors tiegħu. Ara l-gwida tal-SDKs.
  • Kollezzjoni ta' Postman b'kull endpoint hija disponibbli.
  • Is-server tal-MCP jippermetti lil assistent tal-AI bħal Claude Code biex ifittex fl-API u jsejħilha bl-API key tiegħek. Kull sejħa hija talba ordinarja tal-API bl-istess permessi u limiti.
  • Il-webhooks jinnotifikaw lill-app tiegħek meta jiġri xi ħaġa, per eżempju sale_invoice.issued jew sale_invoice.paid. Kull kunsinna hija ffirmata b'firma HMAC sabiex tkun tista' tivverifika li ġiet minn Nordlet. Kunsinni li ma rnexxewx jerġgħu jippruvaw jintbagħtu għal madwar 24 siegħa.

Ittestjar b'kumpaniji sandbox

  • Oħloq kumpanija b'isSandbox: true, jew immarka l-kaxxa tas-sandbox meta tistabbilixxi kumpanija fl-app.
  • Kumpanija sandbox taħdem bħal waħda reali: l-istess moduli, l-istess API.
  • Hija mmarkata b'mod ċar bħala data tat-test, u ma tistgħux tibdel kumpanija reali f'sandbox jew bil-maqlub.
  • Id-dikjarazzjonijiet u l-e-fatturi (e-invoices) ta' kumpanija sandbox jintbagħtu lis-servizzi tat-test tal-amministrazzjonijiet.
  • L-użu f'kumpanija sandbox jitkejjel u jiġi fatturat eżattament bħall-użu f'kumpanija reali.

Il-gwida dwar kif tibda (getting started) tagħtik ħarsa ġenerali lejn l-ewwel API key, l-ewwel fattura u ċ-ċiklu sħiħ.

FAQ

App waħda tista' tiggwida lil diversi kumpaniji?

Iva. Kull API key tappartjeni lil kumpanija waħda, għalhekk inti toħloq key għal kull kumpanija. Kull kunsinna ta' webhook iġorr il-companyId tal-kumpanija li tappartjeni lilha, sabiex riċevitur wieħed ikสามารถ iservi diversi kumpaniji.

Għandi bżonn inbena d-dikjarazzjonijiet tat-taxxa jien stess?

Le. Nordlet jibni d-dikjarazzjonijiet mill-kotba. Għal kull dikjarazzjoni, jew jibgħatha, jew jibni fajl li int tella', jew juri ċ-ċifri li int iddaħħal, skont il-pajjiż. It-tabla ta' appoġġ għad-dikjarazzjonijiet elenka kull każ.

Relatati