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

Adjustment Line — entity reference

One stock correction on an adjustment: an item, SKU, lot and storage location, a quantity, a unit cost and an Adjustment Type that decides which stock bucket and ledger entry type posting uses. Saving a line posts nothing; the adjustment's Post Inventory posts every line without an Inventory Ledger reference. Once posted, a Quantity or Unit Cost edit posts a reversal and a replacement and a delete posts a reversal. Item, SKU, Item Lot and Storage Location cannot be changed after the line is saved.

Fields

FieldLabelTypeRequiredWhat it does
AdjustmentIdInventory AdjustmentLookup → AdjustmentYesThe adjustment the line belongs to; its partner account and branch decide whose stock moves.
AdjustmentTypeAdjustment TypePickListThe reason for the correction. Empty: a positive Quantity adds to Positive Adjusted and a negative one to Negative Adjusted. Excess, Shortage, Damaged and Expired post to their own buckets, only for quantities above zero. OnHold and OnLoan post to their buckets and accept negative quantities to release stock. Assemble and Disassemble both post into Assembled In and generate no component lines. Changing the type on a posted line does not re-post it. Values: Expired, Damaged, OnLoan, Shortage, Assemble, Excess, OnHold, Disassemble.
ClaimBatchIdClaim BatchLookup → ClaimBatchA claim batch reference. Not filled by the standard claim settlement.
ClaimIdClaimLookup → ClaimThe claim a settlement-created line came from.
ClaimLineIdClaim LineLookup → ClaimLineThe claim line whose approved quantity a claim settlement wrote to this line.
ConversionRatioConversion RatioNumber
ConversionRatio1Conversion Ratio 1Number
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
CycleCountLineIdCycle Count LineLookup → CycleCountLineThe counted line that produced this line on a cycle count release: one untyped signed line for the difference, plus Damaged and Expired lines for recorded damaged and expired quantities.
DamagedQuantityDamaged QuantityCalculated (calculated)Calculated: equals Quantity when the type is Damaged, otherwise 0. The damaged ledger setting posts from it.
ExcessQuantityExcess QuantityCalculated (calculated)Calculated: equals Quantity when the type is Excess, otherwise 0. The excess ledger setting posts from it.
ExpiredQuantityExpired QuantityCalculated (calculated)Calculated: equals Quantity when the type is Expired, otherwise 0. The expiry ledger setting posts from it.
ExternalIdExternalText, unique
IdIdGuidYes
ILPostingQuantityIL Posting QuantityCalculated (calculated)Calculated absolute value of Quantity.
InventoryLedgerIdInventory LedgerLookup → InventoryLedgerThe ledger entry the line posted. Set only by posting; Post Inventory skips lines that already have it, which makes repeated posting safe.
IsILPostedIL PostedBooleanYesNever set by any process and protected against edits; use Inventory Ledger to see whether a line is posted.
IsILPostingApprovedIL Posting ApprovedBooleanYesNot checked by adjustment posting.
ItemComponentIdItem ComponentLookup → ItemComponentA bill-of-materials component reference. No standard process fills it, because Assemble and Disassemble lines generate no component lines.
ItemIdItemLookup → ItemYesThe item corrected. Required; must be active and inventory-tracked. Not editable after saving.
ItemLotIdItem LotLookup → ItemLotThe batch or serial corrected. Required for lot-tracked items, both on save and at posting. Not editable after saving.
ItemLotTypeIdItem Lot TypeLookup → ItemLotTypeThe lot type recorded on the ledger entry.
ModifiedByIdModified ByLookup → UserAccountYes
NameLine NumberTextThe line's number, assigned from the IAL document-name series.
OwnerIdOwnerLookup → UserAccountYes
ParentLineIdParent LineLookup → AdjustmentLineA parent-line reference. No standard process creates child lines; deleting a line also deletes any lines that point to it.
PriceAsOnDatePrice As On DateDateA line-level pricing date. Not on the shipped forms; changing it re-prices the line.
PriceListIdPrice ListLookup → PriceListA line-level price list. Not on the shipped forms; pricing uses the header's price list.
QuantityQuantityNumberThe size of the correction, default 0. Its sign gives the direction for untyped, OnHold, OnLoan and Assemble lines. An untyped line with quantity 0 posts nothing.
RecordTypeIdRecord TypeGuid, hidden
RemarksRemarksTextFree text for the evidence reference. Not on the shipped line forms.
ShortageQuantityShortage QuantityCalculated (calculated)Calculated: equals Quantity when the type is Shortage, otherwise 0. The shortage ledger setting posts from it.
SKUIdSKULookup → SKUThe item's variant, limited to SKUs of the item and required when the item needs one. Not editable after saving.
StorageLocationIdStorage LocationLookup → StorageLocationThe bin whose stock row is corrected. Not on the shipped Quick Add form and not editable after saving, so hand-entered lines post to the stock row with no location unless an administrator adds the field to the form. Lines from a cycle count carry the count line's location.
TotalCostTotal CostCurrencyNot calculated and not filled by posting. Use Quantity times Unit Cost.
UIPropsUI PropsText
UnitCostUnit CostCurrencyThe cost per unit written to the ledger entry. Filled from the matching rule of the header's price list when left empty; a cost typed on a new line is kept. Changing the header's Price As On Date replaces it when a rule matches.
UnitCost2Unit Cost 2CurrencyThe secondary price from the same price-list rule. Not used by posting.
UOMUOMPickListValues: Pack, Litres.
UOM1UOM 1PickListValues: Each.
UOMQuantityUOM QuantityNumber
UOMQuantity1UOM Quantity 1Number
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
DeleteInListDeleteDeleteDelete
EditEditEditEdit
EditInLineEditEditEdit
EditInLineEntityEditEditInlineEdit
NewNewNewNew
NewInLineQuick AddNewInlineNew
PostInventoryPost InventoryUIActionPost from the parent document's Perform Inventory Posting, which picks up every line that has no InventoryLedgerId yet.

Validations

ValidationApplies toError messageNotes
Item Required ValidationItemId, ErrorSelection of Item is Mandatory.Selection of Item is Mandatory.
Quantity Validation On DisassembleError, inactiveQuantity can not be positive in case of Disassemble Adjustment Type.Quantity can not be positive in case of Disassemble Adjustment Type.
Restrict Negative QuantityQuantity, Error, inactiveQuantity must be greater than 0.Quantity must be greater than 0.
Total Cost Rule ValidationTotalCost, ErrorTotal Cost can't be negativeTotal Cost can't be negative
Unit Cost Rule ValidationUnitCost, Error, inactiveUnit Cost can't be negativeUnit Cost can't be negative

Lookup filters

FilterLookup fieldNotes
Sku For ItemSKUId