Grensesnitt DIFAS støttesystem og kortleverandørs produksjonssystem

Grensesnitt DIFAS støttesystem og kortleverandørs produksjonssystem Versjon 1.9 18.05.2005 Statens vegvesen Vegdirektoratet

INNHOLDSFORTEGNELSE 1 Innledning... 4 1.1 Dette dokumentet... 4 1.2 Kort om DIFAS støttesystem... 4 2 Løsningsbeskrivelse... 6 2.1 Teknologi... 6 2.1.1 Krav til sikker kommunikasjon... 6 2.2 Meldingskorrelasjon... 7 2.3 Test av kommunikasjon... 7 2.4 Brukstilfeller... 8 2.4.1 Aktører... 8 2.5 Integrasjonsprosess 1 Bestille kort... 9 2.5.1 Kortdata... 9 2.5.2 Avvik... 10 2.6 Integrasjonsprosess 2 Tilbakekalle bestilling av kort... 11 2.6.1 Produksjonsfaser... 11 2.6.2 Avvik... 12 2.7 Integrasjonsprosess 3 Melde fra at bestilt kort er produsert... 13 2.7.1 Avvik... 14 2.8 Integrasjonsprosess 4 Melde fra om makulering av kort... 15 2.8.1 Avvik... 15 2.9 Feilhåndtering... 15 3 Meldinger... 16 3.1 Generelt... 16 3.2 Feilmeldinger... 16 3.3 Meldinger for produksjon av kort... 16 3.3.1 ProduserKort_Request... 17 3.3.2 ProduserKort_Response... 24 3.3.3 TilbakekallKortbestilling_Request... 26 3.3.4 TilbakekallKortbestilling_Response... 28 3.3.5 KortProdusert_Request... 30 3.3.6 KortProdusert_Response... 32 3.3.7 KortMakulert_Request... 34 3.3.8 KortMakulert_Response... 36 3.4 Kommunikasjonstest... 38 3.4.1 IsAlive_Request... 38 3.4.2 IsAlive_Response... 38

FIGURLISTE Figur 1 BiSiReg og DIFAS støttesystem er systemer hos Statens vegvesen som er involvert i produksjon av digital fartskriver kort.... 5 Figur 2: Kommunikasjon skjer med webservices... 6 Figur 3 KorrelasjonsId for meldinger... 7 Figur 4: Fire brukstilfeller for kommunikasjon mellom DIFAS støttesystem og Kortleverandørs produksjonssystem.... 8 Figur 5 Bestilling av kort... 9 Figur 6 Formidling av avvik for bestilling av kort... 10 Figur 7 Tilbakekalling av kortbestilling... 11 Figur 8 Normal meldingsutveksling ved produksjon av kort... 13 Figur 9 Avvik ved melding om produksjonsstatus... 14 Figur 10 Makulering av kort... 15

1 Innledning 1.1 Dette dokumentet Dette dokumentet beskriver grensesnittet mellom Statens vegvesens administrative støttesystem for digital fartskriver (heretter kalt DIFAS støttesystem) og produksjonssystemet til leverandør av korttjenester. Dokumentet er skrevet som en veiledning for de som skal implementere kommunikasjon mellom kortleverandørs produksjonssystem og DIFAS støttesystem. Dokumentet er relativt teknisk detaljert og antar at leseren kjenner til web services som teknologi. Det blir ikke beskrevet hvordan kortleverandør skal legge kortdata inn på fartskriverkortene eller hvordan kortleverandør skal kommunisere med leverandør av MSCA-tjenester. 1.2 Kort om DIFAS støttesystem DIFAS støttesystem er administrativt system som gir Statens vegvesen mulighet til å administrere smartkort til digitale fartskrivere i kjøretøy som kommer inn under reglene for kjøre- og hviletid i vegtransport. DIFAS støttesystem vil hovedsaklig bli brukt av saksbehandlere ved trafikkstasjoner hos Statens vegvesen, men også av kontrollører og administratorer av systemet. Hovedmålet med innføring av digital fartskriver er at de data om kjøre- og hviletid som skal granskes av kontrollmyndighetene vil bli lettere tilgjengelige for dem. I tillegg kommer hensynet til at data blir mer fullstendige. Hovedmålet til DIFAS støttesystem er å utstede og vedlikeholde informasjon angående fartsskriverkort, og sikre at ingen bruker har ulovlige fartsskriverkort. Sjekk mot andre lands registre over fartskriverkort vil skje ved at DIFAS støttesystem forespør de andre landene vha. et felles europeisk nettverk. Systemer som det uveksles data mellom ved produksjon av kort er vist i Figur 1. BiSiReg er Statens vegvesens system for bilder og signaturer brukt på førerkort og fartskriverkort. Kortbestillinger sendes fra DIFAS støttesystem til en ekstern kortleverandør. Kortleverandør vil kun kommunisere med DIFAS støttesystem og ikke med BiSiReg.

Leverandør av MSCA-tjenester Kortleverandørs produksjonssystem DIFAS støttesystem Digitalt sertifikat kortbestilling VPN Fartsskriverkort FRONT DRIVER CARD MEMBER STATE TARJETA DEL CONDUCTOR 1. MS FØRERKORT 2. FAHRERKARTE 3. 4a. 4b. DRIVER CARD 6. 4c. CARTE DE CONDUCTEUR A (4d.) B B CÁRTA TIOMÁNAÍ 5a. CARTA DEL CONDUCENTE 5b. BESTUURDERSKAART CARTÃO DE CONDUTOR 7. KULJETTAJAKORTTILLA FÖRARKORT (8.) REVERSE 1. Surname 2. First name(s)3. Birth date 4a. Date of start of validity of card 4b. Administrative expiry date of card 4c. Issuing authority (4d.) No for national administrative purposes 5a. Driving license number 5b. Card number A 6. Photograph 7. Signature (8.) Address Please return to: NAME OF AUTHORITY AND ADDRESS BiSIReg bilde og signatur Korteier Figur 1 BiSiReg og DIFAS støttesystem er systemer hos Statens vegvesen som er involvert i produksjon av digital fartskriver kort.

2 Løsningsbeskrivelse Dette kapittelet beskriver teknologi, brukstilfeller og sekvensdiagrammer for kommunikasjonen mellom DIFAS støttesystem og Kortleverandørs produksjonssystem. 2.1 Teknologi All kommunikasjon mellom Statens vegvesen og kortleverandør skal skje ved hjelp av web services. SOAP versjon 1.1 benyttes. Hos Statens vegvesen vil det bli satt opp web services for kall fra kortleverandør. Kortleverandør må sette opp web services på sin side for kall fra DIFAS støttesystem. Dette er beskrevet i Figur 2. dd Meldingsteknologi Statens v egv esen Kortlev eandør DIFAS Applikasjon Webservices Webservices Figur 2: Kommunikasjon skjer med webservices 2.1.1 Krav til sikker kommunikasjon Krav til sikkerhet for kommunikasjonen er beskrevet i dokumentet Policy for digital fartskriver i Norge, da spesielt kapitlene 5.8 og 5.9. For valg av teknologi er følgende bestemt: 1. Kortleverandør skal benytte en VPN-klient som kan koble seg opp mot VPN hos Statens vegvesen via internett. 2. Kortleverandør skal opprette forbindelsen til Statens vegvesen og sørge for en stabil kommunikasjon. 3. Kortleverandør skal tilgjengeliggjøre web services for kommunikasjon med DIFAS støttesystem som spesifisert i dette dokumentet. WSDL dokument med beskrivelse skal tilgjengeliggjøres kun for Statens vegvesen.

2.2 Meldingskorrelasjon Svarmeldinger skal inneholde en KorrelasjonsId som skal være lik Id for den meldingen som den er et svar på. sd DIFAS - Kortlev erandør - kortbestilling DIFAS støttesystem Kortlev erandørs produksjonssystem Id = 42 ProduserKort_Request(kortdata, bilde og signatur) ProduserKort_Response(kortnummer) KorrelasjonsId = 42 Figur 3 KorrelasjonsId for meldinger 2.3 Test av kommunikasjon Det skal være mulig å sende testmeldinger til samme server som mottar produksjonsmeldinger. En URL skal motta testmeldinger mens en annen URL skal motta reelle produksjonsmeldinger. Meldinger med TestId= Simulering skal ikke føre til produksjon av kort. Meldinger med TestId= Produksjon er skal føre til produksjon av kort. Når en testmelding skal besvares skal korrekt KorrelasjonsId benyttes som beskrevet i 2.2. I tillegg skal det være mulig å sjekke at den andre parten svarer på forespørsler ved å sende en IsAlive_Request melding.

2.4 Brukstilfeller Det er fire brukstilfeller for kommunikasjon mellom DIFAS støttesystem og Kortleverandørs produksjonssystem. ud DIFAS - Kortleverandør Meldingssystem UC1 Bestille kort UC2 Melde fra at bestilt kort er produsert DIFAS støttesystem UC3 Tilbakekalle bestilling av kort UC4 Melde fra om makulering av kort Kortlev erandørs produksjonssystem Figur 4: Fire brukstilfeller for kommunikasjon mellom DIFAS støttesystem og Kortleverandørs produksjonssystem. 2.4.1 Aktører DIFAS støttesystem: Digital Fartskriver Administrativt Støttesystem. Applikasjon som forvalter informasjon om fartskriverkort i Norge. Kortleverandørs produksjonssystem: System for produksjon av digitale fartskriver kort med av kortdata og produksjonsinformasjon for fartskriverkort hos kortleverandør.

2.5 Integrasjonsprosess 1 Bestille kort Initieres av DIFAS støttesystem. Bestilling av kort vil skje ved at det gjøres et web service kall (ProduserKort_Request) når saksbehandler godkjenner en søknad og velger å utstede kort. Dette kallet vil inneholde kortdata fra DIFAS støttesystem og bilde og signatur fra BiSiReg. Kortleverandør skal svare med et web service kall (ProduserKort_Response) som sier at bestillingen er mottatt og vil bli behandlet. sd DIFAS - Kortlev erandør - kortbestilling DIFAS støttesystem Kortlev erandørs produksjonssystem ProduserKort_Request(kortdata, bilde og signatur) ProduserKort_Response(kortnummer) Figur 5 Bestilling av kort 2.5.1 Kortdata Kortdata som skal inn på kortene er beskrevet i Beskrivelse av fartskriverkort for digital fartskriver i Norge. Disse dataene vil bli overført i web service kall som er definert i kapittel 3 eller i data som kortleverandør får fra leverandør av MSCA-tjenester (Member State Certficate Authority). Kortnummer som skal benyttes på kortene skal genereres av DIFAS støttesystem.

2.5.2 Avvik Følgende feilsituasjoner kan oppstå for en kortbestilling Manglende eller uriktig informasjon i bestilling Kort med kortnummer allerede produsert Intern feil hos kortleverandør gjorde at meldingen ikke kunne mottas sd DIFAS - Kortlev erandør - kortbestilling av v ik DIFAS støttesystem Kortlev erandørs produksjonssystem ProduserKort_Request(kortdata, bilde og signatur) Feilmelding(kode, årsak) Figur 6 Formidling av avvik for bestilling av kort Hvis kortleverandør mottar en bestilling på et kort som allerede er produsert skal dette meldes tilbake som feilmelding uten at nytt kort produseres. For manglende informasjon i bestillingen skal det fremgå i feilmeldingen hvilken informasjon som mangler. For uriktig informasjon i bestillingen skal det fremgå i feilmeldingen hvilken informasjon som er uriktig. Begge tilfellene fører til at produksjonen ikke kan fortsette. Når grunnen til feilen er avdekket skal DIFAS støttesystem sende en ny bestilling. Kortleverandør kan da forkaste bestillinger med feil etter å ha sendt en feilmelding som beskriver feilen.

2.6 Integrasjonsprosess 2 Tilbakekalle bestilling av kort Initieres av DIFAS støttesystem. Det skal være mulig å sende en melding fra DIFAS støttesystem for å stoppe produksjon og utsendelse av ett bestemt kort. Grunnen til dette kan være at det har kommet inn informasjon om søkeren i etterkant av at bestillingen ble sendt. Dette skal kunne gjøres i tidsrommet før kortet sendes ut fra kortleverandør. 2.6.1 Produksjonsfaser Enkel oversikt over produksjonsfaser hos kortleverandør Forespørsel fra F Validering Lagring F Produksjon og kontroll F Sendt DIFAS 1 DB3 2 3 WEB Service TPS FASE 0 FASE 1 FASE 2 FASE 3 Tilbakemelding T 1.x T 2.x T 3.x T 4.x Bestilt kort er i Fase 1: Bestilling tilbakekalt Bestilt kort er i Fase 2: Bestilling under produksjon kort blir makulert Bestilt kort i Fase 3: Bestilling kunne ikke tilbakekalles sendt til sluttbruker Statens vegvesen får dermed klar beskjed at kortet er sendt fra kortleverandør. Hvis kortet er under produksjon og vil dette bli makulert før det sendes ut (FASE 3). Dette vil økonomisk sett føre kostnader bade for produsert kort og destruering av feil bestilt kort. Tilbakekalling av bestillingen gjøres ved at meldingen TilbakekallKortbestilling_Request sendes fra DIFAS støttesystem til kortleverandør. Denne meldingen skal kvitteres av kortleverandør med meldingen TilbakekallKortbestilling_Response, som sier hvorvidt kortleverandøren var i stand til å stoppe produksjon eller tilbakekalle kortet eller ikke. sd DIFAS - Kortlev erandør - tilbakekalling av kortbestilling DIFAS støttesystem Kortlev erandørs produksjonssystem ProduserKort_Request(kortdata, bilde og signatur) ProduserKort_Response(kortnummer) TilbakekallKortbestilling_Request(kortnummer, bestillingsnummer) TilbakekallKortbestlling_Response(status) Figur 7 Tilbakekalling av kortbestilling

2.6.2 Avvik Følgende feilsituasjoner kan oppstå ved tilbakekalling av kortbestilling: Manglende eller uriktig informasjon i tilbakekalling Tilbakekalling av en bestilling på et kort som ikke er bestilt. Intern feil i DIFAS gjorde at meldingen ikke kunne mottas Hvis DIFAS støttesystem ber om å tilbakekalle en bestilling ved å sende en TilbakekallKortbestilling_Request melding til kortleverandør på et kort som ikke er bestilt, skal kortleverandør sende en feilmelding tilbake til DIFAS støttesystem som informerer om dette. Deretter kan kortleverandør forkaste meldingen.

2.7 Integrasjonsprosess 3 Melde fra at bestilt kort er produsert Initieres av Kortleverandørs produksjonssystem Kortleverandør skal gi tilbakemelding om når et kort er produsert ved hjelp av web service kallet KortProdusert_Request. Denne meldingen skal inneholde kortets nummer og digitale sertifikat. Melding om produksjonsstatus skal sendes samme dag som produksjon har funnet sted. DIFAS støttesystem skal svare på denne meldingen med web service kallet KortProdusert_Response. sd DIFAS - Kortlev erandør - produksjonsstatus DIFAS støttesystem Kortlev erandørs produksjonssystem ProduserKort_Request(kortdata, bilde og signatur) ProduserKort_Response(kortnummer) KortProdusert_Request(kortnummer, digitalt sertifikat) KortProdusert_Response(kortnummer) Figur 8 Normal meldingsutveksling ved produksjon av kort Kortleverandør skal også gi melding dersom et kort blir makulert i produksjonsprosessen. Dette skjer med meldingen KortMakulert_Request som DIFAS støttesystem besvarer med KortMakulert_Response. Dette gjøres for å holde orden på status for alle fysiske kort.

2.7.1 Avvik Følgende feilsituasjoner kan oppstå ved formidling av produksjonsstatus: Manglende eller uriktig informasjon i meldingen Kort som er produsert er ikke bestilt Bestilling for kort som er produsert har blitt trukket tilbake Intern feil i DIFAS gjorde at meldingen ikke kunne mottas Hvis kortleverandør melder fra (med et KortMakulert_Request kall) om at det er produsert et kort som DIFAS støttesystem ikke kan finne blant sine bestillinger, skal DIFAS støttesystem melde sende en feilmelding tilbake til kortleverandør. Likedan sender DIFAS støttesystem en feilmelding tilbake til kortleverandør hvis bestillingen for kortet som er bestilt er trukket tilbake. Kortleverandør skal da ikke sende ut kortet til korteier. sd DIFAS - Kortlev erandør - av v ik for produksjonsstatus DIFAS støttesystem Kortlev erandørs produksjonssystem ProduserKort_Request(kortdata, bilde og signatur) ProduserKort_Response(kortnummer) KortProdusert_Request(kortnummer, digitalt sertifikat) Feilmelding(kode, årsak) Figur 9 Avvik ved melding om produksjonsstatus

2.8 Integrasjonsprosess 4 Melde fra om makulering av kort Initieres av Kortleverandørs produksjonssystem. Kortleverandør skal melde fra om alle kort som makuleres som følge av ett av tilfellene som er beskrevet i avsnitt 5.5.6 i Policy for digital fartskriver i Norge. Dette gjøres ved at meldingen KortMakulert_Request sendes til DIFAS støttesystem. DIFAS støttesystem skal da svare med meldingen KortMakulert_Response for å bekrefte at data om det makulerte kortet er lagret. sd DIFAS - Kortlev erandør - makulering av kort DIFAS støttesystem Kortlev erandørs produksjonssystem KortMakulert_Request(kortnummer, digitalt sertifikat, årsak) KortMakulert_Response(kortnummer) Figur 10 Makulering av kort Hvis et kort tilbakekalles etter at produksjon har startet vil det sendes en makuleringsmelding som indikerer at dette er makulert pga. tilbakekalling av bestilling fra Statens vegvesen. 2.8.1 Avvik Følgende feilsituasjoner kan oppstå ved formidling av makulering: Manglende eller uriktig informasjon i meldingen Kort som er makulert er ikke bestilt Intern feil i DIFAS gjorde at meldingen ikke kunne mottas 2.9 Feilhåndtering Hvis en melding (fra DIFAS støttesystem til kortleverandør eller fra kortleverandør til DIFAS støttesystem) ikke følger gyldig format, mangler data eller har andre feil, skal det svares med en beskrivende feilmelding i form av en SOAP Fault. Feilmeldinger skal sendes umiddelbart når et avvik oppstår. Dette er beskrevet nærmere i kapittel 3.2. Hvis en intern feil oppstår på en side skal dette meldes til systemeier (via email, telefon el.) straks da det kan indikere en alvorlig feil i programvaren på den siden som skulle motta meldingen.

3 Meldinger 3.1 Generelt Alle meldinger vil være web service kall med XML-payload. Meldinger skal benytte UTF-8 encoding og kortleverandør skal validere format på meldinger som kommer fra DIFAS støttesystem. Informasjon om aksesspunkt, XSD- og WSDL-dokumenter for meldingene vil bli utarbeidet som en del av arbeidet med å implementere DIFAS støttesystem. 3.2 Feilmeldinger Når det oppstår et avvik skal det sendes en feilmelding tilbake til parten som sendte meldingen som førte til avvikssituasjonen. Alle feilmeldinger sendes som SOAP Fault. Feilkoder er angitt etter hver melding. Element Antall Type Lengde Beskrivelse Fault 1 Element Faultcode 1 String 36 Maskinlesbar feilkode Faultstring 1 String Menneskelig lesbar beskrivelse av feilen. Skal inneholde en referanse til id for meldingen som utløste feilen. Detail 0-1 String Valgfri ekstra beskrivelse av situasjonen Eksempel <SOAP-ENV:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap-enc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <SOAP-ENV:Body> <SOAP-ENV:Fault> <faultcode>soap-env:client.message.incomplete</faultcode> <faultstring>meldingen mangler nødvendige data</faultstring> <detail> Produksjonsbestilling med id 1234634523353 for kortnummer NO12345678960123 kan ikke produseres: Informasjon mangler: Etternavn</detail> </SOAP-ENV:Fault> </SOAP-ENV:Body> </SOAP-ENV:Envelope> Følgende feilkoder er definert: Faultcode Faultstring Server.Validation XML kunne ikke valideres Server.Message.Incomplete Meldingen mangler nødvendige data I tillegg er innhold i gyldige feilmeldinger knyttet til spesifikke meldinger beskrevet under hver melding. Feilmeldinger skal sendes umiddelbart når et avvik oppstår. Parten som sender feilmeldingen står fritt til å fylle inn <detail> feltet med utfyllende informasjon om feilsituasjonen. 3.3 Meldinger for produksjon av kort Det er fire meldinger med tilhørende svar som beskriver produksjon og makulering av kort:

ProduserKort KortProdusert TilbakekallKortbestilling KortMakulert 3.3.1 ProduserKort_Request Melding om at et kort skal produseres vil være en sammenstilling av kortdata fra DIFAS støttesystem og bilde og signatur hentet fra BiSiReg. Dette gjøres ved at DIFAS støttesystem henter bilde og signatur og legger det til meldingen som binære data kodet om til tekst med Base64.

Eksempel: <!--Melding fra DIFAS støttesystem til kortleverandør om at det skal produseres et fartskriverkort med dataene gitt i denne meldingen.-->

<SOAP-ENV:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap-enc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi= http://www.w3.org/2001/xmlschema-instance xmlns:xsd="http://www.w3.org/2001/xmlschema"> <SOAP-ENV:Body> <ProduserKort_Request xmlns="urn:no.vegvesen.difas" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="urn:no.vegvesen.difas:\difas\kortleverandør\cp.xsd"> <Header Versjon="1.9" SendtTidspunkt="2001-12-17T09:30:47.0Z" MeldingsId="1234567890" TestId="Produksjon"/> <Body> <Bestilling Bestillingsreferanse="42"> <Sjaforkort Kortnummer="NO10000000000000" Utstedelsesmyndighet="Statens vegvesen" Startgyldighetdato="1967-08-13" Sprak="EN" Utstedelsesnasjon="NO" Sluttgyldighetdato="1967-08-13"> <Innehaver Fodselsdato="1967-08-13" Fornavn="Kari" Etternavn="Normann"> <Bilde/> <Signatur/> <Forerkort Utstedelsesmyndighet="Statens vegvesen" Utstedelsesnasjon="NO" Forerkortnummer="12345678901"/> </Innehaver> </Sjaforkort> <Produksjonsinformasjon Forsendelsesadresse="Hageveien 1, 2100 Skarnes" Malform="Nynorsk"/> <Brevinformasjon> <Region Adresselinje1="Serviceboks 723" Adresselinje2=" 4808 ARENDAL" Telefax="37 01 98 01" Epost="firmapost-sor@vegvesen.no" Distrikt="Øvre Buskerud" Navn="Region sør" Telefon="815 48 000" /> <Trafikkstasjon Navn="Kongsvinger trafikkstasjon" Adresselinje1="Postboks 524 Stasjonssida" Postnummer="2200" Poststed="Kongsvinger"/> </Brevinformasjon> </Bestilling> </Body> </ProduserKort_Request> </SOAP-ENV:Body> </SOAP-ENV:Envelope> I eksempelet over er innhold i bilde og signatur utelatt for å øke lesbarheten. Den endelige implementasjonen av meldingen vil kunne avvike noe fra eksempelet over. Følgende feilkoder er definert spesielt som tilbakemelding på ProduserKort_Request: Faultcode Faultstring Server.Production.CardProduced Kort med kortnummer som bestilles er allerede produsert Server.BinaryDataNotValidated Informasjonen som ble oversendt til kortprodusent Ble ikke godkjent av produksjonsutstyret.

3.3.2 ProduserKort_Response Svar fra kortleverandør på meldingen ProduserKort_Request. Eksempel: <! Melding fra kortleverandør til DIFAS støttesystem om at kortbestilling (ProduserKort_Request) er mottatt.--> <SOAP-ENV:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap- ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <SOAP-ENV:Body> <ProduserKort_Response xmlns="urn:no.vegvesen.difas" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="urn:no.vegvesen.difas:\difas\kortleverandør\cp.xsd"> <Header Versjon= 1.5 SendtTidspunkt="2001-12-17T09:30:47.0Z" MeldingsId="12345654321" KorrelasjonsId="1234567890" TestId= Produksjon /> <Body> <Kvittering MottattTidspunkt="2001-12-17T09:30:47.0Z" Kortnummer="NO10000000000000" Bestillingsreferanse="42"/>

</Body> </ProduserKort_Response> </SOAP-ENV:Body> </SOAP-ENV:Envelope>

3.3.3 TilbakekallKortbestilling_Request Tilbakekalling av en bestilling for produksjon av kort. Eksempel: <! Melding fra DIFAS støttesystem til kortleverandør om at en kortbestilling skal tilbakekalles. Kortet skal ikke produseres --> <SOAP-ENV:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap- ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <SOAP-ENV:Body> <TilbakekallKortbestilling_Request xmlns="urn:no.vegvesen.difas" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="urn:no.vegvesen.difas:\difas\kortleverandør\cp.xsd"> <Header Versjon= 1.5 SendtTidspunkt="2001-12-17T09:30:47.0Z" MeldingsId="1234567890" TestId= Produksjon /> <Body> <Tilbakekalling Kortnummer="NO10000000000000" Bestillingsreferanse="42"/> </Body> </TilbakekallKortbestilling_Request> </SOAP-ENV:Body> </SOAP-ENV:Envelope> Følgende feilkoder er definert spesielt som tilbakemelding på TilbakekallKortbestilling_Request: Faultcode Faultstring Server.Recall.CardNotOrdered Tilbakekalling av en bestilling på et kort aldri har blitt bestilt

Server.Recall.Rejected Tilbakekalling ikke mulig av andre årsaker. Skal spesifiseres i <detail> feltet for denne feilen.

3.3.4 TilbakekallKortbestilling_Response Svar på TilbakekallKortbestilling_Request. Eksempel: <! Melding fra kortleverandør til DIFAS støttesystem om at tilbakekalling (TilbakekallKortbestilling_Request) er mottatt --> <SOAP-ENV:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap-enc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi= http://www.w3.org/2001/xmlschema-instance xmlns:xsd="http://www.w3.org/2001/xmlschema"> <SOAP-ENV:Body> <TilbakekallKortbestilling_Response xmlns="urn:no.vegvesen.difas" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="urn:no.vegvesen.difas:\difas\kortleverandør\cp.xsd"> <Header Versjon= 1.9 SendtTidspunkt="2001-12-17T09:30:47.0Z" MeldingsId="12345654321" KorrelasjonsId="1234567890" TestId= Produksjon /> <Body>

<Kvittering MottattTidspunkt="2001-12-17T09:30:47.0Z" Kortnummer="NO10000000000000" Bestillingsreferanse="42"/> <Tilbakemelding Resultat="Bestilling tilbakekalt"/> </Body> </TilbakekallKortbestilling_Response> </SOAP-ENV:Body> </SOAP-ENV:Envelope>

3.3.5 KortProdusert_Request Melding om at et kort er produsert. Eksempel: <! Melding fra Kortleverandør til DIFAS støttesystem om at det er produsert et kort.--> <SOAP-ENV:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap-enc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <SOAP-ENV:Body> <KortProdusert_Request xmlns="urn:no.vegvesen.difas" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="urn:no.vegvesen.difas:\difas\kortleverandør\cp.xsd"> <Header Versjon= 1.9 SendtTidspunkt="2001-12-17T09:30:47.0Z" MeldingsId="1234567890" TestId= Produksjon /> <Body> <Produksjon Kortnummer="NO10000000000000" Bestillingsreferanse="42"/> </Body> </KortProdusert_Request> </SOAP-ENV:Body> </SOAP-ENV:Envelope> I eksempelet er ikke verdier for <ESN> og <Digitaltsertifikat> fylt inn.

Følgende feilkoder er definert spesielt som tilbakemelding på KortProdusert_Request: Faultcode Faultstring Server.Production.CardNotOrdered Kort som er produsert er ikke bestilt Server.Production.CardOrderRecalled Kortbestillingen er tilbakekalt

3.3.6 KortProdusert_Response Svar på KortProdusert_Request. Eksempel: <! Melding fra DIFAS støttesystem til kortleverandør om at kortdata (KortProdusert_Request) er mottatt. --> <SOAP-ENV:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap- ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <SOAP-ENV:Body> <KortProdusert_Response xmlns="urn:no.vegvesen.difas" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="urn:no.vegvesen.difas:\difas\kortleverandør\cp.xsd"> <Header Versjon= 1.9 SendtTidspunkt="2001-12-17T09:30:47.0Z" MeldingsId="1234567890" KorrelasjonsId="12345654321" TestId= Produksjon /> <Body> <Produksjon Kortnummer="NO10000000000000" Utstedelsesdato="1967-08-13" Bestillingsreferanse="42">

<Kort> </Kort> </Body> </KortProdusert_Response> </SOAP-ENV:Body> </SOAP-ENV:Envelope> <ESN>LUHJHALSDSLAKBHJAS</ESN> <DigitaltSertifikat>KLADGHLGJUDALUI</DigitaltSertifikat>

3.3.7 KortMakulert_Request Melding om at et kort er makulert. Eksempel: <! Melding fra Kortleverandør til DIFAS støttesystem om at et kort er makulert. --> <SOAP-ENV:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap- ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <SOAP-ENV:Body> <KortMakulert_Request xmlns="urn:no.vegvesen.difas" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="urn:no.vegvesen.difas:\difas\kortleverandør\cp.xsd"> <Header Versjon= 1.9 SendtTidspunkt="2001-12-17T09:30:47.0Z" MeldingsId="1234567890" TestId= Produksjon /> <Body> <Makulering Kortnummer="NO10000000000000" Bestillingsreferanse="42"> <Arsak Beskrivelse="Tilbakekalling SVV"/> <Kort Kortnummer="NO10000000000000"> <ESN>String</ESN>

</Kort> </Makulering> </Body> </KortMakulert_Request> </SOAP-ENV:Body> </SOAP-ENV:Envelope> <DigitaltSertifikat>String</DigitaltSertifikat> I eksempelet er ikke verdier for <ESN> og <Digitaltsertifikat> fylt inn. Følgende feilkoder er definert spesielt som tilbakemelding på KortProdusert_Request: Faultcode Faultstring Server.CardDoesNotExist Kort som er makulert finnes ikke i DIFAS database

3.3.8 KortMakulert_Response Svar på KortMakulert_Request. Eksempel: <! Melding fra DIFAS støttesystem til kortleverandør om at makuleringsmelding (KortMakulert_Request) er mottatt. --> <SOAP-ENV:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap- ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <SOAP-ENV:Body> <KortMakulert_Response xmlns="urn:no.vegvesen.difas" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="urn:no.vegvesen.difas:\difas\kortleverandør\cp.xsd"> <Header Versjon= 1.9 SendtTidspunkt="2001-12-17T09:30:47.0Z" MeldingsId="12345654321 " KorrelasjonsId="1234567890" TestId= Produksjon /> <Body> <Kvittering MottattTidspunkt="2001-12-17T09:30:47.0Z" Kortnummer="NO10000000000000" Bestillingsreferanse="42"/>

</Body> </KortMakulert_Response> </SOAP-ENV:Body> </SOAP-ENV:Envelope>

3.4 Kommunikasjonstest Det skal finnes en melding som sjekker om kommunikasjon mellom DIFAS støttesystem og kortleverandør er aktiv. Begge meldingene skal kunne sendes både fra DIFAS støttesystem til kortleverandør og fra kortleverandør til DIFAS støttesystem. Når en part sender en IsAlive_Request melding skal den andre parten svare med en IsAlive_Response. 3.4.1 IsAlive_Request Forespørsel om server svarer på kall. Eksempel: <! Melding for å sjekke om den andre parten svarer. --> <SOAP-ENV:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap- ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <SOAP-ENV:Body> <IsAlive_Request xmlns="urn:no.vegvesen.difas" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="urn:no.vegvesen.difas:\difas\kortleverandør\cp.xsd" Versjon= 1.9 SendtTidspunkt="2001-12-17T09:30:47.0Z" MeldingsId="1234567890" TestId= Produksjon /> </SOAP-ENV:Body> </SOAP-ENV:Envelope> 3.4.2 IsAlive_Response Svarer at server er aktiv.

Eksempel: <! Melding for si ifra at tjeneste er tilgjengelig. --> <SOAP-ENV:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap- ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <SOAP-ENV:Body> <IsAlive_Response xmlns="urn:no.vegvesen.difas" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="urn:no.vegvesen.difas:\difas\kortleverandør\cp.xsd" Versjon= 1.9 MottattTidspunkt="2001-12-17T09:30:47.0Z" SendtTidspunkt="2001-12-17T09:30:47.0Z" MeldingsId="12345654321" KorrelasjonsId="1234567890" TestId= Produksjon /> </SOAP-ENV:Body> </SOAP-ENV:Envelope>