Økonomiintegrationer

Fælleskommunale Økonomiintegrationer dækker over de integrationer på den fælleskommunale infrastruktur, der viderestiller økonomidata mellem kommunens fagsystemer og kommunens ERP-system.
Om Integrationer Vejledninger FAQ

Med de Fælleskommunale Økonomiintegrationer råder kommunerne over en række integrationer på den fælleskommunale infrastruktur, som gør det muligt at formidle oplysninger om økonomi mellem et fagsystem og kommunens ERP-system. Oplysninger om økonomi kan fx være bogføringsgrundlag, information vedrørende et økonomisk mellemværende mellem borger og kommune, udbetalinger eller fakturaoplysninger.

Den fælleskommunale infrastrukturs økonomiintegrationer og de indeholdte services udstilles via den den fælleskommunale infrastruktur. I modellen herunder er integrationerne illustrereret med farver for at fremhæve dem fra de øvrige integrationer på infrastrukturen. I boksen til under for "Infrastrukturen" er der zoomet ind på integrationerne.

Integrationer - Økonomiintegrationer

SF1590_A
Økonomi
Afsend økonomipostering
Integrationen giver kommunale fagløsninger mulighed for at levere finansposteringer til kommunens bogføringssystem. En typisk anvendelse er, at fagløsningen har udstedt en ordre på at få foretaget en udbetaling via NemKonto, hvorefter fagløsningen sender finansposteringerne – dvs. bogføringsgrundlaget – for udbetalingen til bogføringssystemet.
Læs mere
SF1590_B
Økonomi
ØiR - Afsend Debitorregistrering til Debitor
Integrationen benyttes til at sende debitorregistreringer fra fagsystemer til kommunens ERP-system. Debitorregistrering er fællesbetegnelse for en række handlinger der udføres på en debitorkonto, med tilhørende fordringer og delfordringer. Integrationen kan alene benyttes af Kommunernes Sygedagpenge System (KSD). For fremtidige anvendere vil denne integration blive afløst af SF1590_B_01, SF1590_B_02 og SF1590_B_03.
Læs mere
SF1590_B_01
Økonomi
Afsend DebitorRegistrering
Integrationen giver kommunale fagløsninger mulighed for at overdrage fordringer (mellemværende mellem borger og kommune) til det af kommunen valgte debitorsystem. Desuden kan debitorsystemet informere fagløsningen tilbage om indbetalinger og afskrivninger af de pågældende fordringer, samt advisere om statusskifte på debitorkonti i debitorsystemet. Integrationen sikrer desuden, at debitorsystemet kan videresende fordringer fra kommunens debitorsystem til Gældstyrelsens inddrivelsesløsning PSRM.
Læs mere
SF1590_B_02
Økonomi
Afsend DebitorForespørgsel
Integrationen giver kommunale fagløsninger mulighed for at fremsøge egne og andres debitorregistreringer i kommunens debitorsystem.
Læs mere
SF1590_B_03
Økonomi
Afsend DebitorIndbetaling
Integrationen giver kommunale fagløsninger mulighed for at foretage indbetalinger på egne og andres fordringer (mellemværende mellem borger og kommune) i det af kommunen valgte debitorsystem. Desuden kan debitorsystemet informere fagløsningen, når der er fordringer, der kan foretages indbetaling på.
Læs mere
SF1590_B_04
Økonomi
Afsend debitorkontoanmodning
Integrationen understøtter, at fagsystemet kan oprette en anmodning om en handling, som involverer en eller flere af fagsystemets debitorkonti i myndighedens debitorsystem. Integrationen anvendes, når fagsystemet har behov for, at opkrævningsfunktionen - her repræsenteret ved debitorsystemet – autoriserer og udfører handlinger på fagsystemets debitorkonti. Handlinger, som opkrævningsfunktionen har ansvar for at udføre.
Læs mere
SF1590_D
Økonomi
Afsend Faktura til Godkendelse
Integrationen giver et fakturahåndteringssystem mulighed for at sende fakturaer til et kommunalt fagsystem til decentral kontrol og håndtering. Et fagsystems behandling af fakturainformation kendes også under termen fakturaudlån.
Læs mere
SF1590_E
Økonomi
Afsend Betalingsanmodning til NemKonto
Integrationen giver kommunale fagløsninger mulighed for at foretage udbetalinger via NemKonto. NemKonto understøtter komplette og ukomplette betalinger, som resulterer i en pengeoverførsel mellem betalers bankkonto og modtagers bankkonto. NemKonto er understøttet i systemet NemKonto System (NKS). Integrationen er tiltænkt de fagløsninger, som ikke ønsker at tilgå NKS direkte, fx hvor fagløsningen har behov for at sende mere end 25.000 betalingsanmodninger pr. år, og samtidig ikke ønsker at etablere en infrastruktur med en MQ Server. Integrationen formidler betalingsanmodninger uændret fra fagsystem til NKS.
Læs mere

FAQ - Økonomiintegrationer

For at kunne kalde webservices i økonomiintegrationerne 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 Eksternt testmiljø er det kun muligt at teste med en specifik gruppe myndigheder: Ballerup, Faxe, Lyngby-Taarbæk og Hjørring.

Serviceaftaler

Når du skal oprette en serviceaftale til en økonomiintegration, skal du være opmærksom på, at du skal inkludere to services: Én som udstilles af Serviceplatformen, og én som udstilles af debitorsystemet/fagsystemet. Du skal igennem disse trin, når du skal oprette serviceaftalen i Fælleskommunalt 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. økonomiservices har kun en rolle.

Læs om oprettelse af de nødvendige serviceaftaler for etablering af webserviceruter i denne pixibog.

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 økonomiintegrationer tilbyder et asynkront forretningssvar. For at anvende disse, skal du oprette en Fælleskommunal Service på dit it-system. Se 'Brugervejledning til Administrationsmodulet 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.

For at anvende en filservice (SFTP) skal du have sat dit it-system op som Anvendersystem og udfylde SSH brugernavn samt SSH nøgle. 

Du kan læse mere om Fælleskommunal Filudveksling , serviceaftaler og ruter her

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 brugergrænseflade 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'.

For at skrive til økonomiintegrationerne, 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 Fælleskommunale Økonomiintegrationer. I videoen herunder kan du se et konkret eksempel på, hvordan du opretter et sortiment til debitorintegrationen.

Der er flere muligheder for, at en fagsystemleverandør kan teste anvendelsen af Fælleskommunale Økonomiintegrationer. KOMBIT stiller en række virtualiseringer til rådighed, som gør det muligt at test generiske flow og response. Virtualiseringerne kan anvendes allerede i udviklingsfasen, men også som en del af en egentlig test. Der er virtualiseringer til både SF1590_A Finans og SF1590_B Debitor.

For at foretage end-to-end test mellem et fagsystem og en ERP-løsning, er det nødvendigt at lave en aftale med en (eller flere) ERP-leverandører. Aftalen er en forudsætning for at benyttes ERP-leverandørernes testmiljø - til test op imod henholdsvis KMD Opus, Prisme (Prisme 2009 og Prisme 2015) eller ØS Indsigt. Derudover anbefaler KOMBIT, at der altid foretages en produktionsverifikation i forbindelse med idriftsættelse i en kommune, dette skal sikre, at mapningen af sortimentet i omsætningstabellen er foretaget.