LedgerWire

Invoice · Mod

simulated in sandbox

InvoiceMod

Invoices record a sale on credit. QuickBooks posts them to Accounts Receivable and tracks BalanceRemaining until received payments are applied.

qbXML request

InvoiceModRq
<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="13.0"?>
<QBXML>
  <QBXMLMsgsRq onError="stopOnError">
    <InvoiceModRq requestID="1">
      <InvoiceMod>
        <TxnID>101-1780874052</TxnID>
        <EditSequence>1781910852</EditSequence>
        <DueDate>2026-12-15</DueDate>
        <Memo>October service, PO 7781</Memo>
      </InvoiceMod>
    </InvoiceModRq>
  </QBXMLMsgsRq>
</QBXML>

JSON equivalent

POST /v1/invoices/101-1780874052
{
  "memo": "October service, PO 7781",
  "dueDate": "2026-12-15",
  "editSequence": "1781910852"
}
curl
curl -X POST https://ledgerwire.vibiz.app/v1/invoices/101-1780874052 \
  -H "Authorization: Bearer $LEDGERWIRE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"memo":"October service, PO 7781","dueDate":"2026-12-15","editSequence":"1781910852"}'

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)

InvoiceModRs
<?xml version="1.0" ?>
<QBXML>
  <QBXMLMsgsRs>
    <InvoiceModRs requestID="1" statusCode="0" statusSeverity="Info" statusMessage="Status OK">
      <InvoiceRet>
        <TxnID>101-1780874052</TxnID>
        <TimeCreated>2026-06-07T23:14:12+00:00</TimeCreated>
        <TimeModified>2026-06-19T23:14:12+00:00</TimeModified>
        <EditSequence>1781910912</EditSequence>
        <TxnNumber>1000</TxnNumber>
        <CustomerRef>
          <ListID>8000006F-1794870852</ListID>
          <FullName>Clearwater Facilities Group</FullName>
        </CustomerRef>
        <ARAccountRef>
          <ListID>80000003-1760310852</ListID>
          <FullName>Accounts Receivable</FullName>
        </ARAccountRef>
        <TemplateRef>
          <FullName>Intuit Service Invoice</FullName>
        </TemplateRef>
        <TxnDate>2026-06-07</TxnDate>
        <RefNumber>1001</RefNumber>
        <BillAddress>
          <Addr1>Clearwater Facilities Group</Addr1>
          <Addr2>8932 River Rd</Addr2>
          <City>Madison</City>
          <State>WI</State>
          <PostalCode>53703</PostalCode>
          <Country>US</Country>
        </BillAddress>
        <IsPending>false</IsPending>
        <TermsRef>
          <FullName>Net 15</FullName>
        </TermsRef>
        <DueDate>2026-12-15</DueDate>
        <Memo>October service, PO 7781</Memo>
        <IsToBePrinted>false</IsToBePrinted>
        <IsToBeEmailed>false</IsToBeEmailed>
        <Subtotal>24.75</Subtotal>
        <SalesTaxPercentage>0</SalesTaxPercentage>
        <SalesTaxTotal>0.00</SalesTaxTotal>
        <AppliedAmount>-24.75</AppliedAmount>
        <BalanceRemaining>0.00</BalanceRemaining>
        <IsPaid>true</IsPaid>
        <InvoiceLineRet>
          <TxnLineID>100-1780874052</TxnLineID>
          <ItemRef>
            <ListID>8000002E-1794870852</ListID>
            <FullName>PVC Elbow 2in</FullName>
          </ItemRef>
          <Desc>PVC 90 degree elbow, 2 in</Desc>
          <Quantity>9</Quantity>
          <Rate>2.75</Rate>
          <Amount>24.75</Amount>
        </InvoiceLineRet>
      </InvoiceRet>
    </InvoiceModRs>
  </QBXMLMsgsRs>
</QBXML>

FAQ

Why does InvoiceMod need EditSequence?

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

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

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

Sandbox fidelity

The LedgerWire sandbox simulates InvoiceMod 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 Invoice messages

Other Mod messages

Skip the XML: call POST /v1/invoices/101-1780874052 with JSON.

Get a free sandbox key