SalesOrder Class

Properties   Methods   Events   Config Settings   Errors  

A SalesOrder is used in place of an INVOICE when not all goods have been shipped.

Syntax

SalesOrder

Remarks

This functionality requires a U.S. version of QuickBooks 2003, with the most recent updates from Intuit. The default value for QBXMLVersion for this component is "2.1". If your version of QuickBooks does not support QBXML version 2.1, the class will fail with an error.

Moreover, adding new Sales Orders is a feature of QuickBooks Premier and above; it is not supported in QuickBooks Pro.

A SalesOrder tracks inventory that is on back order for a customer. The operation of the class is similar to that of the Invoice Class.

Required Fields (Add): Customer*, Items

Supported Methods: Add, Get (Id), Delete

Example SalesOrder1.CustomerName = "John Q. Customer" '* SalesOrder1.TransactionDate = "1/17/03" SalesOrder1.ItemCount = 1 SalesOrder1.ItemName(0) = "Our Company's Product" '* SalesOrder1.ItemAmount(0) = "140.00" SalesOrder1.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 ordering of goods or services. To add item lines to the transaction, first set the ItemCount. This will initialize the Items array. For each item you add, set the Item Id (or Name) to an item that has been defined in QuickBooks. The Item Rate/RatePercent, Quantity, Description, Class, TaxCode, and Amount properties may be optionally set for each item as well.

The class supports a variety of other operations as well. The class's Get and Delete methods may be used to retrieve and delete SalesOrders, respectively. The ObjSearch Class may be used to search for SalesOrders in the QuickBooks database.

Property List

The following is the full list of the properties of the class with short descriptions. Click on the links for further details.

Method List

The following is the full list of the methods of the class with short descriptions. Click on the links for further details.

Event List

The following is the full list of the events fired by the class with short descriptions. Click on the links for further details.

Config Settings

The following is a list of config settings for the class with short descriptions. Click on the links for further details.

Amount Property (SalesOrder Class)

Amount of transaction.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetAmount();

Unicode (Windows)
LPWSTR GetAmount();

char* inqb_salesorder_getamount(void* lpObj);

QString GetAmount();

Default Value

""

Remarks

The amount of the transaction. Amount will be total of the amounts in the item lines and (if present) expense lines.

The amount should be formatted as a string in dollars.

This property is read-only.

Data Type

String

BillingAddress Property (SalesOrder Class)

Address to bill to.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetBillingAddress();
int SetBillingAddress(const char* lpszBillingAddress);

Unicode (Windows)
LPWSTR GetBillingAddress();
INT SetBillingAddress(LPCWSTR lpszBillingAddress);

char* inqb_salesorder_getbillingaddress(void* lpObj);
int inqb_salesorder_setbillingaddress(void* lpObj, const char* lpszBillingAddress);

QString GetBillingAddress();
int SetBillingAddress(QString qsBillingAddress);

Default Value

""

Remarks

The address to bill to.

The address is stored as a string, formatted as XML. It may be read and written directly, or with the Address component.

To read an address, set the Aggregate property of an Address class to this value, and read the values of the desired fields. To write an address, write the values of the desired Address fields and set this property to the Address's Aggregate.

To read and/or write directly, use the QBXML formatting: <Addr1>Line1</Addr1><Addr2>Line2</Addr2><Addr3>Line3</Addr3> <City>City</City><State>State</State><PostalCode>PostalCode</PostalCode> <Country>Country</Country>

Data Type

String

CustomerId Property (SalesOrder Class)

A reference to the customer or customer job.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCustomerId();
int SetCustomerId(const char* lpszCustomerId);

Unicode (Windows)
LPWSTR GetCustomerId();
INT SetCustomerId(LPCWSTR lpszCustomerId);

char* inqb_salesorder_getcustomerid(void* lpObj);
int inqb_salesorder_setcustomerid(void* lpObj, const char* lpszCustomerId);

QString GetCustomerId();
int SetCustomerId(QString qsCustomerId);

Default Value

""

Remarks

The Customer property indicates the Customer who has purchased goods or services from the company.

Id/Name Reference Properties

This property is used to reference an object that is already done within QuickBooks. This may be done with its Id (this property) or its full Name, for which a corresponding property is defined.

Using the Id is recommended when feasible, as the Id is guaranteed to never change once defined.

Setting the value of this property will set the corresponding Name property to an empty string.

Either CustomerId or CustomerName is required.

Data Type

String

CustomerMessageId Property (SalesOrder Class)

Reference to message to appear to customer.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCustomerMessageId();
int SetCustomerMessageId(const char* lpszCustomerMessageId);

Unicode (Windows)
LPWSTR GetCustomerMessageId();
INT SetCustomerMessageId(LPCWSTR lpszCustomerMessageId);

char* inqb_salesorder_getcustomermessageid(void* lpObj);
int inqb_salesorder_setcustomermessageid(void* lpObj, const char* lpszCustomerMessageId);

QString GetCustomerMessageId();
int SetCustomerMessageId(QString qsCustomerMessageId);

Default Value

""

Remarks

A reference to a predefined message that will appear to the customer.

Id/Name Reference Properties

This property is used to reference an object that is already done within QuickBooks. This may be done with its Id (this property) or its full Name, for which a corresponding property is defined.

Using the Id is recommended when feasible, as the Id is guaranteed to never change once defined.

Setting the value of this property will set the corresponding Name property to an empty string.

Data Type

String

CustomerMessageName Property (SalesOrder Class)

Reference to message to appear to customer.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCustomerMessageName();
int SetCustomerMessageName(const char* lpszCustomerMessageName);

Unicode (Windows)
LPWSTR GetCustomerMessageName();
INT SetCustomerMessageName(LPCWSTR lpszCustomerMessageName);

char* inqb_salesorder_getcustomermessagename(void* lpObj);
int inqb_salesorder_setcustomermessagename(void* lpObj, const char* lpszCustomerMessageName);

QString GetCustomerMessageName();
int SetCustomerMessageName(QString qsCustomerMessageName);

Default Value

""

Remarks

A reference to a predefined message that will appear to the customer.

Name/Id Reference Properties

This property is used to reference an object that is already done within QuickBooks. This may be done with its full Name (this property) or its Id, for which a corresponding property is defined. If Name is used, it must contain the full name of the object referred to, as generated by QuickBooks. For hierarchically defined objects, such as Customers, this includes the names of parent objects, and the full name can be determined by reading the FullName special field.

Setting the value of this property will set the corresponding Id property to an empty string.

Data Type

String

CustomerName Property (SalesOrder Class)

A reference to the customer or customer job.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCustomerName();
int SetCustomerName(const char* lpszCustomerName);

Unicode (Windows)
LPWSTR GetCustomerName();
INT SetCustomerName(LPCWSTR lpszCustomerName);

char* inqb_salesorder_getcustomername(void* lpObj);
int inqb_salesorder_setcustomername(void* lpObj, const char* lpszCustomerName);

QString GetCustomerName();
int SetCustomerName(QString qsCustomerName);

Default Value

""

Remarks

The Customer property indicates the Customer who has purchased goods or services from the company.

Name/Id Reference Properties

This property is used to reference an object that is already done within QuickBooks. This may be done with its full Name (this property) or its Id, for which a corresponding property is defined. If Name is used, it must contain the full name of the object referred to, as generated by QuickBooks. For hierarchically defined objects, such as Customers, this includes the names of parent objects, and the full name can be determined by reading the FullName special field.

Setting the value of this property will set the corresponding Id property to an empty string.

Either CustomerId or CustomerName is required.

Data Type

String

DueDate Property (SalesOrder Class)

Date when payment is due.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetDueDate();
int SetDueDate(const char* lpszDueDate);

Unicode (Windows)
LPWSTR GetDueDate();
INT SetDueDate(LPCWSTR lpszDueDate);

char* inqb_salesorder_getduedate(void* lpObj);
int inqb_salesorder_setduedate(void* lpObj, const char* lpszDueDate);

QString GetDueDate();
int SetDueDate(QString qsDueDate);

Default Value

""

Remarks

Appears in a variety of transactions. The date when payment is due.

The standard formatting for dates is YYYY-MM-DD; i.e., September 2, 2002 is formatted as 2002-09-02. When getting the value of a date property, the date will always be in this format.

When setting the value of a date property, the formats MM-DD-YY, MM-DD-YYYY, MM/DD/YY, and MM/DD/YYYY are also acceptable. Dates in these formats will be automatically parsed and stored in YYYY-MM-DD format.

Data Type

String

IncludeLinkedTxns Property (SalesOrder Class)

Indicates whether to include linked transactions in the response.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetIncludeLinkedTxns();
int SetIncludeLinkedTxns(int bIncludeLinkedTxns);

Unicode (Windows)
BOOL GetIncludeLinkedTxns();
INT SetIncludeLinkedTxns(BOOL bIncludeLinkedTxns);

int inqb_salesorder_getincludelinkedtxns(void* lpObj);
int inqb_salesorder_setincludelinkedtxns(void* lpObj, int bIncludeLinkedTxns);

bool GetIncludeLinkedTxns();
int SetIncludeLinkedTxns(bool bIncludeLinkedTxns);

Default Value

FALSE

Remarks

If you set IncludeLinkedTxns to true, then the returned object will include a list of all the transactions linked to the queried object (this list is similar to the History view of a transaction in the user interface, but not identical, as the SDK list contains only linked transactions, not items). Each linked transaction will be represented by a LinkedTxn aggregate, which will be parsed by the class into the following properties:

• LinkedTxnCount
• LinkedTxnAmount
• LinkedTxnDate
• LinkedTxnId
• LinkedTxnLinkType
• LinkedTxnRefNumber
• LinkedTxnType

Data Type

Boolean

IsFullyInvoiced Property (SalesOrder Class)

Whether the sales order is fully invoiced.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetIsFullyInvoiced();

Unicode (Windows)
BOOL GetIsFullyInvoiced();

int inqb_salesorder_getisfullyinvoiced(void* lpObj);

bool GetIsFullyInvoiced();

Default Value

FALSE

Remarks

If true, all line items in the sales order have been fully invoiced.

This property is read-only.

Data Type

Boolean

IsToBePrinted Property (SalesOrder Class)

Whether this transaction is to be printed.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetIsToBePrinted();
int SetIsToBePrinted(int bIsToBePrinted);

Unicode (Windows)
BOOL GetIsToBePrinted();
INT SetIsToBePrinted(BOOL bIsToBePrinted);

int inqb_salesorder_getistobeprinted(void* lpObj);
int inqb_salesorder_setistobeprinted(void* lpObj, int bIsToBePrinted);

bool GetIsToBePrinted();
int SetIsToBePrinted(bool bIsToBePrinted);

Default Value

FALSE

Remarks

Indicates whether or not the transaction is to be printed. If set to true, the "To Be Printed" box in the QuickBooks user interface will be checked.

Data Type

Boolean

ItemCount Property (SalesOrder Class)

The number of records in the Item arrays.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetItemCount();
int SetItemCount(int iItemCount);

Unicode (Windows)
INT GetItemCount();
INT SetItemCount(INT iItemCount);

int inqb_salesorder_getitemcount(void* lpObj);
int inqb_salesorder_setitemcount(void* lpObj, int iItemCount);

int GetItemCount();
int SetItemCount(int iItemCount);

Default Value

0

Remarks

This property controls the size of the following arrays:

• ItemAggregate
• ItemAmount
• ItemClassId
• ItemClassName
• ItemDescription
• ItemGroupId
• ItemGroupName
• ItemId
• ItemInvoicedAmount
• ItemLineId
• ItemManuallyClosed
• ItemName
• ItemOther1
• ItemOther2
• ItemPriceLevelId
• ItemPriceLevelName
• ItemQuantity
• ItemRate
• ItemRatePercent
• ItemTaxCodeId
• ItemTaxCodeName
• ItemUnitOfMeasure

The array indices start at 0 and end at ItemCount - 1.

This property is not available at design time.

Data Type

Integer

ItemAggregate Property (SalesOrder Class)

Contains an XML aggregate of the line item.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemAggregate(int iItemIndex);
int SetItemAggregate(int iItemIndex, const char* lpszItemAggregate);

Unicode (Windows)
LPWSTR GetItemAggregate(INT iItemIndex);
INT SetItemAggregate(INT iItemIndex, LPCWSTR lpszItemAggregate);

char* inqb_salesorder_getitemaggregate(void* lpObj, int itemindex);
int inqb_salesorder_setitemaggregate(void* lpObj, int itemindex, const char* lpszItemAggregate);

QString GetItemAggregate(int iItemIndex);
int SetItemAggregate(int iItemIndex, QString qsItemAggregate);

Default Value

""

Remarks

Contains an XML aggregate of the line item. If the line item has not been modified since receiving a response from QuickBooks, the exact LineRet aggregate that QuickBooks returned will be contained in this XML aggregate. However, if you have made changes to the this line item's properties the ItemAggregate property will re-generate the line item XML with the new data.

If you set the other line item properties and then query the ItemAggregate, a LineRet aggregate will be generated from the currently set properties.

You may set this property with raw xml. So long as you do not modify any other properties (forcing the line item to regenerate based on new changes), the xml will be sent as-is to the QuickBooks request processor. It is essential that you properly format the XML that you place in this property. When setting this property manually, the class will send exactly what you have set. You must ensure your xml is appropriate for the action you are attempting. For instance, if you are Adding an Invoice, you must ensure the outer tags are "InvoiceLineAdd". If Modifying an Invoice, the outer tags must be "InvoiceLineMod".

If you do not expressly set the ItemAggregate field with your own custom XML, all of this will be taken care of you automatically by the class.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

ItemAmount Property (SalesOrder Class)

Line item property: the total amount of this item.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemAmount(int iItemIndex);
int SetItemAmount(int iItemIndex, const char* lpszItemAmount);

Unicode (Windows)
LPWSTR GetItemAmount(INT iItemIndex);
INT SetItemAmount(INT iItemIndex, LPCWSTR lpszItemAmount);

char* inqb_salesorder_getitemamount(void* lpObj, int itemindex);
int inqb_salesorder_setitemamount(void* lpObj, int itemindex, const char* lpszItemAmount);

QString GetItemAmount(int iItemIndex);
int SetItemAmount(int iItemIndex, QString qsItemAmount);

Default Value

""

Remarks

Line item property: the total amount of this item.

This property represents the total amount of a transaction line. If ItemRate, ItemCost and/or ItemQuantity are specified the ItemAmount will be automatically computed by QuickBooks.

Whether ItemRate or ItemCost is used will depend on the transaction type. ItemRate is available for CreditMemo, Estimate, Invoice, PurchaseOrder, SalesOrder, and SalesReceipt transactions while ItemCost is available for Bill, CCCharge, CCCredit, Check, ItemReceipt, and VendorCredit transactions.

The amount should be formatted as a string in dollars.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

ItemClassId Property (SalesOrder Class)

Line item property: Reference to the class of the item.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemClassId(int iItemIndex);
int SetItemClassId(int iItemIndex, const char* lpszItemClassId);

Unicode (Windows)
LPWSTR GetItemClassId(INT iItemIndex);
INT SetItemClassId(INT iItemIndex, LPCWSTR lpszItemClassId);

char* inqb_salesorder_getitemclassid(void* lpObj, int itemindex);
int inqb_salesorder_setitemclassid(void* lpObj, int itemindex, const char* lpszItemClassId);

QString GetItemClassId(int iItemIndex);
int SetItemClassId(int iItemIndex, QString qsItemClassId);

Default Value

""

Remarks

Line item property: Reference to the class of the item.

A reference to the class of this item.

Id/Name Reference Properties

This property is used to reference an object that is already done within QuickBooks. This may be done with its Id (this property) or its full Name, for which a corresponding property is defined.

Using the Id is recommended when feasible, as the Id is guaranteed to never change once defined.

Setting the value of this property will set the corresponding Name property to an empty string.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

ItemClassName Property (SalesOrder Class)

Line item property: Reference to the class of the item.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemClassName(int iItemIndex);
int SetItemClassName(int iItemIndex, const char* lpszItemClassName);

Unicode (Windows)
LPWSTR GetItemClassName(INT iItemIndex);
INT SetItemClassName(INT iItemIndex, LPCWSTR lpszItemClassName);

char* inqb_salesorder_getitemclassname(void* lpObj, int itemindex);
int inqb_salesorder_setitemclassname(void* lpObj, int itemindex, const char* lpszItemClassName);

QString GetItemClassName(int iItemIndex);
int SetItemClassName(int iItemIndex, QString qsItemClassName);

Default Value

""

Remarks

Line item property: Reference to the class of the item.

Name/Id Reference Properties

This property is used to reference an object that is already done within QuickBooks. This may be done with its full Name (this property) or its Id, for which a corresponding property is defined. If Name is used, it must contain the full name of the object referred to, as generated by QuickBooks. For hierarchically defined objects, such as Customers, this includes the names of parent objects, and the full name can be determined by reading the FullName special field.

Setting the value of this property will set the corresponding Id property to an empty string.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

ItemDescription Property (SalesOrder Class)

Line item property: Description of item.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemDescription(int iItemIndex);
int SetItemDescription(int iItemIndex, const char* lpszItemDescription);

Unicode (Windows)
LPWSTR GetItemDescription(INT iItemIndex);
INT SetItemDescription(INT iItemIndex, LPCWSTR lpszItemDescription);

char* inqb_salesorder_getitemdescription(void* lpObj, int itemindex);
int inqb_salesorder_setitemdescription(void* lpObj, int itemindex, const char* lpszItemDescription);

QString GetItemDescription(int iItemIndex);
int SetItemDescription(int iItemIndex, QString qsItemDescription);

Default Value

""

Remarks

Line item property: Description of item.

A string description of the Item specified by ItemName or ItemId.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

ItemGroupId Property (SalesOrder Class)

Reference to a group of line items.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemGroupId(int iItemIndex);
int SetItemGroupId(int iItemIndex, const char* lpszItemGroupId);

Unicode (Windows)
LPWSTR GetItemGroupId(INT iItemIndex);
INT SetItemGroupId(INT iItemIndex, LPCWSTR lpszItemGroupId);

char* inqb_salesorder_getitemgroupid(void* lpObj, int itemindex);
int inqb_salesorder_setitemgroupid(void* lpObj, int itemindex, const char* lpszItemGroupId);

QString GetItemGroupId(int iItemIndex);
int SetItemGroupId(int iItemIndex, QString qsItemGroupId);

Default Value

""

Remarks

Reference to a group of line items.

Line item groups represent sets of items that are grouped together. A line item group is a predefined shortcut within QuickBooks. For example, a "Cheeseburger Meal" might consist of a cheeseburger, an order of french fries, and a soft drink. To include an item group in a transaction one should simply set the value of ItemGroup, and optionally, of ItemQuantity. QuickBooks will automatically expand the group into its constituent items. This will send an ItemGroup instead of a regular Item on for this index.

When an ItemGroup is returned from QuickBooks it contains xml aggregates of all of the items in the group you specified. You may access the group's regular properties (total ItemAmount, ItemQuantity, and ItemDescription), but the line items returned are not accessible with this object. However, you may parse the returned line items by passing the contents of the ItemAggregate property to the LineItemGroups class. You may use the LineItemGroups class to view or change the contents of the line items, and then pass the xml aggregate generated by the class back to the ItemAggregate field to use in an Update transaction.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

ItemGroupName Property (SalesOrder Class)

Reference to a group of line items.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemGroupName(int iItemIndex);
int SetItemGroupName(int iItemIndex, const char* lpszItemGroupName);

Unicode (Windows)
LPWSTR GetItemGroupName(INT iItemIndex);
INT SetItemGroupName(INT iItemIndex, LPCWSTR lpszItemGroupName);

char* inqb_salesorder_getitemgroupname(void* lpObj, int itemindex);
int inqb_salesorder_setitemgroupname(void* lpObj, int itemindex, const char* lpszItemGroupName);

QString GetItemGroupName(int iItemIndex);
int SetItemGroupName(int iItemIndex, QString qsItemGroupName);

Default Value

""

Remarks

Reference to a group of line items.

Line item groups represent sets of items that are grouped together. A line item group is a predefined shortcut within QuickBooks. For example, a "Cheeseburger Meal" might consist of a cheeseburger, an order of french fries, and a soft drink. To include an item group in a transaction one should simply set the value of ItemGroup, and optionally, of ItemQuantity. QuickBooks will automatically expand the group into its constituent items. This will send an ItemGroup instead of a regular Item on for this index.

When an ItemGroup is returned from QuickBooks it contains xml aggregates of all of the items in the group you specified. You may access the group's regular properties (total ItemAmount, ItemQuantity, and ItemDescription), but the line items returned are not accessible with this object. However, you may parse the returned line items by passing the contents of the ItemAggregate property to the LineItemGroups class. You may use the LineItemGroups class to view or change the contents of the line items, and then pass the xml aggregate generated by the class back to the ItemAggregate field to use in an Update transaction.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

ItemInvoicedAmount Property (SalesOrder Class)

The amount of this sales order line that has been invoiced.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemInvoicedAmount(int iItemIndex);

Unicode (Windows)
LPWSTR GetItemInvoicedAmount(INT iItemIndex);

char* inqb_salesorder_getiteminvoicedamount(void* lpObj, int itemindex);

QString GetItemInvoicedAmount(int iItemIndex);

Default Value

""

Remarks

The amount of this sales order line that has been invoiced. The amount should be formatted as a string in dollars.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is read-only and not available at design time.

Data Type

String

ItemId Property (SalesOrder Class)

Line item property: Reference to the kind of item.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemId(int iItemIndex);
int SetItemId(int iItemIndex, const char* lpszItemId);

Unicode (Windows)
LPWSTR GetItemId(INT iItemIndex);
INT SetItemId(INT iItemIndex, LPCWSTR lpszItemId);

char* inqb_salesorder_getitemid(void* lpObj, int itemindex);
int inqb_salesorder_setitemid(void* lpObj, int itemindex, const char* lpszItemId);

QString GetItemId(int iItemIndex);
int SetItemId(int iItemIndex, QString qsItemId);

Default Value

""

Remarks

Line item property: Reference to the kind of item.

Line items represent goods or services bought in a QuickBooks transaction.

Each line item is represented by a number of properties, each prefixed by Item (see the list of properties for individual classs for details). Properties such as ItemQuantity and ItemDescription are always present; some properties are found in only certain types of transactions.

Item is a reference to a kind of item, predefined within QuickBooks. Generally items defined within QuickBooks have default values for ItemDescription, etc., and if only Item is set when adding a record to QuickBooks, the other properties will be set automatically.

This class is used to create a single item. However, any InQB class may be set with an unlimited number of these items. For example:

Invoice.ItemCount = 3 LineItems.ItemName = "Wingnut" LineItems.Quantity = 8 Invoice.ItemAggregate[0] = LineItems.GetAggregate() LineItems.ItemName = "Shovel" LineItems.Quantity = 1 Invoice.ItemAggregate[1] = LineItems.GetAggregate() LineItems.ItemName = "Mower blade" LineItems.Quantity = 1 Invoice.ItemAggregate[2] = LineItems.GetAggregate()

Items may also be grouped into ItemGroups, using the LineItemGroups class.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

ItemName Property (SalesOrder Class)

Line item property: Reference to the kind of item.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemName(int iItemIndex);
int SetItemName(int iItemIndex, const char* lpszItemName);

Unicode (Windows)
LPWSTR GetItemName(INT iItemIndex);
INT SetItemName(INT iItemIndex, LPCWSTR lpszItemName);

char* inqb_salesorder_getitemname(void* lpObj, int itemindex);
int inqb_salesorder_setitemname(void* lpObj, int itemindex, const char* lpszItemName);

QString GetItemName(int iItemIndex);
int SetItemName(int iItemIndex, QString qsItemName);

Default Value

""

Remarks

Line item property: Reference to the kind of item.

Line items represent goods or services bought in a QuickBooks transaction.

Each line item is represented by a number of properties, each prefixed by Item (see the list of properties for individual classs for details). Properties such as ItemQuantity and ItemDescription are always present; some properties are found in only certain types of transactions.

Item is a reference to a kind of item, predefined within QuickBooks. Generally items defined within QuickBooks have default values for ItemDescription, etc., and if only Item is set when adding a record to QuickBooks, the other properties will be set automatically.

This class is used to create a single item. However, any InQB class may be set with an unlimited number of these items. For example:

Invoice.ItemCount = 3 LineItems.ItemName = "Wingnut" LineItems.Quantity = 8 Invoice.ItemAggregate[0] = LineItems.GetAggregate() LineItems.ItemName = "Shovel" LineItems.Quantity = 1 Invoice.ItemAggregate[1] = LineItems.GetAggregate() LineItems.ItemName = "Mower blade" LineItems.Quantity = 1 Invoice.ItemAggregate[2] = LineItems.GetAggregate()

Items may also be grouped into ItemGroups, using the LineItemGroups class.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

ItemLineId Property (SalesOrder Class)

Identification number of the transaction line, used for Updates.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemLineId(int iItemIndex);
int SetItemLineId(int iItemIndex, const char* lpszItemLineId);

Unicode (Windows)
LPWSTR GetItemLineId(INT iItemIndex);
INT SetItemLineId(INT iItemIndex, LPCWSTR lpszItemLineId);

char* inqb_salesorder_getitemlineid(void* lpObj, int itemindex);
int inqb_salesorder_setitemlineid(void* lpObj, int itemindex, const char* lpszItemLineId);

QString GetItemLineId(int iItemIndex);
int SetItemLineId(int iItemIndex, QString qsItemLineId);

Default Value

""

Remarks

Identification number of the transaction line, used for Updates.

If you need to add a new transaction line in a transaction Update request, you can do so by setting the ItemLineId to -1.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

ItemManuallyClosed Property (SalesOrder Class)

Indicates if the line item has been manually closed.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetItemManuallyClosed(int iItemIndex);
int SetItemManuallyClosed(int iItemIndex, int iItemManuallyClosed);

Unicode (Windows)
INT GetItemManuallyClosed(INT iItemIndex);
INT SetItemManuallyClosed(INT iItemIndex, INT iItemManuallyClosed);

MC_NOT_SET(0), 
MC_MANUALLY_CLOSED(1), 
MC_NOT_MANUALLY_CLOSED(2)

int inqb_salesorder_getitemmanuallyclosed(void* lpObj, int itemindex);
int inqb_salesorder_setitemmanuallyclosed(void* lpObj, int itemindex, int iItemManuallyClosed);

int GetItemManuallyClosed(int iItemIndex);
int SetItemManuallyClosed(int iItemIndex, int iItemManuallyClosed);

Default Value

0

Remarks

Indicates if the line item has been manually closed.

If ItemManuallyClosed is mcManuallyClosed, the purchase order line has been closed, even if this item has not been received or its sale canceled. If all the purchase order lines are marked as closed, the purchase order itself is marked as closed as well. You cannot change ItemManuallyClosed to mcNotManuallyClosed after the purchase order line has been fully received. If set to mcNotSet the field is not sent in the request.

Only applicable to Update transactions.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

Integer

ItemOther1 Property (SalesOrder Class)

Standard QuickBooks Custom Field available for transaction line items.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemOther1(int iItemIndex);
int SetItemOther1(int iItemIndex, const char* lpszItemOther1);

Unicode (Windows)
LPWSTR GetItemOther1(INT iItemIndex);
INT SetItemOther1(INT iItemIndex, LPCWSTR lpszItemOther1);

char* inqb_salesorder_getitemother1(void* lpObj, int itemindex);
int inqb_salesorder_setitemother1(void* lpObj, int itemindex, const char* lpszItemOther1);

QString GetItemOther1(int iItemIndex);
int SetItemOther1(int iItemIndex, QString qsItemOther1);

Default Value

""

Remarks

Standard QuickBooks Custom Field available for transaction line items.

The ItemOther1 and ItemOther2 custom fields are available for immediate use: you don't need to enable these in the transaction template to be able to access them via SDK. (However, those ItemOther1 and ItemOther2 fields and their values are viewable and printable in QuickBooks only if the transaction template has these enabled!). QBXMLVersion 6.0 or higher is required to use this property.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

ItemOther2 Property (SalesOrder Class)

Standard QuickBooks Custom Field available for transaction line items.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemOther2(int iItemIndex);
int SetItemOther2(int iItemIndex, const char* lpszItemOther2);

Unicode (Windows)
LPWSTR GetItemOther2(INT iItemIndex);
INT SetItemOther2(INT iItemIndex, LPCWSTR lpszItemOther2);

char* inqb_salesorder_getitemother2(void* lpObj, int itemindex);
int inqb_salesorder_setitemother2(void* lpObj, int itemindex, const char* lpszItemOther2);

QString GetItemOther2(int iItemIndex);
int SetItemOther2(int iItemIndex, QString qsItemOther2);

Default Value

""

Remarks

Standard QuickBooks Custom Field available for transaction line items.

The ItemOther1 and ItemOther2 custom fields are available for immediate use: you don't need to enable these in the transaction template to be able to access them via SDK. (However, those ItemOther1 and ItemOther2 fields and their values are viewable and printable in QuickBooks only if the transaction template has these enabled!). QBXMLVersion 6.0 or higher is required to use this property.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

ItemPriceLevelId Property (SalesOrder Class)

Line Item property: Used to specify custom pricing for specific customers.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemPriceLevelId(int iItemIndex);
int SetItemPriceLevelId(int iItemIndex, const char* lpszItemPriceLevelId);

Unicode (Windows)
LPWSTR GetItemPriceLevelId(INT iItemIndex);
INT SetItemPriceLevelId(INT iItemIndex, LPCWSTR lpszItemPriceLevelId);

char* inqb_salesorder_getitempricelevelid(void* lpObj, int itemindex);
int inqb_salesorder_setitempricelevelid(void* lpObj, int itemindex, const char* lpszItemPriceLevelId);

QString GetItemPriceLevelId(int iItemIndex);
int SetItemPriceLevelId(int iItemIndex, QString qsItemPriceLevelId);

Default Value

""

Remarks

Line Item property: Used to specify custom pricing for specific customers.

Id for the PriceLevel selected for this transaction.

If ItemPriceLevelId and/or ItemPriceLevelName are specified, then ItemAmount will be calculated automatically and should not be specified.

Note that ItemPriceLevelId and ItemPriceLevelName, OR ItemRate OR ItemRatePercent may be specified. ItemPriceLevelId and ItemPriceLevelName are ONLY available for QBXMLVersions 4.0 and above.

You can use price levels to specify custom pricing for specific customers. 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.)

The user can now specify a price level on line items in the following supported sales transactions: invoices, sales receipts, credit memos, and sales orders.

Notice that the response data for the affected sales transaction does not list the price level that was used. The response simply lists the ItemRate, which was set using the price level.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

ItemPriceLevelName Property (SalesOrder Class)

Line Item property: Specify custom pricing for specific customers.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemPriceLevelName(int iItemIndex);
int SetItemPriceLevelName(int iItemIndex, const char* lpszItemPriceLevelName);

Unicode (Windows)
LPWSTR GetItemPriceLevelName(INT iItemIndex);
INT SetItemPriceLevelName(INT iItemIndex, LPCWSTR lpszItemPriceLevelName);

char* inqb_salesorder_getitempricelevelname(void* lpObj, int itemindex);
int inqb_salesorder_setitempricelevelname(void* lpObj, int itemindex, const char* lpszItemPriceLevelName);

QString GetItemPriceLevelName(int iItemIndex);
int SetItemPriceLevelName(int iItemIndex, QString qsItemPriceLevelName);

Default Value

""

Remarks

Line Item property: Specify custom pricing for specific customers.

Id for the PriceLevel selected for this transaction.

If ItemPriceLevelId and/or ItemPriceLevelName are specified, then ItemAmount will be calculated automatically and should not be specified.

Note that ItemPriceLevelId and ItemPriceLevelName, OR ItemRate OR ItemRatePercent may be specified. ItemPriceLevelId and ItemPriceLevelName are ONLY available for QBXMLVersions 4.0 and above.

You can use price levels to specify custom pricing for specific customers. 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.)

The user can now specify a price level on line items in the following supported sales transactions: invoices, sales receipts, credit memos, and sales orders.

Notice that the response data for the affected sales transaction does not list the price level that was used. The response simply lists the ItemRate, which was set using the price level.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

ItemQuantity Property (SalesOrder Class)

Line item property: Quantity of item or item group.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemQuantity(int iItemIndex);
int SetItemQuantity(int iItemIndex, const char* lpszItemQuantity);

Unicode (Windows)
LPWSTR GetItemQuantity(INT iItemIndex);
INT SetItemQuantity(INT iItemIndex, LPCWSTR lpszItemQuantity);

char* inqb_salesorder_getitemquantity(void* lpObj, int itemindex);
int inqb_salesorder_setitemquantity(void* lpObj, int itemindex, const char* lpszItemQuantity);

QString GetItemQuantity(int iItemIndex);
int SetItemQuantity(int iItemIndex, QString qsItemQuantity);

Default Value

""

Remarks

Line item property: Quantity of item or item group.

The quantity of the Item specified in this line.

If ItemQuantity and only one of ItemCost, ItemRate, or ItemAmount are specified, QuickBooks will automatically calculate the other.

This property is a String type in order to allow setting fractional quantities. Setting this property with non-numeric data will cause an error. Correct usage of this property is shown below:

class.Quantity = "3.5"

Leave this property blank and no quantity will be sent to QuickBooks.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

ItemRate Property (SalesOrder Class)

Unit rate of item.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemRate(int iItemIndex);
int SetItemRate(int iItemIndex, const char* lpszItemRate);

Unicode (Windows)
LPWSTR GetItemRate(INT iItemIndex);
INT SetItemRate(INT iItemIndex, LPCWSTR lpszItemRate);

char* inqb_salesorder_getitemrate(void* lpObj, int itemindex);
int inqb_salesorder_setitemrate(void* lpObj, int itemindex, const char* lpszItemRate);

QString GetItemRate(int iItemIndex);
int SetItemRate(int iItemIndex, QString qsItemRate);

Default Value

""

Remarks

Unit rate of item.

The unit rate charged for this item.

If ItemAmount is specified, then ItemRate will be calculated automatically and should not be specified.

The amount should be formatted as a string in dollars.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

ItemRatePercent Property (SalesOrder Class)

Line item property: A markup or discount percentage.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemRatePercent(int iItemIndex);
int SetItemRatePercent(int iItemIndex, const char* lpszItemRatePercent);

Unicode (Windows)
LPWSTR GetItemRatePercent(INT iItemIndex);
INT SetItemRatePercent(INT iItemIndex, LPCWSTR lpszItemRatePercent);

char* inqb_salesorder_getitemratepercent(void* lpObj, int itemindex);
int inqb_salesorder_setitemratepercent(void* lpObj, int itemindex, const char* lpszItemRatePercent);

QString GetItemRatePercent(int iItemIndex);
int SetItemRatePercent(int iItemIndex, QString qsItemRatePercent);

Default Value

""

Remarks

Line item property: A markup or discount percentage.

If ItemRatePercent is specified instead of ItemRate, then this line item represents a percentage markup or discount, to be applied to the previous Item or Item group.

ItemRatePercent should be formatted as a positive or negative integer; a positive value indicates a markup.

Only one of ItemRatePercent and ItemRate may be specified. If ItemRatePercent is set, then ItemRate will be set to its default.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

ItemTaxCodeId Property (SalesOrder Class)

Line item property: Sales tax information for this item.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemTaxCodeId(int iItemIndex);
int SetItemTaxCodeId(int iItemIndex, const char* lpszItemTaxCodeId);

Unicode (Windows)
LPWSTR GetItemTaxCodeId(INT iItemIndex);
INT SetItemTaxCodeId(INT iItemIndex, LPCWSTR lpszItemTaxCodeId);

char* inqb_salesorder_getitemtaxcodeid(void* lpObj, int itemindex);
int inqb_salesorder_setitemtaxcodeid(void* lpObj, int itemindex, const char* lpszItemTaxCodeId);

QString GetItemTaxCodeId(int iItemIndex);
int SetItemTaxCodeId(int iItemIndex, QString qsItemTaxCodeId);

Default Value

""

Remarks

Line item property: Sales tax information for this item.

This is a reference to a sales tax code predefined within QuickBooks.

By default, two standard TaxCodes exist: "TAX", or Taxable Sales, and "NON", or Non-Taxable Sales. The QuickBooks user may also define custom tax codes.

Id/Name Reference Properties

This property is used to reference an object that is already done within QuickBooks. This may be done with its Id (this property) or its full Name, for which a corresponding property is defined.

Using the Id is recommended when feasible, as the Id is guaranteed to never change once defined.

Setting the value of this property will set the corresponding Name property to an empty string.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

ItemTaxCodeName Property (SalesOrder Class)

Line item property: Sales tax information for this item.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemTaxCodeName(int iItemIndex);
int SetItemTaxCodeName(int iItemIndex, const char* lpszItemTaxCodeName);

Unicode (Windows)
LPWSTR GetItemTaxCodeName(INT iItemIndex);
INT SetItemTaxCodeName(INT iItemIndex, LPCWSTR lpszItemTaxCodeName);

char* inqb_salesorder_getitemtaxcodename(void* lpObj, int itemindex);
int inqb_salesorder_setitemtaxcodename(void* lpObj, int itemindex, const char* lpszItemTaxCodeName);

QString GetItemTaxCodeName(int iItemIndex);
int SetItemTaxCodeName(int iItemIndex, QString qsItemTaxCodeName);

Default Value

""

Remarks

Line item property: Sales tax information for this item.

This is a reference to a sales tax code predefined within QuickBooks.

By default, two standard TaxCodes exist: "TAX", or Taxable Sales, and "NON", or Non-Taxable Sales. The QuickBooks user may also define custom tax codes.

Name/Id Reference Properties

This property is used to reference an object that is already done within QuickBooks. This may be done with its full Name (this property) or its Id, for which a corresponding property is defined. If Name is used, it must contain the full name of the object referred to, as generated by QuickBooks. For hierarchically defined objects, such as Customers, this includes the names of parent objects, and the full name can be determined by reading the FullName special field.

Setting the value of this property will set the corresponding Id property to an empty string.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

ItemUnitOfMeasure Property (SalesOrder Class)

Unit of measure describing the Quantity .

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetItemUnitOfMeasure(int iItemIndex);
int SetItemUnitOfMeasure(int iItemIndex, const char* lpszItemUnitOfMeasure);

Unicode (Windows)
LPWSTR GetItemUnitOfMeasure(INT iItemIndex);
INT SetItemUnitOfMeasure(INT iItemIndex, LPCWSTR lpszItemUnitOfMeasure);

char* inqb_salesorder_getitemunitofmeasure(void* lpObj, int itemindex);
int inqb_salesorder_setitemunitofmeasure(void* lpObj, int itemindex, const char* lpszItemUnitOfMeasure);

QString GetItemUnitOfMeasure(int iItemIndex);
int SetItemUnitOfMeasure(int iItemIndex, QString qsItemUnitOfMeasure);

Default Value

""

Remarks

Unit of measure describing the ItemQuantity.

In a transaction line item, the name of the unit of measure selected from within the item's available units. If the company file is enabled only for single unit of measure per item, this must be the base unit!

This property is only available for QBXMLVersion 7.0 and higher.

The ItemIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ItemCount property.

This property is not available at design time.

Data Type

String

LinkedTxnCount Property (SalesOrder Class)

The number of records in the LinkedTxn arrays.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetLinkedTxnCount();

Unicode (Windows)
INT GetLinkedTxnCount();

int inqb_salesorder_getlinkedtxncount(void* lpObj);

int GetLinkedTxnCount();

Default Value

0

Remarks

This property controls the size of the following arrays:

• LinkedTxnAmount
• LinkedTxnDate
• LinkedTxnId
• LinkedTxnLinkType
• LinkedTxnRefNumber
• LinkedTxnType

The array indices start at 0 and end at LinkedTxnCount - 1.

This property is read-only and not available at design time.

Data Type

Integer

LinkedTxnAmount Property (SalesOrder Class)

The amount of the linked transaction.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetLinkedTxnAmount(int iLinkedTxnIndex);

Unicode (Windows)
LPWSTR GetLinkedTxnAmount(INT iLinkedTxnIndex);

char* inqb_salesorder_getlinkedtxnamount(void* lpObj, int linkedtxnindex);

QString GetLinkedTxnAmount(int iLinkedTxnIndex);

Default Value

""

Remarks

The amount of the linked transaction.

The LinkedTxnIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LinkedTxnCount property.

This property is read-only and not available at design time.

Data Type

String

LinkedTxnDate Property (SalesOrder Class)

The date of the linked transaction.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetLinkedTxnDate(int iLinkedTxnIndex);

Unicode (Windows)
LPWSTR GetLinkedTxnDate(INT iLinkedTxnIndex);

char* inqb_salesorder_getlinkedtxndate(void* lpObj, int linkedtxnindex);

QString GetLinkedTxnDate(int iLinkedTxnIndex);

Default Value

""

Remarks

The date of the linked transaction.

The LinkedTxnIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LinkedTxnCount property.

This property is read-only and not available at design time.

Data Type

String

LinkedTxnLinkType Property (SalesOrder Class)

Indicates the nature of the link between the transactions.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetLinkedTxnLinkType(int iLinkedTxnIndex);

Unicode (Windows)
LPWSTR GetLinkedTxnLinkType(INT iLinkedTxnIndex);

char* inqb_salesorder_getlinkedtxnlinktype(void* lpObj, int linkedtxnindex);

QString GetLinkedTxnLinkType(int iLinkedTxnIndex);

Default Value

""

Remarks

Indicates the nature of the link between the transactions. Possible responses include:

The LinkedTxnIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LinkedTxnCount property.

This property is read-only and not available at design time.

Data Type

String

LinkedTxnRefNumber Property (SalesOrder Class)

This is the reference number assigned to the linked transaction.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetLinkedTxnRefNumber(int iLinkedTxnIndex);

Unicode (Windows)
LPWSTR GetLinkedTxnRefNumber(INT iLinkedTxnIndex);

char* inqb_salesorder_getlinkedtxnrefnumber(void* lpObj, int linkedtxnindex);

QString GetLinkedTxnRefNumber(int iLinkedTxnIndex);

Default Value

""

Remarks

This is the reference number assigned to the linked transaction. Depending on the type of transaction, it appears in the QuickBooks user interface as Bill Number, Invoice Number, etc.

Reference numbers are alphanumeric strings and are not limited to actually being numbers.

The LinkedTxnIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LinkedTxnCount property.

This property is read-only and not available at design time.

Data Type

String

LinkedTxnId Property (SalesOrder Class)

This property can be used by another class to reference the original transaction which is linked to the current response.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetLinkedTxnId(int iLinkedTxnIndex);

Unicode (Windows)
LPWSTR GetLinkedTxnId(INT iLinkedTxnIndex);

char* inqb_salesorder_getlinkedtxnid(void* lpObj, int linkedtxnindex);

QString GetLinkedTxnId(int iLinkedTxnIndex);

Default Value

""

Remarks

This property can be used by another class to reference the original transaction which is linked to the current response. Simply set the Id property of the appropriate class (based on the LinkedTxnTxnType property) and call the Get method.

The LinkedTxnIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LinkedTxnCount property.

This property is read-only and not available at design time.

Data Type

String

LinkedTxnType Property (SalesOrder Class)

This property indicates which type of linked transaction has been returned.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetLinkedTxnType(int iLinkedTxnIndex);

Unicode (Windows)
LPWSTR GetLinkedTxnType(INT iLinkedTxnIndex);

char* inqb_salesorder_getlinkedtxntype(void* lpObj, int linkedtxnindex);

QString GetLinkedTxnType(int iLinkedTxnIndex);

Default Value

""

Remarks

This property indicates which type of linked transaction has been returned. The LinkedTxnTxnType returned will tell you which class to use to retrieve the original transaction. Use the LinkedTxnTxnId as the Id parameter in the indicated class's Get method to return the original transaction details.

Valid values include:

Note: Not all of the above values are available in the QuickBooks API. Some are only available within the QuickBooks application itself. If the value above is available in the API, the corresponding class is indicated in parenthesis.

The LinkedTxnIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LinkedTxnCount property.

This property is read-only and not available at design time.

Data Type

String

ManuallyClosed Property (SalesOrder Class)

Whether the sales order is manually closed.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetManuallyClosed();
int SetManuallyClosed(int iManuallyClosed);

Unicode (Windows)
INT GetManuallyClosed();
INT SetManuallyClosed(INT iManuallyClosed);

MC_NOT_SET(0), 
MC_MANUALLY_CLOSED(1), 
MC_NOT_MANUALLY_CLOSED(2)

int inqb_salesorder_getmanuallyclosed(void* lpObj);
int inqb_salesorder_setmanuallyclosed(void* lpObj, int iManuallyClosed);

int GetManuallyClosed();
int SetManuallyClosed(int iManuallyClosed);

Default Value

0

Remarks

If true, the sales order is manually closed, even if not all of its line items have been invoiced.

This may also be set for individual line items via ItemManuallyClosed.

Data Type

Integer

Memo Property (SalesOrder Class)

Memo to appear on internal reports only.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMemo();
int SetMemo(const char* lpszMemo);

Unicode (Windows)
LPWSTR GetMemo();
INT SetMemo(LPCWSTR lpszMemo);

char* inqb_salesorder_getmemo(void* lpObj);
int inqb_salesorder_setmemo(void* lpObj, const char* lpszMemo);

QString GetMemo();
int SetMemo(QString qsMemo);

Default Value

""

Remarks

A memo to appear on internal reports. Will not appear to customers, vendors, etc.

Data Type

String

Other Property (SalesOrder Class)

Pre-defined QuickBooks Custom Field.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetOther();
int SetOther(const char* lpszOther);

Unicode (Windows)
LPWSTR GetOther();
INT SetOther(LPCWSTR lpszOther);

char* inqb_salesorder_getother(void* lpObj);
int inqb_salesorder_setother(void* lpObj, const char* lpszOther);

QString GetOther();
int SetOther(QString qsOther);

Default Value

""

Remarks

The Other property is a transaction-level field, like the FOB field, PO Number field, and so forth. This property appears only once for the transaction: you can write to it and modify it. QBXMLVersion 6.0 or higher is required to use this property.

Data Type

String

PONumber Property (SalesOrder Class)

P.O. number.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetPONumber();
int SetPONumber(const char* lpszPONumber);

Unicode (Windows)
LPWSTR GetPONumber();
INT SetPONumber(LPCWSTR lpszPONumber);

char* inqb_salesorder_getponumber(void* lpObj);
int inqb_salesorder_setponumber(void* lpObj, const char* lpszPONumber);

QString GetPONumber();
int SetPONumber(QString qsPONumber);

Default Value

""

Remarks

The P.O. number for this invoice or credit memo.

Data Type

String

QBConnectionMode Property (SalesOrder Class)

The mode of connection to QuickBooks.

Syntax

• C++
• C
• Qt