Summa icon

Summa

Consume Summa API (v.0.1.7)

Actions182

Overview

This node integrates with the Summa API to create a Calling Name Presentation for a Supplementary Service (SS) Subscription via SOAP. It is designed to manage telecommunication service subscriptions, specifically enabling or configuring the presentation of the calling name associated with a subscription.

Typical use cases include:

  • Telecom operators automating the activation or update of calling name presentation services on subscriber accounts.
  • Systems that need to provision or modify supplementary services programmatically in bulk or as part of a workflow.
  • Integrations where calling name presentation status must be synchronized with other subscriber data.

For example, a telecom operator could use this node to activate calling name presentation for a new subscriber or update the state of an existing subscription's calling name presentation service.

Properties

Name Meaning
Activation State The current activation status of the calling name presentation service. Options: NOT_ACTIVE, ACTIVE_AND_OPERATIVE
Id Unique identifier for the SS subscription to be modified or created
Induction State Indicates whether the service has been induced or not. Options: NOT_INDUCED, INDUCED
Override Category Whether to override the default category settings. Options: FALSE, TRUE
Provisioning State The provisioning status of the service. Options: NOT_PROVISIONED, PROVISIONED
Registration State Registration status of the service. Options: REGISTERED, NOT_REGISTERED, ERASED, NOT_APPLICABLE
Supplementary Service Type The type of supplementary service; here it is fixed as "CallingNamePresentation"
Hlr Subscription ID Identifier for the Home Location Register subscription related to this SS subscription
Operator ID Identifier for the operator managing the subscription

Output

The node outputs JSON data representing the result of the SOAP request to create or update the Calling Name Presentation service for the specified SS subscription. This typically includes confirmation of the operation's success, updated subscription details, or error information if the operation failed.

No binary data output is indicated by the source code.

Dependencies

  • Requires an API key credential for authenticating with the Summa API.
  • Depends on the Summa API endpoint accessible via HTTP(S).
  • Uses internal helper classes for HTTP requests, state management, and operation resolution/execution.
  • Requires proper configuration of the "summaApi" credential within n8n.

Troubleshooting

  • Common issues:
    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect or incomplete property values (e.g., missing required fields like id or operatorId) may lead to API errors.
    • Network connectivity problems can prevent successful communication with the Summa API.
  • Error messages:
    • Authentication errors usually indicate invalid API keys or misconfigured credentials.
    • Validation errors from the API may specify which input property is incorrect or missing.
    • Timeout or connection errors suggest network issues or unreachable API endpoints.
  • Resolutions:
    • Verify and re-enter API credentials.
    • Ensure all required properties are provided and valid.
    • Check network access and firewall settings.
    • Review API documentation for correct property usage.

Links and References


Note: The above summary is based solely on static analysis of the provided source code and property definitions.

Discussion