Utvecklare

Bygg vidare på Jurisma

Jurisma har två gränssnitt: ett API för egna integrationer, till exempel ett CRM eller ett webbformulär, och en MCP-server för AI-assistenter som Claude och ChatGPT. Båda använder samma verktyg, samma behörigheter och samma loggning.

Kom igång

Verksamhetens ägare skapar en API-nyckel under Verksamhet → API i Jurisma och väljer vilka områden nyckeln får läsa eller ändra. Nyckeln börjar med jur_api_, visas bara en gång och gäller i sex månader. Ägaren får en påminnelse 30 och 7 dagar innan den går ut, och kan när som helst skapa en ny eller återkalla en nyckel.

Skicka nyckeln i Authorization-headern i varje anrop:

Authorization: Bearer jur_api_…

Anrop

API:t har samma verktyg som MCP-servern. Hämta listan över verktygen som din nyckel får använda, med JSON-schema för indata:

GET https://jurisma.se/api/v2/tools

Kör ett verktyg genom att skicka dess argument som JSON:

POST https://jurisma.se/api/v2/tools/jurisma_create_customer
Content-Type: application/json

{
  "name": "Exempel AB",
  "orgOrPersonNumber": "556677-8899",
  "customerType": "COMPANY",
  "email": "info@exempel.se"
}

Svaret är { "data": … }. Klienter som skapas via API:t jävskontrolleras och loggas i kontrolloggen. Svaret har då även conflictChecks, och en träff som kräver ställningstagande ger ägaren en notis.

Undvik dubbletter genom att först slå upp klienten på person- eller organisationsnummer. Svaret är { "found": true, "customer": { "id": … } } eller { "found": false, "customer": null }. Finns klienten uppdaterar du den med jurisma_update_customer och dess id; annars skapar du den.

POST https://jurisma.se/api/v2/tools/jurisma_find_customer_by_identity
Content-Type: application/json

{ "orgOrPersonNumber": "556677-8899" }
POST https://jurisma.se/api/v2/tools/jurisma_update_customer
Content-Type: application/json

{ "id": "…", "phone": "070-123 45 67", "notes": "Kompletterande uppgifter från formuläret" }

Bekräftelse av riskfyllda åtgärder

Åtgärder som inte går att ångra, till exempel att radera, makulera, kreditera eller föra över till bokföringen, kräver två anrop precis som i MCP. Det första svarar 202 med status: "confirmation_required" och en token. Skicka samma argument igen inom tio minuter med confirmation tillagt:

{ …samma argument…, "confirmation": { "approve": true, "token": "…" } }

En token kan bara användas en gång.

Områden

Ägaren väljer för varje område om nyckeln får läsa, läsa och ändra eller inget alls.

  • general – Översikt och sök
  • customers – Klienter och parter
  • cases – Ärenden
  • time – Tid och kostnader
  • invoices – Fakturor och betalningar
  • calendar – Kalender och uppgifter
  • documents – Dokument och filer
  • email – E-post (läsa och koppla)
  • compliance – Jäv och kundkännedom
  • clientFunds – Klientmedel
  • accounting – Bokföring och bolag
  • payroll – Lön och utlägg
  • portal – Klientportal
  • agent – Agentkön

Begränsningar

  • API:t kan aldrig skicka något i byråns namn: inga mejl, fakturamejl, betalningspåminnelser, portalåtkomst eller ändrade mejlsignaturer.
  • Bara verksamhetens ägare kan skapa nycklar. Slutar personen vara ägare slutar nyckeln fungera.
  • Varje anrop loggas med nyckelns namn, även läsningar.
  • Högst 120 anrop per minut och nyckel, och högst tio aktiva nycklar per verksamhet.

Felkoder

Fel har formen { "error": …, "errorCode": …, "traceId": … }.

400
Ogiltiga indata. issues anger fält och fel.
401
Nyckel saknas, är ogiltig, återkallad eller har gått ut.
403
Nyckeln saknar området, eller den som skapade den är inte längre ägare.
404
Verktyget finns inte, eller funktionen är avstängd för verksamheten.
409
Krock, till exempel att klienten redan finns eller att jäv föreligger.
429
För många anrop. Högst 120 per minut och nyckel.
500
Oväntat fel. Ange traceId när du kontaktar oss.

MCP för AI-assistenter

MCP-servern finns på https://jurisma.se/api/mcp och kopplas med inloggning (OAuth 2.1 med PKCE). Varje användare kopplar sin egen assistent under Inställningar → AI och assistenten får samma åtkomst som användaren. Utskick kräver att användaren godkänner i Jurisma.

claude mcp add jurisma --transport http https://jurisma.se/api/mcp

Frågor om API:t? Skriv till info@jurisma.se.