Zoho Books icon

Zoho Books

Consume Zoho Books API

Actions76

Invoice → Update

AI-generated

Overview

This node updates an existing invoice in Zoho Books. It allows users to modify various invoice details such as the invoice date, number, tax treatment, due date, notes, and line items. This is useful for scenarios where invoice information needs correction or adjustment after creation, for example, updating payment terms, correcting item quantities, or adding notes.

Practical examples:

  • Correcting the invoice date or due date after it was initially set.
  • Changing the GST treatment or GST number for tax compliance.
  • Adding or modifying line items on the invoice to reflect changes in the billed products or services.
  • Providing a reason for update when modifying invoices that have already been sent.

Properties

Name Meaning
Invoice ID The unique identifier of the invoice to update (required).
Update Fields Collection of fields to update on the invoice:
- Date The date of the invoice (format YYYY-MM-DD).
- Invoice Number Custom invoice number.
- Place of Supply Location used for tax calculations.
- GST Treatment GST treatment type; options include Business – GST, Consumer, Overseas, SEZ – Without Tax, SEZ – With Tax, Unregistered.
- GST Number GSTIN number for the invoice.
- Due Date The due date for payment of the invoice.
- Reference Number Reference number associated with the invoice.
- Notes Additional notes related to the invoice.
- Terms Terms and conditions for the invoice.
- Reason for Update Explanation for why the invoice is being updated (mandatory if the invoice has been sent).
Line Items List of line items to update on the invoice. Each item includes:
- Item Name or ID Select from existing items or specify an ID.
- Quantity Quantity of the item (minimum 0.01).
- Rate Price rate per unit of the item (precision up to 2 decimals).

Output

The node outputs JSON data representing the updated invoice record returned by the Zoho Books API. Each output item corresponds to one input item processed and contains the updated invoice details.

If multiple invoices are updated in batch, the output will be an array of JSON objects, each paired with the corresponding input item index.

No binary data output is involved.

Dependencies

  • Requires an active connection to Zoho Books via an OAuth2 API credential configured in n8n.
  • The node depends on the Zoho Books API to perform the update operation.
  • The node dynamically imports the Invoice resource handler internally to execute the update.

Troubleshooting

  • Common issues:

    • Invalid or missing Invoice ID will cause the update to fail.
    • Providing invalid field values (e.g., incorrect date format) may result in API errors.
    • Attempting to update a sent invoice without providing a "Reason for Update" may be rejected by the API.
    • Network or authentication errors if the API credentials are expired or misconfigured.

  • Error messages:

    • "Unsupported resource: invoice": Indicates the resource is not implemented or incorrectly specified.
    • API error messages from Zoho Books will be passed through; check the message for details like validation failures.

  • Resolutions:

    • Ensure the Invoice ID is correct and exists in Zoho Books.
    • Validate all input fields conform to expected formats.
    • Provide a reason when updating sent invoices.
    • Verify API credentials and connectivity.

Links and References

Discussion