Summa icon

Summa

Consume Summa API (v.0.1.7)

Actions182

Overview

The node named "Summa" integrates with the Summa API to perform various telecom-related operations. Specifically, for the Sim Swap Direct Explicit operation under the Sim Swap resource, it facilitates direct and explicit swapping of SIM cards by specifying source and target ICC IDs along with IMSI mappings. This is useful in scenarios where a telecom operator or system administrator needs to transfer subscriber identity information from one SIM card to another explicitly, such as during device upgrades, SIM replacements, or fraud prevention measures.

Practical examples:

  • Migrating a subscriber's service from an old SIM card to a new one.
  • Correcting SIM assignment errors by explicitly mapping IMSIs between SIMs.
  • Managing bulk IMSI swaps during network maintenance or upgrades.

Properties

Name Meaning
From Icc Id The ICC ID (Integrated Circuit Card Identifier) of the source SIM card to swap from.
To Icc Id The ICC ID of the target SIM card to swap to.
Imsi Swaps A collection of IMSI pairs defining the old IMSI values and their corresponding new IMSI values to be swapped. Each entry contains:
- Old Imsi: The current IMSI on the source SIM.
- New Imsi: The IMSI to assign on the target SIM.
Operator Name The name of the mobile network operator managing the SIM swap operation.

Output

The node outputs JSON data representing the result of the SIM swap operation. This typically includes confirmation of the swap status, details of the IMSI mappings applied, and any relevant metadata returned by the Summa API. The output structure depends on the API response but generally confirms success or failure of the requested swaps.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active connection to the Summa API via an API key credential configured in n8n.
  • The node uses an HTTP client internally to communicate with the Summa backend services.
  • Proper configuration of the API credentials and network access to the Summa API endpoint is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing ICC IDs or IMSI values can cause the operation to fail.
    • Network connectivity problems or incorrect API credentials will prevent successful communication with the Summa API.
    • Mismatched IMSI pairs or attempting to swap IMSIs not associated with the specified ICC IDs may result in errors.
  • Error messages:

    • Authentication failures indicate invalid or expired API credentials; verify and update the API key.
    • Validation errors about ICC ID or IMSI formats suggest input data does not meet expected patterns; ensure correct formatting.
    • API response errors related to operator name or permissions imply that the operator name might be incorrect or the API user lacks required privileges.

Resolving these usually involves verifying input parameters, checking API credentials, and ensuring network connectivity.

Links and References

  • Summa API Documentation (Replace with actual URL if available)
  • Telecom standards for ICC ID and IMSI formats for reference.
  • n8n documentation on creating and using API credentials.

Discussion