Billwerk

Automate your subscription business with billwerk

Actions27

Accounting Export Actions
- Get Download Link
Contract Actions
Customer Actions
Invoice Actions
Metered Usage Actions
Order Actions
Payment Actions
Report Actions
- Get Download Link

Overview

The Billwerk node for n8n, when configured with the Invoice resource and the Get All operation, retrieves a list of invoices from the Billwerk platform. This operation is useful for automating tasks such as synchronizing invoice data with other systems, generating reports, or monitoring billing activity. For example, you might use this node to fetch all invoices for a specific customer within a date range, or to paginate through large sets of invoice records.

Properties

Name	Type	Meaning
Customer ID	String	Filters invoices by the specified customer’s unique identifier.
Search	String	Allows searching invoices by document number, or by the customer's last name, first name, or company name.
Date From	DateTime	Returns invoices created on or after this timestamp (optional).
Date To	DateTime	Returns invoices created on or before this timestamp (optional).
From	String	Pagination: The ID of the first invoice to return.
Take	Number	Pagination: Limits the number of returned items (maximum 500).

Output

The output is a JSON array where each element represents an invoice object retrieved from Billwerk. The structure of each invoice object typically includes fields such as invoice ID, customer details, amounts, dates, and status, depending on the Billwerk API response. No binary data is produced by this operation.

Dependencies

External Service: Requires access to the Billwerk API.
API Key/Credentials: You must configure the billwerkApi credentials in n8n for authentication.
n8n Configuration: Ensure that the Billwerk node is properly installed and that credentials are set up in your n8n instance.

Troubleshooting

Authentication Errors: If credentials are missing or incorrect, you may receive errors related to authentication. Double-check your billwerkApi credentials in n8n.
Invalid Property Values: Supplying invalid values (e.g., non-existent customer IDs, malformed dates) may result in API errors. Verify input formats and values.
Pagination Issues: If you request more than 500 items using the "Take" property, the API may reject the request or limit results. Always keep "Take" ≤ 500.
Error Handling: If an error occurs during execution and "Continue On Fail" is enabled, the node will output an object with an error field containing the error message.