LedgerWire

Bill · Mod

simulated in sandbox

BillMod

Bills record what you owe a vendor. They post to Accounts Payable and can carry expense lines (an account) and item lines (inventory you bought).

qbXML request

BillModRq
<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="13.0"?>
<QBXML>
  <QBXMLMsgsRq onError="stopOnError">
    <BillModRq requestID="1">
      <BillMod>
        <TxnID>34A-1793835062</TxnID>
        <EditSequence>1793835062</EditSequence>
        <Memo>October electric, meter 2</Memo>
      </BillMod>
    </BillModRq>
  </QBXMLMsgsRq>
</QBXML>

JSON equivalent

POST /v1/bills/34A-1793835062
{
  "memo": "October electric, meter 2",
  "editSequence": "1793835062"
}
curl
curl -X POST https://ledgerwire.vibiz.app/v1/bills/34A-1793835062 \
  -H "Authorization: Bearer $LEDGERWIRE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"memo":"October electric, meter 2","editSequence":"1793835062"}'

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)

BillModRs
<?xml version="1.0" ?>
<QBXML>
  <QBXMLMsgsRs>
    <BillModRs requestID="1" statusCode="0" statusSeverity="Info" statusMessage="Status OK">
      <BillRet>
        <TxnID>34A-1793835062</TxnID>
        <TimeCreated>2026-11-04T23:31:02+00:00</TimeCreated>
        <TimeModified>2026-11-04T23:31:02+00:00</TimeModified>
        <EditSequence>1793835122</EditSequence>
        <TxnNumber>7000</TxnNumber>
        <VendorRef>
          <ListID>80000088-1794871862</ListID>
          <FullName>Northside Properties LLC</FullName>
        </VendorRef>
        <APAccountRef>
          <ListID>80000007-1760311862</ListID>
          <FullName>Accounts Payable</FullName>
        </APAccountRef>
        <TxnDate>2026-11-04</TxnDate>
        <DueDate>2026-12-04</DueDate>
        <RefNumber>B-7001</RefNumber>
        <TermsRef>
          <FullName>Net 30</FullName>
        </TermsRef>
        <Memo>October electric, meter 2</Memo>
        <AmountDue>1433.52</AmountDue>
        <OpenAmount>1433.52</OpenAmount>
        <IsPaid>false</IsPaid>
        <ItemLineRet>
          <TxnLineID>34B-1793835062</TxnLineID>
          <ItemRef>
            <ListID>8000003D-1794871862</ListID>
            <FullName>Faucet Kitchen</FullName>
          </ItemRef>
          <Desc>Pull-down kitchen faucet</Desc>
          <Quantity>18</Quantity>
          <Cost>79.64</Cost>
          <Amount>1433.52</Amount>
        </ItemLineRet>
      </BillRet>
    </BillModRs>
  </QBXMLMsgsRs>
</QBXML>

FAQ

Why does BillMod need EditSequence?

QuickBooks uses EditSequence for optimistic locking. Send the value from your last query; if someone changed the bill since, QuickBooks answers 3200 and you re-read and retry.

Does BillMod 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 BillMod from JSON?

POST /v1/bills/{id} with the editSequence and the fields to change. LedgerWire builds the BillModRq for you.

Sandbox fidelity

The LedgerWire sandbox simulates BillMod 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 Bill messages

Other Mod messages

Skip the XML: call POST /v1/bills/34A-1793835062 with JSON.

Get a free sandbox key