KEY2BELASTINGEN, GISVG KOPPELVLAK BELASTINGEN DERDEN

KEY2BELASTINGEN, GISVG KOPPELVLAK BELASTINGEN DERDEN

Versie: Datum: Auteur: Afdeling:

1.0 30 januari 2014 BU Belastingen

Key2Belastingen, GIsvg koppelvlak belastingen derden

1

Inhoudsopgave

Contents 1

Inleiding Koppelvlak Belastingen Derden. 1.1 Globale opzet van de koppeling

2

Uploaden van gegevens 2.1 AanslagNotificatie 2.2 AutIncassoNotificatie 2.3 BeschikkingNotificatie 2.4 FinVerantwoordingNotificatie 2.5 FotoNotificatie 2.6 OpenSaldoNotificatie 2.7 TaxatieNotificatie

6 6 9 10 12 14 15 15

3

Uploaden van statusinformatie 3.1 StatusNotificatie

20 20

4

Het uploadproces 4.1 Configuratie van het uploadproces 4.2 Opstarten en testen van het uploadproces 4.3 Opnemen van het uploadproces in de Windows Scheduler

22 22 25 29

5

Indienen van zaken 5.1 CreateZaak 5.2 PostZaken 5.3 Bezwaar 5.4 Aanmelding automatische incasso 5.4.1 algemene gegevens 5.4.2 subjectgegevens 5.4.3 specifieke gegevens 5.5 Intrekking machtiging automatische incasso 5.5.1 algemene gegevens

32 32 33 34 37 37 37 38 38 39


2

5 5

5.6

5.7

5.8

5.9

5.10

5.11

5.5.2 subjectgegevens 5.5.3 specifieke gegevens Wijziging rekeningnummer automatische incasso 5.6.1 subjectgegevens 5.6.2 specifieke gegevens Aanmelding hond 5.7.1 subjectgegevens 5.7.2 specifieke gegevens Afmelding hond 5.8.1 algemene gegevens 5.8.2 subjectgegevens 5.8.3 specifieke gegevens Aanvraag kwijtscheldingsformulier 5.9.1 algemene gegevens 5.9.2 subjectgegevens 5.9.3 specifieke gegevens Uitstel van betaling 5.10.1 algemene gegevens 5.10.2 subjectgegevens 5.10.3 specifieke gegevens Verzoek betalingsregeling 5.11.1 algemene gegevens 5.11.2 subjectgegevens 5.11.3 specifieke gegevens

Copyright 2015, Centric Netherlands B.V. Key2Belastingen, GIsvg koppelvlak belastingen derden

3

39 39 40 40 40 41 41 42 43 43 43 44 45 45 46 46 47 47 47 47 48 48 48 48

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.


4

1

Inleiding Koppelvlak Belastingen Derden.

Dit document beschrijft het koppelvlak dat de belastingsystemen van Centric beschikbaar stellen voor koppeling aan midoffice systemen. Centric levert 3 verschillende belastingsystemen. Dat zijn Key2Belastingen, HIS4all en GISVG. Deze systemen ondersteunen alle het hier beschreven koppelvlak. Het koppelvlak biedt globaal de volgende functionaliteit: 

batchgewijs uploaden van gegevens betreffende aanslagen, beschikkingen, taxaties, etc.



indienen van aanvragen, verzoeken en bezwaren.



batchgewijs uploaden van de status van de afhandeling van een bezwaar.

Voor de functionaliteit onder het eerste en derde punt is een excutable aanwezig die soapberichten aanbiedt aan webservices die het midoffice beschikbaar dient te stellen. Voor de functionaliteit onder punt 2 biedt het koppelvlak zelf een webservice aan die door het midoffice kan worden gebruikt voor het aanbieden van het bezwaar. De werking van de hier boven genoemde componenten zal in onderstaande paragrafen nader worden beschreven.

1.1

Globale opzet van de koppeling

Voor de communicatie tussen het betreffende belastingsysteem en het aan te sluiten midoffice wordt een apart datamodel gebruikt dat wordt aangeduid als ‘de wachtkamer’. Voor deze constructie is gekozen om de volgende redenen: 

De drie belastingsystemen die dit koppelvlak ondersteunen maken gebruik van verschillende datamodellen. De noodzakelijke conversie van gegevens wordt door de belastingsystemen zelf uitgevoerd en niet door de componenten die de communicatie verzorgen.



Een deel van de gegevens die moeten worden geupload is dynamisch (onder meer de kenmerken van een WOZ-object op basis waarvan taxatie plaatsvindt). Om te voorkomen dat deze gegevens worden gewijzigd voordat een upload naar het midoffice heeft plaatsgevonden, worden deze ‘bevroren’ door ze op het relevante moment weg te schrijven in ‘de wachtkamer’.

De wachtkamertabellen bevatten zowel de te uploaden gegevens (aanslagen, beschikkingen, et cetera) als ook de ontvangen bezwaren en de status van de afhandeling ervan. De software die de data vanuit de wachtkamer verzendt, geeft alleen toegevoegde of gewijzigde gegevenssets door.


5

2

Uploaden van gegevens

Om gebruikers van de frontoffice applicaties in staat te stellen gegevens in te zien met betrekking tot aanslagen, beschikkingen en taxaties zonder deze frontoffice toepassing te koppelen aan de database van het belastingsysteem (of kopie daarvan) , kunnen deze gegevens beschikbaar worden gesteld voor opslag in het gegevensmagazijn van het midoffice. Onderdeel van het koppelvlak is een executable waarmee batchgewijs gegevens die door het belastingsysteem in de wachtkamertabellen zijn geplaatst worden aangeboden aan een door het midoffice beschikbaar te stellen webservice. Deze webservice dient de volgende operations te ondersteunen:

OPERATION

OMSCHRIJVING

Aanslagnotificatie

Ontvangt gegevens met betrekking tot aanslagen en aanslagregels

AutIncassoNotificatie

Ontvangt gegevens met betrekking tot afgegeven machtigingen voor automatische incasso

BeschikkingNotificatie

Ontvangt gegevens met betrekking tot kennisgevingen en beschikkingen

FinVerantwoordingNotificatie

Ontvangt gegevens met betrekking tot de financiële verantwoording

FotoNotificatie

Ontvangt foto's van de woz-objecten

OpenSaldoNotificatie

Ontvangt gegevens met betrekking tot open saldi van aanslagen

TaxatieNotificatie

Ontvangt gegevens met betrekking tot taxaties

Aanslagnotificatie

Ontvangt gegevens met betrekking tot aanslagen en aanslagregels

2.1

AanslagNotificatie

Aan deze operation worden de aanslaggegevens aangeboden. Het betreft de nodes AANSLAG en AANSLAGREGEL. Het request is globaal als volgt opgebouwd:

... gegevens aanslag ... gegevens aanslagregel ... ...


6

De software verwacht een response waarin de unieke aanduidingen van de aangeboden aanslagen zijn opgenomen. Op basis van deze response wordt in de wachtkamer verwerkt dat de betreffende aanslagen met succes in het midoffice zijn ontvangen en opgeslagen. De software biedt alleen de sinds de vorige upload toegevoegde en gewijzigde aanslagen aan. Wanneer een gegeven in een aanslag of in een onderliggende aanslagregel is gewijzigd, dan wordt de gehele aanslag opnieuw aangeboden. Er worden meerdere aanslagen in één bericht aangeboden. Het maximum aantal aanslagen in één bericht kan worden ingesteld bij de uploadsoftware (zie configuratie). De defaultwaarde is 100 aanslagen per bericht. In het verzonden bericht zijn de volgende gegevens opgenomen:

algemene gegevens onder node AANSLAG NODENAME

DATATYPE

LENGTE

OMSCHRIJVING

AANSLAGNR

decimal

10,0

Unieke aanduiding van de aanslag

SUBJECTNR

decimal

10,0

Unieke aanduiding van het gekoppelde subject in de backoffice toepassing

BOKEY

string

20

Aanslagnummer in de backoffice toepassing (dit is ook de waarde die op de aanslag staat aangegeven)

SOFINR

string

9

Sofi-nummer

SOFINR_AANV

string

10

Aanvullend sofi-nummer

NAAM

string

200

Achternaam

VOORLT

string

10

Voorletters

VOORV

string

10

Voorvoegsels

STRAAT

string

40

Straatnaam adressering

HUISNR

decimal

5,0

Huisnummer adressering

HUISLT

string

1

Huisletter adressering

TOEV

string

4

Toevoeging bij huisnummer adressering

AAND

string

2

Aanduiding bij huisnummer adressering

LOCATIE

string

40

Locatie-aanduiding adressering

POSTCODE

string

6

Postcode adressering

WOONPLAATS

string

40

Woonplaats adressering

LAND

string

40

Land adressering (indien niet NL)

DDDAGTEKENING

datetime

JJHEFFING

decimal

DDVERVAL

datetime

FFBEDRAG

decimal

13,2

Bedrag van de aanslag

PINCODE

string

100

‘niet in gebruik’

INDAUTINC

string

1

Indicatie automatische incasso (J/N)

Dagtekening 4,0

Heffingsjaar aanslag Laatste vervaldag


7

algemene gegevens onder node AANSLAG NODENAME

DATATYPE

LENGTE

OMSCHRIJVING

AANSLAGTYPE

string

3

Aanslagtype (voorlopig/definitief)

OPDRACHTGEVER

decimal

10,0

Unieke aanduiding van de opdrachtgever

VOLGNR

decimal

3,0

‘niet in gebruik’

BETALINGSKENMERK

decimal

16,0

Betalingskenmerk van de aanslag

algemene gegevens onder node AANSLAGREGEL NODENAME

DATATYPE

LENGTE

OMSCHRIJVING

REGELNR

decimal

10,0

Unieke aanduiding van de aanslagregel

AANSLAGNR

decimal

10,0


BOKEY

string

20

Sleutel van de regel in de backoffice toepassing

VOLGNR

decimal

3,0

Volgnummer regel

HEFFINGCODE

string

5

Heffingcode *)

HEFFING_OMS

string

40

Omschrijving heffing

BESCHIKKINGNR

decimal

10,0

Unieke aanduiding van de beschikking; wordt alleen gevuld als de aanslagregel een beschikking betreft

DDINGANG

datetime

DDEINDE

datetime

OMSCHRIJVING1

string

255

Omschrijvingsregel 1

OMSCHRIJVING2

string

255


OMSCHRIJVING3

string

255


FFBEDRAG

decimal

13,2

Bedrag aanslagregel (niet bij beschikkingen)

Ingangsdatum Eindedatum

*) Overzicht van de gedefinieerde heffingcodes:

CODE

OMSCHRIJVING

BOA

Beschikking op Aanslag

OZBE

Onroerende zaakbelasting eigenaar

OZBG

Onroerende zaakbelasting gebruiker

RIOE

Rioolrecht eigenaren

RIOG

Rioolrecht gebruiker

HOND

Hondenbelasting

BAAT

Baatbelasting


8

CODE

OMSCHRIJVING

WSO

Waterschapsomslag

RZBE

Roerende zaakbelasting eigenaar

RZBG

Roerende zaakbelasting gebruiker

TOER

Toeristenbelasting

REIN

Reinigingsrecht

WOFO

Forensenbelasting

INGO

Ingezetenenomslag

CAI

Centrale antenne inrichting

GRAF

Lijkbezorgingsrechten

PREC

Precariobelasting

RECL

Reclamebelasting

PARK

Parkeerbelasting

LIGG

Liggelden

VERM

Vermakelijkhedenretributie

WVOB

Verontreinigingsr. opp.water bedr.

WVOW

Verontreinigingsr.opp.water woningen

PVS

Parkeervergunningen

ERFP

Erfpacht

NOW

Nota Waterschappen

KORT

Korting n.a.v. Zalmsnip

DIFT

Diftar Ledigingen

Het is mogelijk dat in incidentele gevallen van bovenstaande lijst wordt afgeweken of dat in de nabije toekomst nieuwe heffingsoorten worden toegevoegd.

2.2

AutIncassoNotificatie

Aan deze operation worden de machtigingen voor automatische incasso aangeboden. De gegevens zijn opgenomen in de node AUTOINCASSO. De globale opbouw van het request is als volgt:

... gegevens machtiging ...


9

De software verwacht een response waarin de unieke aanduidingen van de aangeboden machtigingen zijn opgenomen. Op basis van deze response wordt in de wachtkamer verwerkt dat de betreffende machtigingen met succes in het midoffice zijn ontvangen en opgeslagen. De software biedt alleen de sinds de vorige upload toegevoegde en gewijzigde machtigingen aan. Er worden meerdere machtigingen in één bericht aangeboden. Het maximum aantal machtigingen in één bericht kan worden ingesteld bij de uploadsoftware (zie configuratie). De defaultwaarde is 100 machtigingen per bericht. In het verzonden bericht zijn de volgende gegevens opgenomen:

algemene gegevens onder node AUTOINCASSO NODENAME

DATATYPE

LENGTE

OMSCHRIJVING

SUBJECTNR

decimal

10,0

Unieke aanduiding van het subject in de backoffice toepassing

REKENINGNR

decimal

10,0

Rekeningnummer automatische incasso

INDAUTINC

string

9

Indicatie automatische incasso (J/N)

2.3

BeschikkingNotificatie

Aan deze operation worden de kennisgevingen en beschikkingen aangeboden. De gegevens zijn opgenomen in de nodes KENNISGEVING en BESCHIKKING. De globale opbouw van het request is als volgt:

... gegevens kennisgeving ... gegevens beschikking ... ... De beschikkingen worden dus per kennisgeving aangeleverd. Een kennisgeving kan meerdere beschikkingen bevatten. De software verwacht een response waarin de unieke aanduidingen van de aangeboden kennisgevingen zijn opgenomen. Op basis van deze response wordt in de wachtkamer verwerkt dat de betreffende kennisgevingen met succes in het midoffice zijn ontvangen en opgeslagen. De software biedt alleen de sinds de vorige upload toegevoegde en gewijzigde kennisgevingen aan. Wanneer een gegeven in een kennisgeving of in een onderliggende beschikking is gewijzigd, dan wordt de gehele kennisgeving opnieuw aangeboden.


10

Er worden meerdere kennisgevingen in één bericht aangeboden. Het maximum aantal kennisgevingen in één bericht kan worden ingesteld bij de uploadsoftware (zie configuratie). De defaultwaarde is 100 kennisgevingen per bericht. In het verzonden bericht zijn de volgende gegevens opgenomen:

algemene gegevens onder node KENNISGEVING NODENAME

DATATYPE

LENGTE

OMSCHRIJVING

KENNISGNR

decimal

10,0

Unieke aanduiding van de kennisgeving

SUBJECTNR

decimal

10,0

Unieke aanduiding van het gekoppelde subject in de backoffice toepassing

BOKEY

string

20

Sleutel van de kennisgeving in de backoffice toepassing

SOFINR

string

9

Sofi-nummer

SOFINR_AANV

string

10

Aanvullend sofi-nummer

NAAM

string

200

Achternaam van het subject

VOORLT

string

10

Voorletters

VOORV

string

10

Voorvoegsels

STRAAT

string

40

Straat adressering

HUISNR

decimal

5,0

Huis adressering

HUISLT

string

1


TOEV

string

4

Toevoeging bij huisnummer

AAND

string

2

Aanduiding bij huisnummer

LOCATIE

string

40

Locatie-aanduiding

POSTCODE

string

6


WOONPLAATS

string

40


LAND

string

40


HUISLT

string

1


TOEV

string

4

Toevoeging bij huisnummer

AAND

string

2

Aanduiding bij huisnummer

LOCATIE

string

40

Locatie-aanduiding

POSTCODE

string

6


WOONPLAATS

string

40


LAND

string

40


DDDAGTEKENING

datetime

Dagtekening

DDPEIL

datetime

Waardepeildatum

TIJDVAK

string

9


Tijdvak WOZ

11

algemene gegevens onder node BESCHIKKING NODENAME

DATATYPE

LENGTE

OMSCHRIJVING

BESCHIKKINGNR

decimal

10,0

Unieke aanduiding van de beschikking

KENNISGNR

decimal

10,0

Unieke aanduiding van de gekoppelde kennisgeving

WOZBELOBJNR

string

12

Woz-objectnummer

INDBESCHIKKING

string

3

Indicatie soort beschikking. Domein: VOR - voormelding BES - beschikking

BOKEY

string

20

Sleutel backoffice

TAXATIENR

decimal

10,0

Unieke aanduiding van de gekoppelde taxatie

STRAAT

string

40

Straatnaam object

HUISNR

decimal

5,0

Huisnummer object

HUISLT

string

1

Huislettter object

TOEV

string

4

Toevoeging huisnummer object

AAND

string

2

Aanduiding huisnummer object

LOCATIE

string

40

Locatieaanduiding object

POSTCODE

string

6

Postcode object

WOONPLAATS

string

40

Woonplaats object

FFWAARDE_WOZ

decimal

11,0

WOZ-Waarde

DDINGANG_WRD

datetime

Ingangsdatum waarde

DDTOESTAND

datetime

Toestandsdatum

DDHEFFING

datetime

Beginjaar heffing

INDBELANG

string

1

Indicatie eigenaar/gebruiker E - eigenaar G - gebruiker B - beide

BELANG_OMS

string

40

Omschrijving indicatie belang

INDWONING

string

1

Indicatie woning W - woning N – niet-woning

2.4

FinVerantwoordingNotificatie

Aan deze operation worden de financiele gegevens bij de aanslagen aangeboden. De gegevens zijn opgenomen in de node FINVERANTWOORDINGAANSLAG. Daarin wordt een aanslagnummer opgenomen met daaronder meerdere


12

nodes VERANTWOORDING waarin de verschillende verantwoordingsgegevens worden opgenomen. De globale opbouw van het request is als volgt:

... gegevens verantwoording ... ... De software verwacht een response waarin de unieke aanduidingen van de aangeboden aanslagen zijn opgenomen. Op basis van deze response wordt in de wachtkamer verwerkt dat de verantwoordingen van de betreffende aanslagen met succes in het midoffice zijn ontvangen en opgeslagen. De software biedt alleen aanslagen aan waarin sinds de vorige upload toegevoegde en gewijzigde verantwoordingen voorkomen. Van die aanslagen worden alle verantwoordingen opnieuw aan geboden. Er worden meerdere aanslagen in één bericht aangeboden. Het maximum aantal machtigingen in één bericht kan worden ingesteld bij de uploadsoftware (zie configuratie). De defaultwaarde is 100 aanslagen per bericht. In het verzonden bericht zijn de volgende gegevens opgenomen:

algemene gegevens onder node VERANTWOORDING NODENAME

DATATYPE

LENGTE

OMSCHRIJVING

AANSLAGNR

decimal

10,0


VOLGNR

decimal

10,0

Volgnummer van de verantwoording

BOKEY

string

20

Unieke aanduding van de aanslag in de backoffice applicatie

KFINVERANTWCAT

decimal

2,0

Kode financiële verantwoordingscategorie

KFINVERANTWCATOMS

string

200

Omschrijving kode financiële verantwoordingscategorie

KFINVERANTW

string

4,0

Kode financiële verantwoording

OOMSFINVERANTW

string

200

Omschrijving kode financiële verantwoording

DDBETALING

date

FFBEDRAG

decimal

13,2

bedrag

REGELNR

decimal

10

Unieke aanduiding van de regel in de backoffcie applicatie

INDSOORT

string

Datum betaling


niet in gebruik

13

2.5

FotoNotificatie

Aan deze operation worden de foto's van de woz-objecten aangeboden. De gegevens zijn opgenomen in de node FOTO. De globale opbouw van het request is als volgt:

<WOZBELOBJNR/> <JAAR/> De software verwacht een response waarin de unieke aanduidingen van de aangeboden foto's zijn opgenomen. Op basis van deze response wordt in de wachtkamer verwerkt dat de betreffende foto's met succes in het midoffice zijn ontvangen en opgeslagen. Er wordt één foto per bericht aangeboden. In het verzonden bericht zijn de volgende gegevens opgenomen:

algemene gegevens onder node AUTOINCASSO NODENAME

DATATYPE

LENGTE

OMSCHRIJVING

WOZBELOBJNR

decimal

10,0

WOZ objectnummer

NAAM

string

60

bestandnaam

CONTENTTYPE

string

60

contenttype

CONTENT

binary

JAAR

decimal

4,0

jaartal van de foto

OMSCHRIJVING

string

255

per definitie leeg

base64 binary met de inhoud van het bestand

De foto's worden niet vanuit de belastingsystemen geupload. De software verstuurt alle foto's die zijn vastgelegd in een in te stellen directory. In deze directory worden subdirectories opgenomen met het jaartal van de foto's als naam. De foto's zelf moeten het woz-objectnummer van het betreffende woz object bevatten. Met een masker is in de configuratie aan te geven hoe dit nummer eventueel moet worden aangevuld. Voorbeeld:


14

2.6

OpenSaldoNotificatie

Aan deze operation worden de openstaande bedragen bij de aanslagen aangeboden. De gegevens zijn opgenomen in de node OPENSALDOAANSLAG De globale opbouw van het request is als volgt:

... gegevens open saldo ... De software verwacht een response waarin de unieke aanduidingen van de aangeboden aanslagen zijn opgenomen. Op basis van deze response wordt in de wachtkamer verwerkt dat de openstaande bedragen van deze aanslagen met succes in het midoffice zijn ontvangen en opgeslagen. De software biedt alleen de sinds de vorige upload toegevoegde en gewijzigde open saldo's aan. Er worden meerdere open saldo's in één bericht aangeboden. Het maximum aantal open saldo's in één bericht kan worden ingesteld bij de uploadsoftware (zie configuratie). De defaultwaarde is 100 open saldo's per bericht. In het verzonden bericht zijn de volgende gegevens opgenomen:

algemene gegevens onder node OPENSALDO NODENAME

DATATYPE

LENGTE

OMSCHRIJVING

AANSLAGNR

decimal

10,0


OPENSALDO

decimal

13,2

Het bedrag dat nog betaald moet worden

DATUMBIJ

string

date

Laatste datum waarop dit gegeven in de backoffice toepassing is bijgewerkt

2.7

TaxatieNotificatie

Aan deze operation worden de taxatiegegevens aangeboden. De gegevens zijn opgenomen in de volgende nodes:


15

NODE

OMSCHRIJVING

TAXTAXATIE

Bevat de algemene taxatiegegevens

TAXKADOBJECT

Bevat de gegevens van de betrokken kadastrale percelen

TAXOBJECTADRES

Bevat de adresgegevens van het WOZ-object

TAXOBJECTDEEL

Bevat de taxatiegegevens van de verschillende objectdelen

TAXTRANSACTIE

Bevat de relevante marktgegevens (transacties)

TAXVERGELIJK

Bevat een verwijzing naar de referentieobjecten

TAXTAXATIE

Bevat de algemene taxatiegegevens

De globale opbouw van het request is als volgt:

... algemene gegevens taxatie ... gegevens gekoppelde kadastrale percelen ... ... aan het WOZ-object gekoppelde adressen ... ... taxatiegegevens van de objectdelen ... ... relevante marktgegevens ... ... verwijzing naar referentieobjecten ... ... De software verwacht een response waarin de unieke aanduidingen van de aangeboden taxaties zijn opgenomen. Op basis van deze response wordt in de wachtkamer verwerkt dat de betreffende taxaties met succes in het midoffice zijn ontvangen en opgeslagen. De software biedt alleen de sinds de vorige upload toegevoegde en gewijzigde taxaties aan. Wanneer een gegeven in een taxatie is gewijzigd, dan wordt de gehele taxatie opnieuw aangeboden.


16

Er worden meerdere taxaties in één bericht aangeboden. Het maximum aantal taxaties in één bericht kan worden ingesteld bij de uploadsoftware (zie configuratie). De defaultwaarde is 10 taxaties per bericht. In het verzonden bericht zijn de volgende gegevens opgenomen:

algemene gegevens onder node TAXTAXATIE NODENAME

DATATYPE

LENGTE

OMSCHRIJVING

TAXATIENR

decimal

10,0

Unieke aanduiding taxatie

WOZBELOBJNR

string

12

Wozobjectnummer

BOKEY

string

20

Sleutel backoffice taxatie

DDPEIL_WRD

date

DDTAXATIE

date

OPP_MEEGETAX

decimal

8,0

Meegetaxeerde oppervlakte

OPP_GROND

decimal

8,0

Oppervlakte grond

WIJK_OMS

string

40

Omschrijving wijk

BUURT_OMS

string

40

Omschrijving buurt

SRTOBJECT_OMS

string

50

Omschrijving soort object

INDLIGGING_OMS

string

40

Omschrijving ligging

MONUMENT_OMS

string

40

Omschrijving monument

ONTNUTSVRZCODE1_OMS

string

40

Omschrijving ontbrek. nutsv.

ONTNUTSVRZCODE2_OMS

string

40


ONTNUTSVRZCODE3_OMS

string

40


INDLIFT_OMS

string

40

Oms aanwezigheid lift

AANTEKENING

string

255

Bijzondere kenmerken

Waardepeildatum Taxatiedatum

algemene gegevens onder node TAXKADOBJECT NODENAME

DATATYPE

LENGTE

OMSCHRIJVING

TAXATIENR

decimal

10,0


KADGEMCODE

string

5

Kadastrale gemeentecode

SECTIELT

string

2

Sectieletter

PERCEELNR

string

5

Perceelnummer

INDEXLT

string

1

Indexletter

INDEXNR

string

4

Indexnummer

OPP_TOEGEKEND

decimal

8,0

Toegekende Oppervlakte

OPP_TAXGEBOUWD

decimal

8,0

Meegetaxeerde oppervlakte

XCOORD

decimal

8,0

X-coördinaat

YCOORD

decimal

8,0

Y-coördinaat


17

algemene gegevens onder node TAXOBJECTADRES NODENAME

DATATYPE

LENGTE

OMSCHRIJVING

TAXATIENR

decimal

10,0


STRAAT

string

40

Straatnaam

HUISNR

decimal

5,0

Huisnummer

HUISLT

string

1

Huisletter

TOEV

string

4

Toevoeging

AAND

string

2

Aanduiding

LOCATIE

string

40

Locatie

POSTCODE

string

6

Postcode

WOONPLAATS

string

40

Woonplaats

algemene gegevens onder node TAXOBJECTDEEL NODENAME

DATATYPE

LENGTE

OMSCHRIJVING

TAXATIENR

decimal

10,0


ONDERDEELNR

string

20

Nummer onderdeel

DEEL_OMS

string

50

Omschrijving onderdeel

BOUWJAAR

string

9

Bouwjaar

KWALITEIT_OMS

string

40

Omschrijving kwaliteit

ONDERHOUD_OMS

string

40

Onderhoudstoestand

VOORZIENING_OMS

string

40

Voorzieningen

INDTAXATIEMETHODE

string

1

Code taxatiemethodiek *)

FFWAARDE_OND

decimal

10,0

Bepaalde waarde onderdeel

INHOUD

decimal

6,0

Inhoud

INDINHOUD

string

1

Code brutto/netto (B/N)

OPPERVLAKTE

decimal

6,0

Oppervlakte

INDOPPERVLAKTE

string

1

Code bruto/netto (B/N)

JJRENOVATIE

decimal

4,0

Renovatiejaar

VERDIEPINGONTSL1_OMS

string

40

Ontsluiting verdieping 1


string

40



string

40


FFHUURWAARDE_M2

decimal

7,0

Huurwaarde per m2

FFHUURWAARDE

decimal

10,0

Huurwaarde

KAPITALISATIEFACTOR

decimal

5,1

Kapitalisatiefactor


18

algemene gegevens onder node TAXOBJECTDEEL NODENAME

DATATYPE

LENGTE

OMSCHRIJVING

FFVERVKOSTEN_EENHEI D

integer

7,0

Vervangingskosten per eenheid

FFWAARDE_VERVONGEC OR

integer

11,0

Ongecorrigeerde vervangingswaarde

VERW_LEVENSDUUR

integer

3,0

Verwachte levensduur

FFWAARDE_REST

integer

3,0

Restwaarde

FACT_TECHNVEROUD

decimal

5,3

Factor voor technische veroudering

FACT_FUNCTVEROUD

decimal

5,3

Factor voor functionele veroudering

AAEENHEID

decimal

5,0

Aantal eenheden

FFWAARDE_EENHEID

decimal

7,0

Waarde per stuk/eenheid

*) De node INDTAXATIEMETHODE kan de volgende codes bevatten: 

I = Inhoud



A = Aantal



O = Oppervlakte



G = Geen berekening



H = Huurwaardekapitalisatiefactor



S = Stichtingskosten

algemene gegevens onder node TAXTRANSACTIE NODENAME

DATATYPE

LENGTE

OMSCHRIJVING

TAXATIENR

decimal

10,0


MARKTVOLGNR

decimal

8,0

Marktvolgnummer

DDTRANSACTIE

date

FFTRANSACTIE

decimal

11,0

Transactieprijs

TRANSACTIE_OMS

string

40

Omschrijving transactie

Datum transactie

algemene gegevens onder node TAXVERGELIJK NODENAME

DATATYPE

LENGTE

OMSCHRIJVING

TAXATIENR

decimal

10,0


MARKTVOLGNR

decimal

8,0

Marktvolgnummer

WOZBELOBJNR_VGL

string

12

Wozobjectnummer referentieobject


19

3

Uploaden van statusinformatie

Om gebruikers van de frontoffice applicaties in staat te stellen de status van de afhandeling van hun aanvrage, verzoeken en bezwaren te kunnen volgen, worden deze gegevens beschikbaar gesteld voor opslag in het zakenmagazijn van het midoffice. De eerder genoemde executable handelt ook de upload van deze statusgegevens af. Deze gegevens worden echter aan een andere webservice aangeboden. Deze webservice dient de volgende operation te ondersteunen:

OPERATION

OMSCHRIJVING

StatusNotificatie

Ontvangt gegevens met betrekking tot de status van de afhandeling van bezwaren

nb. In versie 1.0 van het koppelvlak werden alle gegevens aangeboden aan één webservice. Met ingang van versie 1.5 kunnen aparte services worden ingesteld voor upload van de belastinggegevens en de upload van de statusinformatie. Configuraties waarbij beide door dezelfde service worden afgehandeld worden nog steeds ondersteund. In dat geval dient voor beide uploads dezelfde url te worden geconfigureerd.

3.1

StatusNotificatie

De status van een bezwaar kan op elk moment worden opgevraagd via de operation GetZaakGegevens van de service Getzaken (zie algemene beschrijving van deze service in de volgende paragraaf). Er worden meerdere statussen in één bericht aangeboden. Het maximum aantal statussen in één bericht kan worden ingesteld bij de uploadsoftware (zie configuratie). De defaultwaarde is 10 statussen per bericht. In het verzonden bericht zijn de volgende gegevens opgenomen:

NODENAME

DATATYPE

LENGTE

OMSCHRIJVING

ZAAKID

decimal

10,0

Unieke aanduiding van het bezwaar in de backoffice

STATUSCODE

string

10

Statuscode

STATUSOMS

string

40

Omschrijving van de status

DATUM

datetime

ZAAKID

decimal

Datum en tijd waarop de status werd bereikt 10,0

Unieke aanduiding van het bezwaar in de backoffice

De statussen worden per zaak aangeboden in de volgorde waarin ze werden bereikt. Het bericht is globaal als volgt opgebouwd:


20

<STATUS> ... <STATUSCODE>... <STATUSOMS/>... ... ...

Let op: Het zaakid in dit bericht betreft de unieke aanduiding van het bezwaar in de wachtkamer van het koppelvlak. Dit zaakid heeft is dus geen directe verwijzing naar een zaak in een eventueel in het gekoppelde midoffice opgenomen zakenmagazijn.


21

4

Het uploadproces

4.1

Configuratie van het uploadproces

De configuratie van het uploadproces wordt ingesteld in het bestand BoSyncExecute.exe.config. Dit bestand ziet er globaal als volgt uit:

<section name="exceptionHandling" type="Microsoft.Practices.EnterpriseLibrary.ExceptionHandling.Configura tion.ExceptionHandlingSettings, Microsoft.Practices.EnterpriseLibrary.ExceptionHandling, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null" /> <section name="dataConfiguration" type="Microsoft.Practices.EnterpriseLibrary.Data.Configuration.Database Settings, Microsoft.Practices.EnterpriseLibrary.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null" /> <sectionGroup name="applicationSettings" type="System.Configuration.ApplicationSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"> <section name="BoSyncExecute.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" /> <setting name="Versie" serializeAs="String"> 1.5 <setting name="KoppelvlakBelastingenService" serializeAs="String">


22

http://mobackoffice.[gemeente].nl/Koppelvlak/KoppelvlakBelasting en.asmx <setting name="ZakenNotificatieService" serializeAs="String"> http://mobackoffice.[gemeente].nl/Koppelvlak/ZakenNotificatie.as mx <setting name="UploadDirectory" serializeAs="String"> c:\temp <setting name="AantalBeschikkingen" serializeAs="String"> 100 <setting name="AantalTaxaties" serializeAs="String"> 50 <setting name="AantalAanslagen" serializeAs="String"> 100 <setting name="AantalStatussen" serializeAs="String"> 100 <setting name="AantalOpenSaldos" serializeAs="String"> 100 <setting name="AantalFinVerantwoordingen" serializeAs="String"> 100 <setting name="AantalAutIncassos" serializeAs="String"> 100 <setting name="ZakenService" serializeAs="String"> http://mobackoffice.[gemeente].nl/Zaken/GetZaken.asmx <setting name="ZakenBackofficeID" serializeAs="String"> GHS/HIS/GISVG <setting name="ZakenDocmentService" serializeAs="String"> <setting name="ZakenDocumentDirectory" serializeAs="String"> c:\document <setting name="FotoDirectory" serializeAs="String"> c:\foto <setting name="FotoMask" serializeAs="String"> ############


23

<setting name="EmailAdresBeheerder" serializeAs="String"> <exceptionHandling> <exceptionPolicies> <exceptionTypes> <exceptionHandlers> <system.net> <mailSettings> <smtp deliveryMethod="Network"> De volgende instellingen zijn hierin met name van belang: In de waarde van de setting KoppelvlakBelastingenService wordt de url van de webservice ingesteld waar de belastinggegevens aan worden aangeboden. Controleer vooraf of de URL via een internetbrowser te benaderen is. In de waarde van de setting ZakenNotificatieService wordt de url van de webservice ingesteld waar de statusinformatie aan wordt aangeboden. Controleer vooraf of de URL via een internetbrowser te benaderen is. In de waarde van de setting UploadDirectory wordt de standaard directory ingesteld waarin de berichten als bestand worden weggeschreven wanneer de betreffende optie in de userinterface is geselecteerd.


24

Met de settings AantalBeschikkingen, AantalTaxaties, AantalAanslagen, AantalStatussen, etc. kunnen de maximaal in een bericht op te nemen aantallen worden vastgelegd. Met de setting FotoDirectory wordt de directory vastgelegd waarin de foto's staan die moeten worden geupload. Deze directory dient subdirectories te bevatten met als naam het jaartal van de foto. In deze subdirectories worden de foto's opgenomen. Met de setting FotoMask wordt het masker aangegeven voor de omzetting van de bestandsnamen van de foto's. In dit masker wordt de bestandsnaam (zonder extentie) en zonodig aangevuld met voorloopnullen weergegeven met #. De overige karakters in het masker worden letterlijk overgenomen. In de waarde van de setting EmailAdresBeheerder kan een emailadres worden opgegegeven dat wordt gebruikt bij het verzenden van emailberichten bij foutsituaties Voor het gebruik van deze functionaliteit dient een lokale smtp-server beschikbaar te zijn. Wanneer wordt gekoppeld aan het passieve midoffice van Centric, dan zijn tevens de volgende settings van belang:

SETTING

OMSCHRIJVING

ZakenService

Url van de webservice van het midoffice waarmee nieuw ingediende zaken (bezwaren) kunnen worden opgevraagd.

ZakenBackofficeID

Unieke aanduiding van de backoffice applicatie die wordt gebruikt in de communicatie met de ZakenService.

ZakenDocmentService

Url van de webservice van het midoffice waarmee gekoppelde documten kunnen worden opgevraagd.

ZakenDocumentDirectory

Lokale directory waarin de ontvangen documenten worden weggeschreven.

Deze laatste vier settings worden niet gebruikt bij een koppeling met midoffice toepassingen van derden.

4.2

Opstarten en testen van het uploadproces

De applicatie kan opgestart worden door te dubbelklikken op het bestand “BoSyncExecute.exe”. Er wordt dan een dialoog getoond waarin de synchronisatie getest kan worden.


25

Na bovenstaand startscherm wordt een scherm met drie tabbladen getoond : 

algemeen



upload



download

4.2.1 tabblad 'algemeen' In dit tabblad worden de volgende gegegevens getoond: 

Versienummer van de synchronisatietool.



Parameters die worden gebruikt voor de connectie met de database.


26



Het email-adres dat wordt gebruikt voor het mailen van eventuele foutmeldingen.

Bovenstaande gegevens kunnen hier niet worden gewijzigd. Deze kunnen met een tekstverwerker rechtstsreeks in de configuratiefile worden aangepast.

4.2.2 tabblad 'upload' In dit tabblad kan worden aangegeven of de te uploaden data aan de ingestelde webservices wordt aangeboden of wordt weggeschreven als bestanden in de ingestelde directory. Daaronder worden de ingestelde aantallen per bericht getoond.


27

Tenslotte wordt aangegeven welke directory wordt gebruikt voor het ophalen van de te uploaden foto's en welk masker is ingesteld voor het omzeten van de bestandsnamen van de foto's naar het WOZ objectnummer. In dit masker wordt de bestandsnaam (zonder extentie) en zonodig aangevuld met voorloopnullen weergegeven met #. De overige karakters in het masker worden letterlijk overgenomen.

4.2.3 tabblad 'download' Het tabblad 'download' is alleen relevant voor synchronisatie met het passieve midoffice van Centric. In een koppeling met midoffice oplossingen van derden wordt geen download uitgevoerd.


28

In dit tabblad wordt getoond welke webservice wordt gebruikt voor het downloaden van zaken en welke backoffice identificatie daarbij wordt gebruikt. Tevens wordt aangegeven welke webservice wordt gebruikt voor het downloaden van gekoppelde documenten en in welke directory deze documenten worden weggeschreven. Na het indrukken van de knop 'verder' wordt onderstaand scherm getoond:

In dit scherm wordt het aantal te uploaden records weergegeven. U kunt de synchronisatie starten met de start-knop.

4.3

Opnemen van het uploadproces in de Windows Scheduler

Om de synchronisatie regelmatig uit te laten voeren zonder dat de applicatie met de hand moet worden gestart kan de applicatie opgenomen worden in de windows-scheduler.


29

De applicatie moet dan opgestart worden met de parameter /c (dus BoSyncExecute.exe /c) Hiermee wordt aangegeven dat de dialoog niet getoond moet worden maar de synchronisatie direct wordt uitgevoerd.


30

Tips: 

Let er hierbij op dat de hierboven ingevoerde windowsgebruiker beschikt over de oracle-client settings om de database te kunnen benaderen.



Bij het opnemen van de synchronisatie in de Windows Scheduler is het niet mogelijk om de commandline parameter "/c" direct toe te voegen bij het eerste scherm. Deze parameter kan pas toegevoegd worden na het toevoegen van de taak. Dat kan door in het laatste scherm het vinkje "Open advanced properties" aan te klikken. Er wordt dan een scherm getoond met een overzicht van de taak. In het veld run moet na de aanhalingstekens de parameter /c toegevoegd worden. Bijvoorbeeld: " C:\Program Files\Centric\Synchronisatie Koppelvlak Belastingen\BoSyncExecute.exe" /c


31

5

Indienen van zaken

Voor het indienen van zaken (aanvragen,verzoeken,bezwaren) wordt in het backoffice de webservice getZaken.asmx aangeboden. Deze webservice kent onder meer de volgende operations:

OPERATION

OMSCHRIJVING

CreateZaak

Creeert een nieuwe zaak in de wachtkamer. De operation geeft het zaakid van deze nieuwe zaak terug in de response.

PostZaken

Via aanroep van deze operation kan een nieuwe zaak worden aangeleverd of kan een bestaande zaak worden gewijzigd. Deze operation geeft een response met een lege rootnode terug.

Omdat bij de upload van de statusinformatie de zaak waar de status betrekking op heeft wordt aangegeven met het zaakid als unieke aanduiding, is het van belang bij het indienen van een zaak deze identificatie te ontvangen en vast te leggen bij de zaak. Daarom dient eerst met de operation CreateZaak een nieuwe zaak te worden aangemaakt. De gegeves van de betreffende zaak kunnen vervolgens met de operation PostZaken in deze zaak worden opgenomen.

5.1

CreateZaak

De operation CreateZaak verwacht een request in de volgende vorm:

... ... Met het attribuut backofficeID identificeert de gekoppelde toepassing zichzelf. In het model is voorzien in autorisatie van toepassingen voor zaaktypes. Voordat een zaak wordt aangemaakt wordt eerst gecontroleerd of de betreffende backoffice toepassing daartoe is geautoriseerd. Het attribuut zaaktype bevat het zaaktype van de betreffende zaak. De response is opgebouwd conform de globale opzet van een zaakbericht en bevat het zaakid van de nieuwe zaak. Voorbeeld van een response:

123


32

Indien een fout optreedt in de verwerking, wordt een omschrijving van deze fout geretourneerd in het volgende formaat:

<error> <description>omschrijving van de fout Indien de backoffice toepassing niet geautoriseerd is voor het betreffende zaaktype, wordt dat op bovenstaande wijze weergegeven met als omschrijving van de fout: Backoffice is niet geautoriseerd. Afhankelijk van de opgetreden foutsituatie kunnen aanvullende gegevens worden aangeleverd. Bijvoorbeeld:

<error> <description>ORA-12500: TNS:luisterproces kon proces voor toegewijde server niet opstarten. <extrainfo> <Method>Open Oracle9i <Message>ORA-12500: TNS:luisterproces kon proces voor toegewijde server niet opstarten. User ID=xxx;Password=yyy;Data Source=zzz;Pooling=true

5.2

PostZaken

De gegevens van de zaak vervolgens aangeboden als request aan de operation postZaken. De rootnode van het request is ZAKEN. Deze node bevat in ieder geval de attributen backofficeID en type. Het attribuut backofficeID bevat de unieke aanduiding van de applicatie die het request aanbiedt. Dit id wordt gebruikt voor autorisatie en is, samen met het zaaktype, bepalend voor het schema waartegen het request wordt gevalideerd. Het attribuut type bevat het zaaktype van de betreffende zaak. Vervolgens wordt de node ZK_ZAAK opgenomen. Hierbij wordt in het attribuut zaakid het zaakid opgenomen uit de response van de operation CreateZaak. Onder de node ZK_ZAAK worden eerst de algemene gegevens opgenomen. Dit betreft:

NODENAME

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

OMSCHRIJVING

String

255

ja

omschrijving van de zaak

DATUM

Date

Ja

datum indiening (formaat: jjjj-mm-dd)


33

NODENAME

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

STATUSCODE

String

10

ja

statuscode (per definitie 0)

STATUSOMS

string

40

ja

omschrijving status (per definitie ‘bericht verzonden’)

Onder de node SUBJECTEN kan de indiener worden opgenomen met specificatie van de naw-gegevens , het burgerservicenummer (sofi-nummer) en het e-mailadres. Indien identificatie plaatsvindt, kunnen de gegevens worden overgenomen uit het gegevensmagazijn (zie AanslagNotificatie). Onder de node ADRESSEN kunnen de betrokken adressen worden opgenomen. Het gaat hier niet om het adres van de indiener. Dat is opgenomen onder de node SUBJECTEN. Hier kunnen zonodig de adressen van betrokken WOZobjecten worden opgenomen (zie BeschikkingNotoficatie). Over het algemeen is dat echter niet nodig als in het bericht ook het aanslagnummer wordt aangeleverd. De overige gegevens van de zaak worden opgenomen in de node GEGEVENS. In het volgende paragrafen wordt per zaaktype aangegeven welke gegevens moeten worden aangeleverd en hoe de berichten zijn opgebouwd. De volgende zaaktypes worden in versie 2.0 ondersteund:

TYPE

OMSCHRIJVING

BZW

Bezwaar

AIA

Aanmelding machtiging automatische incasso

AIS

Intrekking machtiging automatische incasso

AIW

Wijziging rekeningnummer automatische incasso

HNDA

Aanmelding hond

HNDS

Afmelding hond

KWT

Aanvraag kwijtscheldingsformulier

UVB

Aanvraag uitstel van betaling

VBR

Verzoek betalingsregeling

5.3

Bezwaar

Onder de node SUBJECTEN wordt de belastingplichtige opgenomen in de node BELASTINGPLICHTIGE met daaronder de volgende nodes:

NODENAME

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

BSN

string

9

ja

Burgerservicenummer belastingplichtige

EMAIL

string

120

nee

E-mailadres


34

Hoewel het e-mailadres formeel niet verplicht is, is het van belang dit gegeven aan te leveren wanneer (later in het request) wordt aangegeven dat communicatie dient plaats te vinden middels e-mail. De overige gegevens van het bezwaar worden opgenomen in de node GEGEVENS. Het betreft de volgende gegevens:

NODENAME

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

BSN

string

9

ja

Burgerservicenummer belastingplichtige

EMAIL

string

120

nee

E-mailadres

AANSLAGNR

integer

10

ja

Dit is de unieke aanduiding van de aanslag zoals aangeleverd aan de operation AanslagNotificatie. Dit is dus niet het aanslagnummer zoals dat op de papieren aanslag staat.

ONTVANKELIJK

string

ja

Hiermee wordt aangegeven of het bezwaar ontvankelijk is. Toegestane waarden: J - het bezwaar is ontvankelijk N - het bezwaar is niet ontvankelijk

RETOURPOST

string

ja

Hiermee wordt aangegeven of de communicatie met de belastingplichtige over dit bezwaar per brief of per e-mail wordt gevoerd. Toegestane waarden: B - per brief E - per e-mail

TOELICHTING

string

nee

Algemene toelichting. De node TOELICHTING wordt opgenomen binnen de node ZK_TOELICHTING waarmee wordt aangegeven dat de waarde van de node wordt vastgelegd als CLOB en daarmee de lengte dus praktisch ongelimiteerd is (grootte is afhankelijk van de gebruikte database doch minstens 1Gb).

Vervolgens worden de bezwaren per aanslagregel opgenomen onder de node BEZWAAR. Voor iedere aanslagregel waartegen de belastingplichtige bezwaar maakt, wordt dus een node BEZWAAR opgenomen binnen de node GEGEVENS. Onder deze node worden de volgende gegevens opgenomen:

NODENAME

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

REGELNR

integer

10

ja

Dit is de unieke aanduiding van de aanslagregel zoals aangeleverd aan de operation AanslagNotificatie.

SOORTBEZWAAR

string

ja


Hiermee wordt de bezwaarsoort aangegeven. Toegestane waarden zijn:

35

NODENAME

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING B - belanghebbende bezwaar W - bezwaar tegen de waarde en/of objectafbakening P - pro forma bezwaar O - overig V - vrijstelling

TOELICHTING

string

nee

Toelichting bij het bezwaar. De node TOELICHTING wordt opgenomen binnen de node ZK_TOELICHTING waarmee wordt aangegeven dat de waarde van de node wordt vastgelegd als CLOB en daarmee de lengte dus praktisch ongelimiteerd is (grootte is afhankelijk van de gebruikte database doch minstens 1Gb).

Voorbeeld van een bezwaar:

bezwaar 2006-04-20 <STATUSCODE>0 <STATUSOMS>aanvraag verzonden <SUBJECTEN> 123456782 <EMAIL>[email protected] 23456 J E algemene toelichting 274 <SOORTBEZWAAR>B toelichting bij bezwaar


36

275 <SOORTBEZWAAR>W toelichting bij bezwaar

5.4

Aanmelding automatische incasso

Een gebruiker kan alleen een machtiging voor automatische incasso indienen als deze machtiging nog niet is opgenomen in het gegevensmagazijn (zie AutIncassoNotificatie). Als dat wel het geval is, dan kan de gebruiker eventueel het rekeningnummer wijzigen met zaaktype AIW.

5.4.1 algemene gegevens GEGEVEN

OMSCHRIJVING

zaaktype

AIA

omschrijving

Aanmelden automatische incasso

statuscode

0

statusoms

ingediend

5.4.2 subjectgegevens Onder de node INDIENER worden de volgende gegevens opgenomen:

NAAM

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

BSN

string

9

J

bsn / sofinummer

TELNR

string

20

telefoonnummer van de indiener

EMAIL

string

120

e-mailadres van de indiener

Indien de indiener nog niet bekend is in het belastingsysteem in de backoffice, dienen tevens de naw-gegevens te worden geupload:

NAAM

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

NAAM

string

200

J

Naam

VLT

string

10

Voorletters

VVG

string

10

Voorvoegsels


37

NAAM

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

STRNM

string

40

J

Straatnaam

HUISNR

decimal

5,0

J

Huisnummer

HUISLT

string

1

Huisletter

AAND

string

2

Aanduiding

TOEV

string

4

POSTCD

string

5

J

Postcode

WPLNM

string

40

J

Woonplaats

Toevoeging

5.4.3 specifieke gegevens NAAM

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

REKENINGNUMMER

string

9

J

bank- of girorekeningnummer

MACHTIGING

string

J

expliciete aanduiding van de machtiging (per definitie 'ja')

voorbeeld:

aanmelding automatische incasso 2006-04-20 <STATUSCODE>0 <STATUSOMS>ingediend <SUBJECTEN> 123456782 (0123)456789 <EMAIL>[email protected] 123456789 <MACHTIGING>ja

5.5

Intrekking machtiging automatische incasso


38

Een gebruiker kan alleen een machtiging intrekken als deze machtiging expliciet is opgenomen in het gegevensmagazijn (zie AutIncassoNotificatie).


OMSCHRIJVING

zaaktype

AIS

omschrijving

Intrekking automatische incasso

statuscode

0

statusoms

ingediend


NAAM

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

BSN

string

9

J

bsn / sofinummer

TELNR

string

20


EMAIL

string

120



DATATYPE

LENGTE

INTREKKEN

string

J

VERPLICHT

OMSCHRIJVING expliciete aanduiding van de intrekking (per definitie 'ja')

voorbeeld:

intrekking automatische incasso 2006-04-20 <STATUSCODE>0 <STATUSOMS>ingediend <SUBJECTEN> 123456782


39

(0123)456789 <EMAIL>[email protected] ja

5.6


Een gebruiker kan alleen het rekeningnummer wijzigen als de machtiging expliciet is opgenomen in het gegevensmagazijn (zie AutIncassoNotificatie).

GEGEVEN

OMSCHRIJVING

Zaaktype

AIW

omschrijving


statuscode

0

statusoms

ingediend


NAAM

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

BSN

string

9

J

bsn / sofinummer

TELNR

string

20


EMAIL

string

120



DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

REKENINGNUMMER

string

9

J

het nieuwe bank- of girorekeningnummer

voorbeeld:


40

wijziging rekeningnummer automatische incasso 2006-04-20 <STATUSCODE>0 <STATUSOMS>ingediend <SUBJECTEN> 123456782 (0123)456789 <EMAIL>[email protected] 123456789

5.7

Aanmelding hond

Met dit bericht kunnen één of meerdere honden worden aangemeld.

GEGEVEN

OMSCHRIJVING

Zaaktype

HNDA

omschrijving

Aanmelding hond

statuscode

0

statusoms

ingediend


NAAM

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

BSN

string

9

J

bsn / sofinummer

TELNR

string

20


EMAIL

string

120



41


NAAM

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

NAAM

string

200

J

Naam

VLT

string

10

Voorletters

VVG

string

10

Voorvoegsels

STRNM

string

40

J

Straatnaam

HUISNR

decimal

5,0

J

Huisnummer

HUISLT

string

1

Huisletter

AAND

string

2

Aanduiding

TOEV

string

4

Toevoeging

POSTCD

string

5

J

Postcode

WPLNM

string

40

J

Woonplaats


DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

AANTAL

decimal

3

J

aantal aan te melden honden

INGANGSDATUM

string

J

TOTAAL

decimal

3

WAARHEID

string

J

ingangsdatum let op: formaat dd-mm-jjjj J

totaal aantal honden dat door gebruiker na aanmelding wordt gehouden expliciete indicatie dat de gegevens naar waarheid zijn ingevuld (per definitie 'ja')

voorbeeld:

aanmelding hond 2006-04-20 <STATUSCODE>0 <STATUSOMS>ingediend <SUBJECTEN> 123456782 (0123)456789 <EMAIL>[email protected]


42

1 01-04-2006 2 <WAARHEID>ja

5.8

Afmelding hond

Er worden geen gegevens met betrekking tot aangemelde honden door de backoffice applicaties geupload. Dientengevolge kan bij afmelding geen controle op aanmelding plaatsvinden in het midoffice.


OMSCHRIJVING

Zaaktype

HNDS

omschrijving

Afmelding hond

statuscode

0

statusoms

ingediend


NAAM

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

BSN

string

9

J

bsn / sofinummer

TELNR

string

20


EMAIL

string

120



NAAM

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

NAAM

string

200

J

Naam

VLT

string

10

Voorletters

VVG

string

10

Voorvoegsels


43

NAAM

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

STRNM

string

40

J

Straatnaam

HUISNR

decimal

5,0

J

Huisnummer

HUISLT

string

1

Huisletter

AAND

string

2

Aanduiding

TOEV

string

4

POSTCD

string

5

J

Postcode

WPLNM

string

40

J

Woonplaats

Toevoeging

5.8.3 specifieke gegevens Dit formulier wordt ondersteund in twee verschijningsvormen. Bij afmelding kan een penningnummer worden doorgegeven. In dat geval kan slechts één hond per formulier worden afgemeld. Het is ook mogelijk afmelding van meerdere honden tegelijk te ondersteunen. In dat geval wordt in plaats van het penningnummer het aantal honden aangeleverd.

NAAM

DATATYPE

LENGTE

VERPLICHT

PENNINGNUMMER

string

10

penningnummer van de af te melden hond

AANTAL

decimal

1,0

aantal af te melden

INGANGSDATUM

string

J

afmelding per datum let op: formaat dd-mm-jjjj

REDEN

string

J

reden van afmelding: - overleden - overgedaan - overig

NAAM

string

200

naam van degene aan wie de hond is overgedaan

ADRES

string

60

adres van degene aan wie de hond is overgedaan

POSTCODE

string

6

postcode van degene aan wie de hond is overgedaan

WOONPLAATS

string

40

woonplaats van degene aan wie de hond is overgedaan

TOTAAL

decimal

2,0

WAARHEID

string

J

J

totaal aantal honden dat door gebruiker na afmelding wordt gehouden expliciete indicatie dat de gegevens naar waarheid zijn ingevuld (per definitie 'ja')

Voorbeeld:


OMSCHRIJVING

44

afmelding hond 2006-04-20 <STATUSCODE>0 <STATUSOMS>ingediend <SUBJECTEN> 123456782 (0123)456789 <EMAIL>[email protected] 1 01-04-2006 overgedaan J. Janssen Dorpstraat 4 1234AB <WOONPLAATS>Bergharen 2 <WAARHEID>ja

5.9


Een gebruiker kan alleen een kwijtscheldingsformulier aanvragen voor een specifieke aanslag. De gebruiker moet dus bekend zijn in het gegevensmagazijn.


OMSCHRIJVING

Zaaktype

KWT

omschrijving


statuscode

0

statusoms

ingediend


45


NAAM

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

BSN

string

9

J

bsn / sofinummer

TELNR

string

20


EMAIL

string

120



DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

AANSLAGNR

decimal

10

J

unieke aanduiding van de aanslag die is geupload (zie AanslagNotificatie).

KEUZE

string

J

gewenste wijze van ontvangst. Geldige waarden: - post - email

voorbeeld:

aanvraag kwijtscheldingsformulier 2006-04-20 <STATUSCODE>0 <STATUSOMS>ingediend <SUBJECTEN> 123456782 (0123)456789 <EMAIL>[email protected] 12345 email


46

5.10

Uitstel van betaling

Een gebruiker kan alleen uitstel van belating aanvragen voor een specifieke aanslag. De gebruiker moet dus bekend zijn in het gegevensmagazijn.


OMSCHRIJVING

Zaaktype

UVB

omschrijving

Aanvraag uitstel van betaling

statuscode

0

statusoms

ingediend


NAAM

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

BSN

string

9

J

bsn / sofinummer

TELNR

string

20


EMAIL

string

120



DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

AANSLAGNR

decimal

10

J


voorbeeld:

aanvraag uistel van betaling 2006-04-20 <STATUSCODE>0 <STATUSOMS>ingediend


47

<SUBJECTEN> 123456782 (0123)456789 <EMAIL>[email protected] 12345

5.11


Een gebruiker kan alleen uitstel van belating aanvragen voor een specifieke aanslag. De gebruiker moet dus bekend zijn in het gegevensmagazijn.


OMSCHRIJVING

Zaaktype

VBR

omschrijving


statuscode

0

statusoms

ingediend


NAAM

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

BSN

string

9

J

bsn / sofinummer

TELNR

string

20


EMAIL

string

120


5.11.3 specifieke gegevens


48

NAAM

DATATYPE

LENGTE

VERPLICHT

OMSCHRIJVING

AANSLAGNR

decimal

10

J


WERKGEVER

string

80

naam van de werkgever

VESTIGINGSPLAATS

string

40

vestigingsplaats van de werkgever

INKOMEN

decimal

6,0

het inkomen van de indiener

TERMIJNEN

string

gewenst aantal termijnen. Domein: 1-5

TOELICHTING

string

Toelichting bij het verzoek. De node TOELICHTING wordt opgenomen binnen de node ZK_TOELICHTING waarmee wordt aangegeven dat de waarde van de node wordt vastgelegd als CLOB en daarmee de lengte dus praktisch ongelimiteerd is (grootte is afhankelijk van de gebruikte database doch minstens 1Gb).

voorbeeld:

verzoek betalingsregeling 2006-04-20 <STATUSCODE>0 <STATUSOMS>ingediend <SUBJECTEN> 123456782 (0123)456789 <EMAIL>[email protected] 12345 <WERKGEVER>de Boer b.v. 12345 1200 5 toelichting bij verzoek


49

KEY2BELASTINGEN, GISVG KOPPELVLAK BELASTINGEN DERDEN

Recommend Documents