Genex

Interact with Genex API

Actions18

Overview

The Genex node for n8n, specifically with the "Service" resource and "Update Service Rate Plan" operation, allows users to update the rate plan associated with a specific service in the Genex billing system. This is useful for telecom or utility providers who need to programmatically change the pricing structure (rate plan) for a customer's service, optionally re-rating unbilled usage and removing any overrides.

Common scenarios:

  • Migrating customers to new pricing plans.
  • Correcting service assignments after customer requests.
  • Automating bulk updates to service rate plans as part of business processes.

Example use case:
A telecom company wants to automatically move all customers on an old plan to a new one at the start of the month, ensuring that any unbilled usage is recalculated according to the new rates.

Properties

Name Meaning
Customer Number Must be a valid Genex customer number. Identifies the customer whose service rate plan will be updated.
Service Number Genex service number (from the Service Details section). The service must exist and not be released.
Service Rate Plan The new rate plan to assign, specified by the Planno field from the RatePlan data structure.
Re Rate Unbilled Whether unbilled usage should be re-rated according to the new rate plan (true or false).
Remove Overrides Whether any overrides (for this specific service only) should be removed (true or false).

Output

  • The output will be a JSON object reflecting the response from the Genex API after attempting to update the service rate plan.
  • The exact structure depends on the Genex API's response, but typically includes status information, confirmation of the update, and possibly error details if the operation failed.
  • No binary data is produced by this operation.

Dependencies

  • External Service: Requires access to the Genex API (https://genexapi.billing.com.au/).
  • API Credentials: You must configure valid Genex API credentials in n8n under the name genexApi.
  • WSDL Files: The node uses SOAP and expects WSDL files to be available for the relevant operations.

Troubleshooting

Common issues:

  • Invalid Customer or Service Number: If the provided numbers do not match existing records, the API will return an error.
  • Missing or Incorrect Rate Plan: If the Service Rate Plan value does not correspond to a valid plan, the update will fail.
  • Permission Errors: Invalid or missing API credentials will prevent the node from connecting to Genex.
  • SOAP/WSDL Issues: If the required WSDL file is missing or inaccessible, the node cannot make the request.

Error messages you might see:

  • "Customer not found" or "Service not found": Check that the numbers are correct and exist in Genex.
  • "Invalid rate plan": Ensure the rate plan matches a valid Planno in Genex.
  • "Authentication failed": Verify your Genex API credentials in n8n.
  • "WSDL file not found": Make sure the necessary WSDL files are present and accessible to the node.

Links and References

Discussion