Beskrivning

Contract är en tjänst för att lagra metadata och bilagor för olika typer av kontrakt och avtal. Det är möjligt att lagra, hämta, uppdatera samt ta bort kontrakt och bilagor. I dagsläget stödjer tjänsten endast arrendeavtal men kan vid behov utökas för att stödja fler varianter av avtal.

Kontrakt och bilagor

Kontrakt och bilagor hanteras separat i API:et, dvs kontraktets metadata hanteras av en resurs medan bilagorna hanteras i en annan. 
För att uppdatera ett kontrakt (via PATCH) måste kontraktet i sin helhet skickas in då det kommer att skapas en ny version med enbart det data som skickades in.

Vid hämtning av ett kontrakt fås metadata om bilagorna som sedan kan användas för att hämta själva binären/binärerna.

Diff-funktionalitet

Det finns möjlighet att diffa två versioner av ett kontrakt (endast metadata, inte attachments) via /contracts/{municipalityId}/{contractId}/diff .
Default anges ett municipalityID  och ett contractId varvid de två senaste versionerna diffas (förutsatt att det finns två versioner). I svaret returneras i vilken nod i JSON-strukturen som innehåll ändrats, lagts till eller tagits bort.

Svaret innehåller även vilka tidigare versioner som existerar, det är därför möjligt att ange två versioner som en diff skall utföras på.

Livscykelstatus

Produktion

Lösningsbeskrivning

Hantering av personuppgifter

Personuppgifter till intressenter och parter tillhörande avtalet hanteras. Såsom namn, personnummer, kontaktuppgifter och adress.

API specifikation

Säkerhetsklassning

Säkerhetsklass 1

Autentiseringsmetod:  Oauth2

Teknisk ägare

För tekniska frågor: teamunmasked@sundsvall.se

Källkod

Github

FAQ