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/Service Recommendation — entity reference
REFERENCE · Last reviewed

Service Recommendation — entity reference

Advised work for an asset: an item and quantity that a checklist answer (through a service recommendation rule), a posted complaint line (through the complaint item catalogue), an advisor or AI Mechanic recommends. The customer's decision is taken on the service order's Service Recommendation tab or the service opportunity's Recommendation tab: ticking and saving accepts it and adds a service order line or opportunity line; clearing an accepted tick rejects it and withdraws that line. Checklist and complaint recommendations stay linked to the document that raised them; only unlinked ones are offered on the asset's later documents. Mandatory complaint items are accepted automatically. Invoice or Selective Invoice on a service order marks every recommendation behind a line of the order as utilised. The same table also holds the nightly field-sales outlet suggestions, which have an outlet instead of an asset.

Fields

FieldLabelTypeRequiredWhat it does
AcceptLabelAccept LabelTextFree-text slot. Stored only; the recommendations card and actions do not show it.
AssetIdAssetLookup → AssetThe asset the work is for. A document offers the open, unlinked recommendations of its own asset. Cannot be changed after the first save.
ChecklistLineIdChecklist LineLookupThe checklist answer that raised the recommendation. Changing that answer re-evaluates the rules, updating this recommendation, or removing it when its rule no longer matches and it is not utilised. Cannot be changed after the first save.
ComplaintItemIdComplaint ItemLookupThe complaint catalogue row the recommendation was raised from; its quantity and mandatory flag were copied onto the recommendation.
ComplaintLineIdComplaint LineLookupThe complaint line whose posting raised the recommendation. Deleting or re-pointing the complaint line removes or reconciles its recommendations.
ConditionConditionPickListThe Red, Amber or Green verdict copied from the checklist answer; the recommendations card shows it as Risk High, Moderate or Low. Values: Red, Amber, Green.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
ExternalIdExternalMultiLineText, unique
IconNameIcon NameText
IdIdGuidYes
IsAcceptedIs AcceptedBooleanYesThe customer accepted the work. Set by saving a tick on the document's recommendations card, by a mandatory complaint item, by an Accept recommendation nudge or by AI Mechanic. Ticking it on the record itself does not create a line.
IsConsumedIs ConsumedBooleanYesUsed by the field-sales outlet suggestions shown on a visit; no service process sets it.
IsRejectedIs RejectedBooleanYesThe customer declined the work. Setting it (by clearing an accepted tick on the card, or on the record) clears Is Accepted and withdraws the line the acceptance created; this is refused while that service order line is allocated, picked or invoiced. A rejected recommendation is never offered on another document.
IsUtilizedIs UtilizedBooleanYesSet when Invoice or Selective Invoice runs on the service order that holds the recommendation's line, for every such line of the order. A utilised recommendation is never offered again and cannot be deleted.
ItemIdItemLookup → ItemThe part or labour item recommended; it becomes the item of the line created when the recommendation is accepted.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYesShort title. Checklist-raised recommendations are named after the rule's Recommendation Type (or the checklist line's name), complaint-raised ones after the item. There is no numbering series.
NumericValueNumeric ValueNumberThe numeric reading of the checklist line that raised the recommendation (a measurement). Used as the service order line quantity only when Quantity is empty or zero.
OpportunityIdOpportunityLookupThe service opportunity the recommendation was raised on or accepted into. A recommendation linked to an opportunity is not offered on other opportunities.
OpportunityLineIdOpportunity LineLookupThe opportunity line created when the recommendation was accepted on a service opportunity; cleared again if it is rejected.
OwnerIdOwnerLookup → UserAccountYes
QuantityQuantityNumberHow many of the item to order. Seeded from the rule or complaint item and kept when the checklist answer changes. An accepted service order line takes Quantity when above zero, otherwise Numeric Value when above zero, otherwise 1; an opportunity line takes Quantity as it is, so 0 is refused there.
QuoteIdQuoteLookup → QuoteThe estimate the recommendation was raised on (by its checklist or complaint). A recommendation linked to an estimate is not offered on service orders or opportunities.
QuoteLineIdQuote LineLookupThe estimate line created for a mandatory complaint item posted on an estimate.
RecommendationRecommendationTextFree-text slot. Stored only; the recommendations card and actions do not show it.
RecommendationRemarksRecommendation RemarksTextExplanation of the advice. Complaint recommendations fill it as 'Complaint : … Fault : … Recommended Qty : …'.
RecommendationTypeRecommendation TypePickListWhere the recommendation came from: Health Check, Past, Complaint or IOT. Groups the rows on the recommendations card and is copied onto the created line. Complaint recommendations are always Complaint; checklist ones take the rule's value. Values: Health, Past, Complaint, IOT.
RecordTypeIdRecord TypeGuid, hidden
RejectLabelReject LabelTextFree-text slot. Stored only; the recommendations card and actions do not show it.
RepairOrderIdRepair OrderLookupThe service order the recommendation was raised on (by the order's checklist or complaints), or that invoiced it. Stored as the Service Order link; the seeded record page does not show it.
RepairOrderLineIdRepair Order LineLookupThe service order line created when the recommendation was accepted on a service order; cleared if it is rejected. Stored as the Service Order Line link.
ServiceRequestIdServiceRequestGuid
ServiceRequestLineIdServiceRequestLineGuid
SourceSourcePickListNot written by any process; the source is in Recommendation Type and the complaint or checklist links. Values: Repair Order Complaint, Opportunity Complaint.
TextValueText ValueTextThe text answer of the checklist line that raised the recommendation, refreshed when the answer changes.
TitleTitleText
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes
ValueTypeValue TypePickListThe kind of reading behind the recommendation; checklist recommendations copy the checklist line's data type. Values: Numeric, Boolean, RAG.

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
DeleteInListDeleteDeleteDelete
EditEditEditEdit
Edit2EditEditInlineEdit
EditEntityEditEditEditEntity
EditInLineHeaderEditEditInlineEdit In Line Header
NewNewNewNew