Zoho Books icon

Zoho Books

Consume Zoho Books API

Actions76

Vendor Credit → Get Many

AI-generated

Overview

This node operation retrieves multiple vendor credit records from Zoho Books. It is useful for scenarios where you need to list, filter, and analyze vendor credits in bulk rather than fetching them one by one. For example, you might want to generate reports on outstanding vendor credits, audit vendor transactions within a date range, or synchronize vendor credit data with another system.

Typical use cases include:

  • Fetching all vendor credits for a specific vendor or status.
  • Filtering vendor credits updated since a certain date.
  • Sorting vendor credits by date, total amount, or last modified time.
  • Paginating through large sets of vendor credits when not returning all at once.

Properties

Name Meaning
Return All Whether to return all matching vendor credit records or limit the number of results.
Limit Maximum number of vendor credit records to return (only applicable if "Return All" is false). Value must be between 1 and 200.
Filters Collection of filtering and sorting options:
  Status Filter vendor credits by their status. Options: Draft, Open, Closed, Void.
  From Date Only include vendor credits dated on or after this date (format YYYY-MM-DD).
  To Date Only include vendor credits dated on or before this date (format YYYY-MM-DD).
  Vendor Filter vendor credits by a specific vendor (selectable from a list loaded dynamically).
  Updated Since Only return vendor credits updated after this ISO-8601 timestamp.
  Search Text Search vendor credits containing this text, e.g., vendor credit number or vendor name.
  Sort By Field to sort the results by. Options: Date, Vendor Name, Total, Created Time, Last Modified.
  Sort Order Sort direction. Options: Ascending, Descending.
  Page Page number for pagination (only applies when "Return All" is false).
  Per Page Number of results per page (max 200, only applies when "Return All" is false).

Output

The output is an array of JSON objects representing vendor credit records retrieved from Zoho Books. Each item corresponds to one vendor credit and includes all its details as provided by the Zoho Books API.

  • The json field contains the vendor credit data such as ID, vendor info, date, status, total amount, and other relevant fields.
  • The output items are paired with the input item index they correspond to.
  • No binary data is output by this operation.

Dependencies

  • Requires an active connection to Zoho Books via an OAuth2 credential configured in n8n.
  • The node uses Zoho Books API endpoints to fetch vendor credit data.
  • Dynamic loading of vendor options requires API access to retrieve vendor lists.

Troubleshooting

  • Common issues:

    • Incorrect or expired API credentials will cause authentication errors.
    • Requesting too many records without pagination may hit API rate limits.
    • Invalid filter values (e.g., wrong date format) can cause API errors.
    • Selecting a vendor that does not exist or has no vendor credits will return empty results.

  • Error messages:

    • "Unsupported resource": This indicates the selected resource is not implemented; ensure "Vendor Credit" is chosen.
    • API errors related to invalid parameters or permissions will be returned from Zoho Books and surfaced by the node.

  • Resolutions:

    • Verify and refresh API credentials if authentication fails.
    • Use pagination or limit results to avoid rate limiting.
    • Double-check filter inputs for correct formats.
    • Confirm vendor IDs exist in your Zoho Books account.

Links and References

Discussion