Europace AG
Klosterstraße 71, 10179 Berlin
devsupport@europace2.de

Vorgang Anlegen (BEX) API

API zum automatisierten Anlegen von BaufiSmart Vorgängen.


Aktuelle Version 13

Diese Schnittstelle wird auch als "Baufismart EXtern" - kurz: "BEX" bezeichnet. Es werden immer die letzten 3 Versionen der Schnittstelle unterstützt.

Die BEX API wird durch die Datei bex-v13-VorgangAnlegen.wsdl vollständig beschrieben. Die Datei bex-v13-VorgangAnlegen.xsd kann genutzt werden, um mit eigenen Programmen/Werkzeugen die Anfragen zu validieren.

Bitte beachten Sie, daß die SteuerID und die Staatsangehörigkeit nicht über diese Schnittstelle gesetzt werden kann. Die Werte können Sie nachträglich in Baufismart eingeben. Wir sind in der Planung einer neuen REST API, bei der diese Felder integriert werden.

Beispiele

In Beispiele befinden sich XML-Dateien Anfragen und Antworten an den BEX SOAP Service. für eine bessere Lesbarkeit ist der SOAP-Envelope und SOAP-Body nicht dargestellt, sondern nur der Inhalt der Vorgang.xml (Anfrage) und der VorgangMetadaten.xml (Antwort).

Kurzanleitung um ein Vorgang mit SoapUI anzulegen

Ein Probeaufruf der API ist sehr hilfreich, um schnell einzusteigen. Dafür empfehlen wir SoapUI, was auf Windows, Mac OS und Linux funktioniert.

Schritte:

  1. SoapUI installieren: https://www.soapui.org/
  2. Ein neues SOAP Projekt anlegen
  3. Folgende URL in das WSDL Feld eintragen: https://www.europace2.de/baufiSmart/soap/bex/v13/vorgangAnlegen?wsdl
  4. Ein neuen Request anlegen und mit diesem Beispiel XML befüllen.
  5. Eigene PartnerID hier eintragen: <bex:EmpfaengerPartnerId>XXXXXX</bex:EmpfaengerPartnerId>
  6. Eigenen API Key hier eintragen: <bex:ApiKey>YYYYYY</bex:ApiKey>
  7. Request absetzen. Als Antwort sollte unter anderem eine VorgangsID kommen.

Code-Generierung für Client-Stubs

Aus der WSDL-Beschreibung kann automatisch Code generiert werden.

Beispiel für Java

wsimport -keep -extension bex-v13-VorgangAnlegen.wsdl
Wir sind für Dich da! Wir beantworten gerne alle Fragen