12345 Diensten aan De Belastingdienst ondersteunt bij de ontwikkeling van software voor digitaal berichtenverkeer met de Belastingdienst. In deze brochure leest u meer over onze dienstverlening en hoe u zich voor het gebruik van deze diensten aanmeldt. 1. Voor wie is deze brochure? Deze brochure is voor iedereen die software ontwikkelt voor het uitwisselen van digitale berichten met de Belastingdienst. Het kan gaan om: aangiften samenstellen en verzenden berichten verzenden door banken elektronische kopieaanslagen ontvangen en verwerken Het maakt niet uit of u de software ontwikkelt voor eigen gebruik of voor commerciële doeleinden. De Belastingdienst vindt het belangrijk dat er in het digitale berichtenverkeer zo min mogelijk uitval ontstaat. Daarom ondersteunen wij bij het ontwikkelen en testen van de software. Deze onder steuning is ondergebracht bij de Belastingdienst/Centrale administratie in Apeldoorn, Unit Ondersteuning SoftWare Ontwikkelaars (OSWO). AA 975-1Z*4FD 1
Wie is softwareontwikkelaar? Iedereen die software ontwikkelt voor digitaal berichtenverkeer met de Belastingdienst, zien wij als softwareontwikkelaar. Voorbeelden hiervan zijn: ontwikkelaars die administratie- en aangiftesoftware maken voor commerciële doeleinden belastingplichtigen en inhoudingsplichtigen die zelf aangiftesoftware ontwikkelen salarisverwerkingsbureaus en belastingconsulenten die voor hun klanten aangifte doen met eigen ontwikkelde software SBR De overheid gaat vanaf 1 januari 2013 werken met één standaard voor het aanleveren van financiële informatie aan de Belastingdienst, het CBS en de Kamer van Koophandel. Deze standaard heet Standard Business Reporting (SBR). Met SBR kunnen aangiften alleen nog worden verzonden in XBRL-formaat via Digipoort. Het gaat alleen om aangiften die ondernemers of fiscale dienstverleners rechtstreeks doen vanuit softwarepakketten. Voor ondernemers die aangifte doen via de internetsite van de Belastingdienst heeft deze overgang geen gevolgen. De standaard geldt vanaf de aangifte inkomstenbelasting en de vennootschapsbelasting over 2012 en vanaf de btw-aangifte en de opgaaf intracommunautaire prestaties (ICP) over 2014. Voor aangiften over eerdere jaren geldt de standaard niet. Als u bijvoorbeeld in 2013 een aangifte inkomstenbelasting over 2011 indient, hoeft de aangifte niet aan SBR te voldoen. De overgang naar SBR heeft niet alleen gevolgen voor het aanleverformaat (XBRL in plaats van XML) en de aanleverpoort (Digipoort in plaats van BAPI). Ook voor de beveiliging van het bericht en de authenticatie van de verzender maken we gebruik van een ander protocol, namelijk PKI-overheidscertificaten (X.509). 2. Ondersteuningsabonnement Onze diensten zijn alleen toegankelijk voor gebruikers met een onder steuningsabonnement. Dit ondersteuningsabonnement is gratis. Aanmelden U meldt u aan voor een ondersteuningsabonnement met het Aanmeld formulier softwareontwikkelaar. U vindt dit formulier op onze site www.belastingdienst.nl (zoekterm: aanmeldformulier softwareontwikkelaar). Als wij uw aanmeld formulier hebben ontvangen, neemt een medewerker van unit OSWO, meestal een accountmanager, contact met u op. De account managers beoordelen de aanvragen voor een ondersteuningsabonnement en geven voorlichting over de diensten van unit OSWO en over ontwikkelingen op de markt. Uw aanvraag voor een ondersteuningsabonnement bevestigen wij via een e-mail. In deze e-mail staan uw inloggegevens voor de speciale website en voor de Validatietestservice. 2
2.1. Diensten Met het ondersteuningsabonnement hebt u toegang tot: de website Community Software Ontwikkeling voor de actuele releases van de berichtstromen actueelberichten servicedesk testfaciliteiten (zie hoofdstuk 4) Community Software Ontwikkeling De Community Software Ontwikkeling is het loket voor communicatie tussen u en de unit OSWO. De community biedt een overzicht van alle door ons uitgebrachte releases. In deze releases vindt u per berichtstroom de specificaties, toelichtingen en dergelijke die u nodig hebt voor de ontwikkeling en aanpassing van uw software. Ook vindt u op de community links naar informatie van andere organisaties. Als u vragen hebt, stelt u deze aan de servicedesk via de community. Uw vragen zijn niet zichtbaar voor andere gebruikers. Daarnaast kunt u op de community in een forum discussiëren met andere software ontwikkelaars en kennis delen. Ook bieden wij RSS-feeds aan. Actueelberichten Met de actueelberichten informeren wij abonnees over bijvoorbeeld wijzigingen in de specificaties van een belastingmiddel of berichten stroom. We brengen u via e-mail op de hoogte van de publicatie van een actueelbericht. Ook kunt u de actueelberichten ontvangen via RSS-feeds. Servicedesk Onze servicedesk is voor abonnees bereikbaar via de community. Nadat u hebt ingelogd kunt u met uw vragen terecht bij de servicedesk. Let op! Voor fiscaalinhoudelijke vragen die niet te maken hebben met de ontwikkeling van aangifte- of administratiesoftware belt u de BelastingTelefoon: 0800-0543, bereikbaar van maandag tot en met donderdag van 8.00 tot 20.00 uur en op vrijdag van 8.00 tot 17.00 uur. 3
2.2. Doelgroepen U krijgt alleen toegang tot de accounts waarvoor u bent geregistreerd en die voor de ontwikkeling van uw software van belang zijn. Als u bijvoorbeeld software ontwikkelt voor salarisadministraties, krijgt u geen informatie over btw. In de tabel leest u welke accounts we ondersteunen en welke berichtstromen daarbij horen. Overzicht accounts Account Fiscaal Financieel Salaris Generieke diensten Banken en Beleggingsproducten Berichtstromen aangiften inkomstenbelasting en vennootschapsbelasting uitstel inkomstenbelasting en vennootschapsbelasting aanwijzen aangiften uitstelregeling belastingconsulenten (aanwijs inkomstenbelasting en vennootschapsbelasting) vooraf ingevulde aangifte verzoek of wijziging voorlopige aanslag elektronische kopieaanslagen melding gebeurtenissen Toeslagen door fiscaal intermediairs opgaaf intracommunautaire prestaties btw-aangifte teruggaaf btw uit andere EU-landen (omzetbelasting verzoek refund) loonheffingen jaarloonopgaaf eerstedagsmelding weekaanleveringen loonheffingen Belastingdienst/Caraïbisch Nederland groteberichtenkanaal (FOS) kleineberichtenkanaal (BAPI en BAPI Client) webdiensten (webkanaal DigiD) Digipoort (koppelvlak Digipoort) gegevensaanleveringen 4
3. Releases, communicatiekanalen en beveiliging In dit hoofdstuk vindt u informatie over releases, communicatiekanalen en beveiligingstechnieken. 3.1. Releases Voor iedere digitale berichtenstroom zijn releases beschikbaar. Een release bevat een set van specificaties. Hiermee kunt u uw software geschikt maken voor het aanmaken van een bepaalde berichtstroom. De releases zijn voor alle middelen op dezelfde manier opgebouwd: Onderdeel Inhoud 0. Releasenotes Informatie over de inhoud van een release en de veranderingen ten opzichte van een vorige release. 1. Dialoogschema Beschrijving van de samenhang en de kenmerken van de uit te wisselen berichten. Een dialoogschema geeft de stappen van een digitaal bericht weer en welke responses daarop gegenereerd worden. 2. Gegevensspecificaties informatie over de fiscale status van de uitgevraagde gegevens, de voorwaarden waaraan Beschrijving van de eisen aan de gegevens in het bericht. Een gegevens specificatie bevat ze moeten voldoen en de onderlinge samenhang. 3. Bericht specificaties Beschrijving van de structuur en het formaat van het bericht. In de berichtspecificaties is ook het xsd-schema opgenomen. 4. Voorzieningenspecificaties bijvoorbeeld kleineberichtenkanaal (BAPI). Ook zijn hieronder de specifi caties voor de Beschrijving van het kanaal of de kanalen waarlangs het bericht kan worden aan geleverd, Validatietestservice (VTS) en de pre-productieomgeving (PPO) opgenomen. 5. Servicedocumenten Bevatten voorbeeldaangiften in pdf en voorbeeldbestanden. 3.2. Communicatiekanalen Voor het doen van digitale aangiften en opgaven zijn de volgende communicatiekanalen (koppelvlakken) beschikbaar: kleineberichtenkanaal (BAPI) Momenteel is dit het meest gebruikte kanaal voor het inzenden van aangiften en opgaven aan de Belastingdienst. Het wordt ook wel het BAPI-kanaal (Belastingdienst Advanced Program Integration) genoemd. Het kleineberichtenkanaal is gebaseerd op het SMTP-protocol. De komende jaren wordt het kleineberichtenkanaal vervangen door Digipoort. groteberichtenkanaal (FOS) Het groteberichtenkanaal wordt alleen gebruikt voor loonaangiften van organisaties met meer dan 5.000 werknemers. Het groteberichtenkanaal is gebaseerd op het FTP-protocol. webkanaal Dit kanaal wordt voor de inzending van aangiften Inkomstenbelasting door particulieren via DigiD gebruikt. Digipoort via SOAP Dit kanaal is bestemd voor de inzending van berichten in XBRL-formaat en wordt beheerd door Logius. Hierbij wordt gebruikgemaakt van SOAP over HTTP. Digipoort via FTP Dit kanaal is bestemd voor het inzenden van berichten door banken en verzekeraars. Ook aanvragen voor teruggaaf btw uit andere EU-landen (omzetbelasting verzoek refund) worden via dit kanaal ingezonden. De specificaties en toelichtingen voor deze kanalen kunt u downloaden via de community. 5
3.3. Beveiligingstechnieken Voor de beveiliging van berichten gebruiken we verschillende technieken: kleineberichtenkanaal (BAPI) Het kleineberichtenkanaal maakt gebruik van het SMTP- of het SMTP/S-protocol. Encryptie van berichten gebeurt met een digitaal certificaat. Ook voor de authenticatie kan degene die het bericht aanlevert gebruikmaken van een digitaal certificaat. In sommige gevallen is een pincode voldoende. groteberichtenkanaal (FOS) Het groteberichtenkanaal maakt voor het beveiligen van de verbinding gebruik van het FTP/S-protocol. Authenticatie van degene die het bericht aanlevert, gebeurt met een gebruikersnaam en een wachtwoord. webkanaal Het webkanaal voor particuliere aangevers wordt beveiligd door middel van het HTTP/S-protocol. De authenticatie van degene die het bericht aanlevert, gebeurt met DigiD. Digipoort via SOAP Voor de beveiliging van berichten in XBRL via Digipoort wordt gebruikgemaakt van PKI met zogenoemde client-sidecertificaten (X.509 certificaten). Digipoort via FTP Voor de beveiliging van dit kanaal wordt gebruikgemaakt van Transport Layer Security. 4. Software testen U kunt gebruikmaken van onze testfaciliteiten. Met deze faciliteiten test u of de berichten uit uw software technisch te verwerken zijn. Ook de werking van communicatie- en beveiligingssoftware kunt u testen. Let op! U kunt niet de fiscale juistheid van een bericht testen, wel de consistentie van de gegevens in het bericht. 4.1. Testfaciliteiten U kunt de berichten testen met: de validatietestservice (VTS) Hiermee test u of uw berichten verwerkt kunnen worden. de preproductieomgeving (PPO) Met de PPO test u de communicatie en de beveiliging van berichten. de spiegeltestservice Met de spiegeltestservice kunt u berichten testen. Uw bestand wordt gepresenteerd als een ingevulde aangifte, zodat u kunt controleren of de gegevens op de juiste plek staan en de juiste waarden hebben. De spiegeltestservice is nog in ontwikkeling. Om gebruik te maken van onze testfaciliteiten hebt u extra inloggegevens nodig. In de e-mail met de bevestiging van het ondersteuningsabonnement vindt u de inloggegevens voor de validatietestservice. De inloggegevens voor de PPO kunt u aanvragen via onze servicedesk. 6
Validatietestservice De validatietestservice is een webapplicatie waarmee u zelf berichten test. Een link naar deze webservice vindt u op onze community. Nadat u hebt ingelogd kunt u een XML- of XBRL-testbericht aanbieden. Het testbericht wordt aan de volgende controles onderworpen: XML-bericht wellformed-controle syntaxcontrole consistentiecontrole XBRL-bericht wellformed-controle XBRL syntaxvalidatie XBRL FRIS-validatie XBRL taxonomievalidatie Direct na de validatietest krijgt u een testverslag op het beeldscherm. Preproductieomgeving Met de preproductieomgeving controleert u de dialoog tussen inzender en ontvanger. U test verschillende aspecten van het uitwisselen van berichten: verbinding opzetten bericht insturen beveiliging, ondertekening, encryptie controle van het bericht retourberichten verwerken U krijgt terugkoppeling over de testresultaten. Bij deze test onderscheiden we het kleineberichtenkanaal (BAPI), het groteberichten kanaal (FOS) en het webkanaal. Informatie over het testen van de verbinding met Digipoort vindt u op de internetsite van Logius: www.logius.nl. 5. Hebt u nog vragen? Hebt u na het lezen van deze brochure nog vragen over de producten en diensten voor? Kijk dan op www.belastingdienst.nl en zoek op softwareontwikkeling. U kunt ons ook e-mailen op: info@oswo.nl. Dit is een uitgave van Belastingdienst Augustus 2011 7