pexsuppliers

name

pex:suppliers

description

ProcurementExpress supplier and product management via CLI. Use when listing, viewing, creating, or updating suppliers (vendors) and their products (catalog items). Also covers SAM.gov supplier audit checks. CLI commands: pex supplier list|show|create|update|top|check-sam|sam-status and pex product list|show|create|update. Triggers on: supplier, vendor, product, catalog, SKU, top suppliers, supplier search, product list, SAM.gov, supplier audit, UEI, CAGE.

ProcurementExpress Suppliers & Products

Prerequisites

Authenticate and set active company first (pex:setup skill).

Supplier Commands

# List (all or paginated with search)
pex supplier list --search="acme" --page=1
pex supplier list --department-id=5 --archived --show-mappings

# Top suppliers (most frequently used)
pex supplier top --top=10

# Show
pex supplier show 42

# Create
pex supplier create --name="Acme Corp" \
  --email="[e-mail]" --phone-number="[phone]" \
  --contact-person="John Doe" --payment-details="Wire: ACME-BANK-123" \
  --department-ids=5,6

# Update
pex supplier update 42 --address="123 Main St" --archived

Create/Update Options

• --name (required for create, must be unique)
• --email, --address, --notes, --payment-details
• --phone-number, --tax-number, --contact-person
• --department-ids — comma-separated, restrict to departments
• --archived — archive flag (update only)

Product Commands

Products are catalog items associated with a supplier. Use product_id on PO line items to auto-fill description, SKU, and unit price.

# List
pex product list --supplier-id=42 --page=1 --per-page=50
pex product list --archived

# Show
pex product show 99

# Create
pex product create --description="Widget A" --supplier-id=42 \
  --sku="WDG-A-001" --unit-price=9.99

# Update
pex product update 99 --unit-price=12.99

SAM.gov Supplier Audit

Check supplier status against the US government SAM.gov registry.

pex supplier check-sam 42      # trigger SAM.gov audit check
pex supplier sam-status 42     # get current SAM.gov status

Key Supplier Response Fields

• id, name, company_id, archived
• email, phone_number, address, contact_person
• notes, payment_details, tax_number, payment_terms
• currency_id, department_ids[], external_vendor_id

Key Product Response Fields

• id, supplier_id, sku, description, unit_price
• currency_id, archived, tax_rate_id