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 Settlement Setup — entity reference
REFERENCE · Last reviewed

Claim Settlement Setup — entity reference

Says what xMatix creates when a claim of one claim type is approved. When an approval process approves a claim, the Settle claim background job looks up the active setup whose Claim Type equals the claim's Claim Type exactly, with no fallback, and creates a Draft credit note or invoice on the claim's supplier account from the approved lines (Unit Price times Approve Quantity), or nothing when the document is None. The claim then becomes Settled. A setup whose Settlement Grouping is PerBatch leaves approved claims for the Batch claims for settlement job and the Settle Batch action instead. With Simulate Mode on, the job only reports what it would create. Setups are listed in the Claims app under Claim Settlement Setups; the mappings, batching and event fields are edited on the record page, not in the create form.

Fields

FieldLabelTypeRequiredWhat it does
ApplyToOpenInvoicesApply To Open InvoicesBooleanYesWhen on, a settlement credit note is applied against the supplier account's open invoices, oldest first, right after it is saved. It has no effect on invoice settlement.
AutoGLPostingAuto GL PostingBooleanYesCopied onto the created credit note or invoice as its posting request. A settlement credit note is still created as Draft and is posted with Post General Ledger.
ClaimTypeClaim TypePickListYesThe claim type this setup settles. It must equal the claim's Claim Type exactly, and only one setup per type should be active. Choose the same value your claims carry; a claim type that is not in this setup's own list needs the same value added to it before claims of that type can be settled. Values: Trade Schemes(CLT-04), CLT-04R, QPS Scheme (CLT-04), Cashback(CLT-04), Provision (CLT-04), Structural Rate Difference Contract Pricing, PSR Incentive (CLT6,7), PSR Salary (CG 1,2), Training Claim, Damage, Shortage, Rate Difference, Reimbursment, Sale, Service, Purchase, Excess, Transport, Part To Part.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
HeaderMappingHeader MappingMultiLineTextOptional JSON object that overrides fields on the created document's header. Each key is a document field; each value is a claim field path, @approvedAmount (the claim's Total Approved Amount), @approvedQuantity (its Total Approved Quantity) or @const:<value>. It is applied after xMatix fills the document, and it is not checked on save; an error fails the settlement run. For a batch it reads the first claim.
IsActiveActiveBooleanYesOnly active setups are used by settlement and batching. A new setup starts inactive.
LineMappingLine MappingMultiLineTextOptional JSON object that overrides fields on each created document line. Values are claim line field paths, @approvedAmount (Unit Price times Approve Quantity of that line), @approvedQuantity (its Approve Quantity) or @const:<value>. Only lines with an Approve Quantity above zero produce a document line. It is not checked on save.
ModifiedByIdModified ByLookup → UserAccountYes
NameDocument NumberTextYesThe setup's name, typed when the setup is created. Nothing numbers setups and the name does not have to be unique.
OwnerIdOwnerLookup → UserAccountYes
RaiseEventNameRaise Event NameTextOptional business-rule event raised on the claim after settlement. It is also raised when the document is None or when no setup matches the claim's type, so a setup can be used for events only. If the event cannot be raised, the settlement still succeeds.
SettlementDocumentSettlement DocumentPickListYesWhat an approved claim produces. A credit note (the default) or an invoice is created as a Draft document on the claim's supplier account; None creates nothing and only raises the event. The settlement job recognises only the stored values CreditNote, Invoice, None and Adjustment, so any other stored value, including Adjustment (Part to Part), fails the run as not supported. Batch settlement accepts only a credit note or an invoice. Values: Credit Note, None.
SimulateModeSimulate ModeBooleanYesWhen on, the settlement and batching jobs only report what they would create and write nothing, so the claim stays Approved. The reported amount is the claim's Total Approved Amount, not the line total. Claims approved while it was on are not settled automatically when it is switched off; start a settlement run for them.
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete the selected records.
ClaimSettledClaimSettledServerAction (ClaimSettled)Not on any shipped screen and has no server handler. Settlement runs as the Settle claim background job when a claim is approved.
DeleteDeleteDeleteDelete
DeleteInListDeleteDeleteDelete the record.
EditEditEditEdit the ClaimSettlementSetup.
EditEntityEditEditEditEntity
EditInLineEditEditInlineEdit inline.
EditInListEditEditInlineEdit inline in the list.
NewNewNewCreate a new ClaimSettlementSetup.