Gå til hovedindhold
Penge med ikon

Bliv klar til at kode: ØiR

 På denne side kan du læse om:


Forudsætninger for at kunne påbegynde udvikling
 

  1. Du er oprettet som leverandørorganisation og har adgang til Fælleskommunalt Administrationsmodul
  2. Dit it-system er registreret i  Fælleskommunalt Administrationsmodul
  3. Du har anmodet om og fået godkendt de nødvendige serviceaftaler (se herunder)

Integrationer og servicetyper

ØiR har en række snitflader der hver indeholder et antal services. Du kan læse mere om de tilgængelige services for på deres respektive integrationssider som du finder på siden for Økonomi i Rammearkitekturen på Digitaliseringskataloget.

Bemærk: For at skrive til ØiR integrationerne, skal dit IT-system også bruge værdier fra et sortiment, der er oprettet til fagsystemet. Værdierne kan indtastes manuelt eller du kan anvende integrationen SF7002 - Overfør Sortiment. Oprettelsen af Sortimentet skal arrangeres med ØiR. Du kan læse mere om Sortimenter her.

ØiR bruger 3 forskellige typer services:

Webservice

For at kunne kalde webservices i ØiR integrationerne skal der oprettes en serviceaftale med den pågældende myndighed. Der skal oprettes en webservicerute og du skal have de(n) korrekte dokumentation for den enkelte service og certifikater. I Serviceplatformens Eksterne Testmiljø (ExtTest) er det kun muligt at teste med en specifik gruppe myndigheder: Ballerup, Faxe, Lyngby-Taarbæk og Hjørring. Se mere under ”Test”. 

Serviceaftaler
Når du skal oprette en serviceaftale til en ØiR integration, skal du være opmærksom på, at du skal inkludere 2 services: 1 som udstilles af Serviceplatformen og 1 som udstilles af debitorsystemet/fagsystemet. Du skal igennem disse trin, når du skal oprette serviceaftalen i det Fælleskommunale Administrationsmodul:

  • Vælg Serviceaftaletypen: ”Uden videregivelse af data”
  • Vælg følgende services:
    • Den service du skal bruge, som den er udstillet af Serviceplatformen.
    • Dens korresponderende service, som er udstillet af myndighedens Debitorsystem.
  • Vælg en Rolle for hver service. ØiR services har kun 1 rolle.

Ruter
Der skal bestilles en ydelse til oprettelse af rute til webservice. Ruter skal bestilles af Serviceudbyder. Ruter til Debitorsystemer skal dermed bestilles af debitorleverandøren på foranledning af afsendersystem.

Certifikater
For at kunne kalde webservices, skal du skal have installeret følgende certifikater:

Se også: Kom godt i gang med certifikater.

Asynkrone Forretningssvar
Visse ØiR integrationer tilbyder et asynkront forretningssvar. For at anvende disse, skal du oprette en Fælleskommunal Service på dit IT-system. Se 'Brugervejledning til Administrationsmodulerne for leverandører' for detaljer. Bemærk at typen skal være Fælleskommunal Service, at du også skal bestille ydelsen konfiguration af egen Webservice og at du kun bør udstille med Tokensikkerhed. Når du beder debitorleverandøren bestille de ruter, du skal bruge, skal du også gøre dem opmærksom på denne asynkrone rute, og supplere dem med Navn og EntityID på den service du har udstillet.

Dokumentation
Du skal også bruge den relevante dokumentation for den relevante service:

Når alt ovenstående er på plads, kan du begynde at kalde webservices.

Filservice

For at anvende Filservice (SFTP) skal du have sat dit IT-system op som Anvendersystem og udfylde SSH brugernavn samt SSH nøgle. SFTP understøtter ikke serviceaftaler og derfor skal du være opmærksom på, at alle ruter som bestilles også skal underskrives af den konkrete myndighed dit it-system skal agere på vegne af.

Ruter 
Der skal bestilles ydelse til oprettelse af rute til bestilles ydelse til oprettelse af rute mellem afsender- og modtagersystem. Bestillinger af oprettelse af SFTP ruter mellem IT systemer, skal bestilles af serviceanvender.

Du kan læse mere om Filudveksling på Serviceplatformen her

Beskedservice

For at kunne modtage beskeder via Beskedfordeleren, skal du indledningsvis anmode om en serviceaftale til servicen "afhent" indeholdende relevante dataafgrænsninger. Disse afgrænsninger specificerer hvilke beskeder, du må modtage. Når serviceaftalen er godkendt, skal du dernæst via Beskedfordelerens brugerflade opsætte dueslag, abonnement og abonnementsudtryk, hvoraf sidstnævnt beskriver de beskeder, som du ønsker at modtage; dette vil således være en delmængde af de beskeder, som serviceaftalen giver adgang til.

Du kan læse mere om Beskedfordeleren her og eller læse vejledningen 'Kom godt i gang - Fælleskommunal Beskedfordeler'.

Dokumentation og vejledning

På Digitaliseringskatalogets 'Kom godt i gang'-side finder du en række vejledninger til ibrugtagning af forskellige elementer som anvendes i ØiR. Dertil findes der dokumentpakker på de individuelle integrationssider for ØiR, som indeholder al den nødvendige information. Se nedenfor for links til dokumentationspakker. På integrationssiden, kan du også folde de enkelte services ud, og her findes link til serviceplatformens fejlkoder pr service. Se fx 'Fejlkoder for DebitorRegistreringAfsend service i SF1590_B_01'. 

Test

ØiR kan kun testes op imod virtualiseringer eller imod en af følgende kommuner: Lyngby-Taarbæk (Opus), Faxe (Prisme2009), Ballerup (Prisme2015) og Hjørring (ØS Indsigt). For at teste med virtualiseringerne kan trækkes ydelsen Bestilling af hjælp til teknisk afprøvning i Digitaliseringskataloget. Bemærk at der også skal laves aftaler med udbyderen af Debitorsystemer som du skal teste med.