Why do my journal entry posts fail in QuickBooks Online API?

In QuickBooks Online (QBO), journal entries usually fail for a few common reasons. The exact cause depends on the API error response, but the most frequent issues are:

Common reasons journal entry posts fail

1. Debits and credits don’t balance

A journal entry must have equal total debits and credits.

• If total debits ≠ total credits, QBO rejects it.
• Make sure each line has either Debit or Credit, not both.

2. Missing required fields

Typical required fields include:

• TxnDate
• At least 2 lines in Line
• Valid AccountRef on each line
• Proper PostingType / debit-credit structure, depending on the API format you use

3. Invalid or inactive account references

The AccountRef must point to an existing, active QBO account.

Common issues:

• Wrong account ID
• Account is inactive
• Account is not allowed for the transaction type

4. Company settings prevent the posting

Some companies have restrictions or accounting preferences that affect journal entries.

Examples:

• Closed accounting periods
• Restrictions on manual journals
• Multi-currency limitations
• Class/location tracking requirements

5. Date is in a closed period

If your TxnDate falls into a closed books period, QBO will reject the journal entry.

6. Incorrect JSON structure

QBO is strict about payload format. Issues often include:

• Wrong field names
• Wrong nesting
• Sending strings where numbers are expected
• Using unsupported properties

7. Multi-currency problems

If multi-currency is enabled:

• The journal entry may require currency consistency
• Certain account combinations may not be allowed across currencies

8. Duplicate or malformed data

Sometimes posting fails because:

• Duplicate DocNumber conflicts with company rules
• Line items contain invalid characters
• Payload contains unsupported metadata fields

---

Example of a valid journal entry payload

{
  "TxnDate": "2026-10-10",
  "Line": [
    {
      "Id": "1",
      "Amount": 100.00,
      "DetailType": "JournalEntryLineDetail",
      "JournalEntryLineDetail": {
        "PostingType": "Debit",
        "AccountRef": {
          "value": "35"
        }
      }
    },
    {
      "Id": "2",
      "Amount": 100.00,
      "DetailType": "JournalEntryLineDetail",
      "JournalEntryLineDetail": {
        "PostingType": "Credit",
        "AccountRef": {
          "value": "46"
        }
      }
    }
  ]
}

---

What to check first

1. Look at the exact QBO API error message and minor code.
2. Verify debit/credit totals match.
3. Confirm both account IDs exist and are active.
4. Make sure the date is not in a locked period.
5. Compare your payload to QBO’s expected journal entry schema.

If you want, paste the exact API error response and your JSON payload (remove sensitive info), and I can tell you precisely why it’s failing.