xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField Sales & SFACRMRewardsClaimsInventoryProcurementWarehouse ManagementField ServiceServiceSupportTelephony & MessagingFinance & AccountingPayrollExpense ManagementCommercePortalsAnalytics & ReportingData StudioMobile AppSee all products →
PLATFORM
Platform overviewApp BuilderAutomationIntegrationsSecurity & GovernanceChange ManagementDevelopers
SENSE AI
Sense AI overviewSense AssistSense ControlSense VisionAI StudioTrust & governanceIn Claude & ChatGPTUse cases
SOLUTIONS
Auto DMSConsumer Goods DMSSales Force Automation (SFA) FMCG & DistributionManufacturing & Dealer NetworksAutomotive & DealershipsPharma & HealthcareConsumer DurablesAgri-InputsBuilding MaterialsService NetworksWarehousing & 3PLFinancial AccountingERP SoftwareIndia GST ComplianceUAE VAT & e-InvoicingSaudi ZATCA & VATAll solutions →
RESOURCES
Knowledge CenterDeveloper & CLIBlogGuidesWhat is xMatix?Company facts
COMPANY
AboutCareersPartnersEventsContactAuthorsLegal
Sign in Request demo
Home/Docs/Entity Reference/Asset Service Contract — entity reference
REFERENCE · Last reviewed

Asset Service Contract — entity reference

One asset's entitlement under a service contract definition: the dates, usage ceilings, grace allowances and covered items that service orders, opportunities and quotes are checked against when they claim contract cover for the asset. It is created automatically when a sales invoice that sells a Service Contract item against an asset runs Post Inventory (one per matching definition, values copied once), or by hand for cover sold elsewhere. Jobs naming the definition link the asset's entitlement that is not Is Utilized and not lapsed; service order invoicing raises the scope lines' Utilized Quantity and invoice cancellation gives it back. Not in any shipped app menu; reached from the All Asset Service Contracts list, the asset's Related tab, the contract item's Service tab and the vehicle console's Contracts tab.

Fields

FieldLabelTypeRequiredWhat it does
ActivatedDateActivated DateDateWhen cover began. Generated entitlements take the selling invoice's document date, and Due Date and Val Till Date are counted from it. No check reads this field itself.
AssetIdAssetLookup → AssetThe covered asset. Contract matching keys on this field together with Service Contract.
BillingAccountIdBilling AccountLookup → AccountThe payer for claims raised for work under this entitlement. When set it outranks the definition's BillingAccount as the claim's supplier account. Not used for customer invoices and not filled on generated entitlements.
ContractPostingTreatmentContract Posting TreatmentCalculatedA display copy of the definition's Contract Posting Treatment, filled when the record is saved; a value picked on the form is replaced. Job lines take their posting type from the definition, not from this copy.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
DescriptionDescriptionTextFree text. Not on the seeded forms and not read by any process.
DueDateDue DateDateWhen the next service falls due: Activated Date plus the definition's From Days on generated entitlements. Contract-schedule campaigns create reminder leads against this date. Separate from Val Till Date, which ends cover.
DueInHoursDue In HoursNumberThe hour reading at which service falls due, copied from the definition's Minimum Usage (Hours). Not checked by any process.
DueOnUsageReadingDue On Usage ReadingNumberThe usage reading at which service falls due, copied from the definition's Minimum Usage (Reading). Not checked by any process.
ExternalIdExternalText, uniqueNot stored on this entity, so it never holds a value.
GraceUsageDaysGrace Usage DaysNumberDays of tolerance after Val Till Date before the entitlement counts as lapsed. Default 0. The stated date does not move.
GraceUsageHoursGrace Usage HoursNumberHours of tolerance over Val Till Hours before the entitlement counts as lapsed. Default 0.
GraceUsageReadingGrace Usage ReadingNumberReading tolerance over Val Till Usage Reading before the entitlement counts as lapsed. Default 0.
IdIdGuidYes
IsUtilizedIs UtilizedBooleanYesMarks the entitlement as used up. Contract matching, service order and quote line population and campaign reminders skip it, and a Single Use definition refuses it. Nothing sets it automatically, and it is on neither seeded form (shown in the list only).
ItemIdItemLookup → ItemThe package parent line's item when the contract was sold inside a package; blank when the contract item was sold on its own.
ItemServiceContractIdService ContractLookup → ItemServiceContractThe service contract definition this entitlement belongs to. Matching keys on it together with Asset, and the definition's enforcement switches, usage band and posting treatment apply.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYesThe entitlement's number, set from the asset service contract numbering series (shipped prefix SC) when the record is saved; a typed value is replaced.
OwnerIdOwnerLookup → UserAccountYes
PopulateContractLinesPopulate Contract LinesBooleanWhen on, scope lines with Pending Quantity above 0 are copied onto a new service order with this asset and definition and no lines (not one created from an estimate), onto an opportunity when its Service Contract is set, and onto a saved quote when its Item Service Contract changes. Off on generated entitlements.
PostingTypePosting TypeTextFree-text posting type. Lines populated from this entitlement take it, and a job line that reaches the contract check with a blank posting type takes it before the definition's treatment. Not on the seeded forms and not filled on generated entitlements.
RecordTypeIdRecord TypeGuid, hidden
ServiceContractItemService Contract ItemLookup → ItemNot stored; it never holds a value. The contract item is in Service Contract Item (ServiceContractItemId).
ServiceContractItemIdService Contract ItemLookup → ItemThe contract item that was sold, copied from the definition's Item on generated entitlements. Quote line population matches the quote's Service Contract Item against it.
ServiceOrderIdService OrderLookup → ServiceOrderNot stored on this entity, so it never holds a value. Service orders and lines point at the entitlement instead.
ServiceTypeService TypeCalculatedNot stored and always blank. The service type that exists is on the definition.
SingleUseContractSingle Use ContractCalculatedNot stored and always blank. The Single Use Contract switch that is enforced is on the definition.
StatusStatusPickListNo seeded values. The only automatic value is Cancelled, set on every entitlement of an asset when a sale-return credit note line names that asset. Contract checks, line population and campaigns do not read it, so a cancelled entitlement can still give cover; the vehicle console hides it. Not on the seeded forms.
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes
ValidTillDateVal Till DateDateLast day of cover: Activated Date plus the definition's To Days on generated entitlements. The entitlement lapses when the job's failure date (or document date) is after this date plus Grace Usage Days.
ValidTillHoursVal Till HoursNumberHours ceiling, copied from the definition's Maximum Usage (Hours). Default 0. A job whose hours reading reaches this value plus Grace Usage Hours finds the entitlement lapsed, so 0 lapses it on any recorded reading.
ValidTillUsageReadingVal Till Usage ReadingNumberReading (for example distance) ceiling, copied from the definition's Maximum Usage (Reading). Default 0. A job whose reading reaches this value plus Grace Usage Reading finds the entitlement lapsed.

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
EditEditEditEdit
EditInLineEditEditInlineEdit
NewNewNewNew