Actions18
- Customer Actions
- Service Actions
- Connection Actions
Overview
This n8n node interacts with the Genex API, specifically for Customer resource operations. The "Get External System Reference" operation retrieves an external system reference for a given customer from Genex, based on the provided customer number and system identifier. This is useful in scenarios where you need to synchronize or cross-reference customer data between Genex and another external system.
Practical examples:
- Fetching a customer's unique identifier as recognized by a third-party CRM or billing platform.
- Automating workflows that require mapping Genex customers to external systems for integration or reporting purposes.
Properties
| Name | Meaning |
|---|---|
| Customer Number | Must be a valid Genex customer number. Used to identify the customer whose external reference is needed. |
| System | Identifier for the external system. These values are case sensitive and should be entered as supplied. |
Output
The node outputs a json object containing the external system reference information for the specified customer and system. The exact structure of the output depends on the Genex API response, but typically includes fields such as the external reference value and possibly metadata about the customer or system.
Note: This node does not output binary data.
Dependencies
- External Service: Requires access to the Genex API.
- Credentials: Needs a configured
genexApicredential in n8n for authentication. - Environment: No special environment variables are required beyond standard n8n setup.
Troubleshooting
- Invalid Customer Number: If the provided customer number does not exist in Genex, the node may return an error or empty result. Double-check the customer number.
- System Identifier Case Sensitivity: The "System" property is case sensitive. Ensure you enter the identifier exactly as required by Genex.
- Authentication Errors: If credentials are missing or incorrect, you'll receive authentication errors. Verify your
genexApicredentials in n8n. - API Connectivity Issues: Network problems or incorrect API endpoint configuration can cause connection failures.
Common error messages:
NodeOperationError: General error wrapper for issues during execution. Check the error details for more information.- SOAP client creation errors: Indicate issues connecting to the Genex WSDL endpoint (e.g., network/firewall issues).