You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The QuickBooks Online Java SDK provides a set of Java class libraries that make it easier to call QuickBooks Online APIs, and access to QuickBooks Online data. Some of the features included in this SDK are:
8
13
9
14
* Ability to perform single and batch processing of CRUD operations on all QuickBooks Online entities.
@@ -19,109 +24,51 @@ The QuickBooks Online Java SDK provides a set of Java class libraries that make
19
24
* Sparse Update to update writable properties specified in a request and leave the others unchanged.
20
25
* Change data that enables you to retrieve a list of entities modified during specified time points.
21
26
22
-
## Project Overview
27
+
## Project Structure
23
28
* ipp-v3-java-data - contains all entities and entity dependencies that are used in data services operations
24
29
* ipp-v3-java-devkit - core component, contains rest API support
25
30
* ipp-v3-java-devkit-assembly - builds final deployment package (zip) which includes everything
26
31
* ipp-v3-java-devkit-shaded-assembly - builds lightweight version (some dependencies excluded)
27
32
* ipp-v3-java-devkit-javadoc - contains javadoc for data and devkit classes
*[Installation and SDK user guide](https://developer.intuit.com/docs/0100_quickbooks_online/0400_tools/0005_accounting/0200_java/0001_quick_start)
41
+
## Testing the code & building artifacts
42
+
To test the code locally, follow the steps below:
43
+
1. Update keys and tokens in [ippdevkit.properties](https://github.com/intuit/QuickBooks-V3-Java-SDK/blob/master/ipp-v3-java-devkit/src/test/resources/ippdevkit.properties)
44
+
Not sure how to get the tokens? Refer this [blog](https://developer.intuit.com/hub/blog/2016/04/25/quick-start-to-quickbooks-online-rest-api-with-oauth1-0) post to get on boarded with OAuth1 quickly.
45
+
2. cd to the project directory
46
+
3. Run the command: `mvn install` - this will run the unit test, build the project and generate data & devkit jars
39
47
40
-
## Building components
41
-
To build out individual components such as ipp-v3-java-data.jar or ipp-v3-java-devkit.jar, remove parent dependency from the pom.xml and run maven install.
48
+
Note: To build out individual components such as ipp-v3-java-data.jar or ipp-v3-java-devkit.jar, remove parent dependency from the pom.xml of the respective projects and run maven install on the individual project folders.
* Updated httpclient library for platform API (ipp-java-qbapihelper-1.2.2.jar)
50
-
* Updated disconnect and reconnect API to return response in platform API (ipp-java-qbapihelper-1.2.2.jar)
51
-
52
-
* V2.7.1 (11/28/2016)
53
-
* Minor version 8 support
54
-
* cc/bcc field support for Invoice and Preferences entities
55
-
* HttpClient 4.5.2 support
56
-
57
-
* V2.6.0 (10/14/2016)
58
-
* Webhooks support
59
-
* Error code 429
60
-
61
-
* V2.5.0 (05/15/2016)
62
-
* Minor version 5 support
63
-
* cc/bcc field support for Invoice and Preferences entities
64
-
* HttpClient 4.5.2 support
65
-
66
-
* V2.4.0 (09/28/2015)
67
-
* This version includes minor version 3 (default) and 4 support. It also has number of bugfixes.
68
-
* Support for voiding transactions, viewing transactions as PDF, and sending transactions as email
69
-
70
-
* V2.3.2
71
-
* Added JSON support for SyncErrorResponse
72
-
* Adding data jar packages
73
-
74
-
* V2.3.1
75
-
* Added reports, General Ledger, Vendor Balance Detail, AP Aging Detail.
76
-
* Added timeout support for AMEX.
77
-
78
-
* V2.3.0
79
-
* HttpURLConnection
80
-
* Tax Agency create
81
-
* Tax Code create
82
-
83
-
* V2.2.1
84
-
* v72 Reports
85
-
86
-
* V2.2.0
87
-
* Include param support
88
-
89
-
* V2.1.2
90
-
* Default minor version 1
91
-
92
-
* V2.1.1
93
-
* Modifications for CRT APIs
94
-
95
-
* V2.1.0
96
-
* Regenerated POJOs - v71
97
-
* Added minorVersion flag
98
-
* Added code to ignore JSON additional fields
99
-
100
-
* V2.0.4
101
-
* Regenerated POJOs - v70
102
-
* Added AuthenticationApplicationFailed fault type
103
-
104
-
* V2.0.3
105
-
* Separate jars
106
-
* Tested for 8.1 and v69
53
+
## Contribute:
54
+
We greatly encourage contributions! You can add new features, report and fix existing bugs, write docs and
55
+
tutorials, or any of the above. Feel free to open issues and/or send pull requests.
107
56
108
-
* V2.0.2
109
-
* consolidated jar
57
+
The `master` branch of this repository contains the latest stable release of Wasabi, while snapshots are published to the `develop` branch. In general, pull requests should be submitted against `develop` by forking this repo into your account, developing and testing your changes, and creating pull requests to request merges. See the [Contributing to a Project](https://guides.github.com/activities/contributing-to-open-source/)
58
+
article for more details about how to contribute.
110
59
111
-
* V2.0.1
112
-
* Request Id non static method
113
-
* Tracking id implementation
114
-
* Platform API deprecation - including qbapihelper jar
60
+
Steps to contribute:
115
61
116
-
* V2.0.0
117
-
* Regenerated classes with new XSD (v67 + IDs 8.0)
62
+
1. Fork this repository into your account on Github
63
+
2. Clone *your forked repository* (not our original one) to your hard drive with `git clone https://github.com/YOURUSERNAME/QuickBooks-V3-Java-SDK.git`
64
+
3. Design and develop your changes
65
+
4. Add/update unit tests
66
+
5. Create a pull request for review to request merge
67
+
6. Obtain approval before your changes can be merged
118
68
119
-
* V1.0.9
120
-
* Added support for request id as a param
69
+
Note: Before you submit the pull request, make sure to remove the keys and tokens from [ippdevkit.properties](https://github.com/intuit/QuickBooks-V3-Java-SDK/blob/master/ipp-v3-java-devkit/src/test/resources/ippdevkit.properties) that you might have added for testing purpose.
121
70
122
-
* V1.0.8
123
-
* Connection and Socket Timeout support
124
-
* Added environment variables (for builds) in devkit project
0 commit comments