1. Invalid value passed for contact_name_contains

The contact_name_contains parameter in Zoho Books is commonly used in search or filter queries to fetch specific contacts (such as vendors or customers). However, errors can occur if the value passed is empty, null, or incorrectly formatted (for example, if an object or number is provided instead of a valid string).

Make sure the value provided is of the correct type in Zoho Books. In Zoho Books, each contact is categorized as either: Customer – used for invoices and sales, Vendor – used for bills, expenses, and purchases.

2. 1002 – Invalid Value

One or more fields contain invalid values (for example, entering characters in numeric fields). This occurs when incorrect data types are passed, such as using a string instead of a number.

Make sure the value entered is of the correct type in Zoho Books.

3. 1005 – Record Not Found

Attempting to update or link a record that no longer exists (e.g., contact, account). Occurs when: The account_id or contact_id in the sync payload is invalid or has been deleted.

Always search and validate records prior to syncing. In case of updates or deletions in Zoho Books, re-sync the affected parameters.

4. 2002 – Account Inactive or Archived

The account you’re trying to use is inactive or archived. This happens when the GL account or chart of accounts in your data has been deactivated.

Activate the account in Zoho, or map it to a valid active account before syncing.

5. 3001 – Date Format Invalid

Date field format is invalid. Passing non-ISO date format (e.g., MM-DD-YYYY instead of YYYY-MM-DD).

Ensure that the format set in Zoho Books matches the format in Volopay.

6. 1003 – Tax Not Associated

Line item or expense doesn’t have the tax ID or it’s not enabled in the org.

Ensure the tax_id is correct and active in Zoho.

7. 5020 – Currency Mismatch

Currency for the transaction doesn't match the contact's currency.

Update the transaction currency to match the contact’s currency, or enable multi-currency and set the correct currency for the contact.

8. Specify_org_for_user_error

The user is linked to multiple organizations/entities, and a specific organization must be selected to proceed with the operation.

Ensure that the correct organization/entity is specified in the request before proceeding.

9. Remove_tax_for_transaction

Tax or reverse charge cannot be applied if the GST treatment is set as Non-GST supply or Out of Scope.

Remove the tax from the transaction or update the GST treatment in Zoho, if applicable.

10. Enter_valid_expense_account

The specified expense account is either missing or invalid.

Ensure to enter a valid expense account from the chart of accounts.

11. Unauthorized

The user lacks the necessary permissions to complete this action.

Ensure the user has the required access rights (read/write permissions for creating vendors, categories, etc.), or contact an administrator for assistance.