Bill Component

Properties   Methods   Events   Configuration Settings   Errors  

A Bill indicates that the QuickBooks company owes money to a VENDOR . A Bill is the opposite of a VENDORCREDIT .

Syntax

TiqbBill

Remarks

The Bill component represents a bill received from a Vendor. When a bill is added, the total amount is automatically entered into the Accounts Payable register.

Required Fields (Add): Vendor*, TransactionDate, Items or Expenses

Supported Methods: Add, Get (Id), Cancel, Delete

Example

Bill1.VendorName = "ACME Inc."            '*
Bill1.TransactionDate = "1/17/03"
Bill1.DueDate = "2/01/03"
Bill1.ItemCount = 1
Bill1.ItemName(0) = "ACME Widget X"  '*
Bill1.ItemAmount(0) = "299.95"
Bill1.ExpenseCount = 1
Bill1.ExpenseAccountName(0) = "Shipping"       '*
Bill1.ExpenseAmount(0) = "12.00"
Bill1.Add()

'*: Item must already exist in QuickBooks.

Amount is the total of the item lines and (if present) expense lines. It is computed automatically, and should never be set.

Item Lines: Item lines are used to track the purchase of goods or services. Line items may be added by first setting ItemCount. Then, for each line set the Item ID (or Name), Cost, Quantity, Description, Class, Customer, and Amount.

Note: For advanced users, the entire XML item structure may be set and retrieved through the Item's Aggregate property. However, it is up to the developer to ensure that this aggregate is formatted correctly.

Expense Lines: Expense lines are used to track portions of the total amount to expense accounts. To add expense lines to the transaction, first set ExpenseCount. This will initialize the Expenses array. Each expense will be tracked to the account specified in ExpenseAccount. The ExpenseAmount should also be specified for each expense; optionally, the ExpenseClass, ExpenseCustomer, and ExpenseMemo properties may be set as well.

The component supports a variety of other operations as well. The component's Get, Cancel, and Delete methods may be used to retrieve, cancel, and delete Bills, respectively. The ObjSearch Component may be used to search for Bills in the QuickBooks database.