QuickBooks Integrator 2020 macOS Edition

Questions / Feedback?

Update Method

Updates the item in QuickBooks.

Syntax

public func update() throws -> Void

Remarks

Only supported for US versions of QuickBooks 2003 or higher. You must set QBXMLVersion to "2.0" or higher before invoking this method.

This method will update the item in QuickBooks. Only inventory items, non-inventory items, and service items may be updated. If you attempt to invoke Update when ItemType is not set to itInventory, itNonInventory, or itService, the class will fail with an error.

When the method is called, an Update request will be submitted to QuickBooks. The item represented by RefId will have its information updated based on the various property values.

If QuickBooks is able to update the object, it will return a copy of the object, and the values of all properties will be reset from the QuickBooks response. The QBResponseAggregate property will also be set to the entire QBXML aggregate received from QuickBooks.

Not all property values can be modified through /n software QuickBooks Integrator. In particular, for non-inventory and service items the values of Account and PurchaseExpenseAccount may not be modified, and their values will be ignored when submitting an Update request.

One condition must be met for an Update operation to succeed: QuickBooks checks a property called EditSequence. EditSequence is similar to RefId, but is changed every time the object is changed. When an Updateoperation is submitted, the server compares EditSequence with its own EditSequence for the object. If they match, this means that the client program has the latest copy of the object, and the Update operation is permitted. If they don't match, an error will be returned.

If this object represents a value returned from QuickBooks (i.e., a Get or Add call has been made, or the QBResponseAggregate property has been set), the EditSequence will be automatically set. Otherwise this value may be accessed through Config.

Copyright (c) 2021 /n software inc. - All rights reserved.
QuickBooks Integrator 2020 macOS Edition - Version 20.0 [Build 7941]