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:
-
E-Invoices für PostFinance (nur Outbound)
-
E-Invoices für PayNet (nur Outbound)
-
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.
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.