---
title: Invoice
slug: netsuite/XSrE-invoice
description: This document provides detailed information on the parameters and data types associated with the Invoice object in Breadwinner for NetSuite integration. Learn about the various fields such as salesforceID, account, classification, createdDate, and more. A
docTags: 
createdAt: 2021-12-14T12:08:39.000Z
---

When requesting an Invoice, use the requestJSON to pass the Invoice data. The response that is returned will contain a responseJSON section which has the Invoice response returned by Breadwinner for NetSuite.

The Invoice object has the following parameters.

### Invoice

| **Field Name**                          | **Data Type**                                     | **Description**                                                                                                |
| --------------------------------------- | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| salesforceID                            | ID                                                | Read-Only field, provides the Salesforce Record ID upon successful creation or updation in Salesforce.         |
| account                                 | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) | Select the Accounts Receivable account that will be affected by this invoice.<br />Internal ID of the Account. |
| billingAddress                          | [AddressDetail](docId\:LGKOy7mdXhvjzkl2nr9Ql)     | Provide the custom address; otherwise, the customer's address will default.                                    |
| classification                          | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) |  Internal ID of the Class.                                                                                     |
| createdDate                             | Long                                              | Read-Only field, the Date will be returned as a Unix timestamp in seconds.                                     |
| createdFrom                             | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) | Internal ID of the Estimate/SalesOrder.                                                                        |
| currencyName                            | String                                            | Read-Only field, returns the Currency Name.                                                                    |
| currencyRecord                          | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) | Internal ID of the Currency.                                                                                   |
| customFieldList                         | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) | Custom fields and their values.                                                                                |
| customForm                              | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) | Internal ID of the Custom Form.                                                                                |
| department                              | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) | Internal ID of the Department.                                                                                 |
| discountItem                            | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) |  Internal ID of the Discount Item.                                                                             |
| discountRate                            | String                                            | Discount rate like “-12” or “15”.                                                                              |
| discountTotal                           | Double                                            | Read-Only field, returns the Total Discount.                                                                   |
| dueDate                                 | Long                                              | The date is accepted and returned as a Unix timestamp in seconds.                                              |
| entity<font color="#eb144c">\*</font>   | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) | Internal ID of the Entity (Customer).                                                                          |
| exchangeRate                            | Double                                            |  Supported only while creating, holds the value of the Exchange Rate.                                          |
| externalId                              | String                                            |                                                                                                                |
| handlingCost                            | Double                                            |                                                                                                                |
| internalId                              | String                                            |  Unique ID that NetSuite holds. It is required during the update of a Record.                                  |
| itemList<font color="#eb144c">\*</font> | [LineItems](docId\:XSrEr45ur9LxkfaHMkBrH)         | Holds the Line Items.                                                                                          |
| lastModifiedDate                        | Long                                              | Read-Only field and the Date is returned as a Unix timestamp in seconds.                                       |
| location                                | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) | Internal ID of the Location.                                                                                   |
| memo                                    | String                                            |                                                                                                                |
| otherRefNum                             | String                                            | PO/Check Number                                                                                                |
| salesRep                                | String                                            | Internal ID of the Sales Rep (Employee).                                                                       |
| shippingAddress                         | [AddressDetail](docId\:LGKOy7mdXhvjzkl2nr9Ql)     | Provide the custom address; otherwise, the customer's address will default.                                    |
| shippingCost                            | Double                                            |                                                                                                                |
| status                                  | String                                            | Read-Only field, returns the Status of the Invoice.                                                            |
| subsidiary                              | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) | Internal ID of the Subsidiary. By default, NetSuite considers the Subsidiary of the Customer if not provided.  |
| subTotal                                | Double                                            | Read-Only field, returns the Sub-Total Amount.                                                                 |
| taxTotal                                | Double                                            | Read-Only field, returns the Total Tax Amount.                                                                 |
| terms                                   | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) | Internal ID of the Terms                                                                                       |
| tranDate                                | Long                                              | The date is accepted and returned as a Unix timestamp in seconds.                                              |
| tranId                                  | String                                            | Provide Order # (number) or auto-generated by NetSuite                                                         |
| total                                   | Double                                            | Read-Only field, returns the Total Amount.                                                                     |

### LineItems

| **Field Name**                      | **Data Type**                                     | **Description**                                                                                                             |
| ----------------------------------- | ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| item<font color="#eb144c">\*</font> | [LineItemRecord](docId\:XSrEr45ur9LxkfaHMkBrH)\[] | List of LineItem Records.                                                                                                   |
| replaceAll                          | Boolean<br /><br />                               | The default value for the replaceAll attribute is true. If true, NetSuite will replace all the Line Items with the new ones |

### LineItemRecord

| **Field Name**                      | **Data Type**                                     | **Description**                                                                                                                                                         |
| ----------------------------------- | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| amount                              | Double                                            |                                                                                                                                                                         |
| classification                      | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) | Internal ID of the Class.                                                                                                                                               |
| customFieldList                     | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) | List of Custom Fields with their Values.                                                                                                                                |
| department                          | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) | Internal ID of the Department.                                                                                                                                          |
| description                         | String                                            | Item Description                                                                                                                                                        |
| grossAmt                            | Double                                            |                                                                                                                                                                         |
| item<font color="#eb144c">\*</font> | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) | Internal ID of the Item.                                                                                                                                                |
| line                                | Integer                                           | Whenever a new line item is added to the transaction, a unique Line Number is assigned to it.<br />It is a Read-Only and is used for updating the respective line item. |
| location                            | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) | Internal ID of the Location.                                                                                                                                            |
| price                               | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) | Internal ID of the Price Level of Item.<br />If the Rate is a Custom Price, pass "-1" as the Price Level Internal ID.                                                   |
| quantity                            | Double                                            |                                                                                                                                                                         |
| rate                                | String                                            | Rate field becomes read-only if the Price Level is other than the Custom Price (-1)                                                                                     |
| revRecEndDate                       | Long                                              | The date is accepted and returned as a Unix timestamp in seconds.                                                                                                       |
| revRecSchedule                      | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) | Internal ID of the Rev. Rec. Schedule.                                                                                                                                  |
| revRecStartDate                     | Long                                              | The date is accepted and returned as a Unix timestamp in seconds.                                                                                                       |
| tax1Amt                             | Double                                            |                                                                                                                                                                         |
| taxCode                             | [Common Data Types](docId\:LGKOy7mdXhvjzkl2nr9Ql) | Internal ID of the Tax Code.                                                                                                                                            |
| taxRate1                            | Double                                            |                                                                                                                                                                         |




