Genex

Interact with Genex API

Actions18

Overview

The "Update Service External Reference" operation for the "Service" resource in this custom n8n node allows users to update the external account number (External Reference) associated with a specific service for a customer in the Genex system. This is useful in scenarios where you need to synchronize or maintain accurate external references between Genex and other systems, such as billing platforms or CRM tools.

Practical examples:

  • Automatically updating the external account number when a customer's service details change in another system.
  • Integrating Genex with third-party applications that require up-to-date external references for services.

Properties

Name Meaning
Customer Number Must be a valid Genex customer number. Used to identify the customer whose service will be updated.
Service Number Genex service number (from the Service Details section). The service must exist and not be released.
External Reference Value to be updated into the External Account # field for the specified service.

Output

  • The output will contain the result of the update operation as returned by the Genex API. The structure typically includes a json field with the response data from the API call.
  • If an error occurs and "Continue On Fail" is enabled, the output may also include an error field describing the issue, along with the original input data.

Example output:

{
  "json": {
    // Response fields from Genex API, e.g.,
    "status": "Success",
    "message": "External Reference updated successfully"
  }
}

Dependencies

  • External Service: Requires access to the Genex API.
  • Credentials: A valid set of Genex API credentials configured in n8n under the name genexApi.
  • n8n Configuration: The node must be properly configured with the required credentials.

Troubleshooting

  • Common Issues:

    • Invalid or missing customer/service numbers will cause the operation to fail.
    • If the service does not exist or has been released, the update will not proceed.
    • Incorrect or expired Genex API credentials will prevent successful API calls.

  • Error Messages:

    • "Must be a valid Genex customer number": Ensure the provided customer number exists in Genex.
    • "Service must exist in Genex and should not be released": Check that the service number is correct and active.
    • Authentication errors: Verify that the Genex API credentials are correctly set up in n8n.

Links and References

Discussion