PriceLevel Class

Properties   Methods   Events   Configuration Settings   Errors  

A PriceLevel is used to specify custom pricing.

Syntax

class inqb.PriceLevel

Remarks

The PriceLevel class may be used to specify custom pricing for specific customers, however you must have QuickBooks 2005 or greater to use Price Levels. Once you create a price level for a customer, QuickBooks will automatically use the custom price in new invoices, sales receipts, sales orders or credit memos for that customer (you can override this automatic feature, however, when you create the invoices, sales receipts, etc).

With qbxml_version set to "4.0" or higher, users can now specify a price level (either added with this component or through QuickBooks) on line items in the following classs: Invoice, SalesReceipt, CreditMemo, and SalesOrder. Please see those classs for more information.

Required Fields (Add): PriceLevelName, PriceLevelFixedPercentage.

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

Example

PriceLevel1.PriceLevelName = "Employee Discount"
PriceLevel1.FixedPercentage = "-15.0"
PriceLevel1.Add()

Price Levels may also be added on a per-item basis using the item_name/item_id, item_custom_price, item_custom_price_percent, item_adjust_percentage, and/or item_adjust_relative_to properties. However, this functionality is only supported in the Premier and Enterprise editions of QuickBooks 2005 and greater.

The PriceLevel class supports a variety of other operations as well. The class's get, update, cancel, and delete methods may be used to retrieve, modify, cancel, and delete PriceLevels, respectively. The ObjSearch Class may be used to search for PriceLevels in the QuickBooks database.