Vendor · Mod
simulated in sandboxVendorMod
Vendors are who you buy from: suppliers, landlords, utilities and contractors. Bills and bill payments point at a vendor through VendorRef or PayeeEntityRef.
qbXML request
<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="13.0"?>
<QBXML>
<QBXMLMsgsRq onError="stopOnError">
<VendorModRq requestID="1">
<VendorMod>
<ListID>8000007D-1794881794</ListID>
<EditSequence>1762475044</EditSequence>
<Phone>(918) 555-0110</Phone>
</VendorMod>
</VendorModRq>
</QBXMLMsgsRq>
</QBXML>JSON equivalent
{
"phone": "(918) 555-0110",
"editSequence": "1762475044"
}curl -X POST https://ledgerwire.vibiz.app/v1/vendors/8000007D-1794881794 \
-H "Authorization: Bearer $LEDGERWIRE_KEY" \
-H "Content-Type: application/json" \
-d '{"phone":"(918) 555-0110","editSequence":"1762475044"}'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>
<VendorModRs requestID="1" statusCode="0" statusSeverity="Info" statusMessage="Status OK">
<VendorRet>
<ListID>8000007D-1794881794</ListID>
<TimeCreated>2025-11-07T00:24:04+00:00</TimeCreated>
<TimeModified>2025-11-07T00:24:04+00:00</TimeModified>
<EditSequence>1762475104</EditSequence>
<Name>Ferguson Supply Partners</Name>
<IsActive>true</IsActive>
<CompanyName>Ferguson Supply Partners</CompanyName>
<VendorAddress>
<Addr1>Ferguson Supply Partners</Addr1>
<Addr2>1510 River Rd</Addr2>
<City>Tulsa</City>
<State>OK</State>
<PostalCode>74103</PostalCode>
</VendorAddress>
<Phone>(918) 555-0110</Phone>
<NameOnCheck>Ferguson Supply Partners</NameOnCheck>
<TermsRef>
<FullName>Net 30</FullName>
</TermsRef>
<Balance>0.00</Balance>
</VendorRet>
</VendorModRs>
</QBXMLMsgsRs>
</QBXML>FAQ
Why does VendorMod need EditSequence?
QuickBooks uses EditSequence for optimistic locking. Send the value from your last query; if someone changed the vendor since, QuickBooks answers 3200 and you re-read and retry.
Does VendorMod 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 VendorMod from JSON?
POST /v1/vendors/{id} with the editSequence and the fields to change. LedgerWire builds the VendorModRq for you.
Sandbox fidelity
The LedgerWire sandbox simulates VendorMod 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 Vendor messages
Skip the XML: call POST /v1/vendors/8000007D-1794881794 with JSON.
Get a free sandbox key