Enterprise System Nodes
6. Enterprise System Nodes
Enterprise system nodes connect SkyStudio workflows to your company's ERP and CRM systems. Dedicated nodes are provided for Salesforce, SAP and CANIAS ERP. These nodes are usually configured together with your IT department.
They are listed at the bottom of the Nodes tab in the node catalog, grouped by system name.
Salesforce Node
The Salesforce node lets you query and manage the records in your Salesforce CRM. The connection uses a username, a password and a security token.
Connection Setup and Management
Obtaining a Security Token
In addition to your password, Salesforce requires a Security Token for API access.
-
Sign in to Salesforce.
-
Click your profile picture in the top right and select Settings.
-
In the left menu, go to My Personal Information → Reset My Security Token.
-
Click the Reset Security Token button.
-
The token is sent to the email address registered to your account.
-
Copy the token value from the email.
Note: The security token is only delivered by email; it is never displayed on screen. It is reset every time you change your password, and the SkyStudio connection must be updated accordingly.
Verifying API Access
The user account must have API access permission.
-
Go to Setup → Users and open the relevant user.
-
Click the profile listed under Profile.
-
Under Administrative Permissions, confirm that API Enabled is selected.
Note: API access is not offered in some Salesforce editions (for example, Essentials). If you cannot find the permission, contact your Salesforce administrator.
Choosing the Login URL
| Environment | Login URL |
|---|---|
| Production | https://login.salesforce.com |
| Sandbox | https://test.salesforce.com |
Adding the Connection in SkyStudio
-
Click the chain icon (App Connections) in the bottom toolbar of the workflow canvas.
-
Click + New connection.
-
Select Salesforce from the provider list (listed under the CRM & Support category).
-
Fill in the following fields:
| Field | Required | Description |
|---|---|---|
| Connection name | Yes | A descriptive name (e.g. Prod Salesforce) |
| Who can use it | Yes | Only me / Workspace / Selected users / Integrations |
| Name | No | Credential label |
| Username | Yes | Salesforce username (in email format) |
| Password | Yes | Your Salesforce password |
| Security Token | Yes | The token value received by email |
| Login URL | Yes | https://login.salesforce.com or the sandbox address |
| API Version | Yes | The API version to use (e.g. 59.0) |
- Click Add connection.
Note: The password and the security token are entered in separate fields; unlike some integrations, they are not concatenated.
Operations
The Salesforce node offers a single operation:
| Operation | Description |
|---|---|
| Salesforce | Runs SOQL queries and performs record operations |
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The Salesforce connection to use |
| Operation Type | Yes | Query / Create / Update / Delete |
| Object | Yes | The Salesforce object (e.g. Account, Contact, Opportunity) |
| SOQL Query | Conditional | The SOQL statement used for queries |
| Record ID | Conditional | The record identifier for update and delete operations |
| Data (JSON) | Conditional | Field values for create and update operations |
Commonly Used Objects
| Object | Description |
|---|---|
| Account | Companies |
| Contact | People |
| Lead | Prospective customers |
| Opportunity | Sales opportunities |
| Case | Support tickets |
| Task | Tasks |
SAP Node
The SAP nodes give you three different ways to reach the data in your SAP system: SAP HANA Query (direct database queries), SAP SOAP (classic SAP services) and SAP REST (OData services).
Connection Setup and Management
Before You Start
SAP connections are subject to corporate security policies. Request the following information from your IT / SAP Basis team:
| Information | Description |
|---|---|
| Server address | The address used to reach the SAP system |
| Service user | The username and password created for the integration |
| Permissions | Read/write permissions for the tables or services to be accessed |
| Network access | The firewall rules required for SkyStudio to reach the SAP server |
Note: Do not use your personal SAP account for an integration. Ask your IT team for a dedicated service user that holds only the permissions the integration needs.
Adding the Connection in SkyStudio
-
Click the chain icon in the bottom toolbar of the workflow canvas.
-
Click + New connection.
-
Select SAP HANA, SAP SOAP or SAP REST from the provider list (listed under the Database & ERP category).
-
Fill in the following fields:
| Field | Required | Description |
|---|---|---|
| Connection name | Yes | A descriptive name (e.g. SAP Production) |
| Who can use it | Yes | Access level |
| Name | No | Credential label |
| URL | Yes | SAP server address |
| Username | Yes | SAP service username |
| Password | Yes | SAP service user password |
- Click Add connection.
Note: Define separate connections for production and test environments. Naming the environment in the connection name ("SAP Test", "SAP Production") helps prevent operations from running against the wrong system.
SAP HANA Query
Sends SQL queries directly to the SAP HANA database. Used for reporting and data retrieval.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The SAP HANA connection to use |
| SQL Query | Yes | The SQL statement to run |
| Limit | No | Maximum number of rows to return |
Example Use
SELECT MATNR, MAKTX, MEINS
FROM MARA
WHERE MTART = 'FERT'
LIMIT 100
Note: Run only SELECT queries against a production database. For write operations, use the official services through SAP SOAP or SAP REST; writing directly to tables can compromise data integrity.
SAP SOAP
Calls SAP web services over the SOAP protocol. Used to invoke BAPI and RFC functions.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The SAP SOAP connection to use |
| Service / Function | Yes | The service or BAPI name to call |
| SOAP Envelope | Yes | The request body (XML) |
| SOAP Action | No | The SOAPAction header |
Note: You can derive the structure of the SOAP envelope from the WSDL file on the SAP side. Ask your IT team for the WSDL address of the relevant service.
SAP REST
Sends requests to SAP OData or REST services. This is the preferred method on modern SAP installations (S/4HANA).
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The SAP REST connection to use |
| Endpoint | Yes | The service path (e.g. /sap/opu/odata/sap/API_BUSINESS_PARTNER) |
| HTTP Method | Yes | GET, POST, PUT, DELETE |
| Query Parameters | No | OData filter and selection parameters |
| Body | Conditional | The body for POST/PUT requests |
OData Parameter Examples
| Parameter | Description |
|---|---|
| $filter=Country eq 'TR' | Filter by country |
| $select=BusinessPartner,BusinessPartnerName | Return only specific fields |
| $top=50 | The first 50 records |
| $orderby=CreationDate desc | Sort by date |
CANIAS ERP Node
The CANIAS ERP node lets you connect to your CANIAS system over WSDL.
Connection Setup and Management
Before You Start
Request the following information from your IT team for a CANIAS connection:
| Information | Description |
|---|---|
| WSDL address | The address of the CANIAS web service definition file |
| Service user | The credentials created for the integration |
| Company / Period code | The company and fiscal period to work with |
| Permissions | Access rights for the modules to be used |
Adding the Connection in SkyStudio
-
Click the chain icon in the bottom toolbar.
-
Click + New connection.
-
Select CANIAS (WSDL) from the provider list (listed under the Database & ERP category).
-
Fill in the following fields:
| Field | Required | Description |
|---|---|---|
| Connection name | Yes | A descriptive name |
| Who can use it | Yes | Access level |
| URL | Yes | CANIAS WSDL service address |
| Username | Yes | CANIAS service username |
| Password | Yes | CANIAS service user password |
- Click Add connection.
Canias Request
Sends a request to the CANIAS ERP service.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The CANIAS connection to use |
| Service / Method | Yes | The CANIAS service method to call |
| Parameters | Conditional | The parameters sent to the method |
| Company Code | No | The company to work with |
| Period | No | The fiscal period code |
Quick Start Examples
Example 1: Salesforce Opportunity Report
A workflow that reports open sales opportunities every week:
Webhook (every Monday) → Salesforce → Anthropic API Call → Send Mail (Outlook)
Salesforce settings:
- Operation Type: Query
- SOQL:
SELECT Name, Amount, CloseDate FROM Opportunity WHERE IsClosed = false ORDER BY Amount DESC LIMIT 20
Example 2: SAP Stock Alert
A workflow that reports products that have dropped to a critical stock level:
Webhook (every morning) → SAP HANA Query → If-Else Condition → Send Message (Slack)
Example 3: Dashboard from ERP Data
A workflow that analyzes ERP data and produces a visual report:
Webhook (1st of the month) → SAP REST → JSON to Table → Data Analysis (Python) → Artifact → Send Mail
Example 4: Salesforce Record from a Form
A workflow that records a web form submission in the CRM:
Webhook → Text2data → Transform → Salesforce (Create) → Send Message (Slack)
Example 5: ERP Query Chatbot
A chatbot that lets the team query ERP data in natural language:
Text Input → LLM (generate SQL) → SAP HANA Query → LLM (answer) → Text Output
Common Errors
| Error | Possible Cause | Resolution |
|---|---|---|
| INVALID_LOGIN (Salesforce) | Incorrect password or security token | Reset the token and enter the new value from the email |
| API_DISABLED_FOR_ORG | The user has no API permission | Have "API Enabled" granted on the profile |
| MALFORMED_QUERY | Invalid SOQL syntax | Test the query in the Salesforce Developer Console |
| Invalid session ID | The session has expired | Save the connection again |
| SAP Connection refused | Network access is closed | Request a firewall rule from your IT team |
| SAP Authorization failed | The service user lacks sufficient permissions | Ask the SAP Basis team for access to the relevant table or service |
| SAP HANA Table not found | The schema name is missing | Use the fully qualified name in the query (SCHEMA.TABLE) |
| CANIAS WSDL parse error | The WSDL address is wrong or unreachable | Open the address in a browser to confirm it is reachable |
| The query times out | Too many records are being retrieved | Limit the result set with LIMIT / $top |
Notes
- Enterprise system connections are usually set up together with your IT department; request the required information and network permissions from them.
- Use a service user rather than a personal account for integrations; personal password changes break the integration.
- The Salesforce Security Token is reset every time your password changes; remember to update the connection.
- Salesforce production and sandbox environments use different Login URLs — take care not to connect to the wrong environment.
- Send only SELECT queries to a production SAP HANA database; use the official SAP services (SOAP / REST) for write operations.
- SAP REST is preferred on modern SAP installations (S/4HANA), SAP SOAP on older ones.
- Define separate connections for test and production environments, and state the environment in the connection name.
- Always use limiting parameters such as
LIMITand$topon large data sets; ERP queries consume significant system resources. - Test workflows that write to enterprise systems in a test environment first.
