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