Anmodning om begravelse Beskrivelse af integrationen mellem PERSON og bedemandssystemer version 2.1 til idriftsættelse januar 2020 Dnr 49703 29. maj 2019
Indholdsfortegnelse 1. Indledning 3 2. Den tekniske løsning 4 3. Anmodnings-XML 5 4. Status-XML 5 4.1. Modtaget anmodning 5 4.2. Anmodning der IKKE kan modtages 6 Version 2.1 af 24. maj 2019 - til idriftsættelse jan 2020 - Dnr 49703 2
1. Indledning Folkekirkens It har udviklet snitflader til A) digital indberetning af Anmodning om begravelse eller ligbrænding B) dataudveksling mellem PERSON3.0/CPR-systemet og kirkegårds- og/- eller krematoriesystemer. som stilles til rådighed for relevante parter. Relevante parter omfatter 1. bedemænd 2. it-leverandører af systemer til bedemænd 3. it-leverandører af systemer til kirkegårde og krematorier Folkekirkens It forpligter sig til at videregive modtagne, valide data til begravelsesmyndigheden, samt modtage data som tilbagemeldes fra krematorier og kirkegårde. Snitfladen kan anvendes fra systemer, som er certificeret af Folkekirkens It. Ved certificeringen skal dataleverandøren demonstrere, at hans system kan aflevere valide data i henhold til den af Folkekirkens It fastsatte snitflade og fortegnelse over obligatoriske informationer. Forud for certificering af et system skal indgås en aftale om brug af digital indberetning af Anmodning om begravelse eller ligbrænding via et bedemandssystem 1 Teknisk set overføres data fra Anmodning om begravelse eller ligbrænding i det XML-format, som fremgår af snitfladebeskrivelsen. Denne foreløbige beskrivelse af integrationen mellem PERSON og bedemandssystemer skal anvendes fra november 2019, hvor Folkekirkens It idriftsætter en ny digital løsning til anmodning om begravelse i Person 3.0. Den nye løsning erstatter KMD XForm med en simpel filoverførsel af XML-filer, ved hjælp af SFTP. Dette dokument beskriver integrationen, herunder XML-skemaerne til kommunikationen. Dokumentet er foreløbigt og XML-skemaerne vil i den kommende tid blive suppleret og udvidet med f.eks.: - Længderestriktioner, minoccurs og maxoccurs. - XML-Status xsd. - Justeringer ifm. yderligere funktionalitet f.eks.: - Lande skal med i begravelsessted - Askespredning - Askedeling 1 Ved et bedemandssystem forstås i denne sammenhæng et it-system, som en bedemandsvirksomhed anvender til udfyldelse af Anmodning om begravelse eller ligbrænding, og som i henhold til lov om obligatorisk digital selvbetjening samt bekendtgørelse af lov om begravelse og ligbrænding skal indgives til begravelsesmyndigheden. Version 2.1 af 24. maj 2019 - til idriftsættelse jan 2020 - Dnr 49703 3
2. Den tekniske løsning Det tekniske grundlag for integrationen består af en række XML-filer, som bedemandssystemet henholdsvis kan anbringe på og hente fra en SFTP-server hos DXC. Figur 1 - Den nye integration Bedemanden afsender en anmodning til Person3. Når anmodningen er modtaget, vil Person 3 danne en status fil, som efterfølgende kan hentes på SFTP-serven. XML-anmodningen skal indeholde en signatur af data i form af et XMLDsig envoloping signatur-element. I forhold til XForm-løsningen er det altså nu selv bedemandssystemet der skal generere og vedlægge signaturen. Version 2.1 af 24. maj 2019 - til idriftsættelse jan 2020 - Dnr 49703 4
3. Anmodnings-XML begravelsesanmodningens XSD-fil downloades fra samme placering som dette dokument med dette filnavn: 4. Status-XML Beskrivelse af integration_49703_v2.1.xsd Status-XML filen er den samme der allerede benyttes i dag i integrationen mellem bedemandssystemer og Person 3.0. Status XML filen bliver placeret i ud-mappen på SFTP-serveren når en anmodning er modtaget og afgjort. Status-XML filen navngives således: Refnr-BedemandsSystemId-BedemandsSystem-Sagsnummer-status.xml 4.1. Modtaget anmodning Eksempel på modtaget anmodning: <?xml version='1.0' encoding='iso-8859-1' standalone='yes'?> <Status> <personsag> <Referencenr>36121349</Referencenr> <BedemandsSystemId>BR</BedemandsSystemId> <BedemandsId>074</BedemandsId> <BedemandsSystemSagsnummer>39221</BedemandsSystemSagsnummer> <Modtaget>25-04-2019</Modtaget> <Godkendt /> <Afvist /> <BraendingsDato /> <BraendingsNummerModtaget /> <Braendingsnummer /> <Jordfaestelses_Urnenedsaettelses_Dato /> <FaktiskKirkegaardModtaget /> <FaktiskKirkegaard /> <FaktiskKrematorieModtaget /> <FaktiskKrematorie /> <UrnenMaaUdleveresTil>Jørgen Olsen Begravelsesforretning ApS</UrnenMaaUdleveresTil> </personsag> </Status> Version 2.1 af 24. maj 2019 - til idriftsættelse jan 2020 - Dnr 49703 5
4.2. Anmodning der IKKE kan modtages Hvis anmodningen ikke kan modtages, vil svaret IKKE indeholde Modtaget -dato og i stedet vil der være to nye felter, Fejlkode og Fejltekst. Disse vil beskrive hvad gik galt i modtagelsen. Herunder ses et forslag til statusfilen, hvor anmodning IKKE kan modtages: <?xml version='1.0' encoding='iso-8859-1' standalone='yes'?> <Status> <personsag> <Referencenr>B1122445</Referencenr> <BedemandsSystemId>BR</BedemandsSystemId> <BedemandsId>074</BedemandsId> <BedemandsSystemSagsnummer>39221</BedemandsSystemSagsnummer> <Modtaget /> <Godkendt /> <Afvist /> <BraendingsDato /> <BraendingsNummerModtaget /> <Braendingsnummer /> <Jordfaestelses_Urnenedsaettelses_Dato /> <FaktiskKirkegaardModtaget /> <FaktiskKirkegaard /> <FaktiskKrematorieModtaget /> <FaktiskKrematorie /> <UrnenMaaUdleveresTil /> <Fejlkode>VALIDERINGSFEJL</Fejlkode> <Fejltekst>XML kunne ikke valideres: afdoedescprnummer required...</fejltekst> </personsag> </Status> Version 2.1 af 24. maj 2019 - til idriftsættelse jan 2020 - Dnr 49703 6