Update credit memo
update_credit_memoSome fields in a CreditMemoMod request can’t be cleared. If any of the following fields is included in a credit-memo modify request, it must contain a value:
The credit_memo_mod wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this operation's response_json: its data shape and the status codes to handle).
Possible errors (error.code / error.type; the call result explains each): 1030 unsupported_request, 3000 invalid_object_id, 3040 invalid_amount, 3070 string_too_long, 3120 object_not_found, 3140 invalid_reference, 3150 missing_element, 3170 cannot_modify, 3171 closing_date_modify, 3175 in_use, 3176 locked, 3200 stale_edit_sequence, 3210 invalid_value, 3220 not_authorized, 3231 request_not_processed, 3250 feature_not_enabled, 3260 insufficient_permission, 3261 personal_data_access_denied, 3262 payroll_subscription_required, 3263 read_only_access, 3264 merchant_services_subscription_required
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"edit_sequence": "<edit_sequence>",
"txn_id": "<txn_id>"
},
"name": "update_credit_memo"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fob | No | QuickBooks uses the term FOB, “freight on board,” to indicate the place from which the product is shipped. The FOB has no accounting implications. | |
| memo | No | The memo doesn’t print on the credit memo, but does appear in the account register and the customer register. | |
| other | No | Other, Other1, and Other2 are built-in transaction custom fields. Other is transaction-level; Other1 and Other2 are line-level. | |
| txn_id | Yes | `txn_id` is the unique QuickBooks identifier for a transaction. Use it to reference that transaction in later requests. | |
| due_date | No | The date on which payment is due. | |
| txn_date | No | The date of the transaction. In some cases, if you leave `txn_date` out of an -Add message, QuickBooks will prefill `txn_date` with the date of the last-saved transaction of the same type. | |
| class_ref | No | Use classes to categorize transactions (for example, by department, location, or work type). Class tracking is off by default in QuickBooks. | |
| po_number | No | Purchase order number. | |
| ship_date | No | The date when the product was, or will be, shipped. | |
| terms_ref | No | Refers to the payment terms associated with this entity. (This will be an item on the DateDrivenTerms or StandardTerms list.) | |
| is_pending | No | If `is_pending` is set to true, the credit memo hasn’t been completed. | |
| ref_number | No | `ref_number` is a user-managed transaction reference (for example, a check number). It can be edited and is not guaranteed to be globally unique. | |
| request_id | No | Your own label for the request, sent to QuickBooks as its qbXML `requestID` and echoed in the raw answer (`response_xml`); optional, since the answer's webhook already carries the request's `id`. | |
| bill_address | No | This aggregate supports at most five address lines. You can provide a structured address (Addr1-Addr3 plus City/State/`postal_code`/etc.) or use block mode (Addr1-Addr5 only). | |
| customer_ref | No | `customer_ref` identifies a customer or customer job. If both `full_name` and `list_id` are provided, `full_name` is ignored. In SalesReceipt and ReceivePayment, it identifies who receives credit. | |
| ship_address | No | This aggregate supports at most five address lines. You can provide a structured address (Addr1-Addr3 plus City/State/`postal_code`/etc.) or use block mode (Addr1-Addr5 only). | |
| template_ref | No | QuickBooks templates specify how to print certain transactions. A template query returns the names of all templates that have been defined in QuickBooks. | |
| edit_sequence | Yes | `edit_sequence` is a server-generated revision token. It changes each time the object is updated. To modify an existing object, you must send the current `edit_sequence`. | |
| exchange_rate | No | `exchange_rate` is the rate from this currency to the company’s home currency at AsOfDate. You can supply a rate when adding transactions, but QuickBooks does not provide rates through the SDK. | |
| include_qbxml | No | Also return the qbXML this compiles to, for debugging. Not part of the v2 request. | |
| sales_rep_ref | No | A sales representative must be on the Employee, Vendor, or Other Names list within QuickBooks. Sales representative’s names and initials appear on the Rep drop-down list on QuickBooks sales forms. | |
| ar_account_ref | No | `ar_account_ref` points to an Accounts Receivable account. If both `full_name` and `list_id` are provided, `full_name` is ignored. | |
| is_tax_included | No | For future use with international versions of QuickBooks. | |
| ship_method_ref | No | A shipping method, for example, standard mail or overnight delivery. A `ship_method_ref` aggregate refers to an item on the ShipMethod list. | |
| customer_msg_ref | No | A standard message such as “Thank you for your business,” or “Please sign and return this estimate to indicate your approval.” A customer message can be included at the bottom of a form. | |
| is_to_be_emailed | No | When enabled, QuickBooks validates the customer email at runtime before sending. If no valid email is available, the request fails. | |
| is_to_be_printed | No | If `is_to_be_printed` is true, QuickBooks queues the form for later printing. It does not print immediately; printing is still a user action in QuickBooks. | |
| item_sales_tax_ref | No | An ItemSalesTax entry represents one tax rate paid to one tax agency. Use it when a transaction needs a single tax calculation. For multi-rate scenarios, use a sales-tax group instead. | |
| include_ret_element | No | ||
| credit_memo_line_mod | No | Represents one line in the credit memo. Compare with CreditMemoGroupLine, which represents a previously defined group of lines in the credit memo. `credit_memo_line_mod` and `credit_memo_line_group_mod` combine: any number of each. QuickBooks receives them in that order: every `credit_memo_line_mod`, then every `credit_memo_line_group_mod`. | |
| credit_memo_line_group_mod | No | Represents a previously defined group of lines in the credit memo. Compare with CreditMemoLine, which represents just one line in the credit memo. `credit_memo_line_mod` and `credit_memo_line_group_mod` combine: any number of each. QuickBooks receives them in that order: every `credit_memo_line_mod`, then every `credit_memo_line_group_mod`. | |
| customer_sales_tax_code_ref | No | Refers to the sales-tax code for sales related to this customer. (That is, it refers to a member of the SalesTaxCode list.) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Replace {connection_id} with the customer's connection. | |
| body | Yes | The JSON body: the arguments you passed. | |
| qbxml | No | The qbXML it compiles to. Only with include_qbxml. | |
| method | Yes | ||
| headers | Yes | Send with the request. Resent unchanged when no 201 came back, it answers with the request already queued. | |
| webhook | Yes | JSON Schema of the payload POSTed to webhook_url once QuickBooks answers, with this operation's response_json (data shape and status codes). |