Aareon-Webservice

Beschreibung

Eingehende Idocs mit dem Basistyp /SEEAG/ES_CEN (implementiert von Seeburger) werden mit einem speziellen Content per XSLT gemappt und an einen Webservice übergeben. Ziel ist die automatisierte Rechnungs-Übertragung für Wohnungsbaugesellschaften. Der Webservice erwartet die Rechnung im Anhang als PDF-Datei (MTOM-Verfahren).

Installation

Vorraussetzung JRE mit Unlimited Strength JCE Policy Files.

Für die Installation müssen folgende Schritte ausgeführt werden:

1. SSI-Zertifikat einspielen
2. Content einspielen
3. Services einrichten
4. Action einrichten
5. Channel einrichten
6. Extentions anlegen

SSL-Zertifikat

Zertifikat in JKS umwandeln

P12 →JKS keytool -importkeystore -srckeystore keystore.p12 -srcstoretype PKCS12 -deststoretype JKS -destkeystore keystore.jks

Oder das Freeware-Tool KeyStore-Explorer nutzen:

• Create a new KeyStore

• Typ:JKS

• Rechtsklickmenü: Import Trusted Certificate (beliebig of wiederholen)

• Speichern als JKS

• Passwort ggf. definieren

• Fertig!

Zertifikat in Ordner ablegen

Tomcat Java-Systemvariablen setzen für SSL

Folgende Systemvariablen müssen gesetzt werden:

-Djavax.net.ssl.keyStore=D:\temp\keystore.jks -Djavax.net.ssl.keyStorePassword=runner -Djavax.net.ssl.keyStoreType=JKS

-Djavax.net.ssl.trustStore=D:\temp\truststore.jks -Djavax.net.ssl.trustStorePassword=runner -Djavax.net.ssl.trustStoreType=JKS

Zur Anzeige des Mappings in der B2B kann folgende Global-Property gesetzt werden:

org.b2bbp.webservices.DynamicWebServiceClient.LOG_LEVEL = 1

Content

Hier wird der aktuell zu verwendende Aareon Adapter hochgeladen.

Die Versionsnummer des Adapters muss nicht mit der Version des zugehörigen B2B Knotens übereinstimmen, aber wenn es zu Fehlerfällen kommt, kann ein Aktualisieren des Contents wahrscheinlich helfen.

DieContent muss in der Administration wie in den folgenden Screenshotshochgeladenwerden:

Contentname: com.nextlevel.nlc.aareon

Services

Wird von SetPropertyAction aufgerufen!

Actions

NLC-Action

Action-Properties für den Content:

Action-Properties für das Mapping:

B3P_AAREON_XSL_FILENAME (default: aareon.xsl)

Mapping kann mit alternativer XSL-Datei durchgeführt werden. XSL-Datei muss im Content im gleichen Pfad als aareon.xsl vorhanden sein.

B3P_AAREON_INV068_RECHNUNGSPOSITION (default: „Arbeitspreis“)

→ Definiert welches _-SEEAG_-CEN_TLI/_-SEEAG_-CEN_LIN als Rechnungsposition genommen wird

Mehrere Werte können Komma-separiert angegeben werden!

B3P_AAREON_INV068_GESAMTVERBRAUCH (default: „Aktueller Verb./VorperiodenVb.“)

→ Definiert welche _-SEEAG_-CEN_TLI/_-SEEAG_-CEN_LIN als Verbrauch genommen werden soll

B3P_AAREON_INV068_VERBRAUCH (default: „Mengen (Zählerstände)“)

→ Definiert welche _-SEEAG_-CEN_TLI/_-SEEAG_-CEN_LIN als erweiterte Verbräuche genommen werden soll

Mehrere Werte können Komma-separiert angegeben werden!

B3P_AAREON_INV068_ABSCHLAG (default: -)

→ Definiert welche _-SEEAG_-CEN_TLI/_-SEEAG_-CEN_LIN als zukünftige Abschläge genommen werden soll.

Mehrere Werte können Komma-separiert angegeben werden!

B3P_AAREON_RECHNUNGSSTELLER_ID

→ ID des Rechnungsstellers

B3P_AAREON_UMSATZSTEUER_ID

→ Ustid

B3P_AAREON_RECHNUNGSEMPFAENGER_ID

→ ID des Rechnungemfängers

Eigene Bankverbindung:

B3P_AAREON_BANK_BLZ
B3P_AAREON_BANK_KTNR
B3P_AAREON_BANK_IBAN
B3P_AAREON_BANK_BIC

Alle Inhalte werden vom Kunden/Aareon definiert, siehe folgende Excel-Tabelle:

Call-Webservice-Action

Action-Properties

HTTP_URL: https://soaerptest.aareon.com/ars/service?wsdl

B3P_SOAP_SERVICE_NAME: http://www.aareon.com/ars,ARS

B3P_SOAP_PORT_NAME: http://www.aareon.com/ars,ARS_Port

B3P_USED_SERVICE_ID: soap_client

BPM-Dispatcher-Action

Der Aareon-Webservice soll auf einem eigenem Konten laufen, daher wird hier der BP-Dispatcher angewendet.

https://www.next-level-help.org/nlidocu/html/default/webframe.html#BPM_Workflow.html

Channel

Extensions

DIALECT (Formaterkennung)

	# /SEEAG/ES_CEN
	xml./SEEAG/ES_CEN.type=/_-SEEAG_-ES_CEN/IDOC/EDI_DC40/IDOCTYP
	xml./SEEAG/ES_CEN.version='1.0'
	xml./SEEAG/ES_CEN.referenceNumber=/_-SEEAG_-ES_CEN/IDOC/_-SEEAG_-CEN_DCT/INV078
	xml./SEEAG/ES_CEN.senderName=/_-SEEAG_-ES_CEN/IDOC/_-SEEAG_-CEN_SEL/INV014
	xml./SEEAG/ES_CEN.sender=/_-SEEAG_-ES_CEN/IDOC/_-SEEAG_-CEN_SEL/INV085
	xml./SEEAG/ES_CEN.partnerName=/_-SEEAG_-ES_CEN/IDOC/_-SEEAG_-CEN_BYR/INV026
	xml./SEEAG/ES_CEN.partner=/_-SEEAG_-ES_CEN/IDOC/_-SEEAG_-CEN_BYR/INV087
	xml./SEEAG/ES_CEN.alternativeId=/_-SEEAG_-ES_CEN/IDOC/_-SEEAG_-CEN_DCT/INV001
	xml./SEEAG/ES_CEN.additional=date
	xml./SEEAG/ES_CEN.date=/_-SEEAG_-ES_CEN/IDOC/EDI_DC40/CREDAT

EXT_CHANNEL_DIST (welche CD auf welchem Channel)

	org.b2bbp.channels.extension.BGMTypeChanneldistribution;\
	org.b2bbp.channels.extension.BGMTypeChanneldistribution.registeredServiceIds=*
	org.b2bbp.channels.extension.BGMTypeChanneldistribution.executeOnChannelId=INBOUND_CHANNEL_ERROR

GENERIC_MAP (Aussteuerung in Channel)

	BGM_DISTRIBUTION.pattern=${template(&(this.FORMAT.type)_&(this.B3P_BGM_1001)_&(this.FORMAT.partnerCode))}
	BGM_DISTRIBUTION=/SEEAG/ES_CEN=OUTBOUND_AAREON

Trouble Shooting

Wenn es zu Fehlern kommt, obwohl die Konfiguration korrekt ist, zum Beispiel nachdem ein neues Deployment eingespielt wurde, sollte geprüft werden, ob auch eine neue Version des AareonAdapters benötigt wird.