Summa icon

Summa

Consume Summa API (v.0.1.7)

Actions182

Overview

This node integrates with the Summa API to manage SS (Supplementary Service) Subscriptions via SOAP. Specifically, the "Create Basic Supplementary Service For SS Subscription" operation allows users to create and configure a basic supplementary service linked to an existing SS subscription.

Typical use cases include telecom operators or service providers who need to programmatically manage supplementary services such as call waiting, call forwarding, or other value-added services on subscriber accounts. For example, activating call waiting for a subscriber or setting the provisioning state of a supplementary service can be automated using this node.

Properties

Name Meaning
Activation State The activation status of the supplementary service. Options: NOT_ACTIVE, ACTIVE_AND_OPERATIVE
Induction State Indicates whether the supplementary service is induced or not. Options: NOT_INDUCED, INDUCED
Provisioning State The provisioning status of the supplementary service. Options: NOT_PROVISIONED, PROVISIONED
Registration State The registration status of the supplementary service. Options: REGISTERED, NOT_REGISTERED, ERASED, NOT_APPLICABLE
Supplementary Service Type The type/name of the supplementary service to create (e.g., CallWaiting).
SS Subscription ID Identifier of the SS subscription to which the supplementary service will be added.
Operator ID Identifier of the operator managing the subscription/service.

Output

The node outputs JSON data representing the result of the creation operation for the basic supplementary service. This typically includes confirmation details such as the status of the request, identifiers, and any relevant metadata returned by the Summa API.

If the operation involves binary data (not indicated here), it would represent related files or attachments, but in this case, the output is purely JSON-based.

Dependencies

  • Requires an active connection to the Summa API, authenticated via an API key credential.
  • The node depends on the summaApi credential configured in n8n for authentication.
  • Uses internal helper classes for HTTP requests, state management, and operation resolution/execution.
  • No additional external dependencies beyond the Summa API and its credentials.

Troubleshooting

  • Common Issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect SS Subscription ID or Operator ID may lead to errors indicating that the subscription or operator was not found.
    • Providing invalid values for states (activation, induction, provisioning, registration) may cause validation errors from the API.
  • Error Messages:

    • Authentication errors: Check that the API key credential is correctly set up and valid.
    • Validation errors: Ensure all required fields are provided and conform to expected options.
    • Network or timeout errors: Verify network connectivity to the Summa API endpoint.

Resolving these typically involves verifying input parameters, ensuring correct credential configuration, and confirming network access.

Links and References

Discussion