Key2Parkeren Koppeling Kassa-applicatie
Product:
Key2Parkeren
Koppeling:
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
Key2Parkeren, Databasekoppeling Key2Parkeren met Kassa-applicatie 1.0 Centric Netherlands B.V. Gepubliceerd, 05-01-2015
Copyright 2015, Centric Netherlands B.V. 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
Key2Parkeren, Databasekoppeling Key2Parkeren met Kassa-applicatie 1.0 Centric Netherlands B.V. Gepubliceerd, 05-01-2015
Databasekoppeling specificatie
Versie historie Versie 1.0
Datum 05-01-2015
Key2Parkeren, Databasekoppeling Key2Parkeren met Kassa-applicatie 1.0 Gepubliceerd, 05-01-2015
Wijzigingen
Databasekoppeling specificatie
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.
Key2Parkeren, Databasekoppeling Key2Parkeren met Kassa-applicatie 1.0 Gepubliceerd, 05-01-2015
Centric Netherlands B.V.
Databasekoppeling specificatie
Beschrijving koppeltabel Rubriek
:
KGBR RKASSESSIE RVOLG KSRTAANSLAGBILJET DHEFFINGJAAR RAANSLAGBILJSERIE RAANSLAGBILJET RNAHEFFING KKENTEKEN OMERK OLOKATIE BUURTARIEF BKOSTEN_KLEM BNAHEFFING RVERGUNNING KPRODUKT OPRODUKT KSRTVERGUNNING OSRTVERGUNNING KGEBIED OGEBIED BLEGES BWAARBORG BBTW BPRODUKT RRESTITUTIE RBETREG RSBJ RSBJBERIJDER NSBJ NADRES NWPL BBEDRAG DVALUTA TVALUTA RKASSA RBON KBRONCODE OMEMO RSTATUS RBETAALBESTAND IVERW RWAARBORG RKWITANTIE DINGANGPERIODE DEINDEPERIODE DMUTATIE NUSER RDOKUMENT NCOMPUTER OWEIGERING RDEBITEUR RDEBITEURBERIJDER KFNK_SUB
Null? Num/Char:
Lengte:
Omschrijving:
NN NN NN
4 10 3 2 4 3 8 10 20 15 50 13,2 13,2 13,2 9 6 40 4 40 6 50 13,2 13,2 13,2 13,2 9 10 10 10 100 50 50 13,2 10 4 2 8 8 200 1 9 1 10 3 8 8 8 30 3 25 250 15 15 4
Gebruikerscode Kassasessienummer Volgnummer Aanslagbiljetsoort Heffingsjaar Serienummer Aanslagnummer Naheffingsnummer Kenteken Omschrijving automerk Omschrijving parkeerlocatie Uurtarief Klemkosten Bedrag naheffing Vergunningnummer Productcode Omschrijving product Code soort vergunning Omschrijving srt vergunning Code gebied Omschrijving gebied Bedrag leges Bedrag waarborg Bedrag BTW Bedrag product Restitutienummer Betalingsregelingnummer Subjectnummer Subjectnummer bestuurder Subjectnaam Adres Woonplaats Bedrag Valutadatum Valutatijd Kassanummer Kassabonnummer Broncode Memoveld Status Betaalbestandnummer Indicatie verwerkt Waarborgnummer Kwitantienummer Begindatum periode Einddatum periode Mutatiedatum Naam gebruiker Documentnummer Naam werkplek Reden weigering Debiteurnummer Debiteurnummer bestuurder Subfunctiecode
NN
NN NN
NUM NUM NUM NUM NUM NUM NUM NUM CHAR CHAR CHAR NUM NUM NUM NUM CHAR CHAR CHAR CHAR NUM CHAR NUM NUM NUM NUM NUM NUM NUM NUM CHAR CHAR CHAR NUM NUM NUM CHAR CHAR CHAR CHAR NUM NUM CHAR CHAR NUM NUM NUM NUM CHAR NUM CHAR CHAR CHAR CHAR CHAR
Key2Parkeren, Databasekoppeling Key2Parkeren met Kassa-applicatie 1.0 Gepubliceerd, 05-01-2015
Centric Netherlands B.V.
Databasekoppeling specificatie
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.
Key2Parkeren, Databasekoppeling Key2Parkeren met Kassa-applicatie 1.0 Gepubliceerd, 05-01-2015
Centric Netherlands B.V.
Databasekoppeling specificatie
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.
Key2Parkeren, Databasekoppeling Key2Parkeren met Kassa-applicatie 1.0 Gepubliceerd, 05-01-2015
Centric Netherlands B.V.
Databasekoppeling specificatie
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’.
Key2Parkeren, Databasekoppeling Key2Parkeren met Kassa-applicatie 1.0 Gepubliceerd, 05-01-2015
Centric Netherlands B.V.
Databasekoppeling specificatie
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.
Key2Parkeren, Databasekoppeling Key2Parkeren met Kassa-applicatie 1.0 Gepubliceerd, 05-01-2015
Centric Netherlands B.V.
Databasekoppeling specificatie
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.
Key2Parkeren, Databasekoppeling Key2Parkeren met Kassa-applicatie 1.0 Gepubliceerd, 05-01-2015
Centric Netherlands B.V.