Vendors are users who provide services or products to an account and can receive bills for their work. Each vendor is associated with an account and can have multiple bills created for tracking amounts owed.
Overview
Vendors represent companies or individuals you pay for goods or services. Managing vendors allows you to track expenses, create bills, and maintain an organized accounts payable system.
How It Works
- Create a vendor - Add a new vendor with contact and payment details
- Create bills - Associate bills with the vendor for expenses owed
- Track payments - Monitor payments made to each vendor
- Export data - Download vendor information for your accounting system
Example: Add "Content Provider Inc." as a vendor with their payment details. When you receive their monthly invoice, create a bill linked to this vendor for easy tracking and payment.
API Endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /api/v1/core/vendors | List all vendors |
POST | /api/v1/core/vendors | Create a vendor |
GET | /api/v1/core/vendors/{id} | Get a vendor |
PUT | /api/v1/core/vendors/{id} | Update a vendor |
DELETE | /api/v1/core/vendors/{id} | Delete a vendor |
GET | /api/v1/core/vendors/export | Export vendors |
Vendor Object
| Attribute | Type | Description |
|---|---|---|
id | integer | Unique identifier for the vendor |
name | string | Full name (first_name + last_name) |
first_name | string | Vendor contact's first name |
last_name | string | Vendor contact's last name |
email | string | Contact email address |
phone | string | Contact phone number |
birthdate | string | Contact's birthdate (if provided) |
job_title | string | Contact's job title (if provided) |
bills_count | integer | Number of bills associated with vendor |
total_billed | decimal | Total amount billed to this vendor |
metadata | object | Key-value pairs for storing additional data |
created_at | timestamp | Unix timestamp of creation |
updated_at | timestamp | Unix timestamp of last update |
Related Endpoints
- Bills - Bills payable to vendors
