Actions39
- Client Actions
- Client Contact Actions
- Invoice Actions
- Order Actions
- Account Actions
- Service Actions
- Domain Actions
Overview
This node allows you to interact with the HostBill API, specifically to set the status of an invoice. The "Set Status" operation for the "Invoice" resource enables users to update the status of a specific invoice (e.g., mark it as Paid, Unpaid, or Cancelled). This is useful in automated billing workflows where invoice statuses need to be updated based on payment events or other business logic.
Example scenarios:
- Automatically marking invoices as "Paid" when a payment is received.
- Setting invoices to "Cancelled" if an order is voided.
- Updating invoice status to "Unpaid" for overdue reminders.
Properties
| Name | Type | Meaning |
|---|---|---|
| Invoice ID | Number | The unique identifier of the invoice whose status you want to update. |
| Status | Options | The new status to set for the invoice. Possible values: Paid, Unpaid, Cancelled. |
Output
The output will be a JSON object (or array of objects) representing the result of the status update operation for each processed item. The structure typically includes fields returned by the HostBill API after updating the invoice status, such as confirmation of the change and possibly the updated invoice details.
If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message for that item.
Dependencies
- External Service: Requires access to a HostBill instance with API enabled.
- API Credentials: You must configure valid HostBill API credentials in n8n under the name
hostBillApi. - n8n Configuration: No special environment variables are required beyond standard credential setup.
Troubleshooting
Common Issues:
- Invalid Credentials: If the provided HostBill API credentials are incorrect, the node will throw an authentication error. Ensure your credentials are correct and have sufficient permissions.
- Missing Required Fields: If "Invoice ID" or "Status" is not provided, the node will fail. Make sure all required properties are set.
- Invalid Status Value: Providing a status value outside the allowed options ("Paid", "Unpaid", "Cancelled") will result in an error.
Error Messages:
"Cannot read property 'execute' of undefined": This may indicate a misconfiguration or missing dependency. Check that all required files and modules are present."NodeOperationError": General error wrapper; check the error message for specifics (e.g., invalid parameters, API errors).