Zoho Books icon

Zoho Books

Consume Zoho Books API

Vendor → Update

AI-generated

Overview

This node integrates with the Zoho Books API to update vendor records. Specifically, the "Vendor" resource with the "Update" operation allows users to modify details of an existing vendor by specifying the vendor's unique ID and providing updated contact information. This is useful in scenarios where vendor details such as company name, contact email, phone number, or addresses need to be kept current in Zoho Books.

Practical examples include:

  • Updating a vendor’s billing or shipping address after relocation.
  • Correcting or adding missing contact information like phone or email.
  • Changing the currency code or opening balance associated with a vendor.

Properties

Name Meaning
Contact ID The unique identifier of the vendor to update.
Contact Data A collection of fields to update for the vendor, including:
- Contact Name: The vendor's contact person name (e.g., "ABC Supplies Inc.")
- Company Name: The vendor's company name
- Email: Vendor's email address
- Phone: Vendor's phone number
- Website: Vendor's website URL
- Currency Code: The currency used by the vendor. Options: USD, EUR, GBP, CAD, AUD, INR
- Opening Balance: The vendor's opening balance (number with two decimal precision)
- Billing Address: Collection of address fields (Address, City, State, ZIP Code, Country)
- Shipping Address: Collection of address fields (Address, City, State, ZIP Code, Country)

Output

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

No binary data output is involved.

Dependencies

  • Requires an active connection to Zoho Books via an OAuth2 credential configured in n8n.
  • The node dynamically imports the Vendor resource handler from the bundled resources to perform the update operation.
  • No additional external dependencies beyond the Zoho Books API and proper authentication.

Troubleshooting

  • Common issues:

    • Invalid or missing Contact ID will cause the update to fail.
    • Providing invalid field values (e.g., unsupported currency codes or malformed email) may result in API errors.
    • Network or authentication failures can prevent successful updates.
  • Error messages:

    • "Unsupported resource: vendor": Indicates the resource is not recognized; ensure the resource parameter is correctly set.
    • API error messages from Zoho Books will be passed through; check the message for details such as validation errors or permission issues.
  • Resolutions:

    • Verify that the Contact ID exists in Zoho Books before attempting an update.
    • Ensure all required credentials are valid and have sufficient permissions.
    • Validate input fields conform to expected formats and allowed values.

Links and References

Discussion