Summa icon

Summa

Consume Summa API (v.0.1.7)

Actions182

Overview

The "Summa" node integrates with the Summa API (version indicated in the code) to perform various operations on different resources related to telecommunications subscriptions and services. Specifically, for the SS Subscription resource with the Add Supplementary Service operation, this node allows users to add a supplementary service to a subscriber's subscription by specifying key identifiers and service details.

This node is beneficial in scenarios where telecom operators or service providers need to programmatically manage subscriber services, such as enabling call forwarding, call barring, or other supplementary telephony features. For example, an operator could automate adding a voicemail service or call waiting feature to a subscriber’s account based on business rules or customer requests.

Properties

Name Meaning
Imsi The International Mobile Subscriber Identity (IMSI) uniquely identifying the subscriber. Required to specify which subscriber's subscription will be modified.
Template Name The name of the template defining the configuration or parameters of the supplementary service to be added. This likely corresponds to predefined service profiles.
Supplementary Service Type The type/category of the supplementary service to add, e.g., call forwarding, call barring, etc.

Output

The node outputs JSON data representing the result of the Add Supplementary Service operation. This typically includes confirmation of the service addition, status codes, messages, or any returned data from the Summa API indicating success or failure.

If the node supports binary data output, it would relate to any raw response or attachments from the API, but based on the provided code and context, the primary output is structured JSON reflecting the operation outcome.

Dependencies

  • Requires an API key credential for authenticating with the Summa API.
  • Uses an HTTP client internally to communicate with the Summa backend services.
  • The node depends on several internal modules for state management, operation resolution, and execution logic.
  • Proper configuration of the Summa API credentials within n8n is necessary before use.

Troubleshooting

  • Common Issues:

    • Missing or invalid IMSI value can cause the operation to fail because the subscriber cannot be identified.
    • Incorrect or non-existent template names may lead to errors or no action taken.
    • Invalid supplementary service types not supported by the API will result in error responses.
    • Authentication failures due to incorrect API credentials.
  • Error Messages:

    • Authentication errors: Check that the API key credential is correctly configured and valid.
    • Validation errors: Ensure all required fields (IMSI, Template Name, Supplementary Service Type) are provided and correctly formatted.
    • API errors: Review the response message for specific issues like unsupported service types or template mismatches.

Resolving these usually involves verifying input parameters, ensuring correct credential setup, and consulting the Summa API documentation for valid values.

Links and References

  • Summa API official documentation (not provided here; consult your API provider)
  • n8n documentation on creating and using API credentials
  • Telecommunications standards for IMSI and supplementary services (for understanding service types)

Discussion