Summa icon

Summa

Consume Summa API (v.0.1.7)

Actions182

Overview

This node, named "Summa," is designed to interact with the Summa API (version indicated dynamically). It supports multiple resources and operations related to telecommunications services management. Specifically, for the HLR Subscription resource and the Set HLR Teleservice operation, the node allows users to configure teleservice settings on a Home Location Register (HLR) subscription by specifying an IMSI and a teleservices template name.

Common scenarios where this node is beneficial include telecom operators or service providers who need to automate the management of subscriber services, such as enabling or modifying teleservices associated with a subscriber's HLR record. For example, setting a teleservice template for a subscriber identified by their IMSI to control call forwarding, barring, or other network services.

Properties

Name Meaning
Imsi The International Mobile Subscriber Identity (IMSI) uniquely identifying the subscriber whose HLR teleservice settings are to be modified. This is a required string input.
Teleservices Template Name The name of the teleservices template to apply to the HLR subscription. This template defines the set of teleservices (e.g., call forwarding, call barring) to be configured. This is a required string input.

Output

The node outputs data in JSON format representing the result of the Set HLR Teleservice operation. This typically includes confirmation of the applied changes, status messages, or any relevant response data from the Summa API indicating success or failure of the teleservice configuration.

If the node supports binary data output, it would generally relate to raw API responses or logs, but based on the provided code and context, the primary output is structured JSON data reflecting the operation's outcome.

Dependencies

  • Requires an active connection to the Summa API via an API key credential (referred generically as "an API key credential").
  • The node uses an HTTP client internally to communicate with the Summa backend.
  • Proper configuration of the Summa API credentials within n8n is necessary before execution.
  • No additional external dependencies beyond the Summa API and its authentication are indicated.

Troubleshooting

  • Common Issues:

    • Invalid or missing IMSI value will cause the operation to fail since IMSI is required to identify the subscriber.
    • Incorrect or non-existent teleservices template names may lead to errors or no changes being applied.
    • Authentication failures due to invalid or expired API credentials.
    • Network connectivity issues preventing communication with the Summa API.
  • Error Messages and Resolutions:

    • Authentication Error: Verify that the API key credential is correctly configured and has not expired.
    • Invalid IMSI: Ensure the IMSI is correctly formatted and corresponds to an existing subscriber.
    • Template Not Found: Confirm that the teleservices template name exists in the system and is spelled correctly.
    • API Request Failed: Check network connectivity and API endpoint availability.

Links and References

Discussion