quickbooks-node-promise
Version:
Connect to QuickBooks Online API with OAuth 2 with typescript on entities
1,190 lines (912 loc) • 107 kB
Markdown
# Overview
This library was created for Quickbooks OAuth2. It simplifies the OAuth process and renewing of the access token when it is about to expire. This can be turned off in the AppConfig. It also simplifies the process of making requests to Quickbooks. It has typescript types for all the requests and responses.
## Example grabbing a customer from Quickbooks
```javascript
const QuickBooks = require("quickbooks-node-promise");
const qbo = new QuickBooks(appConfig, realmID);
const customers = await qbo.findCustomers({ Id: "1234" });
const customer = customer.QueryResponse.Customer[0];
console.log(`Hi my customer's name is ${customer.Name}`);
```
## Fully typed using documentation
Typescript types were scrapped from the Quickbooks documentation. The types may not be perfect at the moment due to quickbooks documentation not being perfect. If you find any issues, please create an issue on github.

# Setup
**Check the example for node express setup endpoints**
[Example of server on github](https://github.com/pbrink231/quickbooks-node-promise/blob/main/example/server.ts)
## Install
```
npm i quickbooks-node-promise
```
## Config setup
A config setup is needed for each instance. The minimum needed is supplying the instance with a store method properties which are explained later. The `appKey` and `appSecret` are required to create, refresh, and revoke tokens. To create a token the `redirectUrl` and `scope` fields are also required. Use the `authorizeUrl` method to generate an OAuth link. More on the OAuth process later. The `useProduction` field is false by default so for production enviroment you must supply `true` for this.
A very basic example using internal store. This example will not autoRefresh the token and cannot be used to manage token information such as revoking a token.
```javascript
const appConfig: AppConfig = {
autoRefresh: false,
accessToken: '123'
};
const qbo = new Quickbooks(appConfig, realmID);
const customers = await qbo.findCustomers({ Id: "1234" });
```
A more advanced example using a Function Store. When the accessToken expires, it will automatically refresh the accessToken. You should change getToken and saveToken to use a database or some other storage method.
```javascript
const realms = {};
// QB config
const QBAppconfig = {
appKey: QB_APP_KEY,
appSecret: QB_APP_SECRET,
redirectUrl: QB_REDIRECT_URL,
scope: [
Quickbooks.scopes.Accounting,
Quickbooks.scopes.OpenId,
Quickbooks.scopes.Profile,
Quickbooks.scopes.Email,
Quickbooks.scopes.Phone,
Quickbooks.scopes.Address,
],
getToken(realmId, appConfig) {
return Promise.resolve(realms[realmId]);
},
saveToken(realmId, tokenData, appConfig, extra) {
realms[realmId] = saveTokenData;
return Promise.resolve(saveTokenData);
},
};
```
| Property | Type | Description |
| --- | --- | --- |
| appKey | string | Required for token management such as creating, refreshing or revoking tokens. not needed if supplying a token and just need to hit normal endpoints |
| appSecret | string | Required for token management such as creating, refreshing or revoking tokens. not needed if supplying a token and just need to hit normal endpoints |
| redirectUrl | string | Required if using Oauth flow. Must be the same as the url put on the quickbooks developer portal |
| scope | string[] | Required if using Oauth flow. Available scopes detailed below |
| minorversion | number | null for latest version |
| webhookVerifierToken | string | Used for verifying the webhook |
| useProduction | string | default is false, determines weather to use production or sandbox url |
| debug | boolean | default is false, if true will console log all requests and responses. |
| state | string | CSRF Token, used to prevent CSRF attacks. If not supplied, one will be generated for you. Can optionally be supplied in the authorizeUrl method. Used to compare with the state returned from the OAuth process. |
| autoRefresh | boolean | default is true, will auto refresh auth token if about to expire and the appKey and appSecret are supplied |
| autoRefreshBufferSeconds | number | defualt is 60 seconds, number of seconds before token expires that will trigger to get a new token |
### Scopes available:
```javascript
Quickbooks.scopes = {
Accounting: "com.intuit.quickbooks.accounting",
Payment: "com.intuit.quickbooks.payment",
Payroll: "com.intuit.quickbooks.payroll",
TimeTracking: "com.intuit.quickbooks.payroll.timetracking",
Benefits: "com.intuit.quickbooks.payroll.benefits",
Profile: "profile",
Email: "email",
Phone: "phone",
Address: "address",
OpenId: "openid",
Intuit_name: "intuit_name",
};
```
## Create Store
The store is how the token information is saved and retrieved. There are 3 different ways to create a store. Internal, Class and Functions. Only one method can be used at a time. If more than one method is being used, an error will be thrown.
### The Internal Method
The internal method is used if you are managing the OAuth process and token information yourself. by setting `autoRefresh` to `false` and supplying the `accessToken` you can use all of the instance methods to access quickbooks. You will not be able to create, refresh or revoke tokens. If you add the optional `refreshToken` you can use the `refreshAccessToken` method to refresh the token and can set `autoRefresh` to `true` to auto refresh the token. `autoRefresh` requires `appKey` and `appSecret`.
If you do not supply an accessToken, you must supply the `appKey`, `appSecret`, `refreshUrl` and `scope` to create, refresh or revoke tokens. If no other store properties are given, this is the method chosen.
```javascript
// QB config
const QBAppconfig = {
autoRefresh: false,
accessToken: '123',
};
```
```javascript
// QB config
const QBAppconfig = {
appKey: QB_APP_KEY,
appSecret: QB_APP_SECRET,
redirectUrl: QB_REDIRECT_URL,
scope: [
Quickbooks.scopes.Accounting,
],
accessToken: '123',
refreshToken: '123',
};
```
### The Functions method
The functions method supplies the appConfig with two functions. `getToken` and `saveToken`. These functions will be used to get and save the token information. The `getToken` and `saveToken` functions both return a promise with token information. `extra` has the information supplied in the original qbo instance.
```javascript
// QB config
const QBAppconfig = {
appKey: QB_APP_KEY,
appSecret: QB_APP_SECRET,
redirectUrl: QB_REDIRECT_URL,
scope: [
Quickbooks.scopes.Accounting,
],
getToken(realmId: number | string, appConfig: AppConfig, extra: any) {
// should pull from database or some other storage method
return Promise.resolve(realms[realmId]);
},
saveToken(realmId: number | string, tokenData: StoreTokenData, appConfig: AppConfig, extra: any) {
// should save to database or some other storage method
realms[realmId] = saveTokenData;
return Promise.resolve(saveTokenData);
},
};
```
### The Class method
This method was previously the only store method. It was a class given to AppConfig with a getQBToken and storeQBToken. It returns a promise with the token information. `extra` has the information supplied in the original qbo instance.
```ts
class QBStore implements QBStoreStrategy {
/**
* Uses a realmID to lookup the token information.
* Must return a promise with the token information
*/
getQBToken(getTokenData: StoreGetTokenData, appConfig: AppConfig, extra: any) {
const realmID = getTokenData.realmID.toString();
// should pull from database or some other storage method
Promise.resolve(realmInfo[realmID]);
}
/**
* Used to store the new token information
* Will be looked up using the realmID
*/
storeQBToken(storeData: StoreSaveTokenData, appConfig: AppConfig, extra: any) {
const realmID = storeData.realmID.toString();
// should save to database or some other storage method
realmInfo[realmID] = storeData
Promis.resolve(realmInfo[realmID])
}
}
// QB config
const QBAppconfig = {
appKey: QB_APP_KEY,
appSecret: QB_APP_SECRET,
redirectUrl: QB_REDIRECT_URL,
scope: [
Quickbooks.scopes.Accounting,
],
storeStrategy: new QBStore(),
};
```
## OAuth
The OAuth process is used to get the initial token information. The OAuth process is a 3 step process. The first step is to generate an OAuth link. The second step is to use the authCode to create the token. The third step is to use the token to make requests to Quickbooks. The first step is done by using the authorizeUrl method. The second step is done by using the createToken method. The third step is done by using the Quickbooks class.
The authorizeUrl method will return a url to redirect the user to. The user will then login to Quickbooks and authorize your app. Once the user authorizes your app, they will be redirected to the redirectUrl you supplied in the config. The redirectUrl will have a query string with the authCode and realmID. The authCode is used to create the token and the realmID is used to make requests to Quickbooks.
```javascript
// --- End points required to get inital token, Express example
// QB requestToken - Used to start the process
const states = {}; // optional, can be anything you want to track states
app.get("/requestToken", (req, res) => {
const state = Quickbooks.generateState(); // optional
states[state] = true; // optional
const authUrl = Quickbooks.authorizeUrl(QBAppconfig, state); // state is optional
res.redirect(authUrl);
});
// QB token callback - This endpoint must match what you put in your quickbooks app and config
app.get("/callback", async (req, res) => {
let realmID = req.query.realmId;
let authCode = req.query.code;
let state = req.query.state;
// should check state here to prevent CSRF attacks
if (!states[state]) {
res.sendStatus(401);
return;
}
states[state] = false;
// check if realmID and authCode are present
if (!realmID || typeof realmID !== "string" || !authCode || typeof authCode !== "string") {
res.sendStatus(404)
return;
}
// create token
try {
var qbo = new Quickbooks(QBAppconfig, realmID);
const newToken = await qbo.createToken(authCode);
res.send(newToken); // Should not send token out
} catch (err) {
console.log("Error getting token", err);
res.send(err).status(500);
}
});
```
## Query
The query is used to search for a resources. The query is a javascript object or an array of query items that will be converted to a query string. You can also create your own query string instead. Quickbooks does not allow OR in the where statement so all filters will be joined by AND.
There are two main methods for querying. find[EntityName] and count[EntityName]. The find method will return the resources and the count method will return the count of the resources.
### Special query properties
| Property | Type | Description |
| --- | --- | --- |
| limit | number | The limit is the number of resources to return. The default and max is 1000. special default of 1000 if fetchAll is true |
| offset | number | The offset is the number of resources to skip. The default is 0. converts to startposition in the query string by adding 1 |
| asc | string | The asc is the field name to sort by in ascending order. The default is undefined. Cannot be used with desc or sort |
| desc | string | The desc is the field name to sort by in descending order. The default is undefined. Cannot be used with asc or sort |
| sort | string, string[], string[][] | The sort is an array of field names to sort by. The default is undefined. Cannot be used with asc or desc. More information on sorting below |
| fetchAll | boolean | The fetchAll is a boolean to fetch all the resources. The default is false. If true, will make multiple requests to get all the resources. Limit and offset will be used so setting a smaller limit will make more requests to fetch all the resources. If limit is not set, a default limit of 1000 will be used. |
| items | QueryItem[] | The items is an array of query items. The default is undefined. The items array is an array of query items. The query item is an object with the following properties: |
| items.field | string | The field is the field name to filter by. Required |
| items.value | string | The value is the value to filter by. Required |
| items.operator | "=", "IN", "<", ">", "<=", ">=", "LIKE" | The operator is the operator to use for the filter. The default is "=". Available values are |
| [key] | string | Any other property will be converted to a query string. The key will be the field name and the value will be the value to filter by. The operator will be "=" |
### Find
The find method is used to find resources.
```javascript
const customers = await qbo.findCustomers({
Id: "1234",
limit: 10,
});
const customers = await qbo.findCustomers({
field: "Id",
value: "1234",
operator: "=", // optional, default is "="
});
const customers = await qbo.findCustomers({
limit: 10,
items: [
{
field: "Id",
value: "1234"
},
],
});
const customers = await qbo.findCustomers("SELECT * FROM Customer WHERE Id = '1234'");
// return object looks like:
// {
// QueryResponse: {
// startPosition?: number;
// totalCount?: number;
// maxResults?: number;
// Customer?: Customer[];
// };
// time: string;
// }
```
### Count
The count method is used to count the number of resources. The count method will return a queryrequest with a single property called totalCount. The totalCount is the number of resources that match the query. You can use the same input for count[EntittyName] as you do for find[EntityName].
```javascript
const count = await qbo.countCustomers({
Id: "1234",
});
const count = await qbo.countCustomers({
field: "Name",
value: "hello%world",
operator: "like",
});
// return object looks like:
// {
// QueryResponse: {
// totalCount: number;
// };
// time: string;
// }
```
### Sorting query
You can sort the query by using the sort property or for single sorting the asc or desc fields. You can only use 1 of the 3 methods on a query. The sort property is an array of either string or array. if the item is an array, the first item in the array is the field name and the second item is the direction. The direction can be ASC or DESC. If the item is a string, it will be the field name and sorted ASC. If the sort field is an array of 2 strings, the first item is the field name and the second item is the direction. The direction can be ASC or DESC. capitlization of ASC or DESC does not matter
```javascript
const customers = await qbo.findCustomers({
asc: "Id",
limit: 10,
});
const customers = await qbo.findCustomers({
desc: "Id",
limit: 10,
});
const customers = await qbo.findCustomers({
sort: [["Id", "desc"], ["Name", "asc"]],
limit: 10,
});
const customers = await qbo.findCustomers({
sort: [["Id", "desc"], "Name"],
limit: 10,
});
const customers = await qbo.findCustomers({
sort: ["Id", "Name"],
limit: 10,
});
const customers = await qbo.findCustomers({
sort: ["Id", "desc"],
limit: 10,
});
```
## Webhook
The webhook is used to verify the webhook signature. The webhook signature is a sha256 hash of the payload and compared with the verify webhook string you receive once you create the webhook in Quickbooks. To see how to configure the webhook url, go here: [Quickbooks Webhook Docs](https://developer.intuit.com/app/developer/qbo/docs/develop/webhooks).
There is a helper method for checking the signature against the payload to confirm the webhook is verfied. There is also types to use for the payload. The webhook will be sent to periodically (seems pretty quick) with all changes on any realms your app is connected to.
```typescript
app.post("/qbwebhook", (req, res) => {
const webhookPayload = req.body as WebhookPayload
const signature = req.get('intuit-signature');
console.log("signature", signature, "webhookPayload", JSON.stringify(webhookPayload, null, 2))
if (!signature) {
console.log("no signature");
res.status(401).send('FORBIDDEN');
return;
}
const signatureCheck = Quickbooks.VerifyWebhookWithConfig(QBAppconfig, webhookPayload, signature);
// const signatureCheck = Quickbooks.VerifyWebhook(verifyString, webhookPayload, signature);
// const signatureCheck = qbo.VerifyWebhook(webhookPayload, signature); // instance
if (!signatureCheck) {
console.log("signatureCheck failed");
res.status(401).send('FORBIDDEN');
return
}
console.log("webhookPayload is verified", webhookPayload);
res.status(200).send('SUCCESS');
// Do stuff here with the webhookPayload
/*
{
"eventNotifications": [{
"realmId": "193514507456064",
"dataChangeEvent": {
"entities": [
{
"name": "Customer",
"id": "67",
"operation": "Create",
"lastUpdated": "2023-10-27T19:26:27.000Z"
}
]
}
}]
}
*/
})
```
## Change Data Capture (CDC)
The change data capture (cdc) operation returns a list of objects that have changed since a specified time. This operation is for an app that periodically polls data services in order to refresh its local copy of object data. The app calls the cdc operation, specifying a comma separated list of object types and a date-time stamp specifying how far to look back. Data services returns all objects specified by entityList that have changed since the specified date-time. Look-back time can be up to 30 days.
[Quickbooks CDC Docs](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/changedatacapture)
The since date can be a Date, number or string. If it is a number, it will be converted to a date then ISO 8601 string. If it is a string, it will be sent as is. Can be YYYY-MM-DD or full ISO 8601. If it is a date, it will be converted to ISO 8601
```typescript
// minus 30 days from today
const testDateDate = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000)
const cdcData = await qbo.changeDataCapture(['Invoice', 'Customer'], testDateDate);
console.log("cdcData", cdcData);
```
<a name="QuickBooks"></a>
# QuickBooks Methods
**Kind**: global class
* [QuickBooks](#QuickBooks)
* [new QuickBooks(appConfig, realmID)](#new_QuickBooks_new)
* _instance_
* [.authorizeUrl()](#QuickBooks+authorizeUrl) ⇒ <code>string</code>
* [.createToken(authCode, realmID)](#QuickBooks+createToken) ⇒ <code>object</code>
* [.saveToken(token)](#QuickBooks+saveToken)
* [.getToken()](#QuickBooks+getToken)
* [.refreshWithAccessToken(token)](#QuickBooks+refreshWithAccessToken) ⇒ <code>Token</code>
* [.refreshAccessToken()](#QuickBooks+refreshAccessToken) ⇒ <code>Token</code>
* [.revokeAccess(useRefresh)](#QuickBooks+revokeAccess)
* [.validateIdToken()](#QuickBooks+validateIdToken)
* [.getPublicKey(modulus, exponent)](#QuickBooks+getPublicKey)
* [.getUserInfo()](#QuickBooks+getUserInfo)
* [.batch(items)](#QuickBooks+batch)
* [.changeDataCapture(entities, since)](#QuickBooks+changeDataCapture)
* [.upload(filename, contentType, stream, entityType, entityId)](#QuickBooks+upload)
* [.createAccount(account)](#QuickBooks+createAccount)
* [.createAttachable(attachable)](#QuickBooks+createAttachable)
* [.createBill(bill)](#QuickBooks+createBill)
* [.createBillPayment(billPayment)](#QuickBooks+createBillPayment)
* [.createClass(class)](#QuickBooks+createClass)
* [.createCreditMemo(creditMemo)](#QuickBooks+createCreditMemo)
* [.createCustomer(customer)](#QuickBooks+createCustomer)
* [.createDepartment(department)](#QuickBooks+createDepartment)
* [.createDeposit(deposit)](#QuickBooks+createDeposit)
* [.createEmployee(employee)](#QuickBooks+createEmployee)
* [.createEstimate(estimate)](#QuickBooks+createEstimate)
* [.createInvoice(invoice)](#QuickBooks+createInvoice)
* [.createItem(item)](#QuickBooks+createItem)
* [.createJournalCode(journalCode)](#QuickBooks+createJournalCode)
* [.createJournalEntry(journalEntry)](#QuickBooks+createJournalEntry)
* [.createPayment(payment)](#QuickBooks+createPayment)
* [.createPaymentMethod(paymentMethod)](#QuickBooks+createPaymentMethod)
* [.createPurchase(purchase)](#QuickBooks+createPurchase)
* [.createPurchaseOrder(purchaseOrder)](#QuickBooks+createPurchaseOrder)
* [.createRefundReceipt(refundReceipt)](#QuickBooks+createRefundReceipt)
* [.createSalesReceipt(salesReceipt)](#QuickBooks+createSalesReceipt)
* [.createTaxAgency(taxAgency)](#QuickBooks+createTaxAgency)
* [.createTaxService(taxService)](#QuickBooks+createTaxService)
* [.createTerm(term)](#QuickBooks+createTerm)
* [.createTimeActivity(timeActivity)](#QuickBooks+createTimeActivity)
* [.createTransfer(transfer)](#QuickBooks+createTransfer)
* [.createVendor(vendor)](#QuickBooks+createVendor)
* [.createVendorCredit(vendorCredit)](#QuickBooks+createVendorCredit)
* [.getAccount(Id)](#QuickBooks+getAccount)
* [.getAttachable(Id)](#QuickBooks+getAttachable)
* [.getBill(Id)](#QuickBooks+getBill)
* [.getBillPayment(Id)](#QuickBooks+getBillPayment)
* [.getClass(Id)](#QuickBooks+getClass)
* [.getCompanyInfo(Id)](#QuickBooks+getCompanyInfo)
* [.getCreditMemo(Id)](#QuickBooks+getCreditMemo)
* [.getCustomer(Id)](#QuickBooks+getCustomer)
* [.getDepartment(Id)](#QuickBooks+getDepartment)
* [.getDeposit(Id)](#QuickBooks+getDeposit)
* [.getEmployee(Id)](#QuickBooks+getEmployee)
* [.getEstimate(Id)](#QuickBooks+getEstimate)
* [.getExchangeRate(options)](#QuickBooks+getExchangeRate)
* [.getEstimatePdf(Id)](#QuickBooks+getEstimatePdf)
* [.sendEstimatePdf(Id, sendTo)](#QuickBooks+sendEstimatePdf)
* [.getInvoice(Id)](#QuickBooks+getInvoice)
* [.getInvoicePdf(Id)](#QuickBooks+getInvoicePdf)
* [.sendInvoicePdf(Id, sendTo)](#QuickBooks+sendInvoicePdf)
* [.getItem(Id)](#QuickBooks+getItem)
* [.getJournalCode(Id)](#QuickBooks+getJournalCode)
* [.getJournalEntry(Id)](#QuickBooks+getJournalEntry)
* [.getPayment(Id)](#QuickBooks+getPayment)
* [.getPaymentMethod(Id)](#QuickBooks+getPaymentMethod)
* [.getPreferences()](#QuickBooks+getPreferences)
* [.getPurchase(Id)](#QuickBooks+getPurchase)
* [.getPurchaseOrder(Id)](#QuickBooks+getPurchaseOrder)
* [.getRefundReceipt(Id)](#QuickBooks+getRefundReceipt)
* [.getReports(Id)](#QuickBooks+getReports)
* [.getSalesReceipt(Id)](#QuickBooks+getSalesReceipt)
* [.getSalesReceiptPdf(Id)](#QuickBooks+getSalesReceiptPdf)
* [.sendSalesReceiptPdf(Id, sendTo)](#QuickBooks+sendSalesReceiptPdf)
* [.getTaxAgency(Id)](#QuickBooks+getTaxAgency)
* [.getTaxCode(Id)](#QuickBooks+getTaxCode)
* [.getTaxRate(Id)](#QuickBooks+getTaxRate)
* [.getTerm(Id)](#QuickBooks+getTerm)
* [.getTimeActivity(Id)](#QuickBooks+getTimeActivity)
* [.getTransfer(Id)](#QuickBooks+getTransfer)
* [.getVendor(Id)](#QuickBooks+getVendor)
* [.getVendorCredit(Id)](#QuickBooks+getVendorCredit)
* [.updateAccount(account)](#QuickBooks+updateAccount)
* [.updateAttachable(attachable)](#QuickBooks+updateAttachable)
* [.updateBill(bill)](#QuickBooks+updateBill)
* [.updateBillPayment(billPayment)](#QuickBooks+updateBillPayment)
* [.updateClass(class)](#QuickBooks+updateClass)
* [.updateCompanyInfo(companyInfo)](#QuickBooks+updateCompanyInfo)
* [.updateCreditMemo(creditMemo)](#QuickBooks+updateCreditMemo)
* [.updateCustomer(customer)](#QuickBooks+updateCustomer)
* [.updateDepartment(department)](#QuickBooks+updateDepartment)
* [.updateDeposit(deposit)](#QuickBooks+updateDeposit)
* [.updateEmployee(employee)](#QuickBooks+updateEmployee)
* [.updateEstimate(estimate)](#QuickBooks+updateEstimate)
* [.updateInvoice(invoice)](#QuickBooks+updateInvoice)
* [.updateItem(item)](#QuickBooks+updateItem)
* [.updateJournalCode(journalCode)](#QuickBooks+updateJournalCode)
* [.updateJournalEntry(journalEntry)](#QuickBooks+updateJournalEntry)
* [.updatePayment(payment)](#QuickBooks+updatePayment)
* [.updatePaymentMethod(paymentMethod)](#QuickBooks+updatePaymentMethod)
* [.updatePreferences(preferences)](#QuickBooks+updatePreferences)
* [.updatePurchase(purchase)](#QuickBooks+updatePurchase)
* [.updatePurchaseOrder(purchaseOrder)](#QuickBooks+updatePurchaseOrder)
* [.updateRefundReceipt(refundReceipt)](#QuickBooks+updateRefundReceipt)
* [.updateSalesReceipt(salesReceipt)](#QuickBooks+updateSalesReceipt)
* [.updateTaxAgency(taxAgency)](#QuickBooks+updateTaxAgency)
* [.updateTaxCode(taxCode)](#QuickBooks+updateTaxCode)
* [.updateTaxRate(taxRate)](#QuickBooks+updateTaxRate)
* [.updateTerm(term)](#QuickBooks+updateTerm)
* [.updateTimeActivity(timeActivity)](#QuickBooks+updateTimeActivity)
* [.updateTransfer(Transfer)](#QuickBooks+updateTransfer)
* [.updateVendor(vendor)](#QuickBooks+updateVendor)
* [.updateVendorCredit(vendorCredit)](#QuickBooks+updateVendorCredit)
* [.updateExchangeRate(exchangeRate)](#QuickBooks+updateExchangeRate)
* [.deleteAttachable(idOrEntity)](#QuickBooks+deleteAttachable)
* [.deleteBill(idOrEntity)](#QuickBooks+deleteBill)
* [.deleteBillPayment(idOrEntity)](#QuickBooks+deleteBillPayment)
* [.deleteCreditMemo(idOrEntity)](#QuickBooks+deleteCreditMemo)
* [.deleteDeposit(idOrEntity)](#QuickBooks+deleteDeposit)
* [.deleteEstimate(idOrEntity)](#QuickBooks+deleteEstimate)
* [.deleteInvoice(idOrEntity)](#QuickBooks+deleteInvoice)
* [.deleteJournalCode(idOrEntity)](#QuickBooks+deleteJournalCode)
* [.deleteJournalEntry(idOrEntity)](#QuickBooks+deleteJournalEntry)
* [.deletePayment(idOrEntity)](#QuickBooks+deletePayment)
* [.deletePurchase(idOrEntity)](#QuickBooks+deletePurchase)
* [.deletePurchaseOrder(idOrEntity)](#QuickBooks+deletePurchaseOrder)
* [.deleteRefundReceipt(idOrEntity)](#QuickBooks+deleteRefundReceipt)
* [.deleteSalesReceipt(idOrEntity)](#QuickBooks+deleteSalesReceipt)
* [.deleteTimeActivity(idOrEntity)](#QuickBooks+deleteTimeActivity)
* [.deleteTransfer(idOrEntity)](#QuickBooks+deleteTransfer)
* [.deleteVendorCredit(idOrEntity)](#QuickBooks+deleteVendorCredit)
* [.voidInvoice(idOrEntity)](#QuickBooks+voidInvoice)
* [.voidPayment(payment)](#QuickBooks+voidPayment)
* [.findAccounts(criteria)](#QuickBooks+findAccounts)
* [.findAttachables(criteria)](#QuickBooks+findAttachables)
* [.findBills(criteria)](#QuickBooks+findBills)
* [.findBillPayments(criteria)](#QuickBooks+findBillPayments)
* [.findBudgets(criteria)](#QuickBooks+findBudgets)
* [.findClasses(criteria)](#QuickBooks+findClasses)
* [.findCompanyInfos(criteria)](#QuickBooks+findCompanyInfos)
* [.findCreditMemos(criteria)](#QuickBooks+findCreditMemos)
* [.findCustomers(criteria)](#QuickBooks+findCustomers)
* [.findDepartments(criteria)](#QuickBooks+findDepartments)
* [.findDeposits(criteria)](#QuickBooks+findDeposits)
* [.findEmployees(criteria)](#QuickBooks+findEmployees)
* [.findEstimates(criteria)](#QuickBooks+findEstimates)
* [.findInvoices(criteria)](#QuickBooks+findInvoices)
* [.findItems(criteria)](#QuickBooks+findItems)
* [.findJournalCodes(criteria)](#QuickBooks+findJournalCodes)
* [.findJournalEntries(criteria)](#QuickBooks+findJournalEntries)
* [.findPayments(criteria)](#QuickBooks+findPayments)
* [.findPaymentMethods(criteria)](#QuickBooks+findPaymentMethods)
* [.findPreferenceses(criteria)](#QuickBooks+findPreferenceses)
* [.findPurchases(criteria)](#QuickBooks+findPurchases)
* [.findPurchaseOrders(criteria)](#QuickBooks+findPurchaseOrders)
* [.findRefundReceipts(criteria)](#QuickBooks+findRefundReceipts)
* [.findSalesReceipts(criteria)](#QuickBooks+findSalesReceipts)
* [.findTaxAgencies(criteria)](#QuickBooks+findTaxAgencies)
* [.findTaxCodes(criteria)](#QuickBooks+findTaxCodes)
* [.findTaxRates(criteria)](#QuickBooks+findTaxRates)
* [.findTerms(criteria)](#QuickBooks+findTerms)
* [.findTimeActivities(criteria)](#QuickBooks+findTimeActivities)
* [.findTransfers(criteria)](#QuickBooks+findTransfers)
* [.findVendors(criteria)](#QuickBooks+findVendors)
* [.findVendorCredits(criteria)](#QuickBooks+findVendorCredits)
* [.findExchangeRates(criteria)](#QuickBooks+findExchangeRates)
* [.reportBalanceSheet(options)](#QuickBooks+reportBalanceSheet)
* [.reportProfitAndLoss(options)](#QuickBooks+reportProfitAndLoss)
* [.reportProfitAndLossDetail(options)](#QuickBooks+reportProfitAndLossDetail)
* [.reportTrialBalance(options)](#QuickBooks+reportTrialBalance)
* [.reportCashFlow(options)](#QuickBooks+reportCashFlow)
* [.reportInventoryValuationSummary(options)](#QuickBooks+reportInventoryValuationSummary)
* [.reportCustomerSales(options)](#QuickBooks+reportCustomerSales)
* [.reportItemSales(options)](#QuickBooks+reportItemSales)
* [.reportCustomerIncome(options)](#QuickBooks+reportCustomerIncome)
* [.reportCustomerBalance(options)](#QuickBooks+reportCustomerBalance)
* [.reportCustomerBalanceDetail(options)](#QuickBooks+reportCustomerBalanceDetail)
* [.reportAgedReceivables(options)](#QuickBooks+reportAgedReceivables)
* [.reportAgedReceivableDetail(options)](#QuickBooks+reportAgedReceivableDetail)
* [.reportVendorBalance(options)](#QuickBooks+reportVendorBalance)
* [.reportVendorBalanceDetail(options)](#QuickBooks+reportVendorBalanceDetail)
* [.reportAgedPayables(options)](#QuickBooks+reportAgedPayables)
* [.reportAgedPayableDetail(options)](#QuickBooks+reportAgedPayableDetail)
* [.reportVendorExpenses(options)](#QuickBooks+reportVendorExpenses)
* [.reportTransactionList(options)](#QuickBooks+reportTransactionList)
* [.reportGeneralLedgerDetail(options)](#QuickBooks+reportGeneralLedgerDetail)
* [.reportTaxSummary(options)](#QuickBooks+reportTaxSummary)
* [.reportDepartmentSales(options)](#QuickBooks+reportDepartmentSales)
* [.reportClassSales(options)](#QuickBooks+reportClassSales)
* [.reportAccountListDetail(options)](#QuickBooks+reportAccountListDetail)
* _static_
* [.authorizeUrl(appConfig)](#QuickBooks.authorizeUrl) ⇒ <code>string</code>
* [.createToken(appConfig, authCode, realmID)](#QuickBooks.createToken) ⇒ <code>object</code>
* [._dateNotExpired(expired_timestamp)](#QuickBooks._dateNotExpired) ⇒ <code>boolean</code>
* [.isAccessTokenValid(token)](#QuickBooks.isAccessTokenValid) ⇒ <code>boolean</code>
* [.isRefreshTokenValid(token)](#QuickBooks.isRefreshTokenValid) ⇒ <code>boolean</code>
* [.saveToken(store, info)](#QuickBooks.saveToken)
* [.getToken()](#QuickBooks.getToken)
<a name="new_QuickBooks_new"></a>
### new QuickBooks(appConfig, realmID)
Node.js client encapsulating access to the QuickBooks V3 Rest API. An instance
of this class should be instantiated on behalf of each user and company accessing the api.
| Param | Description |
| --- | --- |
| appConfig | application information |
| realmID | QuickBooks companyId, returned as a request parameter when the user is redirected to the provided callback URL following authentication |
<a name="QuickBooks+authorizeUrl"></a>
### quickBooks.authorizeUrl() ⇒ <code>string</code>
Redirect link to Authorization Page
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
**Returns**: <code>string</code> - authorize Uri
<a name="QuickBooks+createToken"></a>
### quickBooks.createToken(authCode, realmID) ⇒ <code>object</code>
Creates new token for the realmID from the returned authorization code received in the callback request
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
**Returns**: <code>object</code> - new token with expiration dates from storeStrategy
| Param | Type | Description |
| --- | --- | --- |
| authCode | <code>string</code> | The code returned in your callback as a param called "code" |
| realmID | <code>number</code> | The company identifier in your callback as a param called "realmId" |
<a name="QuickBooks+saveToken"></a>
### quickBooks.saveToken(token)
Save token
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| token | <code>object</code> | the token to send to store area |
<a name="QuickBooks+getToken"></a>
### quickBooks.getToken()
Get token
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
<a name="QuickBooks+refreshWithAccessToken"></a>
### quickBooks.refreshWithAccessToken(token) ⇒ <code>Token</code>
Use the refresh token to obtain a new access token.
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
**Returns**: <code>Token</code> - returns fresh token with access_token and refresh_token
| Param | Type | Description |
| --- | --- | --- |
| token | <code>Token</code> | has the refresh_token |
<a name="QuickBooks+refreshAccessToken"></a>
### quickBooks.refreshAccessToken() ⇒ <code>Token</code>
Use the refresh token to obtain a new access token.
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
**Returns**: <code>Token</code> - returns fresh token with access_token and refresh_token
<a name="QuickBooks+revokeAccess"></a>
### quickBooks.revokeAccess(useRefresh)
Use either refresh token or access token to revoke access (OAuth2).
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Description |
| --- | --- |
| useRefresh | boolean - Indicates which token to use: true to use the refresh token, false to use the access token. |
<a name="QuickBooks+validateIdToken"></a>
### quickBooks.validateIdToken()
Validate id_token
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
<a name="QuickBooks+getPublicKey"></a>
### quickBooks.getPublicKey(modulus, exponent)
get Public Key
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param |
| --- |
| modulus |
| exponent |
<a name="QuickBooks+getUserInfo"></a>
### quickBooks.getUserInfo()
Get user info (OAuth2).
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
<a name="QuickBooks+batch"></a>
### quickBooks.batch(items)
Batch operation to enable an application to perform multiple operations in a single request.
The following batch items are supported:
create
update
delete
query
The maximum number of batch items in a single request is 25.
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| items | <code>object</code> | JavaScript array of batch items |
<a name="QuickBooks+changeDataCapture"></a>
### quickBooks.changeDataCapture(entities, since)
The change data capture (CDC) operation returns a list of entities that have changed since a specified time.
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| entities | <code>object</code> | Comma separated list or JavaScript array of entities to search for changes |
| since | <code>object</code> \| <code>number</code> \| <code>string</code> | JS Date object, JS Date milliseconds, or string in ISO 8601 - to look back for changes until |
<a name="QuickBooks+upload"></a>
### quickBooks.upload(filename, contentType, stream, entityType, entityId)
Uploads a file as an Attachable in QBO, optionally linking it to the specified
QBO Entity.
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| filename | <code>string</code> | the name of the file |
| contentType | <code>string</code> | the mime type of the file |
| stream | <code>object</code> | ReadableStream of file contents |
| entityType | <code>object</code> | optional string name of the QBO entity the Attachable will be linked to (e.g. Invoice) |
| entityId | <code>object</code> | optional Id of the QBO entity the Attachable will be linked to |
<a name="QuickBooks+createAccount"></a>
### quickBooks.createAccount(account)
Creates the Account in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| account | <code>object</code> | The unsaved account, to be persisted in QuickBooks |
<a name="QuickBooks+createAttachable"></a>
### quickBooks.createAttachable(attachable)
Creates the Attachable in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| attachable | <code>object</code> | The unsaved attachable, to be persisted in QuickBooks |
<a name="QuickBooks+createBill"></a>
### quickBooks.createBill(bill)
Creates the Bill in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| bill | <code>object</code> | The unsaved bill, to be persisted in QuickBooks |
<a name="QuickBooks+createBillPayment"></a>
### quickBooks.createBillPayment(billPayment)
Creates the BillPayment in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| billPayment | <code>object</code> | The unsaved billPayment, to be persisted in QuickBooks |
<a name="QuickBooks+createClass"></a>
### quickBooks.createClass(class)
Creates the Class in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| class | <code>object</code> | The unsaved class, to be persisted in QuickBooks |
<a name="QuickBooks+createCreditMemo"></a>
### quickBooks.createCreditMemo(creditMemo)
Creates the CreditMemo in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| creditMemo | <code>object</code> | The unsaved creditMemo, to be persisted in QuickBooks |
<a name="QuickBooks+createCustomer"></a>
### quickBooks.createCustomer(customer)
Creates the Customer in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| customer | <code>object</code> | The unsaved customer, to be persisted in QuickBooks |
<a name="QuickBooks+createDepartment"></a>
### quickBooks.createDepartment(department)
Creates the Department in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| department | <code>object</code> | The unsaved department, to be persisted in QuickBooks |
<a name="QuickBooks+createDeposit"></a>
### quickBooks.createDeposit(deposit)
Creates the Deposit in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| deposit | <code>object</code> | The unsaved Deposit, to be persisted in QuickBooks |
<a name="QuickBooks+createEmployee"></a>
### quickBooks.createEmployee(employee)
Creates the Employee in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| employee | <code>object</code> | The unsaved employee, to be persisted in QuickBooks |
<a name="QuickBooks+createEstimate"></a>
### quickBooks.createEstimate(estimate)
Creates the Estimate in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| estimate | <code>object</code> | The unsaved estimate, to be persisted in QuickBooks |
<a name="QuickBooks+createInvoice"></a>
### quickBooks.createInvoice(invoice)
Creates the Invoice in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| invoice | <code>object</code> | The unsaved invoice, to be persisted in QuickBooks |
<a name="QuickBooks+createItem"></a>
### quickBooks.createItem(item)
Creates the Item in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| item | <code>object</code> | The unsaved item, to be persisted in QuickBooks |
<a name="QuickBooks+createJournalCode"></a>
### quickBooks.createJournalCode(journalCode)
Creates the JournalCode in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| journalCode | <code>object</code> | The unsaved journalCode, to be persisted in QuickBooks |
<a name="QuickBooks+createJournalEntry"></a>
### quickBooks.createJournalEntry(journalEntry)
Creates the JournalEntry in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| journalEntry | <code>object</code> | The unsaved journalEntry, to be persisted in QuickBooks |
<a name="QuickBooks+createPayment"></a>
### quickBooks.createPayment(payment)
Creates the Payment in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| payment | <code>object</code> | The unsaved payment, to be persisted in QuickBooks |
<a name="QuickBooks+createPaymentMethod"></a>
### quickBooks.createPaymentMethod(paymentMethod)
Creates the PaymentMethod in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| paymentMethod | <code>object</code> | The unsaved paymentMethod, to be persisted in QuickBooks |
<a name="QuickBooks+createPurchase"></a>
### quickBooks.createPurchase(purchase)
Creates the Purchase in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| purchase | <code>object</code> | The unsaved purchase, to be persisted in QuickBooks |
<a name="QuickBooks+createPurchaseOrder"></a>
### quickBooks.createPurchaseOrder(purchaseOrder)
Creates the PurchaseOrder in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| purchaseOrder | <code>object</code> | The unsaved purchaseOrder, to be persisted in QuickBooks |
<a name="QuickBooks+createRefundReceipt"></a>
### quickBooks.createRefundReceipt(refundReceipt)
Creates the RefundReceipt in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| refundReceipt | <code>object</code> | The unsaved refundReceipt, to be persisted in QuickBooks |
<a name="QuickBooks+createSalesReceipt"></a>
### quickBooks.createSalesReceipt(salesReceipt)
Creates the SalesReceipt in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| salesReceipt | <code>object</code> | The unsaved salesReceipt, to be persisted in QuickBooks |
<a name="QuickBooks+createTaxAgency"></a>
### quickBooks.createTaxAgency(taxAgency)
Creates the TaxAgency in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| taxAgency | <code>object</code> | The unsaved taxAgency, to be persisted in QuickBooks |
<a name="QuickBooks+createTaxService"></a>
### quickBooks.createTaxService(taxService)
Creates the TaxService in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| taxService | <code>object</code> | The unsaved taxService, to be persisted in QuickBooks |
<a name="QuickBooks+createTerm"></a>
### quickBooks.createTerm(term)
Creates the Term in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| term | <code>object</code> | The unsaved term, to be persisted in QuickBooks |
<a name="QuickBooks+createTimeActivity"></a>
### quickBooks.createTimeActivity(timeActivity)
Creates the TimeActivity in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| timeActivity | <code>object</code> | The unsaved timeActivity, to be persisted in QuickBooks |
<a name="QuickBooks+createTransfer"></a>
### quickBooks.createTransfer(transfer)
Creates the Transfer in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| transfer | <code>object</code> | The unsaved Transfer, to be persisted in QuickBooks |
<a name="QuickBooks+createVendor"></a>
### quickBooks.createVendor(vendor)
Creates the Vendor in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| vendor | <code>object</code> | The unsaved vendor, to be persisted in QuickBooks |
<a name="QuickBooks+createVendorCredit"></a>
### quickBooks.createVendorCredit(vendorCredit)
Creates the VendorCredit in QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| vendorCredit | <code>object</code> | The unsaved vendorCredit, to be persisted in QuickBooks |
<a name="QuickBooks+getAccount"></a>
### quickBooks.getAccount(Id)
Retrieves the Account from QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| Id | <code>string</code> | The Id of persistent Account |
<a name="QuickBooks+getAttachable"></a>
### quickBooks.getAttachable(Id)
Retrieves the Attachable from QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| Id | <code>string</code> | The Id of persistent Attachable |
<a name="QuickBooks+getBill"></a>
### quickBooks.getBill(Id)
Retrieves the Bill from QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| Id | <code>string</code> | The Id of persistent Bill |
<a name="QuickBooks+getBillPayment"></a>
### quickBooks.getBillPayment(Id)
Retrieves the BillPayment from QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| Id | <code>string</code> | The Id of persistent BillPayment |
<a name="QuickBooks+getClass"></a>
### quickBooks.getClass(Id)
Retrieves the Class from QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| Id | <code>string</code> | The Id of persistent Class |
<a name="QuickBooks+getCompanyInfo"></a>
### quickBooks.getCompanyInfo(Id)
Retrieves the CompanyInfo from QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| Id | <code>string</code> | The Id of persistent CompanyInfo |
<a name="QuickBooks+getCreditMemo"></a>
### quickBooks.getCreditMemo(Id)
Retrieves the CreditMemo from QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | --- |
| Id | <code>string</code> | The Id of persistent CreditMemo |
<a name="QuickBooks+getCustomer"></a>
### quickBooks.getCustomer(Id)
Retrieves the Customer from QuickBooks
**Kind**: instance method of [<code>QuickBooks</code>](#QuickBooks)
| Param | Type | Description |
| --- | --- | ---