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
Sales Order → Update
AI-generatedOverview
The "Sales Order Update" operation in this node allows users to update existing sales orders in Zoho Books. This is useful for modifying details such as customer information, order date, line items, discounts, shipping charges, and status of a sales order after it has been created. Typical scenarios include correcting order details, adding or removing items, adjusting pricing, or changing the order status (e.g., from draft to confirmed).
For example, a user might update a sales order to add additional products requested by a customer or to apply a discount after negotiation.
Properties
| Name | Meaning |
|---|---|
| Sales Order ID | The unique identifier of the sales order to update. Required to specify which sales order to modify. |
| Input Method | How to provide the sales order data for the update: - Form: Use structured form fields. - JSON: Provide complete sales order data as raw JSON. - Hybrid: Choose customer from dropdown and provide rest as JSON. |
| Customer | The customer associated with the sales order. Select from a list or specify an ID via expression. Required when using Form or Hybrid input methods. |
| Sales Order Date | The document date of the sales order in YYYY-MM-DD format. Defaults to today if omitted. |
| Sales Order Number | The sales order number. Leave blank to let Zoho auto-generate the number. |
| Line Items | List of items included in the sales order. Each item includes: - Item Name or ID (selectable) - Quantity (minimum 0.01) - Rate (price per unit) |
| Raw JSON Data | Complete sales order data in JSON format. Used when Input Method is JSON or Hybrid. |
| Rate Includes Tax | Boolean indicating whether the item rates include tax. Defaults to false. |
| Additional Fields | Optional extra fields for the sales order: - Reference Number - Notes - Terms and Conditions - Discount amount - Discount Type (Entity Level or Item Level) - Shipping Charge - Adjustment |
| Update Fields | Fields specifically for updating: - Sales Order Number - Date - Status (Draft, Open, Confirmed, Closed) |
Output
The node outputs the updated sales order data as JSON. The output contains the full representation of the sales order after the update, including all modified fields and any system-generated values like IDs or timestamps.
If multiple input items are processed, the output is an array of updated sales orders, each paired with the corresponding input item index.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to Zoho Books API authenticated via OAuth2.
- The node depends on Zoho Books API credentials configured in n8n.
- Uses internal helper functions to load options dynamically for customers and items.
- No additional external services beyond Zoho Books API are required.
Troubleshooting
- Missing Sales Order ID: The update operation requires a valid sales order ID. Ensure this is provided; otherwise, the API will return an error.
- Invalid JSON Data: When using JSON or Hybrid input methods, malformed JSON will cause failures. Validate JSON syntax before running.
- Unauthorized / Authentication Errors: If the OAuth2 token is expired or invalid, authentication errors will occur. Refresh or reconfigure credentials.
- Unsupported Resource or Operation: Attempting to use unsupported resources or operations will throw errors indicating the resource is not implemented.
- Rate Limit Exceeded: Zoho Books API enforces rate limits. If exceeded, requests may fail temporarily. Implement retry logic or reduce request frequency.
- Validation Errors: Providing invalid field values (e.g., negative quantity, invalid dates) will result in API validation errors. Check field constraints carefully.