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

Claim — entity reference

A trade claim: an amount a partner company recovers from a supplier, manufacturer or principal for warranty and service work, damaged, short or excess goods, scheme payouts and similar. It is created by hand from the Claims app, by a claim generation setup run, or automatically when a service order with Auto Generate Claims lines is invoiced. Its Claim Lines carry the claimed, approved and rejected quantities. When an approval process approves the claim, the settlement job for its claim type creates the settlement document (credit note, invoice or adjustment) on the Supplier Account from the approved lines and sets Status to Settled; claim types settled per batch wait for a claim batch instead.

Fields

FieldLabelTypeRequiredWhat it does
ApproveAllApprove AllBooleanRequest flag for the Approve All routine, which copies every line's Claim Quantity into Approve Quantity and zeroes Reject Quantity. The routine applies this flag rather than the button pressed, and checks it before Reject All. The flag is not on the seeded claim forms and is never cleared.
AsOndateAs On DateDateCut-off date for line population when no specific source is linked: service-order lines and supplier-return lines are taken only from documents dated on or before it. Not on the seeded claim forms; claims created from a service order fill it with the order's date.
BillReturnIdBill ReturnLookup → BillReturnSupplier return (bill return) the claim relates to, for reference. Line population does not read this field.
BranchIdBranchLookup → BranchBranch raising the claim. Line population only considers source documents of this branch, and settlement copies it to the settlement document. Read-only on the record page; hidden for an organization with one location.
ClaimBatchIdClaim BatchLookup → ClaimBatchClaim batch the claim belongs to. Written by the batching job for claim types settled per batch; a claim with a batch is skipped by later batching runs. Deleting a batch does not clear it.
ClaimTypeClaim TypePickListKind of claim. It decides how lines are populated (Service reads service orders; Purchase, Damaged, Shortage and Excess read supplier-return credit-note lines; other types are generated or entered by hand) and which Claim Settlement Setup settles the claim, matched on the exact value. Values: Scheme, Marketing, Damaged, Sale, Service, Purchase, Shortage, Excess, Transport, Part To Part.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
DocumentDateDocument DateDateDate of the claim document. Claims created from a service order get the day they were created.
ExternalIdExternalText, uniqueIdentifier of the claim in an external system, for integrations. Must be unique.
GenerationKeyGeneration KeyTextDuplicate guard for claims created by a claim generation setup: claim type, group key and run month. A run skips any group whose key already exists. Blank on hand-made claims.
GoodsReceiptIdGoods ReceiptLookup → GoodsReceiptGoods receipt the claim relates to, for reference. Not read by line population or settlement.
IdIdGuidYes
InvoiceGroupInvoice GroupPickListInvoice group of the service-order lines the claim covers. Set on claims created from a service order; when the claim names a service order, line population only takes lines of this invoice group.
InvoiceIdSale InvoiceLookup → InvoiceSale invoice the claim relates to, for reference. Not read by line population or settlement.
IsLinePopulatedLine PopulatedBooleanYesNot set by line population. Check the Claim Lines tab to see whether a claim has lines.
IsReconciledReconciledBooleanYesSet when the Perform Reconciliation routine has run. It records that the routine was attempted, not that the supplier has paid.
ItemServiceContractIdService ContractLookup → ItemServiceContractService contract (warranty or free-service contract) the claim recovers against. When the claim names a service order, line population only takes lines covered by this contract.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYesClaim number, assigned on save from the Claim document name setting (default series CN, the date and a six-digit running number).
OwnerIdOwnerLookup → UserAccountYesUser who owns the claim. Claims from a generation setup are owned by the resolved resource's user or the branch owner.
PartnerAccountIdPartner AccountLookup → AccountPartner company (the dealer or distributor) raising the claim. Copied to the settlement document; the settlement document's party is the Supplier Account. Read-only on the record page; hidden for an organization with one company.
PerformPopulateLinesPerform Populate LinesBooleanYesRequest flag on the create and edit form. Saving with it ticked does not build lines; lines are built only when the Perform Populate Lines action runs, which the seeded record page does not offer.
PerformReconciliationPerform ReconciliationBooleanYesRequest flag on the create and edit form. Saving with it ticked does nothing on its own; the Perform Reconciliation routine clears it when it runs.
PurchaseReturnIdPurchase ReturnLookup → PurchaseReturnNot used. Supplier returns are recorded as bill returns.
RecordTypeIdRecord TypeGuid, hidden
RejectAllReject AllBooleanYesRequest flag for the Reject All routine, which copies every line's Claim Quantity into Reject Quantity and zeroes Approve Quantity. It applies only when Approve All is off. Not on the seeded claim forms and never cleared.
RemarksRemarksTextFree-text notes.
SchemeIdSchemeLookup → SchemeTrade scheme the claim comes from. Filled only when a claim generation setup maps it.
ServiceInvoiceAsOnDateService Invoice As On DateDateNot read by line population or settlement.
ServiceOrderAsonDateService Order As on DateDateNot read by line population or settlement; the cut-off used is As On Date.
ServiceOrderIdService OrderLookup → ServiceOrderService order the claim covers. For a Service claim, line population reads this order's claimable lines; without it, population sweeps the branch's invoiced or delivered service orders up to As On Date.
StatusStatusPickListWhere the claim is in its life: Draft (default), Pending Approval, Approved, Rejected or Settled. Approval and rejection values are written by the approval process's field updates; settlement sets Settled. Changing it by hand triggers nothing. Values: Draft, Pending Approval, Approved, Rejected, Settled.
SupplierAccountIdSupplier AccountLookup → AccountSupplier, manufacturer or principal the claim is made against. Settlement books the credit note or invoice to this account and refuses to settle without it. Claims from a service order take the contract's billing account; generated claims take the setup's supplier.
TotalAmountTotal AmountCalculatedClaim total. Not calculated from the lines; filled only when a claim generation setup maps it.
TotalApprovedAmountTotal Approved AmountCalculatedApproved total. Not calculated from the lines. When filled, settlement uses it as the settlement document's amount instead of the sum of the approved lines.
TotalApprovedQuantityTotal Approved QuantityCalculatedNot calculated from the lines.
TotalQuantityTotal QuantityCalculatedNot calculated from the lines.
TotalRejectedAmountTotal Rejected AmountCalculatedNot calculated from the lines.
TotalRejectedQuantityTotal Rejected QuantityCalculatedNot calculated from the lines.
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
ApproveAllApprove AllUIActionApprove All. On the seeded record page this button runs nothing, because the action is a UI action with no dialog. When run as a server action it applies the claim's Approve All and Reject All flags to every line's quantities; it does not approve the claim.
BulkDeleteDeleteDeleteDelete the selected records.
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
DeleteInListDeleteDeleteDelete
EditEditEditEdit
EditEntityEditEditEditEntity
EditInLineEditEditInlineEdit in page.
EditInListEditEditInlineEdit list header
NewNewNewNew
PerformPopulateLinesPerform Populate LinesUIActionPerform Populate Lines. Not on the seeded record page. When run as a server action it builds claim lines from the source documents for the claim type and marks those source lines as claimed, so a rerun does not duplicate them.
PerformReconciliationPerform ReconciliationUIActionPerform Reconciliation. On the seeded record page this button runs nothing, because the action is a UI action with no dialog. When run as a server action it raises a sale invoice on the Supplier Account from the Reimbursment lines with an approved quantity and marks the claim Reconciled.
RejectAllReject AllUIActionReject All. Not on the seeded record page; shares the Approve All routine.