Added value: +"https://json-schema.org/draft/2020-12/schema"

Removed value: -"\"Pay now\" by bank transfer (ACH); same rules as allowOnlineCreditCardPayment, set independently."

Previous value: -"\"Pay now\" by card on this invoice: true shows, false hides; omitted = company default on create, unchanged on update. QuickBooks has no per-customer setting: keep the policy in agentMemory and pass it on every invoice."New value: +"Omitted: company default (create), unchanged (update); ACH alike. No per-customer setting: keep the policy in agentMemory and pass it on every invoice."

Removed value: -"US sales tax only: tax the post-discount subtotal. Does nothing on VAT/GST companies (always post-discount)."

Removed value: -"Billing address on the invoice (create defaults to the customer's). On update the fields sent merge over the stored address."

Removed value: -"State/province code"

Removed value: -"Address stored on the invoice; sends nothing."

Added value: +{
+  "type": "string"
+}

Removed value: -"ISO code, multicurrency companies only. Omit to use the customer's currency (normally right)."

Previous value: -"Custom field values; the definition must be switched on for this transaction type (qbCustomization list). On update only the fields sent change."New value: +"qbCustomization list; \"\" clears."

Removed value: -"Numeric id from qbCustomization list."

Removed value: -"Text; number; date YYYY-MM-DD; or a dropdown option label. \"\" clears (not dropdowns)."

Removed value: -"Customer id. Create: this or projectId."

Previous value: -"Message shown on the invoice. Omitted on create: the company's default invoice message (where firms keep payment instructions), as QuickBooks' own screen fills it. \"\" for none."New value: +"Omitted on create: the company default message; \"\" for none."

Removed value: -"Location (department) id."

Previous value: -"Prepayment already collected; reduces the balance due (deposits must be enabled). Credits Undeposited Funds unless a deposit account is stored. 0 on update removes it."New value: +"Prepayment; 0 on update removes it."

Previous value: -"IES dimensions for the whole document (e.g. sales rep), written to every line; a line's own value wins. On an invoice, sales receipt, estimate or credit memo update without lines it re-tags the stored lines, changing nothing else; other tools need the lines."New value: +"IES dimensions for every line (qbCustomization list)."

Removed value: -"qbCustomization list id."

Removed value: -"Value id or full name."

Previous value: -"Discount after the line subtotal, posted as its own line (discounts must be enabled). On update send it WITH all lines; lines replaced without it keep the stored discount; {percent:0} with lines removes it."New value: +"On update send it WITH all lines; {percent:0} removes it."

Removed value: -"Income account it posts to; default = the company discount account."

Previous value: -"Fixed amount. Send percent OR amount."New value: +"Or percent, not both."

Removed value: -"Percent off the line subtotal (10 = 10%)."

Removed value: -"\"NeedToSend\" does NOT email: it only queues the invoice in QuickBooks' Send later list for a human; it needs billEmail or a customer email."

Previous value: -"Transaction-to-home-currency rate. Send it on foreign-currency documents: with no rate on file QuickBooks silently uses 1."New value: +"Foreign currency: send it, or QuickBooks uses 1."

Removed value: -"Invoice id: present = update."

Removed value: -"Create: required. Update: omit to keep the stored lines; sent lines REPLACE all of them."

Removed value: -"Line amount. Zero and negative lines are allowed (tax is on the net); the invoice total must be 0 or more."

Previous value: -"IES dimensions on this line, one value per dimension. Re-send them when replacing lines or they are lost."New value: +"IES dimensions; re-send when replacing lines."

Removed value: -"qbCustomization list id."

Removed value: -"Value id or full name (\"West:California\")."

Previous value: -"Item id (qbMasterData item). Always send it: without it QuickBooks silently substitutes a default item and its income account."New value: +"Always send it, or QuickBooks uses a default item."

Previous value: -"US: the literal \"TAX\" or \"NON\". Non-US: a TaxCode id (qbMasterData taxCode)."New value: +"US: \"TAX\" or \"NON\". Non-US: a TaxCode id."

Removed value: -"Private note."

Previous value: -"Project id (qbProject list) for the whole document. QuickBooks moves the document to the project's sub-customer, so customerId must be the project's customer or omitted."New value: +"qbProject id; customerId: its customer or omitted."

Removed value: -"Term id (qbMasterData term)."

Removed value: -"Shipping address. On update the fields sent merge over the invoice's stored address."

Removed value: -"State/province code"

Previous value: -"Non-US only: \"TaxExcluded\" (amounts are NET), required on create with taxed lines; on update the stored setting is kept (adding taxed lines to an untaxed invoice needs it). \"TaxInclusive\" is refused: convert a gross-priced invoice to net first."New value: +"Non-US: \"TaxExcluded\" (net), needed with taxed lines."

Removed value: -"YYYY-MM-DD. Create: required."

Removed value: -"Transaction sales-tax code: a TaxCode id (qbMasterData taxCode), not TAX/NON or a TaxRate id. On update it can change without lines (the tool re-sends the stored lines)."

Added value: +"https://json-schema.org/draft/2020-12/schema"

Previous value: -falseNew value: +true

Removed value: -{
-  "description": "Whether the STORED invoice offers bank-transfer (ACH) payment, as QuickBooks holds it.",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "Whether the STORED invoice offers card payment on its \"Pay now\" page, as QuickBooks holds it — read this, not your input, to confirm a toggle landed.",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "Open balance: totalAmount minus the deposit minus payments applied. 0 = nothing left to collect.",
-  "type": "number"
-}

Previous value: -falseNew value: +true

Removed value: -"The company this result came from. Read it back to the user by name."

Added value: +{
+  "description": "The ledger this company keeps its books in (a provider id, or \"none\").",
+  "type": "string"
+}

Added value: +{
+  "description": "Xero organisation name, when the company keeps its books in Xero.",
+  "type": "string"
+}

Removed value: -[
-  "organizationId"
-]

Removed value: -{
-  "description": "Custom field values as QuickBooks STORED them after this write (dropdowns shown by option label). Returned only when the call sent customFields — read this to confirm a value landed.",
-  "items": {
-    "additionalProperties": false,
-    "properties": {
-      "definitionId": {
-        "type": "string"
-      },
-      "name": {
-        "type": "string"
-      },
-      "value": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "definitionId"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

Removed value: -{
-  "type": "string"
-}

Removed value: -{
-  "description": "Customer prepayment recorded on this invoice. Balance is net of it, so without this field a balance below the total cannot be told apart from a payment.",
-  "type": "number"
-}

Removed value: -{
-  "description": "Discount applied, as posted by QuickBooks on its own discount line",
-  "type": "number"
-}

Removed value: -{
-  "description": "Due date",
-  "type": "string"
-}

Removed value: -{
-  "description": "Bill email address",
-  "type": "string"
-}

Removed value: -{
-  "description": "Email status",
-  "type": "string"
-}

Removed value: -"QuickBooks error code when success=false (e.g. TOKEN_EXPIRED, SYNC_TOKEN_CONFLICT, 6140). Branch on this instead of parsing the message."

Removed value: -{
-  "type": "string"
-}

Removed value: -{
-  "type": "string"
-}

Removed value: -{
-  "description": "Number of line items",
-  "type": "number"
-}

Removed value: -{
-  "description": "Invoice line details",
-  "items": {
-    "additionalProperties": false,
-    "properties": {
-      "amount": {
-        "description": "Line amount",
-        "type": "number"
-      },
-      "className": {
-        "description": "Class name if assigned",
-        "type": "string"
-      },
-      "description": {
-        "description": "Line description",
-        "type": "string"
-      },
-      "dimensions": {
-        "description": "Dimension values stored on the line — pass them back as dimensions when replacing lines.",
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "dimension": {
-              "type": "string"
-            },
-            "dimensionId": {
-              "type": "string"
-            },
-            "value": {
-              "type": "string"
-            },
-            "valueId": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "dimensionId",
-            "valueId"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "itemName": {
-        "description": "Item name",
-        "type": "string"
-      },
-      "lineId": {
-        "description": "QuickBooks line ID",
-        "type": "string"
-      },
-      "quantity": {
-        "description": "Quantity",
-        "type": "number"
-      },
-      "serviceDate": {
-        "description": "Service date",
-        "type": "string"
-      },
-      "unitPrice": {
-        "description": "Unit price",
-        "type": "number"
-      }
-    },
-    "required": [
-      "amount"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "Fields QuickBooks did NOT store as sent (it answered success anyway). On an update this makes success false with errorCode NOT_APPLIED.",
-  "items": {
-    "additionalProperties": false,
-    "properties": {
-      "field": {
-        "type": "string"
-      },
-      "reason": {
-        "type": "string"
-      },
-      "sent": {},
-      "stored": {}
-    },
-    "required": [
-      "field",
-      "sent",
-      "stored"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "Project the STORED invoice is on (QuickBooks project id).",
-  "type": "string"
-}

Removed value: -{
-  "description": "Payment terms (e.g., Net 30)",
-  "type": "string"
-}

Removed value: -{
-  "description": "SyncToken for future updates",
-  "type": "string"
-}

Removed value: -{
-  "description": "Total tax amount calculated by QuickBooks",
-  "type": "number"
-}

Removed value: -{
-  "type": "number"
-}

Removed value: -{
-  "description": "Invoice date",
-  "type": "string"
-}

Removed value: -{
-  "description": "Transaction tax code QuickBooks STORED.",
-  "type": "string"
-}

Removed value: -"Present once after the active company was changed by something other than this connection (the portal, or another AI client). Confirm the company with the user before writing."

Removed value: -[
-  "success",
-  "message"
-]

Previous value: -"Message shown on the invoice."New value: +"Message shown on the invoice. Omitted on create: the company's default invoice message (where firms keep payment instructions), as QuickBooks' own screen fills it. \"\" for none."

Previous value: -"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"New value: +"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"

Previous value: -[
-  "field"
-]New value: +[
+  "field",
+  "sent",
+  "stored"
+]

Previous value: -"Custom field values; the definition must be switched on for this transaction type (qbCustomField list). On update only the fields sent change."New value: +"Custom field values; the definition must be switched on for this transaction type (qbCustomization list). On update only the fields sent change."

Previous value: -"Numeric id from qbCustomField list."New value: +"Numeric id from qbCustomization list."

Previous value: -"qbDimension list id."New value: +"qbCustomization list id."

Previous value: -"qbDimension list id."New value: +"qbCustomization list id."

Removed value: -{
-  "description": "QuickBooks realm id, when connected.",
-  "type": "string"
-}

Previous value: -"Per-invoice \"Pay now\" bank-transfer (ACH) option. Same semantics as allowOnlineCreditCardPayment: true shows it, false hides it, omitted = company default on create / unchanged on update. The two are independent — e.g. allowOnlineACHPayment true + allowOnlineCreditCardPayment false for a customer who may not pay by card."New value: +"\"Pay now\" by bank transfer (ACH); same rules as allowOnlineCreditCardPayment, set independently."

Previous value: -"Per-invoice \"Pay now\" card option. true shows \"pay by credit card\" on the customer-facing invoice, false hides it, omitted = the company default on create / unchanged on update (the tool re-sends the stored value: QuickBooks itself resets an omitted flag to the company default on EVERY sparse update, so a toggle set by hand in QuickBooks survives an unrelated edit only because of this carry). Only has a customer-visible effect when QuickBooks Payments is connected to the company; QuickBooks stores the flag either way (proven live on a Sandbox without Payments) and the response echoes what was stored. QuickBooks has NO per-customer setting for this — keep the customer's policy (e.g. \"no credit card\") in agentMemory and pass the flag on every invoice for that customer."New value: +"\"Pay now\" by card on this invoice: true shows, false hides; omitted = company default on create, unchanged on update. QuickBooks has no per-customer setting: keep the policy in agentMemory and pass it on every invoice."

Previous value: -"US companies with sales tax only: compute sales tax on the post-discount subtotal instead of the pre-discount subtotal. Proven live on a US company with Automated Sales Tax — a 100.00 line with a 10% discount books 10.50 of tax when false and 9.45 when true. Outside the US it does NOTHING: a VAT/GST company neither stores nor echoes the flag and always taxes the discounted subtotal (GB-proven, matching the same field on CreditMemo)."New value: +"US sales tax only: tax the post-discount subtotal. Does nothing on VAT/GST companies (always post-discount)."

Previous value: -"Billing address printed on the invoice (defaults to the customer's on create). ON UPDATE the provided fields are merged over the stored billing address."New value: +"Billing address on the invoice (create defaults to the customer's). On update the fields sent merge over the stored address."

Removed value: -"City"

Removed value: -"Country"

Removed value: -"Street address line 1"

Removed value: -"Street address line 2"

Removed value: -"ZIP/postal code"

Previous value: -"State/province code (maps to CountrySubDivisionCode)"New value: +"State/province code"

Previous value: -"Email address stored on the invoice (BillEmail) — where it goes when sent from QuickBooks"New value: +"Address stored on the invoice; sends nothing."

Previous value: -"ISO currency for this transaction (e.g. \"USD\"). Multicurrency companies only. Omit to let QuickBooks take the customer's currency, which is normally correct."New value: +"ISO code, multicurrency companies only. Omit to use the customer's currency (normally right)."

Previous value: -"Custom field values (QuickBooks Plus/Advanced custom fields). Only definitions switched on for this transaction type are accepted — check qbCustomField list. On update only the fields sent change; omitted custom fields keep their stored values."New value: +"Custom field values; the definition must be switched on for this transaction type (qbCustomField list). On update only the fields sent change."

Previous value: -"Custom field definitionId from qbCustomField list (the numeric id)."New value: +"Numeric id from qbCustomField list."

Previous value: -"Value to store. Text as-is; NUMBER fields a number; DATE fields YYYY-MM-DD; dropdown fields one of the option labels qbCustomField lists (case-insensitive). Empty string clears a text, number or date field; a dropdown cannot be cleared through the API."New value: +"Text; number; date YYYY-MM-DD; or a dropdown option label. \"\" clears (not dropdowns)."

Previous value: -"QuickBooks Customer ID (from qb_master_data tool). Required for create."New value: +"Customer id. Create: this or projectId."

Previous value: -"Message to customer (appears on invoice)"New value: +"Message shown on the invoice."

Previous value: -"QB Department/Location ID. Requires location tracking enabled on the company."New value: +"Location (department) id."

Previous value: -"Customer prepayment already collected against this invoice. Reduces the balance due; requires deposits enabled on the company. Credits Undeposited Funds (QuickBooks' own default) unless the invoice already stores a deposit account. Set 0 on update to remove an existing deposit."New value: +"Prepayment already collected; reduces the balance due (deposits must be enabled). Credits Undeposited Funds unless a deposit account is stored. 0 on update removes it."

Previous value: -"Intuit Enterprise Suite dimensions for the WHOLE document (e.g. a sales rep): written to every line, because QuickBooks stores dimensions per line only. A line that sets the same dimension keeps its own value. On update without lines, the stored lines are re-sent unchanged except for these values — a safe way to re-tag an existing document (payments and balances are untouched)."New value: +"IES dimensions for the whole document (e.g. sales rep), written to every line; a line's own value wins. On an invoice, sales receipt, estimate or credit memo update without lines it re-tags the stored lines, changing nothing else; other tools need the lines."

Previous value: -"Dimension id from qbDimension list."New value: +"qbDimension list id."

Previous value: -"The value: its id or its full name as qbDimension lists it."New value: +"Value id or full name."

Previous value: -"Discount applied after the line subtotal. QuickBooks posts it as its own line so gross revenue and discounts stay separate. Requires the company to have discounts enabled. ON UPDATE: changing the discount requires re-sending ALL lines (QuickBooks replaces the whole line array together); when lines are replaced and discount is omitted, the existing discount is preserved automatically. To REMOVE a discount, re-send lines with discount {percent: 0}."New value: +"Discount after the line subtotal, posted as its own line (discounts must be enabled). On update send it WITH all lines; lines replaced without it keep the stored discount; {percent:0} with lines removes it."

Previous value: -"Income account the discount posts to (e.g. \"Discounts given\"). Defaults to the company default discount account."New value: +"Income account it posts to; default = the company discount account."

Previous value: -"Fixed discount amount. Provide percent OR amount, not both."New value: +"Fixed amount. Send percent OR amount."

Previous value: -"Percentage discount off the line subtotal (e.g. 10 for 10%)"New value: +"Percent off the line subtotal (10 = 10%)."

Removed value: -"Invoice number (max 21 characters)"

Removed value: -"Due date in YYYY-MM-DD format (e.g., 2025-02-15)."

Previous value: -"Email status flag. \"NeedToSend\" queues the invoice in QuickBooks' \"Send later\" list — it does NOT email anything by itself; a human sends it from the QuickBooks UI (proven live: after create the invoice has no DeliveryInfo.DeliveryTime, i.e. nothing was delivered). PRECONDITION: \"NeedToSend\" requires an email address — pass billEmail, or the customer must already have one on file (QuickBooks rejects it with 6000 otherwise; the tool checks first and names the fix). \"EmailSent\" and \"NotSet\" need no address."New value: +"\"NeedToSend\" does NOT email: it only queues the invoice in QuickBooks' Send later list for a human; it needs billEmail or a customer email."

Previous value: -"Rate converting the transaction currency to the company home currency. Supply this on foreign-currency documents: when QuickBooks has no current rate on file it silently uses 1, recording the foreign amount at face value in the home currency. The tool warns when that happens."New value: +"Transaction-to-home-currency rate. Send it on foreign-currency documents: with no rate on file QuickBooks silently uses 1."

Previous value: -"QuickBooks Invoice ID to update. SPARSE UPDATE: only provide fields you want to change — omitted fields (including lines) are preserved unchanged."New value: +"Invoice id: present = update."

Previous value: -"Invoice line items. Required for create. For update: ONLY provide if you want to REPLACE ALL existing lines. Omit entirely to keep existing lines unchanged."New value: +"Create: required. Update: omit to keep the stored lines; sent lines REPLACE all of them."

Previous value: -"Line amount. Zero ($0.00 no-charge lines) and NEGATIVE amounts (adjustments, reversals, amounts withheld) are allowed — QuickBooks taxes the net. The invoice total must stay 0 or greater (QuickBooks refuses a negative total)."New value: +"Line amount. Zero and negative lines are allowed (tax is on the net); the invoice total must be 0 or more."

Removed value: -"QB Class ID for tracking"

Removed value: -"Line description"

Previous value: -"Intuit Enterprise Suite dimensions for this line — at most one value per dimension. Re-send them when replacing lines, or the line loses them."New value: +"IES dimensions on this line, one value per dimension. Re-send them when replacing lines or they are lost."

Previous value: -"Dimension id from qbDimension list."New value: +"qbDimension list id."

Previous value: -"The value on this line: its id, or its full name as qbDimension lists it (e.g. \"West:California\", case-insensitive)."New value: +"Value id or full name (\"West:California\")."

Previous value: -"QB Item ID (from qbMasterData entityTypes:[\"item\"]). Effectively REQUIRED: QuickBooks rejects a line whose SalesItemLineDetail is empty, and when omitted alongside other line fields it silently substitutes a default item, sending revenue to that item's income account."New value: +"Item id (qbMasterData item). Always send it: without it QuickBooks silently substitutes a default item and its income account."

Removed value: -"Quantity"

Removed value: -"Service date for this line (YYYY-MM-DD)"

Previous value: -"Line taxability. US companies: the literal \"TAX\" or \"NON\" — QB rejects numeric ids there. NON-US companies (CA/GB/AU/...): a real TaxCode id from qbMasterData(entityTypes:[\"taxCode\"]) — \"TAX\"/\"NON\" are meaningless there. The tool knows the company country and rejects the wrong form."New value: +"US: the literal \"TAX\" or \"NON\". Non-US: a TaxCode id (qbMasterData taxCode)."

Removed value: -"Unit price"

Previous value: -"Private memo/note (internal only)"New value: +"Private note."

Previous value: -"QuickBooks project id (from qbProject list) to put this whole document on a project. QuickBooks then bills the PROJECT: the customer on the document becomes the project's own sub-customer, so customerId must be the project's customer or be omitted. Deleted projects are refused."New value: +"Project id (qbProject list) for the whole document. QuickBooks moves the document to the project's sub-customer, so customerId must be the project's customer or omitted."

Previous value: -"QB Sales Term ID for payment terms (e.g., Net 30, Net 15). Look ids up with qbMasterData(entityTypes:[\"term\"])."New value: +"Term id (qbMasterData term)."

Previous value: -"Shipping address. ON UPDATE the provided fields are merged over the invoice's stored shipping address (QuickBooks would otherwise replace the whole address object, wiping omitted fields)."New value: +"Shipping address. On update the fields sent merge over the invoice's stored address."

Removed value: -"City"

Removed value: -"Country"

Removed value: -"Street address line 1"

Removed value: -"Street address line 2"

Removed value: -"ZIP/postal code"

Previous value: -"State/province code (maps to CountrySubDivisionCode)"New value: +"State/province code"

Removed value: -"Ship date (YYYY-MM-DD)"

Previous value: -"Non-US companies only (CA/GB/AU/...): set \"TaxExcluded\" — line amounts are NET and tax is added on top. QuickBooks requires GlobalTaxCalculation on taxed sales transactions outside the US; required on CREATE with taxed lines. ON UPDATE it may be omitted — the document's stored setting is carried forward (exception: adding taxed lines to a previously untaxed document still requires an explicit \"TaxExcluded\"). \"TaxInclusive\" is REJECTED: QB stores it but ignores it, treating amounts as net anyway, so a gross-priced invoice would post overstated by the tax — convert to net yourself first. Ignored for US companies."New value: +"Non-US only: \"TaxExcluded\" (amounts are NET), required on create with taxed lines; on update the stored setting is kept (adding taxed lines to an untaxed invoice needs it). \"TaxInclusive\" is refused: convert a gross-priced invoice to net first."

Removed value: -"Shipment tracking number"

Previous value: -"Invoice date in YYYY-MM-DD format (e.g., 2025-01-15). Required for create."New value: +"YYYY-MM-DD. Create: required."

Previous value: -"Transaction-level sales-tax code (TxnTaxDetail.TxnTaxCodeRef): a TaxCode id from qbMasterData(entityTypes:[\"taxCode\"]) — not TAX/NON (those are line values) and not a TaxRate id. QuickBooks computes the tax from it and the lines' taxCodeIds. On update it can be changed without re-sending lines (the tool carries the stored lines, because QuickBooks ignores a code sent without them); the result reports the code QuickBooks actually stored."New value: +"Transaction sales-tax code: a TaxCode id (qbMasterData taxCode), not TAX/NON or a TaxRate id. On update it can change without lines (the tool re-sends the stored lines)."

Added value: +{
+  "description": "Intuit Enterprise Suite dimensions for the WHOLE document (e.g. a sales rep): written to every line, because QuickBooks stores dimensions per line only. A line that sets the same dimension keeps its own value. On update without lines, the stored lines are re-sent unchanged except for these values — a safe way to re-tag an existing document (payments and balances are untouched).",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "dimensionId": {
+        "description": "Dimension id from qbDimension list.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "value": {
+        "description": "The value: its id or its full name as qbDimension lists it.",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "dimensionId",
+      "value"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Previous value: -"Line amount"New value: +"Line amount. Zero ($0.00 no-charge lines) and NEGATIVE amounts (adjustments, reversals, amounts withheld) are allowed — QuickBooks taxes the net. The invoice total must stay 0 or greater (QuickBooks refuses a negative total)."

Removed value: -0

Added value: +{
+  "additionalProperties": false,
+  "description": "Billing address printed on the invoice (defaults to the customer's on create). ON UPDATE the provided fields are merged over the stored billing address.",
+  "properties": {
+    "city": {
+      "description": "City",
+      "type": "string"
+    },
+    "country": {
+      "description": "Country",
+      "type": "string"
+    },
+    "line1": {
+      "description": "Street address line 1",
+      "type": "string"
+    },
+    "line2": {
+      "description": "Street address line 2",
+      "type": "string"
+    },
+    "postalCode": {
+      "description": "ZIP/postal code",
+      "type": "string"
+    },
+    "state": {
+      "description": "State/province code (maps to CountrySubDivisionCode)",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Added value: +{
+  "description": "Street address line 2",
+  "type": "string"
+}

Previous value: -"QB Tax Code ID for the entire transaction (sets TxnTaxDetail.TxnTaxCodeRef). Use qbMasterData(entityTypes:[\"taxCode\"]) to look up IDs — TaxCode IDs (e.g. US \"TAX\"/\"NON\"), NOT TaxRate IDs, which QB rejects. When set, QuickBooks auto-calculates tax based on this code and the line-level taxCodeIds."New value: +"Transaction-level sales-tax code (TxnTaxDetail.TxnTaxCodeRef): a TaxCode id from qbMasterData(entityTypes:[\"taxCode\"]) — not TAX/NON (those are line values) and not a TaxRate id. QuickBooks computes the tax from it and the lines' taxCodeIds. On update it can be changed without re-sending lines (the tool carries the stored lines, because QuickBooks ignores a code sent without them); the result reports the code QuickBooks actually stored."

Added value: +{
+  "description": "Fields QuickBooks did NOT store as sent (it answered success anyway). On an update this makes success false with errorCode NOT_APPLIED.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "field": {
+        "type": "string"
+      },
+      "reason": {
+        "type": "string"
+      },
+      "sent": {},
+      "stored": {}
+    },
+    "required": [
+      "field"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Transaction tax code QuickBooks STORED.",
+  "type": "string"
+}

Added value: +{
+  "description": "Custom field values (QuickBooks Plus/Advanced custom fields). Only definitions switched on for this transaction type are accepted — check qbCustomField list. On update only the fields sent change; omitted custom fields keep their stored values.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "definitionId": {
+        "description": "Custom field definitionId from qbCustomField list (the numeric id).",
+        "minLength": 1,
+        "type": "string"
+      },
+      "value": {
+        "description": "Value to store. Text as-is; NUMBER fields a number; DATE fields YYYY-MM-DD; dropdown fields one of the option labels qbCustomField lists (case-insensitive). Empty string clears a text, number or date field; a dropdown cannot be cleared through the API.",
+        "type": [
+          "string",
+          "number"
+        ]
+      }
+    },
+    "required": [
+      "definitionId",
+      "value"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Intuit Enterprise Suite dimensions for this line — at most one value per dimension. Re-send them when replacing lines, or the line loses them.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "dimensionId": {
+        "description": "Dimension id from qbDimension list.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "value": {
+        "description": "The value on this line: its id, or its full name as qbDimension lists it (e.g. \"West:California\", case-insensitive).",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "dimensionId",
+      "value"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "QuickBooks project id (from qbProject list) to put this whole document on a project. QuickBooks then bills the PROJECT: the customer on the document becomes the project's own sub-customer, so customerId must be the project's customer or be omitted. Deleted projects are refused.",
+  "type": "string"
+}

Added value: +{
+  "description": "Custom field values as QuickBooks STORED them after this write (dropdowns shown by option label). Returned only when the call sent customFields — read this to confirm a value landed.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "definitionId": {
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      },
+      "value": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "definitionId"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Dimension values stored on the line — pass them back as dimensions when replacing lines.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "dimension": {
+        "type": "string"
+      },
+      "dimensionId": {
+        "type": "string"
+      },
+      "value": {
+        "type": "string"
+      },
+      "valueId": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "dimensionId",
+      "valueId"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Project the STORED invoice is on (QuickBooks project id).",
+  "type": "string"
+}