AUB - Indberet skoleophold(al8) Indholdsfortegnelse Indholdsfortegnelse 1 Brug snitfladebeskrivelsen... 2 2 Formål og beskrivelse... 2 2.1 Hvad er formålet med snitfladen?... 2 2.2 Beskrivelse snitfladen... 2 3 Snitfladens arkitektur... 3 3.1 Tekniske klaringer... 3 3.2 Tekniske betingelser for anvendelse snitfladen... 3 4 Protokol for dataudveksling... 3 4.1 Opbygning... 3 4.2 Datastruktur... 3 4.3 Datormat... 5 5 Validering data... 7 5.1 Validering ved modtagelse... 7 5.2 Fejlhåndtering... 9 6 Sikkerhed... 9 6.1 Service Level Agreements... 9
Brug snitfladebeskrivelsen 1 Brug snitfladebeskrivelsen Denne snitfladebeskrivelse udgør grundlaget for indgåelse konkrete taler med AUBs samarbejdsparter om udveksling data vedrørende elevers kost og logi ophold. Den er et praktisk arbejdsredskab til støtte for kommunikationen mellem samarbejdsparterne og AUB om snitfladens anvendelse. Beskrivelsen må ikke overdrages eller kopieres i videre omfang end forudsat i ophavsretsloven men kun udlånes til softwareleverandører i forbindelse med etablering snitfladen samt ved fremtidige ændringer. 2 Formål og beskrivelse 2.1 Hvad er formålet med snitfladen? Formålet med snitfladen er at modtage data vedrørende elevers kost og logiophold fra de erhvervsskoler, hvor eleverne bor i deres skoleperioder så de pågældende arbejdsgivere kan få refunderet de udgifter, der er forbundet hermed. De oplysninger, som ønskes, er beskrevet i denne snitfladebeskrivelse. 2.2 Beskrivelse snitfladen Når data modtages i servicekaldet, bliver disse valideret. Der sker først en rent teknisk validering, om alle krævede felter findes og har det rette format. Hvis data fejlmeldes her, returneres data med en fejltekst til sender, og der registreres ikke noget i AUB. Hvis formatvalideringen passeres, går data videre til en rent forretningsmæssig validering. Sker der fejl her, er billedet det samme; systemet returnerer data til sender med en fejlmelding. Som beskrevet i layoutet kan der her modtages to typer fejl; en type som siger at data er vist og skal sendes igen. Og en anden type, som siger at data er modtaget og registreret, skønt der er opdaget nogle problemer i data som må behandles. De forskellige valideringer, samt deres fejlmeldinger kan ses i snitet Validering data. 11-01-2016 Side 2
Snitfladens arkitektur 3 Snitfladens arkitektur 3.1 Tekniske klaringer AUB udstiller en Webservice med navnet Indberetkostoglogitilaub, som kaldes med en XML-strøm, der skal overholde XSD en Indberetkostoglogitilaub.xsd (vedlagt dette dokument). XSD er udleveres elektronisk ved henvendelse til ATP 3.2 Tekniske betingelser for anvendelse snitfladen I forbindelse med udlevering snitfladebeskrivelsen skal der indgås endelig tale om forsendelsesmetoden. Ønskes den endelige tale ændret dataleverandøren, skal dette meddeles AUB skriftligt. Ved ændret tale fremsendes ikke revideret snitfladebeskrivelse. Det er dataleverandørens/snitfladeabonnentens ansvar at transaktionerne er sendt til AUB i overensstemmelse med denne snitfladebeskrivelse. 4 Protokol for dataudveksling 4.1 Opbygning Her henvises til selve XSD en 4.2 Datastruktur Definition XSD Indberetkostoglogitilaub: <?xml version="1.0" encoding="utf-8" standalone="no"?> - <xsd:schema xmlns:xsd="http://www.w3.org/2001/xmlschema" xmlns:cpr="http://rep.atp.dk/common/type/cpr/v1/" xmlns:gen="http://iet.atp.dk/2006/generator/" xmlns:id32="http://rep.atp.dk/common/type/id32/v1/" 11-01-2016 Side 3
Protokol for dataudveksling xmlns:qlm="http://iet.atp.dk/2006/qlminformation/" xmlns:se="http://rep.atp.dk/common/type/se/v1/" xmlns:sik="http://rep.atp.dk/sik/indberetkostoglogitilaub/v2/" xmlns:str="http://rep.atp.dk/common/type/str/v1/" xmlns:timestamp="http://rep.atp.dk/common/type/timestamp/v1/" elementformdefault="qualified" targetnamespace="http://rep.atp.dk/sik/indberetkostoglogitilaub/v2/" xml:lang="en"> - <xsd:annotation> - <xsd:appinfo> <gen:toolversion>1.1</gen:toolversion> </xsd:appinfo> - <xsd:documentation> <qlm:qlmversion>0</qlm:qlmversion> <qlm:qlmrepository>abp</qlm:qlmrepository> <qlm:qlmconfiguration>development</qlm:qlmconfiguration> </xsd:documentation> </xsd:annotation> <xsd:include schemalocation="http://rep.atp.dk/sik/indberetkostoglogitilaub/v2/creation.xsd" <xsd:include schemalocation="http://rep.atp.dk/sik/indberetkostoglogitilaub/v2/aer.xsd" <xsd:import namespace="http://rep.atp.dk/common/type/cpr/v1/" schemalocation="http://rep.atp.dk/common/type/cpr/v1/cprnummer.xsd" <xsd:import namespace="http://rep.atp.dk/common/type/se/v1/" schemalocation="http://rep.atp.dk/common/type/se/v1/senummer.xsd" <xsd:import namespace="http://rep.atp.dk/common/type/str/v1/" schemalocation="http://rep.atp.dk/common/type/str/v1/nonemptystring.xsd" <xsd:import namespace="http://rep.atp.dk/common/type/id32/v1/" schemalocation="http://rep.atp.dk/common/type/id32/v1/identification32.xsd" <xsd:import namespace="http://rep.atp.dk/common/type/timestamp/v1/" schemalocation="http://rep.atp.dk/common/type/timestamp/v1/timestamp.xsd" <xsd:element name="indberetkostoglogitilaub" type="sik:indberetkostoglogitilaubtype" <xsd:element name="indberetkostoglogitilaubdata" type="sik:indberetkostoglogitilaubdatatype" - <xsd:complextype name="indberetkostoglogitilaubtype"> - <xsd:sequence> <xsd:element ref="sik:indberetkostoglogitilaubdata" </xsd:sequence> </xsd:complextype> - <xsd:complextype name="indberetkostoglogitilaubdatatype"> - <xsd:sequence> <xsd:element maxoccurs="unbounded" minoccurs="1" name="creation" type="sik:creationtype" </xsd:sequence> </xsd:complextype> </xsd:schema> 11-01-2016 Side 4
Protokol for dataudveksling 4.3 Datormat Feltnr Antal Bytes Obligat. /Frivillig Datatype Feltforklaring 1 8 O Char Recordtype (Værdi AUB_KOST ) 2 8 O Char Afsender ID Skolehjems SENR. 3 10 O Timestamp Timestamp for recordens dannelse hos sender Notation: yyyy-mmdd- Format = åååå-mm-dd-tt.mm.ss.løbenr hh:mm:ss.999999 Eks. = 2015-01-09-10.38.45.000001 4 5 O Char Afsender-system: EASY_ Angiver det sendende IT-system til sporing. ( _ er = blank ) 5 32 O Char Record-ID. Anvendes som reference ved senere rettelse eller sletning. Værdien skal være unik for sendende system. Frit format men ved indgåelse tale med AUB, tales et specifikt prefiks Hvis der skal rettes, fremsendes ny record med alle værdier, kode=r og det record-id, der ønskes rettet. Dette skal i så fald være modtaget tidligere. Ellers vises recorden. AUB vil da tilbageføre sin gamle record og oprette en ny med de nye værdier. I tilfældet sletning, behøver man kun udfylde de første seks felter. 6 1 O Char Kode for Oprettelse, Rettelse eller Sletning O = oprettelse. R = rettelse S = sletning 7 8 O Char SENR på arbejdsgiver Hvis SENR ikke kan leveres sættes feltet = 0 11-01-2016 Side 5
Protokol for dataudveksling 8 10 O Char Elevens CPR nr. 9 4 Notation:yyyy-mm- O Date Startdato for kost og logi ophold. Format = dd.mm.åååå dd 10 4 O Date Slutdato for kost og logi ophold Notation:yyyy-mm- Format = dd.mm.åååå. Skal være > startdato. dd 11 1 O Char Berettiget Kode for, om opholdet er med statstilskud eller omfattet indtægtsdækket virksomhed. Kodesæt: J = Ophold med statstilskud N = Ophold uden statstilskud 12 4 Højrestillet 13 4 Højrestillet O Char CØSA formål O Char Version Hoved-uddannelseskode højrestillet med foranstillede nuller Uddannelsesversionen højrestillet med foranstillede nuller 14 2 O Char Specialekode højrestillet med foranstillede nuller (kan være blank, hvis elev ikke er tildelt et speciale) 15 8 O Decimal Det akkumulerede beløb Højrestillet AUB ønsker det totale betalte beløb, modtaget efter kostopholdets slutdato. AUB refunderer ikke udgifter til rykkergebyrer mv., så disse beløb må ikke indgå i beløbsfeltet. Beløbet angives i kroner og ører med 2 de- 11-01-2016 Side 6
Validering data cimaler. Dansk komma uden formatering 16 10 O Char Betaler (hvem faktura er udstedt til) AUB har brug for SEnr/CVRnr eller CPR nummer, så vi ved, hvilken virksomhed/elev fakturaen er udstedt til. 17 4 FORELØBIG Notation: yyyy-mmdd VERSION O Date Betalingsdato Format = dd.mm.åååå Datoen for, hvornår fakturaen er betalt til skolehjemmet. 18 2000000 O Char Kontaktperson Variable length 19 16 O Char Kontakt telefonnummer 20 16 O Char Kontakt lokaltelefonnummer 21 4 F Char Svar-kode: udfyldes når AUB svarer. Værdier: OK: indberetning er modtaget OK. Skal ikke gensendes. AFVIST: er ikke registreret. Skal rettes og gensendes. 22 40 F Char Fejltekst fra AUB-systemet udfyldes i tilfælde fejl. 5 Validering data 5.1 Validering ved modtagelse Følgende tests udføres ved modtagelse data i integrationslaget: 11-01-2016 Side 7
Validering data Valideringstype Beskrivelse Sendes tilbage til EASY-A - til kostdelingen (vist) Fejltekst til kostdelingen (via EASY-A) Fejlbeskeder på skærmen Reaktion i SAP Datotjek Der tjekkes på om kostperiode start er større end 31.12.2014. Kostperiode start er før 01.01.2015 Kostperiode start er før 01.01.2015 Datotjek Der tjekkes på, om kostperiode slut dato er ældre end 5 år end modtagelsesdatoen. FORELØBIG Datotjek VERSION Datotjek Kostperiode til dato er før kostperiode fra dato. Kostperiode til dato er efter dagsdato Kost slut dato er ældre end 5 år Kost til dato er før kost fra dato. Kost til dato er efter dagsdato Kost slut dato er ældre end 5 år Kost til dato er før kost fra dato. Kost til dato er efter dagsdato Tjek 1: Ved overlappende kostperioder for samme elev: Er det samme skole? Overlappende og identiske kostperioder (US 8.3 og 8.5) Hvis svaret er JA, så fortsættes her. Hvis svaret er NEJ, så gå videre til Tjek 2. Overlap kostperioder Overlap kostperioder Tjek CPR-nr. i Kernen Kriteriet er, at kost til dato ligger efter CPR-nr. dødsdato. Elev er død Ingen Eleven er død før kost til. Tjek CPR-nr. i Masterdata CPR-nr. kendes ikke i Masterdata Fejl i CPR-nr. CPR-nr. kendes ikke Der er fejl i cprnr. Tjek SE-nr. i Masterdata SE-nummeret må ikke være "fritaget fra AER-bidrag" i dele perioden. SE-nr. kan ikke anvendes AER SE-nr. kan ikke anvendes AER Tjek på record- ID. Record har R for ret, men der er ikke modtaget nogen rettelse. Rettelse uden original Rettelse uden original 11-01-2016 Side 8
Sikkerhed Tjek på record- ID. Record har O for opret, men der er allerede modtaget en record med denne ID. Oprettelse men original findes allerede Oprettelse men original findes allerede Tjek på record- ID. Record har S for slet, men der er ikke modtaget nogen original. Sletning uden original Sletning uden original Tjek på Kostdeling Kostdelingens SEnr. kendes ikke. Kostdelingens SE-nr. kendes ikke Kostdelingens SE-nr. kendes ikke Modtages en XSD med blankt indhold sendes følgende tekniske fejl retur til sender: 5.2 Fejlhåndtering Ved alle modtagelse FORELØBIG en eller flere ovenstående fejlsituationer VERSION er det leverandørs ansvar at rette/behandle fejlen og gensende på ny til AUB. Fejlede ophold medfører at AUB ikke kan behandle skoleopholdet og herved ikke kan refundere arbejdsgiver. 6 Sikkerhed AUB har registreret hvem der anvender denne snitflade og data modtages kun for tilsluttede leverandører. Data skal behandles som fortrolige i henhold til persondataloven. 6.1 Service Level Agreements Servicen er tilgængelig 24/7 med undtagelse servicevinduer og releases. I disse tilfælde bliver serviceabonnenterne kontaktet AUB. 11-01-2016 Side 9