PortaOne icon

PortaOne

Consume PortaOne API (v.1.0.24)

Overview

The PortaOne node for n8n enables users to interact with the PortaOne API, specifically targeting rate management tasks. The "Cleanup Inactive Rates" operation under the Rate Management resource is designed to remove or clean up rates that are no longer active for a specified tariff as of a given effective date. This is particularly useful for telecom billing administrators who need to maintain accurate and up-to-date rate tables by removing obsolete entries.

Practical Example:
A telecom operator wants to ensure their billing system does not contain outdated rates for a specific tariff. By using this node, they can automate the cleanup process, specifying the tariff and the date from which inactive rates should be removed.

Properties

Name Meaning
Authentication The authentication method to use. Options: Token Authentication, Basic Authentication.
Tariff ID The numeric identifier of the tariff whose inactive rates will be cleaned up.
Effective From The date (as a string) from which to consider rates as inactive for cleanup.
Simplify Whether to simplify the output data. If enabled, the output will be streamlined.
SimplifyPath Path to the property that should be returned if simplification is enabled.

Output

  • The node outputs a json field containing the result of the cleanup operation.
  • If Simplify is enabled, only the property specified by SimplifyPath will be included in the output.
  • The exact structure of the output depends on the response from the PortaOne API, but typically includes information about the rates that were cleaned up or affected.

Dependencies

  • External Services: Requires access to the PortaOne API.
  • API Credentials:
    • For Token Authentication: portaOneTokenApi credentials must be configured in n8n.
    • For Basic Authentication: portaOneBasicApi credentials must be configured in n8n.
  • n8n Configuration: Ensure the appropriate credentials are set up and selected based on the chosen authentication method.

Troubleshooting

  • Authentication Errors:
    • Error Message: "Invalid credentials" or "Authentication failed."
      Resolution: Verify that the correct authentication method and credentials are selected and valid.
  • Missing Required Fields:
    • Error Message: "Parameter 'Tariff ID' or 'Effective From' is required."
      Resolution: Ensure all required fields are filled in before executing the node.
  • API Connection Issues:
    • Error Message: "Unable to connect to PortaOne API."
      Resolution: Check network connectivity and API endpoint configuration.

Links and References

Discussion