KEY2PARKEREN. Koppeling Tradelec

Transcriptie

1 KEY2PARKEREN Koppeling Tradelec

2 Product: Koppeling: Key2Parkeren Bestandskoppeling Tradelec Versie: 1.0 Datum: Status: Gepubliceerd Auteur: Centric Netherlands, Public Sector Solutions, Belastingen Gepubliceerd,

3 Inhoudsopgave Inhoudsopgave... 3 Versie historie... 4 Introductie... 5 Bestandskoppeling... 6 Interface van 'KEY2PARKEREN' naar 'Tradelec'... 6 Recordtype; interface van 'KEY2PARKEREN' naar 'Tradelec'... 6 Bestandsnaam; interface van 'KEY2PARKEREN' naar 'Tradelec'... 7 Bestandsindeling; interface van 'KEY2PARKEREN' naar 'Tradelec' 7 Interface van 'Tradelec' naar 'KEY2PARKEREN' Recordtype; interface van 'Tradelec' naar 'KEY2PARKEREN' Bestandsnaam; interface van 'Tradelec' naar 'KEY2PARKEREN' Bestandsindeling; interface van 'Tradelec' naar 'KEY2PARKEREN' Copyright 2015, 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 Centric Netherlands B.V Gepubliceerd,

4 Versie historie Versie Datum Wijzigingen Gepubliceerd,

5 Introductie De pakketten KEY2PARKEREN van Centric Public Sector Solutions en Tradelec van Tradelec International N.V. kunnen door middel van interface-bestanden met elkaar communiceren. Hierbij is sprake van een tweetal interfaces: Interface van KEY2PARKEREN naar Tradelec Met deze gegevens kunnen de handterminals worden gevoed met te onderkennen automerken, tarieven, parkeerlokaties, controleurs, op te merken voertuigen (eventueel gecombineerd met uitgegeven parkeervergunningen), etc.. Interface van Tradelec naar KEY2PARKEREN KEY2PARKEREN wordt gevoed met geconstateerde fiscale-parkeerfeiten en optioneel Mulder-parkeerfeiten. De Fiscale-feiten worden geïnd door KEY2PARKEREN. De Mulder-feiten worden (optioneel) aangeleverd om opgenomen te kunnen worden in management-rapportages. Mulder-feiten worden in standaard KEY2PARKEREN verder niet verwerkt. De beschreven interface betreft de standaard-versies van beide pakketten. In de beide interfaces is een aantal velden opgenomen dat wel wordt aangeleverd maar (vooralsnog) niet wordt uitgelezen door het ontvangende programma: Soms wordt meer informatie aangeleverd dan strikt noodzakelijk! Gepubliceerd,

6 Bestandskoppeling Interface van 'KEY2PARKEREN' naar 'Tradelec' Doel: Tradelec voeden met basisgegevens waardoor met behulp van de handterminal zowel Fiscale-parkeerfeiten als Mulder-parkeerfeiten kunnen worden geregistreerd! Het interface bestand is een ASCII-bestand; het bestand bestaat uit records van 350 posities. N.b.: Voor dit ASCII-bestand geldt dat: - Lege regels zijn toegestaan Regels die beginnen met ';' zijn commentaarregels Het 'Tradelec'-programma dat het bestand inleest slaat dergelijke regels over tijdens het verwerken. Recordtype; interface van 'KEY2PARKEREN' naar 'Tradelec' Op positie '1'en '2' wordt altijd het 'recordtype' weergegeven. Per 'recordtype' is de indeling afwijkend! De onderstaande recordtypen worden onderkend in het ASCII-interface bestand: 01 Voorlooprecord (één per bestand). 10 Kleur ('0' of meer per bestand) 11 Voertuig ('0' of meer per bestand) 12 Merk ('0' of meer per bestand) 13 Land ('0' of meer per bestand) 16 Controleur ('0' of meer per bestand) 17 Controleur nieuw ( 0 of meer per bestand) 20 Feitcategorie code ('0' of meer per bestand) 21 Feittoelichtingen Mulder ('0' of meer per bestand) 22 Feiten Mulder ('0' of meer per bestand) 23 Feittoelichtingen Fiscaal ('0' of meer per bestand) 24 Feiten Fiscaal ('0' of meer per bestand) 30 Code reden op te merken voertuig ('0' of meer per bestand) 31 Op te merken voertuigen ('0' of meer per bestand) 40 Seponeercode ('0' of meer per bestand) 50 Wijk ('0' of meer per bestand) 51 Parkeerlokatie ('0' of meer per bestand) 52 Parkeerobject ('0' of meer per bestand) 61 Plaats ('0' of meer per bestand) 62 Gemeente ('0' of meer per bestand) 99 Sluitrecord (één per bestand) Gepubliceerd,

7 N.b.: Categorie-B wordt niet aangeleverd door KEY2PARKEREN aan de handterminalapplicatie! Altijd wordt een volledige set van gegevens aangeleverd aan Tradelec (er worden dus niet enkel mutaties verzonden, maar nadat slechts één kleur is toegevoegd worden alle onderkende kleuren aangeleverd.). De onderstaande sets worden onderkend: - Kleur ( recordtype 10) - Voertuigsoort (11) - Merk (12) - Land (13) - Controleur (16) en Controleur nieuw (17) - Feiten en tarieven (Combinatie van 20, 21, 22, 23, 24, 25, 62) - Op te merken voertuigen (Combinatie van 30, 31) - Seponeercodes (40) - Parkeerlokaties, parkeerobjecten en tarieven (Combinatie van 50, 51, 52, 61, 62) Bestandsnaam; interface van 'KEY2PARKEREN' naar 'Tradelec' De bestandsnaam bestaat uit een datum en een volgnummer; bestanden worden niet overschreven(theoretisch maximum van 99 bestanden op één dag)! Bijvoorbeeld: TBL Aangemaakt op 22 mei 2000; eerste file TBL Aangemaakt op 22 mei 2000; tweede file op deze dag TBL Aangemaakt op 22 mei 2001; eerste file TBL Aangemaakt op 22 mei 2011; eerste file (N.b.: Het verwerkingsprogramma van Tradelec heeft geen eeuwaanduiding nodig!) In de padentabel van Key2Parkeren is (door de gebruiker zelf) vastgelegd in welke directory de interface-bestanden moeten worden geplaatst! Bestandsindeling; interface van 'KEY2PARKEREN' naar 'Tradelec' Interface bestand: VOORLOOP RECORD 1-2 '01' (N2) 3 'leeg' (A1) 4-8 KEY2PARKEREN (A5) 9 'leeg' (A1) 'TRDLC' (A5) 15 'leeg' (A1) 'Versie-nr.' (N10) 'Datum gegevens' (N8) eejjmmdd 'Aanmaakdatum bestand' (N8) eejjmmdd 'Aanmaaktijd bestand' (N6) uummss 'Filler' Gepubliceerd,

8 Interface bestand: KLEUR 1-2 '10' (N2) 3-4 'KEY2PARKEREN-Kleurcode' (A2) 5-19 'Kleuromschrijving' (A15) 'Tobias-kleurcode' (A6) Filler Fas (A2) Prioriteitscode (N3) [Niet verplicht] 'Filler' Gesorteerd op 'Kleuromschrijving'! Interface bestand: VOERTUIG 1-2 '11' (N2) 3-4 'KEY2PARKEREN-Voertuigcode' (A2) 5-19 'Voertuigomschrijving' (A15) 'Tobias-voertuigcode' (A2) Filler Fas (A2) Prioriteitscode (N3) [Niet verplicht] 'Filler' Gesorteerd op 'Voertuigomschrijving' Interface bestand: MERK 1-2 '12' (N2) 3-4 'KEY2PARKEREN-Merkcode' (A2) 5-19 'Merknaam-kort' (A15) 'Tobias-merkcode' (A20) Filler Fas (A4) 'Filler' Gesorteerd op 'Merknaam-kort' Interface bestand: LAND 1-2 '13' (N2) 3-5 'KEY2PARKEREN/TOBIAS-Landcode' (A3) 6-20 'Omschrijving-kort' (A15) 'Omschrijving-lang' (A40) 'Filler Fas (A4) 65 'Voorkeurcode' (A1) 'Filler' Gesorteerd op 'landcode'. Gepubliceerd,

9 Interface bestand: CONTROLEUR 1-2 '16' (N2) 3-7 'Personeelsnummer' (N5) 8-32 'Achternaam' (A25) 33 'Fiscaal/Mulder/Beide (F/M/B) (A1) 'Geboortedatum' (A8) eejjmmdd 42 'Eed of belofte (E/B)' (A1) 43 'Aant. letters wachtwoord' (N1) exclusief spaties 'Wachtwoord' (N12) wachtwoord is gecodeerd Filler Gesorteerd op 'Personeelsummer'. Interface bestand: CONTROLEUR NIEUW 1-2 '17' (N2) 3-8 'Personeelsnummer' (A6) 9-33 'Achternaam' (A25) 34 'Fiscaal/Mulder/Beide (F/M/B) (A1) 'Geboortedatum' (A8) eejjmmdd 43 'Eed of belofte (E/B)' (A1) 44 'Aant. letters wachtwoord' (N1) exclusief spaties 'Wachtwoord' (N12) wachtwoord is gecodeerd Filler Gesorteerd op 'Personeelsummer'. Wijziging tbv 6-cijferig verbalisantnummer (Itil ) Voor de vulling van het controleursnummer geldt het volgende. Bij een lengte =<5 worden derecordsoorten 16 en 17 gevuld. Heeft het controleursnummer een lengte van 6 dan wordt alleen de recordsoort 17 gevuld. Codering wachtwoord: Wijze van omcoderen: Database-waarde = Decimale code Voorbeeld: FIETS = ' FIET = ' HJK = Niet toegestaan (te kort) FIETS = Niet toegestaan (spatie alleen op twee laatste posities toegestaan) FI ETS = Niet toegestaan Het binnen KEY2PARKEREN vast te leggen wachtwoord kent een minimale lengte van 4 posities en een maximale lengte van 6 posities. Gepubliceerd,

10 Aangezien de spaties die op positie 5 en 6 staan ook omgecodeerd worden zal het aan tradelec aan te leveren wachtwoord altijd een lengte hebben van 12 posities. Overzicht van toegestane karakters en de gerelateerde decimale code: Karakter Decimale code A 65 B 66 C 67 D 68 E 69 F 70 G 71 H 72 I 73 J 74 K 75 L 76 M 77 N 78 O 79 P 80 Q 81 R 82 S 83 T 84 U 85 V 86 W 87 X 88 Y 89 Z space 32 Gepubliceerd,

11 Interface bestand: FEITCATEGORIE CODE (Wordt niet verwerkt in standaard Tradelec) 1-2 '20' (N2) 3-5 'Filler Feitcategorie code' (A3) 6-65 'Filler Feitcategorie omschr.' (A60) 'Filler' Gesorteerd op 'Feitcategorie code' N.b.: Het standaard programma van Tradelec zal de feitcategorie code negeren. Deze gegevens worden vanuit KEY2PARKEREN (indien aldaar gevuld) wel doorgegeven in de interface naar Tradelec. Recordtype 20' zal echter genegeerd worden wanneer de KEY2PARKERENgegevens binnen Tradelec worden verwerkt. Interface bestand: FEITTOELICHTINGEN-MULDER 1-2 '21' (N2) 3-10 'Feitcode (A8) 'Volgnummer' (N2) Gevuld met de waarden 1 t/m 'Omschrijving' (A120) Prioriteitscode (N3) (Voorlopig altijd gevuld met 000) Omschrijving-kort (A45) NOG NIET GEREALISEERD! 'Filler' Gesorteerd op 'Feitcode', 'Volgnummer' Interface bestand: FEITEN-MULDER 1-2 '22' (N2) 3-10 'Feitcode' (A8) Omschrijving kort (A45) 'Feitcategorie-code (A3) 'Schikkingsbedrag HFL' (N8) in centen 'Schikkingsbedrag EURO (N8) in centen Categorie indeling B (A1) Prioriteitscode (N3) [Niet verplicht] 'Omschrijving lang' (A210) Filler Gesorteerd op 'Feitcode' Interface bestand: FEITTOELICHTINGEN FISCAAL 1-2 '23' (N2) 3-10 'Feitcode (A8) 'Volgnummer' (N2) Gevuld met de waarden 1 t/m 'Omschrijving' (A120) Prioriteitscode (N3) (Voorlopig altijd gevuld met 000) Gepubliceerd,

12 Omschrijving-kort (A45) NOG NIET GEREALISEERD! 'Filler' Gesorteerd op 'Feitcode', 'Volgnummer' Interface bestand: FEITEN-FISCAAL 1-2 '24' (N2) 3-10 'Feitcode' (A8) 'Omschrijving kort' (A45) Prioriteitscode (N3) [Niet verplicht] Omschrijving lang (A210) 'Filler' Gesorteerd op 'Feitcode' Interface bestand: CODE REDEN OP TE MERKEN VOERTUIG 1-2 '30' (N2) 3-6 'Code reden' (A4) 7-46 'Omschrijving' (A40) 'Filler' Gesorteerd op 'Code reden' Interface bestand: OP TE MERKEN VOERTUIGEN 1-2 '31' (N2) 3-14 'Kenteken' (A12) Nederlands: zonder spatie/streepjes Buitenland: optioneel spatie/streepjes 'Code reden' (A4) 'Land/parkeervergunning-sector' (A24) Landomschrijving; bij Nederland leeg, Indien vergunning dan Sectornaam ; Niet verplicht Datum ingang (N8) eejjmmdd Datum einde (N8) eejjmmdd; niet verplicht Merk/Productnummer (A40) Merkomschrijving (alfanumeriek) c.q. Productnummer (numeriek) (= vergunningnummer ) Voorloopnullen zijn toegevoegd Bijv start op positie 59 (tot en met 67)! Niet verplicht Filler Gesorteerd op 'Kenteken' Gepubliceerd,

13 N.B.: In op te merken voertuigen kunnen(ook) alle lopende parkeervergunningen en parkeerontheffingen zijn opgenomen! Interface bestand: SEPONEERCODE VAN DE HANDTERMINAL 1-2 '40' (N2) 3-5 'Seponeercode' (A3) 6-45 'Omschrijving' (A40) Prioriteitscode (N3) 'Filler' Gesorteerd op 'Seponeercode' Interface bestand: WIJK 1-2 '50' (N2) 3-8 'Wijkcode' (N6) 9-58 'Omschrijving' (A50) 'Filler' Gesorteerd op 'omschrijving' Interface bestand: PARKEERLOKATIE 1-2 '51' (N2) 3-12 'Parkeerlokatiecode (A10) synoniem: segment code 'Omschrijving-kort (A15) Niet verplicht 'Straat-naam' synoniem J (A24) Tobias-schrijfwijze bijvoorbeeld:. HAGENGRACHT 'Wijk-code' (N6) Niet verplicht 'Plaatscode' (N6) Niet verplicht; verplicht voor TOBIAS 'Gemeentecode' (N4) 'Uurparkeertarief HFL' (N8) In centen, verplicht gevuld; bij 'Mulder-lokaties' gevuld met: 'Uurparkeertarief EURO' (N8) In centen Omschrijving-lang (N50) Maximale lengte is 50; de lengte van de tekst in het omschrijvingsveld is instelbaar! Bijvoorbeeld: Hagengracht-Noord) Aantal P-plaatsen (N4) Niet verplicht Default feitcode (A8) Niet verplicht Filler Gesorteerd op 'Parkeerlokatie-omschrijving' Gepubliceerd,

14 Interface bestand: PARKEEROBJECT 1-2 '52' 3-12 'Parkeerobjectcode (A10) 'Omschrijving (A40) 'Parkeerlokatiecode (A10) Filler Gesorteerd op 'Parkeerobjectcode' Interface bestand: WOONPLAATS 1-2 '61' (N2) 3-8 'Plaatscode' (N6) 9-58 'Omschrijving' (A50) 'Filler' Gesorteerd op 'Omschrijving' N.b.: In Adressen is het optioneel (dus niet verplicht) om een straat in te delen in een gebied 'WOONPLAATS'. Een straat valt in Adressen per definitie wel binnen een 'gemeente'! Indien voor de verwerking van Mulder-feiten wordt gekoppeld met Tobias is woonplaats wél verplicht! Interface bestand: GEMEENTE 1-2 '62' (N2) 3-6 'Gemeentecode' (N4) 7-46 'Omschrijving' (A40) 'Kosten naheffing HFL' (N8) in centen 'Kosten naheffing EURO (N8) in centen 'Kosten klemmen HFL' (N8) in centen 'Kosten klemmen EURO (N8) in centen Prioriteitscode (N3) (Voorlopig altijd gevuld met 000) 'Filler' Gesorteerd op 'Omschrijving' Interface bestand: SLUITRECORD 1-2 '99' (N2) 3-7 'EINDE' (A5) 'Filler Gepubliceerd,

15 Interface van 'Tradelec' naar 'KEY2PARKEREN' Doel: KEY2PARKEREN voeden met zowel geconstateerde Fiscale-parkeerfeiten als geconstateerde Mulder-parkeerfeiten vanuit het systeem Tradelec. N.b.: De interface van Tradelec naar KEY2PARKEREN is identiek aan de interface Eltrapol naar KEY2PARKEREN. Het interface bestand is een ASCII-bestand; het bestand bestaat uit records met een lengte van 500 posities. N.b.: Voor dit ASCII-bestand geldt dat: - Lege regels zijn niet toegestaan - Commentaarregels zijn niet toegestaan. - Een naheffingsaanslag c.q. aankondiging van beschikking mag slechts éénmaal worden aangeleverd! Recordtype; interface van 'Tradelec' naar 'KEY2PARKEREN' Op positie '1'en '2' wordt altijd het 'recordtype' weergegeven. Per 'recordtype' is de recordindeling afwijkend! De onderstaande recordtypen worden onderkend in het ASCII-interface bestand: 01 Voorlooprecord (één per bestand). 15 Geconstateerde feiten (één of meer per bestand) 99 Sluitrecord (één per bestand) Bestandsnaam; interface van 'Tradelec' naar 'KEY2PARKEREN' De bestandsnaam bestaat uit een datum en een volgnummer; bestanden worden niet overschreven (theoretisch maximum van 99 bestanden op een dag)! Bijvoorbeeld: B4U Aangemaakt op 22 mei 2000; eerste file B4U Aangemaakt op 22 mei 2000; tweede file op deze dag B4U Aangemaakt op 22 mei 2001; eerste file B4U Aangemaakt op 22 mei 2011; eerste file In de padentabel van KEY2PARKEREN is (door de gebruiker) vastgelegd in welke directory de te verwerken interface-bestanden zijn geplaatst! Gepubliceerd,

16 Bestandsindeling; interface van 'Tradelec' naar 'KEY2PARKEREN' Interface bestand: VOORLOOP RECORD 1-2 '01' (N2) 3 'leeg' (A1) 4-8 TRDLC (A5) 9 'leeg' (A1) 'KEY2PARKEREN' (A5) 15 'leeg' (A1) 'Versie-nr.' (N10) 'Filler' (A8) 'Aanmaakdatum bestand' (N8) eejjmmdd 'Aanmaaktijd bestand' (N6) uummss 'Filler' Interface bestand: GECONSTATEERDE FEITEN 1-2 '15' (N2) 3-10 'Datum constatering' (N8; eejjmmdd) 'Tijdstip constatering' (N4; uumm) Personeelsnr..controleur (N5) Parkeerlokatiecode (A10) [Niet verplicht] TOBIAS-voertuigcode (A2) KEY2PARKEREN-TOBIAS-Landcode (A3) Kenteken (A12 Nederland: zonder spatie en streepjes; Buitenland: 3-12 posities; optioneel met spaties en streepjes) TOBIAS-merkcode (A20) TOBIAS-kleurcode (A6) 73 Categorie-indeling-B (A1) Feit (A8) Bedrag HFL (N8; in centen) Betreft beschikkingsbedrag (Mulder-feit) c.q. Naheffingsbedrag (Fiscaal-feit) Bedrag EURO (N8; in centen); [Niet verplicht] Uurtarief HFL fiscaalfeit (N8; in centen) [Niet verplicht] Uurtarief EURO fiscaalfeit (N8; in centen); [Niet verplicht] Kosten klemmen HFL (N8; in centen); [Niet verplicht] Kosten klemmen EURO (N8; in centen); [Niet verplicht] 130 Ind. wegsleepwaardig (A1; toegestane waarde J, N ) 131 Ind. weggesleept (A1; toegestane waarde J, N ) 132 Ind wielklem aangebracht (A1; toegestane waarde J, N ) Opmerking1' (A120); toelichting bij feit [Niet verplicht] Opmerking2' (A120); vrije invoer [Niet verplicht] 373 Ind. geseponeerd (A1; toegestane waarde J, N ) Gepubliceerd,

17 Datum seponering (N8; eejjmmdd) [Niet verplicht] Tijdstip seponering' (N4; uumm) [Niet verplicht] Parkeerobjectnummer (A10) [Niet verplicht] Pandnummer (A6) [Niet verplicht] Naheffingsnummer (N10; uniek bij fiscale-feiten, indien Mulder-feit dan 0 Het Tradelec naheffingsnummer bestaatuit: - Jaarnummer (4) - Handterminalnummer (2) - Volgnummer (4))) Tobias-Straat-omschrijving (A25) [Niet verplicht] Gemeentecode (N6) [Niet verplicht] Omschrijving auto type (A10) [Niet verplicht] Adresverfijning (A20) [Niet verplicht] Seponeercode (A3) [Niet erplicht] Controleurnummer nieuw (A6) Filler N.b.: - Straat-omschrijving en Parkeerlokatiecode mogen niet beiden leeg zijn!! - Fiscale-bonnen hebben altijd een gevulde parkeerlokatiecode; bij mulder-bonnen is dit niet verplicht. - Mulder-bonnen hebben altijd een gevulde TOBIAS-straat-omschrijving. - Als zowel pandnummer als adresverfijning zijn gevuld, dan wordt alleen de adresverfijning verwerkt binnen KEY2PARKEREN. - Voor de vulling van het controleursnummer geldt het volgende. Bij een lengte =<5 worden de posities en gevuld. Heeft het controleursnummer een lengte van 6 dan wordt alleen positie gevuld. Interface bestand: SLUITRECORD 1-2 '99' (N2) 3-7 'EINDE' (A5) 'Filler Key2Parkeren, Bestandskoppeling Eltratax 1.0 Gepubliceerd 17