Key2Parkeren Koppeling Kassa-applicatie
Product: Koppeling: Key2Parkeren Databasekoppeling Key2Parkeren met kassa-applicatie Versie: 1.0 Datum: 05-01-2015 Status: Gepubliceerd Auteur: Centric Netherlands, Public Sector Solutions, Belastingen
Inhoudsopgave Inhoudsopgave... 1 Versie historie... 3 Introductie... 4 Doel van de koppeling... 4 Databasekoppeling... 4 Algemene werking vanuit Key2Parkeren... 4 Beschrijving koppeltabel... 5 Verklaring van de rubrieken... 6
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
Versie historie Versie Datum Wijzigingen 1.0 05-01-2015
Introductie Doel van de koppeling Key2Parkeren kan de kasvorderingen doorgeven aan een externe Kassa-applicatie zoals Key2Betalen of G-Kas. Dit gebeurt door middel van een koppeltabel in de Oracle database van Key2Parkeren met de naam ALG_TKAS_KOPPEL. De kassa-applicatie dient hiervoor lees- en wijzigingsrechten te hebben op die tabel. De koppeling ondersteunt de volgende procesgangen: aanmaak/selectie van vorderingen binnen Key2Parkeren; aanbieding van essentiële vordering gegevens door Key2Parkeren aan het Kassasysteem ; aanbieden van betalingsgegevens door het Kassasysteem: automatische verwerking betalingsgegevens binnen Key2Parkeren. Databasekoppeling Algemene werking vanuit Key2Parkeren Bij een kasbetaling in Key2Parkeren wordt er een record toegewezen aan een Kassanummer en opgevoerd in de koppeltabel l ALG_TKAS_KOPPEL. Nieuw opgevoerde records krijgen een status (1). De kassa-applicatie polt op de koppeltabel en haalt alle records op met status 1. Deze records worden in de kassa-applicatie betaalbaar gesteld. Gedurende de verwerking in de kassa-applicatie krijgt het record in de koppeltabel tijdelijk de status 4. De kassa-applicatie voert de betaling/restitutie door en legt deze ook in de eigen database vast. Vervolgens wordt de koppeltabel bijgewerkt: 1) De status wordt 2 2) Het bedrag in de koppeltabel wordt het werkelijke bedrag dat in de kassa-applicatie verwerkt is. 3) Valutadatum en tijd worden aangepast. Zodra Key2Parkeren een record aantreft in de koppeltabel met status 2 wordt dit record opgepakt en verwerkt als zijnde een betaling/restitutie. Na deze verwerking krijgt het record de status 3 (als het compleet afgehandeld is) of 6 (als het niet volledig verwerkt kan worden) Indien posten binnen de kassa-applicatie worden verwijderd, dan krijgen deze in de koppeltabel de status 5. Vanuit Key2Parkeren kan de post opnieuw worden aangeleverd.
Beschrijving koppeltabel Rubriek : Null? Num/Char: Lengte: Omschrijving: KGBR NN NUM 4 Gebruikerscode RKASSESSIE NN NUM 10 Kassasessienummer RVOLG NN NUM 3 Volgnummer KSRTAANSLAGBILJET NUM 2 Aanslagbiljetsoort DHEFFINGJAAR NUM 4 Heffingsjaar RAANSLAGBILJSERIE NUM 3 Serienummer RAANSLAGBILJET NUM 8 Aanslagnummer RNAHEFFING NUM 10 Naheffingsnummer KKENTEKEN CHAR 20 Kenteken OMERK CHAR 15 Omschrijving automerk OLOKATIE CHAR 50 Omschrijving parkeerlocatie BUURTARIEF NUM 13,2 Uurtarief BKOSTEN_KLEM NUM 13,2 Klemkosten BNAHEFFING NUM 13,2 Bedrag naheffing RVERGUNNING NUM 9 Vergunningnummer KPRODUKT CHAR 6 Productcode OPRODUKT CHAR 40 Omschrijving product KSRTVERGUNNING CHAR 4 Code soort vergunning OSRTVERGUNNING CHAR 40 Omschrijving srt vergunning KGEBIED NUM 6 Code gebied OGEBIED CHAR 50 Omschrijving gebied BLEGES NUM 13,2 Bedrag leges BWAARBORG NUM 13,2 Bedrag waarborg BBTW NUM 13,2 Bedrag BTW BPRODUKT NUM 13,2 Bedrag product RRESTITUTIE NUM 9 Restitutienummer RBETREG NUM 10 Betalingsregelingnummer RSBJ NUM 10 Subjectnummer RSBJBERIJDER NUM 10 Subjectnummer bestuurder NSBJ CHAR 100 Subjectnaam NADRES CHAR 50 Adres NWPL CHAR 50 Woonplaats BBEDRAG NN NUM 13,2 Bedrag DVALUTA NUM 10 Valutadatum TVALUTA NUM 4 Valutatijd RKASSA CHAR 2 Kassanummer RBON CHAR 8 Kassabonnummer KBRONCODE NN CHAR 8 Broncode OMEMO CHAR 200 Memoveld RSTATUS NN NUM 1 Status RBETAALBESTAND NUM 9 Betaalbestandnummer IVERW CHAR 1 Indicatie verwerkt RWAARBORG CHAR 10 Waarborgnummer RKWITANTIE NUM 3 Kwitantienummer DINGANGPERIODE NUM 8 Begindatum periode DEINDEPERIODE NUM 8 Einddatum periode DMUTATIE NUM 8 Mutatiedatum NUSER CHAR 30 Naam gebruiker RDOKUMENT NUM 3 Documentnummer NCOMPUTER CHAR 25 Naam werkplek OWEIGERING CHAR 250 Reden weigering RDEBITEUR CHAR 15 Debiteurnummer RDEBITEURBERIJDER CHAR 15 Debiteurnummer bestuurder KFNK_SUB CHAR 4 Subfunctiecode
Verklaring van de rubrieken Kassasessienummer: Een sessienummer wordt door Key2Parkeren gegenereerd om (in combinatie met een volgnummer) een betaling/restitutie uniek te identificeren. In één kassasessie nummer kunnen meerdere betalingen/restituties (ieder op een vordering/belastingaanslag) voorkomen. Een kassasessie nummer kan altijd maar betalingen/restituties bevatten van één subject. Volgnummer: Het volgnummer wordt door Key2Parkeren bepaald. Het volgnummer wordt telkens opgehoogd wanneer er meerdere betalingen van hetzelfde subject worden opgevoerd. Bij een betaling van het subject op één vordering zal het volgnummer 1 zijn. Indien het subject direct voor meerdere vorderingen wil betalen, dan zal het volgnummer oplopen (binnen hetzelfde kassasessie nummer). Kassasessie nummer en volgnummer vormen samen een unieke identificatie van een betaling vanuit Key2Parkeren. Aanslagnummer: Dit unieke nummer voor de belastingaanslag. Key2Parkeren boekt uiteindelijk de betaling/restitutie af op dit aanslagnummer. Dit nummer wordt door Key2Parkeren gevuld in de rubrieken ksrtaanslagbiljet, dheffingjaar, raanslagbiljserie en raanslagbiljet. Naheffingnummer: Het unieke nummer voor de fiscale parkeerbonnen uit de module Parkeerheffen. Kenteken: Het kenteken wat op de fiscale bon is afgedrukt. Deze rubriek kan worden gebruikt voor de modules Patkeerheffen en Vergunningen. Omschrijving merk: Het automerk uit de module Parkeerheffen. Omschrijving locatie: De parkeerlocatie uit de module Parkeerheffen. Bedrag uurtarief: Het uurtarief uit de module Parkeerheffen. Bedrag klemkosten: Het bedrag aan klemkosten uit de module Parkeerheffen. Bedrag naheffing: Het bedrag van de opgelegde naheffing uit de module Parkeerheffen.
Vergunningnummer: Het unieke nummer voor producten uit de module Vergunningen. Productcode: De productcode uit de module Vergunningen. Omschrijving productcode: De omschrijving van de productcode uit de module Vergunningen. Code soort vergunning: De code vergunningsoort uit de module Vergunningen. Omschrijving soort vergunning: De omschrijving van de vergunningsoort uit de module Vergunningen. Code gebied: De gebiedscode (parkeerzone) uit de module Vergunningen. Omschrijving gebied: De omschrijving van het gebied (parkeerzone) uit de module Vergunningen. Bedrag leges: Het bedrag aan leges uit de module Vergunningen. Bedrag waarborg: Het waarborgbedrag uit de module Vergunningen. Bedrag BTW: Het btw bedrag uit de module Vergunningen. Bedrag product: Het bedrag van het product uit de module Vergunningen. Restitutienummer: Het unieke restitutienummer uit de module Inningen. Betalingsregelingnummer: Het unieke betalingsregelingnummer uit de module Inningen Subjectnummer bestuurder: Deze rubriek wordt eventueel gevuld uit de module Vergunningen. Naam subject: De naam van het subject.
Adres subject: Het adres van het subject. Deze rubriek wordt samengesteld uit straatnaam, huisletter, toevoeging en locatie Woonplaats subject: De woonplaats van het subject. Deze rubriek wordt samengesteld uit de postcode en de woonplaatsnaam. Bedrag: Bedrag dat betaald gaat worden op de vordering/ belastingaanslag. Dit bedrag wordt reeds binnen Key2Parkeren ingegeven en in de koppeltabel gevuld. Vanuit de module Parkeerheffen is deze rubriek de sommatie van Bedrag uurtarief, Bedrag klemkosten en Bedrag naheffing. Vanuit PVS is deze rubriek de sommatie van Bedrag leges, Bedrag waarborg, Bedrag B.T.W. en Bedrag product. Indien het bedrag in de kassa-applicatie te wijzigen is (bijv. vanuit Key2Parkeren is doorgegeven dat er 100,- wordt betaald terwijl er in de kassa-applicatie slechts 80,- wordt betaald), dan dient de kassa-applicatie (b.v. Key2betalen of G-Kas) dit bedrag ook te updaten in de koppeltabel. Valutadatum: Valutadatum betaling. Dit veld zal enkel in de koppeltabel opgenomen worden indien binnen de kassa-applicatie een valutadatum in te geven of te wijzigen is. Valutatijd: Valutatijd betaling. Dit veld zal enkel in de koppeltabel opgenomen worden indien binnen de kassa-applicatie een valutatijd in te geven of te wijzigen is. Kassanummer: Identificatie van de kassaterminal. Dit geeft aan vanuit welke kassaterminal de betaling verwerkt is. Dit veld zal door de gebruiker zelf ingevuld moeten worden. Key2Parkeren slaat dit als informatie op bij de kassabetaling. Bonnummer: Het nummer van de kassabon. Dit geeft aan welk bonnummer de betreffende kasbetaling heeft. Dit veld zal door Key2Betalen gevuld moeten worden. HIS@all / Key2Parkeren slaat dit als informatie op bij de kassabetaling. Broncode: Het externe systeem dat de betalingen aan Key2betalen of G-Kas aanlevert. Indien het aanleverende systeem de module Parkeerheffen is, wordt de broncode gevuld met PHS4U. Indien het aanleverende systeem de module Inningen is, wordt de broncode gevuld met INN4U.
Indien het aanleverende systeem de module Vergunningen is, wordt gecontroleerd of optie 30.219 (uitbreiding koppeling Key2Betalen met grootboekrekeningnummer) geactiveerd is. Als optie 30.219 niet geactiveerd is Dan wordt de broncode gevuld met PVS4U Anders wordt gecontroleerd of voor de betreffende productcombinatie het mee te geven grootboekrekeningnummer van maximaal 5 posities bekend is Als dit niet het geval is Dan wordt de broncode gevuld met PVS4U Anders wordt de broncode gevuld met PVS, aangevuld met het betreffende grootboekrekeningnummer (bijv. PVS12345 ) Status: Key2Parkeren voert een record op in de koppeltabel (ALG_TKAS_KOPPEL). Hierbij vult Key2Parkeren de rubrieken zoals in de beschrijving hierboven is aangegeven. ALG_TKAS_KOPPEL.rstatus krijgt de waarde 1. De kassa-applicatie polt en haalt alle records op waarvoor geldt dat ALG_TKAS_KOPPEL.rstatus = 1. Deze records worden in de kassa-applicatie betaalbaar gesteld. Binnen de kassa-applicatie kan de betaling doorgevoerd en vastgelegd worden. De kassaapplicatie zal vervolgens het betreffende record in de koppeltabel (ALG_TKAS_KOPPEL) als volgt moeten updaten. - ALG_TKAS_KOPPEL.rstatus wordt 2 - ALG_TKAS_KOPPEL.bbedrag wordt het werkelijke bedrag dat in de kassa-applicatie verwerkt is - (Evt. worden ALG_TKAS_KOPPEL.tvaluta/dvaluta bijgewerkt) Zodra Key2Parkeren een record in de koppeltabel aantreft met status 2 wordt dit record door Key2Parkeren opgepakt en verwerkt als zijnde een betaling binnen het HIKey2Parkeren systeem. Vervolgens update Key2Parkeren het betreffende record naar (1) status 3, waarmee aangegeven wordt dat dit record compleet is afgehandeld, of (2) status 6, waarmee aangegeven wordt dat dit record niet compleet afgehandeld kon worden. Betaalbestandnummer: Het nummer van het betaalbestand waar de kasbetaling in opgenomen gaat worden. Indicatie verwerkt (J/N): Posten krijgen de indicatie J wanneer deze definitief zijn verwerkt. Waarborgnummer: Het waarborgnummer uit de module Vergunningen. Kwitantienummer: Het kwitantienummer uit de module Vergunningen. Begindatum periode: Begindatum periode vergunning uit de module Vergunningen.
Einddatum periode: Einddatum periode vergunning uit de module Vergunningen. Mutatiedatum: Datum opvoeren record in koppeltabel. Naam gebruiker: Naam gebruiker die ingelogd is in Key2Parkeren. Documentnummer: Het documentnummer uit de module Vergunningen. Naam werkplek: Naam werkplek binnen Key2Parkeren. Om misverstanden te voorkomen is besloten dit veld voortaan leeg te laten! Vanuit Key2Parkeren wordt een, aan de werkplek gekoppeld, kassanummer gevuld in de koppeltabel. Reden weigering: Omschrijving reden waarom een record uit de koppeltabel (1) status 5 krijgt vanuit de kassa-applicatie, of (2) status 6 krijgt vanuit Key2Parkeren. Debiteurnummer: Het debiteurnummer van het subject vanuit de module Vergunningen t.b.v. een extern financieel pakket. Debiteurnummer bestuurder: Het debiteurnummer van de bestuurder vanuit de module Vergunningen t.b.v. een extern financieel pakket.