Zum Inhalt

B2Brouter Moduleinrichtung

Im Abschnitt B2Brouter Setup konfigurieren Sie die Verbindung zu Ihrem B2Brouter-Konto. Hier hinterlegen Sie die erforderlichen Zugangsdaten, legen fest, ob die Produktiv- oder Testumgebung verwendet werden soll, und können den Verbindungsstatus Ihrer Konfiguration überprüfen.

Information

Bevor Sie die B2Brouter-Einrichtung konfigurieren können, müssen Sie zunächst ein B2Brouter-Konto erstellen und die Ersteinrichtung in B2Brouter abschließen.

Informationen zur Registrierung und den ersten Einrichtungsschritten finden Sie unter B2Brouter - Als Benutzer registrieren

Verbindung zu B2Brouter einrichten

Im Abschnitt B2Brouter Hauptinformationen hinterlegen Sie die Zugangsdaten für die Verbindung zu Ihrem B2Brouter-Konto.

  1. Öffnen Sie das Rollencenter Document Dispatch - Administrator.
  2. Öffnen Sie unter Einrichtung die Moduleinrichtung.
  3. Navigieren Sie zum Bereich B2Brouter-Einrichtung.
  4. Hinterlegen Sie die Produktionsdaten:
    • Account Id
    • API Key
  5. Hinterlegen Sie optional die Staging-Daten:
    • Account Id (Staging)
    • API Key (Staging)
  6. Aktivieren Sie Testmode, wenn Sie mit Staging arbeiten möchten.
  7. Prüfen Sie die Verbindungsanzeigen:
    • API Status (Production)
    • API Status (Staging)

Hinweis

Sie finden die Account Id und den API Key, indem Sie sich bei B2Brouter anmelden und zum Bereich Entwickler wechseln.

Die Kontokennung (Account Id) sowie der dort angezeigte API Key werden für die Konfiguration der B2Brouter-Anbindung in Document Dispatch benötigt.

Wenn Sie eine Staging-Umgebung nutzen möchten, muss diese zunächst in Ihrem B2Brouter-Konto erstellt werden.

Der Abschnitt B2Brouter-Einrichtung enthält die Kontoinformationen, die Document Dispatch beim Senden elektronischer Rechnungen an B2Brouter verwendet.

Feld Beschreibung
Account Id Gibt das B2Brouter-Konto für produktive Versandvorgänge an.
API Key Gibt den API-Schlüssel für produktive Versandvorgänge an.
Account Id (Staging) Gibt das B2Brouter-Konto für Testversandvorgänge an.
API Key (Staging) Gibt den API-Schlüssel für Testversandvorgänge an.
Testmode Sendet B2Brouter-Anfragen an die Staging-Umgebung statt an die Produktionsumgebung.
API Status Production Zeigt den Verbindungsstatus für die Produktiv-Einrichtung an.
API Status Staging Zeigt den Verbindungsstatus für die Staging-Einrichtung an.

B2Brouter-Zähler in der Factbox anzeigen (optional)

Sie können in der Factbox einen zusätzlichen B2Brouter-Zähler einblenden. Dadurch sehen Benutzer direkt am aktuellen Datensatz, wie viele zugehörige B2Brouter-Einträge vorhanden sind, ohne die Übersicht verlassen zu müssen.

  1. Öffnen Sie das Rollencenter Document Dispatch - Administrator.
  2. Öffnen Sie im Bereich Einrichtung die Moduleinrichtung.
  3. Navigieren Sie zum Bereich Statusanzeige der sich im Beeich Factbox-Einrichtung befindet.
  4. Aktivieren Sie die Option B2Brouter-Gesendet-Zähler.

Information

Der B2Brouter-Zähler zeigt die Gesamtanzahl aller B2Brouter-Einträge zum aktuellen Datensatz an. Dabei werden unabhängig vom jeweiligen Verarbeitungsstatus sämtliche B2Brouter-Einträge berücksichtigt, beispielsweise erfolgreich verarbeitete, ausstehende oder fehlerhafte Einträge.

Dies erleichtert die Unterscheidung von B2Brouter-Einträgen gegenüber anderen Versand- oder Dokumenteinträgen.

B2Brouter Testmodus aktivieren

Mit dem Testmodus können Sie die Anbindung an B2Brouter in einer separaten Testumgebung (Staging) prüfen, ohne Daten an die Produktivumgebung zu übertragen. Dies ermöglicht es, Konfigurationsänderungen und Prozesse vor dem Live-Betrieb sicher zu testen.

Wenn Testmode aktiviert ist, verwendet Document Dispatch das Staging-Konto und den zugehörigen Staging-API-Schlüssel. Ist Testmode deaktiviert, erfolgt die Kommunikation über das Produktivkonto und den Produktiv-API-Schlüssel.

Folgen Sie diesen Schritten, um den B2Brouter-Testmodus zu aktivieren:

  1. Öffnen Sie das Rollencenter Document Dispatch - Administrator.
  2. Öffnen Sie im Bereich Einrichtung die Moduleinrichtung.
  3. Navigieren Sie zum Bereich B2Brouter-Einrichtung.
  4. Aktivieren Sie den Schieberegler Testmodus, um die Kommunikation mit der Staging-Umgebung von B2Brouter zu verwenden.

Wichtig

Der Testmodus funktioniert nur, wenn eine gültige Konto-ID (Staging) und ein zugehöriger API-Schlüssel (Staging) hinterlegt wurden.

Sind keine gültigen Staging-Zugangsdaten vorhanden, erscheint beim Testversand die Fehlermeldung „API-Schlüssel muss angegeben werden.“

Stellen Sie vor dem Versand von Rechnungen sicher, dass die richtige Umgebung ausgewählt ist. Rechnungen, die mit Produktiv-Zugangsdaten versendet werden, werden an die produktive B2Brouter-Umgebung übertragen.

B2Brouter-Verfügbarkeit prüfen

Mit der Verfügbarkeitsprüfung können Sie kontrollieren, ob die hinterlegten B2Brouter-Zugangsdaten gültig sind und eine Verbindung zur ausgewählten Umgebung hergestellt werden kann. Die angezeigten Statusfelder geben Auskunft darüber, ob die Konfiguration erfolgreich überprüft wurde und die Kommunikation mit B2Brouter möglich ist.

Die Verfügbarkeit für die B2Brouter-Produktivumgebung und die B2Brouter-Stagingumgebung wird getrennt angezeigt.

Die Statusanzeige wird automatisch aktualisiert, sobald Sie die Konto-ID oder den API-Schlüssel ändern. Dadurch können Sie die Gültigkeit der hinterlegten Zugangsdaten direkt überprüfen.

Status Beschreibung
Fehler Die angegebene Konto-ID oder der API-Schlüssel ist ungültig.
Nicht konfiguriert Es wurden keine Zugangsdaten hinterlegt.
Verbunden Die hinterlegten Zugangsdaten sind gültig und Document Dispatch ist erfolgreich mit B2Brouter verbunden.

B2Brouter-Statusaktualisierungsformel

Mit diesem Feld können Sie festlegen, welcher Zeitraum bei der Aktualisierung des B2Brouter-Status berücksichtigt werden soll. Dadurch lässt sich die Anzahl der zu prüfenden Versandeinträge eingrenzen und die Statusaktualisierung auf relevante Einträge beschränken. Berücksichtigt werden nur Versandeinträge, die bereits an B2Brouter übermittelt wurden.

Damit die Statusaktualisierung ausgeführt wird, muss der Aufgabenwarteschlangenposten Document Dispatch Update B2Brouter Status auf Bereit gesetzt sein. Bleibt das Feld leer, werden alle an B2Brouter übermittelten Versandeinträge unabhängig von ihrem Erstellungsdatum berücksichtigt.

Folgen Sie diesen Schritten, um die B2Brouter-Statusaktualisierung auf Versandeinträge zu beschränken:

  1. Öffnen Sie das Rollencenter Document Dispatch - Administrator.
  2. Öffnen Sie im Bereich Einrichtung die Moduleinrichtung.
  3. Navigieren Sie zum Bereich B2Brouter-Einrichtung.
  4. Geben Sie im Feld Statusaktualisierungsformel die Datumsformel -2D ein.

Dadurch werden bei der B2Brouter-Statusaktualisierung nur Versandeinträge berücksichtigt, die innerhalb der letzten zwei Tage erstellt wurden.

Siehe auch