HaloPSA Complete

Overview

This node integrates with the HaloPSA API to perform various operations on different resources. Specifically, for the Invoice resource and the Void operation, it allows users to void an existing invoice by specifying its ID. This is useful in scenarios where an invoice was issued incorrectly or needs to be canceled without deleting it from the system.

Practical examples include:

• Voiding an invoice that was created with incorrect billing details.
• Canceling an invoice before payment is processed.
• Automating invoice management workflows where invalid invoices are programmatically voided.

Properties

The "Invoice ID" property is a required numeric input that identifies which invoice should be voided.

Output

The node outputs JSON data representing the result of the void operation on the specified invoice. This typically includes confirmation of the void action and any relevant invoice details returned by the API after voiding.

No binary data output is involved in this operation.

Dependencies

• Requires an active connection to the HaloPSA API.
• Needs an API authentication token or key configured in n8n credentials to authorize requests.
• The node relies on internal routing logic (router) to dispatch the request to the correct API endpoint based on the resource and operation.

Troubleshooting

• Common issues:

  • Invalid or missing Invoice ID: Ensure the Invoice ID provided exists and is valid.
  • Authentication errors: Verify that the API key or token is correctly set up and has sufficient permissions.
  • Network or API downtime: Check connectivity and HaloPSA service status.

• Error messages:

  • "Invoice not found": The specified Invoice ID does not exist; verify the ID.
  • "Unauthorized": Authentication failed; check API credentials.
  • "Operation not allowed": The invoice may already be voided or in a state that prevents voiding.

Resolving these usually involves verifying input parameters, checking credentials, and ensuring the invoice is in a voidable state.

Links and References

• HaloPSA API Documentation (general reference for API endpoints)
• n8n documentation on creating custom nodes