Summa icon

Summa

Consume Summa API (v.0.1.7)
Join our community

Actions182

Overview

This node integrates with the Summa API to perform various operations on telecom-related resources. Specifically, for the MSISDN resource and the Change MSISDN operation, it allows users to update or swap an existing MSISDN (Mobile Station International Subscriber Directory Number) with a new one. This is useful in scenarios such as number porting, subscriber profile updates, or correcting erroneous MSISDN entries.

Practical examples include:

  • Updating a subscriber's phone number after a SIM swap.
  • Migrating a subscriber to a new MSISDN due to network changes.
  • Correcting data inconsistencies in subscriber records.

Properties

Name Meaning
Old Msisdn The current MSISDN value that needs to be changed. This is the identifier to replace.
New Msisdn The new MSISDN value that will replace the old one.

Both properties are required string inputs.

Output

The node outputs JSON data representing the result of the MSISDN change operation. This typically includes confirmation of the update, status messages, and possibly updated subscriber details reflecting the new MSISDN.

If the operation involves any binary data (not indicated here), it would represent related files or attachments, but this node primarily deals with JSON responses from the Summa API.

Dependencies

  • Requires connection to the Summa API via an API key credential configured in n8n.
  • Uses internal helper classes for HTTP requests, state management, and operation resolution.
  • The node depends on the summaApi credential to authenticate requests.
  • No additional external services beyond the Summa API are needed.

Troubleshooting

  • Authentication errors: Ensure the API key credential is correctly set up and has necessary permissions.
  • Invalid MSISDN format: Verify that both old and new MSISDN values conform to expected formats (e.g., including country codes).
  • Operation failures: If the API returns errors about the MSISDN not found or already in use, double-check the input values.
  • Network issues: Confirm that the n8n instance can reach the Summa API endpoint without firewall or proxy restrictions.

Common error messages might include:

  • "Unauthorized" or "Invalid credentials": Check API key validity.
  • "MSISDN not found": The old MSISDN does not exist in the system.
  • "MSISDN already exists": The new MSISDN is already assigned to another subscriber.

Links and References

Discussion