Procurement Operations

The Procurement service manages the store's purchasing workflow from inventory demand through supplier engagement, quote review, ordering, payment preparation, shipping, and receipt.

For integration contracts, see the Procurement REST API, Procurement Webhooks, and UCP Procurement.

Dashboard Areas

Area	Purpose
Overview	Review procurement status and open work.
Inventory	Maintain purchasable inputs, stock targets, reorder points, and supplier relationships.
Suppliers	Maintain supplier identity, contact, capability, lead-time, and status data.
Requests	Review inventory-driven supplier requests.
Quotes	Review supplier quote information associated with requests and orders.
Orders	Review and update procurement orders.
Shipping	Track dispatch, shipment, receipt, and completion signals.
Integrations	Configure REST, UCP, MCP, webhooks, supplier email, and extensions.
Settings	Configure payment and passkey-related procurement controls.

End-to-End Workflow

1. Create or synchronize procurement inventory items.
2. Set target stock, reorder point, thresholds, unit cost, and preferred supplier where applicable.
3. Create and validate supplier records.
4. Generate or receive an order request.
5. Send the request to eligible suppliers through the configured channel.
6. Receive and review quotes.
7. Approve the selected commercial terms.
8. Create or update the procurement order.
9. Complete the required payment approval or handoff.
10. Track shipment, receipt, and reconciliation.

Integration Options

Integration	Common use
REST	ERP, purchasing system, or scheduled synchronization.
UCP	Protocol-compatible procurement operations.
MCP	Controlled supplier, inventory, and order tools for AI clients.
Inbound webhooks	Supplier, inventory, or order instructions from an external system.
Outbound webhooks	Lifecycle events sent to ERP, supplier, or monitoring systems.
Supplier email	Quote or supplier communication through configured SMTP.
Extension	Packaged procurement adapter for a supported system.

Usage Scenarios

• Replenish low-stock inputs from a preferred supplier.
• Request quotes from multiple suppliers and compare responses.
• Require an approval before a high-value order proceeds.
• Use an AI client to prepare a request while a human approves commercial terms.
• Send order state changes to an ERP through outbound webhooks.
• Approve a USDC supplier payment with a store-connected wallet.
• Track late shipments and incomplete receipts.

Control Points

• Define the authoritative system for inventory and order status.
• Separate request preparation from final approval where required.
• Verify supplier identity and destination before dispatch.
• Apply passkey or another supported approval control to sensitive actions.
• Reconcile payment, shipment, and receipt independently.
• Treat email parsing and webhook input as untrusted data.
• Use idempotency and stable external identifiers for retries.