xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField SalesCRMRewardsClaimsInventoryProcurementWarehouse 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
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 item on a vendor Bill. It mirrors InvoiceLine but is costed rather than priced: BaseAmount is Quantity times UnitCost2 when non-zero else UnitCost. GoodsReceiptLineId decides how the line posts — set, the line clears the goods-received-not-invoiced accrual the receipt already raised, so inventory is not debited twice; unset, the line debits Inventory or Expense according to its GLPostingType. A withholding section on the line drives TDS deduction when the bill is posted.

Fields

FieldLabelTypeRequiredWhat it does
AccountIdAccountLookup → Account
AmountAmountCalculated (calculated)Metadata-calculated as BaseAmount less NetDiscount and NetSchemeDiscount — the net-of-discount, pre-tax line value that rolls into the bill's TotalLineAmount. Unlike the sales-side line it applies the discounts unconditionally, and the post-tax discount switch only affects GrossAmount.
ApplyPostTaxDiscountApply Post Tax DiscountBooleanYes
BaseAmountBase AmountCalculated (calculated)
BenefitIdScheme BenefitLookup → SchemeBenefit
BillIdBillLookup → Bill
BranchIdBranchCalculated (calculated)
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 DiscountPercent
ContractDiscountAmountContract Discount AmountCurrency
ConversionRatioConversion RatioLargeNumber
ConversionRatio1Conversion Ratio 1LargeNumber
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
DescriptionDescriptionText
DiscountDiscountPercent
Discount2Discount 2Decimal
DiscountAmountDiscount AmountCurrency
DiscountAmount2Discount Amount 2Currency
EligibleReturnQuantityEligible Return QuantityCalculated (calculated)
ExternalIdExternalText, unique
GeneralLedgerIdGeneral LedgerLookup → GeneralLedger
GLAccountIdGL AccountLookup → GLAccount
GLAmountGL AmountCalculated (calculated)
GLPostingTypeGL Posting TypePickListDecides the debit account for a line that did not come from a goods receipt: 'Inventory' debits the inventory asset account and anything else debits Expense. It is ignored entirely when the line carries a goods-receipt reference, because such a line instead clears the goods-received-not-invoiced accrual.
GoodsReceiptLineIdGoods Receipt LineLookup → GoodsReceiptLine
GrossAmountGross AmountCalculated (calculated)Metadata-calculated as Amount plus TaxAmount, less the discounts again when the line is flagged for post-tax discounting. It is the tax-inclusive line value and is what the bill's TotalAmount and TotalLineGrossAmount both roll up.
HsnSacCodeHSN/SAC CodeText
IdIdGuidYes
InventoryLedgerIdInventory LedgerLookup → InventoryLedger
InvoiceQuantityInvoice QuantityCalculated (calculated)
IsCustomerBillableCustomer BillableBooleanYes
IsGLPostedGL PostedBooleanYes
IsGLPostingApprovedGL Posting ApprovedBooleanYes
IsILPostedIL PostedBooleanYes
IsILPostingApprovedIL Posting ApprovedBooleanYes
IsSchemeGeneratedScheme GeneratedBooleanYes
ItemIdItemLookup → Item
ItemLotIdItem LotLookup → ItemLot
ItemLotTypeIdItem Lot TypeLookup → ItemLotType
ItemNameItem NameText
ModifiedByIdModified ByLookup → UserAccountYes
NameDocument NumberText
NetDiscountNet DiscountCalculated (calculated)
NetSchemeDiscountNet Scheme DiscountCalculated (calculated)
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner AccountCalculated (calculated)
PriceAsOnDatePrice As On DateDate
PriceListIdPrice ListLookup → PriceList
PriceListRuleIdPrice List RuleLookup → PriceListRule
PurchaseOrderLineIdPurchase Order LineLookup → PurchaseOrderLine
QuantityQuantityLargeNumber
RecordTypeIdRecord TypeGuid, hidden
ReturnedQuantityReturned QuantityLargeNumber
SchemeDiscountScheme DiscountPercent
SchemeDiscountAmountScheme Discount AmountCurrency
SchemeLineIdScheme LineLookup → SchemeLine
SchemeRewardPointsScheme Reward PointsLargeNumber
SkipSchemeSkip SchemeBoolean
SKUIdSKULookup → SKU
StorageLocationIdStorage LocationLookup → StorageLocation
Tax1Tax1Currency
Tax1NameTax1 NameText
Tax1RateTax1 RateCurrency
Tax1TypeTax1 TypeText
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 AmountCurrency
TaxGroupIdTax GroupLookup → TaxGroup
TdsSectionIdTDS SectionLookup → TdsSectionTags the line with a withholding section. New lines with no section inherit the vendor's default section, and explicit tags plus already-saved lines are never overwritten. When the bill posts, a line with a section triggers a withholding entry that debits the payable and credits the withholding liability, reducing what is owed to the vendor; a failure there rolls back the whole posting.
UIPropsUI PropsText
UnitCostUnit CostCurrencyThe purchase cost per unit and the price-equivalent on this entity; BaseAmount is Quantity times UnitCost, unless UnitCost2 is non-zero in which case that wins. A validation rule against zero or negative cost exists but ships inactive.
UnitCost2Unit Cost 2DecimalAn alternate cost taken from the price-list rule's second value, and it takes precedence: BaseAmount uses it whenever it is non-zero and only falls back to UnitCost otherwise.
UOMUOMText
UOM1UOM1PickList
UOMQuantityUOM QuantityLargeNumber
UOMQuantity1UOM Quantity 1LargeNumber
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