CreditMemoAdd qbXML example
Adds a credit memo: a credit a customer can apply to invoices.
qbXML
CreditMemoAddRq, version 16.0
<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="16.0"?>
<QBXML>
<QBXMLMsgsRq onError="stopOnError">
<CreditMemoAddRq>
<CreditMemoAdd>
<CustomerRef>
<FullName>Acme Corp</FullName>
</CustomerRef>
<TxnDate>2026-01-15</TxnDate>
<RefNumber>1001</RefNumber>
<BillAddress>
<Addr1>123 Main St</Addr1>
<City>Springfield</City>
<State>IL</State>
<PostalCode>62701</PostalCode>
</BillAddress>
<Memo>Monthly service</Memo>
<CreditMemoLineAdd>
<ItemRef>
<FullName>Widget</FullName>
</ItemRef>
<Desc>Blue widget, large</Desc>
<Quantity>2</Quantity>
<Rate>125.00</Rate>
</CreditMemoLineAdd>
</CreditMemoAdd>
</CreditMemoAddRq>
</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}/credit-memos
{
"bill_address": {
"addr1": "123 Main St",
"city": "Springfield",
"postal_code": "62701",
"state": "IL"
},
"credit_memo_line_add": [
{
"desc": "Blue widget, large",
"item_ref": {
"full_name": "Widget"
},
"quantity": 2,
"rate": 125.0
}
],
"customer_ref": {
"full_name": "Acme Corp"
},
"memo": "Monthly service",
"ref_number": "1001",
"txn_date": "2026-01-15"
}
Every field CreditMemoAdd takes is in Intuit's reference.
More requests
Customers and sales