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

Bill Line — entity reference

One line of a supplier bill: an item or a description-only charge, the quantity billed, its cost, discounts and taxes, and the account its cost is posted to. Lines are created by Release Invoice or Selective Release Invoice on a purchase order (linked to the order line, and to each receipt line when goods have arrived), by Release Bill on a goods receipt (linked to the receipt line only), or by hand with Quick Add on the bill's Lines tab. On save a new line keeps a typed unit cost or is priced from the bill's price list, gets tax-group and discount-group rules, its taxes, the item's HSN/SAC code and the vendor's default TDS section. The line's quantity counts as billed on its source order and receipt lines. Saving a line posts no stock: Post Inventory on the bill posts the unposted lines, and later quantity or cost changes re-post them. On a posted bill a financial change to a line reverses and re-posts the bill's journal. Lines are numbered from document numbering (shipped series BL).

Fields

FieldLabelTypeRequiredWhat it does
AccountIdAccountLookup → Account
AmountAmountCalculated (calculated)Base amount less the net discount and net scheme discount: the line's taxable value and the amount posted to its debit account. Calculated.
ApplyPostTaxDiscountApply Post Tax DiscountBooleanYesWhen set, percent discounts are taken on the base amount plus tax instead of the base amount.
BaseAmountBase AmountCalculated (calculated)Quantity times the unit cost (Unit Cost 2 when that is above zero, otherwise Unit Cost). Calculated.
BenefitIdScheme BenefitLookup → SchemeBenefitThe scheme benefit that produced the line's scheme discount, filled by the scheme engine.
BillIdBillLookup → BillThe bill the line belongs to. Set when the line is created and cannot be changed afterwards.
BranchIdBranchCalculated (calculated)The bill's branch, calculated from the bill.
CashDiscountCash DiscountPercentA value here therefore does not reduce Amount, GrossAmount or anything posted.
CashDiscountAmountCash Discount AmountCurrencyThe explicit counterpart of the cash-discount rate, and equally unused: it appears in no discount formula and in no posting path, so recording it changes nothing about the line's value or the ledger. Treat it as documentation of terms, not as an amount that will be taken.
ContractDiscountContract DiscountPercentA contract percent discount, 0 to 100, added to the net discount. Ignored when Contract Discount Amount is above zero.
ContractDiscountAmountContract Discount AmountCurrencyA fixed contract discount amount, used instead of Contract Discount when above zero.
ConversionRatioConversion RatioLargeNumber
ConversionRatio1Conversion Ratio 1LargeNumber
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
DescriptionDescriptionTextFree text for the line. Copied from the purchase-order line on order releases, otherwise typed. Used as the journal narration when the line has no item.
DiscountDiscountPercentPercent discount on the line, 0 to 100. Ignored when Discount Amount is above zero.
Discount2Discount 2DecimalA second percent discount, 0 to 100, added to the net discount. Ignored when Discount Amount 2 is above zero.
DiscountAmountDiscount AmountCurrencyA fixed discount amount. When above zero it is used instead of the Discount percent.
DiscountAmount2Discount Amount 2CurrencyA second fixed discount amount, used instead of Discount 2 when above zero.
EligibleReturnQuantityEligible Return QuantityCalculated (calculated)Quantity less Returned Quantity: what can still be returned. Calculated.
ExternalIdExternalText, unique
GeneralLedgerIdGeneral LedgerLookup → GeneralLedgerA journal reference that cannot be edited by users. The bill's journal is linked to the bill itself.
GLAccountIdGL AccountLookup → GLAccountAn explicit account to debit for the line. Wins over posting definitions and the chart's defaults. Copied from the purchase-order line on order releases. The picker is not filtered by company.
GLAmountGL AmountCalculated (calculated)The amount posted to the general ledger for the line; equal to Amount. Calculated.
GLPostingTypeGL Posting TypePickListDecides the debit account for a line that has no GL Account and no goods-receipt link: the value Inventory debits the inventory account, anything else or blank debits expense. The shipped picklist has no values, so an administrator adds them before users can choose one.
GoodsReceiptLineIdGoods Receipt LineLookup → GoodsReceiptLineThe goods-receipt line this line bills, set by Release Bill or by an order release after receipt. A line with it debits the goods-received-not-invoiced account when posted, and its stock posting moves the quantity off Inward. Cannot change once the line has been saved with a quantity.
GrossAmountGross AmountCalculated (calculated)Amount plus tax, less the discounts again when Apply Post Tax Discount is set. Calculated. Shown as Gross Amount in the lines list.
HsnSacCodeHSN/SAC CodeTextThe HSN or SAC code, copied from the item when the line is created and again when its item changes. For businesses in India a filled-in code must have 4, 6 or 8 digits. On no shipped form.
IdIdGuidYes
InventoryLedgerIdInventory LedgerLookup → InventoryLedgerThe inventory-ledger entry made for the line by Post Inventory. While set, a quantity or cost change re-posts the line's stock and deleting the line reverses it; Post Inventory skips lines that have it.
InvoiceQuantityInvoice QuantityCalculated (calculated)Quantity less Returned Quantity: the quantity still billed after returns. Calculated.
IsCustomerBillableCustomer BillableBooleanYes
IsGLPostedGL PostedBooleanYesA system flag that users cannot edit.
IsGLPostingApprovedGL Posting ApprovedBooleanYes
IsILPostedIL PostedBooleanYes
IsILPostingApprovedIL Posting ApprovedBooleanYes
IsSchemeGeneratedScheme GeneratedBooleanYesSet on lines that the scheme engine itself added to the document.
ItemIdItemLookup → ItemThe item billed. Optional, so a line can be a description-only charge. A new line's item must be active and must not be a discount item. Cannot change once the line has been saved with a quantity, and never on a line that came from a goods receipt.
ItemLotIdItem LotLookup → ItemLotThe stock lot billed. Copied from the goods-receipt line on released lines. Locked like Item.
ItemLotTypeIdItem Lot TypeLookup → ItemLotTypeThe lot type of the line. Copied from the goods-receipt line on released lines.
ItemNameItem NameTextItem name text used as the journal line narration when filled; the item itself is in Item.
ModifiedByIdModified ByLookup → UserAccountYes
NameDocument NumberTextThe line number, generated on create from document numbering (shipped series BL, the date as DDMMYYYY and a six-digit counter). Shown as Bill Line Number in the lines list.
NetDiscountNet DiscountCalculated (calculated)The total of the line's discount, second discount and contract discount, each taken as the fixed amount when set or else the percent of the base amount. Calculated.
NetSchemeDiscountNet Scheme DiscountCalculated (calculated)The scheme discount as an amount: the fixed amount when set, otherwise the percent of the base amount. Calculated.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner AccountCalculated (calculated)The bill's partner account (your company), calculated from the bill.
PriceAsOnDatePrice As On DateDateThe date prices are looked up for. Changing it reprices the line.
PriceListIdPrice ListLookup → PriceListThe price list the line was priced from. Changing it reprices the line.
PriceListRuleIdPrice List RuleLookup → PriceListRuleThe price-list rule that priced the line. Changing it reprices the line.
PurchaseOrderLineIdPurchase Order LineLookup → PurchaseOrderLineThe purchase-order line this line bills, set by Release Invoice. Its quantity counts as billed on that order line. Only lines with this link are counted by the three-way match. Cannot change once the line has been saved with a quantity.
QuantityQuantityLargeNumberThe quantity billed. Required on quick add (a whole number of at least 1). Cannot be negative or lower than the quantity already returned. The sum of bill-line quantities is the billed quantity on the source purchase-order and goods-receipt lines, so changing or deleting it releases quantity back to them.
RecordTypeIdRecord TypeGuid, hidden
ReturnedQuantityReturned QuantityLargeNumberQuantity returned to the supplier against this line, rolled up from the lines of vendor credits (bill returns) that name it. A line with a returned quantity cannot be deleted.
SchemeDiscountScheme DiscountPercentPercent scheme discount, 0 to 100. Bill lines run through the scheme engine like sales lines, which can fill it.
SchemeDiscountAmountScheme Discount AmountCurrencyA fixed scheme discount amount, used instead of the Scheme Discount percent when above zero.
SchemeLineIdScheme LineLookup → SchemeLineThe scheme line that applied to this line, filled by the scheme engine.
SchemeRewardPointsScheme Reward PointsLargeNumber
SkipSchemeSkip SchemeBooleanWhen set, the scheme engine leaves the line out.
SKUIdSKULookup → SKUThe item's SKU. Required when the item requires a SKU, and must be one of the item's SKUs (the picker is filtered to them). Locked like Item.
StorageLocationIdStorage LocationLookup → StorageLocationThe storage location used for the line's stock entry when Post Inventory runs.
Tax1Tax1CurrencyTax amount of the line's first tax component, from its tax group. Tax2 to Tax6 hold the further components (for example cess) the same way.
Tax1NameTax1 NameTextName of the first tax component, such as CGST, copied from the tax group.
Tax1RateTax1 RateCurrencyRate of the first tax component, copied from the tax group.
Tax1TypeTax1 TypeTextType of the first tax component. A component with no type is not posted to the general ledger.
Tax2Tax2Currency
Tax2NameTax2 NameText
Tax2RateTax2 RateCurrency
Tax2TypeTax2 TypeText
Tax3Tax3Currency
Tax3NameTax3 NameText
Tax3RateTax3 RateCurrency
Tax3TypeTax3 TypeText
Tax4Tax4Currency
Tax4NameTax4 NameText
Tax4RateTax4 RateCurrency
Tax4TypeTax4 TypeText
Tax5Tax5Currency
Tax5NameTax5 NameText
Tax5RateTax5 RateCurrency
Tax5TypeTax5 TypeText
Tax6Tax6Currency
Tax6NameTax6 NameText
Tax6RateTax6 RateCurrency
Tax6TypeTax6 TypeText
TaxAmountTax AmountCurrencyThe line's total tax from its tax components. Rounded per document when the Finance tax-rounding setting is Document.
TaxGroupIdTax GroupLookup → TaxGroupThe line's tax group. Its taxes are recalculated when Tax Group, Item, SKU, Quantity or Amount change. Copied from the source line on releases, and cannot be changed on a line that came from a goods receipt.
TdsSectionIdTDS SectionLookup → TdsSectionThe TDS section for withholding on this line, labelled TDS/TCS Section on the form. Defaulted from the vendor's default section on new lines. Tax is deducted when the bill posts if the section's deduction point is the bill, otherwise at payment.
UIPropsUI PropsText
UnitCostUnit CostCurrencyThe cost per unit. A cost typed on a new line is kept; an empty one is filled from the bill's price list when a rule matches. Changing the line's Price List or Price As On Date reprices it and replaces a typed cost. Description-only lines released from a purchase order keep the order's cost.
UnitCost2Unit Cost 2DecimalAn override cost. When above zero it is used instead of Unit Cost for the base amount. Filled from the matching price-list rule's second price when the line is priced; on no shipped form.
UOMUOMTextUnit of measure text for the quantity.
UOM1UOM1PickListAn alternative unit of measure. Quantity is recalculated from the unit quantities when they change.
UOMQuantityUOM QuantityLargeNumberQuantity in the line's unit of measure. Changing it recalculates Quantity.
UOMQuantity1UOM Quantity 1LargeNumberQuantity in the alternative unit of measure. Changing it recalculates Quantity.
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete the selected records.
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
DeleteInListDeleteDeleteDelete in a list page
EditEditEditEdit
EditInEditEditInlineEditInLine
EditInLineEditEditEdit in page.
NewQuick AddNewInlineNew

Validations

ValidationApplies toError messageNotes
Unit Cost Rule ValidationUnitCost, Error, inactiveUnit Cost should not be less than 0Prevents zero or negative unit cost

Lookup filters

FilterLookup fieldNotes
Sku For ItemSKUIdSku For Item