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). Specifically, for the resource Send Protocol and operation Send Diameter Cancel Location SGSN, it sends a Diameter protocol message to cancel the location of an SGSN (Serving GPRS Support Node) identified by an IMSI. This operation is typically used in mobile network management scenarios where subscriber session or location information needs to be invalidated or updated in the network.

Practical examples include:

  • Cancelling the current SGSN location of a subscriber when they move to a different serving node.
  • Triggering reattachment procedures by setting flags indicating whether the subscriber should reattach.
  • Managing subscriber mobility and session state in LTE or 3G networks via Diameter signaling.

Properties

Name Meaning
Imsi The International Mobile Subscriber Identity (IMSI) identifying the subscriber uniquely.
Cancellation Type The type of cancellation to perform; defines how the location cancellation is processed.
Reattach Required Flag Indicates whether the subscriber is required to reattach after cancellation (e.g., "true" or "false").
Serving Node Identifier of the current serving node (SGSN) from which the location cancellation is sent.

Output

The node outputs JSON data representing the response from the Summa API after sending the Diameter Cancel Location SGSN message. This output typically includes status information about the request, any error messages, and confirmation details of the cancellation operation.

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 @digital-boss/n8n-designpatterns package for resource-operation resolution and execution patterns.
  • Uses internal backend modules for HTTP client communication, state management, and operation methods.
  • The node expects proper configuration of the Summa API credentials within n8n.

Troubleshooting

  • Common issues:

    • Invalid or missing IMSI value will cause the API call to fail.
    • Incorrect cancellation type or flag values may result in unexpected behavior or errors from the API.
    • Network connectivity problems or incorrect API credentials will prevent successful communication with the Summa API.
  • Error messages:

    • Authentication failures indicate issues with the provided API key credential; verify and update credentials as needed.
    • Validation errors from the API usually point to malformed or missing input properties; ensure all required fields are correctly filled.
    • Timeout or connection errors suggest network issues; check connectivity and endpoint availability.

Links and References

Discussion