LedgerWire

SalesOrder · Add

production passthrough only

SalesOrderAdd

Sales orders (Premier and Enterprise) track committed orders before invoicing and backorders.

qbXML request

SalesOrderAddRq
<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="13.0"?>
<QBXML>
  <QBXMLMsgsRq onError="stopOnError">
    <SalesOrderAddRq requestID="1">
      <SalesOrderAdd>
        <CustomerRef>
          <FullName>Bayside Builders LLC</FullName>
        </CustomerRef>
        <TxnDate>2026-11-09</TxnDate>
        <SalesOrderLineAdd>
          <ItemRef>
            <FullName>Thermostat T6</FullName>
          </ItemRef>
          <Quantity>10</Quantity>
        </SalesOrderLineAdd>
      </SalesOrderAdd>
    </SalesOrderAddRq>
  </QBXMLMsgsRq>
</QBXML>

JSON equivalent

POST /v1/qbxml
POST /v1/qbxml

Sent unchanged through the Web Connector in production. The hosted sandbox does not simulate this message yet and answers status 3250.

curl
curl -X POST https://ledgerwire.vibiz.app/v1/qbxml \
  -H "Authorization: Bearer $LEDGERWIRE_KEY" \
  -H "Content-Type: application/xml" \
  --data-binary @salesorderadd.xml

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

SalesOrderAddRs
<?xml version="1.0" ?>
<QBXML>
  <QBXMLMsgsRs>
    <SalesOrderAddRs requestID="1" statusCode="0" statusSeverity="Info" statusMessage="Status OK">
      <!-- SalesOrderRet with the record QuickBooks stored -->
      </SalesOrderAddRs>
    </QBXMLMsgsRs>
  </QBXML>

FAQ

Can I send SalesOrderAdd through LedgerWire?

Yes, in production: POST the qbXML to /v1/qbxml with a live key and it is passed to QuickBooks through the Web Connector unchanged.

Does the sandbox simulate SalesOrderAdd?

Not yet. The sandbox answers it with statusCode 3250 and a message saying so, rather than inventing a response. The ten core objects are fully simulated.

Which QuickBooks editions support it?

Sales orders exist in Premier, Accountant and Enterprise, not in Pro.

Sandbox fidelity

The sandbox does not simulate SalesOrderAdd yet and answers statusCode 3250 saying so. In production it is passed to QuickBooks unchanged.

Other Add messages

Skip the XML: call POST /v1/qbxml with JSON.

Get a free sandbox key