Billwerk icon

Billwerk

Automate your subscription business with billwerk

Actions27

Overview

The Billwerk node for n8n allows you to automate tasks related to subscription business management using the Billwerk API.
For the Invoice → Get operation, this node retrieves detailed information about a specific invoice by its ID.
This is useful in scenarios where you need to fetch invoice details for reporting, reconciliation, or integration with other systems (e.g., sending invoice data to accounting software or displaying it in dashboards).

Example use cases:

  • Retrieve an invoice's status and amount after a customer purchase.
  • Fetch invoice details to send a payment reminder.
  • Integrate invoice data into custom reports or analytics workflows.

Properties

Name Type Meaning
Invoice ID String The unique identifier of the invoice you want to retrieve from Billwerk.

Output

The output will be a JSON object containing the details of the requested invoice.
While the exact structure depends on the Billwerk API response, typical fields may include:

{
  "id": "string",
  "number": "string",
  "status": "string",
  "date": "string",
  "customerId": "string",
  "amount": "number",
  "currency": "string",
  // ...other invoice-specific fields
}
  • If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message.

Dependencies

  • External Service: Requires access to the Billwerk API.
  • Credentials: You must configure the billwerkApi credential in n8n for authentication.

Troubleshooting

Common Issues:

  • Invalid Invoice ID: If the provided Invoice ID does not exist, the node will return an error message such as "Invoice not found".
  • Authentication Errors: If credentials are missing or incorrect, you may see errors like "401 Unauthorized" or "Invalid API key".
  • Network Issues: Connectivity problems can result in timeout or network-related error messages.

How to resolve:

  • Double-check the Invoice ID for typos or correctness.
  • Ensure your Billwerk API credentials are set up correctly in n8n.
  • Verify network connectivity between n8n and the Billwerk API endpoint.

Links and References

Discussion