Zoho Books icon

Zoho Books

Consume Zoho Books API

Actions76

Item → Get Many

AI-generated

Overview

This node interacts with the Zoho Books API to retrieve multiple item records ("Get Many" operation on the "Item" resource). It is designed to fetch a list of items from a Zoho Books account, supporting pagination and limiting the number of results returned. This functionality is useful for workflows that need to process or analyze inventory data, synchronize item lists with other systems, or generate reports based on product information.

For example, you might use this node to:

  • Retrieve all items in your inventory to update a product catalog.
  • Fetch a limited page of items to display in a dashboard.
  • Integrate item data into an ERP or accounting system.

Properties

Name Meaning
Return All Whether to return all item records or only up to a specified limit.
Page The page number to retrieve when not returning all results (used for pagination).
Per Page Number of items to return per page (maximum 200), applicable when not returning all.

Output

The output consists of an array of JSON objects, each representing an individual item record retrieved from Zoho Books. Each object contains the item's data fields as provided by the Zoho Books API.

If multiple items are returned, each item is output as a separate element in the output array, paired with the corresponding input item index.

No binary data output is produced by this operation.

Dependencies

  • Requires an active Zoho Books API authentication credential (OAuth2).
  • The node dynamically imports the Item resource handler internally to perform API requests.
  • No additional environment variables are explicitly required beyond the configured API credentials.

Troubleshooting

  • Common issues:

    • Pagination parameters (Page and Per Page) must be valid numbers; invalid values may cause errors or unexpected results.
    • If Return All is false but the limit is set too high, the API may reject the request or truncate results.
    • Network or authentication failures will result in errors; ensure the API key or OAuth token is valid and has sufficient permissions.

  • Error messages:

    • "Unsupported resource: item": Indicates the resource is not implemented or incorrectly specified; verify the resource name.
    • API rate limit errors may occur if too many requests are made in a short time; consider adding delays or handling retries.
    • Errors related to invalid pagination parameters or limits should be resolved by adjusting the input properties accordingly.

Links and References

Discussion