Zoho Books icon

Zoho Books

Consume Zoho Books API

Actions76

Credit Note → Create

AI-generated

Overview

This node operation creates a new Credit Note in Zoho Books. It allows users to generate credit notes for customers, which are useful for recording refunds, returns, or adjustments against invoices. This is beneficial in scenarios such as issuing a refund for returned goods, correcting billing errors, or applying discounts after invoicing.

Users can provide credit note data in three ways:

  • Form Fields: Fill out structured fields like customer, date, line items, and additional optional details.
  • Raw JSON: Provide the entire credit note data as a JSON object.
  • Hybrid: Select the customer from a dropdown and provide the rest of the credit note data as raw JSON.

Practical examples include:

  • Creating a credit note for a customer who returned some items, specifying each returned item with quantity and rate.
  • Quickly generating a credit note by pasting complete JSON data when integrating with other systems.
  • Combining dropdown selection for customer with custom JSON for complex credit note details.

Properties

Name Meaning
Input Method How to provide credit note data:
- Form Fields: Use structured form inputs.
- Raw JSON: Provide full credit note data as JSON.
- Hybrid: Choose customer from dropdown, provide rest as JSON.
Raw JSON Data Complete credit note data in JSON format. Example: { "customer_id": "123", "line_items": [{"item_id":"456","quantity":1,"rate":100}] }. Required if input method is Raw JSON or Hybrid.
Customer Name or ID The customer for this credit note. Choose from a list or specify an ID using an expression. Required if input method is Form or Hybrid.
Credit Note Date Document date (YYYY-MM-DD). Defaults to today if omitted. Applicable for Form or Hybrid input methods.
Credit Note Number Credit note number. Leave blank to let Zoho auto-number. Applicable for Form or Hybrid input methods.
Line Items One or more line items for the credit note. Each item includes:
• Item Name or ID (selectable)
• Quantity (minimum 0.01)
• Rate (decimal with 2 precision)
• Tax ID (tax rate to apply)
Required for Form input method.
Additional Fields Optional extra fields:
• Reference Number
• Notes
• Terms and conditions
• Discount amount or percentage
• Discount Type (Entity Level or Item Level)
• Exchange Rate (for multi-currency)

Output

The node outputs the created credit note data as JSON. The output structure corresponds to the response from Zoho Books API for a credit note creation, typically including fields such as credit note ID, customer details, line items, totals, dates, and status.

No binary data output is involved.

Dependencies

  • Requires an active connection to Zoho Books via OAuth2 credentials configured in n8n.
  • Uses Zoho Books API endpoints for credit note creation.
  • Dynamic loading of options (e.g., customers, items, taxes) depends on API access and proper credential setup.

Troubleshooting

  • Common Issues:

    • Missing required fields such as customer or line items will cause errors.
    • Invalid JSON format when using Raw JSON or Hybrid input methods.
    • API authentication failures due to expired or misconfigured OAuth2 credentials.
    • Selecting non-existent customer or item IDs may result in API errors.

  • Error Messages:

    • "Unsupported resource: creditNote": Indicates the resource is not implemented or incorrectly specified; ensure the resource parameter is set correctly.
    • API errors related to validation (e.g., missing fields) will be returned from Zoho Books and surfaced by the node.
    • Network or authentication errors should be resolved by checking credentials and connectivity.

  • Resolution Tips:

    • Validate JSON syntax before submission.
    • Ensure all required fields are provided according to the chosen input method.
    • Refresh or reconfigure OAuth2 credentials if authentication fails.
    • Use expressions carefully to reference dynamic values for IDs.

Links and References

Discussion