B2Brouter einrichten
Bevor Benutzer Rechnungen mit B2Brouter versenden können, müssen Administratoren die Einrichtung in Document Dispatch - Moduleinrichtung und im zugehörigen Versandprofil abschließen.
Voraussetzungen
- Die B2Brouter-Funktion ist in Ihrer Umgebung aktiviert.
- Sie verfügen über B2Brouter-Zugangsdaten für Produktion und optional für Staging.
B2Brouter in der Moduleinrichtung konfigurieren
- Öffnen Sie das Rollencenter Document Dispatch - Administrator.
- Öffnen Sie unter Einrichtung die Moduleinrichtung.
- Wechseln Sie zum Bereich B2Brouter Setup.
- Hinterlegen Sie die Produktionsdaten:
- Account Id
- API Key
- Hinterlegen Sie optional die Staging-Daten:
- Account Id (Staging)
- API Key (Staging)
- Aktivieren Sie Testmode, wenn Sie mit Staging arbeiten möchten.
- Prüfen Sie die Verbindungsanzeigen:
- API Status (Production)
- API Status (Staging)
Die Statusfelder zeigen, ob die hinterlegten Kontodaten erreichbar sind.
Versandprofil für B2Brouter konfigurieren
- Öffnen Sie Versandprofile.
- Erstellen Sie ein neues Profil oder öffnen Sie ein bestehendes.
- Stellen Sie den Ausgabetyp auf B2Brouter.
- Öffnen Sie Ausgabetyp-Einrichtung.
- Konfigurieren Sie diese Optionen:
- Automatic Validation on Dialog: validiert das ausgewählte Dokument im Sendedialog.
- Automatic deletion if error occurs: entfernt den transferierten Eintrag bei einem Sendefehler in B2Brouter.
Konfigurieren Sie den Inhalt der B2Brouter-JSON-Anfrage
Um die JSON-Anfrage für B2Brouter zu erstellen, konfigurieren Sie ein eDocuments-Schema im JSON-Modus. Das Schema definiert die Struktur und die enthaltenen Daten der erzeugten JSON-Anfrage.
- Öffnen Sie eDocuments-Schema.
- Erstellen Sie ein neues Schema oder öffnen Sie ein bestehendes.
- Stellen Sie Schema Type auf JSON.
- Verwenden Sie Create Schema Lines, um die Standard-JSON-Struktur zu erzeugen.
- Prüfen Sie in Schema Data die Felder und hinterlegen Sie die benötigten Werte.
- Stellen Sie für jedes JSON-Feld den JSON Value Type ein:
- String für Textwerte
- Number für Zahlenwerte
- Boolean für Wahr/Falsch-Werte
Info
In JSON-Schemata werden die Kontaktfelder transport_type_code und document_type_code über das Versandprofil gesteuert und nicht direkt in den Schemazeilen gepflegt.
Hilfe zu JSON-Feldern
Verwenden Sie in einer JSON-Schemazeile die Aktion Information, um eine Beschreibung zum ausgewählten JSON-Feld zu sehen.
Test B2Brouter Json
Mit Test B2Brouter Json prüfen Sie das Schema vollständig gegen die B2Brouter-API.
- Öffnen Sie das JSON-Schema.
- Wählen Sie Test B2Brouter Json.
- Wählen Sie einen Beleg, zum Beispiel eine Rechnung.
- Bestätigen Sie die Auswahl.
Das System sendet die erzeugten JSON-Daten zur Validierung an B2Brouter, löscht die Übertragung anschließend und zeigt das Validierungsergebnis an.
Factbox-Status für B2Brouter aktivieren (optional)
Sie können in der Factbox einen eigenen B2Brouter-Zähler anzeigen.
- Öffnen Sie die Moduleinrichtung.
- Aktivieren Sie im Bereich Statusanzeige den B2Brouter Sent Counter.
- In der Factbox wird nun die Anzahl der B2Brouter-Einträge zum aktuellen Datensatz angezeigt.