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 related to telecommunications data management. Specifically, for the MSISDN resource and the Link Subscriber MSISDN operation, it links a mobile subscriber's MSISDN (phone number) to their account or profile in the system.

Typical use cases include:

  • Associating a new phone number with an existing subscriber.
  • Managing subscriber data during SIM swaps or number porting.
  • Synchronizing subscriber information across systems.

For example, a telecom operator could use this node to programmatically link a newly issued MSISDN to a subscriber’s profile after activation.

Properties

Name Meaning
Msisdn The MSISDN (phone number) to be linked to the subscriber.
Send Json Boolean flag indicating whether to send raw JSON data directly instead of individual fields.
Json Data Raw JSON data to send when "Send Json" is true; contains the full payload for linking the MSISDN.
Icc Id The ICCID (SIM card identifier) associated with the subscriber, used when not sending raw JSON.
Imsis Not Affected A collection of IMSI values that should remain unaffected by this linking operation (optional).

Output

The node outputs JSON data representing the result of the linking operation. This typically includes confirmation details such as success status, any updated subscriber information, or error messages if the operation failed.

If binary data were involved (e.g., files or images), it would be summarized here, but this node focuses on JSON responses from the API.

Dependencies

  • Requires an API key credential for authenticating with the Summa API.
  • Uses an HTTP client internally to communicate with the Summa backend service.
  • The node depends on the Summa API being accessible and properly configured with valid credentials.

Troubleshooting

  • Authentication errors: Ensure the API key credential is correctly set up and has necessary permissions.
  • Invalid input data: Verify that required fields like Msisdn and Icc Id are provided and formatted correctly.
  • API connectivity issues: Check network access to the Summa API endpoint.
  • JSON parsing errors: When using the "Send Json" option, ensure the JSON data is well-formed and matches the expected schema.

Common error messages will relate to missing parameters, authentication failures, or invalid request formats. Reviewing the API documentation and validating inputs before execution can help resolve these.

Links and References

Discussion