@arathron/n8n-nodes-zoho-books
Advanced tools
n8n community nodes for Zoho Books and Zoho Inventory API integration - Complete CRUD operations for Sales Orders, Invoices, Items, Vendors, Credit Notes, Payments, Purchase Orders, Bills, Composite Items, Tax Management, Tax Groups, and Tax Exemptions
This is an n8n community node package that provides nodes for Zoho Books and Zoho Inventory in your n8n workflows.
Zoho Books is a cloud-based accounting software that helps you manage your finances, automate business workflows, and work collectively across departments.
Zoho Inventory is an inventory management software that helps you manage your stock, create assemblies, track inventory movements, and streamline order fulfillment.
n8n is a fair-code licensed workflow automation platform.
Follow the installation guide in the n8n community nodes documentation.
npm install n8n-nodes-zoho-books
n8n-nodes-zoho-books folder to your n8n custom nodes foldercd /path/to/n8n-custom-nodes/n8n-nodes-zoho-books
npm install
npm run build
These nodes use OAuth2 authentication to connect to Zoho Books and Zoho Inventory. Follow these steps to set up authentication:
https://your-n8n-instance.com/rest/oauth2-credential/callback
Screenshot: Zoho Books OAuth2 credential configuration in n8n
The Zoho Books node supports the following operations across different resources:
Manage sales orders in your Zoho Books account.
Operations:
Handle customer invoices and billing.
Operations:
Manage products and services.
Operations:
New Feature: The Get by SKU operation allows you to retrieve items using their SKU code instead of the item ID, making it easier to integrate with external systems that use SKU-based references.
Track customer payments.
Operations:
Manage vendor/supplier information.
Operations:
Handle credit notes for returns and adjustments.
Operations:
Configure and manage tax rates for your organization.
Operations:
Features:
Create and manage tax groups that combine multiple tax rates.
Operations:
Features:
Manage tax exemptions for customers (US edition only).
Operations:
Important Notes:
Edition Requirements:
{
"resource": "invoice",
"operation": "create",
"customerId": "{{$node.Customer.json.contact_id}}",
"lineItems": {
"item": [
{
"item_id": "{{$node.Item.json.item_id}}",
"quantity": 2,
"rate": 99.99
}
]
},
"additionalFields": {
"date": "2024-01-15",
"notes": "Thank you for your business!"
}
}
{
"resource": "salesOrder",
"operation": "getAll",
"returnAll": false,
"limit": 10,
"filters": {
"status": "open",
"fromDate": "2024-01-01"
}
}
{
"resource": "payment",
"operation": "create",
"customerId": "{{$node.Customer.json.contact_id}}",
"paymentMode": "creditcard",
"amount": 199.98,
"additionalFields": {
"date": "2024-01-15",
"referenceNumber": "PAY-2024-001"
}
}
{
"resource": "item",
"operation": "getBySku",
"skuCode": "LAPTOP-001"
}
This operation will return the complete item details including stock levels, pricing, and warehouse information based on the SKU code. This is particularly useful when:
Response example:
{
"item_id": "123456789",
"name": "Premium Laptop",
"sku": "LAPTOP-001",
"description": "High-performance laptop for professionals",
"rate": 1299.99,
"stock_on_hand": 25,
"available_stock": 23,
"status": "active",
"item_type": "inventory"
}
{
"resource": "tax",
"operation": "create",
"taxName": "Sales Tax",
"taxPercentage": 8.25,
"additionalFields": {
"is_compound": false,
"is_non_recoverable": false,
"tax_authority_name": "State Tax Authority"
}
}
This creates a new 8.25% sales tax that can be applied to invoices and line items.
{
"resource": "taxGroup",
"operation": "create",
"taxGroupName": "GST + PST",
"taxIds": ["123456789", "987654321"],
"additionalFields": {
"tax_authority_name": "Canada Revenue Agency"
}
}
This creates a tax group combining GST and PST taxes, commonly used for Canadian businesses.
{
"resource": "taxExemption",
"operation": "create",
"taxExemptionCode": "RESELLER",
"description": "Tax exempted because the contact is a reseller",
"type": "customer",
"additionalFields": {
"tax_exemption_percentage": 100
}
}
This creates a tax exemption for resellers (only works in US edition of Zoho Books).
{
"resource": "tax",
"operation": "getAll",
"returnAll": false,
"limit": 20,
"page": 1,
"perPage": 20
}
This retrieves the first 20 taxes with pagination controls for better performance on large datasets.
{
"resource": "tax",
"operation": "update",
"taxId": "123456789",
"updateFields": {
"tax_name": "Updated Sales Tax",
"tax_percentage": 8.75,
"is_compound": true
}
}
This updates an existing tax with a new rate and makes it compound.
Manage composite items (bundled products) in your Zoho Inventory account.
Operations:
Key Fields:
name: Name of the composite itemsku: Stock Keeping Unitrate: Selling pricelineItems: Component items and quantitiesCreate and manage assemblies for composite items.
Operations:
Key Fields:
compositeItemId: ID of the composite item to assemblequantity: Quantity to assembledate: Assembly datereferenceNumber: Reference for trackingManage inventory items in your Zoho Inventory account.
Operations:
Key Features:
Workflow: Automatically create invoices from confirmed sales orders
Workflow: Match bank transactions with customer payments
Workflow: Update item stock levels from external system
Workflow: Automate vendor bill creation from emails
Workflow: Generate monthly sales reports
Workflow: Synchronize inventory from external system using SKU codes
Benefits of SKU-based approach:
ZohoBooks.fullaccess.all scope| Error Code | Description | Solution |
|---|---|---|
| 1002 | Invalid data | Check field formats and required fields |
| 1001 | Resource not found | Verify the ID exists |
| 4000 | Rate limit exceeded | Wait and retry, node handles automatically |
| 1000 | Invalid Organization ID | Check credentials configuration |
| 400 | SKU code is required | Provide a valid, non-empty SKU code |
| 404 | Item with SKU not found | Verify the SKU code exists in your system |
| 409 | Multiple items with same SKU | Ensure SKU codes are unique |
| 500 | Invalid API response format | Contact support if this persists |
To enable detailed logging:
debugSee CHANGELOG.md for version history and updates.
See CONTRIBUTING.md for contribution guidelines.
FAQs
n8n community nodes for Zoho Books and Zoho Inventory API integration - Complete CRUD operations for Sales Orders, Invoices, Items, Vendors, Credit Notes, Vendor Credits with Bill Association, Payments, Purchase Orders, Bills, Composite Items, Tax Managem
The npm package @arathron/n8n-nodes-zoho-books receives a total of 1,041 weekly downloads. As such, @arathron/n8n-nodes-zoho-books popularity was classified as popular.
We found that @arathron/n8n-nodes-zoho-books demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
Malicious update to @ctrl/tinycolor on npm is part of a supply-chain attack hitting 40+ packages across maintainers
Security News
pnpm's new minimumReleaseAge setting delays package updates to prevent supply chain attacks, with other tools like Taze and NCU following suit.
Security News
The Rust Security Response WG is warning of phishing emails from rustfoundation.dev targeting crates.io users.