Briefwahlscheinantrag
Allgemeines
Voraussetzungen
- Ein Paymentanbieter ist bereits eingerichtet.
- Assistentenrechte für den Mandanten sowie den Benutzer sind vorhanden.
- Modulkonfigurationsrechte für den Mandanten sowie für den Benutzer sind vorhanden.
Relevante Daten
- WebService-Url
- Amtlicher Gemeindeschlüssel (AGS)
- X-ApiKey
- Referer
Konfiguration des WebServices
Es muss sichergestellt werden, dass die WebServices "HSH-Spezifizierter Briefwahlscheinantrag" und "HSH-Briefwahlscheinantrag" bereits zur Verfügung stehen (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-Briefwahlscheinantrag", 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/IRWSBV/soap/oliwa/v2/wahlschein".
Dieselbe Konfiguration wird für den WebService "HSH-Spezifizierter Briefwahlscheinantrag" vorgenommen.
"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").
Die Werte der Parameter sind je nach Kunden spezifisch anzupassen.
Nachfolgend werden die Aktionsparameter für "HSH-Briefwahlscheinantrag" aufgelistet.
wahlliste
Parametername
{http://wahlschein.v2.oliwa.services.endpoint.ireg.web.hshsoft.de/}wahlliste:produkt
Wert des Parameters
Informationsregister
Aktionsname des WebServices
wahlliste
Parametername
{http://wahlschein.v2.oliwa.services.endpoint.ireg.web.hshsoft.de/}wahlliste:produkthersteller
Wert des Parameters
HSH Soft- und Hardware Vertriebs GmbH
Aktionsname des WebServices
wahlliste
Parametername
{http://wahlschein.v2.oliwa.services.endpoint.ireg.web.hshsoft.de/}wahlliste:produktversion
Wert des Parameters
1.10
Aktionsname des WebServices
wahlliste
Parametername
{http://wahlschein.v2.oliwa.services.endpoint.ireg.web.hshsoft.de/}wahlliste:version
Wert des Parameters
1
Aktionsname des WebServices
wahlqrentschluesselung
Parametername
{http://wahlschein.v2.oliwa.services.endpoint.ireg.web.hshsoft.de/}wahlqrentschluesselung.{http://www.hshsoft.de/service/olav-ws-nachrichten/v1}gemeindeschluessel*
Wert des Parameters
00000000
Aktionsname des WebServices
wahlqrentschluesselung
Parametername
{http://wahlschein.v2.oliwa.services.endpoint.ireg.web.hshsoft.de/}wahlqrentschluesselung:fassung
Wert des Parameters
2019-01-01
Aktionsname des WebServices
wahlqrentschluesselung
Parametername
{http://wahlschein.v2.oliwa.services.endpoint.ireg.web.hshsoft.de/}wahlqrentschluesselung:produkt
Wert des Parameters
Informationsregister
Aktionsname des WebServices
wahlqrentschluesselung
Parametername
{http://wahlschein.v2.oliwa.services.endpoint.ireg.web.hshsoft.de/}wahlqrentschluesselung:responsewithoutrequest
Wert des Parameters
?
Aktionsname des WebServices
wahlqrentschluesselung
Parametername
{http://wahlschein.v2.oliwa.services.endpoint.ireg.web.hshsoft.de/}wahlqrentschluesselung:produktversion
Wert des Parameters
1.10
Aktionsname des WebServices
wahlqrentschluesselung
Parametername
{http://wahlschein.v2.oliwa.services.endpoint.ireg.web.hshsoft.de/}wahlqrentschluesselung:produkthersteller
Wert des Parameters
HSH Soft- und Hardware Vertriebs GmbH
Aktionsname des WebServices
wahlqrentschluesselung
Parametername
{http://wahlschein.v2.oliwa.services.endpoint.ireg.web.hshsoft.de/}wahlqrentschluesselung:produktversion
Wert des Parameters
1.10
Aktionsname des WebServices
wahlqrentschluesselung
Parametername
{http://wahlschein.v2.oliwa.services.endpoint.ireg.web.hshsoft.de/}wahlqrentschluesselung:version
Wert des Parameters
1
Aktionsname des WebServices
wahlqrentschluesselung
Parametername
{http://wahlschein.v2.oliwa.services.endpoint.ireg.web.hshsoft.de/}wahlqrentschluesselung:test
Wert des Parameters
?
Nachfolgend werden die Aktionsparameter für "HSH-Briefwahlscheinantrag" aufgelistet.
wahlliste
Parametername
{http://wahlschein.v2.oliwa.services.endpoint.ireg.web.hshsoft.de/}wahlliste:produkt
Wert des Parameters
Informationsregister
Aktionsname des WebServices
wahlliste
Parametername
{http://wahlschein.v2.oliwa.services.endpoint.ireg.web.hshsoft.de/}wahlliste:produkthersteller
Wert des Parameters
HSH Soft- und Hardware Vertriebs GmbH
Aktionsname des WebServices
wahlliste
Parametername
{http://wahlschein.v2.oliwa.services.endpoint.ireg.web.hshsoft.de/}wahlliste:produktversion
Wert des Parameters
1.10
Aktionsname des WebServices
wahlliste
Parametername
{http://wahlschein.v2.oliwa.services.endpoint.ireg.web.hshsoft.de/}wahlliste:version
Wert des Parameters
1
Die Werte "00000000" sind mit dem amtlichen Gemeindeschlüssel auszutauschen. Unter "WebService-HeaderParameter" ist der obig erwähnte X-ApiKey sowie ein Referer einzutragen.
Konfiguration der Veröffentlichung
Beim entsprechenden Assistent muss eine WebService-Einreichung konfiguriert werden (siehe hierzu "Webservice Einrichten)". Für die Einreichung wird der WebService "HSH-Briefwahlscheinantrag" ausgewählt.
Damit diese Konfiguration genutzt wird, müssen über Formularkonfiguration weitere Veröffentlichungskonfigurationen definiert werden (siehe hierzu "Webservice Einrichten)".
Das Formular muss per "Senden per E-Mail/Webservice" versendet werden.
Auf der nachfolgenden Seite muss die Option "Senden mit Webservice" ausgewählt und die entsprechende WebService-Url (siehe oben) hinterlegt werden.
Nach Bestätigen der Seite ist die Konfiguration abgeschlossen.