Summa icon

Summa

Consume Summa API (v.0.1.7)

Actions182

Overview

The "Sim Swap Direct" operation of the "Sim Swap" resource in this node interacts with the Summa API to perform a direct SIM swap between two ICC IDs. This operation is useful in telecommunications scenarios where a subscriber's service needs to be transferred from one SIM card (identified by the "from" ICC ID) to another SIM card (identified by the "to" ICC ID). Practical applications include replacing a damaged SIM, upgrading to a new SIM, or transferring service to a different physical SIM card without changing the subscriber's profile.

Properties

Name Meaning
From Icc Id The ICC ID of the SIM card currently associated with the subscriber/service (source SIM).
To Icc Id The ICC ID of the SIM card to which the subscriber/service will be moved (target SIM).

Both properties are required string inputs that specify the source and target SIM cards for the swap operation.

Output

The node outputs JSON data representing the result of the SIM swap operation as returned by the Summa API. This typically includes status information about the swap, confirmation details, and any relevant metadata about the subscriber or SIM cards involved. The output does not explicitly handle binary data.

Dependencies

  • Requires an active connection to the Summa API via an API key credential.
  • The node depends on the summaApi credential for authentication.
  • Internally uses HTTP client utilities and operation resolvers to communicate with the Summa backend services.
  • No additional environment variables are explicitly required beyond the API credential.

Troubleshooting

  • Common Issues:

    • Invalid or missing ICC IDs can cause the operation to fail. Ensure both "From Icc Id" and "To Icc Id" are correctly provided.
    • Authentication errors if the API key credential is invalid or expired.
    • Network connectivity issues when reaching the Summa API endpoint.
  • Error Messages:

    • Authentication failures usually indicate problems with the API key; revalidate or update credentials.
    • Validation errors related to ICC IDs suggest checking the format and existence of the provided ICC IDs.
    • Timeout or network errors require verifying internet connectivity and API endpoint availability.

Links and References

Discussion