Customer Subsidiary Relationship
NetSuite exposes the customer subsidiary relationship record to REST web services. This record enables you to manage a specific customerSubsidiaryRelationship record. You can also get a list of customer subsidiary relationship records. This record is not accessible through the user interface.
The REST API Browser includes information about the field names and field types of the customer subsidiary relationship record. It also includes the HTTP methods, request parameters, and operations available to this record. For details, see the REST API Browser’s customerSubsidiaryRelationship reference page.
For information about using the REST API Browser, see The REST API Browser.
Record ID
The record ID for the customer subsidiary relationship REST record is customerSubsidiaryRelationship.
Prerequisites
You must either use NetSuite OneWorld or have the Subsidiaries hidden feature enabled before you can use this record through REST web services.
Updatable Fields on the customerSubsidiaryRelationship Record
You can update the following fields on the customerSubsidiaryRelationship record:
-
custom fields (available on the customer record, Subsidiary subtab)
-
(externalid) - external id
Supported Operations
The following operations are supported for REST web services:
-
GET (Read, Search for a list of customer subsidiary relationship records)
-
POST (insert a record)
-
DELETE (a specific record)
-
GET (Read, Search a specific record)
-
PATCH (update a specific record)
-
PUT (insert or update a specific record)
Tax-related fields are not supported in REST.
Code Samples
The following code sample shows how to get a specific customerSubsidiaryRelationship record:
GET https://123456.suitetalk.api.netsuite.com/services/rest/record/v1/customersubsidiaryrelationship?q=entity
EQUAL 13 AND subsidiary EQUAL 5
The following code sample shows how to get the ID of a specific customerSubsidiaryRelationship record:
POST https://123456.suitetalk.api.netsuite.com/services/rest/query/v1/suiteql?limit=5
Header:
'prefer: transient'
'Content-Type: application/json'
Body:
'{ "q": "SELECT id FROM customerSubsidiaryRelationship WHERE entity = 13 AND subsidiary = 5"
}'
The following code sample shows how to set the externalId for a specific customerSubsidiaryRelationship record:
PATCH https://123456.suitetalk.api.netsuite.com/services/rest/record/v1/customersubsidiaryrelationship/1
Header:
'Content-Type: application/json'
Body:
'{ "externalId": "VSR1" }'