Billwerk

Overview

The Billwerk node for n8n automates operations related to subscription business management using the Billwerk platform. Specifically, when configured with the Resource: Contract and Operation: Annul, this node annuls (cancels or voids) a contract in your Billwerk account based on a provided Contract ID.

Common scenarios:

• Automatically voiding contracts that are no longer valid.
• Integrating contract annulment into automated customer offboarding workflows.
• Ensuring compliance by programmatically annulling contracts under certain conditions.

Practical example:
When a customer requests cancellation and meets specific criteria, you can use this node to automatically annul their contract in Billwerk as part of an n8n workflow.

Properties

Output

• The output is a JSON object (or array of objects) representing the result of the annul operation.
• If the operation succeeds, the output will typically include details about the annulled contract (such as its status and ID).
• If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message.

Example output:

[
  {
    "id": "12345",
    "status": "annulled",
    // ...other contract fields
  }
]

Or, in case of error:

[
  {
    "error": "Contract not found"
  }
]

Dependencies

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

Troubleshooting

• Missing or Invalid Contract ID:
  • Error: "Contract not found" or similar.
    Solution: Ensure the "Contract ID" property is set correctly and refers to an existing contract in Billwerk.
• Authentication Errors:
  • Error: "Invalid API key" or "Unauthorized"
    Solution: Check that the billwerkApi credentials are correctly configured in n8n.
• API Rate Limits or Connectivity Issues:
  • Error: Network-related messages or timeouts.
    Solution: Verify network connectivity and consult Billwerk's API documentation for rate limits.

Links and References

• Billwerk API Documentation
• n8n Documentation: Custom Nodes