Summa icon

Summa

Consume Summa API (v.0.1.7)

Actions182

Overview

This node integrates with the Summa API to perform various telecom-related operations. Specifically, for the "Send Protocol" resource and the "Send Cancel Location To Current SGSN Of Imsi" operation, it sends a cancellation request related to a mobile subscriber identified by their IMSI (International Mobile Subscriber Identity). This operation is useful in telecom network management scenarios where you need to cancel or update the location information of a subscriber on the current Serving GPRS Support Node (SGSN).

Practical examples include:

  • Cancelling the location of a subscriber who is no longer active on a particular SGSN.
  • Managing subscriber mobility and session state in LTE or 3G networks.
  • Triggering reattachment procedures after cancellation if needed.

Properties

Name Meaning
Imsi The International Mobile Subscriber Identity (IMSI) of the subscriber whose location is to be cancelled.
Map Cancellation Type The type of cancellation according to the MAP (Mobile Application Part) protocol.
Diameter Cancellation Type The type of cancellation according to the Diameter protocol.
Reattach Boolean flag indicating whether the subscriber should be requested to reattach 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 success or failure of the operation, any error messages, and possibly details about the subscriber's updated state.

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

Dependencies

  • Requires an API key credential for authenticating with the Summa API.
  • Depends on the Summa API service being accessible and properly configured.
  • Uses internal helper classes for HTTP requests, state management, and operation resolution.
  • No additional external services are explicitly required beyond the Summa API.

Troubleshooting

  • Common Issues:

    • Invalid or missing IMSI value will cause the operation to fail.
    • Incorrect cancellation types (MAP or Diameter) may result in errors from the API.
    • Network connectivity issues can prevent successful communication with the Summa API.
    • Missing or invalid API credentials will block authentication.
  • Error Messages:

    • Authentication errors indicate problems with the provided API key; verify and update credentials.
    • Validation errors usually point to incorrect input parameters; double-check IMSI and cancellation type values.
    • Timeout or connection errors suggest network problems; ensure the API endpoint is reachable.

Links and References

  • Summa API Documentation (replace with actual URL)
  • Telecom protocols reference for MAP and Diameter cancellation types.
  • n8n documentation on creating custom nodes and using credentials.

Discussion