Summa icon

Summa

Consume Summa API (v.0.1.7)

Actions182

Overview

This node integrates with the Summa API to perform telecom-related operations. Specifically, the "Sim Swap Direct Without Remove" operation under the "Sim Swap" resource allows users to directly swap SIM cards between two ICC IDs without removing the original SIM first. This is useful in scenarios where a subscriber's service needs to be transferred from one SIM card to another seamlessly, such as replacing a damaged SIM or upgrading to a new SIM while maintaining the same subscription.

Practical examples include:

  • Telecom operators automating SIM replacement processes.
  • Customer support workflows that require quick SIM swaps without service interruption.
  • Systems managing inventory and activation of SIM cards dynamically.

Properties

Name Meaning
From Icc Id The ICC ID (Integrated Circuit Card Identifier) of the SIM card currently in use.
To Icc Id The ICC ID of the SIM card to which the service will be swapped directly without removal.

Output

The node outputs JSON data representing the result of the SIM swap operation. This typically includes confirmation details such as status, any identifiers related to the swap transaction, and possibly updated subscription information. The output does not explicitly mention binary data, so it is assumed to be purely JSON structured.

Dependencies

  • Requires an active connection to the Summa API via an API key credential.
  • The node depends on the summaApi credential for authentication.
  • Uses internal helper classes for HTTP requests, state management, and operation execution.
  • No additional external services are indicated beyond the Summa API.

Troubleshooting

  • Authentication errors: Ensure the API key credential is correctly configured and has necessary permissions.
  • Invalid ICC IDs: Verify that both "From Icc Id" and "To Icc Id" are valid and active ICC identifiers recognized by the Summa system.
  • API connectivity issues: Check network access to the Summa API endpoint and confirm no firewall or proxy blocks.
  • Operation failures: Review error messages returned by the API for specific reasons such as subscription conflicts or invalid state transitions.
  • Missing required parameters: Both ICC IDs are mandatory; missing or empty values will cause errors.

Links and References

Discussion