Integrate a YunIO Service with n8n

This article shows how to integrate a yunIO service with n8n.

n8n is a workflow automation platform. Build flows by linking nodes for actions, triggers, or webhooks. It supports HTTP requests, credentials, and data synchronization. For more information, see n8n Documentation.

Setup in yunIO

1. Create a service in yunIO.
2. Click to testrun the service in yunIO. For more information, see Documentation: Run Services in yunIO.
3. Click to copy the service endpoint URL.
   

Setup in n8n

To run yunIO services from n8n:

1. Add a trigger node and an HTTP Request node.
   
2. In the HTTP Request node, set Method to POST.
3. Enter the yunIO service endpoint URL into URL, e.g., https://yunio.example.com:8175/services/. You can find the URL in the Run menu of your service.
4. If yunIO uses access restrictions:
   • Set Authentication to Generic Credential Type.
   • Set Generic Auth Type to Basic Auth.
   • In Basic Auth, click Create new credential and enter your yunIO username and password or select an existing credential.
5. Activate Send Headers to define input and output formats. Example:
   • Content-Type: application/json specifies that the data you send in the request body is formatted as JSON. Use this when passing parameters as a JSON object.
   • Accept: application/json specifies that you want to receive the response data in JSON format. Most n8n nodes expect and work better with JSON data.
6. Optional: use Send Body to pass parameters to your service, see Pass Parameters.
7. Click [Execute step] to test the service call. If successful, the panel on the right displays the service output.
   

You can now fetch SAP data via yunIO and pass it to other nodes for further processing.

Pass Parameters

There are multiple ways to pass parameters to your service in n8n:

• using the input fields in the n8n node UI, see Configure Body Using Fields.
• using the JSON payload of the service, see Configure Body Using JSON.

Configure Body Using Fields

The following workflow is recommended for services with few parameters:

1. In the HTTP Request node, set the header to Content-Type: application/json. This specifies that the data you send in the request body is formatted as JSON.
2. Activate Send Body.
3. Set Body Content Type to JSON.
4. Set Specify Body to Using Fields Below.
5. Click [Add Body Field]. This creates a new pair of input fields: Name and Value.
6. Enter the name of the yunIO service parameter in the Name field, e.g., whereClause. You can find a list of all parameter names in the Run menu of your service.
7. Enter the value you want to pass to the parameter in the Value field, e.g., LAND1 = 'US'. To map parameters to the output of previous nodes, drag-and-drop the data from the left side panel into the input fields, see Data Mapping.
   
8. Repeat steps 5 to 7 for all parameters you want to pass to your service.
9. Click [Execute step] to test the service call. If successful, the right side panel displays the service output.

You can now pass parameters to your service and fetch specific data from SAP.

Configure Body Using JSON

The following workflow is recommended for services with many parameters and/or nested parameters:

1. In the HTTP Request node, set the header to Content-Type: application/json. This specifies that the data you send in the request body is formatted as JSON.
2. Activate Send Body.
3. Set Body Content Type to JSON.
4. Set Specify Body to Using JSON.
5. Open yunIO and navigate to the Run menu of your service.
6. Download the service payload. The file <service-name>_input_payload.json contains all parameters and their structure in JSON format. If you assign parameters in the Run menu before downloading the payload, they are included in the file.
   

7. Copy the content of the <service-name>_input_payload.json file into the JSON field.

   Tip

   For better reusability, use a Read/Write Files from Disk node to load the payload or use an HTTP Request node to fetch the file from a URL. In the HTTP Request node, you can use an expression to reference it: {{ $json.fileContent }}

8. If your parameters do not have values yet, add values directly in the JSON body or use n8n expressions to map parameters to output from previous nodes, see Data Mapping.
   

9. Click [Execute step] to test the service call. If successful, the right side panel displays the service output.

You can now pass parameters to your service and fetch specific data from SAP.

Data Mapping

Reference Output from Previous Nodes

To dynamically pass data from previous nodes in your workflow, use n8n expressions to reference node outputs, see n8n Documentation: Expressions. Alternatively, use the drag-and-drop function of the node UIs to map the data, see n8n Documentation: Referencing Data in the UI.

Custom Variables

On self-hosted Enterprise and Pro Cloud plans of n8n, instance owners and admins can create custom variables to dynamically pass data between nodes and workflows, see n8n Documentation: Custom Variables.

Related Links

• n8n Documentation: HTTP Request Node
• n8n Documentation: HTTP Request Node Common Issues
• yunIO Documentation: Run Services
• yunIO Documentation: Parameters