Zoho Books icon

Zoho Books

Consume Zoho Books API

Actions76

Sales Order → Create

AI-generated

Overview

This node facilitates the creation of Sales Orders in Zoho Books via three input methods: form fields, raw JSON, or a hybrid approach. It is useful for automating sales order entry workflows, integrating with other systems that generate sales data, or bulk-creating orders from structured data.

Typical scenarios include:

  • Creating sales orders from user input forms where line items and customer details are selected.
  • Importing or syncing sales orders from external databases or applications using raw JSON data.
  • Combining dropdown selection of customers with custom JSON payloads for flexible order creation.

For example, a business could use this node to automatically create sales orders when a new purchase request is received, either by filling out form fields or by passing complete JSON data from an ERP system.

Properties

Name Meaning
Input Method How to provide sales order data:
- Form Fields: Use individual form inputs.
- Raw JSON: Provide complete sales order data as JSON.
- Hybrid: Select customer from dropdown, provide rest as JSON.
Rates Include Tax Boolean indicating if line-item rates are tax-inclusive (gross). If true, tax will be calculated and deducted automatically.
Raw JSON Data Complete sales order data in JSON format. Required if Input Method is "Raw JSON" or "Hybrid". Schema must follow Zoho Books sales order structure.
Customer Name or ID The customer for the sales order. Choose from a dropdown list or specify an ID via expression. Required for "Form Fields" and "Hybrid" input methods.
Sales Order Date Document date in YYYY-MM-DD format. Defaults to current date if omitted.
Sales Order Number Custom sales order number. Leave blank to let Zoho auto-generate the number.
Line Items Collection of line items for the order. Each item includes:
- Item Name or ID (selectable from list or via expression)
- Quantity (minimum 0.01)
- Rate (price per unit, two decimal precision). Required for "Form Fields".
Additional Fields Optional extra fields such as:
- Reference Number
- Notes
- Terms and Conditions
- Discount amount and type (entity or item level)
- Shipping Charge
- Adjustment amount

Output

The node outputs the created sales order data as JSON in the json field of the output item. This typically includes all details of the newly created sales order as returned by the Zoho Books API, such as the sales order ID, customer info, line items, totals, dates, and status.

No binary data output is produced by this node.

Dependencies

  • Requires an active Zoho Books API authentication credential configured in n8n.
  • Uses Zoho Books API endpoints to create sales orders.
  • For dropdown options like customers and items, it dynamically loads these lists from Zoho Books via API calls.
  • No additional external services beyond Zoho Books API are required.

Troubleshooting

  • Common Issues:

    • Missing required fields such as customer or line items when using form input method.
    • Invalid JSON schema or malformed JSON when using raw JSON input.
    • Incorrect item IDs or customer IDs causing API errors.
    • Network or authentication failures with Zoho Books API.

  • Error Messages:

    • "Unsupported resource": Indicates the resource parameter is incorrect or not implemented.
    • API errors from Zoho Books may include validation errors on fields; ensure all required fields are provided and correctly formatted.
    • Authentication errors suggest invalid or expired API credentials; re-authenticate the Zoho Books connection.

  • Resolutions:

    • Validate all required properties before execution.
    • Use expressions carefully to ensure valid IDs.
    • Check API limits and retry if rate-limited.
    • Review Zoho Books API documentation for correct JSON schema when using raw JSON input.

Links and References

Discussion