Summa icon

Summa

Consume Summa API (v.0.1.7)

Actions182

Overview

The node named "Summa" is designed to interact with the Summa API, specifically supporting various telecom-related operations. In the context of the Sim Swap resource and the Sim Swap Deferred operation, this node facilitates the deferred swapping of SIM cards by specifying the source and target ICC IDs (Integrated Circuit Card Identifiers). This operation is useful in scenarios where a SIM card needs to be replaced or transferred at a later time rather than immediately, such as scheduling SIM swaps for subscriber management or device provisioning workflows.

Practical examples include:

  • Telecom operators managing subscriber SIM replacements without immediate activation.
  • Automated workflows that prepare SIM swaps in advance and trigger them based on external events.
  • Systems integrating with Summa API to maintain subscriber data consistency during SIM lifecycle changes.

Properties

Name Meaning
From Icc Id The ICC ID of the current SIM card to be swapped out. This is a required string input.
To Icc Id The ICC ID of the new SIM card to be swapped in. This is a required string input.

Output

The node outputs JSON data representing the result of the Sim Swap Deferred operation as returned by the Summa API. This typically includes status information about the swap request, confirmation details, or error messages if the operation fails.

If the node supports binary data output, it would generally relate to any files or attachments returned by the API, but based on the provided code and properties, the primary output is structured JSON data reflecting the API response.

Dependencies

  • Requires an active connection to the Summa API via an API key credential configured in n8n.
  • Uses internal helper classes for HTTP requests and state management.
  • Depends on the summaApi credential for authentication.
  • No additional external services are explicitly required beyond the Summa API endpoint.

Troubleshooting

  • Common issues:
    • Invalid or missing ICC IDs can cause the API to reject the request.
    • Authentication failures due to incorrect or expired API credentials.
    • Network connectivity problems preventing access to the Summa API.
  • Error messages:
    • Authentication errors typically indicate invalid API keys; verify and update credentials.
    • Validation errors from the API may specify which ICC ID is problematic; ensure correct formatting.
    • Timeout or network errors suggest checking internet connectivity or API endpoint availability.

Links and References


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

Discussion