KnowledgeCube ApS Kronprinsessegade 42, 1 DK 1306 København K T +45 33 98 46 00 F +45 33 14 46 00 CVR-nr.: 28 51 04 89 www.knowledgecube.net ARBEJDSMARKEDSSTYRELSEN WEB SERVICE SUPPORT DOKUMENTATION AF PERSONDATASERVICE VERSION 1.1 DATO REFERENCE KC1002-GNR-001 Forfatter: Christian Krog Madsen / Ulrik Bærholm Kontraktnummer: 2003 / S-2003821 Side 1/6
DOKUMENTVERSIONER Version Dato Afsnit Ændringer 1.0 17. august 2005 Første version. 1.1 19. december 2005 1, 2 Beskrivelsen udvidet. Side 2/6
INDHOLDSFORTEGNELSE 1 INTRODUKTION 4 1.1 Resume 4 2 SERVICE DOKUMENTATION 4 2.1 Typedefinitioner 4 Side 3/6
1 Introduktion 1.1 Resume Dette dokument beskriver kort web servicen PersonDataService, der er udviklet som et tillæg til DRV webservices. PersonDataService gør det muligt at udtrække stamdata for en dagpenge- eller kontakthjælpssag via webservices. 2 Service dokumentation Web servicen hedder PersonDataService og er tilgængelig via URLen: http://amportal.bm.dk/ampservices/1/persondataservice.asmx Web servicen understøtter en enkelt operation, kaldet GetPersonData, som kaldes via SOAP med en header af typen OcesCertHeaderInput, og en body af typen PersonCivilRegistrationIdentifier. Returtypen er PersonDataStructure. WSDL filen for PersonDataService er tilgængelig via URLen: http://amportal.bm.dk/ampservices/1/persondataservice.asmx?wsdl Der henvises til Arbejdsmarkedsstyrelsens hjemmeside for mere information om de øvrige DRV webservices samt håndteringen af WS Security i kaldene til PersonDataService. Webadressen er: http://www.ams.dk/visitationsprojekt/it_understoettelse/webservices_drv.asp 2.1 Typedefinitioner Nedenfor angives korte beskrivelser af elementerne i WSDL filen til PersonDataService. Elementer, som ikke er forklaret nedenfor, findes i Infostrukturbasen (http://isb.oio.dk/) eksakte URLer til Infostrukturbasen findes som namespaces i WSDL filen for de enkelte elementer. Type OcesCertHeaderInput PersonCivilRegistrationIdentifier PersonDataStructure Beskrivelse Base64 kodet OCES certifikat CPR-nummer, 10 cifret nummer af formen: DDMMYYXXXX, hvor DD er dato, MM er månedsnummer, YY er årstal (2 cifre) og XXXX er et løbenummer. Tallet 0000000000 er lovligt og angiver ukendt CPR-nummer. Sekvens bestående af: PersonNameStructure valgfri TelephoneNumberIdentifier valgfri MobileNumberIdentifier valgfri PersonCivilRegistrationIdentifier MaritalStatusCode valgfri Municipality valgfri UnemploymentRegion valgfri UnemploymentFund valgfri UnemploymentInsuranceCategory valgfri UnemploymentClientCategory valgfri Side 4/6
PersonOriginCode valgfri PersonNameStructure Det fulde navn på en person. Består af: PersonGivenName PersonMiddleName valgfri PersonSurnameName PersonGivenName Persons fornavn, streng med 1-50 tegn PersonMiddleName Persons mellemnavn, streng med 1-40 tegn PersonSurnameName Persons efternavn, streng med 1-40 tegn TelephoneNumberIdentifier Telefonnummer, evt. inkl. internationalt præfiks. Mellem 3 og 20 cifre, evt. med plus (+) tegn foran. MobileNumberIdentfier Mobiltelefonnummer, samme format som TelephoneNumberIdentifier. MaritalStatusCode Angiver ægteskabelig status. En af følgende strenge: married gift single enlig divorced skilt widow enke registered partnership i registreret partnerskab abolition of registered partnership opløst registreret partnerskab longest living partner længst levende i registreret partnerskab deceased afdød unmarried samlevende Municipality Beskrivelse af kommune, består af: MunicipalityCode MunicipalityName MunicipalityCode Firecifret myndighedskode fra CPR registeret. MunicipalityName Navn på kommune, streng med 1-20 tegn. UnemploymentRegion AF-region, består af: UnemploymentRegionIdentifier UnemploymentRegionName UnemploymentOffice UnemploymentRegionIdentifier AF-regionskode, består af 6-cifret tal. UnemploymentRegionName Navn på AF-region, streng på 1-50 tegn UnemploymentOffice AF-kontor, består af: UnemploymentOfficeIdentifier UnemploymentOfficeName UnemploymentOfficeIdentifier AF-kontorkode, består af 6-cifret tal. UnemploymentOfficeName Navn på AF-kontor, streng med 1-50 tegn. UnemploymentFund A-kasse, består af: UnemploymentFundIdentifier UnemploymentFundName UnemploymentFundIdentifier A-kasse nummer, består af 6-cifret tal. UnemploymentFundName Navn på A-kasse, streng på 1-50 tegn. UnemploymentInsuranceCategory Forsikringskategori, en af følgende strenge: heltidsforsikret Side 5/6
deltidsforsikret ikke-forsikret forsikrede iøvrigt UnemploymentClientCategory PersonOriginCode Forsikrede er - såvel beskæftigde som ledige - der er optaget som medlem af en anerkendt A-kasse. Der er forskellige forsikringskategorier, som har betydning for understøttelsesniveauer under ledighed. Heltidsforsikrede er medlemmer med en ugentlig arbejstid på 37 timer. Deltidsforsikrede har en mindre arbejstid. Det er A-kassen som ejer disse oplysninger, som portalen får fra det centrale ledighedsregister CRAM. Klientkategori, en af følgende strenge: dagpengemodtager kontanthjælpsmodtager Opdeling på dagpengemodtager og kontanthjælpsmodtager er en opdeling, der findes i AMANDA for ledige, der er tilmeldt AF. Dagpengemodtager er - og er kun - forsikrede ledige med ret til understøttelse - både heltids- og deltidsforsikrede. Kontanthjælpsmodtagere er den arbejsmarkedsparate del af disse modtagere. De pågældende kan være forsikret i en A-kasse, men har ikke ret til arbejdsløshedsunderstøttelse. Personens afstamning. En af følgende: Personer med dansk oprindelse Indvandrere fra vestlige lande Efterkommere fra vestlige lande Indvandrere fra ikke-vestlige lande Efterkommere fra ikke-vestlige lande Side 6/6