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

# Contract

> Field reference for the Veles Contract object in the Salesforce managed package.

A Veles Contract is the **agreement in force** with a customer: what they pay
for and are entitled to, created when a new-business or renewal order is
executed. See [Contract Management](https://docs.getveles.com/get-started/contract-management/overview.md)
for how contracts behave in Veles; this page is the field reference for the
mirrored Salesforce record.

A contract belongs to a customer, not to a deal, so it has no proposal parent.
It is a top-level record with a lookup to the Salesforce Account linked to its
company in Veles, which gives Account a **Veles Contracts** related list. A
package cannot change your Account page layout, so add that related list in
Setup > Object Manager > Account > Page Layouts. For the Account's active
contracts at a glance, also drag the **Veles Contracts Card** onto the Account
page in Lightning App Builder: one active contract shows its ARR, TCV, term and
bill-to contact, and several show each contract's TCV and dates. The contract's
[phases](https://docs.getveles.com/sfdc-managed-package/objects/contract-phase.md) and
[lines](https://docs.getveles.com/sfdc-managed-package/objects/contract-line.md) are master-detail children
of the contract.

To list every contract, add the **Veles Contracts** tab to your app's
navigation bar (Setup > App Manager, or each user's own navigation bar). Like
any tab, it opens on Recently Viewed, which cannot be cloned or given columns.
Switch to the **All** list view, which has no filters, and pin it to make it
your default. Build your own views from it with New or Clone, such as active
contracts ending in the next 90 days.

A contract reaches Salesforce once it is in force: when an order creates it,
when a contract entered in Veles by hand is activated, or when an import brings
it in. A draft entered by hand stays in Veles until then.

## How a contract changes over time

* **An amendment changes the contract in place.** The contract, its phases and
  its lines keep their records, and their values move to the amended terms.
  Veles records each change as a
  [Contract Amendment](https://docs.getveles.com/sfdc-managed-package/objects/contract-amendment.md), listed
  newest first in the **Amendments** related list, with what it did to each line
  as a [Contract Amendment Line](https://docs.getveles.com/sfdc-managed-package/objects/contract-amendment-line.md).
  An import's amendment stays in Veles for now.
  A line the amendment removes
  stays, flagged Removed; one removed while under way ends the day before the
  amendment. An amended line's prorated amounts count
  it at its old terms up to the amendment and at its new terms after (see
  [Contract Line](https://docs.getveles.com/sfdc-managed-package/objects/contract-line.md)).
* **A renewal starts a new contract** whose Source Contract is the one it
  renews. The old contract keeps its own record and status. Follow Source
  Contract back, or the **Renewals** related list forward, to walk a
  customer's renewal chain.
* The **Veles Orders** related list shows the orders that created or amended
  the contract, through the Contract lookup on the
  [Order](https://docs.getveles.com/sfdc-managed-package/objects/order.md).
* The **Veles Quotes** related list shows the quotes renewing or amending the
  contract, through the Source Contract lookup on the
  [Quote](https://docs.getveles.com/sfdc-managed-package/objects/quote.md), before any of them becomes an
  order.

## Fields at a glance

| Field | API Name | Type |
| - | - | - |
| Contract Name | `Name` | Text (standard name field) |
| Veles External ID | `Veles__External_Id__c` | Text(255), unique, external ID |
| Account | `Veles__Account__c` | Lookup(Account) |
| Source Contract | `Veles__Source_Contract__c` | Lookup(Veles Contract) |
| Contract Number | `Veles__Contract_Number__c` | Number(9, 0) |
| Status | `Veles__Status__c` | Picklist |
| Rep | `Veles__Rep__c` | Lookup(User) |
| Veles Link | `Veles__App_URL__c` | URL |
| Start Date | `Veles__Start_Date__c` | Date |
| End Date | `Veles__End_Date__c` | Date |
| Term (Months) | `Veles__Term_Months__c` | Number(4, 0) |
| Phase Count | `Veles__Phase_Count__c` | Number(3, 0) |
| TCV | `Veles__TCV__c` | Currency(16, 2) |
| Recurring TCV | `Veles__Recurring_TCV__c` | Currency(16, 2) |
| One-Time TCV | `Veles__One_Time_TCV__c` | Currency(16, 2) |
| First-Year ARR | `Veles__First_Year_ARR__c` | Currency(16, 2) |
| Exit ARR | `Veles__Exit_ARR__c` | Currency(16, 2) |
| Blended ARR | `Veles__Blended_ARR__c` | Currency(16, 2) |
| Currency Code | `Veles__Currency_Code__c` | Text(3) |
| Purchase Order | `Veles__Purchase_Order__c` | Text(255) |
| Billing Name | `Veles__Billing_Name__c` | Text(255) |
| Billing Email | `Veles__Billing_Email__c` | Email |
| Billing Address Line 1 | `Veles__Billing_Address_Line_1__c` | Text(255) |
| Billing Address Line 2 | `Veles__Billing_Address_Line_2__c` | Text(255) |
| Billing Address Line 3 | `Veles__Billing_Address_Line_3__c` | Text(255) |
| Billing City | `Veles__Billing_City__c` | Text(255) |
| Billing State | `Veles__Billing_State__c` | Text(255) |
| Billing Postal Code | `Veles__Billing_Postal_Code__c` | Text(255) |
| Billing Country | `Veles__Billing_Country__c` | Text(255) |
| Synced At | `Veles__Synced_At__c` | DateTime |

## Field details

**Name** `Text (standard name field)`

**Contract Name** — "Contract #" and the contract number, as Veles labels the
contract, then its company's name (e.g. Contract #2 - Acme Corp). Contract
numbers count per company, so the company tells two customers' Contract #2
apart. Just "Contract #2" for a contract with no company.

**Veles\_\_External\_Id\_\_c** `Text(255), unique, external ID`

**Veles External ID** — The Veles contract ID. All sync writes upsert on this
field; never edit.

**Veles\_\_Account\_\_c** `Lookup(Account)`

**Account** — The Salesforce Account this contract is for: the Account linked
to the contract's company in Veles. Empty when that company has no linked
Salesforce Account, for example a company created in Veles by hand. A lookup
rather than master-detail, so a contract mirrors even without one. Creates the
"Veles Contracts" related list on Account.

**Veles\_\_Source\_Contract\_\_c** `Lookup(Veles Contract)`

**Source Contract** — The contract this contract renews: set on a contract
created by a renewal order, empty for new business. A renewal starts a new
contract rather than extending the old one, so following Source Contract back
walks the customer's renewal chain, and the old contract's **Renewals**
related list shows what replaced it. Empty while the contract it renews is not
in Salesforce, and filled in once it is.

**Veles\_\_Contract\_Number\_\_c** `Number(9, 0)`

**Contract Number** — The sequential contract number within the customer's
company in Veles: a company's first contract is 1, its next 2, and so on.

**Veles\_\_Status\_\_c** `Picklist`

**Status** — Where the contract sits in its lifecycle, as Veles shows it.
Amending a contract leaves its status alone, and a renewal is a new contract,
so the contract it renews keeps its own. Unrestricted so new Veles statuses
never break the sync.

Values: `Draft` (not yet in force; seen only on a contract an import moved
back to draft, since a draft entered by hand stays in Veles), `Active`,
`Expired`, `Lapsed`, `Cancelled` (ended early; Veles records the cancellation
as an amendment).

**Veles\_\_Rep\_\_c** `Lookup(User)`

**Rep** — The contract's owner in Veles, as the Salesforce user they connected
Veles with. Empty when the contract has no owner or the owner has never
connected Salesforce. Use this rather than Created By for rep-level reporting.

**Veles\_\_App\_URL\_\_c** `URL`

**Veles Link** — Deep link to open this contract in Veles. Empty for a
contract with no company, which has no page of its own in Veles.

**Veles\_\_Start\_Date\_\_c** `Date`

**Start Date** — The first day of the contract term: the first phase's start
date.

**Veles\_\_End\_Date\_\_c** `Date`

**End Date** — The last day of the contract term: the last phase's end date.

**Veles\_\_Term\_Months\_\_c** `Number(4, 0)`

**Term (Months)** — The contract's term in months, from its Start Date to its
End Date.

**Veles\_\_Phase\_Count\_\_c** `Number(3, 0)`

**Phase Count** — Number of phases (time-segmented windows, e.g. ramp years).
1 means flat pricing for the whole term.

**Veles\_\_TCV\_\_c** `Currency(16, 2)`

**TCV** — Total Contract Value: One-Time TCV + Recurring TCV, everything the
customer pays over the full contract term, prorated to actual windows. An
amended line counts at its old terms up to the amendment and at its new terms
after. In the contract's own currency (see Currency Code).

**Veles\_\_Recurring\_TCV\_\_c** `Currency(16, 2)`

**Recurring TCV** — The sum of all Recurring Revenue Prorated across the
contract's phases. One-Time TCV + Recurring TCV = TCV.

**Veles\_\_One\_Time\_TCV\_\_c** `Currency(16, 2)`

**One-Time TCV** — The sum of all One-Time Revenue across the contract's
phases. One-Time TCV + Recurring TCV = TCV.

A ramp contract has no single ARR, so the contract carries the same three as
the [Quote](https://docs.getveles.com/sfdc-managed-package/objects/quote.md#arr): pick the one your org
calls "ARR". On a flat contract the three are equal. Per-phase ARR lives on
[Contract Phases](https://docs.getveles.com/sfdc-managed-package/objects/contract-phase.md). An amendment
moves all three: a phase's ARR counts an amended line at its new terms, and
Recurring TCV counts it at its old terms up to the amendment and its new terms
after. Cancelling a contract leaves them as they were, like its TCV, so filter
on Status to leave cancelled contracts out of an ARR report.

**Veles\_\_First\_Year\_ARR\_\_c** `Currency(16, 2)`

**First-Year ARR** — The first phase's ARR: the recurring run rate the
contract starts at. Blank when the contract has no phases.

**Veles\_\_Exit\_ARR\_\_c** `Currency(16, 2)`

**Exit ARR** — The last phase's ARR (the highest Sequence): the recurring
run rate the contract ends at. This is the last phase, not the largest, so a
contract that ramps down exits at its lower final rate. Blank when the
contract has no phases.

**Veles\_\_Blended\_ARR\_\_c** `Currency(16, 2)`

**Blended ARR** — Recurring TCV averaged over the term in years:
Recurring TCV / (Term (Months) / 12).

**Veles\_\_Currency\_Code\_\_c** `Text(3)`

**Currency Code** — ISO currency code of the contract (e.g. USD, EUR). All
amount fields on this record, its phases and its lines are in this currency.

**Veles\_\_Purchase\_Order\_\_c** `Text(255)`

**Purchase Order** — The customer's purchase order number, when one was
supplied.

**Veles\_\_Billing\_Name\_\_c** `Text(255)`

**Billing Name** — The bill-to contact name on the contract.

**Veles\_\_Billing\_Email\_\_c** `Email`

**Billing Email** — The bill-to contact email, where invoices are sent. Empty
when the address in Veles is not one Salesforce accepts: malformed, or longer
than 80 characters.

**Veles\_\_Billing\_Address\_Line\_1\_\_c** `Text(255)`

**Billing Address Line 1** — First line of the bill-to address.

**Veles\_\_Billing\_Address\_Line\_2\_\_c** `Text(255)`

**Billing Address Line 2** — Second line of the bill-to address.

**Veles\_\_Billing\_Address\_Line\_3\_\_c** `Text(255)`

**Billing Address Line 3** — Third line of the bill-to address.

**Veles\_\_Billing\_City\_\_c** `Text(255)`

**Billing City** — City of the bill-to address.

**Veles\_\_Billing\_State\_\_c** `Text(255)`

**Billing State** — State or province of the bill-to address.

**Veles\_\_Billing\_Postal\_Code\_\_c** `Text(255)`

**Billing Postal Code** — Postal code of the bill-to address.

**Veles\_\_Billing\_Country\_\_c** `Text(255)`

**Billing Country** — Country of the bill-to address.

**Veles\_\_Synced\_At\_\_c** `DateTime`

**Synced At** — When the Veles sync last wrote this record. The contract
mirror updates whenever the contract changes in Veles: created by an executed
order, activated, amended or cancelled.


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