Ersteinrichtung für den Ventoo Pingen Connector durchführen

Die Ersteinrichtung verbindet Business Central mit Pingen, definiert das Belegversand-Profil und aktiviert die Auftragswarteschlange für den automatischen Rechnungsversand. Ohne diese Schritte werden keine Briefe versendet.

Einrichtungsseite öffnen

Wählen Sie das Suchsymbol (Alt+Q), geben Sie Pingen Einrichtung ein, und wählen Sie den zugehörigen Link.

Der Einrichtungsdatensatz wird beim ersten Öffnen automatisch erstellt. Es sind keine weiteren manuellen Vorbereitungen notwendig.

Pingen-Zugang konfigurieren

Im Inforegister API-Zugangsdaten werden die Pingen-Anmeldedaten hinterlegt:

Feld	Beschreibung
Client-ID	Die Client-ID aus der Pingen Developer App.
Client Secret	Das Client-Geheimnis aus der Pingen Developer App. Wird maskiert dargestellt und verschlüsselt im Isolated Storage abgelegt – nicht in einer Datenbank-Tabelle. Sobald ein Secret gespeichert ist, zeigt das Feld Punkte; zum Wechseln einfach überschreiben.
Organisations-ID	Die Pingen Organisations-ID. Sichtbar in der URL, wenn Sie in Pingen angemeldet sind.

Tipp: Erstellen Sie eine eigene Developer App in Pingen ausschliesslich für Business Central. So lassen sich Zugriffe später nachvollziehen und die Zugangsdaten bei Bedarf isoliert rotieren.

Verbindung testen

Wählen Sie auf der Einrichtungsseite die Aktion Verbindung testen. Die App fordert ein Access Token an und gibt das Ergebnis als Meldung zurück. Bei einem Fehler werden Statuscode und Antwort angezeigt – ideal zur Diagnose ungültiger Zugangsdaten.

Auch beim regulären Versand enthalten Fehlermeldungen den HTTP-Statuscode und die Pingen-Antwort, z.B. Pingen: Authentication failed (HTTP 401). Verify Client ID and Client Secret. Response: .... Damit lässt sich am Logeintrag der Auftragswarteschlange unmittelbar erkennen, ob es sich um Auth-, Validierungs- oder Netzwerkprobleme handelt.

Belegversand-Profil zuweisen

Damit nicht jeder Kunde automatisch per Post bedient wird, steuert die App den Versand über ein Belegversand-Profil (Standard-Funktionalität von Business Central):

Wählen Sie das Suchsymbol (Alt+Q), geben Sie Belegversand-Profile ein, und wählen Sie den zugehörigen Link.
Erstellen Sie ein neues Profil, z.B. mit dem Code POST.
Tragen Sie den gleichen Code im Feld Code des Dokumentenversandprofils auf der Einrichtungsseite ein.
Setzen Sie auf den entsprechenden Debitorenkarten im Feld Belegversand-Profil denselben Code.

Wichtig: Nur Debitoren mit exakt diesem Profil-Code werden vom automatischen Versand erfasst. Alle anderen Debitoren werden ignoriert.

Auftragswarteschlange einrichten

Der automatische Rechnungsversand wird durch eine Auftragswarteschlangen-Position ausgelöst, die regelmässig die Codeunit PingenJobQueueVTO (ID 70679759) ausführt.

Wählen Sie das Suchsymbol (Alt+Q), geben Sie Auftragswarteschlangenposten ein.
Erstellen Sie eine neue Position mit folgenden Werten:

Feld	Wert
Objekttyp auszuführen	Codeunit
Objekt-ID auszuführen	70679759 (PingenJobQueueVTO)
Wiederholungseinstellungen	Z.B. täglich um 06:00 Uhr

Setzen Sie den Status auf Bereit.

Hinweis: Die Codeunit prüft bei jeder Ausführung selbst, ob die Einrichtung vollständig ist. Sind Client-ID, Client Secret, Organisations-ID oder das Belegversand-Profil leer, wird die Verarbeitung übersprungen – ohne Fehler.

Nächste Schritte

Nach der Ersteinrichtung können Sie:

Belegarten aktivieren unter Einrichtung und Konfiguration
Druckeinstellungen anpassen (Adressposition, Versandprodukt, Druckmodus, Farbmodus)
Einzelbelege manuell versenden über den Per Pingen senden-Button