LedgerWire

PurchaseOrder · Add

production passthrough only

PurchaseOrderAdd

Purchase orders record what you ordered from a vendor; item receipts and bills can link to them.

qbXML request

PurchaseOrderAddRq
<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="13.0"?>
<QBXML>
  <QBXMLMsgsRq onError="stopOnError">
    <PurchaseOrderAddRq requestID="1">
      <PurchaseOrderAdd>
        <VendorRef>
          <FullName>Allied Pipe &amp; Valve</FullName>
        </VendorRef>
        <TxnDate>2026-11-09</TxnDate>
        <PurchaseOrderLineAdd>
          <ItemRef>
            <FullName>Copper Pipe 1/2in</FullName>
          </ItemRef>
          <Quantity>40</Quantity>
          <Rate>18.20</Rate>
        </PurchaseOrderLineAdd>
      </PurchaseOrderAdd>
    </PurchaseOrderAddRq>
  </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 @purchaseorderadd.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

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

FAQ

Can I send PurchaseOrderAdd 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 PurchaseOrderAdd?

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?

All current desktop editions (Pro, Premier, Accountant and Enterprise) support it.

Sandbox fidelity

The sandbox does not simulate PurchaseOrderAdd 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