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

Complaint — entity reference

A symptom in the workshop's complaint catalogue, such as Engine overheating: what a customer reports, used again and again on jobs. It is master data, not an individual customer grievance (use a case for that). Complaints are maintained under Service, Settings, Customer Care, Complaints, and each complaint holds its fault codes (Complaint Faults, the diagnosed causes) and its complaint items (the parts and labour it normally needs, optionally per fault). On a service order, estimate, opportunity or field visit the user records a complaint line naming a complaint and optionally one of its fault codes; saving the line raises service recommendations from the matching complaint items. AI Mechanic picks from existing complaints and fault codes when it captures a job's complaints from the technician's words; it never creates them.

Fields

FieldLabelTypeRequiredWhat it does
CodeComplaint CodeTextThe workshop's short code for the symptom, for example ENG-OH. Optional free text up to 100 characters, with no format or uniqueness check. AI Mechanic reads up to 200 complaints in Complaint Code order and shows the code under its proposals.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
DescriptionDescriptionLongMultiLineTextThe symptom in fuller words, ideally the customer's own. Optional. Shown in the All Complaints list and the New and Edit dialog but not on the shipped record page. AI Mechanic uses it as the complaint's title and matches the technician's words against it, falling back to the name when it is empty.
ExternalIdExternalTextAn identifier for the complaint in another system, for imports and integrations. Not on the shipped forms and not read by the complaint or recommendation logic.
IdIdGuidYes
ModifiedByIdModified ByLookup → UserAccountYes
NameComplaint NameTextYesThe symptom as people read it, for example Engine overheating. Required, not unique, and typed by hand because complaint numbering is inactive. Shown in the complaint pickers on jobs and field visits and in the remarks of the recommendations a complaint raises.
OwnerIdOwnerLookup → UserAccountYes
RecordTypeIdRecord TypeGuid, hidden
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes

Actions

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