För AI-assistenter

Hela API:t i ett dokument

Komplett specifikation av Asstios REST + MCP API — endpoints, schemas, autentisering, exempel och versionskontrakt — i ett enda dokument optimerat för LLMs. Klistra in i Claude, Cursor eller ChatGPT och få hjälp att bygga integrationer direkt.

 Ladda ner som .md

Direktlänk: https://www.asstio.com/llms-api.txt

Asstio API-spec för AI

Ge er AI-assistent full kontext om Asstio

1. Klistra in i chatten

Klicka "Kopiera hela specen" ovan, klistra in i Claude / ChatGPT som ett system- eller user-message. AI:n får komplett kunskap om alla endpoints och kan hjälpa er bygga integrationer direkt.

2. Länka direkt

Be Claude eller en assistent med web-access att hämta /llms-api.txt. Med Claude.ai: "Fetch https://www.asstio.com/llms-api.txt och hjälp mig bygga…". Med Cursor: lägg URL:en som @docs.

3. Koppla via MCP istället

Behöver assistenten faktiskt köra anrop — inte bara förstå API:t — använd Asstios MCP-server direkt. Då exponeras varje endpoint som ett verktyg. Se MCP-setup →

Specen täcker hela v1

Ett enda Markdown-dokument med allt en LLM behöver för att resonera om eller generera kod mot Asstio.

1Översikt & base URLs 2Autentisering (3 flöden) 3Konventioner & paginering 413 endpoints med schemas 5MCP-konfiguration 6Versions­kontrakt 7Use cases för LLM-prompts 8Vad som inte finns i v1

Tre exempel på hur ni öppnar Claude med Asstios spec

PROMPT Power BI-dashboard
Här är Asstios API-spec:

[klistra in /llms-api.txt här]

Hjälp mig bygga en C# .NET 9-konsolapp
som hämtar alla öppna säljordrar och
sparar dem som CSV för Power BI-import.
Använd Bearer-auth via app-lösenord.
PROMPT Slack-bot
Du har tillgång till Asstios API
(spec nedan). Skriv ett Node.js-script
som körs nattligt och postar till Slack
om någon orderrad i open-order-lines
ligger 30+ dagar utan delleverans.

[klistra in /llms-api.txt här]
PROMPT Analytisk fråga
Här är Asstios API. Vilka endpoints
behöver jag kombinera för att svara
på frågan: "Vilka 5 kunder hade
högst snittfaktura senaste kvartalet,
och vad köpte de mest av?"

[klistra in /llms-api.txt här]

Specen i sin helhet

Samma dokument som ligger på /llms-api.txt — här visat med rubrikstruktur så ni kan skumma innan ni kopierar.

1. Översikt

REST under /api/v1/* för servrar och script. MCP-server för Claude, Cursor, Cline. Samma data, samma auth, samma versionskontrakt.

Base URL: https://purchase.svc.order.asstio.com/api/v1/

Samma host för alla tenants — er tenant väljs av iid (InstanceId)-claim inuti tokenen, inte av hostnamnet.

2. Autentisering

Tre olika flöden — ett per användartyp.

  • Servrar / cron-jobb: Skapa app-lösenord i Asstio → växla mot Zitadel-token → cacha → använd som Authorization: Bearer.
  • In-browser: Token finns redan i Asstio-sessionen.
  • AI-assistenter: OAuth-discovery enligt RFC 9728 — Claude Desktop / Cursor sköter det själva.

Rate-limits: REST har inga per-user-limits idag. MCP: 60 tool-calls/min/användare i ett sliding window — bursts ger 429 med Retry-After: 60.

3. Konventioner & datamodell

  • ISO 8601 UTC, UTF-8 JSON in/ut, decimaler som JSON-nummer med 2 decimalers precision.
  • Cursor-baserad paginering: nextCursor i responsen → ?cursor=… i nästa request. Cursors är opaka base64.
  • Default pageSize = 50, max per endpoint (oftast 100, 200 för warehouse-stock).
  • Versionsheader X-Asstio-Api-Version: v1 på varje response.
  • Document model: alla rader (säljorder, säljfaktura, kreditfaktura, inköpsorder) ligger i samma Orders-tabell, diskriminerad av OrderStatusType.SystemName och tre flaggor: IsOrderIntake, IsSales, IsPurchase.

4. Endpoints (13 st)

10 read-only endpoints (alla MCP-verktyg) + 3 endpoints för 3-vägs-matchning av leverantörsfakturor.

MethodPathVerktyg/syfte
GET/sales-orderslist_sales_orders
GET/purchase-orderslist_purchase_orders
GET/sales-invoiceslist_sales_invoices
POST/sales-invoice-lineslist_sales_invoice_lines
GET/open-order-lineslist_open_order_lines
GET/warehouse-stockget_warehouse_stock
GET/vendor-pricesget_vendor_prices_for_product
GET/products/findfind_product
GET/customerslist_customers
GET/customers/{id}get_customer
GET/purchase-invoice-matches/{id}3-vägs-matchning
POST/purchase-invoice-matches/{id}/confirmspara matchningar
POST/purchase-invoice-matches/{id}/match-whole-ordermatcha hel PO

Varje endpoint i den fulla specen har komplett query-parameter-lista och response-schema med fältnamn, typer och exempelvärden.

5. MCP-konfiguration

Claude Desktop, Cursor och Cline — alla använder samma claude_desktop_config.json-pattern. Custom-klienter kan upptäcka servern via RFC 9728 OAuth Protected Resource discovery på /.well-known/oauth-protected-resource.

6. Versions­kontrakt

Inuti v1: bara additiva ändringar. Fältnamn, typer och default-beteenden ändras inte. Breaking changes landar på /api/v2/*. v1 fortsätter köra tills sista integratorn migrerat.

7. ErrorEnvelope

Non-2xx-responses returnerar code, message och valfritt traceId. Statuskoder: 400 bad_request, 401 unauthorized, 403 forbidden, 404 not_found, 429 rate_limited (MCP), 500 internal_error.

8. Vad som inte finns i v1

  • Skrivande operationer på affärsdata (utöver de 2 PO-match-endpoints som persisterar matchningar).
  • Bokföringsdata (huvudbok, kontoplan) — kommer i v1.x.
  • Lön — under utveckling.
  • Lagerrörelser detaljerat (bara aktuella saldon idag).
  • Bilagor och dokument.
Få access

Redo att låta er AI prata med Asstio?

Kontakta oss för app-lösenord, tenant-URL och MCP-endpoint — och säg gärna vad ni vill bygga, så pekar vi mot rätt endpoints och prompts.

Kontakta oss Tillbaka till /api →