ProAbono icon

ProAbono

Interact with ProAbono API

Actions19

Overview

This node integrates with the ProAbono API to manage invoicing tasks, specifically allowing users to create a line item in a customer's balance. This operation is useful for adding custom charges or credits to a customer's invoice, such as additional fees, discounts, or adjustments that are not part of standard subscription billing.

Common scenarios include:

  • Adding one-time charges or fees to a customer’s account.
  • Adjusting balances before generating an invoice.
  • Recording manual transactions linked to a customer.

For example, if you want to bill a customer for a consulting session outside their regular subscription, you can create a balance line with a descriptive label and amount to reflect this charge on their next invoice.

Properties

Name Meaning
Reference Customer The unique identifier used within your own application to identify the customer for whom the line is created.
Label A descriptive label for the line item that will appear on the invoice, explaining the charge or credit.
Amount The monetary amount of the line item, specified in cents (e.g., 12797 represents €127.97), before taxes.
Quantity The quantity associated with the line item; purely informative and displayed on the invoice (default is 1).
Only if Customer Has Valid Payment Information? Option to create the line only if the customer has valid payment information ("Yes") or always create it regardless ("No").

Output

The node outputs JSON data representing the result of the API call to create the balance line. This typically includes details about the newly created line item such as its ID, label, amount, quantity, and status. The output structure allows subsequent workflow steps to access these details for further processing or logging.

There is no indication that the node outputs binary data.

Dependencies

  • Requires an active connection to the ProAbono API.
  • Needs credentials including a business identifier, an agent key, and an API key for authentication.
  • The base URL for API requests is dynamically constructed using the business ID from credentials.
  • Proper configuration of these credentials in n8n is necessary for successful operation.

Troubleshooting

  • Invalid Customer Identifier: If the provided reference customer ID does not exist or is incorrect, the API may return an error indicating the customer was not found. Verify the customer ID before running the node.
  • Insufficient Permissions: Errors related to authentication usually mean the API keys or credentials are invalid or lack required permissions. Check and update credentials accordingly.
  • Amount Format Issues: The amount must be specified in cents as an integer. Providing a decimal or incorrect format may cause errors. Ensure amounts are converted properly (e.g., €127.97 → 12797).
  • Payment Information Requirement: If the option to create the line only when the customer has valid payment info is enabled but the customer lacks such info, the line will not be created. Confirm customer payment details if lines are unexpectedly missing.
  • API Connectivity Problems: Network issues or incorrect base URL configuration can cause request failures. Verify network connectivity and credential settings.

Links and References

Discussion