{"service":"quickbooks-bridge","description":"QBO-shaped HTTP API facade over QuickBooks Desktop company files.","qboCompatibility":{"publicEntityNames":"Use QBO-facing entity names. For customer payments use Payment, not ReceivePayment.","desktopTranslation":"The bridge translates supported QBO-shaped calls to qbXML internally.","coverage":"Supported endpoints and filters are intentionally bounded; unsupported QBO surface area returns explicit faults."},"authentication":{"type":"bearer","header":"Authorization: Bearer <token>","note":"Discovery endpoints are public. Company data endpoints require the configured bearer token."},"companyScope":{"pathParameter":"realmId","note":"Use a company realm ID or configured API name supplied by the operator. This discovery document intentionally does not list companies."},"endpoints":{"query":{"method":"GET","path":"/v3/company/{realmId}/query?query={sql}","examples":["SELECT * FROM Customer WHERE DisplayName LIKE '%051326A-Martens%'","SELECT * FROM Invoice WHERE CustomerRef = '80005878-1778608236'","SELECT * FROM Payment WHERE CustomerRef = '80005878-1778608236'","SELECT * FROM CompanyInfo"]},"readById":{"method":"GET","path":"/v3/company/{realmId}/{entity}/{id}","examples":["/v3/company/{realmId}/Invoice/{txnId}","/v3/company/{realmId}/Customer/{listId}","/v3/company/{realmId}/companyinfo/{realmId}"]},"create":{"method":"POST","path":"/v3/company/{realmId}/{entity}"},"update":{"method":"POST","path":"/v3/company/{realmId}/{entity}?operation=update"},"delete":{"method":"DELETE","path":"/v3/company/{realmId}/{entity}/{id}?syncToken={syncToken}"},"reports":{"method":"GET","path":"/v3/company/{realmId}/reports/{reportName}?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD&accounting_method=Accrual","supported":["AgedReceivables","AgedReceivablesDetail","CustomerSales","GeneralLedger","ProfitAndLoss","TransactionList","TransactionListByCustomer","TransactionListByVendor"]},"cdc":{"method":"GET","path":"/v3/company/{realmId}/cdc?entities=Invoice,Customer&changedSince=YYYY-MM-DDTHH:mm:ssZ"}},"supportedEntities":["Account","Bill","BillPayment","Class","CompanyInfo","CreditMemo","Customer","Department","Deposit","Employee","Estimate","Invoice","Item","JournalEntry","Payment","PaymentMethod","PurchaseOrder","RefundReceipt","SalesReceipt","TaxCode","Term","TimeActivity","Transfer","Vendor","VendorCredit"],"querySyntax":{"shape":"SELECT * FROM Entity [WHERE Field OP Value [AND ...]] [ORDERBY Field ASC|DESC] [MAXRESULTS n] [STARTPOSITION n]","commonFilters":{"listEntities":["Id","FullName","DisplayName","Name","Active","MetaData.LastUpdatedTime"],"transactionEntities":["Id","DocNumber","TxnDate","CustomerRef","VendorRef","EntityRef","PaidStatus","MetaData.LastUpdatedTime"]},"notes":["DisplayName LIKE supports substring customer searches.","FullName is exact-match only.","CompanyInfo is a singleton; direct read uses /companyinfo/{realmId}."]}}