Overview

The Plan4Flex node allows you to connect to the Plan4Flex SOAP API using a WSDL endpoint.

This node enables you to retrieve or interact with data inside Plan4Flex, such as employees (werknemers) and other entities exposed via their webservices.

⚠️ Note: The Plan4Flex API has some limitations. For more advanced or large-scale use cases, we recommend using direct database integrations via Flowmage database nodes.

When to Use This Node

Use the Plan4Flex node when you want to:

• Retrieve data from Plan4Flex via their webservice

• Call specific SOAP operations (e.g. GetWerknemer)

• Integrate Plan4Flex into simple automation flows

• Quickly connect without direct database access

Configuration

WSDL Configuration

WSDL URL

The URL to the Plan4Flex SOAP service.

Example:

https://webservices.localjobs.com:1334/WsServiceTest/WsService.svc

? Flowmage will automatically append ?singleWsdl if needed.

Load

Click “Load” to fetch available operations from the WSDL.

After loading, you can select which operation to use.

Operation

Select the API operation you want to call.

Example:

GetWerknemer

Parameters

Once an operation is selected, the required parameters will appear automatically.

Example Parameters

apiKey (string)

Your Plan4Flex API key.

Example:

1234sada-2321-ndjanie-232o1-b3325cfFFF122

werknemerId (int)

The ID of the employee you want to retrieve.

Example:

12345

? You can also use Flowmage variables here:

@previousNode.werknemerId@

Error Handling

Continue on Error

If enabled, the flow will continue even if this node fails.

Use this when:

• The API is unreliable

• You want fallback logic in your flow

How It Works

1. Flow starts

2. Plan4Flex node connects to the WSDL endpoint

3. Selected operation is executed

4. Parameters are sent to the API

5. Response is returned to Flowmage

6. Output becomes available for next steps

Output / Variables

The node returns the response from the Plan4Flex API.

Example usage:

@userapi.result@
@userapi.werknemerNaam@

? userapi = your Output ID

The exact structure depends on the selected operation.

Common Mistakes

❌ Invalid WSDL URL

The service cannot be loaded.

✅ Make sure the URL is correct and accessible

❌ Forgetting to Click “Load”

No operations will be available.

✅ Always load the WSDL before configuring

❌ Incorrect API Key

Authentication will fail.

✅ Verify your API key with Plan4Flex

❌ Wrong Parameter Types

For example:

• String instead of integer

✅ Match the expected type exactly

❌ Unstable API Responses

Plan4Flex API can sometimes be inconsistent.

✅ Add error handling or fallback logic

⚠️ Important: API vs Database Integration

While this node works for basic integrations, the Plan4Flex API has limitations such as:

• Performance issues

• Limited endpoints

• Inconsistent responses

Recommended Alternative: Database Nodes

For advanced use cases, we recommend using Flowmage’s database nodes to connect directly to the Plan4Flex database.

Benefits:

• Faster performance

• More control over data

• Access to full dataset

• More reliable for large-scale automations

Pro Tips

• Use this node for simple lookups or triggers

• Combine with conditions to handle API inconsistencies

• Cache results if you call the API frequently

• Switch to database integration for heavy workflows

Summary

The Plan4Flex node allows you to connect to the Plan4Flex SOAP API and execute operations directly from your flows.

For simple integrations, it works well—but for more advanced scenarios, consider using database integrations for better performance and reliability.