Onoots Supply

Onoots Supply is a procurement management system enabling businesses to request quotes, issue purchase orders, track invoices, and settle payments—all with built-in compliance guardrails and digital signatures.

Core Workflow

Requisition → Create a purchase request with spend details
Sourcing → Send RFQs (Request for Quotes) to vendors
PO Issuance → Issue a signed purchase order (e-signature)
Receipt & Matching → Record goods received, match against PO
Invoice & Payment → Receive invoice, execute three-way match, pay vendor
Settlement → Payment anchored on-chain (blockchain receipt)

Key Features

💳 Stripe Payments (P5)

Invoice checkout via Stripe
Guardian-gated payment authorization (release_payment act)
Automatic credit deduction from brokerage balance
Payment webhook validation

✍️ E-Signatures (P7)

POs sent to vendor + buyer for digital signature (HelloSign)
Audit trail per PO
Status tracking (sent, viewed, signed, completed)
Binding contract records

⛓️ Web3 Settlement (P7)

Invoice payment anchored on Polygon Amoy testnet
Immutable proof of payment via OnootsReceipts contract
Settlement receipts for dispute resolution
Cron-based confirmation

Invoice Payment Flow

Initiate Payment


POST /api/procurement/invoices/payment
Authorization: Bearer <jwt>
Content-Type: application/json
 
{
  "invoiceId": "uuid"
}

Response:


{
  "url": "https://checkout.stripe.com/pay/...",
  "sessionId": "cs_..."
}

Payment Webhooks

Webhook	Source	Event
`/api/webhooks/stripe-payment`	Stripe	Payment completed → record + anchor
`/api/webhooks/hellosign`	HelloSign	Signature events → update PO status

Settlement Proof

After payment confirmed on-chain:


GET /api/procurement/receipts/{receiptId}/proof
Authorization: Bearer <jwt>

Response:


{
  "status": "confirmed",
  "txHash": "0x...",
  "blockNumber": 12345,
  "explorerUrl": "https://amoy.polygonscan.com/tx/0x..."
}

The procurement team can view payment status at /dashboard/procurement/invoices and download settlement proofs for records.

Guardian Compliance

All procurement acts are routed through the Compliance Guardian:

Act	Level	Restrictions
`dispatch_rfq`	Full Auto	None
`approve_spend`	AI Prepare	Budget checks
`issue_po`	Human Approve	Signature required
`release_payment`	Human Licensed	Payment gate

release_payment requires licensed human approval. Automated payment release is not permitted.

Status

P5 (Payments): ✅ Live — Stripe integration active
P7a (E-Sign): ✅ Ready — HelloSign integration configured
P7b (Web3): ✅ Coded — Polygon anchoring queued
P9 (Deploy): ✅ Live — https://supply.onoots.com

Next Steps

Deploy OnootsReceipts contract to Polygon Amoy testnet
Activate voice agent for vendor negotiations (optional)
Configure Railway swarm relay for background jobs (optional)

Learn more: See the Onoots Supply setup guides for deployment instructions.