Billwerk

Overview

This node integrates with the Billwerk platform to automate subscription business processes. Specifically, for the Invoice resource and the Get Download Link operation, the node retrieves a direct download link for a specified invoice. This is useful in scenarios where you need to programmatically access or distribute invoice documents, such as sending invoices to customers, archiving them, or integrating with other systems for financial processing.

Practical examples:

• Automatically fetching invoice download links after a sale for record-keeping.
• Sending invoice download links to customers via email.
• Integrating with document management systems to store invoice PDFs.

Properties

Output

The output will be a JSON object (or array of objects if multiple items are processed) containing the result of the "Get Download Link" operation for the specified invoice. While the exact structure depends on the Billwerk API response, it typically includes:

• A field containing the download URL for the invoice.
• Possibly additional metadata about the invoice.

Example output structure:

{
  "downloadLink": "https://api.billwerk.com/invoices/12345/download",
  "invoiceId": "12345"
}

Note: The actual field names may vary depending on the Billwerk API.

Dependencies

• External Service: Requires access to the Billwerk API.
• Credentials: Needs a configured billwerkApi credential in n8n.
• Environment: No special environment variables required beyond standard n8n setup.

Troubleshooting

• Invalid Invoice ID: If an incorrect or non-existent Invoice ID is provided, the node may return an error such as Invoice not found. Ensure the Invoice ID exists in your Billwerk account.
• Authentication Errors: If credentials are missing or invalid, errors like Unauthorized or Invalid API Key may occur. Check your n8n credentials configuration.
• API Rate Limits: Excessive requests may trigger rate limiting from Billwerk. In this case, try reducing the frequency of requests.

Links and References

• Billwerk API Documentation
• n8n Documentation: Credentials
• n8n Documentation: Custom Nodes