KEY2PARKEREN Koppeling Tradelec
Product: Koppeling: Key2Parkeren Bestandskoppeling Tradelec Versie: 1.0 Datum: 05-01-2015 Status: Gepubliceerd Auteur: Centric Netherlands, Public Sector Solutions, Belastingen Gepubliceerd, 05-01-2015 2
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'... 15 Recordtype; interface van 'Tradelec' naar 'KEY2PARKEREN'... 15 Bestandsnaam; interface van 'Tradelec' naar 'KEY2PARKEREN'... 15 Bestandsindeling; interface van 'Tradelec' naar 'KEY2PARKEREN'... 16 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, 05-01-2015 3
Versie historie Versie Datum Wijzigingen 1.0 05-01-2015 Gepubliceerd, 05-01-2015 4
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, 05-01-2015 5
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, 05-01-2015 6
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: -00052201.TBL Aangemaakt op 22 mei 2000; eerste file -00052202.TBL Aangemaakt op 22 mei 2000; tweede file op deze dag -01052201.TBL Aangemaakt op 22 mei 2001; eerste file -11052201.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) 10-14 'TRDLC' (A5) 15 'leeg' (A1) 16-25 'Versie-nr.' (N10) 26-33 'Datum gegevens' (N8) eejjmmdd 34-41 'Aanmaakdatum bestand' (N8) eejjmmdd 42-47 'Aanmaaktijd bestand' (N6) uummss 48-350 'Filler' Gepubliceerd, 05-01-2015 7
Interface bestand: KLEUR 1-2 '10' (N2) 3-4 'KEY2PARKEREN-Kleurcode' (A2) 5-19 'Kleuromschrijving' (A15) 20-25 'Tobias-kleurcode' (A6) 26-27 Filler Fas (A2) 28-30 Prioriteitscode (N3) [Niet verplicht] 31-350 'Filler' Gesorteerd op 'Kleuromschrijving'! Interface bestand: VOERTUIG 1-2 '11' (N2) 3-4 'KEY2PARKEREN-Voertuigcode' (A2) 5-19 'Voertuigomschrijving' (A15) 20-21 'Tobias-voertuigcode' (A2) 22-23 Filler Fas (A2) 24-26 Prioriteitscode (N3) [Niet verplicht] 27-350 'Filler' Gesorteerd op 'Voertuigomschrijving' Interface bestand: MERK 1-2 '12' (N2) 3-4 'KEY2PARKEREN-Merkcode' (A2) 5-19 'Merknaam-kort' (A15) 20-39 'Tobias-merkcode' (A20) 40-43 Filler Fas (A4) 44-350 'Filler' Gesorteerd op 'Merknaam-kort' Interface bestand: LAND 1-2 '13' (N2) 3-5 'KEY2PARKEREN/TOBIAS-Landcode' (A3) 6-20 'Omschrijving-kort' (A15) 21-60 'Omschrijving-lang' (A40) 61-64 'Filler Fas (A4) 65 'Voorkeurcode' (A1) 66-350 'Filler' Gesorteerd op 'landcode'. Gepubliceerd, 05-01-2015 8
Interface bestand: CONTROLEUR 1-2 '16' (N2) 3-7 'Personeelsnummer' (N5) 8-32 'Achternaam' (A25) 33 'Fiscaal/Mulder/Beide (F/M/B) (A1) 34-41 'Geboortedatum' (A8) eejjmmdd 42 'Eed of belofte (E/B)' (A1) 43 'Aant. letters wachtwoord' (N1) exclusief spaties 44-55 'Wachtwoord' (N12) wachtwoord is gecodeerd 56-350 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) 35-42 'Geboortedatum' (A8) eejjmmdd 43 'Eed of belofte (E/B)' (A1) 44 'Aant. letters wachtwoord' (N1) exclusief spaties 45-56 'Wachtwoord' (N12) wachtwoord is gecodeerd 57-350 Filler Gesorteerd op 'Personeelsummer'. Wijziging tbv 6-cijferig verbalisantnummer (Itil 988853) 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 = 100 - Decimale code Voorbeeld: FIETS = 302731161768' FIET = 302731166868' 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, 05-01-2015 9
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 90 0 48 1 49 2 50 3 51 4 52 5 53 6 54 7 55 8 56 9 57 space 32 Gepubliceerd, 05-01-2015 10
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) 66-350 '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) 11-12 'Volgnummer' (N2) Gevuld met de waarden 1 t/m 10 13-132 'Omschrijving' (A120) 133-135 Prioriteitscode (N3) (Voorlopig altijd gevuld met 000) 136-180 Omschrijving-kort (A45) NOG NIET GEREALISEERD! 181-350 'Filler' Gesorteerd op 'Feitcode', 'Volgnummer' Interface bestand: FEITEN-MULDER 1-2 '22' (N2) 3-10 'Feitcode' (A8) 11-55 Omschrijving kort (A45) 56-58 'Feitcategorie-code (A3) 59-66 'Schikkingsbedrag HFL' (N8) in centen 67-74 'Schikkingsbedrag EURO (N8) in centen 75-75 Categorie indeling B (A1) 76-78 Prioriteitscode (N3) [Niet verplicht] 79-288 'Omschrijving lang' (A210) 289-350 Filler Gesorteerd op 'Feitcode' Interface bestand: FEITTOELICHTINGEN FISCAAL 1-2 '23' (N2) 3-10 'Feitcode (A8) 11-12 'Volgnummer' (N2) Gevuld met de waarden 1 t/m 10 13-132 'Omschrijving' (A120) 133-135 Prioriteitscode (N3) (Voorlopig altijd gevuld met 000) Gepubliceerd, 05-01-2015 11
136-180 Omschrijving-kort (A45) NOG NIET GEREALISEERD! 181-350 'Filler' Gesorteerd op 'Feitcode', 'Volgnummer' Interface bestand: FEITEN-FISCAAL 1-2 '24' (N2) 3-10 'Feitcode' (A8) 11-55 'Omschrijving kort' (A45) 56-58 Prioriteitscode (N3) [Niet verplicht] 59-268 Omschrijving lang (A210) 269-300 '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) 47-350 '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 15-18 'Code reden' (A4) 19-42 'Land/parkeervergunning-sector' (A24) Landomschrijving; bij Nederland leeg, Indien vergunning dan Sectornaam ; Niet verplicht 43-50 Datum ingang (N8) eejjmmdd 51-58 Datum einde (N8) eejjmmdd; niet verplicht 59-98 Merk/Productnummer (A40) Merkomschrijving (alfanumeriek) c.q. Productnummer (numeriek) (= vergunningnummer ) Voorloopnullen zijn toegevoegd Bijv. 000012345 start op positie 59 (tot en met 67)! Niet verplicht. 99-350 Filler Gesorteerd op 'Kenteken' Gepubliceerd, 05-01-2015 12
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) 46-48 Prioriteitscode (N3) 49-350 'Filler' Gesorteerd op 'Seponeercode' Interface bestand: WIJK 1-2 '50' (N2) 3-8 'Wijkcode' (N6) 9-58 'Omschrijving' (A50) 59-350 'Filler' Gesorteerd op 'omschrijving' Interface bestand: PARKEERLOKATIE 1-2 '51' (N2) 3-12 'Parkeerlokatiecode (A10) synoniem: segment code 13-27 'Omschrijving-kort (A15) Niet verplicht 28-51 'Straat-naam' synoniem J (A24) Tobias-schrijfwijze bijvoorbeeld:. HAGENGRACHT 52-57 'Wijk-code' (N6) Niet verplicht 58-63 'Plaatscode' (N6) Niet verplicht; verplicht voor TOBIAS 64-67 'Gemeentecode' (N4) 68-75 'Uurparkeertarief HFL' (N8) In centen, verplicht gevuld; bij 'Mulder-lokaties' gevuld met: 00000000 76-83 'Uurparkeertarief EURO' (N8) In centen 84-133 Omschrijving-lang (N50) Maximale lengte is 50; de lengte van de tekst in het omschrijvingsveld is instelbaar! Bijvoorbeeld: Hagengracht-Noord) 134-137 Aantal P-plaatsen (N4) Niet verplicht 138-145 Default feitcode (A8) Niet verplicht 146-350 Filler Gesorteerd op 'Parkeerlokatie-omschrijving' Gepubliceerd, 05-01-2015 13
Interface bestand: PARKEEROBJECT 1-2 '52' 3-12 'Parkeerobjectcode (A10) 13-52 'Omschrijving (A40) 53-62 'Parkeerlokatiecode (A10) 63-350 Filler Gesorteerd op 'Parkeerobjectcode' Interface bestand: WOONPLAATS 1-2 '61' (N2) 3-8 'Plaatscode' (N6) 9-58 'Omschrijving' (A50) 59-350 '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) 47-54 'Kosten naheffing HFL' (N8) in centen 55-62 'Kosten naheffing EURO (N8) in centen 63-70 'Kosten klemmen HFL' (N8) in centen 71-78 'Kosten klemmen EURO (N8) in centen 79-81 Prioriteitscode (N3) (Voorlopig altijd gevuld met 000) 82-350 'Filler' Gesorteerd op 'Omschrijving' Interface bestand: SLUITRECORD 1-2 '99' (N2) 3-7 'EINDE' (A5) 8-350 'Filler Gepubliceerd, 05-01-2015 14
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: -00052201.B4U Aangemaakt op 22 mei 2000; eerste file -00052202.B4U Aangemaakt op 22 mei 2000; tweede file op deze dag -01052201.B4U Aangemaakt op 22 mei 2001; eerste file -11052201.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, 05-01-2015 15
Bestandsindeling; interface van 'Tradelec' naar 'KEY2PARKEREN' Interface bestand: VOORLOOP RECORD 1-2 '01' (N2) 3 'leeg' (A1) 4-8 TRDLC (A5) 9 'leeg' (A1) 10-14 'KEY2PARKEREN' (A5) 15 'leeg' (A1) 16-25 'Versie-nr.' (N10) 26-33 'Filler' (A8) 34-41 'Aanmaakdatum bestand' (N8) eejjmmdd 42-47 'Aanmaaktijd bestand' (N6) uummss 48-500 'Filler' Interface bestand: GECONSTATEERDE FEITEN 1-2 '15' (N2) 3-10 'Datum constatering' (N8; eejjmmdd) 11-14 'Tijdstip constatering' (N4; uumm) 15-19 Personeelsnr..controleur (N5) 20-29 Parkeerlokatiecode (A10) [Niet verplicht] 30-31 TOBIAS-voertuigcode (A2) 32-34 KEY2PARKEREN-TOBIAS-Landcode (A3) 35-46 Kenteken (A12 Nederland: zonder spatie en streepjes; Buitenland: 3-12 posities; optioneel met spaties en streepjes) 47-66 TOBIAS-merkcode (A20) 67-72 TOBIAS-kleurcode (A6) 73 Categorie-indeling-B (A1) 74-81 Feit (A8) 82-89 Bedrag HFL (N8; in centen) Betreft beschikkingsbedrag (Mulder-feit) c.q. Naheffingsbedrag (Fiscaal-feit) 90-97 Bedrag EURO (N8; in centen); [Niet verplicht] 98-105 Uurtarief HFL fiscaalfeit (N8; in centen) [Niet verplicht] 106-113 Uurtarief EURO fiscaalfeit (N8; in centen); [Niet verplicht] 114-121 Kosten klemmen HFL (N8; in centen); [Niet verplicht] 122-129 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 ) 133-252 Opmerking1' (A120); toelichting bij feit [Niet verplicht] 253-372 Opmerking2' (A120); vrije invoer [Niet verplicht] 373 Ind. geseponeerd (A1; toegestane waarde J, N ) Gepubliceerd, 05-01-2015 16
374-381 Datum seponering (N8; eejjmmdd) [Niet verplicht] 382-385 Tijdstip seponering' (N4; uumm) [Niet verplicht] 386-395 Parkeerobjectnummer (A10) [Niet verplicht] 396-401 Pandnummer (A6) [Niet verplicht] 402-411 Naheffingsnummer (N10; uniek bij fiscale-feiten, indien Mulder-feit dan 0 Het Tradelec naheffingsnummer bestaatuit: - Jaarnummer (4) - Handterminalnummer (2) - Volgnummer (4))). 412-436 Tobias-Straat-omschrijving (A25) [Niet verplicht] 437-442 Gemeentecode (N6) [Niet verplicht] 443-452 Omschrijving auto type (A10) [Niet verplicht] 453-472 Adresverfijning (A20) [Niet verplicht] 473-475 Seponeercode (A3) [Niet erplicht] 476-481 Controleurnummer nieuw (A6) 482-500 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 15-19 en 476-481 gevuld. Heeft het controleursnummer een lengte van 6 dan wordt alleen positie 476-481 gevuld. Interface bestand: SLUITRECORD 1-2 '99' (N2) 3-7 'EINDE' (A5) 8-500 'Filler Key2Parkeren, Bestandskoppeling Eltratax 1.0 Gepubliceerd 17