Beta

Dieser SAP Connector befindet sich in der Beta-Phase Der SAP Connector ist aktuell noch nicht öffentlich verfügbar. Wir arbeiten intensiv an der Fertigstellung. Wenn Sie frühzeitigen Zugang erhalten möchten, kontaktieren Sie uns.

Kontakt aufnehmen →
Referenz

API-Referenz

Vollständige Parameter-Dokumentation aller SAP Connector Nodes.

Credentials

Alle SAP Nodes nutzen die gleichen Credentials für die Verbindung zum ZATW-Connector.

ParameterTypBeschreibung
baseUrlstringURL des SAP-Systems (z.B. https://sap.example.com:8443)
clientstringSAP-Mandant (z.B. 100)
usernamestringSAP-Benutzername
passwordstringSAP-Passwort
languagestringAnmeldesprache (DE, EN, etc.)

OData Node

Zugriff auf SAP OData Services für Stamm- und Bewegungsdaten.

Parameter

ParameterTypPflichtBeschreibung
operationenumJaread, create, update, delete
servicePathstringJaOData Service Pfad (z.B. /sap/opu/odata/sap/API_BUSINESS_PARTNER)
entitySetstringJaEntity Set Name (z.B. A_BusinessPartner)
$filterstringNeinOData Filter Expression
$selectstringNeinKomma-getrennte Feldliste
$expandstringNeinNavigation Properties laden
$topnumberNeinMax. Anzahl Datensätze
$skipnumberNeinAnzahl zu überspringender Datensätze

Beispiel

OData Read Parameter
{
  "operation": "read",
  "servicePath": "/sap/opu/odata/sap/API_BUSINESS_PARTNER",
  "entitySet": "A_BusinessPartner",
  "$filter": "BusinessPartnerCategory eq '1'",
  "$select": "BusinessPartner,BusinessPartnerFullName",
  "$top": 100
}

RFC Node

Führt RFC-Funktionsbausteine und BAPIs aus.

Parameter

ParameterTypPflichtBeschreibung
functionModulestringJaName des Funktionsbausteins
importingobjectNeinImporting-Parameter
tablesobjectNeinTabellen-Parameter
commitbooleanNeinBAPI_TRANSACTION_COMMIT aufrufen

Beispiel

RFC Parameter
{
  "functionModule": "BAPI_MATERIAL_GETLIST",
  "importing": {
    "MATNRSELECTION": [
      { "SIGN": "I", "OPTION": "CP", "MATNR_LOW": "MAT*" }
    ]
  },
  "commit": false
}

IDoc Node

Sendet IDocs an SAP für asynchrone Datenübertragung.

Parameter

ParameterTypPflichtBeschreibung
idocTypestringJaIDoc-Basistyp (z.B. ORDERS05)
messageTypestringJaNachrichtentyp (z.B. ORDERS)
receiverPortstringJaEmpfänger-Port
receiverPartnerstringJaEmpfänger-Partnernummer
idocDataobjectJaIDoc-Segmente mit Daten

Webhooks Node

Trigger-Node für eingehende SAP-Events.

Parameter

ParameterTypPflichtBeschreibung
pathstringNeinWebhook-Pfad (auto-generiert wenn leer)
authenticationenumNeinnone, basicAuth, headerAuth
responseCodenumberNeinHTTP Response Code (Standard: 200)

Output

Webhook Output
{
  "headers": {
    "content-type": "application/json",
    "x-sap-signature": "sha256=..."
  },
  "body": {
    "event": { ... },
    "payload": { ... }
  },
  "query": {},
  "webhookUrl": "https://..."
}

Fehlerbehandlung

Alle Nodes geben standardisierte Fehlerobjekte zurück.

Fehlerstruktur
{
  "error": {
    "code": "RFC_ERROR",
    "message": "Function module not found",
    "details": {
      "sapMessageClass": "SY",
      "sapMessageNumber": "002",
      "sapMessageText": "Funktionsbaustein BAPI_INVALID nicht gefunden"
    }
  }
}

Fehler-Codes

  • AUTH_ERROR – Authentifizierungsfehler
  • RFC_ERROR – RFC-Ausführungsfehler
  • ODATA_ERROR – OData Service Fehler
  • IDOC_ERROR – IDoc-Verarbeitungsfehler
  • CONNECTION_ERROR – Verbindungsfehler

Weitere Ressourcen