Nordlet

← All features

Software tal-kontabilità b'API

Kull parti ta' Nordlet hija disponibbli permezz ta' API JSON waħda, b'SDKs, webhooks, tentattivi mill-ġdid idempotenti u server tal-MCP għall-assistenti tal-intelliġenza artifiċjali.

L-API (interface tal-programmazzjoni tal-applikazzjonijiet) hija mezz kif programm wieħed jikkomunika ma' ieħor. API tal-kontabilità tħalli lis-software tiegħek joħloq fatturi, jirreġistra ħlasijiet u jaqra rapporti, mingħajr ma persuna jkollha tikklikkja l-iskrins.

Nordlet huwa software tal-kontabilità fejn l-API hija l-mezz ewlieni ta' dħul. Kulma tagħmel l-applikazzjoni tal-web huwa disponibbli fuq l-istess JSON API. Din il-paġna hija maħsuba għall-iżviluppaturi u għal dawk li jieħdu d-deċiżjonijiet dwar x'għandu jikkonnettja mal-prodott tagħhom.

X'jagħmel Nordlet

  • Struttura ta' talba waħda. Kull sejħa hija POST /v1/{module}/{resource}/{action} b'korp JSON, pereżempju sales/invoices/create jew bank/transactions/match.
  • Ċwievet tal-API bi skopijiet (scopes). Kull ċavetta tappartjeni lil kumpanija waħda u jkollha skopijiet assoċjati bħal sales:read jew bank:write. Ċavetta li ma jkollhiex l-iskop meħtieġ tirċievi tweġiba 403.
  • Flus bħala test. L-ammonti huma kodiċijiet deċimali b'sa 4 postijiet deċimali, qatt numri b'punt f'wiċċ l-ilma (floating-point numbers), sabiex ma jintilfux ċenteżmi minħabba l-arrotondament.
  • Format ta' żball wieħed. Kull żball għandu l-istess envelop b'kodiċi, messaġġ u ID tat-talba.
  • Mistoqsijiet ta' listi kondiviżi. Kull sejħa ta' list tieħu l-istess oqsma ta' paginazzjoni, ordni u filtri, u tista' tirritorna totali.
  • Regoli kontabbli reali. L-entries tal-ġurnal (journal entries) iridu jibbilancjaw, in-numri tad-dokumenti ma jista' jkollhom l-ebda vojt, u perjodu kontabbli (accounting period) imsakkar jirrifjuta posts ġodda bi tweġiba 409. Kull bidla tiġi miktuba f'reġistru tal-verifika (audit log).

Tentattivi mill-ġdid sikuri bl-idempotenza

In-netwerk jista' jfalli wara li t-talba tiegħek tkun ġiet ipproċessata iżda qabel ma tkun irċevejt it-tweġiba. Jekk terġa' tipprova, tista' tispiċċa toħloq l-istess fattura darbtejn. L-idempotenza (idempotency) tfisser li talba ripetuta jkollha l-istess effett bħ>**l-ewwel waħda.

  • Ibgħat header Idempotency-Key ma' kwalunkwe sejħa li tibdel id-data.
  • Tentattiv mill-ġdid bl-istess ċavetta u l-istess korp jirċievi t-tweġiba maħżuna lura, flimkien ma' x-idempotent-replay: true.
  • L-istess ċavetta b'korp differenti tiġi rifjutata.
  • Iċ-ċwievet jinżammu għal 24 siegħa.

Webhooks

Il-webhook huwa messaġġ li Nordlet jibgħat lis-server tiegħek meta jiġri xi ħaġa, bħal sale_invoice.paid.

  • L-avvenimenti jinkitbu fl-istess transazzjoni tad-database bħall-bidla, u għalhekk bidla li titħassar ma tibgħat l-ebda avveniment.
  • Kull konsenja tiġi ffirmata b'HMAC-SHA256 bl-użu tas-sigriet tas-subskrizzjoni tiegħek, sabiex tkun tista' tivverifika li ġiet minn Nordlet.
  • Konsenja li tfalli terġa' tiġi ppruvata għal madwar 24 siegħa. Tista' wkoll terġa' tibgħatha manwalment.
  • Is-subskrizzjonijiet jiġu mmaniġġjati taħt Account → Webhooks jew permezz tal-API.

Għodod għall-iżviluppaturi

  • Referenza tal-API. Referenza tal-API interattiva mibnija mid-deskrizzjoni OpenAPI, flimkien ma' ġabra ta' Postman (Postman collection).
  • SDKs. Klijenti tipizzati għal TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift u Rust, iġġenerati mill-istess deskrizzjoni. Ara l-gwida tal-SDKs.
  • Server tal-MCP. Assistenti tal-intelliġenza artifiċjali bħal Claude jistgħu jfittxu u jsejħu l-API bl-użu taċ-ċavetta tal-API tiegħek. Ara l-gwida tas-server tal-MCP.
  • Kumpaniji sandbox. Kumpanija tat-test taħdem bħal waħda reali, tkun immarkata bħala data tat-test, u tibgħat preżentazzjonijiet u e-fatturi (e-invoices) biss lill-endpoints tat-test tal-amministrazzjonijiet.
  • Limitu tar-rata (Rate limit). 300 talba kull minuta għal kull ċavetta tal-API, b'headers li juru dak li fadal.

FAQ

X'nista' nagħmel permezz tal-API?

Kulma hemm fil-prodott: fatturazzjoni, xiri, il-ktieb il-kbir (general ledger), tqabbil tal-banek, stokk, assi, pagi, rapporti u preżentazzjonijiet lill-pajjiż. Il-gwida tal-bidu (getting started guide) timxi pass pass ma' ċiklu sħiħ mill-fattura sal-figuri tal-VAT.

Nista' nbni l-kontabilità fil-prodott tiegħi stess?

Iva. Kull kumpanija f'Nordlet għandha l-kotba tagħha stess, u s-software tiegħek jaħdem fuqhom permezz taċ-ċavetta tal-API tiegħu. L-API m'għandha l-ebda sejħa li teditja jew tħassar entry tal-ġurnal li tkun saret tpartit. Korrezzjoni tkun entry ġdida, li żżomm reġistru immutabbli (immutable ledger).

Relatati