KMD-ØS Snitfladebeskrivelse for posteringer fra KMD s modersystemer til lokal anvendelse Version 8 15.05.2007 KMD 2002. Alle rettigheder forbeholdes. Dette materiale er ophavsretligt beskyttet og må ikke kopieres i videre omfang end forudsat i ophavsretsloven.
Indholdsfortegnelse 0 Ændringer i forhold til forrige version... 3 1 Brug af snitfladebeskrivelsen... 4 2 Formål og målgrupper... 4 2.1 Hvad er formålet med standardsnitfladen?... 4 2.2 Hvem er målgrupperne?... 4 3 Standardsnitfladens arkitektur... 5 3.1 Systemskitse Verbal beskrivelse... 6 4 Teknisk implementering... 6 5 Betingelser for anvendelse af standardsnitfladen... 6 6 Garantier... 6 7 Protokol for dataudveksling... 6 7.1 Hvordan opbygges datastrømmen... 6 7.2 Datastruktur... 6 7.2.1 Opbygning og indhold af posteringsindivid... 7 7.2.2 Posteringsindivid (G69)... 8 8 Validering af data... 9 8.1 Hvilke krav stilles der til validiteten af data?... 9 8.2 Databeskrivelser... 9 8.3 Hvordan håndteres fejl?... 15 Bilag 1: Omfang af udtræk/overførsel af automatposteringer fra div. modersyst.... 16 Version 8 Side 2 af 16
0 Ændringer i forhold til forrige version Indlagt mulighed for anvendelse af 2 nye nummertyper: CVR-nummer P-nummer (produktionsenhedsnummer) Ændringen træder i kraft fra og med d. 03.09.2007. Desuden ny organisationstype til regioner. Desuden er KMD s adresse ændret. Version 8 Side 3 af 16
1 Brug af snitfladebeskrivelsen Denne snitfladebeskrivelse danner grundlag for udtræk/overførsel af posteringer fra KMD s modersystemer til kommuner/amter, som ikke anvender KMD s økonomisystem (KMD-ØS), og som derfor ønsker at hjemtage posteringer med henblik på ajourføring af eget økonomisystem. Grundlag for indgåelse af aftaler. Beskrivelsen må bruges internt af KMD og af brugere, som har indgået aftale om brug heraf. Snitfladen må ikke overdrages eller kopieres videre. Henvendelser vedrørende standardsnitfladen (generelt) rettes til: Udlån til andre leverandører. Kontakt til KMD. KMD Aalborg Serviceafdelingen Økonomi Lauritzens Plads 1 9000 Aalborg Er der derimod tale om spørgsmål vedr. posteringer fra et specifikt modersystem, rettes henvendelse til dette modersystem. 2 Formål og målgrupper 2.1 Hvad er formålet med standardsnitfladen? Formålet med snitfladen er at give brugeren mulighed for at modtage posteringer dannet af div. KMD modersystemer. Snitfladebeskrivelsen indeholder oplysninger om indhold og opbygning af de økonomitransaktioner, som KMD stiller til rådighed for kommuner / amter med eget anlæg. 2.2 Hvem er målgrupperne? Beskrivelsen henvender sig til interessenter, der ikke anvender KMD-ØS, det vil sige brugere af div. KMD-modersystemer, som ikke anvender KMD s Økonomisystem (KMD-ØS). Version 8 Side 4 af 16
3 Standardsnitfladens arkitektur Div. modersystemer Generel Div. modersystemer datafangst Udtræk og konv. af postering GQ31100L TR69 Kommunen Posteringer Kommunens edb-anlæg Version 8 Side 5 af 16
3.1 Systemskitse Verbal beskrivelse Systemdiagrammet 3. snitfladens arkitektur illustrerer KMD s behandling af økonomitransaktioner med henblik på at stille disse til rådighed for brugere til behandling på eget anlæg. 1. Posteringer fra KMD s modersystemer til lokal anvendelse Overførsel via denne snitflade sker kun for modersystemer, som leverer data på KMD-ØS-format. Posteringer fra div. modersystemer indspilles i KMD s datafangstsystem, hvorfra de efterfølgende udtrækkes og forsendes til brugernes anlæg, som en samlet fil pr. udtræksdato. Forsendelse sker på første produktionsdato, når systemet konstaterer at der er posteringer til brugeren (se 5.). Hvilke modersystemer, som skal aflevere / overføre posteringer, aftales i hvert enkelt tilfælde mellem bruger og pågældende modersystem. Det fremgår af Bilag 1, hvilke modersystemer brugeren p.t. har aftale med, om at få leveret posteringer. Automatposteringer leveres på følgende struktur: Posteringsindivid (TR69) 4 Teknisk implementering Teknisk implementering af snitfladen hos kunden er KMD uvedkommende. 5 Betingelser for anvendelse af standardsnitfladen Forud for opstart af Udtræk/overførsel af posteringer fra modersystemer til lokal anvendelse skal der i god tid mellem bruger og KMD: indgås aftale om overførsel indgås aftale om, hvorvidt udtrukne posteringer kun skal anvendes lokalt, eller om der også skal foretages opdatering i KMD-ØS. aftales/etableres forbindelse til den fysiske filforsendelse af posteringer til brugeren - min. 14 dages varsel 6 Garantier Ændringsvarsel i forbindelse med datastrukturer er 3 måneder. 7 Protokol for dataudveksling 7.1 Hvordan opbygges datastrømmen Flg. datastrukturer indgår i denne snitfladebeskrivelse: Posteringsindivid (TR69) 7.2 Datastruktur Posteringer leveret i henhold til denne snitflade afleveres altid med fast recordopbygning. Version 8 Side 6 af 16
7.2.1 Opbygning og indhold af posteringsindivid Krydsskema, som beskriver indholdet af en postering med angivelse af afhængigheder mellem de enkelte felter: Feltindhold Feltnr. 001 NOR Individtype (69) Administrativ organisation Organisationstype Posteringstype x x x x Kaldenavn-kort 101 O Posteringsafstemningsenhed 102 X Posteringsregistreringssted 103 X Ekspeditionsnummer 104 X Posteringsdato 110 X Registreringskontonummer 111 X Posteringsbeløb 112 X Debet-/kreditmarkering 113 X Regnskabsår 114 O Momsberegningsdato 115 O Bilagsarkivnr. 116 O Udbetalingshenvisningsnr. 117 O Valørdato 118 O Betalingsmodtager nummerkode 130 <131> Betalingsmodtagernr. 131 <130> Ydelsesmodtager nummerkode 132 <133> Ydelsesmodtagernr. 133 <132> Oplysningspligtreg. Nummerkode 134 <135> Oplysningspligtreg.nr. 135 <134> Oplysningspligtkode 136 <134> Posteringsudtrækstekst-1 150 O Posteringsudtrækstekst-2 151 O Posteringsudtrækskode 152 O Posteringstekst 153 O Rekvisitionsnummer 170 O Delleverance 171 <170> Symbolforklaring: x = Krævede felter. o = Valgfrie felter. <> = Feltet afhænger af andet felt (feltnr. er anført). = Feltet må ikke anvendes. Version 8 Side 7 af 16
7.2.2 Posteringsindivid (G69) POSTERINGER (posteringstype 001/NOR) dannet af det enkelte modersystem. Individ/Formularbetegnelse Udtræk fra modersystemer Struktur/Formularnavn GQ31125N Nr/ pos Program- Datanavn Antal Antal Antal Repr. Beskrivelse POSTERINGSINDIVID, KMD-ØS 1 CINDTYP 2 CH INDIVIDTYPE 69 3 BRUGER 4 CH BRUGERNUMMER 7 ORGANISATI 2 CH ORGANISATIONSTYPE 9 POSTERING_ 3 CH POSTERINGSTYPE 12 KALDENAVN 10 CH KALDENAVN KORT (LOS) 22 AFSTEM_ENH 5 CH AFSTEMNINGSENHED 27 REG_STED_N 5 CH REGISTRERINGSSTED 32 POST_EKSP_ 7 CH EKSPEDITIONSNUMMER 39 POST_DATO 8 CH POSTERINGSDATO 04-01-00 47 REG_KONTO_ 10 CH REGISTRERINGSKONTONR. 57 POST_BELØB 12 CH POSTERINGSBELØB 69 SIGN 1 CH FORTEGN 70 CDEBKRE 1 CH DEBET/KREDIT MARK 71 REGNÅR 4 CH REGNSKABSÅR 75 MOMS_DATO 8 CH MOMSBEREGNINGSDATO 83 BILAG_ARKI 10 CH BILAGSARKIVNR. 93 UDB_HENV_N 20 CH UDBETALINGSHENVISNINGSNR. 113 VALØR_DATO 8 CH VALØRDATO 121 BETAL_MODT 2 CH NR.KODE BETALINGSMODT 123 BETAL_MODT 14 CH BETALINGSMODTAGERNR. 137 YDEL_MODT_ 2 CH NR.KODE YDELSESMODTAG. 139 YDEL_MODT_ 14 CH YDELSESMODTAGERNR. 153 OPLYS_MODT 2 CH NR.KODE OPLYSNINGSPLIG 155 OPLYST_MOD 14 CH OPLYSNINGSPLIGT REGNR. 169 OPLYS_TYPE 1 CH OPLYSNINGSPLIGT KODE 170 UDTRÆK_TEK 5 CH POSTERINGSUDTRÆK.TEKST1 175 UDTRÆK_TEK 5 CH POSTERINGSUDTRÆK.TEKST2 180 UDTRÆK_KOD 5 CH POSTERINGSUDTRÆKSKODE 185 POSTERING_ 35 CH POSTERINGSTEKST 220 REKVISITIO 10 CH REKVISITIONSNR. 230 DEL_LEVERA 1 CH KODE FOR DELLEVERANCE STRUKTURENS LÆNGDE: 230 Version 8 Side 8 af 16
8 Validering af data 8.1 Hvilke krav stilles der til validiteten af data? De posteringer, som videresendes i henhold til denne snitflade gennemgår ikke nogen form for validering inden de videresendes til den enkelte kommune / region, hvorfor evt. fejl i data må henføres til afsendende KMD modersystem. 8.2 Databeskrivelser Administrativ Organisation: Identifikation af brugeren (kommunenr., amtsnr. m.v.) 1-9999. Organisationstype: Kode, som angiver typen af den administrative organisation. 01: Primærkommune 02: Amtskommune 03: Selvejende institution 04: Anden kommunal organisation 06: Anden amtskommunal virksomhed. 19: Regioner Posteringstype: Felt, som angiver posteringstype for transaktionen. 001/NOR Kaldenavn-kort: Identifikation af administrativ enhed vedr. posteringer via enhedens korte kaldenavn i LOS. 10 positioner - Alfanumerisk. Posteringsafstemningsenhed: Identifikation af afstemningsenhed. Skal udfyldes med en værdi, som findes i KMD-ØS postering på den enkelte kommune. Skal anføres med store bogstaver. 5 positioner - alfanumerisk Posteringsregistreringssted: Angiver oprindelsessted for en postering. 1-99999. Ekspeditionsnummer: Fortløbende nummerering af posteringer indenfor et registreringssted. 1-9999999. Posteringsdato: Version 8 Side 9 af 16
Angiver den dato, hvor en postering skal påvirke regnskabet. Å Å Å Å M M D D dag måned år, inkl. århundrede Registreringskontonummer: Angiver det registreringskontonr., hvorpå posteringen skal konteres. 8 første cifre: 1-99999999. 2 sidste cifre: Edb- og checkcifre i henhold til modulus 11. (00-09 eller 50). Posteringsbeløb: Beløbet som den enkelte postering omfatter, angivet i ører. 999999999999- til 999999999999+. 12 cifre og fortegn (højrestillet). Fortegn = blank: positivt beløb. Fortegn = - negativt beløb. Debet-kreditmarkering: Markering for, om en postering er en udgift (debet) eller en indtægt (kredit). D = Debet K = Kredit Regnskabsår: Feltet angiver det regnskabsår, hvortil posteringen hører. Århundrede, årti og år. Momsberegningsdato: Momsberegningsdato henviser til den momsprocent, ud fra hvilken momsberegningen skal foretages. Å Å Å Å M M D D Dag Måned år, inkl. århundrede Bilagsarkivnr: Angiver hvilket nummer bilaget til en given postering er arkiveret under. 0-9999999999. Udbetalingshenvisningsnr.: Version 8 Side 10 af 16
Dette nummer knytter forbindelsen mellem én/flere posteringer til én/flere udbetalinger. Feltet opbygges af: - Post.dato (8 cifre) - Registreringssted (5 cifre) - Eksp.nr. (7 cifre) Valørdato: Angiver datoen for frigørelse fra en betalingspligt. Å Å Å Å M M D D Dag Måned år, inkl. århundrede Betalingsmodtager nummerkode: Angiver hvilket nummersystem der er brugt ved indberetning af betalingsmodtager. 01 = Frit valgt nummer. 02 = Personnummer. 03 = SE-nummer. 04 = Gironummer. 05 = Telefonnummer. 06 = PBS-nummer. 07 = PI-kontonummer. 08 = FI-nr. 10 = Myndighedsnummer 11 = CVR-nummer 12 = P-nummer (produktionsenhed) Betalingsmodtagernr: Identifikation af udbetalingsmodtageren. Valideringsregler: Max 14 cifre, bestemmes af betalingsmodtager nummerkode. Alle: Numerisk kontrol. 01: 1-9 cifre (uden checkcifferkontrol). 10 cifre (med checkcifferkontrol). 02: IM's regler for CPR-nr. 03: T og S's regler for SE-nr. 04: Girobanks regler for Gironr. 05: 8 cifre. 10 cifre (incl. checkciffer). 06: PBS's regler for PBS-nr. 07: 14 cifre. De første 4 cifre (bankreg.nr) må ikke Version 8 Side 11 af 16
være = 0000 De sidste 10 cifre (bankkontonr.) må ikke være = 0000000000 08: 8 cifre. 70000000-99999999 (incl. modulus-11-kontrol) 10: 0001-4999, 6000-9499 11: 8 cifre med modulus-11 kontrol 12: 10 cifre med et særligt moduluscheck Særligt modulus-check af P-nummer (nr.-kode værdi 12): Ved en fejl blev der i kodningen af nummergeneratoren for produktionsenheder anvendt forkerte vægte i forhold til de vægte, der indgår i modulus 11. Den forkerte nummergenerator blev anvendt til at danne serien af P-numre til de konverterede produktionsenheder i forbindelse med CVR's idriftsættelse. De anvendte forkerte vægte i konverteringen er 1 5 6 7 3 6 4 8 9 Mens de rigtige vægte i modulus 11 er 4 3 2 7 6 5 4 3 2 Den serie af P-numre, der tildeles driftmæssigt i CVR efter konverteringen, er dannet på baggrund af de rigtige vægte. Højeste P-nummer dannet med de forkerte vægte er: 1.006.959.421. Højere P-numre er dannet med den rette vægt. Ydelsesmodtager nummerkode: Angiver hvilket nummersystem der er brugt ved indberetning af ydelsesmodtager. 02 = Personnummer 03 = SE-nummer 11 = CVR-nummer 12 = P-nummer (produktionsenhed) Ydelsesmodtagernr. Identifikation af ydelsesmodtageren. Valideringsregler: Max 14 cifre, bestemmes af ydelsesmodtagernummerkode. Alle: Numerisk kontrol. 02: IM's regler for CPR-nr. 03: T og S's regler for SE-nr. 11: 8 cifre med modulus-11 kontrol 12: 10 cifre med et særligt moduluscheck Version 8 Side 12 af 16
Særligt modulus-check af P-nummer (nr.-kode værdi 12): Ved en fejl blev der i kodningen af nummergeneratoren for produktionsenheder anvendt forkerte vægte i forhold til de vægte, der indgår i modulus 11. Den forkerte nummergenerator blev anvendt til at danne serien af P-numre til de konverterede produktionsenheder i forbindelse med CVR's idriftsættelse. De anvendte forkerte vægte i konverteringen er 1 5 6 7 3 6 4 8 9 Mens de rigtige vægte i modulus 11 er 4 3 2 7 6 5 4 3 2 Den serie af P-numre, der tildeles driftmæssigt i CVR efter konverteringen, er dannet på baggrund af de rigtige vægte. Højeste P-nummer dannet med de forkerte vægte er: 1.006.959.421. Højere P-numre er dannet med den rette vægt. Oplysningspligtregistrant nummerkode: Angiver hvilket nummersystem der er brugt ved indberetning af oplysningspligtregistrant. 01 = Frit valgt nummer. 02 = Personnummer. 03 = SE-nummer. 04 = Gironummer. 05 = Telefonnummer. 06 = PBS-nummer. 07 = PI-kontonummer. 08 = FI-nr. 10 = Myndighedsnummer 11 = CVR-nummer 12 = P-nummer (produktionsenhed) Oplysningspligtregistrantnr.: Identifikation af den person/virksomhed, til hvilken der er knyttet oplysningspligt overfor Told- og skattestyrelsen eller Danmarks Statistik. Valideringsregler: max 14 cifre, bestemmes oplysningspligtregistrant nummerkode. Alle: Numerisk kontrol. 01: 1-9 cifre (uden checkcifferkontrol). 10 cifre (med checkcifferkontrol). 02: IM's regler for CPR-nr. 03: T og S's regler for SE-nr. 04: Girobanks regler for Gironr. 05: 8 cifre. Version 8 Side 13 af 16
10 cifre (incl. checkciffer). 06: PBS's regler for PBS-nr. 07: 14 cifre. De første 4 cifre (bankreg.nr) må ikke være = 0000 De sidste 10 cifre (bankkontonr.) må ikke være = 0000000000 08: 8 cifre. 70000000-99999999 (incl. modulus-11-kontrol) 10: 0001-4999, 6000-9499 11: 8 cifre med modulus-11 kontrol 12: 10 cifre med et særligt moduluscheck Særligt modulus-check af P-nummer (nr.-kode værdi 12): Ved en fejl blev der i kodningen af nummergeneratoren for produktionsenheder anvendt forkerte vægte i forhold til de vægte, der indgår i modulus 11. Den forkerte nummergenerator blev anvendt til at danne serien af P-numre til de konverterede produktionsenheder i forbindelse med CVR's idriftsættelse. De anvendte forkerte vægte i konverteringen er 1 5 6 7 3 6 4 8 9 Mens de rigtige vægte i modulus 11 er 4 3 2 7 6 5 4 3 2 Den serie af P-numre, der tildeles driftmæssigt i CVR efter konverteringen, er dannet på baggrund af de rigtige vægte. Højeste P-nummer dannet med de forkerte vægte er: 1.006.959.421. Højere P-numre er dannet med den rette vægt. Oplysningspligtkode: Angiver hvilken type af oplysningspligt, der er knyttet til den udbetaling, posteringen repræsenterer. H = Honorar og vederlag - hvoraf AMB skal beregnes U = Honorar og vederlag - hvoraf der ikke skal beregnes AMB F = Befordringsgodtgørelse. Posteringsudtrækstekst-1: Valgfri tekst som knyttes til den enkelte postering, og som kan anvendes som udtrækskriterie ved udtræk og forespørgsel. Fri tekst. Posteringsudtrækstekst-2: Valgfri tekst som knyttes til den enkelte postering, og som kan anvendes som udtrækskriterie ved udtræk og forespørgsel. Version 8 Side 14 af 16
Fri tekst. Posteringsudtrækskode: Valgfri kode, som knyttes til den enkelte postering, og som kan anvendes som udtrækskriterie ved udtræk og forespørgsler. PS. Koden kaldes også Projektkode Fri tekst. Posteringstekst: Valgfri tekst som knyttes til den enkelte postering. Fri tekst. Rekvisitionsnummer: Et af brugeren defineret nummer, der medfører overførsel af posteringsoplysninger til dispositionsbogholderiet. 0-9999999999. Delleverance: Kode der angiver, om beløbet i den tilsvarende disposition i dispositionsbogholderiet skal nedskrives eller afsluttes. Kan kun/skal anvendes, når rekvisitionsnummer er udfyldt. N = Afslutning. J = Delleverance. 8.3 Hvordan håndteres fejl? Såfremt der hos kommunen/amtet opstår problemer vedr. indholdet af de modtagne posteringer, da rettes henvendelse til relevante modersystem. Version 8 Side 15 af 16
Bilag 1: Omfang af udtræk/overførsel af automatposteringer fra div. modersyst. Version 8 Side 16 af 16