1. SuiteCloud Platform
  2. SuiteTalk Web Services
  3. SuiteTalk REST Web Services Records Guide
  4. REST Web Services Supported Records
  5. Sales Order

Sales Order

A sales order record exposes a sales order to REST web services. This record has one subrecord: salesOrderItem.

To access this record in NetSuite, go to Transactions > Sales > Enter Sales Order.

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 sales order record, and about the HTTP methods, request parameters, and operations available to this record. For details, see the REST API Browser’s sales order reference page.

For information about using the REST API Browser, see The REST API Browser.

Record ID

The record ID for a sales order REST record is salesorder.

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.

When you transform a sales order into an item fulfillment, you must include the inventoryLocation field in the request body. For more information, see Transforming Sales Orders with the Intercompany Cross-Subsidiary Feature

            POST /record/v1/salesOrder/<source Sales Order id>/!transform/itemFulfillment
{
        "inventoryLocation": {
                "id" : <location id>
        }
...
}

You can create a sales order with an ItemGroup item but it is not possible to change or update the quantity, rate, and amount value of the member items using the create request. You can only update the quantity, rate, and amount values using the PATCH request.

Code Samples

These samples show common use cases for sales orders. The example ID is 1504.

A Basic GET Request of a Sales Order

              GET: https://demo123.suitetalk.api.netsuite.com/services/rest/record/v1/salesorder/1504

Updating a Sales Order

              PATCH: https://demo123.suitetalk.api.netsuite.com/services/rest/record/v1/salesorder/1504
{"istaxable":false}

Updating the Amount of a Line Item Within a Sales Order

              {
"item": {
"items": [{
"line": 1,
"item": {
"id": 328
},
"amount": 54.0
}]
}
}

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