Hoppa till innehållet
Utvecklare
English GitHub

Utvecklare

Ändringar i API:t

Varje ändring i NONOX Connect API, den senaste först. Inom v1 görs bara tillägg (nya anrop, nya frivilliga fält, nya värden i svar); något som skulle bryta en befintlig integration får /v2, och v1 finns kvar bredvid i minst tolv månader. Filen visas på nonox.app/utvecklare/andringar.

2026-11-01: v1.1.0

Tillagt

  • Webhooks skickas nu: voucher.posted, invoice.sent, invoice.paid, supplier_invoice.approved. Signerade med Nonox-Signature: t=<unix>,v1=<HMAC-SHA256 av "t.kropp">, med Nonox-Event-Id och Nonox-Event-Type, skickade efter commit, åtta försök under ungefär ett dygn och sedan avstängning med mejl till ägaren. Hanteras under Anslutningar (ägare eller administratör, passkey).
  • Återkallelse av token (RFC 7009): POST /oauth/revoke, och revocation_endpoint i metadata.
  • Artiklar: GET/POST /articles, GET/PATCH /articles/{id}.
  • Kostnadsställen och projekt: GET/POST /cost-centers, GET/PATCH /cost-centers/{id}, samma för /projects.
  • Kundfakturor: GET/POST /invoices, GET/PATCH /invoices/{id}, POST /invoices/{id}/issue, /send, /credit, /payments, GET /invoices/{id}/pdf.
  • Leverantörsfakturor: GET/POST /supplier-invoices, GET/PATCH/DELETE /supplier-invoices/{id}, POST /supplier-invoices/{id}/file, /register, /approve, /payments.
  • Betalningar: GET /payments, GET /supplier-payments.
  • Rapporter: GET /reports/trial-balance, /general-ledger, /balance-sheet, /income-statement.
  • Moms: GET /vat-periods, GET /vat-return.
  • Räkenskapsår: GET /fiscal-years/{id}/periods (låsta månader), GET /fiscal-years/{id}/sie (SIE 4).
  • Scopes: accounts:manage, reports:view, vat:prepare, export:sie, invoices:send, invoices:credit, payments:create.
  • required_scope_sets i 403 insufficient_scope: vilka kombinationer av scopes som räcker.
  • Testföretag med exempeldata för att prova API:t (php artisan connect:test-company eller under Anslutningar).

Ändrat

  • Beskrivningarna av invoices:view, invoices:create, supplier-invoices:create och supplier-invoices:approve täcker nu också de nya resurserna. En nyckel eller app som redan har dem får tillgång till de nya adresserna inom samma område; inget som fungerade tidigare slutar fungera.

2026-11-01: utvecklarwebben

  • Den publika utvecklarwebben på /utvecklare, på svenska och engelska (?lang=en): guider, en referens som genereras från openapi.yaml, kodexempel i curl, PHP, JavaScript och Python, och specifikationen att ladda ner som YAML och JSON.
  • openapi.yaml: taggarna har fått ett engelskt namn (x-en-name) och behörigheterna en svensk beskrivning (x-sv-scopes). Bara tillägg; inget anrop har ändrats.

2026-11-01: v1.0.0

Första versionen av NONOX Connect (ADR-032).

  • Anrop: företaget, kontoplanen, momskoder, räkenskapsår, verifikationsserier, verifikationer (lista, hämta, skapa och ändra utkast, ta bort utkast, bokföra, rätta, underlag upp och ner), kunder och leverantörer (lista, hämta, skapa, ändra).
  • Autentisering: OAuth 2.0 med auktoriseringskod och PKCE (S256 för alla appar), godkännande av ägare eller administratör med passkey, access tokens på högst 15 minuter, refresh tokens som byts vid varje användning och återkallar hela anslutningen om de används två gånger. API-nycklar med slutdatum och valfri IP-lista.
  • Regler: Idempotency-Key på varje POST, sidindelning med markör och updated_since, fel som problem+json (RFC 9457), gränser per nyckel, företag och IP-adress med RateLimit-*-huvuden.
  • Kommer: webhooks för voucher.posted, invoice.sent, invoice.paid och supplier_invoice.approved är beskrivna men skickas inte ännu.

Föreslå en ändring på GitHub