# QuickbooksOnlineSDK
Python SDK for accessing QBO APIs.
## Installation
This project requires [Python 3+](https://www.python.org/downloads/) and [Requests](https://pypi.org/project/requests/) library (pip install requests).
1. Download this project and use it (copy it in your project, etc).
2. Install it from [pip](https://pypi.org).
$ pip install qbosdk
## Usage
To use this SDK you'll need these QBO credentials used for OAuth2 authentication: **client ID**, **client secret** and **refresh token**.
This SDK is very easy to use.
1. First you'll need to create a connection using the main class QuickbooksOnlineSDK.
```python
from qbosdk import QuickbooksOnlineSDK
connection = QuickbooksOnlineSDK(
client_id='<YOUR CLIENT ID>',
client_secret='<YOUR CLIENT SECRET>',
refresh_token='<YOUR REFRESH TOKEN>',
realm_id='<REALM / COMPANY ID>',
environment='<sandbox / production>'
)
```
2. After that you'll be able to access any of the API classes
```python
"""
USAGE: <QuickbooksOnlineSDK INSTANCE>.<API_NAME>.<API_METHOD>(<PARAMETERS>)
"""
# Get a list of all Employees (with all available details for Employee)
response = connection.employees.get()
# Get a list of all Accounts
response = connection.accounts.get()
```
See more details about the usage into the wiki pages of this project.
## Integration Tests
To run integration tests, you will need a mechanism to connect to a real qbo account. Save this info in a test_credentials.json file in your root directory:
```json
{
"client_id": "<client_id>",
"client_secret": "<client_secret>",
"realm_id": "<realm_id>",
"refresh_token": "<refresh_token>",
"environment": "<environment sandbox / production>"
}
```
```bash
$ pip install pytest
$ python -m pytest test/integration
```
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details
Raw data
{
"_id": null,
"home_page": "https://github.com/fylein/qbo-sdk-py",
"name": "qbosdk",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "quickbooks-online, quickbooks, fyle, api, python, sdk",
"author": "Shwetabh Kumar",
"author_email": "shwetabh.kumar@fyle.in",
"download_url": "https://files.pythonhosted.org/packages/41/2f/59339d7231ef58298c83a48d0aa025ea6ce38fe31c00a16fa73295138826/qbosdk-1.4.0.tar.gz",
"platform": null,
"description": "# QuickbooksOnlineSDK\n\nPython SDK for accessing QBO APIs.\n\n## Installation\n\nThis project requires [Python 3+](https://www.python.org/downloads/) and [Requests](https://pypi.org/project/requests/) library (pip install requests).\n\n1. Download this project and use it (copy it in your project, etc).\n2. Install it from [pip](https://pypi.org).\n \n $ pip install qbosdk\n\n## Usage\n\nTo use this SDK you'll need these QBO credentials used for OAuth2 authentication: **client ID**, **client secret** and **refresh token**.\n\nThis SDK is very easy to use.\n1. First you'll need to create a connection using the main class QuickbooksOnlineSDK.\n```python\nfrom qbosdk import QuickbooksOnlineSDK\n\nconnection = QuickbooksOnlineSDK(\n client_id='<YOUR CLIENT ID>',\n client_secret='<YOUR CLIENT SECRET>',\n refresh_token='<YOUR REFRESH TOKEN>',\n realm_id='<REALM / COMPANY ID>',\n environment='<sandbox / production>'\n)\n```\n2. After that you'll be able to access any of the API classes\n```python\n\"\"\"\nUSAGE: <QuickbooksOnlineSDK INSTANCE>.<API_NAME>.<API_METHOD>(<PARAMETERS>)\n\"\"\"\n\n# Get a list of all Employees (with all available details for Employee)\nresponse = connection.employees.get()\n\n# Get a list of all Accounts\nresponse = connection.accounts.get()\n```\n\nSee more details about the usage into the wiki pages of this project.\n\n## Integration Tests\n\nTo run integration tests, you will need a mechanism to connect to a real qbo account. Save this info in a test_credentials.json file in your root directory:\n\n```json\n{\n \"client_id\": \"<client_id>\",\n \"client_secret\": \"<client_secret>\",\n \"realm_id\": \"<realm_id>\",\n \"refresh_token\": \"<refresh_token>\",\n \"environment\": \"<environment sandbox / production>\"\n}\n```\n\n```bash\n$ pip install pytest\n\n$ python -m pytest test/integration\n```\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python SDK for accessing Quickbooks Online APIs",
"version": "1.4.0",
"project_urls": {
"Homepage": "https://github.com/fylein/qbo-sdk-py"
},
"split_keywords": [
"quickbooks-online",
" quickbooks",
" fyle",
" api",
" python",
" sdk"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ad6c9b56e5dc6049f474f3d2980ac00d0e7f04f7ff798690c2963952b7a80883",
"md5": "3cd1db4a92f7e7c6028b2b92d904d3b7",
"sha256": "3c50ea05dce5a57b5576583c54cf33329a168e26543c5f0cc65f46527ab9268f"
},
"downloads": -1,
"filename": "qbosdk-1.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3cd1db4a92f7e7c6028b2b92d904d3b7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 23866,
"upload_time": "2025-07-28T18:16:12",
"upload_time_iso_8601": "2025-07-28T18:16:12.072002Z",
"url": "https://files.pythonhosted.org/packages/ad/6c/9b56e5dc6049f474f3d2980ac00d0e7f04f7ff798690c2963952b7a80883/qbosdk-1.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "412f59339d7231ef58298c83a48d0aa025ea6ce38fe31c00a16fa73295138826",
"md5": "cf12dfd0d96a6d0451b0745d3d340926",
"sha256": "2431946aa81b535e0f2b7fcd3be7735b1f3b109160ec1d79e9d5c4e686328a6d"
},
"downloads": -1,
"filename": "qbosdk-1.4.0.tar.gz",
"has_sig": false,
"md5_digest": "cf12dfd0d96a6d0451b0745d3d340926",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 14939,
"upload_time": "2025-07-28T18:16:13",
"upload_time_iso_8601": "2025-07-28T18:16:13.099241Z",
"url": "https://files.pythonhosted.org/packages/41/2f/59339d7231ef58298c83a48d0aa025ea6ce38fe31c00a16fa73295138826/qbosdk-1.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-28 18:16:13",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "fylein",
"github_project": "qbo-sdk-py",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "requests",
"specs": [
[
">=",
"2.25.0"
]
]
},
{
"name": "future",
"specs": [
[
"==",
"1.0.0"
]
]
},
{
"name": "pylint",
"specs": [
[
"==",
"2.7.4"
]
]
}
],
"lcname": "qbosdk"
}
JSON
