Billwerk icon

Billwerk

Automate your subscription business with billwerk

Actions27

Overview

This node provides integration with the Billwerk platform, specifically for the "Report" resource and the "Get Download Link" operation. It allows users to retrieve a download link for a specific report by providing its Report ID. This is useful in scenarios where automated workflows need to fetch reports generated in Billwerk for further processing, sharing, or archival.

Practical examples:

  • Automatically downloading financial or subscription reports from Billwerk and storing them in cloud storage.
  • Triggering downstream processes (e.g., data analysis, emailing reports) once a new report is available.

Properties

Name Type Meaning
Report ID String The unique identifier of the report for which you want to obtain the download link.

Output

The output will be a JSON object containing the download link for the specified report. The exact structure may vary depending on the Billwerk API, but typically includes at least a URL field such as:

{
  "downloadLink": "https://api.billwerk.com/reports/12345/download"
}

If an error occurs and "Continue On Fail" is enabled, the output will include 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.
  • Environment: No special environment variables are required beyond standard n8n setup.

Troubleshooting

  • Invalid Report ID: If the provided Report ID does not exist or is incorrect, the node may return an error such as "Report not found" or a similar message from the Billwerk API.
    • Resolution: Double-check the Report ID for typos or ensure the report exists in Billwerk.
  • Authentication Errors: If credentials are missing or invalid, errors like "Unauthorized" or "Invalid API key" may occur.
    • Resolution: Ensure that the billwerkApi credential is correctly set up in n8n.
  • Network Issues: Timeouts or connectivity problems can result in errors like "Network Error" or "Request Timed Out".
    • Resolution: Check your network connection and Billwerk service status.

Links and References

Discussion