---
title: Bill
slug: quickbooks/bill
docTags: 
createdAt: 2024-03-06T10:30:19.097Z
---

When processing a Bill, use the requestJSON to pass the Bill data. The returned response will contain a responseJSON section with the Bill response returned by Breadwinner for QuickBooks.

The Bill object has the following parameters.

### Bill

| **Field Name**                          | **Data Type**                                | **Description**                                                                                                                                            |
| --------------------------------------- | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Balance                                 | Decimal                                      | The balance reflects any payments made against the transaction. Read Only                                                                                  |
| CurrencyRef                             | [value\_name](docId\:GoAsZtQI8wCZGotEKYtEK)  | Reference to the currency in which all amounts on the associated transaction are expressed.                                                                |
| DepartmentRef                           | [value\_name](docId\:GoAsZtQI8wCZGotEKYtEK)  | A reference to a Department object specifying the location of the transaction                                                                              |
| DocNumber<font color="#e00707">*</font> | String                                       | Bill Number                                                                                                                                                |
| DueDate                                 | String                                       | Date when the payment of the transaction is due. (add by converting date to string)                                                                        |
| ExchangeRate                            | Decimal                                      | The number of home currency units it takes to equal one unit of currency specified by CurrencyRef, Applicable if multicurrency is enabled for the company. |
| GlobalTaxCalculation                    | String                                       | Fixed values (NotApplicable, TaxInclusive,TaxExcluded)                                                                                                     |
| HomeBalance                             | Decimal                                      | Read Only                                                                                                                                                  |
| Line<font color="#e00707">*</font>      | [LineItem](docId\:MpZPCquzR-OqlFEOnw3y9)     | Individual line items of a transaction                                                                                                                     |
| Id                                      | String                                       | Unique identifier for this object and ReadOnly field                                                                                                       |
| Metadata                                | [Metadata](docId\:GoAsZtQI8wCZGotEKYtEK)     | Descriptive information about the object. The MetaData values are set by Data Services and are read only                                                   |
| PrivateNote                             | String                                       | User entered, organization-private note about the transaction                                                                                              |
| SyncToken                               | String                                       | Version number of the object. It is used to lock an object for use by one app at a time. Read Only                                                         |
| TotalAmt                                | Decimal                                      | Indicates the total amount of the transaction. This includes the total of all the charges, allowances, and taxes. Read Only                                |
| TxnDate                                 | String                                       | The date entered by the user when this transaction occurred. (add by converting date to string in yyyy-mm-dd format)                                       |
| TxnTaxDetail                            | [TxnTaxDetail](docId\:MpZPCquzR-OqlFEOnw3y9) | This data type provides information for taxes charged on the transaction as a whole.                                                                       |
| SalesTermRef                            | [value\_name](docId\:GoAsZtQI8wCZGotEKYtEK)  | Reference to a SalesTerm associated with this company object                                                                                               |
| Sparse                                  | Boolean                                      | Allows updating only specified properties of an object while leaving unspecified properties unchanged.                                                     |
| VendorRef<font color="#e00707">*</font> | [value\_name](docId\:GoAsZtQI8wCZGotEKYtEK)  | The ID (Unique QuickBooks Online ID) for the referenced vendor                                                                                             |

### LineItem&#x20;

| **Field Name**                | **Data Type**                                                 | **Description**                                                                                                         |
| ----------------------------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| AccountBasedExpenseLineDetail | [AccountBasedExpenseLineDetail](docId\:MpZPCquzR-OqlFEOnw3y9) |                                                                                                                         |
| Amount                        | Decimal                                                       |                                                                                                                         |
| Description                   | String                                                        |                                                                                                                         |
| DetailType                    | String                                                        | Provide the DetailType as SalesItemDetail, etc. <br />For Shipping charge apply the DetailType as 'SalesItemLineDetail' |
| Id                            | String                                                        |                                                                                                                         |
| ItemBasedExpenseLineDetail    | [ItemBasedExpenseLineDetail](docId\:MpZPCquzR-OqlFEOnw3y9)    |                                                                                                                         |

### AccountBasedExpenseLineDetail

| **Field Name** | **Data Type**                                   | **Description** |
| -------------- | ----------------------------------------------- | --------------- |
| APAccountRef   | [value\_name](docId\:GoAsZtQI8wCZGotEKYtEK)     |                 |
| AccountRef     | [value\_name](docId\:GoAsZtQI8wCZGotEKYtEK)     |                 |
| BillableStatus | String                                          |                 |
| VendorRef      | [value\_name](docId\:GoAsZtQI8wCZGotEKYtEK)     |                 |
| ItemRef        | [value\_name](docId\:GoAsZtQI8wCZGotEKYtEK)     |                 |
| MarkupInfo     | [MarkInformation](docId\:MpZPCquzR-OqlFEOnw3y9) |                 |
| Qty            | Decimal                                         |                 |
| UnitPrice      | Decimal                                         |                 |

### MarkInformation

| **Field Name** | **Data Type**  | **Description** |
| -------------- | -------------- | --------------- |
| Percent        | Decimal        |                 |

### ItemBasedExpenseLineDetail

| **Field Name** | **Data Type**                                   | **Description** |
| -------------- | ----------------------------------------------- | --------------- |
| BillableStatus | String                                          |                 |
| VendorRef      | [value\_name](docId\:GoAsZtQI8wCZGotEKYtEK)     |                 |
| ItemRef        | [value\_name](docId\:GoAsZtQI8wCZGotEKYtEK)     |                 |
| MarkupInfo     | [MarkInformation](docId\:MpZPCquzR-OqlFEOnw3y9) |                 |
| Qty            | Decimal                                         |                 |
| UnitPrice      | Decimal                                         |                 |

### TxnTaxDetail

| **Field Name** | **Data Type**                               | **Description** |
| -------------- | ------------------------------------------- | --------------- |
| TaxLine        | TaxLine\[]                                  |                 |
| TotalTax       | Decimal                                     |                 |
| TxnTaxCodeRef  | [value\_name](docId\:GoAsZtQI8wCZGotEKYtEK) |                 |

