Zoho BooksInstall

Overview

This node integrates with Zoho Books to manage sales orders, specifically supporting the deletion of a sales order by its ID. It allows users to remove unwanted or obsolete sales orders from their Zoho Books account programmatically within an n8n workflow.

Common scenarios where this node is beneficial include:

• Automating cleanup of test or draft sales orders.
• Removing canceled or duplicate sales orders automatically.
• Integrating with other systems to synchronize and maintain accurate sales order records.

For example, after a sales order is fulfilled and invoiced in another system, you might use this node to delete the corresponding sales order in Zoho Books to keep data tidy.

Properties

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will be a confirmation object indicating success or failure of the deletion. If the operation fails and "Continue On Fail" is enabled, the output will contain an error message describing the issue.

No binary data output is produced by this operation.

Example output JSON structure (conceptual):

{
  "message": "Sales order deleted successfully",
  "salesOrderId": "123456789"
}

or on error:

{
  "error": "Sales order not found"
}

Dependencies

• Requires an active connection to Zoho Books via an OAuth2 API credential configured in n8n.
• The node depends on the Zoho Books API being accessible and the provided API credentials having permissions to delete sales orders.
• No additional external dependencies beyond the Zoho Books API and n8n's OAuth2 credential setup.

Troubleshooting

• Missing or invalid Sales Order ID: The node requires a valid sales order ID to perform deletion. Ensure the ID is correct and exists in Zoho Books.
• API authentication errors: If the OAuth2 token is expired or invalid, the node will fail. Refresh or reauthorize the credential.
• Permission denied: The API user must have rights to delete sales orders. Check Zoho Books user permissions.
• Sales order not found: Attempting to delete a non-existent sales order will return an error. Verify the ID before deletion.
• Rate limiting: Zoho Books API may throttle requests if too many are made in a short time. Implement retry logic or reduce request frequency.

If "Continue On Fail" is enabled, errors will be returned as part of the output JSON instead of stopping the workflow.

Links and References

• Zoho Books API Documentation - Sales Orders
• n8n OAuth2 Credential Setup
• n8n Expressions and Parameters