Interface beschrijving v6.1 - Nationaal Parkeer Register

Interface beschrijving v6.1 - Revisie toelichting
Interface description v6.1 - Revision history
Versie:
Datum:
3 B 1616e
31 juli 2014
Revisie van de XML interface van het Nationaal Parkeer Register
De volgende wijzigingen in versie 6.1 zijn geïntroduceerd ten opzichte van de vorige versie 6.0 van
de XML interface van het Nationaal Parkeer Register (NPR):























Soap XML Voorbeelden zijn verwijderd en vervangen door één voorbeeldrequest per XML
bericht waar alle (optionele) velden in zitten.
De alinea’s van de “Message dialogues” zijn opnieuw gerangschikt voor een meer
chronologische uitleg.
Alle XML elementen van de requests en de responses zijn beschreven in de message dialogues.
In paragraaf 2.2 de tabel met gebruiksdoelen van Amsterdam verwijderd. Tevens toegelicht dat
een gebiedsbeheerder zelf gebruiksdoelen kan opvoeren als dit noodzakelijk is.
Paragraaf 2.7 tekstueel aangepast en het adres van de XSD aangepast.
In hoofdstuk 3 toegevoegd dat providers de mogelijkheid hebben om het bericht
RetrieveRightInfoForProvider te gebruiken en dat NPR berichten gebruik maken van UTC tijden.
In paragraaf 4.1.1. toegevoegd dat tijdsvensters met lokale tijd moeten worden opgemaakt.
In paragraaf 4.1.1. en 4.2.1. een extra button beschreven waarin een aangepaste eindtijd op kan
treden.
In paragraaf 4.3.1 de volgende tekst verwijderd: "In this version of the NPR interface the request
message has the following change: ‰ Indicator time (IndicatorTime) is optional because it only
has to be provided in combination with
a vehicle identification or a disabled person’s parking card identification (VehicleId)."
Deze informatie was dubbel beschreven.
In paragraaf 4.3.1 de alinea verwijderd met daarin de uitleg dat met een indicator time alle
rechten binnen 24 uur worden opgehaald. Bij een RetrieverightInfoForProvider bestaat geen
Indicator time, maar een start en een eindtijd.
In paragraaf 5.1.1 tekst toegevoegd over het bevragen van GPK.
In paragraaf 6.1.1 tekst toegevoegd over het bevragen van GPK.
In paragraaf 6.2.1 tekst toegevoegd over het bevragen van GPK.
In paragraaf 7.1.1 alinea toegevoegd over PIN identificatie.
Ook toegevoegd dat rechtverwervers geautoriseerd moeten worden om een CalculatePrice uit
te voeren voor een gebied.
De tekst: "If price calculation fails because of an internal system error (e.g. calculation
parameters are set incorrectly), the rights acquirer will receive an error message" verwijderd.
In paragraaf 7.2.1 alinea toegevoegd over PIN identificatie.
In paragraaf 7.3.1 Tekst aangepast dat het bericht voor alle entiteiten kan worden gebruikt.
In paragraaf 7.4.1 alinea toegevoegd over PIN identificatie.
Beschrijving van ClaimRightPossible aangepast in Annex A. Deze indicator geeft aan of PSRight’s
geldig zijn, maar beperkt niet om deze vast te leggen.
Remark type 3 toegevoegd aan Annex B.
Foutcode 116 en 127 + Fout-oms toegevoegd aan Annex C.
Foutcode 115 verwijderd uit Annex C. Deze treed niet meer op in verband met een bugfix in de
resendprogrammatuur.
Annex D verwijderd.
Taal- en grammaticafouten hersteld.
3 B 1616e Interface beschrijving v6.1 - Revisie toelichting
3 B 1616e Interface description v6.1 - Revision history
1
Revision of the XML Interface of the Nationaal Parkeer Register
The following changes have been introduced in version 6.1 as compared to the previous version 6.0
of the XML Interface Description of the Nationaal Parkeer Register (NPR):























All SOAP XML examples have been removed and replaced with one example request message
for each XML message, in which all (optional) fields are present.
The paragraphs pertaining to the “Message dialogues” have been reordered for a more
chronological explanation.
All XML elements of the requests and responses have been described in the message dialogues.
In paragraph 2.2 the table with usage IDs of Amsterdam has been removed. It has been added
that area managers can add their own usage IDs if necessary.
Paragraph 2.7 has been textually changed and the XSD address has been changed.
In chapter 3 it has been added that NPR messages make use of UTC times.
In paragraph 4.1.1 it has been added that time windows have to be used with local times.
In paragraph 4.1.1 and 4.2.1 an extra item has been described about when an adjusted end time
can occur.
In paragraph 4.3.1 the following text has been removed: "In this version of the NPR interface the
request message has the following change: ‰ Indicator time (IndicatorTime) is optional because
it only has to be provided in combination with a vehicle identification or a disabled person’s
parking card identification (VehicleId)." This information was described twice.
In paragraph 4.3.1 the part explaining that with an indicator time all rights within 24 hour are
obtained, has been removed. For the RetrieveRightInfoForProvider message there is no Indicator
Time option, but a start and end time have to be provided.
In paragraph 5.1.1 a text has been added about the usage of GPK.
In paragraph 6.1.1 a text has been added about the usage of GPK.
In paragraph 6.2.1 a text has been added about the usage of GPK.
In paragraph 7.1.1 a paragraph has been added about PIN identification. Besides this, a remark
has been added that rights acquirers need to be authorized to be able to use the CalculatePrice
message in an area.
The text "If price calculation fails because of an internal system error (e.g. calculation
parameters are set incorrectly), the rights acquirer will receive an error message" has been
removed.
In paragraph 7.2.1 a paragraph has been added about PIN identification.
In paragraph 7.3.1 the text that the message can be used by all entities has been changed.
In paragraph 7.4.1 a paragraph has been added about PIN identification.
The description of ClaimRightPossible has been changed in Annex A. This indicator states
whether a PSRight is valid, not whether it can be obtained or not.
Remark type 3 has been added to Annex B.
Error codes 116 and 127 and descriptions have been added to Annex C.
Errorcode 115 has been removed from Annex C. This errorcode doesn’t appear because of a
bugfix in the resend software.
Annex D has been removed.
Spelling and grammar errors have been removed.
3 B 1616e Interface beschrijving v6.1 - Revisie toelichting
3 B 1616e Interface description v6.1 - Revision history
2

Download Report