ActivatedDate | Activated Date | Date | | When the entitlement was activated and coverage began, which can be later than the record's creation date — a contract sold with an asset is often activated at installation. |
AssetId | Asset | Lookup → Asset | | |
BillingAccountId | Billing Account | Lookup → Account | | The account to bill for work carried out under this entitlement, which is frequently not the asset's owning account — for warranty work it is typically the manufacturer or the selling partner. |
ContractPostingTreatment | Contract Posting Treatment | Calculated | | Declared as a calculated field but the first-party seed ships no formula for it, so it resolves to nothing on this entity. The authoritative value lives on the governing ItemServiceContract template, where it is a real picklist of Generate Claims, Generate Invoices and Auto Generate Claims. Read it from the template, not from here. |
CreatedById | Created By | Lookup → UserAccount | Yes | |
CreatedDateTime | Created Date | DateAndTime | Yes | |
Description | Description | Text | | |
DueDate | Due Date | Date | | When the next service under this contract falls due, as opposed to ValidTillDate which is when the entitlement expires altogether. Due tracking and expiry are separate axes here. |
DueInHours | Due In Hours | Number | | |
DueOnUsageReading | Due On Usage Reading | Number | | |
ExternalId | External | Text, unique | | |
GraceUsageDays | Grace Usage Days | Number | | Days of tolerance added to ValidTillDate before the contract is treated as lapsed. It extends the coverage window for matching purposes; it does not move the stated expiry date itself. |
GraceUsageHours | Grace Usage Hours | Number | | |
GraceUsageReading | Grace Usage Reading | Number | | |
Id | Id | Guid | Yes | |
IsUtilized | Is Utilized | Boolean | Yes | Marks the entitlement as consumed. Contract matching skips any contract with this set, and when the governing template is flagged SingleUseContract a second attempt to use it fails with 'This is a Single Use contract and has already been utilised'. |
ItemId | Item | Lookup → Item | | |
ItemServiceContractId | Service Contract | Lookup → ItemServiceContract | | The ItemServiceContract template this per-asset contract was instantiated from — labelled simply 'Service Contract'. Contract matching keys on this together with AssetId, and the template's flags decide whether an active contract is required, scope-restricted or single-use. Do not confuse it with ServiceContractItemId, which points at an Item. |
ModifiedById | Modified By | Lookup → UserAccount | Yes | |
Name | Name | Text | Yes | |
OwnerId | Owner | Lookup → UserAccount | Yes | |
PopulateContractLines | Populate Contract Lines | Boolean | | |
PostingType | Posting Type | Text | | How utilisation of this entitlement should be posted commercially. It is stored as free text on this record rather than as a picklist, unlike the template's ContractPostingTreatment which carries the seeded vocabulary. |
RecordTypeId | Record Type | Guid, hidden | | |
ServiceContractItem | Service Contract Item | Lookup → Item | | A lookup-typed field with no relation defined and no counterpart on the domain class — every other lookup on this entity has an EntityRelation and this one does not. It duplicates the label of ServiceContractItemId, which is the field that actually resolves to an Item. Do not read, filter or set this field; use ServiceContractItemId. |
ServiceContractItemId | Service Contract Item | Lookup → Item | | A lookup to the Item that represents the contract as a sellable product. Despite the similar label it is unrelated to ItemServiceContractId, which points at the ItemServiceContract template — this one resolves to an Item. |
ServiceOrderId | Service Order | Lookup → ServiceOrder | | |
ServiceType | Service Type | Calculated | | Declared as a calculated field with no formula in the first-party seed, so it holds nothing here. The real value is the ItemServiceContract template's ServiceType picklist, seeded with Warranty Repairs and Paid Repairs. |
SingleUseContract | Single Use Contract | Calculated | | Declared as a calculated field with no formula in the first-party seed. The flag that is actually enforced is SingleUseContract on the governing ItemServiceContract template, which combines with this record's IsUtilized to block a second use. |
Status | Status | PickList | | |
UIProps | UI Props | Text | | |
UpdatedDateTime | Modified Date | DateAndTime | Yes | |
ValidTillDate | Val Till Date | Date | | The calendar expiry of the entitlement. Lapse is judged against this date extended by GraceUsageDays, and the date compared is the document's failure date where one is given, otherwise the document date. |
ValidTillHours | Val Till Hours | Number | | The hour-meter ceiling of the entitlement. The contract is treated as lapsed once the service document's usage hours reach this value plus GraceUsageHours. |
ValidTillUsageReading | Val Till Usage Reading | Number | | The usage or distance ceiling of the entitlement. Exceeding this value plus GraceUsageReading lapses the contract and produces the failure 'KM reading exceeds service contract usage limit'. |
