Actions25
Overview
The node operation "Update" for the "Billing Item" resource allows users to modify existing billing items in the Whoz talent management platform. This operation is useful when you need to correct, enhance, or add additional information to a billing item after its creation. For example, you might update the description, associate it with a different task, adjust financial details like amount or currency, or add external references such as purchase orders.
Practical scenarios include:
- Correcting an incorrect billing amount or currency.
- Adding a purchase order number after the initial billing item was created.
- Linking the billing item to a specific task or updating that association.
- Updating descriptive fields to provide more context for accounting or auditing purposes.
Properties
| Name | Meaning |
|---|---|
| Billing Item ID | The unique identifier of the billing item to update. This is required to specify which billing item will be modified. |
| Additional Fields | A collection of optional fields to update on the billing item: - External ID: Identifier from an external system. - Description: Textual description of the billing item. - Task ID: ID of the associated task. - Task External ID: External ID of the associated task. - Purchase Order: Purchase order number. - Purchase Invoice: Purchase invoice number. - Reference: Reference identifier. |
| Financial Details | A collection of financial-related fields to update: - Amount Value: Total monetary amount. - Amount Currency: Currency code for the amount (EUR, USD, GBP, CHF, CAD). - Quantity: Number of units. - Unit Cost Value: Cost per unit. - Unit Cost Currency: Currency code for unit cost (EUR, USD, GBP, CHF, CAD). - Unit Rate Value: Rate per unit. - Unit Rate Currency: Currency code for unit rate (EUR, USD, GBP, CHF, CAD). |
Output
The output JSON contains the updated billing item data returned from the Whoz API after the update operation. It typically includes all the fields of the billing item, reflecting the new values after modification. The structure corresponds to the billing item object schema used by the Whoz platform.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Whoz talent management platform via an authenticated API credential (e.g., OAuth2 token).
- The node uses the Whoz API endpoint, which varies depending on environment configuration (sandbox or production).
- Proper API permissions are necessary to perform update operations on billing items.
Troubleshooting
- Missing Billing Item ID: The operation requires the billing item ID to identify which item to update. Omitting this will cause an error.
- Invalid Field Values: Providing invalid currency codes or negative amounts may result in API errors.
- API Authentication Errors: If the API credentials are missing, expired, or invalid, the request will fail with authentication errors.
- Network Issues: Connectivity problems can cause timeouts or failed requests.
- Permission Denied: Insufficient permissions on the API key or user role may prevent updates.
To resolve these issues:
- Ensure the billing item ID is correctly provided.
- Validate all input fields for correctness and completeness.
- Verify API credentials and refresh tokens if needed.
- Check network connectivity.
- Confirm that the API user has appropriate permissions.
Links and References
- Whoz API Documentation (general reference for API endpoints and data models)
- n8n Documentation on Creating Custom Nodes