BillAdd qbXML example

Adds a bill: money owed to a vendor, entered in accounts payable.

qbXML BillAddRq, version 16.0
<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="16.0"?>
<QBXML>
  <QBXMLMsgsRq onError="stopOnError">
    <BillAddRq>
      <BillAdd>
        <VendorRef>
          <FullName>Northwind Supplies</FullName>
        </VendorRef>
        <TxnDate>2026-01-15</TxnDate>
        <DueDate>2026-02-14</DueDate>
        <RefNumber>INV-2291</RefNumber>
        <Memo>January order</Memo>
        <ExpenseLineAdd>
          <AccountRef>
            <FullName>Freight</FullName>
          </AccountRef>
          <Amount>18.50</Amount>
          <Memo>Shipping</Memo>
        </ExpenseLineAdd>
        <ItemLineAdd>
          <ItemRef>
            <FullName>Widget</FullName>
          </ItemRef>
          <Desc>Blue widget, large</Desc>
          <Quantity>2</Quantity>
          <Cost>60.00</Cost>
        </ItemLineAdd>
      </BillAdd>
    </BillAddRq>
  </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.
  • Use ItemLineAdd for items bought and ExpenseLineAdd for amounts posted straight to an account. A bill can have both.

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}/bills
{
  "due_date": "2026-02-14",
  "expense_line_add": [
    {
      "account_ref": {
        "full_name": "Freight"
      },
      "amount": 18.5,
      "memo": "Shipping"
    }
  ],
  "item_line_add": [
    {
      "cost": 60.0,
      "desc": "Blue widget, large",
      "item_ref": {
        "full_name": "Widget"
      },
      "quantity": 2
    }
  ],
  "memo": "January order",
  "ref_number": "INV-2291",
  "txn_date": "2026-01-15",
  "vendor_ref": {
    "full_name": "Northwind Supplies"
  }
}

Every field BillAdd takes is in Intuit's reference.

More requests

Vendors and purchases

All qbXML examples