How intuit/quickbooks-v3-java-sdk works
This repository is a Java SDK for QuickBooks Online, with separate OAuth2 and Payments V2 client libraries. A typical QBO integration calls the devkit’s data or reporting services, which exchange entity or report data with QuickBooks Online; the data module supplies the API’s entity models. The README documents CRUD, batch operations, queries, change-data retrieval, XML/JSON, synchronous/asynchronous handling, and resilience features. Service internals are only partly sampled, so the graph avoids asserting unshown call chains.
Main entry points: DataService.java Data Service · ServiceBase.java Payment Transport · OAuth2PlatformClient.java OAuth2 Client · ReportService.java Report Service
Components 24
QBO Data Models
- Entity Base
ipp-v3-java-data/src/main/java/com/intuit/ipp/data/IntuitEntity.java - Business Entities
ipp-v3-java-data/src/main/java/com/intuit/ipp/data/Invoice.java - Query Responses
ipp-v3-java-data/src/main/java/com/intuit/ipp/data/QueryResponse.java - API Faults
ipp-v3-java-data/src/main/java/com/intuit/ipp/data/Fault.java - Tax Models
ipp-v3-java-data/src/main/java/com/intuit/ipp/data/TaxService.java
QBO API Devkit
- Data Service
ipp-v3-java-devkit/src/main/java/com/intuit/ipp/services/DataService.java - Report Service
ipp-v3-java-devkit/src/main/java/com/intuit/ipp/services/ReportService.java - Tax Service
ipp-v3-java-devkit/src/main/java/com/intuit/ipp/services/GlobalTaxService.java - Webhook Service
ipp-v3-java-devkit/src/main/java/com/intuit/ipp/services/WebhooksService.java - HTTP Interceptors
ipp-v3-java-devkit/src/main/java/com/intuit/ipp/interceptors/HTTPClientConnectionInterceptor.java - Batch Interceptor
ipp-v3-java-devkit/src/main/java/com/intuit/ipp/interceptors/HTTPBatchClientConnectionInterceptor.java - Retry Policy
ipp-v3-java-devkit/src/main/java/com/intuit/ipp/net/IntuitRetryPolicyHandler.java
OAuth2 Client
- OAuth2 Client
oauth2-platform-api/src/main/java/com/intuit/oauth2/client/OAuth2PlatformClient.java - OAuth Configuration
oauth2-platform-api/src/main/java/com/intuit/oauth2/config/OAuth2Config.java - OAuth HTTP Client
oauth2-platform-api/src/main/java/com/intuit/oauth2/http/HttpRequestClient.java
Payments V2
- Payment Context
payments-api/src/main/java/com/intuit/payment/config/RequestContext.java - Bank Accounts
payments-api/src/main/java/com/intuit/payment/services/BankAccountService.java - Card Service
payments-api/src/main/java/com/intuit/payment/services/CardService.java - Charge Service
payments-api/src/main/java/com/intuit/payment/services/ChargeService.java - Payment Transport
payments-api/src/main/java/com/intuit/payment/services/base/ServiceBase.java - Payment HTTP Client
payments-api/src/main/java/com/intuit/payment/http/HttpRequestClient.java
Other components
- SDK Consumer
- QuickBooks Online
- Payments API
Connections 21
- SDK Consumer → Data Service: invokes CRUD
- SDK Consumer → Report Service: requests reports
- Data Service → QuickBooks Online: sends API requests
- Report Service → QuickBooks Online: retrieves reports
- Data Service → Business Entities: handles entities
ipp-v3-java-devkit/src/main/java/com/intuit/ipp/services/DataService.java - Data Service → Query Responses: processes queries
ipp-v3-java-devkit/src/main/java/com/intuit/ipp/services/DataService.java - Data Service → API Faults: handles faults
ipp-v3-java-devkit/src/main/java/com/intuit/ipp/services/DataService.java - SDK Consumer → Tax Service: requests tax
- Tax Service → Tax Models: uses tax model
ipp-v3-java-devkit/src/main/java/com/intuit/ipp/services/GlobalTaxService.java - SDK Consumer → Webhook Service: uses webhooks
ipp-v3-java-devkit/src/main/java/com/intuit/ipp/services/WebhooksService.java - SDK Consumer → OAuth2 Client: requests tokens
- OAuth2 Client → OAuth Configuration: uses configuration
oauth2-platform-api/src/main/java/com/intuit/oauth2/client/OAuth2PlatformClient.java - OAuth2 Client → OAuth HTTP Client: makes HTTP calls
oauth2-platform-api/src/main/java/com/intuit/oauth2/client/OAuth2PlatformClient.java - SDK Consumer → Bank Accounts: manages accounts
- SDK Consumer → Card Service: manages cards
- SDK Consumer → Charge Service: processes charges
- Bank Accounts → Payment Transport: sends requests
payments-api/src/main/java/com/intuit/payment/services/BankAccountService.java - Card Service → Payment Transport: sends requests
payments-api/src/main/java/com/intuit/payment/services/CardService.java - Charge Service → Payment Transport: sends requests
payments-api/src/main/java/com/intuit/payment/services/ChargeService.java - Payment Transport → Payment HTTP Client: makes API call
payments-api/src/main/java/com/intuit/payment/services/base/ServiceBase.java - Payment HTTP Client → Payments API: calls payment API