HostBill

Overview

This node allows you to delete an invoice from the HostBill system by specifying its unique Invoice ID. It is useful in automation scenarios where invoices need to be programmatically removed, such as cleaning up test data, handling cancellations, or integrating with other systems that require invoice management.

Example use cases:

• Automatically deleting invoices that were created in error.
• Integrating with a CRM or ERP system to remove invoices when a customer account is deleted.
• Cleaning up old or unpaid invoices as part of a scheduled workflow.

Properties

Output

The output will be a JSON object (or array of objects) representing the result of the delete operation. Typical fields may include:

• A confirmation of successful deletion (e.g., a status message or success flag).
• If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message.

Example output:

[
  {
    "success": true,
    "message": "Invoice deleted successfully"
  }
]

Or, if an error occurs and "Continue On Fail" is enabled:

[
  {
    "error": "Invoice not found"
  }
]

Dependencies

• HostBill API: Requires access to a HostBill instance with API enabled.
• API Credentials: You must configure valid HostBill API credentials in n8n under the name hostBillApi.

Troubleshooting

• Missing or Invalid Invoice ID: If the provided Invoice ID does not exist, the node will return an error such as "Invoice not found".
• Authentication Errors: If API credentials are missing or incorrect, you may see errors related to authentication failure.
• Permission Issues: The API user must have permission to delete invoices; otherwise, you may receive a permission denied error.
• Network Issues: Connectivity problems between n8n and HostBill can cause timeouts or connection errors.

How to resolve:

• Double-check the Invoice ID for accuracy.
• Ensure your API credentials are correct and have sufficient permissions.
• Verify network connectivity to the HostBill server.

Links and References

• HostBill API Documentation
• n8n Documentation: Custom Nodes