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.

Webservice-Definition

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".

Webservice Definition

"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 von Form-Solutions jedoch empfohlen.

"Werte für Queue-Messaging Konfiguration" sind standardmäßig nicht zu befüllen. Eine Einreichtung wird von Form-Solutions jedoch empfohlen (siehe hierzu "Security Paket)".

Webservice Konfigurationsmaske

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.

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}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

Webservice Header Parameter

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 am Formularserver hochgeladen wird. Auf Grund der spezifischen Felder wird eine Beauftragung von Form-Solutions 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.

Veröffentlichung

Konfiguration Assistentenantwortgenerierung Über den Fieldmapping-Button auf der rechten Seite, muss das entsprechende Mapping erfolgen.

Mapping PDF

Tags: