Melderegisterauskunft
Allgemeines
Voraussetzungen
- Ein Payment ist bereits eingerichtet am Mandanten.
- PDF und Assistentenrecht sind beim Mandanten vorhanden.
Relevante Daten
- WebService-Url
- Amtlicher Gemeindeschlüssel (AGS)
- X-username (base64-codierter Benutzername für das HSH Soft- und Hardware Vertriebs GmbH-System)
- X-password (base64-codiertes Passwort für das HSH Soft- und Hardware Vertriebs GmbH-System)
- Briefbogen des Kunden
Konfiguration des WebServices
Es muss sichergestellt werden, dass der WebService "HSH-Melderegisterauskunft" bereits zur Verfügung steht (siehe hierzu "Webservice Einrichten)". Hierzu kann entweder der Reiter Web Services - WebService-Definition oder WebService-Konfiguration genutzt werden. Ist die Replikation eingerichtet, sollte der WebService bereits vorhanden sein.
Unter "WebService-Konfiguration" müssen anschließend die obigen erwähnten Daten erfasst werden. Hierzu wird der WebService-Name "HSH-Melderegisterauskunft", die WebService-OrganisationsID "22222222-2222", sowie die von dem Anbieter bereitgestellte, bestenfalls aktuellste WebService-Version ausgewählt. Anschließend wird die WebService-URL eingetragen, beispielsweise "https://www.meldebehoerde.de:443/cebit/IRWS/ws/XMeld24Service".
"Werte für HTTP-Basic Authentifikation" sind standardmäßig nicht zu befüllen.
"Werte für Zertifikatsauthentifizierung" sind standardmäßig nicht zu befüllen. Eine Einrichtung wird dennoch von Mach ProForms GmbH empfohlen.
"Werte für Queue-Messaging Konfiguration" sind standardmäßig nicht zu befüllen. Eine Einrichtung wird dennoch von Mach ProForms GmbH empfohlen (siehe hierzu "Security Paket)".
Die Aktionsparameter sind zu definieren (siehe hierzu "Webservice Einrichten"). Diese sind je XMeld Version abweichend. Nachfolgend ein Beispiel der Version 2.4. Die Werte der Parameter sind je nach Kunden spezifisch anzupassen.
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}nachrichtenkopf*.{http://www.osci.de/xmeld24}anwenderkennung
Wert des Parameters
TESTUSER
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}nachrichtenkopf*.{http://www.osci.de/xmeld24}empfaenger*.{http://www.osci.de/xmeld24}ORGANISATIONSEINHEIT[0].{http://www.osci.de/xmeld24}hierarchieebene*
Wert des Parameters
1
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}nachrichtenkopf*.{http://www.osci.de/xmeld24}empfaenger*.{http://www.osci.de/xmeld24}erreichbarkeit[0].kanal*.code*
Wert des Parameters
01
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}nachrichtenkopf*.{http://www.osci.de/xmeld24}empfaenger*.{http://www.osci.de/xmeld24}erreichbarkeit[0].kennung*
Wert des Parameters
support@hsh-berlin.com
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}anwenderkennung
Wert des Parameters
TESTUSER
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}auskunft\.anforderung[0]*.{http://www.osci.de/xmeld24}anfragedaten*.{http://www.osci.de/xmeld24}gewerblicherZweck.{http://www.osci.de/xmeld24}angabeDesZwecks*.{http://www.osci.de/xmeld24}code[0].code*
Wert des Parameters
2
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}auskunft\.anforderung[0]*.{http://www.osci.de/xmeld24}anfragedaten*.{http://www.osci.de/xmeld24}gewerblicherZweck.{http://www.osci.de/xmeld24}geschaeftszeichen*
Wert des Parameters
TEST§
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}auskunft\.anforderung[0]*.{http://www.osci.de/xmeld24}anfragedaten*.{http://www.osci.de/xmeld24}zumZweckdesAdresshandels*
Wert des Parameters
false
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}auskunft\.anforderung[0]*.{http://www.osci.de/xmeld24}anfragedaten*.{http://www.osci.de/xmeld24}zumZweckDerWerbung*
Wert des Parameters
true
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}auskunft\.anforderung[0]*.{http://www.osci.de/xmeld24}technische\.einzelidentifikation*.{http://www.osci.de/xmeld24}ereigniszeitpunkt*
Wert des Parameters
2019-01-01T08:20:54
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}auskunft\.anforderung[0]*.{http://www.osci.de/xmeld24}steuerungsinformationen.{http://www.osci.de/xmeld24}option\.auskunft[0].code*
Wert des Parameters
01
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}auskunft\.anforderung[0]*.{http://www.osci.de/xmeld24}anfragedaten*.{http://www.osci.de/xmeld24}einwilligungWurdeErteilt[0].code*
Wert des Parameters
1
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}nachrichtenkopf*.{http://www.osci.de/xmeld24}identifikation\.nachricht*.{http://www.osci.de/xmeld24}erstellungszeitpunkt*
Wert des Parameters
2019-01-01T08:20:54
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}auskunft\.anforderung[0]*.{http://www.osci.de/xmeld24}anfragedaten*.{http://www.osci.de/xmeld24}zeicheneinzelfall
Wert des Parameters
Adressermittlung
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600{http://www.osci.de/xmeld24}auskunft\.anforderung[0]*.{http://www.osci.de/xmeld24}datenZurAnfrage*.{http://www.osci.de/xmeld24}name*.{http://www.osci.de/xmeld24}phonetik
Wert des Parameters
true
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}auskunft\.anforderung[0]*.{http://www.osci.de/xmeld24}technische\.einzelidentifikation*.{http://www.osci.de/xmeld24}zeicheneinzelfall*
Wert des Parameters
TESTANFRAGE
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600:produkthersteller*
Wert des Parameters
HSH
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600:produkt*
Wert des Parameters
OLMERA
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}auskunft\.anforderung[0]*.{http://www.osci.de/xmeld24}anfragedaten*.{http://www.osci.de/xmeld24}einwilligungWurdeErteilt[0]:listVersionID
Wert des Parameters
1
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}auskunft\.anforderung[0]*.{http://www.osci.de/xmeld24}anfragedaten*.{http://www.osci.de/xmeld24}gewerblicherZweck.{http://www.osci.de/xmeld24}angabeDesZwecks*.{http://www.osci.de/xmeld24}code[0]:listVersionID*
Wert des Parameters
1
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}nachrichtenkopf*.{http://www.osci.de/xmeld24}empfaenger*.{http://www.osci.de/xmeld24}ANSCHRIFT.gemeindeschluessel:listVersionID*
Wert des Parameters
1
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}zeichennachricht
Wert des Parameters
TEST2
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}auskunft\.anforderung[0]*.{http://www.osci.de/xmeld24}anfragedaten*.{http://www.osci.de/xmeld24}gewerblicherZweck.{http://www.osci.de/xmeld24}angabeDesZwecks*.{http://www.osci.de/xmeld24}freitext
Wert des Parameters
ADRESSERMITTLUNG
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}nachrichtenkopf*.{http://www.osci.de/xmeld24}empfaenger*.{http://www.osci.de/xmeld24}behoerdenkennung*
Wert des Parameters
ags:00000000
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}nachrichtenkopf*.{http://www.osci.de/xmeld24}empfaenger*.{http://www.osci.de/xmeld24}ANSCHRIFT.gemeindeschluessel.code*
Wert des Parameters
00000000
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\.anforderung\.0600.{http://www.osci.de/xmeld24}nachrichtenkopf*.{http://www.osci.de/xmeld24}identifikation\.nachricht*.{http://www.osci.de/xmeld24}nachrichtennummer*.code*
Wert des Parameters
0600
Aktionsname des WebServices
abfrage0600
Parametername
{XMeld24Auskunft}abfrage0600.{http://www.osci.de/xmeld24}melderegisterauskunfteinfach\\.anforderung\\.0600.{http://www.osci.de/xmeld24}nachrichtenkopf*.{http://www.osci.de/xmeld24}identifikation\\.nachricht*.{http://www.osci.de/xmeld24}tagesvorgangszaehler*
Wert des Parameters
1
Für die Version 2.3 sind alle Referenzen {XMeld24Auskunft} mit {XMeld23Auskunft}, sowie {http://www.osci.de/xmeld24} mit {http://www.osci.de/xmeld23} zu ersetzen. Die Werte "00000000" sind mit dem amtlichen Gemeindeschlüssel auszutauschen.
Unter "WebService-HeaderParameter" sind die obigen erwähnten Parameter "X-username" und "X-password" zu hinterlegen.
Einbindung des Briefbogens
Aufbereitung
Der Briefbogen wird in ein mappbares PDF umgewandelt und mit assistentenspezifischen Feldern versehen, welches auf die MACH formsolutions Plattform hochgeladen wird. Auf Grund der spezifischen Felder wird eine Beauftragung von MACH ProForms GmbH zur Umwandlung und Einbindung empfohlen.
Einbindung als Auskunft
Damit die Melderegisterauskunft nach dem Bezahlvorgang ausgegeben wird, muss in der Veröffentlichungsmaske die "automatische Assistentenantwortgenerierung" das zuvor hochgeladene PDF ausgewählt werden.
Über den Fieldmapping-Button auf der rechten Seite, muss das entsprechende Mapping erfolgen.
