Summa icon

Summa

Consume Summa API (v.0.1.7)

Actions182

Overview

This node integrates with the Summa API to manage HLR (Home Location Register) subscription settings, specifically allowing users to apply custom Outgoing Data Barring (ODB) configurations. It is useful in telecom environments where controlling call and data barring on subscriber lines is necessary for compliance, fraud prevention, or service customization.

A practical example would be a telecom operator applying specific barring rules to a subscriber identified by their IMSI (International Mobile Subscriber Identity), such as disabling outgoing calls while allowing incoming calls and packet-oriented services.

Properties

Name Meaning
Imsi The International Mobile Subscriber Identity of the subscriber whose HLR ODB settings are modified.
Barring Of Outgoing Calls The setting to enable or disable barring of outgoing calls for the subscriber.
Barring Of Incoming Calls The setting to enable or disable barring of incoming calls for the subscriber.
Barring Of Roaming Calls The setting to enable or disable barring of roaming calls for the subscriber.
Barring Of Packet Oriented Services The setting to enable or disable barring of packet-oriented services (e.g., data services) for the subscriber.

Each barring property expects a string value indicating the desired barring state (e.g., "enabled", "disabled" or similar, depending on the API's accepted values).

Output

The node outputs JSON data representing the result of applying the custom HLR ODB settings. This typically includes confirmation of the applied settings, status codes, or error messages returned by the Summa API.

If the operation involves binary data (not indicated here), it would represent raw responses or files related to the HLR subscription update, but this node primarily deals with JSON responses.

Dependencies

  • Requires an active connection to the Summa API via an API key credential configured in n8n.
  • The node depends on internal helper classes for HTTP requests, state management, and operation resolution.
  • No additional external dependencies beyond the Summa API and its authentication.

Troubleshooting

  • Common Issues:

    • Invalid or missing IMSI: Ensure the IMSI is correctly provided and formatted.
    • Incorrect barring values: Use valid strings as per the Summa API specification for barring options.
    • Authentication failures: Verify that the API key credential is correctly set up and has sufficient permissions.
    • Network issues: Confirm connectivity to the Summa API endpoint.
  • Error Messages:

    • Authentication errors usually indicate invalid or expired credentials; reconfigure the API key.
    • Validation errors from the API may point to incorrect barring parameters or missing required fields.
    • Timeout or network errors suggest connectivity problems; check firewall and proxy settings.

Links and References

  • Summa API Documentation (Replace with actual URL)
  • Telecom standards on HLR and ODB settings for further understanding of barring concepts.

Discussion