canonical: https://jentic.com/apis/auravms.com/auravms # AuraVMS API The AuraVMS API runs the request-for-quotation cycle for procurement teams: it creates RFQs and notifies selected suppliers by email, collects their quotes, compares them with automatic L1, L2, and L3 price ranking, and places purchase orders against a chosen quote. You manage a supplier directory with performance stats, save and send RFQ drafts, attach and download files, and send reminders to suppliers who have not responded. It also exports quote comparisons as PDF and reports procurement dashboard statistics. ## For AI agents Create RFQs, notify suppliers, compare their quotes with L1/L2/L3 ranking, and place purchase orders. Authenticates with a bearer JWT or an avms_ API key. ## Scope Does not process payments, track warehouse inventory, or handle shipping logistics. Use for running RFQs, comparing supplier quotes, and placing purchase orders only. ## Capabilities - Add and update suppliers in a directory and read their performance stats - Create an RFQ and notify selected suppliers by email - Compare supplier quotes with automatic L1, L2, and L3 price ranking - Place a purchase order against a chosen supplier quote - Send reminders, close an RFQ, and save or send RFQ drafts - Export a quote comparison as PDF and read procurement dashboard stats ## Use cases ### Agent-Run Sourcing An AI agent connected through Jentic creates an RFQ for a list of items, notifies the chosen suppliers, and later reads back the ranked quotes so a buyer can approve a purchase order. Because creating an RFQ and placing a PO both send supplier email, those steps sit behind an approval rule while the agent handles the assembly. Example prompt: Create an RFQ for these line items, send it to the selected suppliers, and report the quotes once they arrive ### Quote Comparison and Purchase Order A buyer reads an RFQ item's quotes with their automatic L1, L2, and L3 price ranking, exports the comparison as a PDF, and places a purchase order against the chosen quote. The ranking turns a stack of quotes into a clear lowest-to-highest view the agent can summarize. Example prompt: Read the quotes for this RFQ item, surface the lowest three, and place a purchase order against the one chosen ### Supplier Directory Management A team adds and updates suppliers, groups them by category, and reads performance statistics so the next RFQ goes to the right vendors. The supplier stats give an agent a basis for shortlisting rather than emailing everyone. Example prompt: Add a new supplier, tag its category, and return the performance stats for all suppliers in that category ## Key endpoints | Method | Path | Description | | --- | --- | --- | | POST | `/api/create-rfq/` | Create an RFQ and notify suppliers | | GET | `/api/get-rfq-list/` | List all RFQs | | GET | `/api/rfq-item-data/{rfq_item_id}` | Get quotes with L1/L2/L3 ranking | | POST | `/api/rfq-item-data/{rfq_item_id}` | Place a purchase order against a quote | | POST | `/api/create-supplier/` | Add a supplier | | GET | `/api/get-suppliers/` | List suppliers | ## Key resources - **Suppliers** — A supplier directory with categories and performance statistics - **RFQs** — Request-for-quotation lifecycle: create, list, items, drafts, reminders, and close - **Quotes and purchase orders** — Supplier quotes with L1/L2/L3 ranking and purchase orders placed against them - **Attachments and exports** — RFQ item attachments and PDF or Excel exports of quote data ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 60 / 100 - **Maturity:** Foundational - **Dimensions:** - Foundational Compliance: 71 / 100 - Developer Experience & Jentic Compatibility: 69 / 100 - AI-Readiness & Agent Experience: 38 / 100 - Agent Usability: 94 / 100 - Security: 60 / 100 - AI Discoverability: 74 / 100 - **View full report:** https://jentic.com/apis/auravms.com/auravms/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the AuraVMS API by hand means obtaining a JWT or an avms_ API key, separating the public login and status checks from the authenticated calls, and handling the asynchronous jobs some operations return. Through Jentic you install once, import AuraVMS from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** AuraVMS puts the RFQ and RFQ-item ids in the URL path, so a rule can let your agent read RFQs and compare quotes while leaving the operations that email suppliers or place a purchase order out. You choose the operations it may call, so sending an RFQ or placing a PO is included only if you add it. - **Credential handling:** Your AuraVMS key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'create an RFQ' or 'compare supplier quotes', and Jentic returns the matching AuraVMS operation with its input schema so the agent calls the right endpoint without reading the reference docs. ## Related APIs - **Zoho Inventory API** — Inventory, purchase orders, and vendor management for small businesses - **Xero Accounting API** — Cloud accounting with bills, purchase orders, and ledgers ## FAQ ### Is there an AuraVMS MCP server? You don't need an MCP server to give your agent the AuraVMS API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent can create RFQs and compare quotes straight away, with no extra server to run and no tool definitions to load into the agent's context. ### Can I limit what my agent is allowed to do with the AuraVMS API? Yes. Write a rule that allows reading RFQs and comparing quotes but not the operations that email suppliers or place a purchase order, so the agent can assemble sourcing work while a person approves anything that leaves the building, and every call it makes is logged. Because RFQ and item ids are in the URL path, you can also bound the agent to one RFQ. ### What authentication does the AuraVMS API use? The AuraVMS API authenticates with a bearer token, either a JWT access token or an avms_ API key created under Settings, per its OpenAPI spec. The login and status endpoints are public. Through Jentic the key is stored encrypted by your own instance and added at call time, so it never appears in the agent's prompt or logs. ### Can I compare supplier quotes with the AuraVMS API? Yes. Reading an RFQ item returns every supplier quote with automatic L1, L2, and L3 price ranking, and you can export that comparison as a PDF. An agent can surface the lowest quotes so a buyer places the purchase order with the ranking already done. ### What are the rate limits for the AuraVMS API? The OpenAPI spec does not specify rate limits for the AuraVMS API. For current limits and fair-use guidance, see the AuraVMS documentation at https://www.auravms.com. ### How do I run an RFQ with the AuraVMS API through Jentic? Import the AuraVMS API from the Jentic API Directory, then have your agent issue a request such as 'create an RFQ for these items and send it to these suppliers'. Jentic matches the intent to the create-RFQ operation and returns its input schema so the agent builds the correct request; because that operation emails suppliers, keep it behind your approval rules. To run it on your own infrastructure, install Jentic One from its GitHub repo.