Breadcrumbs

2 · Einrichtung und Konfiguration

Installation

Ventoo Address Validation ist eine Erweiterung für Microsoft Dynamics 365 Business Central (SaaS, BC 28 / Runtime 17.0).

  1. Installieren Sie die App aus dem AppSource-Marketplace oder laden Sie die .app-Datei über Erweiterungsverwaltung › Verwalten › Erweiterung hochladen hoch.

  2. Nach der Installation legt die App automatisch den Einrichtungsdatensatz mit sinnvollen Vorgabewerten an – die App ist also sofort funktionsfähig, sobald die Verbindung konfiguriert ist.

  3. Weisen Sie den Benutzern den Berechtigungssatz Ventoo Address Validation (AddressValidUserVTO) zu, der konfigurierenden Person zusätzlich Ventoo Address Validation - Setup (AddressValidAdminVTO) – siehe Administrationsreferenz › Berechtigungen. Für die automatischen Abläufe ist kein Berechtigungssatz nötig.

Voraussetzung: Ein technischer Benutzer der Schweizerischen Post für den Adress-Webservice. Diesen erhalten Sie über das Entwicklerportal der Post.

Verbindung zum Post-Webservice einrichten

Öffnen Sie die Seite Adressvalidierung Einrichtung (Suche: Address Validation Setup).

  1. Umgebung – wählen Sie Test (Integrationsumgebung) oder Produktion. Die Basis-URLs sind bereits vorbelegt; sie lassen sich bei Bedarf anpassen.

  2. Benutzername – geben Sie den reinen technischen Benutzer ein, z. B. TU_1234567_0001 – ohne den Zusatz @service.post.ch.

  3. Passwort – hinterlegen Sie das Passwort des technischen Benutzers. Es wird verschlüsselt im Isolated Storage abgelegt und nie im Klartext im Einrichtungssatz gespeichert.

  4. Verbindung testen – prüft mit einem Testaufruf, ob Zugangsdaten und Endpunkt stimmen.

Timeout: Über Timeout (ms) steuern Sie, wie lange Business Central auf eine Antwort der Post wartet (Standard 10 000 ms).

Empfohlene Standardwerte

Klicken Sie in der Einrichtung auf Empfohlene Standardwerte übernehmen. Damit wird die bewährte Grundkonfiguration gesetzt:

  • Prüfung überall aktiv, aber nicht blockierend (nur Hinweis) auf Karten, Belegen, bei Freigabe, Belegdruck, Mahnungen sowie beim Druck/Versand gebuchter Rechnungen.

  • Hartes Blockieren nur beim Buchungs-Gate – der letzte Punkt, an dem sich die Adresse noch auf dem Beleg korrigieren lässt.

  • Blockieren bei Adresse nicht gefunden (PSTAT 7) eingeschaltet; bei teilweise bestätigt (PSTAT 6) und nicht eindeutig (PSTAT 8) ausgeschaltet.

  • Hintergrund-Warteschlange für alle Stammtabellen aktiv, Stapelgrösse 50, Intervall 30 Minuten, erneute Prüfung unveränderter Adressen alle 90 Tage.

Sie können anschliessend jede Einstellung einzeln anpassen.

Prüf-Auslöser konfigurieren

Die App prüft an mehreren Stellen. Für jede Stelle gibt es eine Ein/Aus-Option und – wo sinnvoll – einen Modus:

  • Vorschlag – informiert bzw. warnt und lässt Sie fortfahren.

  • Blockieren – hält die Aktion an, damit die Adresse zuerst korrigiert wird.

Die Auslöser von früh (am besten korrigierbar) nach spät (letzte Absicherung):

#

Auslöser

Einstellung

Modus

Empfehlung

1

Manuelle Schaltfläche

Manuelle Schaltfläche aktivieren

Button-Modus

Vorschlag

2

Automatische Prüfung auf Karten

Karten automatisch prüfen

– (immer nicht blockierend)

Ein

3

Belegprüfung

Adressen auf Belegen prüfen

– (immer nicht blockierend)

Ein

4

Freigabe-Gate

Freigabe-Gate aktivieren

Freigabe-Gate-Modus

Vorschlag

5

Belegdruck-Gate (unbuchbarer Beleg)

Belegdruck-Gate aktivieren

Belegdruck-Gate-Modus

Vorschlag

6

Mahn-Gate

Mahn-Gate aktivieren

Mahn-Gate-Modus

Vorschlag

7

Buchungs-Gate

Buchungs-Gate aktivieren

Buchungs-Gate-Modus

Blockieren

8

Druck-Gate (gebuchte Rechnung)

Druck-Gate aktivieren

Druck-Gate-Modus

Vorschlag

9

Versand-Gate (gebuchte Rechnung)

Versand-Gate aktivieren

Versand-Gate-Modus

Vorschlag

Warum nur beim Buchungs-Gate blockieren? Auf Karten und bei der Belegerfassung soll die Prüfung nicht stören – ein Hinweis genügt. Beim Buchen ist es der letzte Moment, in dem sich die Adresse noch auf dem Beleg korrigieren lässt; danach (gebuchte Rechnung) ist eine Korrektur nicht mehr möglich, deshalb dort nur Vorschlag.

Verhalten in schwierigen Fällen (nur im Modus Blockieren)

Einstellung

Wirkung

Blockieren: Teilweise bestätigt (PSTAT 6)

Stoppt, wenn die Post die Adresse nur teilweise bestätigen kann. Standard: aus.

Blockieren: Adresse nicht gefunden (PSTAT 7)

Stoppt, wenn die Adresse gar nicht gefunden wird. Standard: an.

Blockieren: Adresse nicht eindeutig (PSTAT 8)

Stoppt, wenn mehrere Treffer möglich sind. Standard: aus.

Blockieren, wenn Post nicht erreichbar

Stoppt bei Timeout/technischem Fehler. Standard: aus (warnen und fortfahren).

Blockieren: Korrektur verfügbar

Stoppt, wenn eine nicht übernommene Korrektur/Vervollständigung vorliegt. Standard: aus (nur Warnung).

Geprüfte Adressen sind ausgenommen. Diese Blockier-Regeln greifen nie bei einer Adresse, die eine Person bereits im Arbeitsvorrat bearbeitet hat (auf Erledigt oder Zurückgestellt gesetzt), solange die Adresse unverändert bleibt. Das geschieht automatisch – dafür gibt es keine Einstellung.

E-Mail-Versand

Standardmässig wird beim E-Mail-Versand nicht geprüft, da die Postadresse für die Zustellung per E-Mail nicht relevant ist (sie erscheint aber weiterhin auf dem PDF). Aktivieren Sie Auch bei E-Mail prüfen, wenn Sie auch hier eine Prüfung wünschen.

Hintergrund-Warteschlange konfigurieren

Die Warteschlange prüft den bestehenden Adressbestand automatisch (siehe Geschäftsfunktionen › Hintergrund-Warteschlange).

Einstellung

Bedeutung

Standard

Warteschlange: Debitoren / Lieferadressen / Kontakte / Kreditoren / Bestelladressen

Welche Stammtabellen die Warteschlange prüft.

alle an

Stapelgrösse pro Lauf

Max. Anzahl Post-Aufrufe pro Lauf (bleibt im Minutenlimit).

50

Laufintervall (Minuten)

Wie oft die Aufgabenwarteschlange läuft.

30

Erneute Prüfung (Tage)

Nach wie vielen Tagen eine unveränderte Adresse erneut geprüft wird (0 = aus).

90

Hausnummern bei falscher/fehlender Nr. auflisten

Holt automatisch die gültigen Hausnummern der Strasse (≈ 9 zusätzliche Aufrufe, einmalig).

an

Log-Verlauf aufbewahren (Tage)

Nach wie vielen Tagen abgelöste Log-Einträge gelöscht werden (0 = für immer behalten).

0

Wiedervorlage im Arbeitsvorrat

Einstellung

Bedeutung

Standard

Bei Verschlechterung erneut öffnen

Setzt eine erledigte/zurückgestellte Adresse zurück auf Offen, wenn sich das Ergebnis verschlechtert.

an

Zurückgestellte erneut öffnen nach (Tagen)

Zeitgesteuerte Wiedervorlage zurückgestellter Adressen (0 = aus).

30

Erledigte erneut öffnen nach (Tagen)

Zeitgesteuerte Wiedervorlage erledigter Adressen (0 = aus).

0