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
OpenAPI 3.1: https://api.asstio.com/api/v1/openapi.json

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 — koppla den till Asstios MCP-server på https://mcp.asstio.com/mcp. Då anropar den verktygen med era behörigheter. 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 och API-nycklar 3Konventioner & paginering 4Endpoints med schemas 5MCP-konfiguration 6Versions­kontrakt 7Felkoder 8Gränser 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 en API-nyckel (asstio_…)
som Bearer-token.
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://api.asstio.com/api/v1/
MCP: https://mcp.asstio.com/mcp
OpenAPI: https://api.asstio.com/api/v1/openapi.json
Interaktiv referens: https://api.asstio.com/api/v1/docs

Samma host för alla bolag. Bolaget följer med nyckeln eller inloggningen, inte med hostnamnet. OpenAPI-dokumentet och den interaktiva referensen går att läsa utan nyckel.

2. Autentisering

Tre flöden — ett per användartyp.

  • Servrar, cron-jobb och Power BI: Skapa en API-nyckel under Inställningar → API-nycklar och skicka den som Authorization: Bearer asstio_…, bara i headern. Nyckeln agerar som en vald person med den personens behörigheter, är Läs eller Läs och skriv, och visas en gång.
  • In-browser: Token finns redan i Asstio-sessionen.
  • AI-assistenter via MCP: OAuth-discovery enligt RFC 9728 — Claude Desktop och Cline sköter det själva. API-nycklar fungerar inte mot MCP-servern.

Rate-limits: REST har ingen gräns per användare i dag, men ett anrop med API-nyckel kan få ett tillfälligt 429. 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

Ett urval nedan. Dokumentet beskriver hela v1, och OpenAPI-dokumentet är den exakta referensen för varje operation.

MethodPathVerktyg/syfte
GET/sales-orderslist_sales_orders
GET/sales-orders/{id}get_sales_order
GET/sales-orders/{id}/contactget_sales_order_contact
GET/sales-orders/{id}/fulfilmentget_sales_order_fulfilment
GET/sales-orders/{id}/paymentget_sales_order_payment
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-priceslist_product_vendor_prices
GET/products/findendast REST
GET/customerslist_customers
GET/customers/{id}get_customer
GET/purchase-invoice-matches/{id}suggest_purchase_invoice_matches
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

Ange https://mcp.asstio.com/mcp som serverns URL i klientens MCP-konfiguration. Klienter kan upptäcka inloggningen via RFC 9728 OAuth Protected Resource discovery på /.well-known/oauth-protected-resource. Skrivande verktyg körs med användarens behörigheter, utan något eget bekräftelsesteg i Asstio.

6. Versions­kontrakt

Inuti v1: bara additiva ändringar. Fältnamn, typer och default-beteenden ändras inte. Ett undantag görs bara med avsikt och står i dokumentets ändringslogg; hittills ett, i september 2026, för skrivanropen till butikens filterinställningar. Breaking changes landar på /api/v2/*. v1 fortsätter köra tills sista integratorn migrerat.

7. ErrorEnvelope

De flesta fel returnerar code, message och valfritt traceId. Statuskoder: 400 bad_request, 401 unauthorized, 403 forbidden (även en nyckel med Läs på ett skrivande anrop), 404 not_found, 429 rate_limited (MCP, eller tillfälligt för API-nycklar). En 500 har ingen garanterad body, och några operationer har egna felformat som OpenAPI-dokumentet anger.

8. Gränser i v1

  • API-nycklar fungerar bara på operationerna i OpenAPI-dokumentet. Butikens endpoints och uppladdningen av företagets logotyp ligger utanför det och tar inte emot nycklar.
  • MCP-servern tar inte emot API-nycklar, bara en inloggning.
  • En nyckel kan inte skapa eller återkalla andra nycklar. Det görs i webbappen.
Få access

Redo att låta er AI prata med Asstio?

Skapa en API-nyckel under Inställningar → API-nycklar, eller koppla er AI-klient till https://mcp.asstio.com/mcp. Säg gärna vad ni vill bygga, så pekar vi mot rätt endpoints och prompts.

Kontakta oss Tillbaka till /api →