WhozInstall

Overview

This node integrates with the Whoz talent management platform, allowing users to perform various operations on different resources such as accounts, billing items, dossiers, talents, and tasks. Specifically for the Billing Item resource, it supports operations including creating, updating, deleting, validating, restoring, and retrieving multiple billing items.

The Restore operation for a Billing Item enables users to recover a previously deleted or archived billing item by specifying its unique ID. This is useful in scenarios where a billing item was removed accidentally or needs to be reactivated without recreating it from scratch.

Practical example:
A finance team uses this node to restore a billing item that was mistakenly deleted during data cleanup, ensuring continuity in billing records without manual re-entry.

Properties

Output

The output of the restore operation returns JSON data representing the restored billing item. The structure typically includes all relevant details of the billing item as stored in the Whoz platform after restoration.

• The output is a JSON array containing one or more objects corresponding to the restored billing items.
• Each object includes fields describing the billing item’s properties (e.g., ID, status, associated account, amounts).
• No binary data output is indicated for this operation.

Dependencies

• Requires an API key credential configured for authenticating with the Whoz platform.
• The node uses the Whoz API endpoint, which varies depending on the environment setting (sandbox or production).
• Proper network access to the Whoz API endpoints is necessary.

Troubleshooting

• Common issues:

  • Providing an invalid or non-existent Billing Item ID will likely result in an error from the API indicating the item cannot be found.
  • Network connectivity problems or incorrect API credentials can cause authentication failures.
  • Using the wrong environment setting may lead to unexpected results if the billing item exists only in one environment.

• Error messages:

  • Errors returned by the Whoz API are caught and handled, often providing descriptive messages about missing parameters or invalid IDs.
  • If the node throws an "Unknown billing item operation" error, verify that the operation name is correctly set to "restore".
  • For authorization errors, ensure the API key credential is valid and has appropriate permissions.

Links and References

• Whoz Platform Documentation (general reference for the API)
• n8n documentation on creating custom nodes (for further customization)

If you need details on other operations or resources, feel free to ask!