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 for managing rate records. The "Rate Management" resource with the "Get" operation allows you to retrieve detailed information about a specific rate by its unique ID. This is useful in scenarios where you need to fetch and process rate data for billing, reporting, or integration with other systems.

Practical examples:

  • Fetching the details of a particular rate for display in a dashboard.
  • Integrating rate information into automated workflows for invoicing or customer notifications.
  • Retrieving rate data to validate or audit pricing structures.

Properties

Name Meaning
Authentication The authentication method to use. Options: Token Authentication, Basic Authentication.
Rate ID The unique ID of the rate record (mandatory for update operations).
Simplify Whether to simplify the output data.
SimplifyPath Path to the property that should be returned (used when simplifying output).

Output

  • The node outputs a json field containing the retrieved rate information.
  • If Simplify is enabled, only the property specified by SimplifyPath (default: rate_info) will be included in the output, making the result more concise.
  • If Simplify is disabled, the full response from the API is returned as JSON.
  • No binary data is produced by this node.

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 in your n8n instance under the node's credential options.

Troubleshooting

  • Missing or Invalid Credentials:
    • Error: "No credentials found" or authentication errors.
      Resolution: Ensure the correct authentication method is selected and valid credentials are provided in n8n.
  • Invalid Rate ID:
    • Error: "Rate not found" or similar API error.
      Resolution: Double-check the Rate ID value; it must correspond to an existing rate in PortaOne.
  • Incorrect SimplifyPath:
    • Error: "Property not found" or empty output when using Simplify.
      Resolution: Verify that the path specified in SimplifyPath matches a property in the API response.

Links and References

Discussion