User Help

98122 B2B-Messenger einrichten

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

Allgemein

In diesem Bereich hinterlegen Sie Ports, Protokolle und das zu verwendende Opacc OXAS Login.

Allgemein

Http-Port
Die Angabe eines generellen Http-Ports ist nur notwendig, wenn einer der (aktivierten) Channels einen http-Endpunkt adressiert oder bereitstellt.
Https-Port
Die Angabe eines generellen Https-Ports ist nur notwendig, wenn einer der (aktivierten) Channels einen https-Endpunkt adressiert oder bereitstellt.
Https-Protokolle
Hier wählen Sie das Sicherheitsprotokoll aus, das für die Https-Verbindung verwendet werden soll. Zur Auswahl stehen:
  • 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

Hier erfassen Sie die Opacc OXAS Login-Daten.
OpaccOXAS-Mandant
Hier wählen Sie aus der Liste aller Mandanten den Mandanten für das Login aus.
OpaccOXAS-Benutzer
Hier wählen Sie den Benutzer aus, mit welchem das Login erfolgt.
OpaccOXAS-Passwort (verschlüsselt)
Hier erfassen Sie das Passwort für das Login. Mit Klick auf den Button Verschlüsseln können Sie das eingegebene Passwort verschlüsseln.

PayNet

In diesem Bereich erfassen Sie Zeitplanung und die Biller-Angaben für den Datentransfer zu PayNet.

Zeitplanung

Aktiviert
Über diese Checkbox können Sie den PayNet-Channel aktivieren oder deaktivieren.
Start-Zeit / Stop-Zeit
Hier legen Sie die Start- und die Stop-Zeit für den Beginn bzw. das Ende der Datenkommunikation fest.
Pause
Hier legen Sie die Zeitdauer (in Minuten) der Pause zwischen mehreren Datentransfers fest.

Biller

In der BO-Liste werden Ihnen alle bereits erfassten PayNet Biller-Konfigurationen angezeigt. Die Attribute in der Liste sind fix vorgegeben, die Liste 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 oder
                  deaktivieren.

               
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 automatisch 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
                  steht nur PDF einfügen zur
                  Auswahl.

               
WebService-Authentifizierungstyp

               
Hier
                  wählen Sie die Art der Authentifizierung gegenüber den PayNet
                  WebServices aus. Bei PayNet steht nur die Möglichkeit
                  Benutzer und Passwort zur
                  Auswahl.

               
WebService-Benutzer

               
Hier
                  erfassen Sie den von PayNet vergebenen Benutzer für das Ausführen der
                  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 zu der
                  PayNet-Konfiguration hinterlegen.

            

         

      

      

         
PostFinance

         

            
In diesem Bereich erfassen Sie Zeitplanung und die Biller-Angaben für
               den Datentransfer zu PostFinance.

            

               

                  

                     Notiz
                     
                        
Notiz

                        

                           
Beachten Sie, dass der Zugriff auf den PostFinance WebService
                              nach 3 Fehlversuchen gesperrt wird. Wenn der Zugriff gesperrt ist, kann
                              dieser lediglich durch die PostFinance wieder freigeschaltet
                              werden.

                        

                     		
                  

               

            

         

      

      

         
Zeitplanung

         

            

               
Aktiviert

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

               
Start-Zeit /
                  Stop-Zeit

               
Hier legen Sie die Start- und die Stop-Zeit
                  für den Beginn bzw. das Ende der Datenkommunikation
                  fest.

               
Pause

               
Hier legen Sie die Zeitdauer
                  (in Minuten) der Pause zwischen mehreren Datentransfers
                  fest.

            

         

      

      

         
Biller

         

            

               
In der BO-Liste werden Ihnen alle bereits erfassten
                  PostFinance Biller-Konfigurationen angezeigt. Die Attribute in der
                  Liste sind fix vorgegeben, die Liste 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 oder
                  deaktivieren.

               
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 nichts
                  konfiguriert 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
                  steht nur PDF einfügen zur
                  Auswahl.

               
WebService-Authentifizierungstyp

               
Hier
                  wählen Sie die Art der Authentifizierung gegenüber den PostFinance
                  WebServices aus. Bei PostFinance steht nur die Möglichkeit Benutzer
                     und Passwort zur
                  Auswahl.

               
WebService-Benutzer

               
Hier
                  erfassen Sie den von PostFinance vergebenen Benutzer für das Ausführen
                  der 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 erfasst 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 zu der
                  PostFinance-Konfiguration hinterlegen.

            

         

      

      

         
XML over HTTP

         

            
In diesem Bereich erfassen Sie Zeitplanung und die Biller-Angaben für
               die Datenkommunikation (Inbound oder Outbound) zu einem beliebigen
               Partner.

         

      

      

         
Zeitplanung

         

            

               
Aktiviert

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

               
Start-Zeit /
                  Stopp-Zeit

               
Hier legen Sie die Start- und die Stop-Zeit
                  für den Beginn bzw. das Ende der Datenkommunikation
                  fest.

               
Pause

               
Hier legen Sie die Zeitdauer
                  (in Minuten) der Pause zwischen mehreren Datentransfers
                  fest.

            

         

      

      

         
Partner

         

            

               
In der BO-Liste werden Ihnen alle bereits erfassten
                  XmlOverHttp-Konfigurationen angezeigt. Die Attribute in der Liste sind
                  fix vorgegeben, die Liste kann nicht angepasst
                  werden.

               

               
PartnerId

               
Hier erfassen
                  Sie die Partner-ID. Die Partner-ID können Sie im Prinzip frei wählen.
                  Sie wird beim Aufruf des Service B2B.HttpRequest()
                  mitgegeben/verwendet und muss innerhalb der Opacc ERP Installation
                  eindeutig sein.

               
Beispiel:
                  websms-opacc

               
Aktiviert

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

               
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 nichts
                  konfiguriert ist, wird automatisch das Verzeichnis XmlOverHttp
                  angesprochen.

               
Beschreibung

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

            

         

      

      

         
Outbound

         

            

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

               

               
Aktiviert

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

               
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

               
Hier muss der vom
                  Kommunikationspartner vorgegebene Benutzer erfasst werden, mit dem
                  auf den http(s)-Endpunkt zugegriffen werden soll.

               
Dieses
                  Attribut ist passiv, wenn Sie den Authentifizierungstyp Keine
                  oder Client-Zertifikat gewählt haben.

               
Passwort
                  (verschlüsselt)

               
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.

               
Dieses
                  Attribut ist passiv, wenn Sie den Authentifizierungstyp Keine
                  oder Client-Zertifikat gewählt
                  haben.

               
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 das vom Partner
                  zugeteilte Client-Zertifikat hinterlegt werden.

               
Sie müssen das
                  Client-Zertifikat mittels Opacc.Commons.Encryption.exe für
                  die Assembly Opacc.ServiceBus.Connector.B2B.dll in Base64
                  codieren.

            

         

      

      

         
Inbound

         

            

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

               

               
Aktiviert

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

               
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

               
Hier muss der von Ihnen
                  vorgegebene Benutzer erfasst werden, mit dem auf den
                  http(s)-Endpunkt zugegriffen werden soll. Dieser Benutzer muss dem
                  Partner mitgeteilt werden.

               
Dieses Attribut ist passiv, wenn
                  Sie den Authentifizierungstyp Keine oder
                  Client-Zertifikat gewählt haben.

               
Passwort
                  (verschlüsselt)

               
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.

               
Dieses Attribut ist
                  passiv, wenn Sie den Authentifizierungstyp Keine oder
                  Client-Zertifikat gewählt
                  haben.

               
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]]"
"[[TRANSACTION_ID]]"

               
TransactionID

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

               
Plain-Response

               
Wenn Sie
                  diese Checkbox aktivieren, wird die Antwort (Response) im
                  Text-Format (Plain-Text-Response) anstatt im XML-Format
                  (XML-Response) übermittelt.

            

         

      

      

         
Buttons

         

            
Mit dem Button Neu aktivieren Sie den
               Erfassungsmodus.

            
Mit dem Button Speichern werden Ihre Eingaben
               gespeichert.

            
Mit dem Button Löschen wird der aktive Eintrag
               gelöscht.