Zoho Books icon

Zoho Books

Consume Zoho Books API

Actions76

Vendor Credit → Create

AI-generated

Overview

This node operation creates a Vendor Credit record in Zoho Books. Vendor Credits are used to record credit notes received from vendors, which can be applied against bills to reduce the amount payable. This node supports multiple input methods for flexibility: using form fields, raw JSON data, or a hybrid approach combining both.

Common scenarios where this node is beneficial include:

  • Automating vendor credit creation when receiving credit notes or refunds from suppliers.
  • Applying vendor credits automatically to specific bills to manage accounts payable efficiently.
  • Integrating with other systems that provide vendor credit data either as structured forms or JSON payloads.

Practical example:

  • A company receives a credit note from a vendor for returned goods. Using this node, the credit can be created in Zoho Books and optionally applied to an outstanding bill, reducing the payable balance automatically.

Properties

Name Meaning
Input Method How to provide vendor credit data. Options:
• Form Fields — Use individual form inputs.
• Raw JSON — Provide complete vendor credit data as JSON.
• Hybrid — Select vendor via dropdown, provide rest as JSON.
Raw JSON Data Complete vendor credit data in JSON format. Required if input method is Raw JSON or Hybrid. Must include valid fields like vendor_id and line_items. Rate values must be non-negative.
Vendor Name or ID The vendor associated with this vendor credit. Choose from a dropdown list or specify an ID via expression. Required if input method is Form or Hybrid.
Vendor Credit Date Document date of the vendor credit (format YYYY-MM-DD). Defaults to current date if omitted.
Vendor Credit Number Custom vendor credit number. Leave blank to let Zoho auto-generate it.
Associated Bill Number or ID The bill to associate this vendor credit with. Used only in Hybrid input method. Can be selected from a list or specified by ID.
Associate to Bill After Create Boolean flag (true/false) indicating whether to apply the vendor credit to the selected bill after creation. Only relevant in Hybrid input method.
Apply Amount Amount to apply to the associated bill. If zero, applies the full vendor credit amount. Relevant only if "Associate to Bill After Create" is enabled.
Debug HTTP Include sanitized request payload and Zoho error details in logs/output for debugging purposes.
Line Items Collection of line items for the vendor credit. Each item can be of type "Item" (product/service) or "Account" (account-based line). Includes fields like item/account ID, quantity, rate, amount, tax ID, and description. Required if input method is Form.
Additional Fields Optional additional fields such as reference number, notes, terms, currency, exchange rate, discount (amount or percentage), discount type (entity or item level), whether discount applies before tax, tax exemption, adjustment amount and description.

Output

The node outputs the created vendor credit record as JSON. The output includes all details returned by Zoho Books API about the newly created vendor credit, such as its ID, vendor info, line items, amounts, dates, and any applied bills.

If the "Debug HTTP" option is enabled, the output may also include sanitized HTTP request payloads and detailed error information from Zoho for troubleshooting.

This node does not output binary data.

Dependencies

  • Requires an active Zoho Books account with appropriate permissions to create vendor credits.
  • Requires an API authentication credential configured in n8n for Zoho Books OAuth2.
  • Uses Zoho Books REST API endpoints for vendor credit creation and optional bill association.
  • Some properties load options dynamically from Zoho Books (e.g., vendors, bills, items, accounts, taxes, currencies).

Troubleshooting

  • Invalid or missing vendor ID: Ensure the vendor exists in Zoho Books and the correct ID or name is provided.
  • Line item validation errors: Rates must be non-negative; quantities must be positive; amounts for account lines must be greater than zero.
  • JSON syntax errors: When using Raw JSON or Hybrid input methods, ensure the JSON is well-formed and matches Zoho Books API schema.
  • Bill association failures: If associating vendor credit to a bill after creation, verify the bill ID is valid and the apply amount does not exceed the vendor credit amount.
  • API rate limits: Zoho Books enforces rate limits; excessive requests may cause errors. Use retry logic or reduce request frequency.
  • Authentication errors: Check that the OAuth2 credentials are valid and have not expired.
  • Enabling "Debug HTTP" helps reveal request payloads and detailed API error messages for diagnosis.

Links and References

Discussion