Summa icon

Summa

Consume Summa API (v.0.1.7)
Join our community

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 subscriber management. Specifically, for the resource Send Protocol and operation Send Cancel Location To All Currents Of IMSI, the node sends a cancellation request targeting all current sessions associated with a given IMSI (International Mobile Subscriber Identity).

Typical use cases include:

  • Cancelling or terminating active subscriber sessions across network elements.
  • Managing subscriber mobility or session state in telecom environments.
  • Triggering network-level cancellation procedures based on subscriber identity.

For example, a telecom operator might use this node to cancel all active locations of a subscriber identified by their IMSI when the subscriber changes service plans or terminates service.

Properties

Name Meaning
Imsi The International Mobile Subscriber Identity (IMSI) string identifying the subscriber.
Map Cancellation Type The type of cancellation to send using the MAP protocol (e.g., specific cancellation reason).
Diameter Cancellation Type The type of cancellation to send using the Diameter protocol (e.g., specific cancellation reason).
Reattach Boolean flag indicating whether the subscriber should be reattached after cancellation.

Output

The node outputs JSON data representing the response from the Summa API after attempting to send the cancel location request. This typically includes status information about the cancellation operation, any error messages, and confirmation details.

If the node handles binary data, it would relate to raw protocol messages or logs, but based on the provided code and context, the output is primarily structured JSON reflecting the API response.

Dependencies

  • Requires an API key credential for authenticating with the Summa API.
  • Depends on the @digital-boss/n8n-designpatterns package for resource-operation resolution and execution patterns.
  • Uses internal backend modules for HTTP communication (HttpClient), state management (State), and operation methods (operations).
  • The node expects proper configuration of the Summa API credentials within n8n.

Troubleshooting

  • Common issues:

    • Invalid or missing IMSI value will cause the operation to fail.
    • Incorrect cancellation types may lead to API errors or unexpected behavior.
    • Network connectivity problems can prevent successful API calls.
    • Missing or invalid API credentials will result in authentication failures.

  • Error messages:

    • Authentication errors indicate issues with the provided API key; verify and update credentials.
    • Validation errors usually point to missing required parameters like IMSI or cancellation types.
    • Timeout or connection errors suggest network issues; check connectivity and endpoint availability.

Resolving these typically involves verifying input parameters, ensuring valid credentials, and confirming network access to the Summa API endpoint.

Links and References

Discussion