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

Requisition Line — entity reference

One requested item on a requisition, numbered from document numbering (shipped series RL). The two fulfilment routes are counted separately: Purchase Order Quantity is rolled up from the purchase order lines released from this line, and Stock Transfer Quantity from the transfer lines released from it. Pending Quantity is Quantity minus both, and every release draws on it. Unit Cost comes from the requisition's purchase price list unless typed, the tax group from the tax group rules, and Amount is quantity times unit cost plus tax. Quantity cannot be lowered below the purchase order quantity, and a line with purchase order quantity cannot be deleted. Adding a package item adds its purchase components as child lines. A release copies the item, SKU, unit cost and package component to the new purchase order or transfer line; Item Lot Type and Description stay on the requisition line.

Fields

FieldLabelTypeRequiredWhat it does
AmountAmountCalculated (calculated)The line value: quantity times unit cost plus the line's tax amount. Rolls up into the requisition's Total Amount.
ApplyPostTaxDiscountApply Post Tax DiscountBooleanNot used on requisition lines: they carry no discounts, so tax is always worked out on quantity times unit cost.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
ExcludeInAutoOrderExclude In Auto OrderBooleanYesLeaves the line out of the auto-order calculations that count open requisitions. It has no effect on the release actions.
ExternalIdExternalTextAn identifier from another system, for imports and integrations. Not shown on the shipped forms.
IdIdGuidYes
ItemComponentIdItem ComponentLookup → ItemComponentThe package component this line represents. Filled automatically and carried to the purchase order line on release.
ItemIdItemLookup → ItemThe requested item. Required. Inactive items, discontinued items and Discounted Items are refused when the line is added.
ItemLotTypeIdItem Lot TypeLookup → ItemLotTypeThe lot type of the requested item, for reference. Shown on the line's record page only, and not copied to the purchase order or transfer line on release.
ModifiedByIdModified ByLookup → UserAccountYes
NameDocument NumberTextYesThe line's number, generated on save from the Requisition Line Name Setting (series RL, the document date and a six-digit counter).
OwnerIdOwnerLookup → UserAccountYes
PackageRequisitionLineIdRequisition LineLookup → RequisitionLineThe package line this component line belongs to. Filled automatically when a package item is added; deleting the package line deletes its component lines.
PendingQuantityPending QuantityCalculated (calculated)Quantity minus Purchase Order Quantity minus Stock Transfer Quantity: what a release can still take. Recalculated whenever the line is saved.
PriceAsOnDatePrice As On DateDateThe date the line's price is taken from; the requisition's price date or document date when empty. Not on the shipped forms. Changing it reprices the line.
PriceListIdPrice ListLookup → PriceListThe price list used for this line; the requisition's price list when empty. Not on the shipped forms. Changing it reprices the line.
PriceListRuleIdPrice List RuleLookup → PriceListRuleA reference to a price list rule. Automatic pricing does not fill it, and it is not on the shipped forms; changing it makes xMatix work out the line's price again from the price list.
PurchaseOrderQuantityPurchase Order QuantityNumberThe total Quantity of the purchase order lines released from this line. Maintained by the system when those lines are added, changed or deleted. A Cancelled Quantity on the purchase order line is not subtracted, so cancelling does not make the quantity pending again.
PurchaseRequisitionLineNumberPurchaseRequisitionLineNumberNumberSequence number of the line within its requisition.
QuantityQuantityNumberYesHow much is requested. Must be greater than zero, and cannot be lowered below the quantity already on purchase orders. On a package component line it must also stay within the component's minimum and maximum, and cannot change when the component's quantity is not editable.
RecordTypeIdRecord TypeGuid, hidden
RequestedQuantityRequested QuantityNumberThe quantity entered for this line in a selective release dialog. Must be greater than zero and no more than Pending Quantity. Not stored, so it always reads zero on the line's record page.
RequisitionIdRequisitionLookup → RequisitionThe requisition this line belongs to. Set when the line is added from the requisition's Lines tab.
SKUIdSKULookup → SKUThe item variant. Required when the item requires a SKU; limited to the item's SKUs, and a SKU of another item is refused.
StockTransferQuantityStock Transfer QuantityNumberThe total Quantity of the outward transfer lines released from this line. Maintained by the system when those lines are added, changed or deleted.
Tax1Tax 1CurrencyThe amount of the first tax component on the line, filled by the tax calculation from the line's tax group.
Tax1NameTax Name 1TextThe name of the first tax component, copied from the tax.
Tax1RateTax Rate 1CurrencyThe rate of the first tax component, copied from the tax.
Tax1TypeTax Type 1TextThe type of the first tax component, copied from the tax.
Tax2Tax 2CurrencyThe amount of the second tax component on the line, filled by the tax calculation from the line's tax group.
Tax2NameTax Name 2TextThe name of the second tax component, copied from the tax.
Tax2RateTax Rate 2CurrencyThe rate of the second tax component, copied from the tax.
Tax2TypeTax Type 2TextThe type of the second tax component, copied from the tax.
Tax3Tax 3CurrencyThe amount of the third tax component on the line, filled by the tax calculation from the line's tax group.
Tax3NameTax Name 3TextThe name of the third tax component, copied from the tax.
Tax3RateTax Rate 3CurrencyThe rate of the third tax component, copied from the tax.
Tax3TypeTax Type 3TextThe type of the third tax component, copied from the tax.
Tax4Tax 4CurrencyThe amount of the fourth tax component on the line, filled by the tax calculation from the line's tax group.
Tax4NameTax Name 4TextThe name of the fourth tax component, copied from the tax.
Tax4RateTax Rate 4CurrencyThe rate of the fourth tax component, copied from the tax.
Tax4TypeTax Type 4TextThe type of the fourth tax component, copied from the tax.
Tax5Tax 5CurrencyThe amount of the fifth tax component on the line, filled by the tax calculation from the line's tax group.
Tax5NameTax Name 5TextThe name of the fifth tax component, copied from the tax.
Tax5RateTax Rate 5CurrencyThe rate of the fifth tax component, copied from the tax.
Tax5TypeTax Type 5TextThe type of the fifth tax component, copied from the tax.
Tax6Tax 6CurrencyThe amount of the sixth tax component on the line, filled by the tax calculation from the line's tax group.
Tax6NameTax Name 6TextThe name of the sixth tax component, copied from the tax.
Tax6RateTax Rate 6CurrencyThe rate of the sixth tax component, copied from the tax.
Tax6TypeTax Type 6TextThe type of the sixth tax component, copied from the tax.
TaxAmountTax AmountCurrencyThe line's tax, recalculated when the item, SKU, quantity, amount or tax group changes. Each tax in the group is quantity times unit cost times its rate.
TaxGroupIdTax GroupLookup → TaxGroupThe line's taxes, chosen from the tax group rules when the line is added. Not copied on release; the purchase order line works out its own taxes.
UIPropsUI PropsText
UnitCostUnit CostCurrencyThe expected price per unit. On a new line the purchase price list price is filled in unless a cost was typed; picking a different item on the add form reprices the line, or clears the cost to zero when the new item has no price. Copied to the purchase order or transfer line on release.
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
DeleteInListDeleteDeleteDelete
EditEditEditEdit
EditEntityEditEditEditEntity
EditInLineEditEditInlineEdit In Line
HeaderEditHeader EditEditInlineedit
ImportImportUIActionImport
NewQuick AddNewInlineNew
ProductCatalogueProduct CatalogueUIActionProduct Catalogue

Validations

ValidationApplies toError messageNotes
Quantity Rule ValidationQuantity, ErrorQuantity should be greater than 0Prevents zero or negative quantity on requisition lines

Lookup filters

FilterLookup fieldNotes
Sku For ItemSKUIdSkuForItem