InventoryCostAdjustmentAdd

Adds a cost adjustment memo to QBPOS.


Request

Response

XMLOPS

VB.NET

C#

Tag Type Max length Implementation Required

IInventoryCostAdjustmentAdd

Adds a cost adjustment memo to QBPOS.
        

defMacro

You use a macro in a request message set if you need to create some object in one request, then refer to it in a subsequent request within that same message set. For example, you could create an inventory item and then include that item as a line item in a sales order all in one request message set, rather than create the item, query for it, then include it in a separate SalesOrderAdd request. In this latter case, you are accessing QBPOS three times, versus only once, using macros. The item to be referenced is specified via the defmacro. The actual reference to that item in the succeeding request is done via the use macro, as follows: ItemInventoryAdd defMacro=”ListID:Inv1” In the above line, you simply replace Inv1 with the name you want to give the macro. When you reference this macro in another request (one that requires that object’s listID) in the same message set, you use this syntax: ListID useMacro=”ListID:Inv1” This is covered in more detail in the Programming Guide.
 IQBStringType   2.0  

Associate

The employee making the adjustment transaction.
 IQBStringType 40 chars    

Comments

The Comment field contains a description of the transaction, for example, why a memo was issued, or why cash was paid out (receipt).
 IQBStringType 300 chars    

InventoryAdjustmentSource

The action or functionality that created the adjustment: manually created memo (Manual), physical inventory (Physical), Assembly item (Assembly).
 IQBENInventoryAdjustmentSourceType      

QuickBooksFlag

This element is used only if QBPOS is being used with QuickBooks Financial Software. The value here displays the status of data export for a memo: NOT POSTED (not yet sent to QuickBooks), COMPLETE (sent to QuickBooks), or ERROR (attempting to send the memo to QuickBooks resulted in an error). Values: NotPosted, Completed, Error, UnbilledPurchases No default value.
 IQBENQuickBooksFlagType      

Reason

Enter the reason for the adjustment or select from the following predefined reasons: Cycle Count (Cycl Cnt), Vendor Change (Vend Chg), Price Line (Prc Line), End of Season (Seas End), Annual (Annual), Shrinkage (Shrink), Stolen (Stolen), Damaged (Damaged), New Item (New Item).
 IQBStringType 8 chars   Y

StoreNumber

This is used only for multi-store versions of QBPOS. The value is between 1 and 10, since a maximum of 10 stores are currently supported.
 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      

TxnState

Indicates whether the transaction is complete (Normal) or is a “held document” (Held) which means it is not yet finalized. For example, a saved draft pending while awaiting some work or decision.
 IQBENTxnStateType   1.1  

Workstation

Workstation from which the transaction was made.
 IQBIntType      

InventoryCostAdjustmentItemAddList

The list of InventoryCostAdjustmentItemRet objects.
 IInventoryCostAdjustmentItemAddList      

(List of IInventoryCostAdjustmentItemAdd Objects)

        

ListID

The unique ID returned by QBPOS for this object. If supplied in a request, the ListID is a reference to an object required in the request. For example, in a SalesOrder or PurchaseOrder line item, the ListID that is required is an Item list ID.
 IQBIDType     Y

useMacro

You use a macro in a request message set if you need to create some object in one request, then refer to it in a subsequent request within that same message set. For example, you could create an inventory item and then include that item as a line item in a sales order all in one request message set, rather than create the item, query for it, then include it in a separate SalesOrderAdd request. In this latter case, you are accessing QBPOS three times, versus only once, using macros. The item to be referenced is specified via the defmacro. The actual reference to that item in the succeeding request is done via the use macro, as follows: ItemInventoryAdd defMacro=”ListID:Inv1” In the above line, you simply replace Inv1 with the name you want to give the macro. When you reference this macro in another request (one that requires that object’s listID) in the same message set, you use this syntax: ListID useMacro=”ListID:Inv1” This is covered in more detail in the Programming Guide.
 IQBStringType   2.0  

NewCost

You must specify a new cost for each inventory item being adjusted.
 IQBAmountType     Y

UnitOfMeasure

If the company is using only a single unit of measure, this specifies the unit of measure for the item. If the company is using multiple units of measure, this specifies the base unit of measure for the item. Inventory quantities are tracked and reported in terms of this base unit.
 IQBStringType 20 chars 2.0  

IncludeRetElementList

You can use the IncludeRetElement feature to restrict the data returned in the response to the specified qbposXML field here. If you do this, only those elements specified will be returned. To use this feature, you simply add the qbposXML element name to the IncludeRetElementList. The following example shows how to do this, specifying that only the CreatedBy and ClockOutTime elements are to be returned in the TimeEntryAdd response: Dim MyTimeEntry As ITimeEntryAdd Set MyTimeEntry = requestMsgSet.AppendTimeEntryAddRq MyTimeEntry.IncludeRetElementList.Add “CreatedBy” MyTimeEntry.IncludeRetElementList.Add “ClockOutTime” ‘ set the other properties as desired…
 IBSTRList 50 chars 2.0  
Tag Type Max length Implementation Required

IResponse

Adds a cost adjustment memo to QBPOS.
        

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

 IInventoryCostAdjustmentRet      

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      

TimeCreated

The timestamp indicating the time when this object was created in QBPOS.
 IQBDateTimeType   1.1  

TimeModified

The time when the object was modified by QBPOS.
 IQBDateTimeType      

Associate

The employee making the adjustment transaction.
 IQBStringType 40 chars    

Comments

The Comment field contains a description of the transaction, for example, why a memo was issued, or why cash was paid out (receipt).
 IQBStringType 300 chars    

CostDifference

Difference in cost for the item. The value displayed is equal to the New Cost minus the Old Cost.
 IQBAmountType      

HistoryDocStatus

Indicates the current status of the cost memo created as a result of this request. Status of reversed means that this was an original memo that had to be corrected. Status of reversing means that this memo caused an older memo to be reversed. Status of regular means that the document has been corrected.
 IQBENHistoryDocStatusType      

InventoryAdjustmentNumber

The adjustment number for an adjustment is automatically assigned by QBPOS when an adjustment is successfully added to QBPOS.
 IQBIntType      

InventoryAdjustmentSource

The action or functionality that created the adjustment: manually created memo (Manual), physical inventory (Physical), Assembly item (Assembly).
 IQBENInventoryAdjustmentSourceType      

ItemsCount

The number of line items in the adjustment add request that added the adjustment to QBPOS.
 IQBIntType      

NewCost

You must specify a new cost for each inventory item being adjusted.
 IQBAmountType      

OldCost

Inventory cost for this item before updating this memo.
 IQBAmountType      

QuickBooksFlag

This element is used only if QBPOS is being used with QuickBooks Financial Software. The value here displays the status of data export for a memo: NOT POSTED (not yet sent to QuickBooks), COMPLETE (sent to QuickBooks), or ERROR (attempting to send the memo to QuickBooks resulted in an error). Values: NotPosted, Completed, Error, UnbilledPurchases No default value.
 IQBENQuickBooksFlagType      

Reason

Enter the reason for the adjustment or select from the following predefined reasons: Cycle Count (Cycl Cnt), Vendor Change (Vend Chg), Price Line (Prc Line), End of Season (Seas End), Annual (Annual), Shrinkage (Shrink), Stolen (Stolen), Damaged (Damaged), New Item (New Item).
 IQBStringType 8 chars    

StoreExchangeStatus

In multi store configurations, if the customer’s information has changed, this information is updated at the headquarters store. This response field indicates whether the information was successfully updated or not.
 IQBENStoreExchangeStatusType      

StoreNumber

This is used only for multi-store versions of QBPOS. The value is between 1 and 10, since a maximum of 10 stores are currently supported.
 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      

TxnState

Indicates whether the transaction is complete (Normal) or is a “held document” (Held) which means it is not yet finalized. For example, a saved draft pending while awaiting some work or decision.
 IQBENTxnStateType   1.1  

Workstation

Workstation from which the transaction was made.
 IQBIntType      

InventoryCostAdjustmentItemRetList

The list of InventoryCostAdjustmentItemRet objects.
 IInventoryCostAdjustmentItemRetList      

(List of IInventoryCostAdjustmentItemRet Objects)

        

ListID

The unique ID returned by QBPOS for this object. If supplied in a request, the ListID is a reference to an object required in the request. For example, in a SalesOrder or PurchaseOrder line item, the ListID that is required is an Item list ID.
 IQBIDType      

CostDifference

Difference in cost for the item. The value displayed is equal to the New Cost minus the Old Cost.
 IQBAmountType      

NewCost

You must specify a new cost for each inventory item being adjusted.
 IQBAmountType      

NumberOfBaseUnits

If you use multiple units of measure, rather than a single UOM, you need to select one of the UOMs as the base unit. This base unit should be the smallest unit that you sell by. Inventory quantities are always expressed in terms of this base unit.
 IQBQuanType   2.0  

OldCost

Inventory cost for this item before updating this memo.
 IQBAmountType      

UnitOfMeasure

If the company is using only a single unit of measure, this specifies the unit of measure for the item. If the company is using multiple units of measure, this specifies the base unit of measure for the item. Inventory quantities are tracked and reported in terms of this base unit.
 IQBStringType 20 chars 2.0  

DataExtRetList

If you specify any custom fields/private data extensions to be returned in the query request (in the OwnerIDList), then this Ret List will contain all of the data extensions that belong to each specified OwnerID. For example, if you specify an OwnerID value of 0 (custom fields), then the query will return all custom data for the returned records.
 IDataExtRetList   1.2  

(List of IDataExtRet Objects)

        

OwnerID

OwnerID refers to the owner of a data extension, and must be 0 or a valid GUID. (Custom fields, which are visible in the QuickBooks UI, always have an OwnerID of 0. ) Usually you would keep your application’s GUID confidential to prevent other applications from accessing your data extensions. But if you want to share data extensions with another application, the applications need to use the same GUID. In this case, each application could use two GUIDs, one for shared data extensions and one for confidential data extensions. (An application can have any number of GUIDs.) When you share a 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     Y

DataExtName

The name of the data extension. If this is a custom field, DataExtName will be visible as a label in the QuickBooks user interface. Also because OwnerID and DataExtName together make the data extension unique, and because custom fields all have the same OwnerID of zero, the DataExtName must be a unique value among existing custom fields. In contrast, the DataExtName for private data extensions must be unique only for the specified OwnerID GUID.
 IQBStringType     Y

DataExtType

b>DataExtType The type of the data extension.
 IQBENDataExtTypeType     Y

DataExtValue

The data in this field. The maximum length of DataExtValue will depend on the DataExtType of this data extension. For example, if DataExtType is STR255TYPE, the maximum length of DataExtValue is 255 characters. If DataExtType is STR1024TYPE, the maximum size of DataExtValue is 1KB.
 IQBStringType     Y 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
<?xml version="1.0" encoding="utf-8"?>
<?qbposxml version="4.0"?>
<QBPOSXML>
        <QBPOSXMLMsgsRq onError="stopOnError">
                <InventoryCostAdjustmentAddRq>
                        <InventoryCostAdjustmentAdd defMacro="MACROTYPE"> <!-- required -->
                                <Associate >STRTYPE</Associate> <!-- optional -->
                                <Comments >STRTYPE</Comments> <!-- optional -->
                                <!-- InventoryAdjustmentSource may have one of the following values: Manual, PhysicalInventory, Assembly -->
                                <InventoryAdjustmentSource >ENUMTYPE</InventoryAdjustmentSource> <!-- optional -->
                                <!-- QuickBooksFlag may have one of the following values: NotPosted, Completed, Error, UnbilledPurchases -->
                                <QuickBooksFlag >ENUMTYPE</QuickBooksFlag> <!-- optional -->
                                <Reason >STRTYPE</Reason> <!-- required -->
                                <StoreNumber >INTTYPE</StoreNumber> <!-- optional -->
                                <TxnDate >DATETYPE</TxnDate> <!-- optional -->
                                <!-- TxnState may have one of the following values: Normal, Held -->
                                <TxnState >ENUMTYPE</TxnState> <!-- optional -->
                                <Workstation >INTTYPE</Workstation> <!-- optional -->
                                <InventoryCostAdjustmentItemAdd> <!-- optional, may repeat -->
                                        <ListID  useMacro="MACROTYPE">IDTYPE</ListID> <!-- required -->
                                        <NewCost >AMTTYPE</NewCost> <!-- required -->
                                        <UnitOfMeasure >STRTYPE</UnitOfMeasure> <!-- optional -->
                                </InventoryCostAdjustmentItemAdd>
                        </InventoryCostAdjustmentAdd>
                        <IncludeRetElement >STRTYPE</IncludeRetElement> <!-- optional, may repeat -->
                </InventoryCostAdjustmentAddRq>

                <InventoryCostAdjustmentAddRs statusCode="INTTYPE" statusSeverity="STRTYPE" statusMessage="STRTYPE">
                        <InventoryCostAdjustmentRet> <!-- optional -->
                                <TxnID >IDTYPE</TxnID> <!-- optional -->
                                <TimeCreated >DATETIMETYPE</TimeCreated> <!-- optional -->
                                <TimeModified >DATETIMETYPE</TimeModified> <!-- optional -->
                                <Associate >STRTYPE</Associate> <!-- optional -->
                                <Comments >STRTYPE</Comments> <!-- optional -->
                                <CostDifference >AMTTYPE</CostDifference> <!-- optional -->
                                <!-- HistoryDocStatus may have one of the following values: Regular, Reversed, Reversing -->
                                <HistoryDocStatus >ENUMTYPE</HistoryDocStatus> <!-- optional -->
                                <InventoryAdjustmentNumber >INTTYPE</InventoryAdjustmentNumber> <!-- optional -->
                                <!-- InventoryAdjustmentSource may have one of the following values: Manual, PhysicalInventory, Assembly -->
                                <InventoryAdjustmentSource >ENUMTYPE</InventoryAdjustmentSource> <!-- optional -->
                                <ItemsCount >INTTYPE</ItemsCount> <!-- optional -->
                                <NewCost >AMTTYPE</NewCost> <!-- optional -->
                                <OldCost >AMTTYPE</OldCost> <!-- optional -->
                                <!-- QuickBooksFlag may have one of the following values: NotPosted, Completed, Error, UnbilledPurchases -->
                                <QuickBooksFlag >ENUMTYPE</QuickBooksFlag> <!-- optional -->
                                <Reason >STRTYPE</Reason> <!-- optional -->
                                <!-- StoreExchangeStatus may have one of the following values: Modified, Sent, Acknowledged -->
                                <StoreExchangeStatus >ENUMTYPE</StoreExchangeStatus> <!-- optional -->
                                <StoreNumber >INTTYPE</StoreNumber> <!-- optional -->
                                <TxnDate >DATETYPE</TxnDate> <!-- optional -->
                                <!-- TxnState may have one of the following values: Normal, Held -->
                                <TxnState >ENUMTYPE</TxnState> <!-- optional -->
                                <Workstation >INTTYPE</Workstation> <!-- optional -->
                                <InventoryCostAdjustmentItemRet> <!-- optional, may repeat -->
                                        <ListID >IDTYPE</ListID> <!-- optional -->
                                        <CostDifference >AMTTYPE</CostDifference> <!-- optional -->
                                        <NewCost >AMTTYPE</NewCost> <!-- optional -->
                                        <NumberOfBaseUnits >QUANTYPE</NumberOfBaseUnits> <!-- optional -->
                                        <OldCost >AMTTYPE</OldCost> <!-- optional -->
                                        <UnitOfMeasure >STRTYPE</UnitOfMeasure> <!-- optional -->
                                </InventoryCostAdjustmentItemRet>
                                <DataExtRet> <!-- optional, may repeat -->
                                        <OwnerID >GUIDTYPE</OwnerID> <!-- required -->
                                        <DataExtName >STRTYPE</DataExtName> <!-- required -->
                                        <!-- DataExtType may have one of the following values: INTTYPE, AMTTYPE, PRICETYPE, QUANTYPE, PERCENTTYPE, DATETIMETYPE, STR255TYPE, STR1024TYPE -->
                                        <DataExtType >ENUMTYPE</DataExtType> <!-- required -->
                                        <DataExtValue >STRTYPE</DataExtValue> <!-- required -->
                                </DataExtRet>
                        </InventoryCostAdjustmentRet>
                </InventoryCostAdjustmentAddRs>
        </QBPOSXMLMsgsRq>
</QBPOSXML>


  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
'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.qbposfc4

        Public Class SampleInventoryCostAdjustmentAdd
                Public Sub  DoInventoryCostAdjustmentAdd()
                        Dim sessionBegun as Boolean
                        sessionBegun = False
                        Dim connectionOpen as Boolean
                        connectionOpen = False
                        Dim sessionManager as QBPOSSessionManager
                        sessionManager = nothing

                        Try
                                'Create the session Manager object
                                sessionManager = new QBPOSSessionManager

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

                                BuildInventoryCostAdjustmentAddRq(requestMsgSet)

                                'Connect to QuickBooks and begin a session
                                sessionManager.OpenConnection("","Sample Code from OSR")
                                connectionOpen = True
                                sessionManager.BeginSession("")
                                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

                                WalkInventoryCostAdjustmentAddRs(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 BuildInventoryCostAdjustmentAddRq(requestMsgSet as IMsgSetRequest)
                        Dim InventoryCostAdjustmentAddRq as IInventoryCostAdjustmentAdd
                        InventoryCostAdjustmentAddRq= requestMsgSet.AppendInventoryCostAdjustmentAddRq()
                        'Set field value for Associate
                        InventoryCostAdjustmentAddRq.Associate.SetValue("ab")
                        'Set field value for Comments
                        InventoryCostAdjustmentAddRq.Comments.SetValue("ab")
                        'Set field value for InventoryAdjustmentSource
                        InventoryCostAdjustmentAddRq.InventoryAdjustmentSource.SetValue(ENInventoryAdjustmentSource.iasManual)
                        'Set field value for QuickBooksFlag
                        InventoryCostAdjustmentAddRq.QuickBooksFlag.SetValue(ENQuickBooksFlag.qbfNotPosted)
                        'Set field value for Reason
                        InventoryCostAdjustmentAddRq.Reason.SetValue("ab")
                        'Set field value for StoreNumber
                        InventoryCostAdjustmentAddRq.StoreNumber.SetValue(6)
                        'Set field value for TxnDate
                        InventoryCostAdjustmentAddRq.TxnDate.SetValue(DateTime.Parse("12/15/2007"))
                        'Set field value for TxnState
                        InventoryCostAdjustmentAddRq.TxnState.SetValue(ENTxnState.tsNormal)
                        'Set field value for Workstation
                        InventoryCostAdjustmentAddRq.Workstation.SetValue(6)
                        Dim InventoryCostAdjustmentItemAdd891 as IInventoryCostAdjustmentItemAdd
                        InventoryCostAdjustmentItemAdd891=InventoryCostAdjustmentAddRq.InventoryCostAdjustmentItemAddList.Append()
                        'Set field value for ListID
                        InventoryCostAdjustmentItemAdd891.ListID.SetValue("200000-1011023419")
                        'Set attributes
                        'Set field value for ListID to use Macro
                        InventoryCostAdjustmentItemAdd891.ListID.SetValueUseMacro("200000-1011023419")
                        'Set field value for NewCost
                        InventoryCostAdjustmentItemAdd891.NewCost.SetValue(10.01)
                        'Set field value for UnitOfMeasure
                        InventoryCostAdjustmentItemAdd891.UnitOfMeasure.SetValue("ab")
                        'Set field value for IncludeRetElementList
                        'May create more than one of these if needed
                        InventoryCostAdjustmentAddRq.IncludeRetElementList.Add("ab")
                End Sub




                Public Sub WalkInventoryCostAdjustmentAddRs( 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.rtInventoryCostAdjustmentAddRs) then
                                                        'upcast to more specific type here, this is safe because we checked with response.Type check above
                                                        Dim InventoryCostAdjustmentRet as IInventoryCostAdjustmentRet
                                                        InventoryCostAdjustmentRet = CType(response.Detail,IInventoryCostAdjustmentRet)
                                                                WalkInventoryCostAdjustmentRet(InventoryCostAdjustmentRet)
                                                End If
                                        End If
                                End If
                        Next j
                End Sub




                Public Sub WalkInventoryCostAdjustmentRet(InventoryCostAdjustmentRet as IInventoryCostAdjustmentRet)
                        if (InventoryCostAdjustmentRet is nothing) then
                                Exit Sub
                        End If

                        'Go through all the elements of IInventoryCostAdjustmentRet
                        'Get value of TxnID
                        if ( not InventoryCostAdjustmentRet.TxnID is nothing) then
                                Dim TxnID892 as String
                                TxnID892 = InventoryCostAdjustmentRet.TxnID.GetValue()
                        End If
                        'Get value of TimeCreated
                        if ( not InventoryCostAdjustmentRet.TimeCreated is nothing) then
                                Dim TimeCreated893 as DateTime
                                TimeCreated893 = InventoryCostAdjustmentRet.TimeCreated.GetValue()
                        End If
                        'Get value of TimeModified
                        if ( not InventoryCostAdjustmentRet.TimeModified is nothing) then
                                Dim TimeModified894 as DateTime
                                TimeModified894 = InventoryCostAdjustmentRet.TimeModified.GetValue()
                        End If
                        'Get value of Associate
                        if ( not InventoryCostAdjustmentRet.Associate is nothing) then
                                Dim Associate895 as String
                                Associate895 = InventoryCostAdjustmentRet.Associate.GetValue()
                        End If
                        'Get value of Comments
                        if ( not InventoryCostAdjustmentRet.Comments is nothing) then
                                Dim Comments896 as String
                                Comments896 = InventoryCostAdjustmentRet.Comments.GetValue()
                        End If
                        'Get value of CostDifference
                        if ( not InventoryCostAdjustmentRet.CostDifference is nothing) then
                                Dim CostDifference897 as Double
                                CostDifference897 = InventoryCostAdjustmentRet.CostDifference.GetValue()
                        End If
                        'Get value of HistoryDocStatus
                        if ( not InventoryCostAdjustmentRet.HistoryDocStatus is nothing) then
                                Dim HistoryDocStatus898 as ENHistoryDocStatus
                                HistoryDocStatus898 = InventoryCostAdjustmentRet.HistoryDocStatus.GetValue()
                        End If
                        'Get value of InventoryAdjustmentNumber
                        if ( not InventoryCostAdjustmentRet.InventoryAdjustmentNumber is nothing) then
                                Dim InventoryAdjustmentNumber899 as Integer
                                InventoryAdjustmentNumber899 = InventoryCostAdjustmentRet.InventoryAdjustmentNumber.GetValue()
                        End If
                        'Get value of InventoryAdjustmentSource
                        if ( not InventoryCostAdjustmentRet.InventoryAdjustmentSource is nothing) then
                                Dim InventoryAdjustmentSource900 as ENInventoryAdjustmentSource
                                InventoryAdjustmentSource900 = InventoryCostAdjustmentRet.InventoryAdjustmentSource.GetValue()
                        End If
                        'Get value of ItemsCount
                        if ( not InventoryCostAdjustmentRet.ItemsCount is nothing) then
                                Dim ItemsCount901 as Integer
                                ItemsCount901 = InventoryCostAdjustmentRet.ItemsCount.GetValue()
                        End If
                        'Get value of NewCost
                        if ( not InventoryCostAdjustmentRet.NewCost is nothing) then
                                Dim NewCost902 as Double
                                NewCost902 = InventoryCostAdjustmentRet.NewCost.GetValue()
                        End If
                        'Get value of OldCost
                        if ( not InventoryCostAdjustmentRet.OldCost is nothing) then
                                Dim OldCost903 as Double
                                OldCost903 = InventoryCostAdjustmentRet.OldCost.GetValue()
                        End If
                        'Get value of QuickBooksFlag
                        if ( not InventoryCostAdjustmentRet.QuickBooksFlag is nothing) then
                                Dim QuickBooksFlag904 as ENQuickBooksFlag
                                QuickBooksFlag904 = InventoryCostAdjustmentRet.QuickBooksFlag.GetValue()
                        End If
                        'Get value of Reason
                        if ( not InventoryCostAdjustmentRet.Reason is nothing) then
                                Dim Reason905 as String
                                Reason905 = InventoryCostAdjustmentRet.Reason.GetValue()
                        End If
                        'Get value of StoreExchangeStatus
                        if ( not InventoryCostAdjustmentRet.StoreExchangeStatus is nothing) then
                                Dim StoreExchangeStatus906 as ENStoreExchangeStatus
                                StoreExchangeStatus906 = InventoryCostAdjustmentRet.StoreExchangeStatus.GetValue()
                        End If
                        'Get value of StoreNumber
                        if ( not InventoryCostAdjustmentRet.StoreNumber is nothing) then
                                Dim StoreNumber907 as Integer
                                StoreNumber907 = InventoryCostAdjustmentRet.StoreNumber.GetValue()
                        End If
                        'Get value of TxnDate
                        if ( not InventoryCostAdjustmentRet.TxnDate is nothing) then
                                Dim TxnDate908 as DateTime
                                TxnDate908 = InventoryCostAdjustmentRet.TxnDate.GetValue()
                        End If
                        'Get value of TxnState
                        if ( not InventoryCostAdjustmentRet.TxnState is nothing) then
                                Dim TxnState909 as ENTxnState
                                TxnState909 = InventoryCostAdjustmentRet.TxnState.GetValue()
                        End If
                        'Get value of Workstation
                        if ( not InventoryCostAdjustmentRet.Workstation is nothing) then
                                Dim Workstation910 as Integer
                                Workstation910 = InventoryCostAdjustmentRet.Workstation.GetValue()
                        End If
                        if (not InventoryCostAdjustmentRet.InventoryCostAdjustmentItemRetList is nothing)
                                Dim i911 as Integer
                                for i911 = 0  to InventoryCostAdjustmentRet.InventoryCostAdjustmentItemRetList.Count - 1
                                        Dim InventoryCostAdjustmentItemRet as IInventoryCostAdjustmentItemRet
                                        InventoryCostAdjustmentItemRet = InventoryCostAdjustmentRet.InventoryCostAdjustmentItemRetList.GetAt(i911)
                                        'Get value of ListID
                                        if ( not InventoryCostAdjustmentItemRet.ListID is nothing) then
                                                Dim ListID912 as String
                                                ListID912 = InventoryCostAdjustmentItemRet.ListID.GetValue()
                                        End If
                                        'Get value of CostDifference
                                        if ( not InventoryCostAdjustmentItemRet.CostDifference is nothing) then
                                                Dim CostDifference913 as Double
                                                CostDifference913 = InventoryCostAdjustmentItemRet.CostDifference.GetValue()
                                        End If
                                        'Get value of NewCost
                                        if ( not InventoryCostAdjustmentItemRet.NewCost is nothing) then
                                                Dim NewCost914 as Double
                                                NewCost914 = InventoryCostAdjustmentItemRet.NewCost.GetValue()
                                        End If
                                        'Get value of NumberOfBaseUnits
                                        if ( not InventoryCostAdjustmentItemRet.NumberOfBaseUnits is nothing) then
                                                Dim NumberOfBaseUnits915 as Double
                                                NumberOfBaseUnits915 = InventoryCostAdjustmentItemRet.NumberOfBaseUnits.GetValue()
                                        End If
                                        'Get value of OldCost
                                        if ( not InventoryCostAdjustmentItemRet.OldCost is nothing) then
                                                Dim OldCost916 as Double
                                                OldCost916 = InventoryCostAdjustmentItemRet.OldCost.GetValue()
                                        End If
                                        'Get value of UnitOfMeasure
                                        if ( not InventoryCostAdjustmentItemRet.UnitOfMeasure is nothing) then
                                                Dim UnitOfMeasure917 as String
                                                UnitOfMeasure917 = InventoryCostAdjustmentItemRet.UnitOfMeasure.GetValue()
                                        End If
                                Next i911
                        End If
                        if (not InventoryCostAdjustmentRet.DataExtRetList is nothing)
                                Dim i918 as Integer
                                for i918 = 0  to InventoryCostAdjustmentRet.DataExtRetList.Count - 1
                                        Dim DataExtRet as IDataExtRet
                                        DataExtRet = InventoryCostAdjustmentRet.DataExtRetList.GetAt(i918)
                                        'Get value of OwnerID
                                        Dim OwnerID919 as String
                                        OwnerID919 = DataExtRet.OwnerID.GetValue()
                                        'Get value of DataExtName
                                        Dim DataExtName920 as String
                                        DataExtName920 = DataExtRet.DataExtName.GetValue()
                                        'Get value of DataExtType
                                        Dim DataExtType921 as ENDataExtType
                                        DataExtType921 = DataExtRet.DataExtType.GetValue()
                                        'Get value of DataExtValue
                                        Dim DataExtValue922 as String
                                        DataExtValue922 = DataExtRet.DataExtValue.GetValue()
                                Next i918
                        End If
                End Sub




        End Class


  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
//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.qbposfc4;

namespace com.intuit.idn.samples
{
        public class SampleInventoryCostAdjustmentAdd
        {
                public void  DoInventoryCostAdjustmentAdd()
                {
                        bool sessionBegun = false;
                        bool connectionOpen = false;
                        QBPOSSessionManager sessionManager = null;

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

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

                                BuildInventoryCostAdjustmentAddRq(requestMsgSet);

                                //Connect to QuickBooks and begin a session
                                sessionManager.OpenConnection("","Sample Code from OSR");
                                connectionOpen = true;
                                sessionManager.BeginSession("");
                                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;

                                WalkInventoryCostAdjustmentAddRs(responseMsgSet);
                        }
                        catch (Exception e)
                        {
                                MessageBox.Show(e.Message, "Error");
                                if (sessionBegun)
                                {
                                        sessionManager.EndSession();
                                }
                                if (connectionOpen)
                                {
                                        sessionManager.CloseConnection();
                                }
                        }
                }
                void BuildInventoryCostAdjustmentAddRq(IMsgSetRequest requestMsgSet)
                {
                        IInventoryCostAdjustmentAdd InventoryCostAdjustmentAddRq= requestMsgSet.AppendInventoryCostAdjustmentAddRq();
                        //Set attributes
                        //Set field value for defMacro
                        InventoryCostAdjustmentAddRq.defMacro.SetValue("IQBStringType");
                        //Set field value for Associate
                        InventoryCostAdjustmentAddRq.Associate.SetValue("ab");
                        //Set field value for Comments
                        InventoryCostAdjustmentAddRq.Comments.SetValue("ab");
                        //Set field value for InventoryAdjustmentSource
                        InventoryCostAdjustmentAddRq.InventoryAdjustmentSource.SetValue(ENInventoryAdjustmentSource.iasManual);
                        //Set field value for QuickBooksFlag
                        InventoryCostAdjustmentAddRq.QuickBooksFlag.SetValue(ENQuickBooksFlag.qbfNotPosted);
                        //Set field value for Reason
                        InventoryCostAdjustmentAddRq.Reason.SetValue("ab");
                        //Set field value for StoreNumber
                        InventoryCostAdjustmentAddRq.StoreNumber.SetValue(6);
                        //Set field value for TxnDate
                        InventoryCostAdjustmentAddRq.TxnDate.SetValue(DateTime.Parse("12/15/2007"));
                        //Set field value for TxnState
                        InventoryCostAdjustmentAddRq.TxnState.SetValue(ENTxnState.tsNormal);
                        //Set field value for Workstation
                        InventoryCostAdjustmentAddRq.Workstation.SetValue(6);
                        IInventoryCostAdjustmentItemAdd InventoryCostAdjustmentItemAdd923=InventoryCostAdjustmentAddRq.InventoryCostAdjustmentItemAddList.Append();
                        //Set field value for ListID
                        InventoryCostAdjustmentItemAdd923.ListID.SetValue("200000-1011023419");
                        //Set attributes
                        //Set field value for ListID to use Macro
                        InventoryCostAdjustmentItemAdd923.ListID.SetValueUseMacro("200000-1011023419");
                        //Set field value for NewCost
                        InventoryCostAdjustmentItemAdd923.NewCost.SetValue(10.01);
                        //Set field value for UnitOfMeasure
                        InventoryCostAdjustmentItemAdd923.UnitOfMeasure.SetValue("ab");
                        //Set field value for IncludeRetElementList
                        //May create more than one of these if needed
                        InventoryCostAdjustmentAddRq.IncludeRetElementList.Add("ab");
                }




                void WalkInventoryCostAdjustmentAddRs(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.rtInventoryCostAdjustmentAddRs)
                                                {
                                                        //upcast to more specific type here, this is safe because we checked with response.Type check above
                                                        IInventoryCostAdjustmentRet InventoryCostAdjustmentRet = (IInventoryCostAdjustmentRet)response.Detail;
                                                                WalkInventoryCostAdjustmentRet(InventoryCostAdjustmentRet);
                                                }
                                        }
                                }
                        }
                }




                void WalkInventoryCostAdjustmentRet(IInventoryCostAdjustmentRet InventoryCostAdjustmentRet)
                {
                        if (InventoryCostAdjustmentRet == null) return;
                        //Go through all the elements of IInventoryCostAdjustmentRet
                        //Get value of TxnID
                        if (InventoryCostAdjustmentRet.TxnID != null)
                        {
                                string TxnID924 = (string)InventoryCostAdjustmentRet.TxnID.GetValue();
                        }
                        //Get value of TimeCreated
                        if (InventoryCostAdjustmentRet.TimeCreated != null)
                        {
                                DateTime TimeCreated925 = (DateTime)InventoryCostAdjustmentRet.TimeCreated.GetValue();
                        }
                        //Get value of TimeModified
                        if (InventoryCostAdjustmentRet.TimeModified != null)
                        {
                                DateTime TimeModified926 = (DateTime)InventoryCostAdjustmentRet.TimeModified.GetValue();
                        }
                        //Get value of Associate
                        if (InventoryCostAdjustmentRet.Associate != null)
                        {
                                string Associate927 = (string)InventoryCostAdjustmentRet.Associate.GetValue();
                        }
                        //Get value of Comments
                        if (InventoryCostAdjustmentRet.Comments != null)
                        {
                                string Comments928 = (string)InventoryCostAdjustmentRet.Comments.GetValue();
                        }
                        //Get value of CostDifference
                        if (InventoryCostAdjustmentRet.CostDifference != null)
                        {
                                double CostDifference929 = (double)InventoryCostAdjustmentRet.CostDifference.GetValue();
                        }
                        //Get value of HistoryDocStatus
                        if (InventoryCostAdjustmentRet.HistoryDocStatus != null)
                        {
                                ENHistoryDocStatus HistoryDocStatus930 = (ENHistoryDocStatus)InventoryCostAdjustmentRet.HistoryDocStatus.GetValue();
                        }
                        //Get value of InventoryAdjustmentNumber
                        if (InventoryCostAdjustmentRet.InventoryAdjustmentNumber != null)
                        {
                                int InventoryAdjustmentNumber931 = (int)InventoryCostAdjustmentRet.InventoryAdjustmentNumber.GetValue();
                        }
                        //Get value of InventoryAdjustmentSource
                        if (InventoryCostAdjustmentRet.InventoryAdjustmentSource != null)
                        {
                                ENInventoryAdjustmentSource InventoryAdjustmentSource932 = (ENInventoryAdjustmentSource)InventoryCostAdjustmentRet.InventoryAdjustmentSource.GetValue();
                        }
                        //Get value of ItemsCount
                        if (InventoryCostAdjustmentRet.ItemsCount != null)
                        {
                                int ItemsCount933 = (int)InventoryCostAdjustmentRet.ItemsCount.GetValue();
                        }
                        //Get value of NewCost
                        if (InventoryCostAdjustmentRet.NewCost != null)
                        {
                                double NewCost934 = (double)InventoryCostAdjustmentRet.NewCost.GetValue();
                        }
                        //Get value of OldCost
                        if (InventoryCostAdjustmentRet.OldCost != null)
                        {
                                double OldCost935 = (double)InventoryCostAdjustmentRet.OldCost.GetValue();
                        }
                        //Get value of QuickBooksFlag
                        if (InventoryCostAdjustmentRet.QuickBooksFlag != null)
                        {
                                ENQuickBooksFlag QuickBooksFlag936 = (ENQuickBooksFlag)InventoryCostAdjustmentRet.QuickBooksFlag.GetValue();
                        }
                        //Get value of Reason
                        if (InventoryCostAdjustmentRet.Reason != null)
                        {
                                string Reason937 = (string)InventoryCostAdjustmentRet.Reason.GetValue();
                        }
                        //Get value of StoreExchangeStatus
                        if (InventoryCostAdjustmentRet.StoreExchangeStatus != null)
                        {
                                ENStoreExchangeStatus StoreExchangeStatus938 = (ENStoreExchangeStatus)InventoryCostAdjustmentRet.StoreExchangeStatus.GetValue();
                        }
                        //Get value of StoreNumber
                        if (InventoryCostAdjustmentRet.StoreNumber != null)
                        {
                                int StoreNumber939 = (int)InventoryCostAdjustmentRet.StoreNumber.GetValue();
                        }
                        //Get value of TxnDate
                        if (InventoryCostAdjustmentRet.TxnDate != null)
                        {
                                DateTime TxnDate940 = (DateTime)InventoryCostAdjustmentRet.TxnDate.GetValue();
                        }
                        //Get value of TxnState
                        if (InventoryCostAdjustmentRet.TxnState != null)
                        {
                                ENTxnState TxnState941 = (ENTxnState)InventoryCostAdjustmentRet.TxnState.GetValue();
                        }
                        //Get value of Workstation
                        if (InventoryCostAdjustmentRet.Workstation != null)
                        {
                                int Workstation942 = (int)InventoryCostAdjustmentRet.Workstation.GetValue();
                        }
                        if (InventoryCostAdjustmentRet.InventoryCostAdjustmentItemRetList != null)
                        {
                                for (int i943 = 0; i943 < InventoryCostAdjustmentRet.InventoryCostAdjustmentItemRetList.Count; i943++)
                                {
                                        IInventoryCostAdjustmentItemRet InventoryCostAdjustmentItemRet = InventoryCostAdjustmentRet.InventoryCostAdjustmentItemRetList.GetAt(i943);
                                        //Get value of ListID
                                        if (InventoryCostAdjustmentItemRet.ListID != null)
                                        {
                                                string ListID944 = (string)InventoryCostAdjustmentItemRet.ListID.GetValue();
                                        }
                                        //Get value of CostDifference
                                        if (InventoryCostAdjustmentItemRet.CostDifference != null)
                                        {
                                                double CostDifference945 = (double)InventoryCostAdjustmentItemRet.CostDifference.GetValue();
                                        }
                                        //Get value of NewCost
                                        if (InventoryCostAdjustmentItemRet.NewCost != null)
                                        {
                                                double NewCost946 = (double)InventoryCostAdjustmentItemRet.NewCost.GetValue();
                                        }
                                        //Get value of NumberOfBaseUnits
                                        if (InventoryCostAdjustmentItemRet.NumberOfBaseUnits != null)
                                        {
                                                int NumberOfBaseUnits947 = (int)InventoryCostAdjustmentItemRet.NumberOfBaseUnits.GetValue();
                                        }
                                        //Get value of OldCost
                                        if (InventoryCostAdjustmentItemRet.OldCost != null)
                                        {
                                                double OldCost948 = (double)InventoryCostAdjustmentItemRet.OldCost.GetValue();
                                        }
                                        //Get value of UnitOfMeasure
                                        if (InventoryCostAdjustmentItemRet.UnitOfMeasure != null)
                                        {
                                                string UnitOfMeasure949 = (string)InventoryCostAdjustmentItemRet.UnitOfMeasure.GetValue();
                                        }
                                }
                        }
                        if (InventoryCostAdjustmentRet.DataExtRetList != null)
                        {
                                for (int i950 = 0; i950 < InventoryCostAdjustmentRet.DataExtRetList.Count; i950++)
                                {
                                        IDataExtRet DataExtRet = InventoryCostAdjustmentRet.DataExtRetList.GetAt(i950);
                                        //Get value of OwnerID
                                        string OwnerID951 = (string)DataExtRet.OwnerID.GetValue();
                                        //Get value of DataExtName
                                        string DataExtName952 = (string)DataExtRet.DataExtName.GetValue();
                                        //Get value of DataExtType
                                        ENDataExtType DataExtType953 = (ENDataExtType)DataExtRet.DataExtType.GetValue();
                                        //Get value of DataExtValue
                                        string DataExtValue954 = (string)DataExtRet.DataExtValue.GetValue();
                                }
                        }
                }




        }
}