Service API Specificatie. Key2Parkeren Koppelvlak Tijdelijke Kenteken Registratie

Vergelijkbare documenten
Service API Specificatie. Key2Parkeren Koppelvlak Kentekenwijziging

Service API Specificatie. Key2Parkeren Koppelvlak Bewonersproducten

Key2Parkeren. Koppeling Module vergunningen - Extern financieel pakket

Key2Parkeren. Koppeling Kassa-applicatie

KEY2PARKEREN. Koppeling Eltratax

Technische documentatie APK AFS 6.2

KEY2PARKEREN. Koppeling Tradelec

Rekenen Groep 6-2e helft schooljaar.

Test rapport Yenlo The experts in integration

Rekenen Groep 6-1e helft schooljaar.

Kilometerregistratie App. powered by SCOPE

Rekenen Groep 7-2e helft schooljaar.

Voorbeeldberichten KRE webserver

KEY2BELASTINGEN KOPPELING EXTERNE VORDERINGEN

Functionaliteit: lvwoz-processor 1. In deze versie worden de opentunnel.extra eigenschappen van berichten correct geretourneerd naar OpenTunnel.

Voorbeeldberichten KRI webserver

Koppelvlakbeschrijving statusservice Bancaire Infrastructurele Voorzieningen. Het ophalen van statusinformatie bij de BIV

1 INLEIDING Doel Scope 7. 2 SOAP ENVELOPE EN NAMESPACES SOAP Envelope Namespaces 8

Gebruikershandleiding e-invoicing/customerservice 01.00

Openbare webservice diergeneeskunderegister

Coachview.net Eenmalige Imports

Handleiding Testvoorziening istandaarden (TiS) 4 mei 2017

Koppelvlakbeschrijving mededelingenservice Bancaire Infrastructurele Voorzieningen. Het ophalen van mededelingen bij de BIV

Gebruikershandleiding bezwaar en beroep applicatie

GISVG KOPPELING WAARDEREN DERDEN

DinZ Web ZVW. Gebruikershandleiding. Release 1.46 Copyright DinZ BV, Nederland

Korte handleiding AB Register Melkvee: technische specificaties

Gebruikers Handleiding Webservice Verzekering Afsluiten

Gebruikershandleiding GPK-applicatie

Berichtspecificaties Connector Verkooporders. Unit4 Business Software B.V. Datum Februari 2016 Connector Document versie 5.

Rapport. Versiebeheer. Aan te sluiten overheidspartij Kamer van Koophandel Nederland

Technische documentatie Overdracht bedrijfsvoorraad B2B AFS 6.2

Antwoorden Rekenen Groep 5-1e helft schooljaar

Brunelleschi. De Dom van Florence

Tellerstand dienst (OKR) AFS 7.0

Beschrijving OpenTunnel koppelvlak met MijnOverheid BerichtenBox

Port Redirection NAT >> Port Redirection Enable.

Rekenen Groep 4-1e helft schooljaar.

INSPIRATIE FORMULIER NIEUW INCIDENT

Technische Documentatie TaxatieVoertuig A2SP 2015

Rekenen Groep 4-2e helft schooljaar.

Rekenen Groep 4-2e helft schooljaar.

Gebruikershandleiding MijnPost Business 2 Business Webservice

Geen fabriekswerk. Roeien met de wind mee en de stroom tegen. Jac Willekens

Aansluitdocument webservices COV VZ801/802

Switch aanmelden in VigorACS 2

Handleiding Simon. 5 juni Schouw Informatisering B.V. Danny Cevaal. Versienummer 1.0

HANDLEIDING SERVICEDESKPORTAL

Releasenotes VerzuimSignaal. Versie: VS In business for people.

IBAN API. Simpel & krachtig. Documentatie : IBAN REST API Versie : 1.0 DE BETAALFABRIEK

Gebruikershandleiding webagenda voor begrafenisondernemers

Basiswettenbestand Gebruikersdocumentatie Web services. Versie 1.0 Datum 3 juni 2015

Web applicatie Tolk- en vertaalaanvragen: Handleiding voor aanvragers SVBBO

Index. Auteur: André van den Nouweland Datum: 17 oktober 2017 Betreft: SAML voor authenticatie/autorisatie

Onderhouden Werkvoorraad

Nu kunt u aangeven over welke WAN poort dit verkeer moet lopen. Standaard staat Binding WAN Interface op WAN1. Dit kunt u uiteraard zelf aanpassen.

Compliancy Testrapportage

Taxis Pitane Business Suite Taxi Online API. Censys BV Eindhoven v1.0.1

Juliana van Stolberglaan CA Den Haag Postbus AC Den Haag [Handleiding Generieke interface Energielabels.

VoIP Blocking: Hiermee kunnen VoIP protocollen zoals JaJah en Skype geblokkeerd worden.

Procesbeschrijving aansluiten digitaal stelsel Vergunningaanvragen en meldingen verwerken

Belscores. Gegevensstroom BEL_GS01 Push belscores

Beheervoorziening BSN - Use Case Specificatie 28: Ophalen nummergegevens

Gebruikershandleiding Digikoppeling Serviceregister

Generieke interface energielabels

Gebruikershandleiding GPK applicatie

Bancaire Infrastructurele Voorziening Fout- en statusmeldingen

Titel: Beschrijving berichten - T010 Re. : 1.1 Blad : 1 van 6 Datum : 10-april-2017

HANDLEIDING INDIVIDUEEL KEUZEBUDGET

Open Ports. Als eerste maakt u de regel actief. Dit kan door boven in het scherm een vinkje te zetten bij Enable Open Ports

WAN IP Alias. In deze handleiding gaan wij uit van onderstaande IP-adressen, deze gegevens ontvangt u normaal gesproken van uw internet provider.

Access Point Management. DrayTek Vigor 2860 & 2925 Serie

HOE WERKT DE API WIJZIGEN KENMERKEN ZAAK/OBJECT/DOCUMENT

Extern FD-register t.b.v. vergunningcontrole

Whitepaper. One language, one source, one truth

KOPPELVLAK BEZORGEN REISDOCUMENTEN

Beheervoorziening BSN - Use Case Specificatie 25: Periodieke controle nummerregister

QoS / Quality Of Service

Technisch Interface Specificatie Webservice Koppelvlak Versie Datum Status Concept

Firewall Configuratie

Screenshots tbv Checklist Testen Berichtenbox Circle Software dinsdag 4 februari Test uitgevoerd :

Wijziging algemene btw-tarief Plan&Go TMS, In&Out WMS en Cash&Pay

HDN DARTS WEB AUTHENTICATIE

Functioneel ontwerp. Omgevingsloket online. Koppeling met BAG

1.4. Installatie toelichting. RoTekst. Dé specialist in ruimtelijke informatievoorziening

Koppelvlakbeschrijving aanleverservice Bancaire Infrastructurele Voorzieningen. Het aanleveren van kredietrapportages bij de BIV

Firewall. Web Content Filter

In deze handleiding kunt je de stappen vinden die je kunt uitvoeren om de foto s in Sportlink te zetten.

Koppelvlakbeschrijving AuSP Service Bancaire Infrastructurele Voorzieningen

Dashboard bekostigd BRON mbo

Koppelvlak BAG Koppelvlak BAG. Documentversie: 1.01 Datum: Versie van standaard: 3.10

Beheervoorziening BSN - Use Case Specificatie 33: Stellen Bulkvraag

HANDLEIDING WEBSERVICES DICOS NETWERK VERSIE 1.6

BAG Beheerauditrapportage

In deze handleiding gaan we een voorbeeld geven hoe u een bepaalde situatie kunt oplossen doormiddel van een aantal Firewall >> Filter Rules.

Care4. CBS export. Productdocumentatie

Address Mapping Address Mapping regels:

Adhoc Testrapportage. Testrapportnummer: Leverancier: PerfectView B.V. Datum: :54:30 CET

Bancaire Infrastructurele Voorziening Aanleverservice. Implementatie conform koppelvlak WUS 2.0 Bedrijven

Transcriptie:

Key2Parkeren Koppelvlak Tijdelijke Kenteken Registratie

Product: Services: Key2Parkeren Koppelvlak Tijdelijke Kenteken Registratie Versie: 1.0 Datum: 10-10-2014 Status: Gepubliceerd Auteur: Netherlands, Public Sector Solutions, Belastingen

Inhoudsopgave Inhoudsopgave... 1 Versie historie... 4 Introductie... 5 Het koppelvlak Tijdelijke Kenteken Registratie... 6 Onderdelen van het Koppelvlak... 6 Overzicht... 6 Webservices... 6 Ophalen gegevens... 7 Ophalen plaatssoorten... 7 Productspecificaties... 8 Vergunningenvraag... 9 Vergunninggebied/Parkeerzone... 10 Vergunningaanvraag selectie... 10 Tijdelijke kenteken Registratie... 11 TKR vraag... 12 TKR aanvraag... 14 TKR wijziging... 16 Voorbeeldberichten...18 Vergunningenvraag... 18 Request opvragen actuele vergunningen o.b.v. type... 18 Response... 18 Request opvragen actuele vergunningen o.b.v. soort vergunning... 18 Response... 19 Tijdelijke kentekenregistratie... 20 TKR vraag... 20 Request... 20 Response... 20 TKR aanvraag... 20 Request... 20 Response... 21 TKR wijziging aanvraag... 21 Request... 21 Response met foutmelding... 22 Response bij goedgekeurd bericht... 22 Key2Parkeren, Koppelvlak Tijdelijke Kenteken Registratie 1.0

Key2Parkeren, Koppelvlak Tijdelijke Kenteken Registratie 1.0

Copyright 2014, Niets uit deze uitgave mag worden verveelvoudigd, opgeslagen in een geautomatiseerd gegevensbestand of openbaar gemaakt, in enige vorm of op enige wijze, hetzij elektronisch, mechanisch, door fotokopieën, opnamen of enige andere manier, zonder schriftelijke toestemming van Netherlands B.V Key2Parkeren, Koppelvlak Tijdelijke Kenteken Registratie 1.0

Introductie Versie historie Versie Datum Wijzigingen 1.0 2014-29-11 Key2Parkeren, Koppelvlak Tijdelijke Kenteken Registratie 1.0

Introductie Introductie De API bevat een aantal services voor het vastleggen of muteren van tijdelijke kenteken registraties in de applicatie Key2Parkeren De API bevat een aantal webservices: 1. Ophalen van gegevens die in meerdere services gevraagd worden, zoals prijs- en beschikbaarheidsinformatie of een overzicht van lopende producten 2. TKR (registratie tijdelijk kenteken) 3. Basisservice met operaties voor verwerken aanvragen, kentekenwijzigingen, verlengingen en beëindigingen Dit document specificeert de interactie tussen Key2Parkeren en Mid/Front-office door middel van de API Koppelvlak Tijdelijke Kenteken Registratie. Deze API is gebaseerd op XML. De XSD en WSDL van deze API kunnen worden opgevraagd bij de productmanager voor Key2Parkeren. Op de website wordt altijd de nieuwste versie van dit document gepubliceerd. Key2Parkeren, Koppelvlak Tijdelijke Kenteken Registratie 1.0

Versie Historie Het koppelvlak Tijdelijke Kenteken Registratie Onderdelen van het Koppelvlak Overzicht Het Koppelvlak is modulair opgebouwd en bestaat uit een aantal componenten en bijbehorende documentatie: 1 Webservices voor tijdelijke kentekenmutaties en het ophalen van gegevens De documentatie bestaat uit door het midoffice aan te roepen webservices, XSD s, WSDLS en deze beschrijving van het Koppelvlak. De XSD s en WSDL s kunnen worden opgevraagd bij de productmanager van Key2Parkeren Webservices Er zijn een aantal webservices: 1. Ophalen van gegevens die in meerdere services gevraagd worden 2. TKR (registratie tijdelijk kenteken) 3. Basisservice met operaties voor verwerken aanvragen, kentekenwijzigingen, verlengingen en beëindigingen De service genoemd onder 2 roept de basisservice aan.

Ophalen gegevens Web Service: IParkeerGegevens Target Namespace: http://www.centric.eu/key2parkeren/ Port parkeergegevensoap2_iparkeergegevens Service: Ppvsw005.svc Protocol: SOAP Transport protocol: SOAP over http Schema Ppvsw005.xsd Operations: 1. Plaatssoorten 2. Productspecificaties 3. Vergunningaanvraagselectie 4. Vergunningenvraag 5. Vergunninggebied Ophalen plaatssoorten Operation type: Request-response. The endpoint receives a message, and sends a correlated message. SOAP action: http://www.centric.eu/key2parkeren/iparkeergegevens/plaatssoortenrequest Niet nodig voor de TKR Request Request Bepaling plaatssoort(en) bij vergunningsoort gebruikerscode b.v. 344 of 1900 Number (4) vergunningsoort b.v. BNK of 1BW Varchar2(4) Response Response Lijst met plaatssoorten vergunningsoort b.v. BNK Varchar2(4) plaatssoort b.v. N of 4 Varchar2(2) Omschrijving 1plaatssoort b.v. vergunninghoudersplaats Varchar2(40) Omschrijving 2 plaatssoort b.v. woonwijk Varchar2(40)

Productspecificaties Operation type: Request-response. The endpoint receives a message, and sends a correlated message. SOAP action: http://www.centric.eu/key2parkeren/iparkeergegevens/productspecificatiesrequest Niet nodig voor de TKR Request Opvragen product specificaties *BSN/NAW volgens StUF-EF. Indien de aanvrager al bekend is in het systeem, dan volstaat het BSN, anders zijn ook de NAW gegevens nodig voor bepaling van het vergunning gebied en het vastleggen van het subject in de database gebruikerscode Number(4) productcategorie B.v. A of V of 20 Varchar2(6) Vergunning soort b.v. BNK of 1BW Varchar2(4) Ingangsdatum vergunning yyyymmdd Number(8) Response Vergunning soort b.v. BNK of 1BW Varchar2(4) productcategorie B.v. A of V of 20 Varchar2(6) Parkeerzone b.v. 1100 of 300100 Number(6) Beschikbaar op adres True of False boolean Beschikbaar in gebied True of False boolean Te betalen bedrag Volgens StUF-EF (dus in centen) AI Machtiging aanwezig True of False boolean Einddatum periode Einddatum eerste geldigheidsperiode Number(8)

Vergunningenvraag Operation type: Request-response. The endpoint receives a message, and sends a correlated message. SOAP action: http://www.centric.eu/key2parkeren/iparkeergegevens/vergunningaanvraagselectie Request Haalt de actuele vergunningen van een aanvrager op. Actuele vergunningen zijn vergunningen met de status BL, LV of WB waarvoor geldt dat deinde > systeemdatum EN die een vergunningregel hebben waarvoor geldt dat dingangperiode <= systeemdatum < deindeperiode (=een actuele vergunningregel) en iregel = P Request BSN Number(10) Gebruikerscode gebruikerscode voor de gemeente. Number(4) Indicatie type vergunning Indicatie bewoners of zakelijk B = bewoners en Z = zakelijk als vergunning soort leeg Varchar2(1) Vergunning soort Als Indicatie type is leeg Varchar2(4) Vergunningen kunnen opgevraagd worden op type (bewoners of zakelijk) of op soort vergunning Response Lijst met lopende vergunningen met de volgende elementen Vergunningnummer b.v. 23901 Number(9) Code Parkeerzone b.v. 1100 of 300100 Number(6) Omschrijving parkeerzone b.v. Havenkwartier of Delfgaauw Varchar2(50) Vergunning soort b.v. BNK Varchar2(4) Omschrijving soort vergunning b.v. Bewoners kwartaal Varchar2(40) Kenteken 1 b.v. 99-XX-XX of 99-XXX-9 enz. Varchar2(8) Kenteken 2 Kenteken 3 Varchar2(8) Varchar2(8) Kenteken tekst b.v. 4-DEXTER, HH 14DG 1 of Plasman BV Varchar2(20) Indicatie TKR mogelijk True of False boolean Einddatum geldigheid actuele periode yyyymmdd Toegestaan aantal dagen TKR TKR = tijdelijke kenteken registratie b.v. 5 Toegestaan aantal TKR per kalenderjaar b.v. 3 Aantal geregistreerde TKR lopend jaar b.v. 2 Eindtijd geldigheid actuele periode Betaalstatus vergunning hhmm 0 = niet betaald, 1 = betaling onderweg en 3 = betaling verwerkt Actuele Vergunningen worden opgehaald.

Informatie die in het antwoord teruggegeven wordt kan voor verschillende doeleinden gebruikt worden. Vergunninggebied/Parkeerzone Operation type: Request-response. The endpoint receives a message, and sends a correlated message. SOAP action: http://www.centric.eu/key2parkeren/iparkeergegevens/vergunninggebiedrequest Niet nodig voor de TKR Request bepalen parkeerzone BSN/NAW volgens StUF-EF als de persoon al bekend is volstaat het BSN Gebruikerscode gebruikerscode voor de gemeente., b.v. 1900 Number(4) Het antwoord geeft de code van de parkeerzone terug Response Key2Parkeren Code parkeerzone Parkeerzone( leeg wanneer aanvrager niet in een zone) Number(6) Vergunningaanvraag selectie Haalt op basis van het midoffice zaak- of referentienummer gegevens van een specifieke vergunning(aanvraag) op uit Key2Parkeren Niet nodig voor de TKR Request Vergunningaanvraag selectie Gebruikerscode b.v. 344 Number (4) Midoffice referentienummer b.v. ERdAg5 Varchar2 Response Key2Parkeren Vergunningnummer b.v. 45612 Number(9) Status vergunning b.v. LV of AB Varchar2(2) Zaaknummer Key2Parkeren b.v. 7181 Number(10) Geldig VANAF Yyyymmdd gevuld als status LV of WB Number(8) Geldig TOT Yyyymmdd gevuld als status LV of WB Number(8) Subjectnummer aanvrager b.v. 7363785 Number(10)

Tijdelijke kenteken Registratie Web Service: ITkr Target Namespace: http://www.centric.eu/key2parkeren/ Port BasicHttpBinding_ITkr Service: Ppvsw040.svc Protocol: SOAP Transport protocol: SOAP over HTTP Schema Ppvsw040.xsd Operations: 1. TKRvraag 2. TKRaanvraag 3. TKRwijzigingaanvraag Deze service wordt gebruikt voor het registreren of wijzigen van een tijdelijk kenteken worden ter vervanging van een permanent kenteken bij vergunninghouders met een parkeervergunning op kenteken Met deze service kan 1. een nieuwe TKR ( Tijdelijk Kenteken Registratie ) worden aangemaakt. 2. een al aanwezige TKR worden gewijzigd. TKR s zijn bedoeld voor digitale parkeerproducten; dit betekent dus dat TKR gebruikt wordt voor de bewonersvergunning op kenteken en dus niet voor de zakelijk vergunning. Er is maar één actuele of toekomstige TKR. Een tijdelijk kenteken van een parkeervergunning mag, per permanent kenteken, een begrenst aantal maal per kalenderjaar worden opgevoerd. Het aantal is instelbaar in de stuurgegevens en daarnaast ook in de vergunning (voor specifieke afwijkingen op vergunning niveau). Er wordt geen zaak vastgelegd in Key2Parkeren Een lopende TKR kan gewijzigd worden (er zijn wel beperkingen) Een lopende TKR kan 1. Per direct worden beëindigd 2. Kan een vroegere einddatum krijgen (dus eerder eindigen dan aanvankelijk gedacht) 3. Kan een latere einddatum krijgen 4. Kan een ander kenteken krijgen (in Key2Parkeren en het NPR betekent dit: (1) de bestaande TKR per direct beëindigen en (2) een direct aansluitend TKR/parkeerrecht voor het nieuwe kenteken registeren). Niet toegestane requests bij een lopende TKR: Wijziging van de ingangsdatum/tijd (want er is al parkeerrecht verstreken; de ingangsdatum/tijd is bij een lopende is gepasseerd)

TKR vraag Operation type: Request-response. The endpoint receives a message, and sends a correlated message. SOAP action: http://www.centric.eu/key2parkeren/itkr/tkrvraagrequest Haalt op basis van het vergunningnummer de daarbij geregistreerde TKR s op Request Gebruikerscode Number(4) Vergunningnummer vergunning nummer Number(9) Response Lijst met TKW voor vergunning met de volgende elementen Vergunningnummer Number(9) Volgnummer TKR volgnummer in K2P Number(4) Tijdelijk kenteken tijdelijke kenteken Varchar2(20) Permanent kenteken het permanente kenteken dat tijdelijk wordt vervangen Varchar2(20) Begindatum TKR YYYYMMDD Number(8) Begintijd TKR HHMM Number(4) Eindedatum TKR YYYYMMDD Number(8) Eindtijd TKR HHMM Number(4) Bij het terug geven door Key2Parkeren van de bij een vergunning vastgelegde TKR s geldt het volgende: Als een TKR functioneel is verwijderd (Begindatum/tijd = Einddatum/tijd) dan wordt deze niet geselecteerd/geretourneerd. Als meer TKR s betrekking hebben op hetzelfde tijdelijke kenteken en hetzelfde permanente kenteken, en de begindatum/tijd van de een is direct aansluitend aan de einddatum/tijd van de ander dan worden deze regels samengevoegd (deze verlengde regels tellen immers mee als één TKR; N.B.: Meerdere rijen in de TKR-tabel alleen als 1 geteld indien de totaalduur van de samen te voegen regels binnen de tolerantie van de in Key2Pakeren ingestelde maximum duur van een TKR valt) Voorbeeld Volgnr. Permanen t kenteken Tijdelijk kenteken 0001 35-TDJ-4 78-TBB- 1 0002 35-TDJ-4 NB-ZZ- 86 0003 35-TDJ-4 NB-ZZ- 86 Begindatum Einddatum Selecteren bij opvragen 31-12-2011 12:00 03-01-2012 17:00 06-02-2012 09:15 06-02-2012 09:15 07-02-2012 09:15 08-02-2012 17:00 J N J Telt niet

0004 35-TDJ-4 YJ-88- PK 0005 35-TDJ-4 11-05- BM 0006 35-TDJ-4 12-KVP- 5 0007 35-TDJ-4 12-KVP- 5 0008 35-TDJ-4 53-TFG- 4 0009 35-TDJ-4 35-TFG- 4 0010 36-XTR-5 11-05- BM 05-04-2012 10:00 05-04-2012 10:00 08-02-2012 18:00 12-02-2012 18:01 22-05-2012 14:15 23-05-2012 18:02 23-05-2012 18:02 25-05-2012 18:02 26-07-2012 18:00 28-07-2012 14:03 28-07-2012 14:03 29-07-2012 18:04 02-08_2012 15:45 03-08-2012 18:00 J J J N, is aansluitend! J J, is aansluitend maar met een ander tijdelijk kenteken J Tellen als één! Response resultaat 0001 35-TDJ-4 78-TBB- 1 0003 35-TDJ-4 NB-ZZ- 86 0004 35-TDJ-4 YJ-88- PK 0005 35-TDJ-4 11-05- BM 0006 35-TDJ-4 12-KVP- 5 0008 35-TDJ-4 53-TFG- 4 0009 35-TDJ-4 35-TFG- 4 0010 36-XTR-5 11-05- BM 31-12-2011 12:00 03-01-2012 17:00 07-02-2012 09:15 08-02-2012 17:00 05-04-2012 10:00 05-04-2012 10:00 08-02-2012 18:00 12-02-2012 18:01 22-05-2012 14:15 25-05-2012 18:02 26-07-2012 18:00 28-07-2012 14:03 28-07-2012 14:03 29-07-2012 18:04 02-08_2012 03-08-2012 15:45 18:00 Combi van 06 en 07

TKR aanvraag Operation type: Request-response. The endpoint receives a message, and sends a correlated message. SOAP action: http://www.centric.eu/key2parkeren/itkr/tkraanvraagrequest Voor het aanmelden van een nieuwe TKR wordt de volgende vraag aan Key2Parkeren gesteld: Request Vergunningnummer Volgnummer Number(9) Number(4) Permanent kenteken Permanente kenteken Varchar2(20) Tijdelijk kenteken Nieuw tijdelijk kenteken Varchar2(20) Landcode Internationale landcode, b.v. GB Varchar2(3) Begindatum TKR YYYYMMDD >= systeemdatum/tijd Number(8) Begintijd TKR HHMM Number(4) Eindedatum TKR YYYYMMDD > dbegin_tkr, > tbegin_tkr Number(8) Eindtijd TKR HHMM Number(4) Aanvraagnummer Aanvraagdatum Varchar2(255) Number(8) BSN BSN aanvrager Number(10) Gebruikerscode gebruikerscode voor de gemeente. Number(4) Midoffice referentienummer BetalingID Bedrag Betaalkenmerk Betaald bedrag in centen response Vergunningnummer Niet aanwezig als fout Number(9) TKR volgnummer Niet aanwezig als fout. Volgnummer in Key2Parkeren Number(4) Tijdelijk kenteken Niet aanwezig als fout Varchar2(20) Fouttype Geeft type weer (b.v. functioneel) Foutcode b.v. TKR1A Number(4) Foutomschrijving

Foutmeldingen Foutcodes 1 TKR1A TKR1B TKR2C Er is nog een lopende TKR, nieuwe TKR kan niet toegevoegd worden Er is in de TKR-periode (nog) geen parkeerrecht voor het permanente kenteken De einddatum/tijd ligt voor de begindatum Aanmaken van een TKR bij een vergunning betekent: Aanmaken vergunningregel Aanmaken nieuwe TKR regel Parkeerrechten o Afmelden van alle nog oude nog actuele parkeerrechten voor de betreffende vergunning op basis van de parkeerrecht-sleutel(s) per begindatum/tijd TKR, o Aanmelden parkeerrecht van het tijdelijke kenteken. per begindatum/tijd TKR, t/m einddatum/tijd TKR o Aanmelden direct aansluitende parkeerrecht van het aan permanente kenteken per einddatum/tijd TKR t/m datum/tijd=00:00:00 dat oorspronkelijk het parkeerrecht al was aangemeld.

TKR wijziging Operation type: Request-response. The endpoint receives a message, and sends a correlated message. SOAP action: http://www.centric.eu/key2parkeren/itkr/tkrwijzigingaanvraagrequest Bij het wijzigen van een TKR wordt onderscheid gemaakt tussen een geplande of een lopende TKR. Van en geplande is de startdatum/tijd nog niet aangebroken. Van een lopende is de startdatum/tijd wel aangebroken. (N.B.: Is de einddatum/tijd verstreken dan is geen wijziging meer mogelijk omdat er is geen sprake meer is van een geplande of lopende TKR: Begindatum/tijd en Einddatum/tijd zijn verstreken). Een lopende TKR is herkenbaar aan: Begindatum/tijd: verstreken Einddatum/tijd: niet verstreken Een lopende TKR kan gewijzigd worden (er zijn wel beperkingen) Een lopende TKR kan 1. Per direct worden beëindigd 2. Kan een vroegere einddatum krijgen (dus eerder beëindigen dan aanvankelijk gedacht) 3. Kan een latere einddatum (in Key2Parkeren en het NPR betekent dit: een tweede direct aansluitend TKR/parkeerrecht) 4. Kan een ander kenteken krijgen (in Key2Parkeren en het NPR betekent dit: de bestaande TKR per direct beëindigen en een tweede direct aansluitend TKR/parkeerrecht voor het nieuwe kenteken registeren) Niet toegestane requests bij een lopende TKR a. Wijziging van de ingangsdatum/tijd (want er is al parkeerrecht verstreken; de ingangsdatum/tijd is bij een lopende is gepasseerd) Een geplande TKR kan gewijzigd worden (er zijn wel beperkingen). Een geplande TKR is herkenbaar aan: Begindatum/tijd: niet verstreken (en natuurlijk is de Einddatum/tijd ook niet verstreken) Een geplande TKR kan: 1. Functioneel worden verwijderd; in Key2Parkeren en de NPR betekent dit dat de einddatum/tijd en de ingangsdatumtijd dezelfde waarde krijgen. 2. Van een geplande TKR kan worden gewijzigd a. Begindatum/tijd en/of b. Einddatum/tijd en/of c. Tijdelijk Kenteken In Key2Parkeren en de NPR betekent dit dat de oude wordt beëindigd, en een volledig nieuwe wordt opgevoerd.

Niet toegestane requests bij een geplande TKR: b. Als ingangsdatum/tijd = einddatum/tijd, dan is de TKR beëindigd en kan deze niet meer worden gewijzigd (er mag wel een nieuwe worden aangemaakt) Request Vergunningnummer Number(9) Volgnummer TKR volgnummer in Key2Parkeren Number(4) Tijdelijk kenteken NL kenteken /NILL Varchar2(20) Begindatum TKR YYYYMMDD / NILL Number(8) Begintijd TKR HHMM / NILL Number(4) Eindedatum TKR YYYYMMDD / NILL Number(8) Eindtijd TKR HHMM / NILL Number(4) Aanvraagnummer Aanvraagdatum Varchar2(255) Number(8) BSN BSN aanvrager Number(10) Gebruikerscode Midoffice referentienummer Number(4) Varchar2(20) BetalingID Bedrag Betaalkenmerk Bedrag in centen De response is hetzelfde als bij de TKR aanvraag

Voorbeeldberichten Vergunningenvraag Request opvragen actuele vergunningen o.b.v. type <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:key="http://www.centric.eu/key2parkeren"> <soapenv:header/> <soapenv:body> <key:vergunningenvraag> <key:bsn>043012180</key:bsn> <key:kgbr>1</key:kgbr> <key:ibewzak>b</key:ibewzak> </key:vergunningenvraag> </soapenv:body> </soapenv:envelope> Response <s:envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:body xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <Vergunningen xmlns="http:// www.centric.eu/key2parkeren"> <Vergunningantwoord> <Rvergunning>231983</Rvergunning> <Kgebied>5000</Kgebied> <Ogebied>WH82</Ogebied> <Ksrtvergunning>BNK</Ksrtvergunning> <Osrtvergunning>Bewonersvergunning kwartaal</osrtvergunning> <Kenteken>38-ZBD-1</Kenteken> <Tkr_mogelijk>true</Tkr_mogelijk> <Deindeperiode>20150101</Deindeperiode> <Adagen_duur_tkr>5</Adagen_duur_tkr> <A_tkr_kalender_jr>2</A_tkr_kalender_jr> <A_num_tkr>0</A_num_tkr> <Teindeperiode>0</Teindeperiode> <Kbetaling>1</Kbetaling> </Vergunningantwoord> </Vergunningen> </s:body> </s:envelope> Request opvragen actuele vergunningen o.b.v. soort vergunning <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:key="http://www.centric.eu/key2parkeren"> <soapenv:header/> <soapenv:body> <key:vergunningenvraag> <key:bsn>063013654</key:bsn> <key:kgbr>1</key:kgbr> <key:ksrtvergunning>bkw</key:ksrtvergunning>

</key:vergunningenvraag> </soapenv:body> </soapenv:envelope> Response <s:envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:body xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <Vergunningen xmlns="http://www.centric.eu/key2parkeren"> <Vergunningantwoord> <Rvergunning>315</Rvergunning> <Kgebied>100100</Kgebied> <Ogebied>Parkeergebied Centrum</Ogebied> <Ksrtvergunning>BKW</Ksrtvergunning> <Osrtvergunning>Bewonersvergunning kwartaal</osrtvergunning> <Kenteken>WW-22-AA</Kenteken> <Tkr_mogelijk>true</Tkr_mogelijk> <Deindeperiode>20130101</Deindeperiode> <Adagen_duur_tkr>5</Adagen_duur_tkr> <A_tkr_kalender_jr>2</A_tkr_kalender_jr> <A_num_tkr>0</A_num_tkr> <Teindeperiode>0</Teindeperiode> <Kbetaling>3</Kbetaling> </Vergunningantwoord> <Vergunningantwoord> <Rvergunning>317</Rvergunning> <Kgebied>100100</Kgebied> <Ogebied>Parkeergebied Centrum</Ogebied> <Ksrtvergunning>BKW</Ksrtvergunning> <Osrtvergunning>Bewonersvergunning kwartaal</osrtvergunning> <Kenteken>ZZ-00-BB</Kenteken> <Tkr_mogelijk>true</Tkr_mogelijk> <Deindeperiode>20150401</Deindeperiode> <Adagen_duur_tkr>5</Adagen_duur_tkr> <A_tkr_kalender_jr>2</A_tkr_kalender_jr> <A_num_tkr>0</A_num_tkr> <Teindeperiode>0</Teindeperiode> <Kbetaling>3</Kbetaling> </Vergunningantwoord> <Vergunningantwoord> <Rvergunning>344</Rvergunning> <Kgebied>100100</Kgebied> <Ogebied>Parkeergebied Centrum</Ogebied> <Ksrtvergunning>BKW</Ksrtvergunning> <Osrtvergunning>Bewonersvergunning kwartaal</osrtvergunning> <Kenteken>JJ-11-JJ</Kenteken> <Tkr_mogelijk>false</Tkr_mogelijk> <Deindeperiode>20150101</Deindeperiode> <Adagen_duur_tkr>5</Adagen_duur_tkr> <A_tkr_kalender_jr>2</A_tkr_kalender_jr> <A_num_tkr>2</A_num_tkr> <Teindeperiode>0</Teindeperiode> <Kbetaling>1</Kbetaling> </Vergunningantwoord> </Vergunningen> </s:body> </s:envelope>

Tijdelijke kentekenregistratie TKR vraag Request <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:key="http://www.centric.eu/key2parkeren"> <soapenv:header/> <soapenv:body> <key:tkrvraag> <key:kgbr>1</key:kgbr> <key:rvergunning>231968</key:rvergunning> </key:tkrvraag> </soapenv:body> </soapenv:envelope> Response <s:envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:body xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <Tkrs xmlns="http://www.centric.eu/key2parkeren"> <Rvergunning>231968</Rvergunning> <Rvolgnummer>1</Rvolgnummer> <Okenteken_tkr>44-RTF-2</Okenteken_tkr> <Okenteken_perm>44-RTF-4</Okenteken_perm> <Dbegin_tkr>20131130</Dbegin_tkr> <Tbegin_tkr>1149</Tbegin_tkr> <Deinde_tkr>20131130</Deinde_tkr> <Teinde_tkr>1151</Teinde_tkr> <Rvergunning>231968</Rvergunning> <Rvolgnummer>2</Rvolgnummer> <Okenteken_tkr>44-RTF-3</Okenteken_tkr> <Okenteken_perm>44-RTF-4</Okenteken_perm> <Dbegin_tkr>20140101</Dbegin_tkr> <Tbegin_tkr>1158</Tbegin_tkr> <Deinde_tkr>20140102</Deinde_tkr> <Teinde_tkr>1200</Teinde_tkr> </Tkrs> </s:body> </s:envelope> TKR aanvraag Request <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:key="http://www.centric.eu/key2parkeren"> <soapenv:header/> <soapenv:body> <key:tkraanvraag> <key:rvergunning>231978</key:rvergunning> <key:rvolgnummer>1</key:rvolgnummer> <key:okenteken_perm>45-ttr-8</key:okenteken_perm> <key:okenteken_tkr>35-hh-tt</key:okenteken_tkr>

<key:dbegin_tkr>20131230</key:dbegin_tkr> <key:tbegin_tkr>1200</key:tbegin_tkr> <key:deinde_tkr>20140101</key:deinde_tkr> <key:teinde_tkr>1230</key:teinde_tkr> <key:algemeen> <!--Optional:-- > <key:aanvraagnummer>kj-099</key:aanvraagnummer> <key:aanvraagdatum>20131228</key:aanvraagdatum> <key:bsn>159228803</key:bsn> <key:kgbr>1</key:kgbr> <key:oref>eref-0932</key:oref> <key:betalingid>4755</key:betalingid> <key:bedrag>2000</key:bedrag> </key:algemeen> </key:tkraanvraag> </soapenv:body> </soapenv:envelope> Response <s:envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:body xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <Tkr xmlns="http://www.centric.eu/key2parkeren"> <Rvergunning>231978</Rvergunning> <Rvolgnummer>1</Rvolgnummer> <Okenteken_tkr>35-HH-TT</Okenteken_tkr> </Tkr> </s:body> </s:envelope> TKR wijziging aanvraag Request <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:key="http://www.centric.eu/key2parkeren"> <soapenv:header/> <soapenv:body> <key:tkrwijzigingaanvraag> <key:rvergunning>231969</key:rvergunning> <key:rvolgnummer>1</key:rvolgnummer> <key:okenteken_tkr>55-dfr-3</key:okenteken_tkr> <key:dbegin_tkr>20140201</key:dbegin_tkr> <key:tbegin_tkr>1205</key:tbegin_tkr> <key:deinde_tkr>20140204</key:deinde_tkr> <key:teinde_tkr>1300</key:teinde_tkr> <key:algemeen>

<key:aanvraagnummer>tkr-0001</key:aanvraagnummer> <key:aanvraagdatum>20131228</key:aanvraagdatum> <key:bsn>159135576</key:bsn> <key:kgbr>1</key:kgbr> <key:oref>kj-4525</key:oref> <key:betalingid>12929</key:betalingid> <key:bedrag>2000</key:bedrag> </key:algemeen> </key:tkrwijzigingaanvraag> </soapenv:body> </soapenv:envelope> Response met foutmelding <s:envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:body> <s:fault> <faultcode>s:client</faultcode> <faultstring xml:lang="nl-nl">tkr1c</faultstring> <detail> <Foutbericht xmlns="http://www.centric.eu/key2parkeren" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <Fouttype>Functioneel</Fouttype> <Foutcode>TKR1C</Foutcode> <Foutomschrijving>Aangeleverde begindatum/tijd TKR moet groter/gelijk systeemtijd zijn</foutomschrijving> </Foutbericht> </detail> </s:fault> </s:body> </s:envelope> Response bij goedgekeurd bericht <s:envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:body xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <Tkr xmlns="http://www.centric.eu/key2parkeren"> <Rvergunning>231969</Rvergunning> <Rvolgnummer>1</Rvolgnummer> <Okenteken_tkr>55-DFR-3</Okenteken_tkr> </Tkr> </s:body> </s:envelope>