Summa icon

Summa

Consume Summa API (v.0.1.7)

Actions182

Overview

This node integrates with the Summa API to perform various operations related to telecommunications subscriptions and services. Specifically, for the "SS Subscription" resource and the "Remove Supplementary Service By MSISDN" operation, it removes a supplementary service associated with a given MSISDN (mobile number). This is useful in scenarios where a telecom operator or system administrator needs to deactivate or remove additional services linked to a subscriber's phone number.

Practical examples include:

  • Removing call forwarding or call barring services from a subscriber.
  • Deactivating value-added services that are no longer needed by the user.
  • Managing subscription changes programmatically via API calls.

Properties

Name Meaning
Msisdn The mobile number (MSISDN) of the subscriber whose supplementary service will be removed.
Template Name The name of the template defining the parameters or configuration for the removal request.
Supplementary Service Typel The type identifier of the supplementary service to be removed.

Output

The node outputs JSON data representing the result of the removal operation. This typically includes status information indicating success or failure, any messages returned by the Summa API, and possibly details about the affected subscription or service state after removal.

If the node supports binary data output, it would represent any raw response or files returned by the API, but based on the provided code and context, the primary output is structured JSON.

Dependencies

  • Requires an API key credential for authenticating with the Summa API.
  • Uses an HTTP client internally to communicate with the Summa backend services.
  • Depends on the n8n environment having this credential configured and tested.
  • The node relies on bundled internal modules for managing state, resolving operations, and executing requests.

Troubleshooting

  • Common issues:

    • Invalid or missing MSISDN input can cause the API call to fail.
    • Incorrect template name or supplementary service type may lead to errors or no action taken.
    • Authentication failures if the API key credential is not set up correctly.
    • Network connectivity problems affecting communication with the Summa API.
  • Error messages:

    • Authentication errors usually indicate invalid or expired credentials; reconfigure the API key.
    • Validation errors often point to missing or malformed input properties; verify all required fields.
    • API response errors might include service-specific codes; consult Summa API documentation for details.

Links and References

  • Summa API official documentation (not provided here, but recommended to consult for detailed API usage).
  • n8n documentation on creating and using custom nodes.
  • General telecom supplementary services concepts for understanding service types and templates.

Discussion