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 in the code). Specifically, for the resource SS Subscription and operation Get All Supplementary Services By MSISDN, it retrieves all supplementary services associated with a given MSISDN (a mobile phone number in international format).

Common scenarios where this node would be beneficial include:

  • Telecom operators or service providers wanting to fetch all active or available supplementary services linked to a subscriber's phone number.
  • Customer support systems that need to display or verify supplementary services for a user during support calls.
  • Automated workflows that adjust or audit subscriber services based on their current subscriptions.

Practical example:

  • A workflow that takes a customer's phone number as input and returns all supplementary services they have enabled, such as call forwarding, voicemail, or data packages.

Properties

Name Meaning
Msisdn The MSISDN (mobile phone number) for which to retrieve all supplementary services. This is a required string input.

Output

The node outputs JSON data containing the list of supplementary services associated with the provided MSISDN. The exact structure depends on the Summa API response but typically includes details about each supplementary service such as service name, status, activation date, and other relevant metadata.

If the node supports binary data output, it is not indicated in the provided source; thus, the output is primarily JSON-based.

Dependencies

  • Requires an API key credential to authenticate with the Summa API.
  • Uses an HTTP client internally to send requests to the Summa backend.
  • The node depends on the summaApi credential being configured and tested successfully within n8n.
  • No additional environment variables are explicitly required beyond the API credential.

Troubleshooting

  • Missing or invalid MSISDN: Since the MSISDN property is required, ensure it is provided and correctly formatted. Invalid phone numbers may cause API errors.
  • Authentication errors: If the API key credential is missing, invalid, or expired, the node will fail to authenticate with the Summa API. Verify the credential configuration.
  • API connectivity issues: Network problems or incorrect API endpoint configurations can cause request failures. Check network access and credential settings.
  • Unexpected API responses: If the Summa API changes or returns unexpected data, the node might not parse the output correctly. Review API documentation and update the node if necessary.

Links and References

Discussion