Create journal entry
create_journal_entryIn versions 1.0 and 1.1, all debit lines in a JournalEntryAdd request had to appear first, followed by all credit lines. But in versions 2.0 and above, the debit and credit lines can be intermingled. A credit line can legally come first in thejournal entry add.
The journal_entry_add 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, 3175 in_use, 3176 locked, 3180 cannot_save, 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, 3270 missing_posting_account
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "create_journal_entry"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| memo | No | Additional information. | |
| 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. | |
| def_macro | No | `def_macro` lets you assign a reusable name to a returned `txn_id` or `txn_line_id` so later requests can reference it with `useMacro`. This feature requires SDK 2.0+. | |
| 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`. | |
| currency_ref | No | A currency record defines how QuickBooks stores and displays a currency. Built-in currency name/code values are fixed; formatting and active status can vary by settings and workflow. Choose at most one of: `is_home_currency_adjustment`, or the set (`currency_ref`, `exchange_rate`, `is_amounts_entered_in_home_currency`). Members of a set combine with each other, not with the other choices. | |
| 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. Choose at most one of: `is_home_currency_adjustment`, or the set (`currency_ref`, `exchange_rate`, `is_amounts_entered_in_home_currency`). Members of a set combine with each other, not with the other choices. | |
| external_guid | No | Allows for the attachment of a user defined GUID value. | |
| include_qbxml | No | Also return the qbXML this compiles to, for debugging. Not part of the v2 request. | |
| is_adjustment | No | When a change is an “adjustment,” the original information is retained, usually so an accountant can see the effects of the adjustment. | |
| journal_debit_line | No | If no amount is included in the first debit line (or credit line) of a journal entry in the QuickBooks user interface, then subsequent SDK queries on that JournalEntry object will fail XML validation. At least one entry is required across `journal_debit_line` and `journal_credit_line`; they combine, any number of each. QuickBooks receives them in that order: every `journal_debit_line`, then every `journal_credit_line`. | |
| include_ret_element | No | ||
| journal_credit_line | No | If no amount is included in the first credit line (or debit line) of a journal entry in the QuickBooks user interface, then subsequent SDK queries on that JournalEntry object will fail XML validation. At least one entry is required across `journal_debit_line` and `journal_credit_line`; they combine, any number of each. QuickBooks receives them in that order: every `journal_debit_line`, then every `journal_credit_line`. | |
| is_home_currency_adjustment | No | Indicates whether the transaction is using a home currency or foreign currency. Choose at most one of: `is_home_currency_adjustment`, or the set (`currency_ref`, `exchange_rate`, `is_amounts_entered_in_home_currency`). Members of a set combine with each other, not with the other choices. | |
| is_amounts_entered_in_home_currency | No | Flag that indicates the amount being entered is in the home currency. Choose at most one of: `is_home_currency_adjustment`, or the set (`currency_ref`, `exchange_rate`, `is_amounts_entered_in_home_currency`). Members of a set combine with each other, not with the other choices. |
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). |