Zoho Inventory icon

Zoho Inventory

Consume Zoho Inventory API
Join our community

Actions14

Overview

The node integrates with Zoho Inventory to update a Composite Item. A Composite Item in Zoho Inventory is a product made up of multiple component items (line items). This node operation allows users to modify an existing composite item’s details such as its name, selling price, component items, and additional attributes.

This node is beneficial in inventory management workflows where composite products need to be maintained or adjusted dynamically, for example:

  • Updating the price or description of a bundled product.
  • Changing the quantities or components that make up a composite product.
  • Adjusting stock-related fields like reorder levels or initial stock values.

Practical example: An e-commerce business sells gift baskets composed of several individual products. When the basket contents or pricing changes, this node can update the composite item record in Zoho Inventory accordingly.

Properties

Name Meaning
Composite Item ID The unique identifier of the composite item to update.
Name The new or updated name of the composite item.
Rate The selling price of the composite item, with two decimal precision.
Line Items A collection of component items making up the composite item. Each line item includes:
- Item ID: Identifier of the component item.
- Quantity: Number of units of the component item included in the composite item (3 decimals).
Additional Fields Optional extra fields to update on the composite item:
- Description: Text description of the composite item.
- Purchase Rate: Cost price of the composite item (2 decimals).
- Reorder Level: Stock level at which reordering should occur.
- Initial Stock: Starting stock quantity.
- Initial Stock Rate: Cost rate per unit of the initial stock (2 decimals).

Output

The output JSON contains the updated composite item object returned from Zoho Inventory after the update operation. It reflects all current properties of the composite item including its ID, name, SKU, rate, mapped component items, and any additional fields.

Example structure of the output JSON field:

{
  "composite_item": {
    "composite_item_id": "string",
    "name": "string",
    "sku": "string",
    "rate": number,
    "mapped_items": [
      {
        "item_id": "string",
        "quantity": number
      }
    ],
    "description": "string",
    "purchase_rate": number,
    "reorder_level": number,
    "initial_stock": number,
    "initial_stock_rate": number
  }
}

No binary data output is produced by this operation.

Dependencies

  • Requires valid Zoho Inventory OAuth2 credentials configured in n8n.
  • The credentials must include a valid Organization ID.
  • The node communicates with the Zoho Inventory API endpoint corresponding to the configured data center region.
  • Network access to Zoho Inventory API endpoints is required.

Troubleshooting

  • Missing Credentials or Organization ID: If OAuth2 credentials or organization ID are not set, the node will throw errors indicating missing configuration. Ensure credentials are properly configured in n8n settings.
  • Invalid Composite Item ID: Providing a non-existent or incorrect composite item ID will cause API errors. Verify the ID before updating.
  • API Errors: Any error response from Zoho Inventory API (e.g., validation errors, permission issues) will be surfaced. Review the error message for details.
  • Line Items Format: Ensure each line item has a valid item ID and quantity; otherwise, the API may reject the request.
  • Rate and Numeric Fields: Numeric fields like rate, purchase rate, reorder level, etc., should be within acceptable ranges and formatted correctly.

Links and References

Discussion