> ## Documentation Index
> Fetch the complete documentation index at: https://tavryn.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Add and Manage Your SaaS Vendor Contracts in Tavryn

> Import, edit, and monitor your SaaS and cloud vendor contracts. Learn how Tavryn detects seat waste and triggers autonomous renewal negotiations.

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.

> [tab] PDF / Invoice Import
>
> 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.

> [tab] CSV Bulk Import
>
> Prepare a CSV file using the standard Tavryn column format and upload it from the contracts page or during onboarding. The parser validates every row on upload and surfaces field-level errors inline.
>
> **Required columns:**
>
> ```csv theme={null}
> vendor,service,category,annual_price,renewal_date,seats,active_seats
> Slack,Messaging Platform,software,12000,2025-03-01,100,62
> Datadog,Monitoring,software,18000,2025-04-15,50,48
> AWS,Cloud Infrastructure,cloud,45000,2025-06-01,,
> ```
>
> Column names are case-insensitive. Leave `seats` and `active_seats` blank for cloud contracts billed on usage rather than seats. The `annual_price` column must be a full-year figure in USD with no currency symbols or commas.
>
> > [!NOTE]
> >
> > Active seats must not exceed total seat count. The validator rejects rows
> > where `active_seats > seats` to prevent incorrect waste calculations.

> [tab] Manual Entry
>
> From the contracts page, click **Add Contract** to open the manual entry panel. Fill in the fields below and click **Save**.
>
> **vendor** `string` *required*
>
> The vendor's company name — e.g., `Notion`, `Datadog`, `AWS`.
>
> **service** `string` *required*
>
> The specific product or plan name — e.g., `Team Plan`, `Pro Monitoring`, `Cloud Infrastructure`.
>
> **category** `string` *required*
>
> One of `software`, `cloud`, or `contractors`. The agent uses this to match contracts against your policy's `allowed_categories` and `category_budgets`.
>
> **currentPrice** `number` *required*
>
> Annual contract value in USD. Must be greater than zero.
>
> **renewalDate** `string` *required*
>
> Contract renewal or expiry date in `YYYY-MM-DD` format.
>
> **seatCount** `number`
>
> Total provisioned seats. Omit for usage-based cloud contracts. Corresponds to the `seats` column in CSV imports.
>
> **activeSeats** `number`
>
> Seats with confirmed active logins in the current period. Used to calculate seat utilization waste. Must not exceed `seatCount`. Corresponds to the `active_seats` column in CSV imports.

## Contract fields reference

| Field | Type | Description |
| - | - | - |
| **Vendor** | string | Vendor company — matched against the vendor registry; new vendors are auto-created with a default reputation score of 4.8 |
| **Service** | string | Product or plan name shown on invoices and receipts |
| **Category** | enum | `software` · `cloud` · `contractors` |
| **Current Price** | number | Annual contract value in USD |
| **Renewal Date** | date | The date the contract auto-renews; triggers agent scanning 45 days prior |
| **Seat Count** | integer | Total provisioned user seats (nullable for cloud) |
| **Active Seats** | integer | Seats with recent confirmed usage (nullable for cloud) |

## 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:

```text theme={null}
idle_seats = seatCount - activeSeats
seat_savings = (idle_seats / seatCount) × currentPrice
```

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

> [!NOTE]
>
> 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

| Status | Meaning |
| - | - |
| **active** | Live contract; monitored by the daily scan |
| **negotiating** | Agent has opened a negotiation round with the vendor |
| **pending\_approval** | A deal has been proposed and is awaiting supervisor sign-off |
| **settled** | Payment has been escrowed and a savings receipt generated |
| **cancelled** | Contract was cancelled rather than renewed |

## 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.

> [!WARNING]
>
> 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:

```csv theme={null}
vendor,service,category,annual_price,renewal_date,seats,active_seats
Slack,Messaging Platform,software,12000,2025-03-01,100,62
Datadog,Monitoring,software,18000,2025-04-15,50,48
AWS,Cloud Infrastructure,cloud,45000,2025-06-01,,
Notion,Team Plan,software,4800,2025-05-10,40,39
GitHub,Enterprise,software,21000,2025-07-01,150,143
```

> [!TIP]
>
> 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.