Summa icon

Summa

Consume Summa API (v.0.1.7)

Actions182

Overview

The "HLR Subscription - Apply Subscription Settings" operation in this node allows users to update or apply various subscription settings for a given IMSI (International Mobile Subscriber Identity) on the Summa API platform. This is useful in telecom environments where subscriber profiles and service parameters need to be programmatically managed, such as enabling/disabling barrings, call forwarding, location privacy classes, and other telephony-related configurations.

Typical use cases include:

  • Automating subscriber profile updates based on business rules.
  • Bulk updating of subscription parameters during migrations or provisioning.
  • Integrating telecom backend systems with external workflows for dynamic subscriber management.

For example, a user might apply a new HLR profile and set specific call barring options for a subscriber identified by their IMSI.

Properties

Name Meaning
Imsi The IMSI (International Mobile Subscriber Identity) of the subscriber whose settings are being applied. This is required.
Send Json Boolean flag indicating whether to send raw JSON data directly (true) or use structured additional fields (false).
Json Data Raw JSON data representing subscription settings to apply. Required if "Send Json" is true.
Additional Fields A collection of optional structured fields to specify subscription settings when "Send Json" is false. These include:
- Hlr Profile Identifier for the HLR profile to apply.
- Operator Determined Barring String value specifying operator-determined barring settings.
- Pdp Id Assignation List List of PDP context assignments, each with Id, PDP Context Identifier, and Template Name.
- Regional Subscription Regional subscription identifier string.
- Tele Service List List of tele services to apply.
- Bearer Service List List of bearer services to apply.
- Access Restriction Data String defining access restriction parameters.
- Localised Service Area Subscriptions List of localized service area subscription values.
- Advice Of Charge Chargings List of advice of charge charging values.
- Advice Of Charge Informations List of advice of charge information values.
- All Barrings List of all barring values.
- Autonomous Self Location Classes List of autonomous self-location class values.
- Barring Of All Incoming Calls List of barring values for all incoming calls.
- Barring Of Incoming Calls List of barring values for incoming calls.
- Barring Of Incoming Calls Roam List of barring values for incoming calls while roaming.
- Barring Of Outgoing Calls Except HPLMN Country List of barring values for outgoing calls except in home PLMN country.
- Barring Of Outgoing Calls List of barring values for outgoing calls.
- Barring Of Outgoing International Calls List of barring values for outgoing international calls.
- Basic Self Location Classes List of basic self-location class values.
- Call Deflections List of call deflection values.
- Call Forward On Mobile Subscriber Busies List of call forward values when mobile subscriber is busy.
- Call Forward On No Replies List of call forward values when there is no reply.
- Call Forward On Mobile Subscriber Not Reachables List of call forward values when mobile subscriber is not reachable.
- Call Forward Unconditionals List of unconditional call forward values.
- Call Holds List of call hold values.
- Calling Name Presentations List of calling name presentation values.
- Call Line Identification Presentations List of call line identification presentation values.
- Call Line Identification Restrictions List of call line identification restriction values.
- Call Or Session Related LCS Privacy Classes List of call/session related location service privacy class values.
- Call Or Session Unrelated LCS Privacy Classes List of call/session unrelated location service privacy class values.
- Call Waitings List of call waiting values.
- Closed User Groups List of closed user group values.
- Completion Calls To Busy Subscriber As List of completion call values to busy subscriber type A.
- Completion Calls To Busy Subscriber Bs List of completion call values to busy subscriber type B.
- Connected Line Identification Presentations List of connected line identification presentation values.
- Connected Line Identification Restrictions List of connected line identification restriction values.
- Enhanced Multi Level Precedence And Preemptions List of enhanced multi-level precedence and preemption values.
- Explicit Call Transfers List of explicit call transfer values.
- Multi Parties List of multi-party call values.
- Plmn Operator LCS Privacy Classes List of PLMN operator location service privacy class values.
- Transfer To Third Party Classes List of transfer to third party class values.
- Universal LCS Privacy Classes List of universal location service privacy class values.
- User To User Signalling1s List of user-to-user signalling type 1 values.
- User To User Signalling2s List of user-to-user signalling type 2 values.
- User To User Signalling3s List of user-to-user signalling type 3 values.
- Anonymous Call Rejection String value to enable or configure anonymous call rejection.
- Multi Call String value to enable or configure multi-call features.
- Ussd Profile USSD profile identifier string.
- Cse Notification Profile CSE notification profile identifier string.
- Msrn Profile MSRN profile identifier string.
- Pdpassignations String value for PDP assignations.

Output

The node outputs JSON data representing the response from the Summa API after applying the subscription settings. This typically includes confirmation of the applied settings, status messages, or error details if the operation failed.

If binary data were involved (not indicated here), it would represent files or media related to the subscription, but this operation focuses on JSON responses only.

Dependencies

  • Requires an active connection to the Summa API service.
  • Requires valid API authentication credentials configured in n8n (an API key or token).
  • The node uses internal HTTP client utilities to communicate with the Summa backend.
  • No additional environment variables are explicitly required beyond standard credential setup.

Troubleshooting

  • Invalid IMSI: If the IMSI provided is incorrect or not found, the API may return an error. Verify the IMSI format and existence.
  • Malformed JSON Data: When "Send Json" is true, ensure that the JSON data is well-formed and matches the expected schema; otherwise, the API will reject the request.
  • Missing Required Fields: Some subscription settings may require mandatory fields; omitting them can cause errors.
  • API Authentication Errors: Ensure the API credentials are correctly configured and have sufficient permissions.
  • Network Issues: Connectivity problems to the Summa API endpoint will cause failures; check network and proxy settings.
  • Unsupported Field Values: Providing unsupported or invalid values in additional fields may result in API validation errors.

Common error messages usually indicate which field or parameter caused the issue, helping to correct the input.

Links and References

  • Summa API official documentation (refer to your organization's API docs for detailed field descriptions and examples).
  • Telecom standards references for IMSI and subscription parameters.
  • n8n documentation on creating and using custom nodes with API credentials.

Discussion