# AuraVMS - AI Agent Skills File

## What is AuraVMS

AuraVMS is RFQ (Request for Quotation) software for small businesses. It manages the supplier quotation workflow: send quote requests to suppliers, collect and compare responses with automatic L1/L2/L3 price ranking, and place purchase orders.

## API Access

- **Base URL:** https://api.auravms.com
- **Auth:** Bearer token in Authorization header
- **Key format:** avms_ prefix + 40 hex characters
- **Get a key:** Settings > API Keys in the AuraVMS app (https://app.auravms.com)
- **Full API docs:** https://www.auravms.com/docs

## Capabilities

You can use the AuraVMS API to:

1. **Manage suppliers** - add, update, list, view categories and performance stats
2. **Create RFQs** - send quotation requests with items, specs, and delivery dates to selected suppliers
3. **Track quotes** - view supplier responses ranked L1 (cheapest) through L3
4. **Place orders** - select a winning quote and place a purchase order (supplier gets PO email)
5. **Close RFQs** - mark quotation rounds as complete
6. **Send reminders** - notify non-responsive suppliers
7. **Manage drafts** - save, edit, send, or delete draft RFQs
8. **Attach documents** - upload/download files on RFQ items
9. **View analytics** - dashboard stats, supplier performance, export data
10. **Manage API keys** - create, list, revoke keys
11. **Submit feedback** - report bugs, request features, or send general feedback

## Key Workflow

1. List/add suppliers -> get their UUIDs
2. Create RFQ with items + supplier UUIDs -> suppliers get email with quote link
3. Check quotes -> GET /api/rfq-item-data/{item_id} shows L1/L2/L3 ranking
4. Place order -> POST with response_id of chosen quote
5. Close RFQ

## Restricted Actions

Organization settings, user profiles, billing, bulk import, and supplier response submission require the web app - they cannot be done via API keys.

## Links

- Full API documentation: https://www.auravms.com/docs
- Interactive API explorer: https://api.auravms.com/api/v1/docs/
- OpenAPI spec: https://api.auravms.com/api/v1/openapi.json
- Sign up: https://app.auravms.com/signup
- Pricing: https://www.auravms.com/pricing