forked from ej2/python-quickbooks
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathclient.py
More file actions
247 lines (185 loc) · 7.75 KB
/
client.py
File metadata and controls
247 lines (185 loc) · 7.75 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
try:
import httplib # Python 2
except ImportError:
import http.client as httplib # Python 3
from .exceptions import QuickbooksException, SevereException
try:
from rauth import OAuth1Session, OAuth1Service
except ImportError:
print("Please import Rauth:\n\n")
print("http://rauth.readthedocs.org/en/latest/\n")
raise
class QuickBooks(object):
"""A wrapper class around Python's Rauth module for Quickbooks the API"""
access_token = ''
access_token_secret = ''
consumer_key = ''
consumer_secret = ''
company_id = 0
callback_url = ''
session = None
sandbox = False
qbService = None
sandbox_api_url_v3 = "https://sandbox-quickbooks.api.intuit.com/v3"
api_url_v3 = "https://quickbooks.api.intuit.com/v3"
request_token_url = "https://oauth.intuit.com/oauth/v1/get_request_token"
access_token_url = "https://oauth.intuit.com/oauth/v1/get_access_token"
authorize_url = "https://appcenter.intuit.com/Connect/Begin"
request_token = ''
request_token_secret = ''
_BUSINESS_OBJECTS = [
"Account", "Attachable", "Bill", "BillPayment",
"Class", "CompanyInfo", "CreditMemo", "Customer",
"Department", "Employee", "Estimate", "Invoice",
"Item", "JournalEntry", "Payment", "PaymentMethod",
"Preferences", "Purchase", "PurchaseOrder",
"SalesReceipt", "TaxCode", "TaxRate", "Term",
"TimeActivity", "Vendor", "VendorCredit"
]
__instance = None
def __new__(cls, **kwargs):
if QuickBooks.__instance is None:
QuickBooks.__instance = object.__new__(cls)
if 'consumer_key' in kwargs:
cls.consumer_key = kwargs['consumer_key']
if 'consumer_secret' in kwargs:
cls.consumer_secret = kwargs['consumer_secret']
if 'access_token' in kwargs:
cls.access_token = kwargs['access_token']
if 'access_token_secret' in kwargs:
cls.access_token_secret = kwargs['access_token_secret']
if 'company_id' in kwargs:
cls.company_id = kwargs['company_id']
if 'callback_url' in kwargs:
cls.callback_url = kwargs['callback_url']
if 'sandbox' in kwargs:
cls.sandbox = kwargs['sandbox']
return QuickBooks.__instance
@classmethod
def get_instance(cls):
return cls.__instance
def _drop(self):
QuickBooks.__instance = None
@property
def api_url(self):
if self.sandbox:
return self.sandbox_api_url_v3
else:
return self.api_url_v3
def create_session(self):
if self.consumer_secret and self.consumer_key and self.access_token_secret and self.access_token:
session = OAuth1Session(
self.consumer_key,
self.consumer_secret,
self.access_token,
self.access_token_secret,
)
self.session = session
else:
raise QuickbooksException("Quickbooks authenication fields not set. Cannot create session.")
return self.session
def get_authorize_url(self):
"""
Returns the Authorize URL as returned by QB, and specified by OAuth 1.0a.
:return URI:
"""
if self.qbService is None:
self.set_up_service()
response = self.qbService.get_raw_request_token(
params={'oauth_callback': self.callback_url})
content = str.split(response.content, '&')
self.request_token = str.split(content[2], "=")[1]
self.request_token_secret = str.split(content[0], "=")[1]
#self.request_token, self.request_token_secret = self.qbService.get_raw_request_token(
# params={'oauth_callback': self.callback_url})
return self.qbService.get_authorize_url(self.request_token)
def set_up_service(self):
self.qbService = OAuth1Service(
name=None,
consumer_key=self.consumer_key,
consumer_secret=self.consumer_secret,
request_token_url=self.request_token_url,
access_token_url=self.access_token_url,
authorize_url=self.authorize_url,
base_url=None
)
def get_access_tokens(self, oauth_verifier):
"""
Wrapper around get_auth_session, returns session, and sets access_token and
access_token_secret on the QB Object.
:param oauth_verifier: the oauth_verifier as specified by OAuth 1.0a
"""
session = self.qbService.get_auth_session(
self.request_token,
self.request_token_secret,
data={'oauth_verifier': oauth_verifier})
self.access_token = session.access_token
self.access_token_secret = session.access_token_secret
return session
def make_request(self, request_type, url, request_body=None, content_type='application/json'):
if not request_body:
request_body = {}
if self.session is None:
self.create_session()
headers = {
'Content-Type': content_type,
'Accept': 'application/json'
}
req = self.session.request(request_type, url, True, self.company_id, headers=headers, data=request_body)
if "cdc" in url:
print url
print headers
print request_type
try:
result = req.json()
except:
raise QuickbooksException("Error reading json response: {0}".format(req.text), 10000)
if req.status_code is not httplib.OK or "Fault" in result:
self.handle_exceptions(result["Fault"])
else:
return result
def get_single_object(self, qbbo, pk):
url = self.api_url + "/company/{0}/{1}/{2}/".format(self.company_id, qbbo.lower(), pk)
result = self.make_request("GET", url, {})
return result
def handle_exceptions(self, results):
# Needs to handle multiple errors
for error in results["Error"]:
message = error["Message"]
detail = ""
if "Detail" in error:
detail = error["Detail"]
code = ""
if "code" in error:
code = error["code"]
if code >= 10000:
raise SevereException(message, code, detail)
else:
raise QuickbooksException(message, code, detail)
def create_object(self, qbbo, request_body):
self.isvalid_object_name(qbbo)
url = self.api_url + "/company/{0}/{1}".format(self.company_id, qbbo.lower())
results = self.make_request("POST", url, request_body)
return results
def changed_data(self, entity_list, changed_since):
entities = ",".join(entity_list)
url = self.api_url + "/company/{0}/cdc?entities={1}&changedSince={2}".format(
self.company_id, entities, changed_since)
result = self.make_request("POST", url, "", content_type='application/text')
return result
def query(self, select):
url = self.api_url + "/company/{0}/query".format(self.company_id)
result = self.make_request("POST", url, select, content_type='application/text')
return result
def isvalid_object_name(self, object_name):
if object_name not in self._BUSINESS_OBJECTS:
raise Exception("{0} is not a valid QBO Business Object.".format(object_name))
return True
def update_object(self, qbbo, request_body):
url = self.api_url + "/company/{0}/{1}".format(self.company_id, qbbo.lower())
result = self.make_request("POST", url, request_body)
return result
def batch_operation(self, request_body):
url = self.api_url + "/company/{0}/batch".format(self.company_id)
results = self.make_request("POST", url, request_body)
return results