Description
n8n-nodes-sap
This is an n8n community node that provides integration with SAP systems through the NeKu.AI OData wrapper service.
n8n is a fair-code licensed workflow automation platform.
> [!IMPORTANT]
> Prerequisites: Before using this node, the NeKu.AI Connector must be installed and configured in your SAP system. To request the installation and setup of the NeKu.AI Connector, please contact us at info@neku.ai.
Installation
Operations
Credentials
Compatibility
Usage
Resources
Installation
Follow the installation guide in the n8n community nodes documentation.
Community Nodes (Recommended)
1. Go to Settings > Community Nodes in your n8n instance
2. Select Install
3. Enter n8n-nodes-sap in Enter npm package name
4. Agree to the risks of using community nodes
5. Select Install
Manual Installation
To install the node manually:
npm install n8n-nodes-sap
For Docker-based n8n installations, add the following environment variable:
NPM_PACKAGES=n8n-nodes-sap
Operations
The SAP Connector node supports the following operation:
- Execute Report: Send data to SAP OData endpoint
/ZNEKUAIWRAPPERSRV/ReportSet - Report Name (required): The name of the SAP report to execute (e.g., “MaterialType”)
- Report Payload: JSON object containing the data to send to SAP (will be stringified)
- NeKu AI User (required): The NeKu.AI platform user identifier (supports expressions like
{{$execution.user.email}}) - Return Raw Response: Toggle to return the complete API response or just the processed data
- Minimum n8n version: 0.200.0
- Tested with n8n versions: 0.200.0 and above
Parameters
Credentials
SAP Basic Authentication NeKu.AI API
To connect to your SAP system, you’ll need to set up the following credentials:
1. Base URL (required): The base URL of your SAP system
– Example: https://s4hana.company.com
2. SAP Client (required): Your SAP Client number (Mandant)
– Example: 100, 200, etc.
3. Username (required): Your SAP username for authentication
4. Password (required): Your SAP password for authentication
Setting up Credentials
1. In n8n, go to Credentials > New
2. Search for “SAP Basic Authentication NeKu.AI API”
3. Fill in the required fields:
– Base URL of your SAP system
– SAP Client number
– Username
– Password
4. Click Save
The credentials are automatically tested when saved to ensure connectivity with your SAP system.
Compatibility
Usage
Basic Example
1. Add the SAP Connector Neku.AI node to your workflow
2. Select or create SAP credentials
3. Configure the node:
– Report Name: Enter your SAP report name (e.g., “MaterialType”)
– Report Payload: Add a JSON object with your data
– NeKu AI User: Provide the user identifier
4. Execute the workflow
Example Payload
{
"MaterialNumber": "100001",
"MaterialType": "FERT",
"Description": "Finished Product"
}
Using Variables
You can use n8n expressions in the NeKu AI User field to automatically populate the logged-in user’s email:
={{$execution.user.email}}
Other available user properties:
={{$execution.user.firstName}} – User’s first name={{$execution.user.lastName}} – User’s last name={{$execution.user.id}} – User’s IDResponse Handling
By default, the node returns processed data from the SAP response. Enable Return Raw Response to get the complete API response including metadata.
The node automatically extracts data from common SAP OData response structures:
d.results (collection)d (single entity)value (array)Error Handling
The node includes built-in error handling:
Resources
Version History
0.1.0 (Current)
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
Author
Serkan Ozcan
Email: serkan.ozcan@nekudos.com
GitHub: @serkanozcan
Support
For issues, questions, or contributions, please visit the GitHub repository.
