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) subscriptions, specifically allowing users to set GMLC (Gateway Mobile Location Center) numbers associated with a subscriber's IMSI (International Mobile Subscriber Identity). It is useful in telecom environments where location services need to be configured or updated for mobile subscribers.

Typical use cases include:

  • Updating location center numbers for subscribers to enable or modify location-based services.
  • Automating telecom subscriber management workflows involving HLR data.
  • Integrating telecom backend systems with external APIs for subscriber data updates.

For example, a telecom operator could use this node to programmatically update the GMLC numbers for a batch of subscribers based on changing network configurations or regulatory requirements.

Properties

Name Meaning
Imsi The IMSI (International Mobile Subscriber Identity) of the subscriber whose GMLC numbers are being set. This is a required string input.
Send Json Boolean flag indicating whether to send the GMLC numbers as raw JSON (true) or via structured fields (false).
Json Data When Send Json is true, this JSON input contains the full data payload for setting GMLC numbers. Must be valid JSON representing the address list and related info.
Address Dto List When Send Json is false, this is a collection of structured entries specifying GMLC addresses. Each entry includes:
- Address: The GMLC number/address string.
- Address Type: Type classification of the address.
- Address Nature: Nature/category of the address.
- Numbering Plan: Numbering plan used for the address format. Multiple such entries can be provided.

Output

The node outputs JSON data representing the response from the Summa API after attempting to set the GMLC numbers. This typically includes status information about the operation, any errors, and confirmation details.

No binary data output is indicated by the source code or properties.

Dependencies

  • Requires an API key credential for authenticating with the Summa API.
  • Uses an HTTP client internally to communicate with the Summa backend service.
  • The node depends on the Summa API version specified in the bundled code (version referenced dynamically).
  • No additional environment variables are explicitly required beyond the API credential.

Troubleshooting

  • Invalid IMSI: If the IMSI is missing or malformed, the API will likely reject the request. Ensure the IMSI is correctly formatted and provided.
  • Malformed JSON: When using the Send Json option, invalid JSON syntax or incorrect structure in Json Data will cause errors. Validate JSON before sending.
  • Missing Required Fields: If Send Json is false but no addresses are provided in Address Dto List, the request may fail due to lack of data.
  • Authentication Errors: Failure to provide a valid API key credential or expired credentials will result in authentication failures.
  • API Errors: The Summa API might return error messages if the GMLC numbers are invalid or if there are backend issues. Check the returned JSON for error details.

To resolve these issues:

  • Double-check all required inputs.
  • Validate JSON formatting.
  • Confirm API credentials are correct and active.
  • Review API response messages for specific error codes or descriptions.

Links and References

  • Summa API Documentation (Replace with actual URL)
  • Telecom standards for IMSI and GMLC numbers (e.g., 3GPP TS 23.003)
  • n8n HTTP Request Node documentation for understanding underlying HTTP communication patterns

Discussion