Summa icon

Summa

Consume Summa API (v.0.1.6)

Actions100

Overview

This node allows you to create a basic supplementary service for an SS (Supplementary Service) Subscription via the Summa API. It is designed for telecom or network management scenarios where you need to programmatically manage supplementary services (such as call waiting, call forwarding, etc.) associated with a subscriber's SS subscription.

Common use cases:

  • Activating or deactivating supplementary services for a mobile subscriber.
  • Automating provisioning workflows for telecom operators.
  • Integrating with OSS/BSS systems to manage subscriber features.

Example:
A telecom operator wants to enable "Call Waiting" for a specific subscriber and set its activation and provisioning states using an automated workflow.


Properties

Name Type Meaning
Activation State options The current activation state of the supplementary service (e.g., NOT_ACTIVE, ACTIVE_AND_OPERATIVE).
Induction State options Indicates whether the service is induced (e.g., NOT_INDUCED, INDUCED).
Provisioning State options The provisioning status of the service (e.g., NOT_PROVISIONED, PROVISIONED).
Registration State options The registration status (e.g., REGISTERED, NOT_REGISTERED, ERASED, NOT_APPLICABLE).
Supplementary Service Type string The type of supplementary service to be managed (e.g., CallWaiting).
SS Subscription ID string Unique identifier for the SS subscription to which the service applies.
Operator ID string Identifier for the operator performing the action.

Output

The node returns a json object containing the result of the operation from the Summa API. The exact structure depends on the API response, but typically includes:

  • Status of the operation (success/failure)
  • Details of the created supplementary service
  • Any error messages if the operation failed

If the API supports binary data, it would represent exported files or documents related to the operation.


Dependencies

  • External Service: Requires access to the Summa API endpoint.
  • API Credentials: Needs valid Summa API credentials configured in n8n under the name summaApi.
  • n8n Configuration: Ensure the credential is tested and available; the node uses a built-in credential test method.

Troubleshooting

Common Issues:

  • Invalid Credentials: If the provided Summa API credentials are incorrect or expired, authentication will fail.
  • Missing Required Fields: All properties listed above are required. Omitting any will result in validation errors.
  • API Errors: If the Summa API returns an error (e.g., invalid SS Subscription ID), the node will output the error message in the response.

Error Messages & Resolutions:

  • "Authentication failed": Check your Summa API credentials in n8n.
  • "Missing required parameter": Ensure all required fields are filled in the node configuration.
  • "Resource not found": Verify that the SS Subscription ID and Operator ID are correct and exist in the system.

Links and References

  • n8n Documentation
  • (If available) Summa API documentation – consult your provider or internal documentation for detailed API specs.

Discussion