Invoice
The invoice record exposes an invoice to REST web services.
To access this record in NetSuite, go to Transactions > Sales > Create Invoices.
For information about the invoice record user interface, see Invoices.
There are no prerequisites for using this record through REST web services.
REST web services do not support legacy tax features. To work with taxation through REST web services, you must have the SuiteTax feature enabled. For more information about using SuiteTax, see SuiteTax.
The REST API Browser includes information about the field names and field types of the invoice record, and about the HTTP methods, request parameters, and operations available to this record. For details, see the REST API Browser’s invoice reference page.
For information about using the REST API Browser, see The REST API Browser.
Record ID
The record ID for an invoice REST record is invoice.
Usage Notes
To use the Choose Team and Update Customer fields in the Sales Team subtab, the Team Selling feature must be enabled. To enable Team Selling, go to Setup > Company > Enable Features > CRM. Check the Team Selling box, and then click Save.
The Multi-Partner Management Feature must also be enabled to use the Update Customer field in the Relationships subtab. An administrator can enable the Multi-Partner Management feature at Setup > Company > Setup Tasks > Enable Features. Click the CRM subtab, and then under Partners, check the Multi-Partner Management box. Click Save.
Code Samples
These samples show common use cases for invoices.
In the following examples,
-
<accountID> represents your account ID.
-
<recordKey> represents the database key for the invoice.
Creating a New Invoice With an Item
POST: https://demo123.suitetalk.api.netsuite.com/services/rest/record/v1/invoice { "asofdate": "2021-03-15", "enddate": "2021-06-15", "entity": { "id": "220" }, "item": { "items": [ { "amount": 1000.0, "item": { "id": "144" } } ] }, "startdate": "2021-03-15", "subsidiary": { "id": "1" }, "terms": { "id": "1" }
Creating a New Invoice With a Billable Item
POST: https://demo123.suitetalk.api.netsuite.com/services/rest/record/v1/invoice { "asofdate": "2021-03-15", "entity": { "id": "221" }, "itemcost": { "items": [ { "apply": true, "doc": { "id": "310" }, "line": 1 } ] }
}
Creating a New Invoice With Billable Time
POST: https://demo123.suitetalk.api.netsuite.com/services/rest/record/v1/invoice { "entity": { "id": "220" }, "time": { "items": [ { "apply": true, "doc": { "id": "1" }, "rate": 10 } ] }
}
Updating an Existing Invoice
The transaction date and rate are in line item 1.
PATCH: https://demo123.suitetalk.api.netsuite.com/services/rest/record/v1/invoice/<recordKey> { "item": { "items": [ { "line": 1, "rate": 50.00 } ] }, "tranDate": "2021-03-05"
}
Setting the Sales Order's Sales Team Members to Match Sales Group 164
"salesGroup": {
"id": 164 }
Update the Customer's Partner Team to Match the Transaction Partners
"syncPartnerTeams": true
Update the Customer's Sales Team to Match the Transaction Sales Team
"syncSalesTeams": true