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.
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"
}