Beta

This SAP Connector is in beta The SAP Connector is not yet publicly available. We are actively working on its completion. If you would like early access, please contact us.

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.

Parameter	Typ	Beschreibung
`baseUrl`	string	URL des SAP-Systems (z.B. https://sap.example.com:8443)
`client`	string	SAP-Mandant (z.B. 100)
`username`	string	SAP-Benutzername
`password`	string	SAP-Passwort
`language`	string	Anmeldesprache (DE, EN, etc.)

OData Node

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

Parameter

Parameter	Typ	Pflicht	Beschreibung
`operation`	enum	Ja	read, create, update, delete
`servicePath`	string	Ja	OData Service Pfad (z.B. /sap/opu/odata/sap/API_BUSINESS_PARTNER)
`entitySet`	string	Ja	Entity Set Name (z.B. A_BusinessPartner)
`$filter`	string	Nein	OData Filter Expression
`$select`	string	Nein	Komma-getrennte Feldliste
`$expand`	string	Nein	Navigation Properties laden
`$top`	number	Nein	Max. Anzahl Datensätze
`$skip`	number	Nein	Anzahl 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

Parameter	Typ	Pflicht	Beschreibung
`functionModule`	string	Ja	Name des Funktionsbausteins
`importing`	object	Nein	Importing-Parameter
`tables`	object	Nein	Tabellen-Parameter
`commit`	boolean	Nein	BAPI_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

Parameter	Typ	Pflicht	Beschreibung
`idocType`	string	Ja	IDoc-Basistyp (z.B. ORDERS05)
`messageType`	string	Ja	Nachrichtentyp (z.B. ORDERS)
`receiverPort`	string	Ja	Empfänger-Port
`receiverPartner`	string	Ja	Empfänger-Partnernummer
`idocData`	object	Ja	IDoc-Segmente mit Daten

Webhooks Node

Trigger-Node für eingehende SAP-Events.

Parameter

Parameter	Typ	Pflicht	Beschreibung
`path`	string	Nein	Webhook-Pfad (auto-generiert wenn leer)
`authentication`	enum	Nein	none, basicAuth, headerAuth
`responseCode`	number	Nein	HTTP 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

API-Referenz

Credentials

OData Node

Parameter

Beispiel

RFC Node

Parameter

Beispiel

IDoc Node

Parameter

Webhooks Node

Parameter

Output

Fehlerbehandlung

Fehler-Codes

Weitere Ressourcen

Datentypen

Troubleshooting