Zoho Books icon

Zoho Books

Consume Zoho Books API

Actions76

Item → Update

AI-generated

Overview

This node operation updates an existing item record in Zoho Books. It allows users to modify various attributes of an item such as its name, description, SKU, pricing, tax details, product type, status, unit of measurement, reorder level, and stock information.

Common scenarios where this node is beneficial include:

  • Updating product details after a price change or rebranding.
  • Adjusting inventory-related fields like reorder levels or initial stock.
  • Changing tax settings for items due to regulatory updates.
  • Activating or deactivating items in the catalog.

Practical example: A retailer wants to update the selling price and description of a laptop item in their Zoho Books inventory. Using this node, they specify the item ID and provide new values for the "Rate" and "Description" fields to keep their records current.

Properties

Name Meaning
Item ID The unique identifier of the item to update (required).
Update Fields Collection of fields to update on the item. Includes:
- Name New name of the item.
- Description Updated description text for the item.
- SKU Updated Stock Keeping Unit code.
- Rate Updated selling price of the item (number with two decimal precision).
- Purchase Rate Updated purchase price of the item (number with two decimal precision).
- Tax ID Updated tax associated with the item (selectable from available taxes).
- Tax Exemption ID Updated tax exemption associated with the item (US edition only).
- Product Type Whether the item is a physical good or a service. Options: "Goods", "Service".
- Status Status of the item. Options: "Active", "Inactive".
- Unit Unit of measurement for the item (e.g., Piece, Box, Kg).
- Reorder Level Minimum quantity that should be maintained (non-negative number).

Output

The output is a JSON object representing the updated item record returned by the Zoho Books API. This typically includes all the item's properties after the update, such as its ID, name, description, SKU, rates, tax info, status, and other metadata.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to Zoho Books via an OAuth2 API credential.
  • The node depends on Zoho Books API endpoints for item management.
  • Proper permissions in Zoho Books are necessary to update item records.
  • The node uses internal helper functions and resource classes to interact with the API.

Troubleshooting

  • Common issues:

    • Invalid or missing Item ID will cause the update to fail.
    • Providing invalid field values (e.g., negative reorder level) may result in API errors.
    • Insufficient permissions or expired credentials can cause authentication failures.
    • Network or API rate limiting issues may interrupt the update process.

  • Error messages:

    • "Unsupported resource: item": Occurs if the resource parameter is incorrect; ensure "Item" is selected.
    • API error messages related to validation will indicate which field caused the problem.
    • Authentication errors suggest checking the API key or OAuth token validity.

  • Resolutions:

    • Verify the Item ID exists in Zoho Books before updating.
    • Validate input fields conform to expected types and constraints.
    • Refresh or reconfigure API credentials if authentication fails.
    • Implement retry logic or respect rate limits if encountering throttling.

Links and References

Discussion