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

Item Lot — entity reference

An item lot is one identifiable quantity of an item, such as a received batch, a serial-numbered unit or a consignment, held by one partner account at one branch and storage location, with its own dates, costs and quantity counters. Receiving a goods receipt creates one lot per received line for every inventory-tracked item; transfers and van sales clone a lot at the destination and link it back through Related Item Lot; lots can also be created by hand. Lots are named from the Item Lot Name Setting (series LOT). For items with Track Lots every stock-moving line must name a lot. Invoicing and fulfilment allocation pick lots with an empty Hold Code and available quantity, matching the line's item, SKU, company, branch and (when the line has one) lot type, oldest first. Posting refuses any movement that would take a lot bucket below zero, and a cycle count with inventory locking freezes its lots until counting finishes.

Fields

FieldLabelTypeRequiredWhat it does
AdjustmentAdjustmentNumberNet signed quantity from untyped adjustment lines against this batch - this, not the adjusted-in counter, is where positive adjustments land. Counts fully into both the lot's available and in-hand balances.
BatchNoBatch NoTextYour batch identifier. Goods receipt does not copy it, so enter it on the lot; transfers and van sales copy it to the destination lot.
BranchIdBranchLookup → BranchThe branch that holds the lot. The picker lists only the chosen partner account's branches. Allocation and invoicing pick only lots at the document's branch.
ComponentNumberComponent NumberTextThe manufacturer's or component reference, copied from the goods receipt line and carried onto cloned lots.
CostCostCurrencyA cost value that goods receipt and posting do not fill; transfers copy it to the destination lot. Use Unit Cost for the received cost.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTime
DateOfDispatchDate Of DispatchDateNot filled by any process; it holds a value only if entered by hand. Not on the seeded forms.
DateOfExpiryDate Of ExpiryDateExpiry date of the batch. Goods receipt does not fill it; enter it on the lot. When a fulfilment order line has Limit Expiry Days, auto-allocation takes only lots whose expiry is on or before today plus that many days, and skips lots with no expiry date.
DateOfInwardDate Of InwardDateNot filled by any process; Date Of Receipt is the receipt date that goods receipt sets. Not on the seeded forms.
DateOfMfgDate Of MfgDateManufacturing date of the batch. Goods receipt does not fill it; enter it on the lot. Transfers copy it to the destination lot.
DateOfReceiptDate Of ReceiptDateThe goods receipt's document date, set when the receipt creates the lot.
DateOfRegistrationDate Of RegistrationDateRegistration date for registrable goods. Not filled automatically; when a receipt or invoice creates an asset from the lot, the asset takes this date. Not on the seeded forms.
DateOfSupplierDispatchDate Of Supplier DispatchDateThe supplier's dispatch date, copied from the goods receipt header when the lot is created. Not on the seeded forms.
DateOfSupplierInvoiceDate Of Supplier InvoiceDateThe supplier's invoice date, copied from the goods receipt header when the lot is created.
DisassembleDisassembleNumberAlways zero: no posting writes it, although both balances subtract it.
ExternalIdExternalText
ExternalNameExternal NameText
HashCodeHash CodeNumberAn internal token assigned when the lot is created. It is not a checksum and no process reads it.
HoldCodeHold CodeTextAny value quarantines the lot: invoicing and fulfilment allocation never pick a lot with a hold code. Clear it to release the lot. Nothing sets it automatically, and it is not on the seeded forms, so an administrator must add it to the lot record page before users can set it.
IdIdGuidYes
IsClosedIs ClosedBooleanInformational only. No process reads it, so it does not stop the lot being picked; use Hold Code for that. Not on the seeded forms.
IsClosedForSaleIs Closed For SaleBooleanInformational only. No process reads it, so it does not stop the lot being sold; use Hold Code for that. Not on the seeded forms.
IsTransactionLockedIs Transaction LockedBooleanSet by Start Counting and cleared by Finish Counting on a cycle count with inventory locking. While it is on, any save that changes the lot, including a posting, is refused with 'Item is locked for transaction! Please contact your Administrator for more details.' A save that clears the flag is accepted.
ItemIdItemLookup → ItemThe item the lot belongs to. Lot pickers on order, invoice and delivery order lines list only lots of the line's item and SKU.
ItemLotCodeLot CodeTextA short code shown in the allocation and manual-picking screens. Nothing assigns it automatically; enter it by hand if you use it.
ItemLotTypeIdItem Lot TypeLookup → ItemLotTypeThe commercial grade of the lot's stock, such as saleable, sample or promo. Copied from the goods receipt line. When a sales line has a lot type, only lots of that type are picked; a line with no lot type accepts any lot. Not on the create form.
LandedCostLanded CostCurrencyNot filled by any receipt or posting. Not on the seeded forms.
ModifiedByIdModified ByLookup → UserAccountYes
MRPMRPCurrencyMaximum retail price copied from the goods receipt line, and copied onto cloned lots. Not on the seeded forms.
NameNameTextThe lot number, generated on save from the Item Lot Name Setting (by default series LOT, a DDMMYYYY date and a six-digit counter). Document lines, ledger entries and the related-lot link refer to it.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner AccountLookup → AccountThe company that owns the lot: the goods receipt header's partner account, or the transfer's destination company for a cloned lot. Hidden on tenants that run one company.
PurchaseDatePurchase DateDateNot filled automatically; transfers and van sales only copy it from the source lot. Not on the seeded forms.
QuantityAdjustedInPostitive AdjustedNumberAlways zero: positive adjustments are counted in Adjustment instead.
QuantityAdjustedOutNegative AdjustedNumberBatch quantity written off by negative untyped adjustment lines, accumulated as a positive magnitude because the engine applies it as a decrement of a negative quantity.
QuantityAssembledInQuantity Assembled In (Future Use)NumberBatch quantity produced by assembly adjustments; despite the label marking it for future use it is actively written, because the seeded assemble rule's field name resolves to this property. It also absorbs disassembly adjustments, since the seeded disassemble rule points at the same assemble field.
QuantityAssembledOutQuantity Assembled Out (Future Use)NumberAlways zero: no posting writes it. Disassembly adjustments are counted in the assembled-in counter.
QuantityAvailableAvailableCalculated (calculated)Calculated quantity free to promise: the in-hand inflows minus everything sold, allocated, picked, on hold, under inspection, on loan, damaged, expired, short, transferred out or dispatched. Allocation and invoicing pick only lots with available quantity.
QuantityDamagedDamagedNumber
QuantityExcessQuantity ExcessNumber
QuantityExpiredExpiredNumber
QuantityInHandIn HandCalculated (calculated)Calculated quantity present at the location: receipts, assembly, transfers in, sale returns, excess and adjustments, minus sold, transfers out, purchase returns, damaged, expired, shortage, unbilled dispatches and quantity on loan. It can read negative when issues were posted against a lot that never received the matching quantity.
QuantityInPendingDeliveriesPending DeliveriesNumberBatch quantity invoiced but not yet delivered, incremented alongside the sold counter and released again when the delivery posts.
QuantityInTransitTransitNumberThe lot-level in-transit balance for two-step transfers: outward release adds the moving quantity on the destination clone, and inward receipt removes it.
QuantityOnAllocationAllocatedNumberQuantity of this batch reserved by fulfilment allocation lines; picking drains it as it fills the picked counter. Subtracted from the lot's available balance and ignored by its in-hand balance.
QuantityOnFulfillmentQuantity On Fulfillment (Future Use)NumberAlways zero and counted in neither balance. Reserved quantity is tracked in Allocated and Picked.
QuantityOnHoldQuantity On Hold (Future Use)NumberBatch quantity blocked by OnHold adjustment lines; despite the label marking it for future use it is actively maintained by posting, and is subtracted from the lot's available balance.
QuantityOnInspectionInspectionNumberBatch quantity held for incoming inspection, posted from inspection lines on a goods receipt. Subtracted from the lot's available balance and ignored by its in-hand balance.
QuantityOnInwardUnbilled ReceiptsNumberPer-lot mirror of the received-but-unbilled stock bucket, moved by the same posting call that moves the stock row. Adds to the lot's calculated available and in-hand balances.
QuantityOnLoanQuantity On Loan (Future Use)NumberBatch quantity lent out by OnLoan adjustment lines; despite the label marking it for future use it is actively maintained by posting, and is subtracted from the lot's available balance.
QuantityOnOutwardUnbilled DispatchesNumberPer-lot mirror of the dispatched-but-uninvoiced bucket. Subtracted by the lot's available balance and absent from its in-hand balance.
QuantityPickedPickedNumberQuantity of this batch on picked fulfilment lines, incremented as allocation is drained. Subtracted from the lot's available balance only.
QuantityPurchasedPurchasedNumberQuantity posted by supplier bills that name the lot. It is counted in neither In Hand nor Available.
QuantityPurchaseReturnedPurchase ReturnedNumberAn older counter that is not stored; nothing reads or writes it.
QuantitySaleReturnedSale ReturnedNumberAn older counter that is not stored; nothing reads or writes it.
QuantityShortageShortageNumber
QuantitySoldSoldNumber
QuantityTransferInTransfer InNumberAn older counter that is not stored and always reads empty. Transfers in are counted in Transfer Inward.
QuantityTransferOutQuantity Transfer OutDecimalAn older counter that is not stored and always reads empty. Transfers out are counted in Transfer Outward.
RecordTypeIdRecord TypeGuid, hidden
RegistrationNumberRegistration NumberTextRegistration number for registrable goods. Not filled by goods receipt; transfers copy it to the destination lot. Not on the seeded forms.
RelatedItemLotIdRelated Item LotLookup → ItemLotThe source lot this lot was cloned from by a transfer or van sale. Empty on lots created by goods receipt or by hand. Follow it to trace one batch across branches.
SaleDateSale DateDateNot filled by invoicing, which records the sale date on the asset instead. Not on the seeded forms.
SerialNumberSerial NumberTextSerial identity of a single-unit lot, copied from the goods receipt line. Receipt lines for items with Track Asset need one before they can be received.
SKUIdSKULookup → SKUThe item variant the lot belongs to. Copied from the goods receipt line.
StorageLocationIdStorage LocationLookup → StorageLocationThe bin or location the lot sits in. Copied from the goods receipt line, and rewritten when a transfer inward line is received with a storage location. Not on the create form.
SupplierInvoiceNumberSupplier Invoice NumberTextThe supplier's invoice number, copied from the goods receipt header when the lot is created.
TotalCostTotal CostCurrencyA total cost value that goods receipt and posting do not fill. It stays at zero unless entered by hand.
TransferInwardTransfer InwardDecimalCumulative quantity transferred into this batch's location, incremented by the inward leg of a transfer posting. Counts positively into the lot's available and in-hand balances.
TransferOutTransferOutDecimalYesAn older counter that is not stored and always reads empty. Transfers out are counted in Transfer Outward.
TransferOutwardTransfer OutwardDecimalCumulative quantity transferred out of this batch, incremented by the outward leg of a transfer posting. Subtracted by the lot's available and in-hand balances.
UIPropsUI PropsText
UnitCostUnit CostCurrencyPer-unit cost copied from the goods receipt line when the lot is created, and used as the unit cost on ledger entries that move this lot. Not on the seeded forms.
UpdatedDateTimeModified DateDateAndTime

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete the selected records.
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
DeleteInListDeleteDeleteDelete in a list page
EditEditEditEdit
EditInLineEditEditInlineEdit
EditListHeaderEditEditInlineEditListHeader
EditListRowEditEditEditListRow
NewNewNewNew

Validations

ValidationApplies toError messageNotes
Allow Product Lots Only with One QtyErrorThis Product Lot do not allow quantities in excess of one.Prevents serialised products from having more than one quantity in a lot

Lookup filters

FilterLookup fieldNotes
Branch For Partner AccountBranchId