KEY2PARKEREN. Koppeling Eltratax

Transcriptie

1 KEY2PARKEREN Koppeling Eltratax

2 Product: Koppeling: Key2Parkeren Bestandskoppeling Eltratax 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 'ELTRATAX'... 6 Recordtype; interface van 'Key2Parkeren' naar 'ELTRATAX'... 7 Bestandsnaam; interface van 'Key2Parkeren' naar 'ELTRATAX'... 8 Bestandsindeling; interface van 'Key2Parkeren' naar 'ELTRATAX'... 8 Interface van 'ELTRATAX' naar 'Key2Parkeren' Recordtype; interface van 'ELTRATAX' naar 'Key2Parkeren' Bestandsnaam; interface van 'ELTRATAX' naar 'Key2Parkeren' Bestandsindeling; interface van 'ELTRATAX' 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 en ELTRATAX van TaxaMeter Centrale kunnen door middel van interface-bestanden met elkaar communiceren. Hierbij is sprake van een tweetal interfaces: Interface van Key2Parkeren naar ELTRATAX 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 ELTRATAX naar Key2Parkeren Key2Parkeren wordt gevoed met geconstateerde fiscale-parkeerfeiten en Mulderparkeerfeiten. 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. Optioneel kan tevens terreinstatistiek worden 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 'ELTRATAX' Doel: ELTRATAX voeden met basisgegevens waardoor met behulp van de handterminal zowel Fiscale-parkeerfeiten als Mulder-parkeerfeiten kunnen worden geregistreerd! Verschillen tussen interface STANDAARD-VERSIE t.o.v. PBR-VERSIE (status per december 1998): - In de PBR-versie geldt dat een Fas-kleurcode, Fas-voeruigcode, Fas-merkcode, en Fas-landcode worden onderkend. Deze velden moeten in de standaard interface met ELTRATAX worden beschouwd als en z.g. filler. - In de PBR-versie wordt gebruik gemaakt van recordsoort 20' (Feitcategorie code). In de standaard interface met ELTRATAX kunnen deze gegevens ook zijn gevuld, echter standaard ELTRATAX verwerkt deze gegevens niet! - In de PBR-versie wordt binnen recordsoort 22' (Feiten-Mulder ) de feitcategoriecode onderkend. In de standaard interface met ELTRATAX wordt dit veld beschouwd als filler. Het veld code reden op te merken voertuig is met één positie uitgebreid (A3 wordt A4). Hierdoor ontstaat de mogelijkheid om tevens alle lopende parkeervergunningen op te nemen als op te merken voertuig. Deze wijziging in recordsoort 30' en 31' betreft beide interfacemodellen; zowel de STANDAARD-versie als de PBR-versie! Het interface bestand is een ASCII-bestand; het bestand bestaat uit records van 150 posities. N.b.: Voor dit ASCII-bestand geldt dat: - Lege regels zijn toegestaan Regels die beginnen met ';' zijn commentaarregels Het 'ELTRA'-programma dat het bestand inleest slaat dergelijke regels over tijdens het verwerken. Gepubliceerd,

7 Recordtype; interface van 'Key2Parkeren' naar 'ELTRATAX' 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) (N.b.: Feitcategorie wordt niet verwerkt in standaard ELTRATAX) 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 Parkeerobjecten ('0' of meer per bestand) 61 Plaats ('0' of meer per bestand) 62 Gemeente ('0' of meer per bestand) 99 Sluitrecord (één per bestand) Altijd wordt een volledige set van gegevens aangeleverd aan ELTRATAX (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, 62) - Op te merken voertuigen (Combinatie van 30, 31) - Seponeercodes (40) - Parkeerlokaties en tarieven (Combinatie van 50, 51, 52, 61, 62) Gepubliceerd,

8 Bestandsnaam; interface van 'Key2Parkeren' naar 'ELTRATAX' 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 1998; eerste file TBL Aangemaakt op 22 mei 1998; tweede file op deze dag TBL Aangemaakt op 22 mei 2000; eerste file (N.b.: Het verwerkingsprogramma van ELTRA heeft geen eeuwaanduiding nodig!) In de padentabel van Key2Parkeren is (door de gebruiker) vastgelegd in welke directory de interface-bestanden moeten worden geplaatst! Bestandsindeling; interface van 'Key2Parkeren' naar 'ELTRATAX' Interface bestand: VOORLOOP RECORD 1-2 '01' (N2) 3 'leeg' (A1) 4-8 Key2Parkeren (A5) 9 'leeg' (A1) 'ELTRA' (A5) 15 'leeg' (A1) 'Versie-nr.' (N10) 'Datum gegevens' (N8; eejjmmdd) 'Aanmaakdatum bestand' (N8; eejjmmdd) 'Aanmaaktijd bestand' (N6; uummss) 'Filler' (A103) Interface bestand: KLEUR 1-2 '10' 3-4 'Key2Parkeren-Kleurcode' (A2) 5-19 'Kleuromschrijving' (A15) 'Tobias-kleurcode' (A6) FillerFas (A2) 28 e.v. 'Filler' Gesorteerd op 'Kleuromschrijving'! Gepubliceerd,

9 Interface bestand: VOERTUIG 1-2 '11' 3-4 'Key2Parkeren-Voertuigcode' (A2) 5-19 'Voertuigomschrijving' (A15) 'Tobias-voertuigcode' (A2) Filler tbv conversie (A2) 24 'Voorkeur J/N' (A1) 25 e.v. 'Filler' Gesorteerd op 'Tobias-voertuigcode' Interface bestand: MERK 1-2 '12' 3-4 'Key2Parkeren-Merkcode' (A2) 5-19 'Merknaam-kort' (A15) 'Tobias-merkcode' (A20) 'Filler tbv conversie (A4) 44-e.v. 'Filler' Gesorteerd op 'Merknaam-kort' Interface bestand: LAND 1-2 '13' 3-5 'Key2Parkeren/TOBIAS-Landcode' (A3) 6-20 'Omschrijving-kort' (A15) 'Omschrijving-lang' (A40) 'Filler tbv conversie (A4) 65 'Voorkeurcode' (A1) 66 e.v. 'Filler' Gesorteerd op 'landcode'. Interface bestand : CONTROLEUR 1-2 '16' 3-7 'Personeelsnummer' (N5) 8-32 'Achternaam' (A25) 33 'Fiscaal/Beide' (A1) 'Geboortedatum' (A8; eejjmmdd) 42 'Eed of belofte (E/B)' (A1) 43 'Aant. letters wachtwoord' (N1; Exclusief spaties) 'Wachtwoord' (N12; wachtwoord is gecodeerd) 56-e.v. Filler Gesorteerd op 'Personeelsummer'. Gepubliceerd,

10 Interface bestand : CONTROLEUR NIEUW 1-2 '17' 3-8 'Personeelsnummer' (A6) 9-33 'Achternaam' (A25) 34 'Fiscaal/Beide' (A1) 'Geboortedatum' (A8; eejjmmdd) 43 'Eed of belofte (E/B)' (A1) 44 'Aant. letters wachtwoord' (N1; Exclusief spaties) 'Wachtwoord' (N12; wachtwoord is gecodeerd) 57-e.v. Filler Gesorteerd op 'Personeelsummer'. Voor de vulling van het controleurnummer geldt het volgende. Als het controleurnummer een lengte heeft van =<5, dan worden de recordsoorten 16 en 17 gevuld. Als het controleurnummer een lengte van 6 heeft, dan wordt alleen recordsoort 17 gevuld. Interface bestand: FEITCATEGORIE CODE (Wordt wel aangeleverd maar niet verwerkt in de standaardversie van ELTRATAX!) 1-2 '20' 3-5 'Filler Feitcategorie code' (A3) 6-65 'Filler Feitcategorie omschr.' (A60) 66 e.v. 'Filler' Gesorteerd op 'Feitcategorie code' N.b.: Het standaard programma van ELTRATAX zal de feitcategoriecode negeren. Deze gegevens worden vanuit Key2Parkeren (indien aldaar gevuld) wel doorgegeven in de interface naar ELTRATAX. Recordtype 20' zal echter genegeerd worden wanneer de gegevens binnen ELTRATAX worden verwerkt. Interface bestand: FEITTOELICHTINGEN-MULDER 1-2 '21' 3-10 'Feitcode (A8) 'Volgnummer' (N2) (ELTRATAX: alleen volgnr 1 t/m 10!) 'Omschrijving' (A120) 133 e.v. 'Filler' Gesorteerd op 'Feitcode', 'Volgnummer' Gepubliceerd,

11 Interface bestand: FEITEN-MULDER 1-2 '22' 3-10 'Feitcode' (A8) 'Omschrijving' (A45) (de korte omschrijving!) 'Feitcategoriecode' (A3) 'Schikkingsbedrag HFL' (N8) (in centen) 'Schikkingsbedrag EURO (N8) (in centen) 75-e.v. Filler Gesorteerd op 'Feitcode' Interface bestand: FEITTOELICHTINGEN FISCAAL 1-2 '23' 3-10 'Feitcode 'Volgnummer' (N2) (volgnummer alleen 1 t/m 10) 'Omschrijving' (A120) 133 e.v. 'Filler' Gesorteerd op 'Feitcode', 'Volgnummer' Interface bestand: FEITEN-FISCAAL 1-2 '24' 3-10 'Feitcode' (A8) 'Omschrijving' (A45) (de korte omschrijving!) 56 e.v. 'Filler' Gesorteerd op 'Feitcode' N.B. Er zijn 2 fiscale feitcodes die voortaan een vaste betekenis zullen krijgen binnen ELTRATAX nl.: - ZZ1 Deze feitcode wordt gebruikt voor de zgn. vervolgbonnen. - ZZ2 Deze feitcode wordt gebruikt voor de zgn. belanghebbendenbonnen (Utrecht) Kenmerkend voor deze bonnen is dat er Interface bestand: CODE REDEN OP TE MERKEN VOERTUIG 1-2 '30' 3-6 'Code reden' (A4) 7-46 'Omschrijving' (A40) 47 e.v. 'Filler' Gesorteerd op 'Code reden' Gepubliceerd,

12 Interface bestand: OP TE MERKEN VOERTUIGEN 1-2 '31' 3-14 'Kenteken' (A12; Nederland: zonder spatie en streepjes; Buitenland: optioneel spatie en streepjes) 'Code reden' (A4) 'Landomschrijving' (A24) (niet verplicht; bij nederland leeg) Datum ingang (N8) (eejjmmdd) Datum einde (N8; (eejjmmdd; niet verplicht) 59-e.v. Filler Gesorteerd op 'Kenteken' Gepubliceerd,

13 N.B.: In op te merken voertuigen kunnen alle lopende parkeervergunningen en ontheffingen zijn opgenomen! Interface bestand: SEPONEERCODE VAN DE HANDTERMINAL 1-2 '40' 3-5 'Seponeercode' (A3) 6-45 'Omschrijving' (A40) 46 e.v. 'Filler' Gesorteerd op 'Seponeercode' Interface bestand: WIJK 1-2 '50' 3-8 'Wijkcode' (N6) 9-48 'Omschrijving' (A50) 49 e.v. 'Filler' Gesorteerd op 'omschrijving' Gepubliceerd,

14 Interface bestand: PARKEERLOKATIE 1-2 '51' 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) 'Gemeentecode' (N4) 'Uurparkeertarief HFL' (N8; In centen, verplicht gevuld; bij 'Mulder-lokaties' ) '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 plaatsen N4 (Niet verplicht) Default feit A8 (Niet verplicht) Filler Gesorteerd op 'Parkeerlokatie-omschrijving' Interface bestand: PARKEEROBJECT 1-2 '52' 3-12 'Parkeerobjectcode (A10) 'Omschrijving (A40) 'Parkeerlokatiecode (A10) Filler Gesorteerd op 'Parkeerobjectcode' Interface bestand: PLAATS 1-2 '61' 3-8 'Plaatscode' (N6) 9-48 'Omschrijving' (A50) 49 e.v. 'Filler' Gesorteerd op 'Omschrijving' N.b.: In ADR4U is het optioneel (dus niet verplicht) om een straat in te delen in een gebied 'WOONPLAATS'. Een straat valt in ADR4U per definitie wel binnen een 'gemeente'! Gepubliceerd,

15 Interface bestand: GEMEENTE 1-2 '62' 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) 79 e.v. 'Filler' Gesorteerd op 'Omschrijving' Interface bestand: SLUITRECORD 1-2 '99' (N2) 3-7 'EINDE' (A5) 'Filler' (A143). Gepubliceerd,

16 Interface van 'ELTRATAX' naar 'Key2Parkeren' Doel: Key2Parkeren voeden met zowel geconstateerde Fiscale-parkeerfeiten als geconstateerde Mulder-parkeerfeiten vanuit het systeem ELTRATAX. Tevens kan terreinstatistiek worden aangeleverd. 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 geconstateerd feit mag slecht eenmaal worden aangeleverd! N.b.: - ELTRATAX kan geen seponeringscode terug sturen; de omschrijving van de seponering staat in Opmerking2'. Hierin kunnen ook overige teksten staan! - ELTRATAX kan seponeren bij Mulder maar ook bij Fiscaal ; door ELTRATAX als geseponeerd aangeleverde gegevens mogen wel worden ingelezen maar nooit meer worden gewijzigd (Beschouwen als niet opgelegd )! Recordtype; interface van 'ELTRATAX' 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) 17 Terreinstatistiek (nul of meer per bestand) 99 Sluitrecord (één per bestand) Bestandsnaam; interface van 'ELTRATAX' 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 1999; eerste file B4U Aangemaakt op 22 mei 1999; tweede file op deze dag B4U Aangemaakt op 22 mei 2000; eerste file In de padentabel van Key2Parkeren is (door de gebruiker) vastgelegd in welke directory de te verwerken interface-bestanden zijn geplaatst! Gepubliceerd,

17 Bestandsindeling; interface van 'ELTRATAX' naar 'Key2Parkeren' Interface bestand: VOORLOOP RECORD 1-2 '01' (N2) 3 'leeg' (A1) 4-8 ELTRA (A5) 9 'leeg' (A1) 'Key2Parkeren' (A5) 15 'leeg' (A1) 'Versie-nr.' (N10) 'filler' (A8) 'Aanmaakdatum bestand' (N8; eejjmmdd) 'Aanmaaktijd bestand' (N6; uummss) 'Filler' (A453) Interface bestand: GECONSTATEERDE FEITEN 1-2 '15' (N2) 3-10 'Datum constatering' (N8; eejjmmdd) 'Tijdstip constatering' (N4; uumm) Personeelsnr.controleur (N5) Parkeerlokatiecode (A10; synoniem is segmentcode ) [Niet verplicht] TOBIAS-voertuigcode (A2) Key2Parkeren-TOBIAS-Landcode (A3) Kenteken (A12 Nederland: zonder spatie en streepjes; Buitenland: 3-12 posities; optioneel spaties en streepjes) TOBIAS-merkcode (A20) TOBIAS-kleurcode (A6) 73 Categorie-indeling-B (A1) Feit (A8) Bedrag HFL (N8; in centen) Betreft schikkingsbedrag (Mulder-Feit) c.q. Naheffingsbedrag (Fiscaal-feit) Bedrag EURO (N8; in centen); [Niet verplicht] vooralsnog niet gevuld! Uurtarief HFL fiscaalfeit (N8; in centen) [Niet verplicht] Uurtarief EURO fiscaalfeit (N8; in centen); [Niet verplicht] vooralsnog niet gevuld! Kosten klemmen HFL (N8; in centen); [Niet verplicht] Kosten klemmen EURO (N8; in centen); [Niet verplicht] Gepubliceerd,

18 vooralsnog niet gevuld! 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 ) 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) Tobias-Straat-omschrijving (A25) [Niet verplicht] Gemeentecode (N6) [Niet verplicht] Omschrijving auto type (A10) [Niet verplicht] Controleurnummer nieuw (A6) Filler N.b.: Straat-omschrijving en parkeerlokatiecode (c.q. segment-codering ) 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. Voor de vulling van het controleurnummer geldt het volgende. Als het controleurnummer een lengte heeft van =<5, dan worden de posities en gevuld. Heeft het controleurnummer een lengte van 6, dan wordt alleen positie gevuld. Interface bestand: TERREINSTATISTIEK 1-2 '17' (N2) 3-10 'Datum telling' (N8; eejjmmdd) 'Tijdstip telling' (N4; uumm) Personeelsnr.controleur (N5) Parkeerlokatiecode (A10) Aantal plaatsen aanwezig (N4) (Niet verplicht) Aantal plaatsen bezet (N4) Aantal plaatsen extra-1' (N4) (Niet verplicht; vooralsnog niet in gebruik) Aantal plaatsen extra-2' (N4) (Niet verplicht; vooralsnog niet in gebruik) Opmerking (A40) (Niet verplicht; vooralsnog niet in gebruik) Controleurnummer nieuw (A6) Filler Gepubliceerd,

19 Voor de vulling van het controleurnummer geldt het volgende. Als het controleurnummer een lengte heeft van =<5, dan worden de posities en gevuld. Heeft het controleurnummer een lengte van 6, dan wordt alleen positie gevuld. Interface bestand: SLUITRECORD 1-2 '99' (N2) 3-7 'EINDE' (A5) Gepubliceerd,