98122 B2B-Messenger einrichten

In diesem BC können Sie den B2B-Messenger und die Channels für die Datenkommunikation mit den u. g. externen Kommunikationspartnern konfigurieren.
Der B2B-Messenger ermöglicht den Datentransfer (Inbound oder Outbound) mit externen Kommunikations-Partnern:
  1. E-Invoices für PostFinance (nur Outbound)
  2. E-Invoices für PayNet (nur Outbound)
  3. XML-Daten via HTTP(s) (Inbound und Outbound mit beliebigen Partner)

            
Eine detaillierte Beschreibung des B2B-Messengers finden Sie in den Opacc Manuals unter Einrichten OXAS > B2B-Messenger.

Allgemein

Im Abschnitt Allgemein hinterlegen Sie die HTTP-Ports und das Protokoll für die B2B-Services sowie das OpaccOXAS-Login.

Allgemein

Http-Port:

Die Angabe eines generellen Http-Ports ist nur notwendig, wenn einer der (aktivierten) Channels einen http-Endpunkt adressiert oder bereitstellt.

Http-Port:

Die Angabe eines generellen Http-Ports ist nur notwendig, wenn einer der (aktivierten) Channels einen http-Endpunkt adressiert oder bereitstellt.

Http-Protokoll:

Hier wählen Sie das Sicherheitsprotokoll aus, das für die Https-Verbindung verwendet werden soll:
  • Gemäss Windows
  • TLS (Alle Versionen)
  • TLS 1.1 und TLS 1.2
  • Nur TLS 1.2
  • Nur TLS 1.1
  • Nur TLS 1.0
  • TLS 1.0 und SSL 3.0
  • Nur SSL 3.0

OpaccOXAS-Login

In dieser Gruppe erfassen Sie die OpaccOXAS Login-Daten für die B2B-Messenger-Datenkommunikation.

OpaccOXAS-Mandant:

Hier wählen Sie aus der Mandantenliste den Mandanten für das Login aus.

OpaccOXAS-Benutzer:

Hier wählen Sie aus der BO-Tabelle "Mitarbeiter" den Benutzer aus, für welchen Sie das Login erstellen wollen.

OpaccOXAS-Passwort (verschlüsselt):

Hier erfassen Sie das Passwort für den Login. Dieses können Sie anschliessend durch Klick auf den Button <Verschlüsseln> verschlüsseln.

PayNet

Im Abschnitt PayNet hinterlegen Sie Zeitplanung und die Biller-Angaben für den Datentransfer (Outbound) zu PayNet.

PayNet - Zeitplanung

In dieser Gruppe definieren Sie die Zeitplanung für das Ausführen der Datenkommunikation mit PayNet.

Aktiviert:

Über diese Checkbox können Sie den PayNet-Channel aktivieren (Checkbox gesetzt) oder deaktivieren (Checkbox passiv).

Start-Zeit: / Stopp-Zeit:

Hier legen Sie die Startzeit und die Stoppzeit für den Beginn bzw. das Ende der Datenkommunikation fest. Definitionen der Art "22.00 ... 03.00" sind für beide Zeitpunkte möglich.

Pause:

Hier legen Sie die Pausen-Zeitdauer im Min. zwischen mehreren Datentransfers fest.

PayNet - Biller

In dieser Gruppe können Sie verschiedene PayNet-Biller Konfigurationen erstellen.

Definierte PayNet-Biller-Konfigurationen (Tabelle)

In dieser Tabelle werden pro Konfiguration folgende Attribute angezeigt:
BillerID - Beschreibung - Verzeichnis - WebService-Zielknoten - Aktiviert
Die Tabelle zeigt Attribute des Haupt-BO-Typs Cfg.B2B.Channel.PayNet. Die Tabelle ist fix und kann nicht angepasst werden.

BillerId:

Hier erfassen Sie die ID des Rechnungsstellers. Diese ID wird von PayNet vergeben.

Aktiviert:

Über diese Checkbox können Sie die Biller-Konfiguration aktivieren (Checkbox gesetzt) oder deaktivieren (Checkbox passiv).

Verzeichnis:

Hier müssen Sie das Root-Verzeichnis für die Invoice-Dateien angeben. Relative Pfade beziehen sich auf das Verzeichnis, in welchem die Assembly 'Opacc.B2B.Channel.PayNet.dll' liegt. Wenn nichts konfiguriert ist, wird das Verzeichnis 'PayNet' angesprochen.

Rechnungs-Detail-Modus:

Hier können Sie den Rechnung-Detail-Modus ( Behandlung der Rechnungs-Details, z.B. bei PDF-Dokument) auswählen. Bei PayNet kann nur "PDF einfügen" ausgewählt werden.

WebService-Authentifizierungstyp:

Hier wählen Sie die Art der Authentifizierung gegenüber den PayNet WebServices aus. Es kann nur die Möglichkeit Benutzer und Passwort ausgewählt werden.

WebService-Benutzer:

Hier erfassen Sie den von PayNet vergebenen Benutzer für das Ausführen des PayNet-WebServices.

WebService-Passwort (verschlüsselt):

Hier hinterlegen Sie das von PayNet vergebene Passwort. Es muss für die Assembly 'Opacc.B2B.Channel.PayNet.dll' verschlüsselt werden. Die Verschlüsselung wird mit dem Button <Verschlüsseln> ausgelöst.

WebService-Ziel-Knoten:

Hier hinterlegen Sie den Ziel-Knoten auf dem die PayNet WebServices laufen.
Format: "[Host-Name or IP-Address]:[Port]".
Beispiel: "bws1.paynet.ch"

Beschreibung:

Hier können Sie eine Beschreibung oder eine Erläuterung der PayNet-Konfiguration hinterlegen.

PostFinance

Im Abschnitt PostFinance hinterlegen Sie Zeitplanung und die Biller-Angaben für den Datentransfer (Outbound) zu PostFinance.

PostFinance - Zeitplanung

In dieser Gruppe definieren Sie die Zeitplanung für das Ausführen der Datenkommunikation mit dem Dienstleister PostFinance.

Aktiviert:

Über diese Checkbox können Sie den PostFinance-Channel aktivieren (Checkbox gesetzt) oder deaktivieren (Checkbox passiv).

Start-Zeit: / Stopp-Zeit:

Hier legen Sie die Startzeit und die Stoppzeit für den Beginn bzw. das Ende der Datenkommunikation fest. Definitionen der Art "22.00 ... 03.00" sind für beide Zeitpunkte möglich.

Pause:

Hier legen Sie die Pausen-Zeitdauer im Min. zwischen mehreren Datentransfers fest.

PostFinance - Biller

In dieser Gruppe können Sie verschiedene PostFinance-Biller-Konfigurationen definieren.

Definierte PostFinance-Biller-Konfigurationen (Tabelle)

In dieser Tabelle werden pro Konfiguration folgende Attribute angezeigt:
Biller-ID - Beschreibung - Verzeichnis - WebService-Zielknoten - Aktiviert
Die Tabelle zeigt Attribute des Haupt-BO-Typs Cfg.B2B.Channel.PostFinance. Die Tabelle ist fix und kann nicht angepasst werden.

BillerId:

Hier erfassen Sie die ID des Rechnungsstellers. Diese ID wird von PostFinance vergeben. Dieses Attribut muss leer bleiben, wenn kein Rechnungsversand gewünscht wird.

Aktiviert:

Über diese Checkbox können Sie die Biller-Konfiguration aktivieren (Checkbox gesetzt) oder deaktivieren (Checkbox passiv).

Verzeichnis:

Hier müssen Sie das Root-Verzeichnis für die Invoice-Dateien angeben. Relative Pfade beziehen sich auf das Verzeichnis, in welchem die Assembly 'Opacc.B2B.Channel.PostFinance.dll' liegt. Wenn dieses Attribut leer ist, wird automatisch das Verzeichnis 'PostFinance' angesprochen.

Rechnungs-Detail-Modus:

Hier können Sie den Rechnung-Detail-Modus ( Behandlung der Rechnungs-Details, z.B. bei PDF-Dokument) auswählen. Bei PostFinance kann nur "PDF einfügen" ausgewählt werden.

WebService-Authentifizierungstyp:

Hier wählen Sie die Art der Authentifizierung gegenüber den PostFinance WebServices aus. Es kann nur die Möglichkeit Benutzer und Passwort ausgewählt werden.

WebService-Benutzer:

Hier erfassen Sie den von PostFinance vergebenen Benutzer für das Ausführen des PostFinance-WebServices.

WebService-Passwort (verschlüsselt):

Hier hinterlegen Sie das von PostFinance vergebene Passwort. Es muss für die Assembly 'Opacc.B2B.Channel.PostFinance.dll' verschlüsselt werden. Die Verschlüsselung wird mit dem Button <Verschlüsseln> ausgelöst.

WebService-Ziel-Knoten:

Hier hinterlegen Sie den Ziel-Knoten auf dem die PostFinance WebServices laufen.
Format: "[Host-Name or IP-Address]:[Port]".
Beispiel: "ebill.yellowworld.ch"

WebService-Via-Knoten:

Hier hinterlegen Sie den Via-Knoten für den Zugriff auf die PostFinance WebServices. Dieses Attribut muss nur gefüllt werden, wenn für den Datenaustausch ein Via-Knoten erforderlich ist.
Format: "[Host-Name or IP-Address]:[Port]".
Beispiel: "ebill.yellowworld.ch:9943".

Beschreibung:

Hier können Sie eine Beschreibung oder eine Erläuterung der PostFinance-Konfiguration hinterlegen.

XML over HTTP

Im Abschnitt XML over HTTP hinterlegen Sie Zeitplanung und die Biller-Angaben für die Datenkommunikation (Inbound oder Outbound) zu einem beliebigen Partner.

XML over HTTP - Zeitplanung

In dieser Gruppe definieren Sie die Zeitplanung für das Ausführen der Datenkommunikation mit dem Partner.

Aktiviert:

Über diese Checkbox können Sie den XmlOverHttp-Channel aktivieren (Checkbox gesetzt) oder deaktivieren (Checkbox passiv).

Start-Zeit: / Stopp-Zeit:

Hier legen Sie die Startzeit und die Stoppzeit für den Beginn bzw. das Ende des Transfers fest. Definitionen der Art "22.00 ... 03.00" sind für beide Zeitpunkte möglich.

Pause:

Hier legen Sie die Pausen-Zeitdauer im Min. zwischen mehreren Transfers fest.

XML over HTTP - Partner

In dieser Gruppe können Sie verschiedene Konfigurationen für die Datenkommunikation mit externen Partnern definieren.

Definierte XML over HTTP - Partner-Konfigurationen (Tabelle)

In dieser Tabelle werden pro Konfiguration folgende Attribute angezeigt:
PartnerID - Beschreibung - Verzeichnis - Aktiviert
Die Tabelle zeigt Attribute des Haupt-BO-Typs Cfg.B2B.Channel.XmlHttp. Die Tabelle ist fix und kann nicht angepasst werden.

PartnerId:

Hier erfassen Sie die Partner-ID. Diese ID kann im Prinzip frei gewählt werden, z. B. "AbcProduktiv". Sie wird beim Aufruf von "B2B.HttpRequest()" mitgegeben/benutzt und muss aber innerhalb der Installation eindeutig sein.
Beispiel: websms-opacc

Aktiviert:

Über diese Checkbox können Sie die Partner-Konfiguration aktivieren (Checkbox gesetzt) oder deaktivieren (Checkbox passiv).

Verzeichnis:

Hier müssen Sie das Root-Verzeichnis für die XML-Dateien angeben. Relative Pfade beziehen sich auf das Verzeichnis in dem die Assembly 'Opacc.B2B.Channel.XmlOverHttp.dll' liegt. Wenn dieses Attribut leer ist, wird der Ordner 'XmlOverHttp' angesprochen.

Beschreibung:

Hier können Sie eine Beschreibung oder eine Erläuterung der PostFinance-Konfiguration hinterlegen.

Outbound

In dieser Gruppe erfassen Sie eine Konfiguration für die Outbound-Datenkommunikation mit dem Partner

Aktiviert:

Über diese Checkbox können Sie die Partner-Outbound-Konfiguration aktivieren (Checkbox gesetzt) oder deaktivieren (Checkbox passiv).

Http(s)-Authentifizierungstyp:

Hier wählen Sie die Art der Authentifizierung gegenüber dem Partner aus. Folgende Möglichkeiten stehen zur Auswahl:
  • keine
  • Benutzer und Passwort
  • Client-Zertfikat

Benutzer:

Dieses Attribut ist passiv, wenn Sie den Authentifizierungstyp "Keine" oder "Client-Zertifikat" gewählt haben.
Hier muss der vom Kommunikationspartner vorgegebene Benutzer, mit dem auf den http(s)-Endpunkt zugegriffen werden soll, angegeben werden.

Passwort (verschlüsselt):

Dieses Attribut ist passiv, wenn Sie den Authentifizierungstyp "Keine" oder "Client-Zertifikat" gewählt haben.
Hier hinterlegen Sie das vom Partner vergebene Passwort. Es muss für die Assembly 'Opacc.B2B.Channel.XmlOverHttp.dll' verschlüsselt werden. Die Verschlüsselung wird mit dem Button <Verschlüsseln> ausgelöst.

HTTP(s)-URL:

Hier hinterlegen Sie die Adresse (URL) des Partners, an welche die XML-Daten gesendet werden sollen. Es können folgende Platzhalter verwendet werden:
"[[HTTP_PORT]]"
"[[HTTPS_PORT]]"
"[[PARTNER_ID]]"
"[[TRANSACTION_ID]]" 

SOAPAction-Header:

Die hier definierte Zeichenkette wird mit jedem Request innerhalb des "SOAPAction"-http-Headers gesendet. Eine solche Zeichenkette ist in der Regel für WebService-Endpunkte erforderlich.
Beispiel: "SOAPAction=http://www.opacc.com/Opacc/ServiceBus/Interface/Ws/Generic/Generic/FlatRequest"

Client-Zertifikat (Base64-codiert):

Wenn Sie den Authentifizierungstyp "Client-Zertifikat" gewählt haben, muss hier wird das vom Partner zugeteilte und mittels 'Opacc.Commons.Encryption.exe' für die Assembly 'Opacc.ServiceBus.Connector.B2B.dll' in Base64-Form gebrachte Client-Zertifikat für den Zugriff auf den Partner hinterlegt werden.

Inbound

In dieser Gruppe erfassen Sie eine Konfiguration für die Inbound-Datenkommunikation mit dem Partner.

Aktiviert:

Über diese Checkbox können Sie die Partner-Inbound-Konfiguration aktivieren (Checkbox gesetzt) oder deaktivieren (Checkbox passiv).

Http(s)-Authentifizierungstyp:

Hier wählen Sie die Art der Authentifizierung gegenüber dem Partner aus. Folgende Möglichkeiten stehen zur Auswahl:
  • keine
  • Benutzer und Passwort
  • Client-Zertfikat

Benutzer:

Dieses Attribut ist passiv, wenn Sie den Authentifizierungstyp "Keine" oder "Client-Zertifikat" gewählt haben.
Hier muss der von Ihnen vorgegebene Benutzer, mit dem auf den http(s)-Endpunkt zugegriffen werden soll, angegeben werden. Dieser Benutzer muss dem Partner mitgeteilt werden.

Passwort (verschlüsselt):

Dieses Attribut ist passiv, wenn Sie den Authentifizierungstyp "Keine" oder "Client-Zertifikat" gewählt haben.
Hier hinterlegen Sie das von Ihnen vergebene und dem Partner mitgeteilte Passwort. Es muss für die Assembly 'Opacc.B2B.Channel.XmlOverHttp.dll' verschlüsselt werden. Die Verschlüsselung wird mit dem Button <Verschlüsseln> ausgelöst.

HTTP(s)-URL:

Hier hinterlegen Sie die Adresse (URL) des http(s) Endpunkts für den Partner. Es können folgende Platzhalter verwendet werden:
"[[HTTP_PORT]]"
"[[HTTPS_PORT]]"
"[[PARTNER_ID]]" 

Beispiel: "http://+:[[HTTP_PORT]]/XmlOverHttp/[[PARTNER_ID]]/"

TransactionID:

In diesem Attribut können Sie auswählen, ob die Transaktions-Ids für eingehende Messages mit einem Zeitstempel oder einem URL-Suffix erzeugt werden sollen. Wird UrlSuffix gewählt, muss die Endpunkt-URL am Schluss die "[[TRANSACTION_ID]]" enthalten.

Buttons

Mit dem Button <Neu> aktivieren Sie den Erfassungsmodus und können eine neue Konfiguration erfassen. Nach dem Speichern einer neu angelegten Konfiguration befinden Sie sich automatisch im Erfassungsmodus.
Mit dem Button <Speichern> speichern Sie eine neue oder geänderte Konfiguration.
Mit dem Button <Löschen> löschen Sie die aktive Konfiguration.