TimeTrackingAdd

This request adds a time tracking transaction to QuickBooks, mirroring the time-tracking feature available in the QuickBooks UI. The time tracking feature allows a QuickBooks user to base payroll or invoices on time worked. You can add time-tracking information to any vendor, employee, or person on the Other Names list in QuickBooks. If IsBillable is set to true, both CustomerRef and ItemServiceRef are required. There is no link between an invoice and the time entries. However when you do the invoicing from QuickBooks, QuickBooks does mark the time entries as “billed.” If you don’t record the time entries as billed properly, then you get into a user workflow issue where everytime the user creates an invoice for a customer, QB pops up a dialog asking if they want to bill the unbilled time (which you already billed from your app). That’s why beginning with QB2007 and qbXML spec 6.0 we added support for the “BillableStatus” field *and* add TimeTrackingMod so that you can mark the time as billed when you create an invoice for it.

Request

Response

XMLOps

VB.NET

Tag	Type	Max length	Implementation	Required
ITimeTrackingAdd This request adds a time tracking transaction to QuickBooks, mirroring the time-tracking feature available in the QuickBooks UI. The time tracking feature allows a QuickBooks user to base payroll or invoices on time worked. You can add time-tracking information to any vendor, employee, or person on the Other Names list in QuickBooks. If IsBillable is set to true, both CustomerRef and ItemServiceRef are required. There is no link between an invoice and the time entries. However when you do the invoicing from QuickBooks, QuickBooks does mark the time entries as “billed.” If you don’t record the time entries as billed properly, then you get into a user workflow issue where everytime the user creates an invoice for a customer, QB pops up a dialog asking if they want to bill the unbilled time (which you already billed from your app). That’s why beginning with QB2007 and qbXML spec 6.0 we added support for the “BillableStatus” field and add TimeTrackingMod so that you can mark the time as billed when you create an invoice for it.
defMacro Note that defMacro was introduced with SDK 2.0, so it only works with 2.0 and higher requests. You can use the defMacro attribute to assign a name to the TxnID or TxnListID that this aggregate will return. This way you can refer to the transaction by name in a later request. For example, if you were using the qbXML API and you defined an invoice add request with the name TxnID:RecvPmt1234, as shown below, then you could refer to that invoice by name in a later receive payment add request: … … …If you use macros with QBOE… There may be a bug in the QBOE implementation of this feature. If this feature is not working for you in QBOE, try stripping the prefix “TxnID:” from the name of the useMacro. For example, defMacro=”TxnID:RecvPmt1234” and useMacro=”RecvPmt1234”	IQBStringType		2.0
TxnDate The date of the transaction. In some cases, if you leave TxnDate out of an -Add message, QuickBooks will prefill TxnDate with the date of the last-saved transaction of the same type.	IQBDateType
EntityRef A QuickBooks “entity” is a customer, vendor, employee, or person on the QuickBooks “other names” list. Special cases to note: In a BillToPayQuery message, EntityRef refers to the vendor name.In JournalCreditLine and JournalDebitLine messages for A/R accounts, EntityRef must refer to a customer, or else the transaction will not be recorded. For A/P accounts the EntityRef must refer to a vendor, or else the transaction will not be recorded.In a TimeTracking message, EntityRef cannot refer to a customer, only to an employee, vendor, or person on the “other names” list whose time is being tracked.	IQBBaseRef			Y
ListID Along with FullName, ListID is a way to identify a list object. When a list object is added to QuickBooks through the SDK or through the QuickBooks user interface, the server assigns it a ListID. A ListID is not unique across lists, but it is unique across each particular type of list. For example, two customers could not have the same ListID, and a customer could not have the same ListID as an employee (because Customer and Employee are both name lists). But a customer could have the same ListID as a non-inventory item.	IQBIDType
FullName FullName (along with ListID) is a way to identify a list object. The FullName is the name prefixed by the names of each ancestor, for example Jones:Kitchen:Cabinets. FullName values are not case-sensitive.	IQBStringType	209 chars
CustomerRef The customer list includes information about the QuickBooks user’s customers and the individual jobs that are being performed for them. A CustomerRef aggregate refers to one of the customers (or customer jobs) on the list. In a request, if a CustomerRef aggregate includes both FullName and ListID, FullName will be ignored. Special cases to note:In SalesReceipt and ReceivePayment requests, CustomerRef refers to the customer or customer job to which the payment is credited.In a TimeTracking request, CustomerRef refers to the customer or customer job to which this time could be billed. If IsBillable is set to true, CustomerRef is required in TimeTrackingAdd. In an ExpenseLineAdd request, if AccountRef refers to an A/P account, CustomerRef must refer to a vendor (not to a customer). If AccountRef refers to any other type of account, the CustomerRef must refer to a customer.	IQBBaseRef
ListID Along with FullName, ListID is a way to identify a list object. When a list object is added to QuickBooks through the SDK or through the QuickBooks user interface, the server assigns it a ListID. A ListID is not unique across lists, but it is unique across each particular type of list. For example, two customers could not have the same ListID, and a customer could not have the same ListID as an employee (because Customer and Employee are both name lists). But a customer could have the same ListID as a non-inventory item.	IQBIDType
FullName FullName (along with ListID) is a way to identify a list object. The FullName is the name prefixed by the names of each ancestor, for example Jones:Kitchen:Cabinets. FullName values are not case-sensitive.	IQBStringType	209 chars
ItemServiceRef A service item refers to services that a business charges for or purchases. Examples include specialized labor, consulting hours, and professional fees. An ItemServiceRef aggregate refers to an item on the ItemService list. In a request, if an ItemServiceRef aggregate includes both FullName and ListID, FullName will be ignored. In a TimeTracking message, ItemServiceRef refers to the type of work. If no CustomerRef is specified, then ItemServiceRef is not needed. If IsBillable is set to true, then TimeTrackingAdd must include both ItemServiceRef and CustomerRef.	IQBBaseRef
ListID Along with FullName, ListID is a way to identify a list object. When a list object is added to QuickBooks through the SDK or through the QuickBooks user interface, the server assigns it a ListID. A ListID is not unique across lists, but it is unique across each particular type of list. For example, two customers could not have the same ListID, and a customer could not have the same ListID as an employee (because Customer and Employee are both name lists). But a customer could have the same ListID as a non-inventory item.	IQBIDType
FullName FullName (along with ListID) is a way to identify a list object. The FullName is the name prefixed by the names of each ancestor, for example Jones:Kitchen:Cabinets. FullName values are not case-sensitive.	IQBStringType	159 chars
Duration Time spent doing the work. In a TimeTrackAdd request, notice that although you can specify seconds, seconds are not returned in the response because the UI does not use seconds.	IQBTimeIntervalType			Y
ClassRef Classes can be used to separate transactions into meaningful categories. (For example, transactions could be classified according to department, business location, or type of work.) In QuickBooks, class tracking is off by default. A ClassRef aggregate refers to one of these named classes. For example, in a TimeTracking message, ClassRef refers to the QuickBooks class into which the timed activity falls. If a ClassRef aggregate includes both FullName and ListID, FullName will be ignored. In an InvoiceAdd request, if you specify a ClassRef for the whole invoice, that same ClassRef is automatically used in the line items. If you want to clear that (that is, have NO ClassRef for the line item, you can clear it in the line item by simply not specifying it in the line item.	IQBBaseRef
ListID Along with FullName, ListID is a way to identify a list object. When a list object is added to QuickBooks through the SDK or through the QuickBooks user interface, the server assigns it a ListID. A ListID is not unique across lists, but it is unique across each particular type of list. For example, two customers could not have the same ListID, and a customer could not have the same ListID as an employee (because Customer and Employee are both name lists). But a customer could have the same ListID as a non-inventory item.	IQBIDType
FullName FullName (along with ListID) is a way to identify a list object. The FullName is the name prefixed by the names of each ancestor, for example Jones:Kitchen:Cabinets. FullName values are not case-sensitive.	IQBStringType	159 chars
PayrollItemWageRef Each payroll wage item describes and names a payment scheme, for example, Regular Pay or Overtime Pay. A PayrollItemWageRef aggregate refers to one of these wage items. In a request, if a PayrollItemWageRef aggregate includes both FullName and ListID, FullName will be ignored. Within QuickBooks, a timesheet can specify a payroll wage item only if the following criteria are met: The name on the timesheet (which corresponds to the EntityRef in the TimeTracking object) is on the QuickBooks Employee list, and The “Use time data to create paychecks” preference is turned on in the QuickBooks Payroll Info window that provides detailed employee information employee.	IQBBaseRef
ListID Along with FullName, ListID is a way to identify a list object. When a list object is added to QuickBooks through the SDK or through the QuickBooks user interface, the server assigns it a ListID. A ListID is not unique across lists, but it is unique across each particular type of list. For example, two customers could not have the same ListID, and a customer could not have the same ListID as an employee (because Customer and Employee are both name lists). But a customer could have the same ListID as a non-inventory item.	IQBIDType
FullName FullName (along with ListID) is a way to identify a list object. The FullName is the name prefixed by the names of each ancestor, for example Jones:Kitchen:Cabinets. FullName values are not case-sensitive.	IQBStringType	31 chars
Notes Additional information.	IQBStringType	4095 chars
BillableStatus The billing status of this item line or expense line.	IQBENBillableStatusType		6.0
IsBillable NOT USABLE IN QBXML SPEC 6.0 AND LATER!! Use BillableStatus instead. If IsBillable is true, the tracked time is billable, and you must specify CustomerRef and ItemServiceRef so that an invoice can be created. If no invoice will be created, set IsBillable to false. (IsBillable is true by default.)	IQBBoolType
ExternalGUID Allows for the attachment of a user defined GUID value.	IQBGUIDType		9.0
IncludeRetElementList You use this if you want to limit the data that will be returned in the response. In this list, you specify the name of each top-level element or aggregate that you want to be returned in the response to the request. You cannot specify fields within an aggregate, for example, you cannot specify a City within an Address: you must specify Address and will get the entire address. The names specified in the list are not parsed, so you must be especially careful to supply valid names, properly cased. No error is returned in the status code if you specify an invalid name. Notice that if you want to return custom data or private data extensions, you must specify the DataExtRet element and you must supply the OwnerID set to either a value of 0 (custom data) or the GUID for the private data.	IBSTRList	50 chars	4.0

Tag	Type	Max length	Implementation	Required
IResponse This request adds a time tracking transaction to QuickBooks, mirroring the time-tracking feature available in the QuickBooks UI. The time tracking feature allows a QuickBooks user to base payroll or invoices on time worked. You can add time-tracking information to any vendor, employee, or person on the Other Names list in QuickBooks. If IsBillable is set to true, both CustomerRef and ItemServiceRef are required. There is no link between an invoice and the time entries. However when you do the invoicing from QuickBooks, QuickBooks does mark the time entries as “billed.” If you don’t record the time entries as billed properly, then you get into a user workflow issue where everytime the user creates an invoice for a customer, QB pops up a dialog asking if they want to bill the unbilled time (which you already billed from your app). That’s why beginning with QB2007 and qbXML spec 6.0 we added support for the “BillableStatus” field and add TimeTrackingMod so that you can mark the time as billed when you create an invoice for it.
StatusCode A number that corresponds to a statusSeverity and statusMessage. Five status codes relate directly to signon messages: 2000, 2010, 2020, 2030, and 2040. For details about these and other statusCode values that can be returned, see the statusCode table on the Error Codes page.	IQBIntType			Y
StatusSeverity One of the following values: INFO The request was completed, and the results are consistent with what your application expected. WARNING The request was completed, but the results might not be consistent with what you expected. ERROR The request was not completed. No data will appear in the server’s response after the statusMessage.	IQBStringType			Y
StatusMessage A user-readable explanation of the success or error condition that is indicated by the statusCode. For details about the statusMessage values that can be returned, see the “Explanation” column of the statusCode table on the Error Codes page.	IQBStringType			Y
Detail	ITimeTrackingRet
TxnID QuickBooks generates a unique TxnID for each transaction that is added to QuickBooks. A TxnID returned from a request can be used to refer to the transaction in subsequent requests. Notice that you cannot supply the TxnID of a TimeTracking transaction to TransactionQueryRq requests. If you do, you get an error stating that no such record could be found, even though the transaction is in QuickBooks. This behavior reflects the behavior in the QuicKBooks UI in the Find window.	IQBIDType			Y
TimeCreated Time the object was created.	IQBDateTimeType			Y
TimeModified Time the object was last modified.	IQBDateTimeType			Y
EditSequence A number that the server generates and assigns to this object. Every time the object is changed, the server will change its EditSequence value. When you try to modify a list object, you must provide its EditSequence. The server compares the EditSequence you provide with the EditSequence in memory to make sure you are dealing with the latest copy of the object. If you are not, the server will reject the request and return an error. Because EditSequence is only used to check whether two objects match, there is no reason to interpret its value.	IQBStringType	16 chars		Y
TxnNumber An identifying number for this transaction.	IQBIntType
TxnDate The date of the transaction. In some cases, if you leave TxnDate out of an -Add message, QuickBooks will prefill TxnDate with the date of the last-saved transaction of the same type.	IQBDateType			Y
EntityRef A QuickBooks “entity” is a customer, vendor, employee, or person on the QuickBooks “other names” list. Special cases to note: In a BillToPayQuery message, EntityRef refers to the vendor name.In JournalCreditLine and JournalDebitLine messages for A/R accounts, EntityRef must refer to a customer, or else the transaction will not be recorded. For A/P accounts the EntityRef must refer to a vendor, or else the transaction will not be recorded.In a TimeTracking message, EntityRef cannot refer to a customer, only to an employee, vendor, or person on the “other names” list whose time is being tracked.	IQBBaseRef			Y
ListID Along with FullName, ListID is a way to identify a list object. When a list object is added to QuickBooks through the SDK or through the QuickBooks user interface, the server assigns it a ListID. A ListID is not unique across lists, but it is unique across each particular type of list. For example, two customers could not have the same ListID, and a customer could not have the same ListID as an employee (because Customer and Employee are both name lists). But a customer could have the same ListID as a non-inventory item.	IQBIDType
FullName FullName (along with ListID) is a way to identify a list object. The FullName is the name prefixed by the names of each ancestor, for example Jones:Kitchen:Cabinets. FullName values are not case-sensitive.	IQBStringType	209 chars
CustomerRef The customer list includes information about the QuickBooks user’s customers and the individual jobs that are being performed for them. A CustomerRef aggregate refers to one of the customers (or customer jobs) on the list. In a request, if a CustomerRef aggregate includes both FullName and ListID, FullName will be ignored. Special cases to note:In SalesReceipt and ReceivePayment requests, CustomerRef refers to the customer or customer job to which the payment is credited.In a TimeTracking request, CustomerRef refers to the customer or customer job to which this time could be billed. If IsBillable is set to true, CustomerRef is required in TimeTrackingAdd. In an ExpenseLineAdd request, if AccountRef refers to an A/P account, CustomerRef must refer to a vendor (not to a customer). If AccountRef refers to any other type of account, the CustomerRef must refer to a customer.	IQBBaseRef
ListID Along with FullName, ListID is a way to identify a list object. When a list object is added to QuickBooks through the SDK or through the QuickBooks user interface, the server assigns it a ListID. A ListID is not unique across lists, but it is unique across each particular type of list. For example, two customers could not have the same ListID, and a customer could not have the same ListID as an employee (because Customer and Employee are both name lists). But a customer could have the same ListID as a non-inventory item.	IQBIDType
FullName FullName (along with ListID) is a way to identify a list object. The FullName is the name prefixed by the names of each ancestor, for example Jones:Kitchen:Cabinets. FullName values are not case-sensitive.	IQBStringType	209 chars
ItemServiceRef A service item refers to services that a business charges for or purchases. Examples include specialized labor, consulting hours, and professional fees. An ItemServiceRef aggregate refers to an item on the ItemService list. In a request, if an ItemServiceRef aggregate includes both FullName and ListID, FullName will be ignored. In a TimeTracking message, ItemServiceRef refers to the type of work. If no CustomerRef is specified, then ItemServiceRef is not needed. If IsBillable is set to true, then TimeTrackingAdd must include both ItemServiceRef and CustomerRef.	IQBBaseRef
ListID Along with FullName, ListID is a way to identify a list object. When a list object is added to QuickBooks through the SDK or through the QuickBooks user interface, the server assigns it a ListID. A ListID is not unique across lists, but it is unique across each particular type of list. For example, two customers could not have the same ListID, and a customer could not have the same ListID as an employee (because Customer and Employee are both name lists). But a customer could have the same ListID as a non-inventory item.	IQBIDType
FullName FullName (along with ListID) is a way to identify a list object. The FullName is the name prefixed by the names of each ancestor, for example Jones:Kitchen:Cabinets. FullName values are not case-sensitive.	IQBStringType	159 chars
Duration Time spent doing the work. In a TimeTrackAdd request, notice that although you can specify seconds, seconds are not returned in the response because the UI does not use seconds.	IQBTimeIntervalType			Y
ClassRef Classes can be used to separate transactions into meaningful categories. (For example, transactions could be classified according to department, business location, or type of work.) In QuickBooks, class tracking is off by default. A ClassRef aggregate refers to one of these named classes. For example, in a TimeTracking message, ClassRef refers to the QuickBooks class into which the timed activity falls. If a ClassRef aggregate includes both FullName and ListID, FullName will be ignored. In an InvoiceAdd request, if you specify a ClassRef for the whole invoice, that same ClassRef is automatically used in the line items. If you want to clear that (that is, have NO ClassRef for the line item, you can clear it in the line item by simply not specifying it in the line item.	IQBBaseRef
ListID Along with FullName, ListID is a way to identify a list object. When a list object is added to QuickBooks through the SDK or through the QuickBooks user interface, the server assigns it a ListID. A ListID is not unique across lists, but it is unique across each particular type of list. For example, two customers could not have the same ListID, and a customer could not have the same ListID as an employee (because Customer and Employee are both name lists). But a customer could have the same ListID as a non-inventory item.	IQBIDType
FullName FullName (along with ListID) is a way to identify a list object. The FullName is the name prefixed by the names of each ancestor, for example Jones:Kitchen:Cabinets. FullName values are not case-sensitive.	IQBStringType	159 chars
PayrollItemWageRef Each payroll wage item describes and names a payment scheme, for example, Regular Pay or Overtime Pay. A PayrollItemWageRef aggregate refers to one of these wage items. In a request, if a PayrollItemWageRef aggregate includes both FullName and ListID, FullName will be ignored. Within QuickBooks, a timesheet can specify a payroll wage item only if the following criteria are met: The name on the timesheet (which corresponds to the EntityRef in the TimeTracking object) is on the QuickBooks Employee list, and The “Use time data to create paychecks” preference is turned on in the QuickBooks Payroll Info window that provides detailed employee information employee.	IQBBaseRef
ListID Along with FullName, ListID is a way to identify a list object. When a list object is added to QuickBooks through the SDK or through the QuickBooks user interface, the server assigns it a ListID. A ListID is not unique across lists, but it is unique across each particular type of list. For example, two customers could not have the same ListID, and a customer could not have the same ListID as an employee (because Customer and Employee are both name lists). But a customer could have the same ListID as a non-inventory item.	IQBIDType
FullName FullName (along with ListID) is a way to identify a list object. The FullName is the name prefixed by the names of each ancestor, for example Jones:Kitchen:Cabinets. FullName values are not case-sensitive.	IQBStringType	31 chars
Notes Additional information.	IQBStringType	4095 chars
BillableStatus The billing status of this item line or expense line.	IQBENBillableStatusType		6.0
ExternalGUID Allows for the attachment of a user defined GUID value.	IQBGUIDType		9.0
IsBillable NOT USABLE IN QBXML SPEC 6.0 AND LATER!! Use BillableStatus instead. If IsBillable is true, the tracked time is billable, and you must specify CustomerRef and ItemServiceRef so that an invoice can be created. If no invoice will be created, set IsBillable to false. (IsBillable is true by default.)	IQBBoolType
IsBilled If IsBilled is true, the tracked time has already been billed.	IQBBoolType
Detail	IErrorRecovery		11.0
ORListOwnerTxn	IORListOwnerTxn			Y
ListID Along with FullName, ListID is a way to identify a list object. When a list object is added to QuickBooks through the SDK or through the QuickBooks user interface, the server assigns it a ListID. A ListID is not unique across lists, but it is unique across each particular type of list. For example, two customers could not have the same ListID, and a customer could not have the same ListID as an employee (because Customer and Employee are both name lists). But a customer could have the same ListID as a non-inventory item.	IQBIDType
OwnerID Refers to the owner of a data extension:If OwnerID is 0, this is a public data extension, also known as a custom field. Custom fields appear in the QuickBooks UI.If OwnerID is a GUID, for example {6B063959-81B0-4622-85D6-F548C8CCB517}, this field is a private data extension defined by an integrated application. Private data extensions do not appear in the QuickBooks UI. Note that OwnerID values are not case-sensitive, meaning that if you enter an OwnerID value with lower-case letters, the value will be saved and returned with upper-case letters. When you share a private data extension with another application, the other application must know both the OwnerID and the DataExtName, as these together form a data extension’s unique name.	IQBGUIDType
TxnID QuickBooks generates a unique TxnID for each transaction that is added to QuickBooks. A TxnID returned from a request can be used to refer to the transaction in subsequent requests. Notice that you cannot supply the TxnID of a TimeTracking transaction to TransactionQueryRq requests. If you do, you get an error stating that no such record could be found, even though the transaction is in QuickBooks. This behavior reflects the behavior in the QuicKBooks UI in the Find window.	IQBIDType
TxnNumber An identifying number for this transaction.	IQBIntType
EditSequence A number that the server generates and assigns to this object. Every time the object is changed, the server will change its EditSequence value. When you try to modify a list object, you must provide its EditSequence. The server compares the EditSequence you provide with the EditSequence in memory to make sure you are dealing with the latest copy of the object. If you are not, the server will reject the request and return an error. Because EditSequence is only used to check whether two objects match, there is no reason to interpret its value.	IQBStringType	16 chars
ExternalGUID Allows for the attachment of a user defined GUID value.	IQBGUIDType

<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="17.0"?>
<QBXML>
        <QBXMLMsgsRq onError="stopOnError">
                <TimeTrackingAddRq>
                        <TimeTrackingAdd defMacro="MACROTYPE"> <!-- required -->
                                <TxnDate >DATETYPE</TxnDate> <!-- optional -->
                                <EntityRef> <!-- required -->
                                        <ListID >IDTYPE</ListID> <!-- optional -->
                                        <FullName >STRTYPE</FullName> <!-- optional -->
                                </EntityRef>
                                <CustomerRef> <!-- optional -->
                                        <ListID >IDTYPE</ListID> <!-- optional -->
                                        <FullName >STRTYPE</FullName> <!-- optional -->
                                </CustomerRef>
                                <ItemServiceRef> <!-- optional -->
                                        <ListID >IDTYPE</ListID> <!-- optional -->
                                        <FullName >STRTYPE</FullName> <!-- optional -->
                                </ItemServiceRef>
                                <Duration >TIMEINTERVALTYPE</Duration> <!-- required -->
                                <ClassRef> <!-- optional -->
                                        <ListID >IDTYPE</ListID> <!-- optional -->
                                        <FullName >STRTYPE</FullName> <!-- optional -->
                                </ClassRef>
                                <PayrollItemWageRef> <!-- optional -->
                                        <ListID >IDTYPE</ListID> <!-- optional -->
                                        <FullName >STRTYPE</FullName> <!-- optional -->
                                </PayrollItemWageRef>
                                <Notes >STRTYPE</Notes> <!-- optional -->
                                <!-- BillableStatus may have one of the following values: Billable, NotBillable, HasBeenBilled -->
                                <BillableStatus >ENUMTYPE</BillableStatus> <!-- optional -->
                                <IsBillable >BOOLTYPE</IsBillable> <!-- optional -->
                                <ExternalGUID >GUIDTYPE</ExternalGUID> <!-- optional -->
                        </TimeTrackingAdd>
                        <IncludeRetElement >STRTYPE</IncludeRetElement> <!-- optional, may repeat -->
                </TimeTrackingAddRq>

                <TimeTrackingAddRs statusCode="INTTYPE" statusSeverity="STRTYPE" statusMessage="STRTYPE">
                        <TimeTrackingRet> <!-- optional -->
                                <TxnID >IDTYPE</TxnID> <!-- required -->
                                <TimeCreated >DATETIMETYPE</TimeCreated> <!-- required -->
                                <TimeModified >DATETIMETYPE</TimeModified> <!-- required -->
                                <EditSequence >STRTYPE</EditSequence> <!-- required -->
                                <TxnNumber >INTTYPE</TxnNumber> <!-- optional -->
                                <TxnDate >DATETYPE</TxnDate> <!-- required -->
                                <EntityRef> <!-- required -->
                                        <ListID >IDTYPE</ListID> <!-- optional -->
                                        <FullName >STRTYPE</FullName> <!-- optional -->
                                </EntityRef>
                                <CustomerRef> <!-- optional -->
                                        <ListID >IDTYPE</ListID> <!-- optional -->
                                        <FullName >STRTYPE</FullName> <!-- optional -->
                                </CustomerRef>
                                <ItemServiceRef> <!-- optional -->
                                        <ListID >IDTYPE</ListID> <!-- optional -->
                                        <FullName >STRTYPE</FullName> <!-- optional -->
                                </ItemServiceRef>
                                <Duration >TIMEINTERVALTYPE</Duration> <!-- required -->
                                <ClassRef> <!-- optional -->
                                        <ListID >IDTYPE</ListID> <!-- optional -->
                                        <FullName >STRTYPE</FullName> <!-- optional -->
                                </ClassRef>
                                <PayrollItemWageRef> <!-- optional -->
                                        <ListID >IDTYPE</ListID> <!-- optional -->
                                        <FullName >STRTYPE</FullName> <!-- optional -->
                                </PayrollItemWageRef>
                                <Notes >STRTYPE</Notes> <!-- optional -->
                                <!-- BillableStatus may have one of the following values: Billable, NotBillable, HasBeenBilled -->
                                <BillableStatus >ENUMTYPE</BillableStatus> <!-- optional -->
                                <ExternalGUID >GUIDTYPE</ExternalGUID> <!-- optional -->
                                <IsBillable >BOOLTYPE</IsBillable> <!-- optional -->
                                <IsBilled >BOOLTYPE</IsBilled> <!-- optional -->
                        </TimeTrackingRet>
                        <ErrorRecovery> <!-- optional -->
                                <!-- BEGIN OR -->
                                        <ListID >IDTYPE</ListID> <!-- optional -->
                                <!-- OR -->
                                        <OwnerID >GUIDTYPE</OwnerID> <!-- optional -->
                                <!-- OR -->
                                        <TxnID >IDTYPE</TxnID> <!-- optional -->
                                <!-- END OR -->
                                <TxnNumber >INTTYPE</TxnNumber> <!-- optional -->
                                <EditSequence >STRTYPE</EditSequence> <!-- optional -->
                                <ExternalGUID >GUIDTYPE</ExternalGUID> <!-- optional -->
                        </ErrorRecovery>
                </TimeTrackingAddRs>
        </QBXMLMsgsRq>
</QBXML>

'The following sample code is generated as an illustration of
'Creating requests and parsing responses ONLY
'This code is NOT intended to show best practices or ideal code
'Use at your most careful discretion

imports System
imports System.Net
imports System.Drawing
imports System.Collections
imports System.ComponentModel
imports System.Windows.Forms
imports System.Data
imports System.IO
imports Interop.QBFC16

Module com.intuit.idn.samples
        Public Class Sample
                Public Sub  DoTimeTrackingAdd()
                        Dim sessionBegun as Boolean
                        sessionBegun = False
                        Dim connectionOpen as Boolean
                        connectionOpen = False
                        Dim sessionManager as QBSessionManager
                        sessionManager = nothing

                        Try
                                'Create the session Manager object
                                sessionManager = new QBSessionManager

                                'Create the message set request object to hold our request
                                Dim requestMsgSet as IMsgSetRequest
                                requestMsgSet = sessionManager.CreateMsgSetRequest("US",16,0)
                                requestMsgSet.Attributes.OnError = ENRqOnError.roeContinue

                                BuildTimeTrackingAddRq(requestMsgSet)

                                'Connect to QuickBooks and begin a session
                                sessionManager.OpenConnection("","Sample Code from OSR")
                                connectionOpen = True
                                sessionManager.BeginSession("", ENOpenMode.omDontCare)
                                sessionBegun = True

                                'Send the request and get the response from QuickBooks
                                Dim responseMsgSet as IMsgSetResponse
                                responseMsgSet = sessionManager.DoRequests(requestMsgSet)

                                'End the session and close the connection to QuickBooks
                                sessionManager.EndSession()
                                sessionBegun = False
                                sessionManager.CloseConnection()
                                connectionOpen = False

                                WalkTimeTrackingAddRs(responseMsgSet)
                        Catch e as Exception
                                MessageBox.Show(e.Message, "Error")
                                if (sessionBegun) then
                                        sessionManager.EndSession()
                                End If
                                if (connectionOpen) then
                                        sessionManager.CloseConnection()
                                End If
                        End Try
                End Sub
                Public Sub BuildTimeTrackingAddRq(requestMsgSet as IMsgSetRequest)
                        Dim TimeTrackingAddRq as ITimeTrackingAdd
                        TimeTrackingAddRq= requestMsgSet.AppendTimeTrackingAddRq()
                        'Set field value for TxnDate
                        TimeTrackingAddRq.TxnDate.SetValue(DateTime.Parse("12/15/2007"))
                        'Set field value for ListID
                        TimeTrackingAddRq.EntityRef.ListID.SetValue("200000-1011023419")
                        'Set field value for FullName
                        TimeTrackingAddRq.EntityRef.FullName.SetValue("ab")
                        'Set field value for ListID
                        TimeTrackingAddRq.CustomerRef.ListID.SetValue("200000-1011023419")
                        'Set field value for FullName
                        TimeTrackingAddRq.CustomerRef.FullName.SetValue("ab")
                        'Set field value for ListID
                        TimeTrackingAddRq.ItemServiceRef.ListID.SetValue("200000-1011023419")
                        'Set field value for FullName
                        TimeTrackingAddRq.ItemServiceRef.FullName.SetValue("ab")
                        'Set field value for Duration
                        TimeTrackingAddRq.Duration.SetValue("IQBTimeIntervalType")
                        'Set field value for ListID
                        TimeTrackingAddRq.ClassRef.ListID.SetValue("200000-1011023419")
                        'Set field value for FullName
                        TimeTrackingAddRq.ClassRef.FullName.SetValue("ab")
                        'Set field value for ListID
                        TimeTrackingAddRq.PayrollItemWageRef.ListID.SetValue("200000-1011023419")
                        'Set field value for FullName
                        TimeTrackingAddRq.PayrollItemWageRef.FullName.SetValue("ab")
                        'Set field value for Notes
                        TimeTrackingAddRq.Notes.SetValue("ab")
                        'Set field value for BillableStatus
                        TimeTrackingAddRq.BillableStatus.SetValue(ENBillableStatus.bsBillable)
                        'Set field value for IsBillable
                        TimeTrackingAddRq.IsBillable.SetValue(True)
                        'Set field value for ExternalGUID
                        TimeTrackingAddRq.ExternalGUID.SetValue(System.Guid.NewGuid().ToString())
                        'Set field value for IncludeRetElementList
                        'May create more than one of these if needed
                        TimeTrackingAddRq.IncludeRetElementList.Add("ab")
                End Sub




                Public Sub WalkTimeTrackingAddRs( responseMsgSet as IMsgSetResponse)
                        if (responseMsgSet is nothing) then
                                Exit Sub
                        End If

                        Dim responseList as IResponseList
                        responseList = responseMsgSet.ResponseList
                        if (responseList is nothing) then
                                Exit Sub
                        End If

                        'if we sent only one request, there is only one response, we'll walk the list for this sample
                        for j=0 to responseList.Count-1
                                Dim response as IResponse
                                response = responseList.GetAt(j)
                                'check the status code of the response, 0=ok, >0 is warning
                                if (response.StatusCode >= 0) then
                                        'the request-specific response is in the details, make sure we have some
                                        if (not response.Detail is nothing) then
                                                'make sure the response is the type we're expecting
                                                Dim responseType as ENResponseType
                                                responseType = CType(response.Type.GetValue(),ENResponseType)
                                                if (responseType == ENResponseType.rtTimeTrackingAddRs) then
                                                        'upcast to more specific type here, this is safe because we checked with response.Type check above
                                                        Dim TimeTrackingRet as ITimeTrackingRet
                                                        TimeTrackingRet = CType(response.Detail,ITimeTrackingRet)
                                                        WalkTimeTrackingRet(TimeTrackingRet)
                                                End If
                                        End If
                                End If
                        Next j
                End Sub




                Public Sub WalkTimeTrackingRet(TimeTrackingRet as ITimeTrackingRet)
                        if (TimeTrackingRet is nothing) then
                                Exit Sub
                        End If

                        'Go through all the elements of ITimeTrackingRet
                        'Get value of TxnID
                        Dim TxnID22307 as String
                        TxnID22307 = TimeTrackingRet.TxnID.GetValue()
                        'Get value of TimeCreated
                        Dim TimeCreated22308 as DateTime
                        TimeCreated22308 = TimeTrackingRet.TimeCreated.GetValue()
                        'Get value of TimeModified
                        Dim TimeModified22309 as DateTime
                        TimeModified22309 = TimeTrackingRet.TimeModified.GetValue()
                        'Get value of EditSequence
                        Dim EditSequence22310 as String
                        EditSequence22310 = TimeTrackingRet.EditSequence.GetValue()
                        'Get value of TxnNumber
                        if ( not TimeTrackingRet.TxnNumber is nothing) then
                                Dim TxnNumber22311 as Integer
                                TxnNumber22311 = TimeTrackingRet.TxnNumber.GetValue()
                        End If
                        'Get value of TxnDate
                        Dim TxnDate22312 as DateTime
                        TxnDate22312 = TimeTrackingRet.TxnDate.GetValue()
                        'Get value of ListID
                        if ( not TimeTrackingRet.EntityRef.ListID is nothing) then
                                Dim ListID22313 as String
                                ListID22313 = TimeTrackingRet.EntityRef.ListID.GetValue()
                        End If
                        'Get value of FullName
                        if ( not TimeTrackingRet.EntityRef.FullName is nothing) then
                                Dim FullName22314 as String
                                FullName22314 = TimeTrackingRet.EntityRef.FullName.GetValue()
                        End If
                        if (not TimeTrackingRet.CustomerRef. is nothing) then
                                'Get value of ListID
                                if ( not TimeTrackingRet.CustomerRef.ListID is nothing) then
                                        Dim ListID22315 as String
                                        ListID22315 = TimeTrackingRet.CustomerRef.ListID.GetValue()
                                End If
                                'Get value of FullName
                                if ( not TimeTrackingRet.CustomerRef.FullName is nothing) then
                                        Dim FullName22316 as String
                                        FullName22316 = TimeTrackingRet.CustomerRef.FullName.GetValue()
                                End If
                        End If
                        if (not TimeTrackingRet.ItemServiceRef. is nothing) then
                                'Get value of ListID
                                if ( not TimeTrackingRet.ItemServiceRef.ListID is nothing) then
                                        Dim ListID22317 as String
                                        ListID22317 = TimeTrackingRet.ItemServiceRef.ListID.GetValue()
                                End If
                                'Get value of FullName
                                if ( not TimeTrackingRet.ItemServiceRef.FullName is nothing) then
                                        Dim FullName22318 as String
                                        FullName22318 = TimeTrackingRet.ItemServiceRef.FullName.GetValue()
                                End If
                        End If
                        'Get value of Duration
                        Dim Duration22319 as IQBTimeIntervalType
                        Duration22319 = TimeTrackingRet.Duration.GetValue()
                        if (not TimeTrackingRet.ClassRef. is nothing) then
                                'Get value of ListID
                                if ( not TimeTrackingRet.ClassRef.ListID is nothing) then
                                        Dim ListID22320 as String
                                        ListID22320 = TimeTrackingRet.ClassRef.ListID.GetValue()
                                End If
                                'Get value of FullName
                                if ( not TimeTrackingRet.ClassRef.FullName is nothing) then
                                        Dim FullName22321 as String
                                        FullName22321 = TimeTrackingRet.ClassRef.FullName.GetValue()
                                End If
                        End If
                        if (not TimeTrackingRet.PayrollItemWageRef. is nothing) then
                                'Get value of ListID
                                if ( not TimeTrackingRet.PayrollItemWageRef.ListID is nothing) then
                                        Dim ListID22322 as String
                                        ListID22322 = TimeTrackingRet.PayrollItemWageRef.ListID.GetValue()
                                End If
                                'Get value of FullName
                                if ( not TimeTrackingRet.PayrollItemWageRef.FullName is nothing) then
                                        Dim FullName22323 as String
                                        FullName22323 = TimeTrackingRet.PayrollItemWageRef.FullName.GetValue()
                                End If
                        End If
                        'Get value of Notes
                        if ( not TimeTrackingRet.Notes is nothing) then
                                Dim Notes22324 as String
                                Notes22324 = TimeTrackingRet.Notes.GetValue()
                        End If
                        'Get value of BillableStatus
                        if ( not TimeTrackingRet.BillableStatus is nothing) then
                                Dim BillableStatus22325 as ENBillableStatus
                                BillableStatus22325 = TimeTrackingRet.BillableStatus.GetValue()
                        End If
                        'Get value of ExternalGUID
                        if ( not TimeTrackingRet.ExternalGUID is nothing) then
                                Dim ExternalGUID22326 as String
                                ExternalGUID22326 = TimeTrackingRet.ExternalGUID.GetValue()
                        End If
                        'Get value of IsBillable
                        if ( not TimeTrackingRet.IsBillable is nothing) then
                                Dim IsBillable22327 as Boolean
                                IsBillable22327 = TimeTrackingRet.IsBillable.GetValue()
                        End If
                        'Get value of IsBilled
                        if ( not TimeTrackingRet.IsBilled is nothing) then
                                Dim IsBilled22328 as Boolean
                                IsBilled22328 = TimeTrackingRet.IsBilled.GetValue()
                        End If
                End Sub




        End Class
End Module

//The following sample code is generated as an illustration of
//Creating requests and parsing responses ONLY
//This code is NOT intended to show best practices or ideal code
//Use at your most careful discretion

using System;
using System.Net;
using System.Drawing;
using System.Collections;
using System.ComponentModel;
using System.Windows.Forms;
using System.Data;
using System.IO;
using Interop.QBFC16;

namespace com.intuit.idn.samples
{
        public class Sample
        {
                public void  DoTimeTrackingAdd()
                {
                        bool sessionBegun = false;
                        bool connectionOpen = false;
                        QBSessionManager sessionManager = null;

                        try
                        {
                                //Create the session Manager object
                                sessionManager = new QBSessionManager();

                                //Create the message set request object to hold our request
                                IMsgSetRequest requestMsgSet = sessionManager.CreateMsgSetRequest("US",16,0);
                                requestMsgSet.Attributes.OnError = ENRqOnError.roeContinue;

                                BuildTimeTrackingAddRq(requestMsgSet);

                                //Connect to QuickBooks and begin a session
                                sessionManager.OpenConnection("","Sample Code from OSR");
                                connectionOpen = true;
                                sessionManager.BeginSession("", ENOpenMode.omDontCare);
                                sessionBegun = true;

                                //Send the request and get the response from QuickBooks
                                IMsgSetResponse responseMsgSet = sessionManager.DoRequests(requestMsgSet);

                                //End the session and close the connection to QuickBooks
                                sessionManager.EndSession();
                                sessionBegun = false;
                                sessionManager.CloseConnection();
                                connectionOpen = false;

                                WalkTimeTrackingAddRs(responseMsgSet);
                        }
                        catch (Exception e)
                        {
                                MessageBox.Show(e.Message, "Error");
                                if (sessionBegun)
                                {
                                        sessionManager.EndSession();
                                }
                                if (connectionOpen)
                                {
                                        sessionManager.CloseConnection();
                                }
                        }
                }
                void BuildTimeTrackingAddRq(IMsgSetRequest requestMsgSet)
                {
                        ITimeTrackingAdd TimeTrackingAddRq= requestMsgSet.AppendTimeTrackingAddRq();
                        //Set attributes
                        //Set field value for defMacro
                        TimeTrackingAddRq.defMacro.SetValue("IQBStringType");
                        //Set field value for TxnDate
                        TimeTrackingAddRq.TxnDate.SetValue(DateTime.Parse("12/15/2007"));
                        //Set field value for ListID
                        TimeTrackingAddRq.EntityRef.ListID.SetValue("200000-1011023419");
                        //Set field value for FullName
                        TimeTrackingAddRq.EntityRef.FullName.SetValue("ab");
                        //Set field value for ListID
                        TimeTrackingAddRq.CustomerRef.ListID.SetValue("200000-1011023419");
                        //Set field value for FullName
                        TimeTrackingAddRq.CustomerRef.FullName.SetValue("ab");
                        //Set field value for ListID
                        TimeTrackingAddRq.ItemServiceRef.ListID.SetValue("200000-1011023419");
                        //Set field value for FullName
                        TimeTrackingAddRq.ItemServiceRef.FullName.SetValue("ab");
                        //Set field value for Duration
                        TimeTrackingAddRq.Duration.SetValue("IQBTimeIntervalType");
                        //Set field value for ListID
                        TimeTrackingAddRq.ClassRef.ListID.SetValue("200000-1011023419");
                        //Set field value for FullName
                        TimeTrackingAddRq.ClassRef.FullName.SetValue("ab");
                        //Set field value for ListID
                        TimeTrackingAddRq.PayrollItemWageRef.ListID.SetValue("200000-1011023419");
                        //Set field value for FullName
                        TimeTrackingAddRq.PayrollItemWageRef.FullName.SetValue("ab");
                        //Set field value for Notes
                        TimeTrackingAddRq.Notes.SetValue("ab");
                        //Set field value for BillableStatus
                        TimeTrackingAddRq.BillableStatus.SetValue(ENBillableStatus.bsBillable);
                        //Set field value for IsBillable
                        TimeTrackingAddRq.IsBillable.SetValue(true);
                        //Set field value for ExternalGUID
                        TimeTrackingAddRq.ExternalGUID.SetValue(Guid.NewGuid().ToString());
                        //Set field value for IncludeRetElementList
                        //May create more than one of these if needed
                        TimeTrackingAddRq.IncludeRetElementList.Add("ab");
                }




                void WalkTimeTrackingAddRs(IMsgSetResponse responseMsgSet)
                {
                        if (responseMsgSet == null) return;
                        IResponseList responseList = responseMsgSet.ResponseList;
                        if (responseList == null) return;
                        //if we sent only one request, there is only one response, we'll walk the list for this sample
                        for(int i=0; i < responseList.Count; i++)
                        {
                                IResponse response = responseList.GetAt(i);
                                //check the status code of the response, 0=ok, >0 is warning
                                if (response.StatusCode >= 0)
                                {
                                        //the request-specific response is in the details, make sure we have some
                                        if (response.Detail != null)
                                        {
                                                //make sure the response is the type we're expecting
                                                ENResponseType responseType = (ENResponseType)response.Type.GetValue();
                                                if (responseType == ENResponseType.rtTimeTrackingAddRs)
                                                {
                                                        //upcast to more specific type here, this is safe because we checked with response.Type check above
                                                        ITimeTrackingRet TimeTrackingRet = (ITimeTrackingRet)response.Detail;
                                                        WalkTimeTrackingRet(TimeTrackingRet);
                                                }
                                        }
                                }
                        }
                }




                void WalkTimeTrackingRet(ITimeTrackingRet TimeTrackingRet)
                {
                        if (TimeTrackingRet == null) return;
                        //Go through all the elements of ITimeTrackingRet
                        //Get value of TxnID
                        string TxnID22285 = (string)TimeTrackingRet.TxnID.GetValue();
                        //Get value of TimeCreated
                        DateTime TimeCreated22286 = (DateTime)TimeTrackingRet.TimeCreated.GetValue();
                        //Get value of TimeModified
                        DateTime TimeModified22287 = (DateTime)TimeTrackingRet.TimeModified.GetValue();
                        //Get value of EditSequence
                        string EditSequence22288 = (string)TimeTrackingRet.EditSequence.GetValue();
                        //Get value of TxnNumber
                        if (TimeTrackingRet.TxnNumber != null)
                        {
                                int TxnNumber22289 = (int)TimeTrackingRet.TxnNumber.GetValue();
                        }
                        //Get value of TxnDate
                        DateTime TxnDate22290 = (DateTime)TimeTrackingRet.TxnDate.GetValue();
                        //Get value of ListID
                        if (TimeTrackingRet.EntityRef.ListID != null)
                        {
                                string ListID22291 = (string)TimeTrackingRet.EntityRef.ListID.GetValue();
                        }
                        //Get value of FullName
                        if (TimeTrackingRet.EntityRef.FullName != null)
                        {
                                string FullName22292 = (string)TimeTrackingRet.EntityRef.FullName.GetValue();
                        }
                        if (TimeTrackingRet.CustomerRef != null)
                        {
                                //Get value of ListID
                                if (TimeTrackingRet.CustomerRef.ListID != null)
                                {
                                        string ListID22293 = (string)TimeTrackingRet.CustomerRef.ListID.GetValue();
                                }
                                //Get value of FullName
                                if (TimeTrackingRet.CustomerRef.FullName != null)
                                {
                                        string FullName22294 = (string)TimeTrackingRet.CustomerRef.FullName.GetValue();
                                }
                        }
                        if (TimeTrackingRet.ItemServiceRef != null)
                        {
                                //Get value of ListID
                                if (TimeTrackingRet.ItemServiceRef.ListID != null)
                                {
                                        string ListID22295 = (string)TimeTrackingRet.ItemServiceRef.ListID.GetValue();
                                }
                                //Get value of FullName
                                if (TimeTrackingRet.ItemServiceRef.FullName != null)
                                {
                                        string FullName22296 = (string)TimeTrackingRet.ItemServiceRef.FullName.GetValue();
                                }
                        }
                        //Get value of Duration
                        IQBTimeIntervalType Duration22297 = (IQBTimeIntervalType)TimeTrackingRet.Duration.GetValue();
                        if (TimeTrackingRet.ClassRef != null)
                        {
                                //Get value of ListID
                                if (TimeTrackingRet.ClassRef.ListID != null)
                                {
                                        string ListID22298 = (string)TimeTrackingRet.ClassRef.ListID.GetValue();
                                }
                                //Get value of FullName
                                if (TimeTrackingRet.ClassRef.FullName != null)
                                {
                                        string FullName22299 = (string)TimeTrackingRet.ClassRef.FullName.GetValue();
                                }
                        }
                        if (TimeTrackingRet.PayrollItemWageRef != null)
                        {
                                //Get value of ListID
                                if (TimeTrackingRet.PayrollItemWageRef.ListID != null)
                                {
                                        string ListID22300 = (string)TimeTrackingRet.PayrollItemWageRef.ListID.GetValue();
                                }
                                //Get value of FullName
                                if (TimeTrackingRet.PayrollItemWageRef.FullName != null)
                                {
                                        string FullName22301 = (string)TimeTrackingRet.PayrollItemWageRef.FullName.GetValue();
                                }
                        }
                        //Get value of Notes
                        if (TimeTrackingRet.Notes != null)
                        {
                                string Notes22302 = (string)TimeTrackingRet.Notes.GetValue();
                        }
                        //Get value of BillableStatus
                        if (TimeTrackingRet.BillableStatus != null)
                        {
                                ENBillableStatus BillableStatus22303 = (ENBillableStatus)TimeTrackingRet.BillableStatus.GetValue();
                        }
                        //Get value of ExternalGUID
                        if (TimeTrackingRet.ExternalGUID != null)
                        {
                                string ExternalGUID22304 = (string)TimeTrackingRet.ExternalGUID.GetValue();
                        }
                        //Get value of IsBillable
                        if (TimeTrackingRet.IsBillable != null)
                        {
                                bool IsBillable22305 = (bool)TimeTrackingRet.IsBillable.GetValue();
                        }
                        //Get value of IsBilled
                        if (TimeTrackingRet.IsBilled != null)
                        {
                                bool IsBilled22306 = (bool)TimeTrackingRet.IsBilled.GetValue();
                        }
                }




        }
}