ItemInventory · Mod
simulated in sandboxItemInventoryMod
Inventory items are stock QuickBooks tracks with quantity on hand and average cost. They need an income, a COGS and an asset account.
qbXML request
<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="13.0"?>
<QBXML>
<QBXMLMsgsRq onError="stopOnError">
<ItemInventoryModRq requestID="1">
<ItemInventoryMod>
<ListID>8000002D-1794871862</ListID>
<EditSequence>1770249597</EditSequence>
<SalesPrice>199.00</SalesPrice>
</ItemInventoryMod>
</ItemInventoryModRq>
</QBXMLMsgsRq>
</QBXML>JSON equivalent
{
"type": "inventory",
"salesPrice": 199,
"editSequence": "1770249597"
}curl -X POST https://ledgerwire.vibiz.app/v1/items/8000002D-1794871862 \
-H "Authorization: Bearer $LEDGERWIRE_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"inventory","salesPrice":199,"editSequence":"1770249597"}'Run this request against your own sandbox
Add and Mod requests change data, so they run in a private sandbox, not the shared demo. Get a free key (10 seconds), then POST the request above to /v1/qbxml.
qbXML response (from the sandbox seed data)
<?xml version="1.0" ?>
<QBXML>
<QBXMLMsgsRs>
<ItemInventoryModRs requestID="1" statusCode="0" statusSeverity="Info" statusMessage="Status OK">
<ItemInventoryRet>
<ListID>8000002D-1794871862</ListID>
<TimeCreated>2026-02-04T23:59:57+00:00</TimeCreated>
<TimeModified>2026-02-04T23:59:57+00:00</TimeModified>
<EditSequence>1770249657</EditSequence>
<Name>Copper Pipe 1/2in</Name>
<FullName>Copper Pipe 1/2in</FullName>
<IsActive>true</IsActive>
<Sublevel>0</Sublevel>
<QuantityOnHand>108</QuantityOnHand>
<AverageCost>18.20</AverageCost>
<AssetAccountRef>
<ListID>80000005-1760311862</ListID>
<FullName>Inventory Asset</FullName>
</AssetAccountRef>
<COGSAccountRef>
<ListID>8000000F-1760311862</ListID>
<FullName>Cost of Goods Sold</FullName>
</COGSAccountRef>
<IncomeAccountRef>
<ListID>8000000D-1760311862</ListID>
<FullName>Sales Income</FullName>
</IncomeAccountRef>
<PurchaseCost>18.20</PurchaseCost>
<PurchaseDesc>Copper pipe, 1/2 in x 10 ft</PurchaseDesc>
<ReorderPoint>2</ReorderPoint>
<SalesDesc>Copper pipe, 1/2 in x 10 ft</SalesDesc>
<SalesPrice>199.00</SalesPrice>
</ItemInventoryRet>
</ItemInventoryModRs>
</QBXMLMsgsRs>
</QBXML>FAQ
Why does ItemInventoryMod need EditSequence?
QuickBooks uses EditSequence for optimistic locking. Send the value from your last query; if someone changed the item since, QuickBooks answers 3200 and you re-read and retry.
Does ItemInventoryMod replace the whole record?
No, only the elements you send change. Lines are the exception on transactions: send every line you want to keep with its TxnLineID, and TxnLineID -1 for new ones.
How do I call ItemInventoryMod from JSON?
POST /v1/items/{id} with the editSequence and the fields to change. LedgerWire builds the ItemInventoryModRq for you.
Sandbox fidelity
The LedgerWire sandbox simulates ItemInventoryMod with QuickBooks rules: required fields, element names, refs that must exist (3140), unique names (3100), field lengths (3070) and EditSequence locking (3200). Tax calculation, custom fields and preferences are not simulated.
More ItemInventory messages
Skip the XML: call POST /v1/items/8000002D-1794871862 with JSON.
Get a free sandbox key