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 Order Line — entity reference
REFERENCE · Last reviewed

Service Order Line — entity reference

One part or labour line on a service order: the item, quantity, price, who pays (posting type and service contracts) and how far the line has got through time sheets, fulfilment, allocation, delivery, invoicing and claiming. Only Work Item (labour) and Part (stock) items can be used. Lines are added on the order's Lines tab or created from a service estimate, an opportunity, a lead, the asset's service contract, a change of the order's contract, open campaign maintenance or accepted service recommendations. On creation xMatix prices the line from the order's price list, applies the item's rate basis, copies the header discount, resolves tax and stock, sets the posting type and checks whether the same Work Item was recently done on the same asset (repeat repair).

Fields

FieldLabelTypeRequiredWhat it does
ActionTakenAction TakenPickListValues: Replace, Repair.
ActualDurationHoursActual Duration (Hours)NumberHours logged on the time sheet for this line.
AllocatedInvoicedQuantityAllocated Invoiced QuantityNumber
AllocatedQuantityAllocated QuantityNumberStock reserved for the line by allocation. Once it is above zero the item is locked and the line cannot be deleted.
AlternateItemIdAlternateItemLookup → ItemAlternateThe alternate-item record used when the requested item was substituted.
AmountAmountCalculated (calculated)Calculated: Base Amount less the net discount and net scheme discount, or Base Amount when discounts are taken after tax.
ApplyPostTaxDiscountApply Post Tax DiscountBooleanWhen on, the line's discounts are taken after tax instead of before it.
AssetIdAssetLookup → Asset
AssetMaintenanceIdAsset MaintenanceLookup → AssetMaintenanceThe scheduled asset maintenance this line carries out. Such lines are never flagged as repeat repairs.
AssetServiceContractIdAsset Service ContractLookup → AssetServiceContractThe asset's service contract that covers the line. Found automatically from the order's asset and the line's Item Service Contract, checking the contract's validity date, hours and usage reading against the order.
AssetServiceContractLineIdAsset Service Contract LineLookup → AssetServiceContractLineThe entitlement line of the asset service contract the work is drawn from.
BaseAmountBaseAmountCalculated (calculated)Calculated: (Quantity less Cancelled Quantity) times Unit Price 2 when it is above zero, otherwise times Unit Price.
BranchIdBranchLookup
CancelledQuantityCancelled QuantityNumberQuantity that will not be supplied or performed. Subtracted from the amount and from every pending quantity. A Work Item line whose whole quantity is cancelled no longer holds up the order's Work Completed status. Cannot be changed on campaign-mandatory lines.
ClaimableQuantityClaimable QuantityCalculated (calculated)Calculated: Quantity less Cancelled Quantity less Claimed Quantity when the posting type is a claims type, otherwise zero.
ClaimedQuantityClaimed QuantityNumberHow much of the line has been claimed. Once above zero the line's rate and hours are no longer recalculated.
ComplaintCodeIdComplaintCodeLookup → Complaint
ComplaintFaultCodeIdComplaintFaultCodeLookup → ComplaintFault
ContractDiscountContract DiscountPercentThe discount rate the service contract gives the line. Ignored when Contract Discount Amount is set.
ContractDiscountAmountContract Discount AmountCurrencyThe contract discount as an amount. Used instead of the Contract Discount rate when above zero.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTime
DeliveryQuantityDelivery QuantityNumberHow much of the line has gone out on delivery orders.
DiscountAmountDiscount AmountCurrencyThe line discount as an amount. Entering one clears the percentage discount the line took from the order.
DiscountAmount2Cash Discount AmountCurrencyLabelled Cash Discount Amount: a second discount as an amount.
ExternalIdExternalText
FailedItemDeliveredQuantityFailed Item Delivered QuantityNumberHow much of the failed part has been handed back. Recorded by hand.
FailedItemTreatmentFailed Item TreatmentPickListValues: Replaced, Repaired, Inspected.
FailedPartInfoFailed Part InfoText
FulfilmentOrderQuantityFulfilment Order QuantityNumberHow much of the line has been released to the warehouse on fulfilment orders.
GrossAmountGross AmountCalculated (calculated)Calculated: Amount plus tax, less the discounts when they are taken after tax.
HeaderItemHeader ItemTextNot stored.
IdIdGuid
IncludedInPackageIncluded In PackageBoolean
InventoryLedgerIdInventory LedgerLookup → InventoryLedgerThe inventory ledger entry raised for this line's stock movement. Its presence is what marks the line as already posted: the inventory-posting action only considers lines where it is empty, and refuses to run when every line has one.
InventoryStockIdInventory StockLookup → InventoryStock
InvoiceGroupInvoice GroupPickListParts or Service. Lines are split into separate invoices by invoice group. Values: Parts, Service.
InvoiceQuantityInvoice QuantityNumberHow much of the line has been invoiced. Once above zero the line's rate and hours are no longer recalculated.
IsBillableBillableBooleanOn when Posting Type is Generate Invoices or blank. Cannot be set by hand.
IsClaimedClaimedBooleanSet when the line has been claimed. Once set the line's rate and hours are no longer recalculated.
IsILPostedIL PostedBooleanSet by the system when the line's stock movement is posted to the inventory ledger. Cannot be edited.
IsILPostingApprovedIL Posting ApprovedBooleanSet by the system when the line's inventory ledger posting is approved. Cannot be edited.
IsInvoicedInvoicedBooleanSet when an invoice line has been produced for this line. Once set the line's rate and hours are no longer recalculated.
IsPackageServicePackage ServiceBoolean
IsSchemeGeneratedScheme GeneratedBooleanMarks a line the scheme engine added. Such lines are never flagged as repeat repairs.
IsCampaignMandatoryCampaign MandatoryBooleanMarks a line a campaign requires. Its item, quantity, cancelled quantity and contract cannot be changed and the line cannot be deleted.
ItemIdItemLookup → ItemYesThe part or labour item on the line. Only items of type Work Item or Part can be picked. The item must be active, needs a SKU when the item requires one, cannot be a Discounted Item, and must be one of the related items of the asset's item when such a list exists. Locked once stock has been allocated to the line.
ItemLotIdItem LotLookup → ItemLot
ItemLotTypeIdItem Lot TypeLookup → ItemLotType
ItemNameItem NameText
ItemServiceContractIdItem Service ContractLookup → ItemServiceContractThe service contract the line is charged to. The item must be on the contract's component lines once it has any; contracts that require an active, scope-restricted or single-use asset contract need a valid asset service contract for the order's asset. The lookup lists contracts whose Application To Type matches the order's Service Type, or that have none.
ItemServiceContractId2Item Service Contract2Lookup → ItemServiceContractA second contract that bears Service Contract Weightage 2 of the line's value. The contract needs a Weightage Invoice Charge Item that is not the line's own item.
ItemServiceContractId3Item Service Contract3Lookup → ItemServiceContractA third contract that bears Service Contract Weightage 3 of the line's value, with the same rules as Item Service Contract 2.
MaintenanceSubTypeMaintenance Sub-TypePickListA finer classification under Maintenance Type. Free text; no values are shipped.
MaintenanceTypeMaintenance TypePickListValues: Breakdown, Predictive, Preventive.
ModifiedByIdModified ByLookup → UserAccount
NameNameText
NetDiscountNet DiscountCalculated (calculated)Calculated: Discount Amount plus Cash Discount Amount plus the contract discount.
NetSchemeDiscountNet Scheme DiscountCalculated (calculated)
OpportunityLineIdOpportunity LineLookup → OpportunityLineThe opportunity line the line came from. The opportunity line's service order quantity is kept in step with this line's quantity.
OriginalItemIdOriginal ItemLookupThe item first asked for, kept when the line uses a substitute.
OTCInvoicedQuantityOTC Invoiced QuantityNumberQuantity billed over the counter, without going through fulfilment. Subtracted from the pending fulfilment order quantity.
OwnerIdOwnerLookup → UserAccountYes
PackageClassificationPackage ClassificationPickListMarks how the line sits inside a service package. Lines classified as "Packaged Item" are skipped by both the invoice run and the claim run, because their value is billed through the package parent rather than in their own right.
PartnerAccountIdPartner AccountLookup → Account
PendiFulfilmentOrderQuantityPending Fulfilment Order QuantityCalculated (calculated)Calculated: Quantity less Fulfilment Order Quantity, OTC Invoiced Quantity and Cancelled Quantity. What is still to release to the warehouse.
PendingAllocatedInvoicedQuantityPending Allocated Invoiced QuantityCalculated (calculated)Calculated: Allocated Quantity less Allocated Invoiced Quantity. Stock reserved for the line that has not yet been invoiced.
PendingDeliveryOrderPending Delivery OrderCalculated (calculated)Calculated: Quantity less Delivery Quantity less Cancelled Quantity. What is still to deliver.
PendingFulfilmentAllocationQuantityPending Fulfilment Allocation QuantityCalculated (calculated)Calculated: Quantity less Allocated Quantity less Cancelled Quantity. What is still to allocate.
PendingInvoiceQuantityPending Invoice QuantityCalculated (calculated)Calculated: Quantity less Cancelled Quantity less Invoice Quantity. What is still to invoice.
PendingPickingQuantityPending Picking QuantityCalculated (calculated)
PickedQuantityPicked QuantityDecimal
PostingTypePosting TypePickListWho the line is charged to. Current versions offer Generate Invoices (customer invoice), Generate Claims (a claim against the line's Item Service Contract, which is then required), Expense and Accidental Repairs; Auto Generate Claims is switched off. When the line's contract lists the item and has a Contract Posting Treatment, that treatment is set on the line; otherwise a blank value becomes Generate Invoices. Set again when the item or the contract on the line changes. Values: Auto Generate Claims, Generate Invoices, Generate Claims, Expense.
PriceAsOnDatePrice As On DateDateAndTimeThe date the price is looked up for. Changing it on the line looks the price up again.
PriceListIdPrice ListLookup → PriceListThe price list the line is priced from. Changing it looks the price up again.
PriceListRuleIdPrice List RuleLookup → PriceListRuleThe price list rule that gave the line its price.
PriceListRulesIdPrice List RulesLookupShown on the line page but not stored. Leave blank.
PurchaseOrderLineIdPurchase Order LineLookup → PurchaseOrderLineThe VOR purchase order line raised to buy this part.
QuantityQuantityNumberHow much is ordered. Must be greater than zero. On a Standard Hours, Actual Hours or Capped Actual rate basis it holds the billable hours and is filled by xMatix; a value you type is kept by time sheet updates but recalculated by the order's Reprice action.
QuoteLineIdQuote LineLookup → QuoteLineThe service estimate line the line came from. Pushing the estimate again skips estimate lines already on the order.
RecommendationAmountRecommendation AmountCalculated (calculated)Calculated: the line's Amount when the line came from a service recommendation, otherwise zero.
RecommendationIdRecommendationLookup
RecommendationTypeRecommendation TypePickListHow strongly the work was recommended, carried from the service recommendation or estimate line.
RecordTypeIdRecord TypeGuid, hidden
RequestedQuantityRequested QuantityNumberThe quantity picked for this line in a selective action (selective fulfilment, allocation, invoice or VOR). Not stored on the line.
ResourceIdResourceLookup → ResourceNot stored. The line's worker is in Service Advisor.
RNAExternalIdRNAExternalText
RNAServiceOrderExternalIdRNA Service Order ExternalText
SchemeBenefitIdScheme BenefitLookup → SchemeBenefit
SchemeDiscountAmountScheme Discount AmountCurrency
SchemeLineIdScheme SlabLookup → SchemeLine
SchemeRewardPointsScheme Reward PointsNumber
CampaignIdCampaignLookup → CampaignThe campaign the line was added under. When the order is delivered, the matching campaign maintenance on the asset is recorded as done by this line.
CampaignItemIdCampaign ItemLookupThe campaign item that produced the line. Such lines are never flagged as repeat repairs.
ServiceContractItemIdService Contract ItemLookup → ItemThe contract's charge item, carried from the estimate, opportunity or contract the line came from.
ServiceContractWeightageService Contract WeightageCalculated (calculated)Calculated: the share of the line left with the first contract, as a percentage (100 less the second and third shares).
ServiceContractWeightage2Service Contract Weightage 2DecimalThe share of the line borne by Item Service Contract 2, entered as a percentage. The second and third shares together cannot exceed the whole line, and a share needs its contract.
ServiceContractWeightage3Service Contract Weightage 3DecimalThe share of the line borne by Item Service Contract 3, entered as a percentage, with the same rules as Service Contract Weightage 2.
ServiceOrderDiscountService Order DiscountCalculated (calculated)Read-only copy of the order's header discount rate. The rate is copied onto the line when it is created.
ServiceOrderIdService OrderLookup → ServiceOrderThe service order the line belongs to. Cannot be changed after the line is saved.
ServiceOrderTimeSheetIdService Order Time SheetLookup → ServiceOrderTimeSheetThe time sheet the line is on. A line can be on only one time sheet; part lines are never put on one.
ServiceRecommendationIdService RecommendationLookup → ServiceRecommendationThe service recommendation the line was created from. Marked as used when the order is invoiced.
SkipSchemeSkip SchemeBooleanLeaves this line out of scheme evaluation, so it gets no scheme discount or reward.
SKUIdSKULookup → SKUThe variant of the item. Required when the item is set to require a SKU. Changing it looks up the stock record and recalculates tax.
StandardDurationHoursStandard Duration (Hours)NumberBook time for the operation in hours, from the item's Service Duration(Minutes) or the estimate or opportunity line. On a Standard Hours line it is the billable hours; on Capped Actual it is the cap.
StockAvailableStock AvailableCalculated (calculated)Free stock for the line's item, SKU, lot type and storage location, read from the stock record.
StockInHandStock In HandCalculated (calculated)On-hand stock for the line's item, SKU, lot type and storage location, read from the stock record.
StorageLocationIdStorage LocationLookup → StorageLocation
Tax1Tax1Currency
Tax1NameTaxName1Text
Tax1RateTaxRate1Currency
Tax1TypeTaxType1Text
Tax2Tax2Currency
Tax2NameTaxName2Text
Tax2RateTaxRate2Currency
Tax2TypeTaxType2Text
Tax3Tax3Currency
Tax3NameTaxName3Text
Tax3RateTaxRate3Currency
Tax3TypeTaxType3Text
Tax4Tax4Currency
Tax4NameTaxName4Text
Tax4RateTaxRate4Currency
Tax4TypeTaxType4Text
Tax5Tax5Currency
Tax5NameTaxName5Text
Tax5RateTaxRate5Currency
Tax5TypeTaxType5Text
Tax6Tax6Currency
Tax6NameTaxName6Text
Tax6RateTaxRate6Currency
Tax6TypeTaxType6Text
TaxAmountTax AmountCurrencyThe line's total tax. Recalculated when the item, SKU, quantity, tax group, amount or discount changes.
TaxGroupIdTax GroupLookup → TaxGroupThe tax group that decides the line's taxes. Picked automatically when the line is created and can be changed on the line dialog.
TechnicianIdTechnicianLookup → ResourceLabelled Service Advisor on the line: the person who works the line. Copied to the time sheet line when a time sheet is created; when blank, it is filled from the time sheet's resource.
TimeLostTime LostNumber
UIPropsUI PropsText
UnitPriceUnit PriceDecimalPrice per unit, or per hour on an hourly rate basis. Set from the order's price list when the line is created or its price list or price date changes; on a Cost Plus line it is the cost plus the markup. When set it must be greater than zero, so a line with no price on the price list needs a price entered by hand.
UnitPrice2Unit Price 2NumberAn override price for this line. When it is above zero it is used instead of Unit Price in the line's amount.
UpdatedDateTimeModified DateDateAndTime
WorkEndedAtWork Ended AtDateAndTimeWhen work on the line ended, set from the time sheet once every work segment for the line has ended.
WorkStartedByWork Started ByDateAndTimeA date and time, not a person: when work on the line first started, copied from the time sheet.
WorkStatusWork StatusPickListThe line's work stage. In current versions it is derived from the time sheet as Work Started, Work Paused or Work Ended. Read together with Work Ended At by the order's Work Completed check. Values: Paused- Non-Availability Of Stock, Paused- Non-Availability Of Technician, Work Ended.

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
Delete2DeleteDeleteDelete
DeleteInListDeleteDeleteDelete
DemoQAPQuick AddUIActionDemo QAP
EditEditEditEdit
Edit2EditEditInlineEdit In Line
EditEntityEditEditEdit Entity
EditInLineEditEditEdit
EditInLinePageEditEditInlineEdit
NewNewNewNew
NewInLineNewNewInlineNewInLine
ProductCatalogueProduct CatalogueUIActionDemo Product Catalogue

Validations

ValidationApplies toError messageNotes
Quantity Rule ValidationQuantity, ErrorQuantity should not be less than 0Quantity should not be less than 0
Unit Price Rule ValidationUnitPrice, ErrorUnit Price can not be less than 0Unit Price can not be less than 0

Lookup filters

FilterLookup fieldNotes
Item For Type Work Item Or PartItemId