Actions76
- Bill Actions
- Contact Actions
- Credit Note Actions
- Invoice Actions
- Item Actions
- Sales Order Actions
- Tax Actions
- Tax Group Actions
- Tax Exemption (US only) Actions
- Vendor Actions
- Vendor Credit Actions
Bill → Create
AI-generatedOverview
This node integrates with Zoho Books to create a new Bill record. It allows users to input bill data in multiple ways: via form fields, raw JSON, or a hybrid approach where the vendor is selected from a dropdown and the rest of the bill data is provided as JSON. This flexibility makes it suitable for various automation scenarios such as:
- Automatically creating bills from purchase data collected in other systems.
- Importing bulk bill data using JSON payloads.
- Combining manual selection of vendors with programmatic bill details.
Practical examples include automating accounts payable workflows by generating bills when purchase orders are approved or syncing bills from external procurement platforms.
Properties
| Name | Meaning |
|---|---|
| Input Method | How to provide bill data. Options: • Form Fields — Use structured form inputs below. • Raw JSON — Provide complete bill data as a JSON object. • Hybrid — Select vendor from dropdown, provide rest as JSON. |
| Vendor Name or ID | The vendor associated with this bill. Choose from a list loaded dynamically or specify an ID via expression. Required when using Form or Hybrid input methods. |
| Raw JSON Data | Complete bill data in JSON format. Used when Input Method is Raw JSON or Hybrid. Example structure includes date and line items with item IDs, quantities, and rates. |
| Line Items | A collection of one or more line items for the bill. Each item includes: • Item Name or ID (selectable) • Quantity (minimum 0.01) • Rate (decimal with two digits precision). Required when Input Method is Form. |
| Additional Fields | Optional extra fields for the bill when using Form input method: • Date (bill date) • Due Date • Reference Number • Notes |
Output
The node outputs the created Bill record as JSON. The output contains all the details returned by the Zoho Books API after successful creation, including identifiers, dates, line items, vendor info, and any additional metadata.
No binary data output is produced by this node.
Dependencies
- Requires an active Zoho Books API connection authenticated via OAuth2.
- The node depends on dynamic loading of options for vendors and items, which requires proper API access permissions.
- No additional environment variables beyond standard n8n credential setup are needed.
Troubleshooting
Common Issues:
- Failure to load vendor or item options usually indicates missing or invalid API credentials or insufficient permissions.
- Providing malformed JSON in the Raw JSON or Hybrid input methods will cause errors during API request.
- Missing required fields like vendor or line items will result in validation errors.
Error Messages:
"Unsupported resource": Occurs if the resource parameter is incorrect or not implemented; ensure "Bill" is selected.- API errors from Zoho Books (e.g., authentication failures, validation errors) will be surfaced with their messages. Check credentials and input data formatting.
Resolution Tips:
- Verify API credentials and scopes.
- Validate JSON syntax before input.
- Ensure required fields are populated according to the chosen input method.