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

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

A Veles Contract Amendment is **one change Veles recorded to a contract**: the
order that created it, each order that amended it, an import, an activation or
a cancellation. See [Amendment](https://docs.getveles.com/get-started/contract-management/overview.md#amendment)
for how amendments behave in Veles; this page is the field reference for the
mirrored Salesforce record.

Amendments are master-detail children of the
[Contract](https://docs.getveles.com/sfdc-managed-package/objects/contract.md), which gives the contract an
**Amendments** related list: its change history, newest first. An amendment an
order made lists what it did to each contract line as
[Contract Amendment Lines](https://docs.getveles.com/sfdc-managed-package/objects/contract-amendment-line.md).

## What makes an amendment

| Amendment Type | Recorded when | Lines |
| - | - | - |
| Order Execution | An executed order creates the contract (its first amendment, named Initial Contract) or amends it (Amendment 2, 3, ...) | One per contract line the order added, changed, removed or kept |
| Import | Veles imports the contract or a change to it, or a contract entered in Veles is activated | None |
| Cancellation | The contract is cancelled | None |

Only an order reprices a contract, so only an Order Execution amendment has
lines and a Payable Impact. The others record that something happened to the
contract, and when.

For now the sync sends the amendments an order made and a cancellation. An
Import amendment stays in Veles: a contract that was imported, or entered in
Veles and activated, has no amendment in Salesforce until an order amends it,
and its Amendment Numbers in Salesforce have a gap wherever an import happened.

A renewal order creates a new contract rather than amending the old one, so its
Order Execution amendment is the new contract's Initial Contract.

## The money on an amendment

**Payable Impact** is how much the amendment changes what the customer pays,
from its Effective On date to the end of each line's window: the sum of its
lines' Payable Impact, positive when the customer pays more. On the Initial
Contract every line is new, so the Payable Impact is each line's value over its
whole window. On a later amendment it is the change alone: taking a line from
10 to 20 seats at $1,200 a seat per year, halfway through a one-year term, reads
about $6,000.

Report expansion and contraction on the
[Contract Amendment Line](https://docs.getveles.com/sfdc-managed-package/objects/contract-amendment-line.md),
which carries the same Payable Impact per line along with its Impact Type,
Billing Type and product.

## The amendment page

An amendment's record page shows what it did to each contract line, phase by
phase. Where a quantity, unit price or amount changed, the old value is struck
through above the new one, and each line shows its Payable Impact. The page
opens on the lines that changed; **All lines** adds the ones the amendment
kept. Beside the lines, the summary gives the amendment's Payable Impact and
the contract's TCV before and after it (Old TCV and New TCV): an order
amendment has a line for every contract line, so these are the sums of its
lines' Prior Contribution and Contribution. Below the figures, the summary
links the contract's Account, the contract and the order. The Initial Contract
shows its lines and TCV as signed. A cancellation has no lines.

## Fields at a glance

| Field | API Name | Type |
| - | - | - |
| Amendment Name | `Name` | Text (standard name field) |
| Veles External ID | `Veles__External_Id__c` | Text(255), unique, external ID |
| Contract | `Veles__Contract__c` | Master-Detail(Veles Contract) |
| Amendment Number | `Veles__Amendment_Number__c` | Number(9, 0) |
| Amendment Type | `Veles__Amendment_Type__c` | Picklist |
| Effective On | `Veles__Effective_On__c` | Date |
| Order | `Veles__Order__c` | Lookup(Veles Order) |
| Payable Impact | `Veles__Payable_Impact__c` | Currency(16, 2) |
| Description | `Veles__Description__c` | Long Text Area(32768) |
| Synced At | `Veles__Synced_At__c` | DateTime |

## Field details

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

**Amendment Name** — The amendment's name in Veles (e.g. Initial Contract,
Amendment 2, Contract Cancelled).

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

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

**Veles\_\_Contract\_\_c** `Master-Detail(Veles Contract)`

**Contract** — The Veles contract this amendment changed. Master-detail: a
contract's amendments, by Amendment Number, are its change history.

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

**Amendment Number** — The amendment's sequence number within its contract:
the contract's first amendment is 1, its next 2, and so on.

**Veles\_\_Amendment\_Type\_\_c** `Picklist`

**Amendment Type** — What made the amendment. Empty for an amendment recorded
through the Veles API without a type. Unrestricted so new Veles amendment
types never break the sync.

Values: `Order Execution` (an executed order created or amended the
contract), `Import` (Veles imported the contract or a change to it, or a
contract entered in Veles was activated), `Cancellation` (the contract was
cancelled).

**Veles\_\_Effective\_On\_\_c** `Date`

**Effective On** — When the amendment takes effect. For one an order made,
the order's Effective On: on an amendment order, the amendment date inside the
contract's window. For a cancellation, the effective date picked when the
contract was cancelled. For an import or activation, the day Veles recorded
it. Each amendment takes effect on or after the one before it.

**Veles\_\_Order\_\_c** `Lookup(Veles Order)`

**Order** — The Veles order whose execution made this amendment: the order
that created the contract, or one that amended it. Empty for an import,
activation or cancellation, and until the order is in Salesforce: the sync
fills it in once the order lands. Gives the
[Order](https://docs.getveles.com/sfdc-managed-package/objects/order.md) a **Contract Amendments** related
list.

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

**Payable Impact** — The sum of this amendment's lines' Payable Impact: how
much the amendment changes what the customer pays from its Effective On date
to the end of each line's window. Positive when the customer pays more. Zero
on an amendment with no lines: an import, activation or cancellation.

**Veles\_\_Description\_\_c** `Long Text Area(32768)`

**Description** — A short account of what the amendment did, as Veles wrote
it (e.g. Amendment 2 created from order).

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