Zoho BooksInstall

Overview

This node interacts with the Zoho Books API to retrieve details of a Sales Order. It supports fetching a sales order either by its unique ID or by its sales order number. This functionality is useful in scenarios where you need to integrate Zoho Books sales order data into workflows, such as automating order processing, syncing sales orders with other systems, or generating reports based on specific sales orders.

For example, you might use this node to:

• Retrieve a sales order by its ID after receiving an order confirmation.
• Fetch a sales order by its number (e.g., "SO-00001") to verify order details before shipping.
• Automate follow-up actions based on sales order status or contents.

Properties

Output

The output contains the JSON representation of the retrieved sales order record from Zoho Books. Each item corresponds to one sales order and includes all relevant fields returned by the Zoho Books API for that sales order.

• The json field holds the sales order data object.
• There is no binary data output for this operation.

Dependencies

• Requires an active connection to Zoho Books via an OAuth2 API authentication credential.
• The node dynamically loads the Sales Order resource handler internally to perform the API request.
• No additional environment variables are explicitly required beyond the configured API credentials.

Troubleshooting

• Common issues:

  • Providing an invalid or empty Sales Order ID or Number will result in an error or no data found.
  • Using the wrong search type (e.g., selecting "By Number" but providing an ID) may cause the node to fail.
  • API rate limits from Zoho Books could cause temporary failures; ensure proper handling or retries.

• Error messages:

  • "Unsupported resource: salesOrder": Indicates the resource is not implemented or incorrectly specified (unlikely here since salesOrder is supported).
  • Errors related to missing required parameters (Sales Order ID or Number) depending on the selected search type.
  • Network or authentication errors if the API key or OAuth token is invalid or expired.

To resolve these:

• Double-check the input parameters match the selected search type.
• Verify API credentials are valid and have necessary permissions.
• Handle errors gracefully using the node's "Continue On Fail" option if needed.

Links and References

• Zoho Books API Documentation - Sales Orders
• n8n Documentation - Expressions
• Zoho Books Official Site