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/toolsKö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ökcustomers– Klienter och partercases– Ärendentime– Tid och kostnaderinvoices– Fakturor och betalningarcalendar– Kalender och uppgifterdocuments– Dokument och fileremail– E-post (läsa och koppla)compliance– Jäv och kundkännedomclientFunds– Klientmedelaccounting– Bokföring och bolagpayroll– Lön och utläggportal– Klientportalagent– 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/mcpFrågor om API:t? Skriv till info@jurisma.se.