Contract - Veles Docs

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 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 and lines 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, listed newest first in the Amendments related list, with what it did to each line as a Contract Amendment Line. 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).
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.
The Veles Quotes related list shows the quotes renewing or amending the contract, through the Source Contract lookup on the Quote, 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

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.

Text(255), unique, external ID

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

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.

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.

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.

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

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.

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.

Date

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

Date

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

Number(4, 0)

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

Number(3, 0)

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

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

Currency(16, 2)

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

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: pick the one your org calls “ARR”. On a flat contract the three are equal. Per-phase ARR lives on Contract Phases. 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.

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.

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.

Currency(16, 2)

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

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.

Text(255)

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

Text(255)

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

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.

Text(255)

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

Text(255)

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

Text(255)

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

Text(255)

Billing City — City of the bill-to address.

Text(255)

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

Text(255)

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

Text(255)

Billing Country — Country of the bill-to address.

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.