Vendors
Stores vendor details such as addresses, contact information, and payment terms, for procurement workflows.
Table-Specific Information
The Vendors table is only accessible when connected to a ZohoCRM Enterprise Edition account. If using a different edition, this table may not be available.Select
This table supports COQL for filtering, meaning that most filters comparing columns to values are submitted server-side.
Insert
The following example demonstrates a basic insert operation:
-- Insert a new vendor with a name, email address, and website
INSERT INTO Vendors (VendorName, Email, Website) VALUES ('XYZVendor', '[email protected]', 'vendeverything.xyz')
Required fields: VendorName is required. This identifies the vendor record being created.
Any field which is not read-only (ReadOnly = false in the table schema) can be inserted.
Delete
You must specify the Id column in the WHERE clause to delete a record. The following example demonstrates a delete operation:
-- Delete a vendor by its unique ID
DELETE FROM Vendors WHERE Id = '3152079000000153079'
Update
You must specify the Id column in the WHERE clause to update a record. The following example demonstrates an update operation:
-- Update the description for a specific vendor using its ID
UPDATE Vendors SET Description = 'Changed from the API' WHERE Id = '3152079000000492032'
Required fields: Id is required. The update must target a specific record.
Any field which is not read-only (ReadOnly = false in the table schema) can be updated.
Columns
| Name | Type | ReadOnly | Description |
| Id [KEY] | String | True |
A unique identifier (Id) for the vendor record. |
| VendorName | String | False |
The name of the vendor. |
| Phone | String | False |
The vendor's phone number. |
| String | False |
The vendor's email address. | |
| Website | String | False |
The vendor's website URL. |
| GLAccount | String | False |
The general ledger account associated with the vendor. |
| Category | String | False |
The category or classification of the vendor. |
| VendorOwner_Id | String | False |
The unique Id of the user who owns this vendor record. |
| VendorOwner_FirstName | String | True |
The first name of the vendor record owner. |
| VendorOwner_LastName | String | True |
The last name of the vendor record owner. |
| VendorOwner_Email | String | True |
The email address of the vendor record owner. |
| VendorOwner_Name | String | True |
The full name of the vendor record owner. |
| CreatedBy_Id | String | False |
The unique Id of the user who created this vendor record. |
| CreatedBy_FirstName | String | True |
The first name of the user who created this vendor record. |
| CreatedBy_LastName | String | True |
The last name of the user who created this vendor record. |
| CreatedBy_Email | String | True |
The email address of the user who created this vendor record. |
| CreatedBy_Name | String | True |
The full name of the user who created this vendor record. |
| ModifiedBy_Id | String | False |
The unique Id of the user who last modified this vendor record. |
| ModifiedBy_FirstName | String | True |
The first name of the user who last modified this vendor record. |
| ModifiedBy_LastName | String | True |
The last name of the user who last modified this vendor record. |
| ModifiedBy_Email | String | True |
The email address of the user who last modified this vendor record. |
| ModifiedBy_Name | String | True |
The full name of the user who last modified this vendor record. |
| CreatedTime | Datetime | False |
The date and time when the vendor record was created. |
| ModifiedTime | Datetime | False |
The date and time when the vendor record was last modified. |
| Tag | String | False |
Any tags associated with this vendor record. |
| Street | String | False |
The street address of the vendor. |
| City | String | False |
The city where the vendor is located. |
| State | String | False |
The state or province where the vendor is located. |
| ZipCode | String | False |
The postal code of the vendor's address. |
| Country | String | False |
The country where the vendor is located. |
| Description | String | False |
Additional descriptive information about the vendor. |
| VendorImage | String | False |
The image or logo associated with the vendor. |
| RecordId | Long | True |
A system-generated record Id for internal reference. |
| Locked | Bool | True |
Indicates whether the vendor record is locked from further edits. |
| EmailOptOut | Bool | False |
Indicates whether the vendor has opted out of email communication. |
| UnsubscribedMode | String | True |
Describes how the vendor unsubscribed from emails. |
| UnsubscribedTime | Datetime | True |
The date and time when the vendor unsubscribed. |
| LastActivityTime | Datetime | False |
The most recent time of activity related to the vendor. |
Pseudo-Columns
SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| DuplicateCheckFields | String |
The fields used to check for duplicate records when performing an upsert. The REST API allows multiple fields, while the BULK API allows only one. |
| Trigger | String |
Used to trigger automation rules when inserting the vendor record. |
| CustomViewId | Long |
The custom view Id used to filter this record. Applies only when the useCOQL parameter is set to false. |