xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField SalesCRMRewardsClaimsInventoryProcurementWarehouse 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
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 Fault — entity reference
REFERENCE · Last reviewed

Complaint Fault — entity reference

The diagnosed fault code that a technician assigns against a reported complaint - the 'what was actually wrong' counterpart to the customer-reported Complaint symptom. Rows can be scoped to a specific item or to an item group so the fault list can be filtered by what is being serviced, and they are referenced from ComplaintLine, ServiceOrderLine and ClaimLine. Gotcha for reasoning about service recommendations: changing a ComplaintLine's fault code re-triggers the recommendation recompute, but the recommendation rules themselves match only on ComplaintId, so the fault code never changes which recommendations are produced. It also carries a direct ServiceOrderId, giving two ways to reach a service order (directly, or via the ComplaintLine) - they are not kept in sync by any code.

Fields

FieldLabelTypeRequiredWhat it does
ApplicableToItemGroupIdApplicable To Item GroupLookup → ItemGroupThe broader alternative to ApplicableToItemId, scoping the fault code to a whole item group. Both may be set or both left empty; no code resolves precedence between them or validates the choice at save time.
ApplicableToItemIdApplicable To ItemLookup → ItemRestricts this fault code to a single item so fault pick-lists can be narrowed to what is actually being serviced. It is advisory scoping metadata - nothing in the platform enforces that a service line's item matches the fault code chosen.
ComplaintIdComplaintLookup → ComplaintTies the diagnosed fault back to the customer-reported symptom it explains, which is how a fault list is filtered once a complaint is chosen. Note that service recommendations are generated from the complaint alone - this link does not influence which recommendations appear.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
ExternalIdExternalText
FaultCodeFault CodeTextThe short diagnostic code for the fault, free text with no enforced format or uniqueness. It is the human-facing code; joins from service and claim lines are always on the record id, never on this string.
IdIdGuidYes
ModifiedByIdModified ByLookup → UserAccountYes
NameComplaint Fault Code NameTextYes
OwnerIdOwnerLookup → UserAccountYes
RecordTypeIdRecord TypeGuid, hidden
ServiceOrderIdService OrderLookup → ServiceOrder
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
CloneCloneServerAction (Clone)Create a copy of this record
EditEditEditInlineEdit
Edit2EditEditInlineEdit
NewNewNewInlineNew