Skip to main content
The contracts view at /contracts is the central record of every SaaS subscription, cloud commitment, and contractor agreement your organization has connected to Tavryn. Each contract entry feeds the autonomous procurement engine: when a renewal date falls within the active scanning window, the agent audits seat utilization and usage trends, computes potential savings, and — if conditions are met — opens a negotiation. Keeping your contract list accurate and complete is the single most important thing you can do to maximize the value Tavryn delivers.

Adding contracts

Tavryn supports three methods for adding contracts to your account. You can mix and match — for example, bulk-importing most contracts via CSV and then manually adding a few edge cases.
Navigate to /onboard or use the Import action from the contracts page. Upload a PDF invoice, vendor order confirmation, or a scanned image (PNG/JPG). The AI extraction layer parses the document and identifies the vendor, service name, annual price, renewal date, and seat details.Supported formats: PDF, PNG, JPG/JPEG — up to 10 MB per file.After extraction, the detected contract appears in the review table. Verify the extracted fields, correct anything the parser got wrong, and click Add to Contracts.Every contract created through invoice import is logged to the append-only audit chain with action: contract_created_from_invoice and a confidence score.

Contract fields reference

How Tavryn detects waste

The agent uses two primary waste signals: Seat utilization. When both seatCount and activeSeats are present, Tavryn calculates the idle-seat ratio:
In the sample data above, Slack has 100 seats but only 62 are active — 38% of the contract value is billable waste. The agent anchors its opening negotiation position around this number. Usage decline. For cloud contracts, you can optionally supply a usage_decline_pct field representing the percentage by which measured consumption has dropped over the past period. The agent uses this metric to build the case for a reduced commitment tier. Both signals feed the Switch vs. Renegotiate Matrix — a net NPV calculation that weighs renewal savings against migration engineering hours, employee retraining cost, and downtime risk before the agent commits to a strategy.

The 45-day renewal window

Tavryn’s daily cron job (running at 08:00 UTC) scans all contracts and flags any with a renewalDate within the next 45 days. Once a contract enters the active scanning window:
  1. The agent audits seat utilization and usage decline metrics
  2. It evaluates whether projected savings exceed the min_savings policy threshold
  3. If both conditions are met, it initiates the negotiation loop — up to 5 rounds of concession curves against the vendor
  4. An adversarial Reviewer Agent independently audits the proposed deal before escalation
The default 45-day renewal window can be adjusted by your Tavryn administrator to match your organization’s procurement calendar. Contact support to request a custom window width.

Contract statuses

Trigger an agent run manually

To run the agent immediately against a specific contract without waiting for the daily cron, open the contract detail view and click Run Agent Now. This executes the full 7-stage autonomous loop — waste detection, NPV comparison, negotiation, reviewer audit, policy check, and (if approved) USDC escrow — on demand.
Manually triggered runs count against your vendor’s concession round budget. If the agent has already completed multiple rounds with a vendor this period, triggering another run may exhaust the walk-away ceiling sooner than expected.

CSV format reference

Use this template when bulk-importing contracts. Save it as a .csv file with UTF-8 encoding:
Export your company credit card statement as a CSV and upload it via the Statement / Invoice ingestion mode instead of building this file from scratch. The AI parser will detect recurring charges and populate the fields automatically.