PurchaseOrderAdd qbXML example

Adds a purchase order to a vendor.

qbXML PurchaseOrderAddRq, version 16.0
<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="16.0"?>
<QBXML>
  <QBXMLMsgsRq onError="stopOnError">
    <PurchaseOrderAddRq>
      <PurchaseOrderAdd>
        <VendorRef>
          <FullName>Northwind Supplies</FullName>
        </VendorRef>
        <TxnDate>2026-01-15</TxnDate>
        <RefNumber>1001</RefNumber>
        <Memo>Monthly service</Memo>
        <PurchaseOrderLineAdd>
          <ItemRef>
            <FullName>Widget</FullName>
          </ItemRef>
          <Desc>Blue widget, large</Desc>
          <Quantity>2</Quantity>
          <Rate>125.00</Rate>
        </PurchaseOrderLineAdd>
      </PurchaseOrderAdd>
    </PurchaseOrderAddRq>
  </QBXMLMsgsRq>
</QBXML>
Open in the validator Check it against the qbXML 16.0 schema, edit it, and run it in your own QuickBooks.

Things to know

  • Write amounts with two decimals (40.00, not 40). QuickBooks refuses a whole-number amount with status 3040, though the schema allows it.
  • A *Ref that names a record QuickBooks doesn't have answers 3120 when it gives a ListID and 3140 when it gives a FullName.

The same request with QuBe Sync's API

QuBe Sync takes this JSON, writes the qbXML for you and delivers QuickBooks' answer to your webhook as JSON.

POST /api/v2/connections/{connection_id}/purchase-orders
{
  "memo": "Monthly service",
  "purchase_order_line_add": [
    {
      "desc": "Blue widget, large",
      "item_ref": {
        "full_name": "Widget"
      },
      "quantity": 2,
      "rate": 125.0
    }
  ],
  "ref_number": "1001",
  "txn_date": "2026-01-15",
  "vendor_ref": {
    "full_name": "Northwind Supplies"
  }
}

Every field PurchaseOrderAdd takes is in Intuit's reference.

More requests

Vendors and purchases

All qbXML examples