Bill — entity reference

A bill is a supplier's invoice recorded in xMatix: what the company owes a vendor, and the document that turns a purchase into a payable. It appears in the Procurement and Finance apps, on web and mobile. It is released from a purchase order (Release Invoice, Selective Release Invoice), from a goods receipt (Release Bill), or entered directly; item lines are priced from the bill's own price list. It is numbered from document numbering (shipped series BI, separator -, date DDMMYYYY, six digits). Supplier Account, Purchase Order, Partner Account, Branch and Document Date are locked once saved. Post General Ledger writes one balanced journal (debit goods-received-not-invoiced, inventory or expense plus input tax, credit Accounts Payable with the supplier as party), raises a payable open item due on the Due Date, deducts TDS for lines whose section deducts at the bill, and moves Status from Draft to Posted. Post Inventory posts unposted lines to the inventory ledger. A saved financial change to a posted bill re-posts its journal automatically; a posted bill cannot be deleted. Payment progress is read from Open Amount, Adjusted Amount and the Payment summary, not from Status. Step-by-step procedures are on the Bills page of the Procurement documentation.

Fields

Field	Label	Type	Required	What it does
`AccountName`	Account Name	Text		A free-text denormalised party name limited to twenty characters, which is short enough that most real vendor names are truncated. It is not maintained from the linked supplier account, so it can drift; resolve the vendor through SupplierAccountId instead of reading this field.
`AdjustedAmount`	Adjusted Amount	Currency		The total settled against the bill by payment allocations, adjustments and TDS deducted. Open Amount is Total Amount less this value.
`AmountPaid`	Amount Pa	Currency		A system field locked against manual edits; it normally stays empty. Use Open Amount, Adjusted Amount or the Payment summary to see how much of a bill has been paid.
`BillingAddress`	Billing Address	Text
`BillingCity`	Billing City	PickList		Values: Pune, Mumbai, Chandigarh.
`BillingCityId`	Billing City	Lookup → Place		Values: Pune, Chandigarh, Mumbai.
`BillingContactAddressId`	Billing Address	Lookup → ContactAddress		The billing address. Filled from the partner account's default address when left empty.
`BillingCountry`	Billing Country	PickList		Values: India.
`BillingPostalCode`	Billing Postal Code	Text
`BillingRegion`	Billing Region	Text
`BillingState`	Billing State	PickList		Values: New Delhi, Maharashtra, Punjab, Delhi, Haryana.
`BillingStreet`	Billing Street	Text
`BranchId`	Branch	Lookup → Branch		Your branch. Must be active and belong to the partner account; required when the partner account has branches. Locked once saved.
`CreatedById`	Created By	Lookup → UserAccount	Yes
`CreatedDateTime`	Created Date	DateAndTime	Yes
`Description`	Description	Text
`DiscountGroupId`	Discount Group	Lookup → DiscountGroup		The discount group line discounts come from. A purchase-type discount group is chosen automatically on creation.
`DocumentDate`	Document Date	Date		The date the bill is booked in the ledgers and the date of its journal. Releases copy it from the purchase order or goods receipt. Locked once saved.
`DueDate`	Due Date	Date		When the vendor expects payment. Posting copies it onto the payable open item; ageing counts from it, or from the document date when it is empty. Changing it on a posted bill re-posts the journal.
`ExternalId`	External	Text
`GeneralLedgerId`	General Ledger	Lookup → GeneralLedger
`GeneratedById`	Generated By	Lookup
`GLAccountId`	GL Account	Lookup → GLAccount		A header GL account shown on the Details tab. It does not choose the payable account, which is always Accounts Payable on the shipped flow.
`GLAmount`	GL Amount	Calculated		Nominally the header posting amount for a bill, but no calculated formula and no code path populates it. Because a bill that has lines derives its payable leg from the sum of the line amounts plus their tax, the header value is never consulted in practice and the field typically stays at zero.
`GLPostingType`	GL Posting Type	PickList		Selects the account the bill's total is credited to: empty or Credit posts to Accounts Payable. The Cash, Bank and Credit Card values are seeded inactive, so the shipped form always posts to Accounts Payable.
`GoodsReceiptId`	Goods Receipt	Lookup → GoodsReceipt		The goods receipt the bill was released from with Release Bill. Lines of such a bill carry only the goods-receipt-line link, so the three-way match service does not count them.
`Id`	Id	Guid	Yes
`IsBillGenerated`	Bill Generated	Calculated (calculated)	Yes	Labelled Bill Generated: true when every line has been posted to the inventory ledger. The Post Inventory button is hidden once it is true.
`IsGLPosted`	GL Posted	Boolean	Yes	A legacy flag that current posting does not write. Use Status or GL Posting Status to tell whether the journal is posted.
`IsGLPostingApproved`	GL Posting Approved	Boolean		Labelled GL Posting Approved: the posting gate. Post General Ledger sets it before writing the journal. The Post General Ledger button is hidden once it is set.
`IsKPICalculated`	KPI Calculated	Boolean
`IsRCM`	Is RCM	Boolean		Marks a reverse-charge bill. Posting credits the tax portion to the reverse-charge GST payable account instead of Accounts Payable and reduces the payable by that amount. For businesses in India it is defaulted from the supplier when empty.
`ModifiedById`	Modified By	Lookup → UserAccount	Yes
`Name`	Document Number	Text		The bill's document number, generated on save from the bill name setting. The shipped format is BI, a hyphen, the document date as DDMMYYYY, a hyphen and a six-digit counter.
`OpenAmount`	Open Amount	Calculated		What is still owed on the bill: Total Amount less Adjusted Amount.
`OwnerId`	Owner	Lookup → UserAccount	Yes
`PartnerAccountId`	Partner Account	Lookup → Account		Your company, which owes the money. Only active partner accounts can be picked. General-ledger posting happens only when this account has GL posting enabled. Locked once saved; on a bill released from a goods receipt it keeps the receipt's value.
`PaymentTerms`	Payment Terms	Text		The supplier's payment terms as free text. Informational; it does not set the Due Date.
`PerformGLPosting`	Perform GL Posting	Boolean	Yes
`PerformKPICalculation`	Perform KPI Calculation	Boolean
`PlaceOfSupply`	Place of Supply	Calculated (calculated)		The state of supply. For businesses in India it is filled from the supplier when empty. Values: Maharashtra, Gujarat, Rajasthan, Haryana.
`PriceAsOnDate`	Price As On Date	Date		The date prices are taken from. Changing it reprices the bill's lines.
`PriceListId`	Price List	Lookup → PriceList		The purchase price list item lines are priced from when they are created. A purchase-type price list is chosen automatically on creation; the order's or receipt's unit cost is not copied.
`PurchaseOrderId`	Purchase Order	Lookup → PurchaseOrder		The purchase order the bill was released from with Release Invoice or Selective Release Invoice. Locked once saved.
`RecordTypeId`	Record Type	Guid, hidden
`Remarks`	Remarks	Text
`ResourceId`	Executive	Lookup → Resource		Labelled Executive: the person responsible for the bill.
`RoundOff`	Round Off	Currency		A rounding adjustment added to the bill total. Posting a bill with a round-off needs a Rounding posting definition for bills.
`ShippingAddress`	Shipping Address	Text
`ShippingCity`	Shipping City	PickList		Values: Pune, Mumbai, Chandigarh.
`ShippingCityId`	Shipping City	Lookup → Place		Values: Pune, Mumbai, Chandigarh.
`ShippingContactAddressId`	Shipping Address	Lookup → ContactAddress
`ShippingCountry`	Shipping Country	PickList		Values: India.
`ShippingPostalCode`	Shipping Postal Code	Text
`ShippingRegion`	Shipping Region	Text
`ShippingState`	Shipping State	PickList		Values: Maharashtra, New Delhi, Punjab, Delhi, Haryana.
`ShippingStreet`	Shipping Street	Text
`SkipScheme`	Skip Scheme	Boolean	Yes
`SourceOfSupply`	Source of Supply	PickList		The state the goods are supplied to the branch in. For businesses in India it is filled from the branch when empty. Values: Maharashtra, Gujarat, Rajasthan, Haryana.
`Status`	Status	PickList		The bill's posting stage: Draft (the default) or Posted. Posting the bill to the general ledger moves it from Draft, Approved or empty to Posted, and reversing the journal moves it back to Draft. It does not show payment; use Open Amount for that. The system never sets Approved, Rejected or Pending Approval, so the shipped Approved Bills, Pending Bills and Rejected Bills list views stay empty unless a process of your own sets those values. Values: Draft, Approved, Rejected, Posted.
`SupplierAccountId`	Supplier Account	Lookup → Account		The vendor being paid: the party on the Accounts Payable line of the journal and on the payable open item. Only active supplier accounts can be picked. Filled from the branch's default supplier when left empty. Locked once saved.
`SupplierGSTIN`	Supplier GSTIN	Calculated (calculated)		The supplier's GST number, read from the supplier account when Type of Bill is Purchase Bill and empty otherwise.
`SupplierInvoiceAmount`	Supplier Invoice Amount	Currency		The total printed on the vendor's invoice, kept for comparison with the bill's Total Amount. It is not used in posting.
`SupplierInvoiceDate`	Supplier Invoice Date	Date		The date on the vendor's invoice. Input-tax capture for GST returns uses it, falling back to the document date when it is empty.
`SupplierInvoiceNumber`	Supplier Invoice Number	Text		The vendor's own invoice number, as opposed to the bill's document number. Input-tax capture for GST returns uses it, falling back to the document number when it is empty.
`Tax1`	Tax1	Currency
`Tax1Name`	Tax1 Name	Text
`Tax1Rate`	Tax1 Rate	Currency
`Tax1Type`	Tax1 Type	Text
`TaxGroupId`	Tax Group	Lookup → TaxGroup
`TaxId`	Tax	Lookup → Tax
`TaxSupplyType`	Tax Supply Type	PickList		The tax lane: Within State, Outside State, Exempt, Exports or SEZ. For businesses in India it is recalculated on every save from the supplier's GST registration type and whether place and source of supply differ. Values: Within State, Outside State, Exempt, Exports, SEZ.
`TCSEligibleAmount`	TCS Eligible Amount	Currency		The amount on which tax collected at source applies, shown on the Details tab.
`TotalAmount`	Total Amount	Calculated (calculated)		The bill total: the sum of the lines' gross amounts plus Round Off.
`TotalDiscountAmount`	Total Discount Amount	Calculated (calculated)
`TotalLineAmount`	Total Line Amount	Calculated (calculated)
`TotalLineBaseAmount`	Total Line Base Amount	Calculated (calculated)
`TotalLineGrossAmount`	Total Line Gross Amount	Calculated (calculated)
`TotalLineTaxAmount`	Total Line Tax Amount	Calculated (calculated)
`TotalQuantity`	Total Quantity	Calculated (calculated)
`TotalSchemeDiscountAmount`	Total Scheme Discount Amount	Calculated (calculated)
`TotalTaxAmount`	Total Tax Amount 1	Calculated (calculated)
`TotalTaxAmount2`	Total Tax Amount 2	Calculated (calculated)
`TotalTaxAmount3`	Total Tax Amount 3	Calculated (calculated)
`TransactionType`	Transaction Type	PickList		Values: Type 1, Type 2, Type 3.
`TypeOfBill`	Type of Bill	PickList		A classification: Purchase Bill, Expense Bill or OTC Purchase Bill. Posting does not read it; Supplier GSTIN is filled only for Purchase Bill. Values: Expense Bill, OTC Purchase Bill, Purchase Bill.
`UIProps`	UI Props	Text
`UpdatedDateTime`	Modified Date	DateAndTime	Yes

Actions

Action	Label	Type	What it does
`BulkDelete`	Delete	Delete	Delete Selected
`Clone`	Clone	ServerAction (`Clone`)	Create a copy of this record
`Delete`	Delete	Delete	Delete
`DeleteInList`	Delete	Delete	Delete in a list page
`Edit`	Edit	Edit	Edit
`EditDetail`	Edit	EditInline	edit
`EditInLine`	Edit	Edit	Edit in page.
`EditInList`	Edit	EditInline	Edit
`GetOpenDocuments`	Get Open Documents	ServerAction (`GetOpenDocuments`)	A read-only lookup that returns the open documents available to settle against, scoped to the bill's party and branch and to the payment direction, with an optional search key. It creates nothing — it is the picker behind a settlement screen, not a posting step.
`GetPaymentAmountSummary`	Payment	ServerAction (`GetPaymentAmountSummary`)	A read-only summary for the bill: its total, how much has been adjusted, what remains open, and the payments and adjustments making up the difference. Returns data for display only and changes nothing.
`New`	New	New	New
`PerformGLPosting`	Post General Ledger	ServerAction (`PerformGLPosting`)	PostGeneralLedger
`PerformInventoryPosting`	Post Inventory	ServerAction (`PerformInventoryPosting`)	This action perform inventory posting.
`PostAdjustments`	Post Adjustments	ServerAction (`PostAdjustments`)	Bill settlement is recorded as PaymentAdjustment rows or, on the current open-item engine, SettlementAllocation rows against the bill's OpenTransaction.

Lookup filters

Filter	Lookup field	Notes
Branch For Partner Account	`BranchId`
Only Partner Account	`PartnerAccountId`
Only Supplier	`SupplierAccountId`

Account — looks up via SupplierAccountId
Place — looks up via BillingCityId
Tax — looks up via TaxId
UserAccount — looks up via OwnerId
GoodsReceipt — looks up via GoodsReceiptId
Place — looks up via ShippingCityId
ContactAddress — looks up via ShippingContactAddressId
PurchaseOrder — looks up via PurchaseOrderId
PriceList — looks up via PriceListId
TaxGroup — looks up via TaxGroupId
Account — looks up via PartnerAccountId
DiscountGroup — looks up via DiscountGroupId
GLAccount — looks up via GLAccountId
UserAccount — looks up via CreatedById
UserAccount — looks up via ModifiedById
Branch — looks up via BranchId
Resource — looks up via ResourceId
GeneralLedger — looks up via GeneralLedgerId
ContactAddress — looks up via BillingContactAddressId
DebitNoteLine — referenced by via BillId
GSTR3BRule37Tracker — referenced by via BillId
BillLine — referenced by via BillId
Journal — referenced by via SourceRecordId
OpenTransaction — referenced by via SourceRecordId
PaymentAdjustment — referenced by via BillId
Payment — referenced by via BillId
SchemeLedger — referenced by via BillId
GeneralLedger — referenced by via BillId
DebitNote — referenced by via BillId
InterestCharge — referenced by via SourceRecordId
InventoryLedger — referenced by via ParentRecordId
CreditNoteLine — referenced by via BillId

Bill — entity reference

Fields

Actions

Lookup filters

Related entities

Related topics