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.

Note:

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

Note:

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 

            

Related Topics

General Notices