repairshopr-vendor

name	repairshopr-vendor
description	Manage vendors (suppliers) in RepairShopr
license	MIT
compatibility	opencode
metadata	{"audience":"purchasers, parts managers, administrators","api":"GET /vendors, POST /vendors, GET /vendors/{id}, PUT /vendors/{id}"}

What I do

I manage vendors (suppliers) in RepairShopr. Vendors represent companies or individuals from whom you purchase parts and supplies. I can list vendors, create new vendor records, view vendor details, and update vendor information.

When to use me

Use this when:

• Adding a new parts supplier to your system
• Updating vendor contact information (email, phone, address)
• Looking up vendor details when creating a purchase order
• Managing vendor relationships and accounts

How to use

Required API base URL:

• VITE_REPAIRSHOPR_SUBDOMAIN
• VITE_REPAIRSHOPR_API_KEY

Permissions:

• "Vendors - List" for listing
• "Vendors - New" for creating
• "Vendors - View Details" for viewing single vendor
• "Vendors - Edit" for updating

List Vendors (GET /vendors) Optional:

• page (integer) - Page number (100 results per page)

Create Vendor (POST /vendors) Body fields (all optional but you'd typically provide at least name and contact info):

• name (string) - Vendor company/name (required? not explicitly stated but typical)
• rep_first_name, rep_last_name (string) - Sales representative name
• email (string) - Contact email
• phone (string) - Phone number
• address, city, state, zip - Physical address
• website (string) - Vendor website
• notes (string) - Additional notes
• account_number (string) - Your account number with vendor

Get Vendor (GET /vendors/{id})

• id (integer) - Vendor ID

Update Vendor (PUT /vendors/{id})

• id (integer) - Vendor ID Body: fields to update (name, contact info, etc.)

Example call:

// List all vendors
const vendors = await skill({ name: "repairshopr-vendor" })

// Create a new vendor
const vendor = await skill({ name: "repairshopr-vendor" }, {
  name: "TechParts Wholesale",
  rep_first_name: "Bill",
  rep_last_name: "Sales",
  email: "[e-mail]",
  phone: "603-344-5555",
  address: "123 Supply Way",
  city: "Keene",
  state: "NH",
  zip: "03455",
  website: "www.techparts.com",
  notes: "Preferred vendor for LCD displays"
})

// Update vendor phone number
await skill({ name: "repairshopr-vendor" }, {
  phone: "603-555-1234"
}, { id: vendor.vendor.id, method: 'PUT' })

Response includes:

• Vendor object with fields: id, name, rep_first_name, rep_last_name, email, phone, address, city, state, zip, website, notes, created_at, updated_at

Important

• Vendor creation likely requires name at minimum (though not explicitly marked required in example)
• Email validation may apply (422 if invalid email format)
• Vendors are used in purchase orders; you cannot delete a vendor referenced by a PO (depends on your account's restrictions)

Related skills

• repairshopr-purchase-order - To create POs with vendors
• repairshopr-product - Products can be linked to vendors via vendor_ids
• repairshopr-asset - Assets may have vendor info