HostBill

Overview

The HostBill node for n8n allows you to interact with the HostBill API. Specifically, when using the Invoice resource and the Get operation, this node retrieves details of a specific invoice from your HostBill system by its ID. This is useful in automation scenarios where you need to fetch invoice data for reporting, notifications, or integration with other systems.

Example use cases:

• Retrieve an invoice's details to send a payment reminder.
• Fetch invoice information to update records in another system.
• Use invoice data as part of a workflow for financial reconciliation.

Properties

Output

The output will be a JSON object containing the details of the requested invoice. The exact structure depends on the HostBill API response, but typically includes fields such as invoice number, date, client information, line items, amounts, status, etc.

Example output:

{
  "id": 1234,
  "number": "INV-2023-0001",
  "date": "2023-06-01",
  "client": {
    "id": 567,
    "name": "Acme Corp"
  },
  "items": [
    {
      "description": "Web Hosting",
      "amount": 100
    }
  ],
  "total": 100,
  "status": "Paid"
}

Note: Actual fields may vary based on your HostBill configuration.

Dependencies

• External Service: Requires access to a HostBill instance with API enabled.
• API Credentials: You must configure hostBillApi credentials in n8n.
• n8n Configuration: No additional environment variables are required beyond standard credential setup.

Troubleshooting

• Missing or Invalid Credentials:
  Error message: "No credentials found" or authentication errors.
  Resolution: Ensure that the hostBillApi credentials are correctly set up in n8n.

• Invalid Invoice ID:
  Error message: "Invoice not found" or similar.
  Resolution: Double-check the Invoice ID provided; ensure it exists in your HostBill system.

• API Connection Issues:
  Error message: Network or timeout errors.
  Resolution: Verify network connectivity between n8n and your HostBill server.

• Continue On Fail:
  If enabled, failed requests will return an error message in the output instead of stopping the workflow.

Links and References

• HostBill API Documentation
• n8n Documentation: Creating Workflows
• n8n Credentials Setup