Berichtenboek. Suite4Omgevingsdiensten. Betalen en Invorderen

Transcriptie

1 Berichtenboek Suite4Omgevingsdiensten Betalen en Invorderen

2 Berichtenboek Betalen en Invorderen Copyright Centric The Netherlands All rights reserved. No part of this publication may be reproduced, stored in a retrieval system or disclosed in any form or by any means, whether electronically, mechanically, by photocopying, recording or otherwise, without written permission from Centric Netherlands B.V. 2 van

3 Berichtenboek Betalen en Invorderen Inhoudsopgave Versies... 4 Algemene koppelvlakinformatie... 5 Koppelvlakinstellingen... 6 Bericht: VerstrekVordering van

4 Berichtenboek Betalen en Invorderen Versies Datum Auteur Wijzigingen W. van Weelden Eerste versie 4 van

5 Berichtenboek Betalen en Invorderen Algemene koppelvlakinformatie Met het koppelvlak Betalen en Invorderen (StUF-FIN) geeft u leges door aan het financiële systeem. Het financiële systeem zorgt voor het factureren en invorderen van de leges. Dit koppelvlak werkt met elk financieel systeem dat de open standaard StUF- FIN ondersteunt. Deze koppelvlakbeschrijving bevat alleen een beschrijving van de berichtelementen waar de definitie van de standaard StUF-FIN onvoldoende is om een koppelvlak te realiseren. Bijvoorbeeld hoe de Suite4Omgevingsdiensten vorderingcode gebruikt. De velden waarvoor de StUF-standaard toereikend zijn, staan niet in deze beschrijving. Onderdeel Methode Module Ondersteunde berichten Toelichting GSOAP Vergunningen Activiteiten Milieu VerstrekVordering 5 van

6 Koppelvlakinstellingen In deze sectie staan alle instellingen van het koppelvlak. U wijzigt deze instellingen op de pagina Koppelvlakinstellingen in de module Autorisatie. Bericht Instelling Toelichting Verplicht Alle Standaard URI De endpoint waar het systeem de uitgaande berichten naar toe verstuurt. Alle RSIN van vorderende organisatie Het standaard RSIN van de organisatie aan wie de leges moeten worden betaald. Het systeem gebruikt deze standaardwaarde als er voor het bevoegd gezag van het dossier geen RSIN beschikbaar is. Alle Ontvangende applicatie De code of naam van de applicatie die het bericht ontvangt. Stem met het financiële systeem af welke waarde deze instelling moet hebben. VerstrekVordering Bericht URI Laat dit attribuut leeg. 6 van

7 Bericht: VerstrekVordering Berichtbeschrijving Onderdeel Soort bericht Beschrijving Toelichting Uitgaand Het bericht VerstrekVordering stuurt een of meer legesfacturen naar het financiële systeem Gegevensmapping Gegeven Toelichting Locatie in XML Algemene factuuromschrijving De omschrijving van het dossiertype waarbinnen de leges zijn opgelegd. vrdlk01/object/algemenefactuuromschrijving BIC BIC Het BIC van de debiteur. Dit gegevens is opgenomen in de extraelementen omdat er geen goede plaats was binnen de standaard. Alleen beschikbaar als de IBAN beschikbaar is in de Suite4Omgevingsdiensten. Het BIC van de debiteur. Dit gegevens is opgenomen in de extraelementen omdat er geen goede plaats was binnen de standaard. Alleen beschikbaar als de IBAN beschikbaar is in de Suite4Omgevingsdiensten. vrdlk01/object/wordtbetaalddoornatuurlijkpersoonalsdebiteur/extraelementen/ vrdlk01/object/wordtbetaalddoornietnatuurlijkpersoonalsdebiteur/ 7 van

8 Gegeven Toelichting Locatie in XML BTW-categorie BTW-percentage Bedrag BTW Bedrag exclusief BTW (vorderingregel) Bedrag inclusief BTW (vorderingsregel) Creatiedatum Debiteurnummer De BTW-categorie van de legesregel. Op leges mag geen BTW worden geheven en daarom moet de vordering volledig zonder BTW worden geheven (vrijgesteld van BTW). Omdat de standaard een BTW-categorie vereist, is de waarde van dit element altijd: NUL. Het financiële systeem moet dit intern correct vertalen naar een vordering zonder BTW. Het BTW-percentage van de vorderingsregel. Dit is altijd 0. Het totaal verschuldigde BTW-bedrag. Het is niet toegestaan om BTW over leges te heffen. Deze waarde is daarom altijd 0. Het bedrag exclusief BTW in centen. Dit is het bedrag voor een enkele legesregel. Het bedrag inclusief BTW in centen. Omdat er geen BTW op leges geheven mag worden, is dit bedrag altijd hetzelfde als het bedrag exclusief BTW. De datum dat de Suite4Omgevingsdiensten deze vordering heeft aangemaakt. Het debiteurnummer van de natuurlijke persoon. Alleen beschikbaar wanneer het debiteurnummer bekend is in de Suite4Omgevingsdiensten. vrdlk01/object/vorderingsregel/btwcategorie vrdlk01/object/vorderingsregel/btwpercentage vrdlk01/object/vorderingsregel/bedragbwt vrdlk01/object/vorderingsregel/bedragexclbtw vrdlk01/object/vorderingsregel/bedraginclbtw vrdlk01/object/creatiedatum vrdlk01/object/wordtbetaalddoornatuurlijkpersoonalsdebiteur/debiteurnummer 8 van

9 Gegeven Toelichting Locatie in XML Factuur uitgestuurd Factuurnummer De Suite4Omgevingsdiensten stuurt geen facturen als het koppelvlak is ingesteld. De waarde is altijd: N Het nummer van de vordering. Deze waarde is gelijk aan het Vorderingsnummer. vrdlk01/object/indicatorfactuuruitgestuurd vrdlk01/object/factuurnummer IBAN IBAN Het IBAN van de debiteur. Dit gegevens is opgenomen in de extraelementen omdat er geen goede plaats was binnen de standaard. Alleen beschikbaar als de IBAN beschikbaar is in de Suite4Omgevingsdiensten. Het IBAN van de debiteur. Dit gegevens is opgenomen in de extraelementen omdat er geen goede plaats was binnen de standaard. Alleen beschikbaar als de IBAN beschikbaar is in de Suite4Omgevingsdiensten. vrdlk01/object/wordtbetaalddoornatuurlijkpersoonalsdebiteur/extraelementen/ extraelement/@naam='iban' vrdlk01/object/wordtbetaalddoornietnatuurlijkpersoonalsdebiteur/ extraelementen/extraelement/@naam='iban' Indicator publiekrechterlijk Is onstaan in Zaak Vaste waarde: Ja Het zaak-id van de zaak waarbinnen de leges zijn opgelegd. Alleen beschikbaar wanneer de leges binnen een zaak zijn opgelegd. Voor leges die buiten een zaak zijn opgelegd, ontbreekt dit element. vrdlk01/object/indicatorpubliekrechtelijk vrdlk01/object/isontstaaninzaak/gerelateerde/identificatie 9 van

10 Gegeven Toelichting Locatie in XML KVK-nummer Natuurlijk persoon als debiteur Niet-natuurlijk persoon als debiteur Ontvangende applicatie Taakstellende applicatie Tenaamstelling rekeningnummer Het KVK-nummer van de niet-natuurlijke persoon. Dit gegeven is opgenomen in de extraelementen omder er geen goede plaats was binnen de standaard. Alleen beschikbaar als het KVKnummer beschikbaar is binnen de Suite4Omgevingsdiensten. Element met de gegevens van de debiteur. Alleen beschikbaar als de debiteur een natuurlijk persoon is. Element met de gegevens van de debiteur. Alleen beschikbaar als de debiteur een nietnatuurlijk persoon is. De code van de ontvangende applicatie. Deze waarde van dit veld is een instelling van het koppelvlak in de Suite4Omgevingsdiensten. Attribuut: Ontvangende applicatie. Vaste waarde: K2V De tenaamstelling van het rekeningnummer van de debiteur. Dit gegevens is opgenomen in de extraelementen omdat er geen goede plaats was binnen de standaard. Alleen beschikbaar als de Tenaamstelling beschikbaar is in de Suite4Omgevingsdiensten. vrdlk01/object/wordtbetaalddoornietnatuurlijkpersoonalsdebiteur/ vrdlk01/object/wordtbetaalddoornatuurlijkpersoonalsdebiteur vrdlk01/object/wordtbetaalddoornietnatuurlijkpersoonalsdebiteur stuurgegevens/ontvanger/applicatie vrdlk01/object/tsa vrdlk01/object/wordtbetaalddoornatuurlijkpersoonalsdebiteur/extraelementen/ 10 van

11 Gegeven Toelichting Locatie in XML Tenaamstelling rekeningnummer Totaalbedrag BTW Totaalbedrag exclusief BTW De tenaamstelling van het rekeningnummer van de debiteur. Dit gegevens is opgenomen in de extraelementen omdat er geen goede plaats was binnen de standaard. Alleen beschikbaar als de Tenaamstelling beschikbaar is in de Suite4Omgevingsdiensten. Het totaal verschuldigde BTW-bedrag. Het is niet toegestaan om BTW over leges te heffen. Deze waarde is daarom altijd 0. Het verschuldigde legesbedrag in centen vrdlk01/object/wordtbetaalddoornietnatuurlijkpersoonalsdebiteur/ vrdlk01/object/totaalbedragbtw vrdlk01/object/totaalbedragexclbtw Totaalbedrag inclusief BTW Het toaal verschuldigde legesbedrag in centen. Omdat er geen BTW op leges geheven mag worden, is dit bedrag altijd hetzelfde als het bedrag exclusief BTW. vrdlk01/object/totaalbedraginclbtw Valutacode Vaste waarde: EUR vrdlk01/object/valutacode Verderingcode Verzendende applicatie De code van de vordering om de leges te inboeken. Hier staat de code van de legesregel waarop de vorderingsregel is gebaseerd. Het financiële kan deze code koppelen aan een grootboek. Vaste waarde: K2V vrdlk01/object/vorderingsregel/vorderingcode stuurgegevens/zender/applicatie Vorderingomschrijving De omschrijving van de legesregel waarop de vorderingsregel is gebaseerd. vrdlk01/object/vorderingsregel/ vorderingsomschrijving 11 van

12 Gegeven Toelichting Locatie in XML Vorderingsnummer Het nummer van de vordering Dit nummer is uniek per vordering. vrdlk01/object/vorderingnummer Vorderingtype Het soort vordering. Als de legesregel een kortingslege is, is de waarde VRM. Als het legesbedrag < 0 en het is geen kortingsregel, dan is de waarde CRE. In alle andere gevallen is de waarde FAC. vrdlk01/object/vorderingsregel/vorderingtype 12 van