Nexus
NetSuite uses the term nexus to describe a tax jurisdiction or geographic area where you do business and which has its own tax regulations. For example, a nexus can be a country, municipality, city, state, province, county, or economic zone.
For more information, see Understanding Nexuses in SuiteTax.
This record is not a subrecord.
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 nexus record, and about the HTTP methods, request parameters, and operations available to this record. For details, see the REST API Browser’s nexus reference page.
For information about using the REST API Browser, see The REST API Browser.
Record ID
The record ID for the nexus REST record is nexus.
Prerequisites
The SuiteTax feature must be enabled.
Actions
The nexus record has the following actions through REST web services:
-
Submit new
-
Submit
-
Reset
-
Delete
Code Samples
This code sample shows how to post the nexus record:
POST /services/rest/record/v1/nexus { "country": "US", "state": "CA", "description": "California", "parentNexus": "1", "taxAgency": "2"
}
This code sample shows how to get the nexus record:
GET /services/rest/record/v1/nexus/13 { "links": [ { "rel": "self", "href": "https://barochpatrik-runbox-parity-deuf1-001.eng.netsuite.com/services/rest/record/v1/nexus/13" } ], "country": { "id": "US", "refName": "United States" }, "description": "California", "id": "13", "isInactive": false, "parentNexus": { "links": [ { "rel": "self", "href": "https://barochpatrik-runbox-parity-deuf1-001.eng.netsuite.com/services/rest/record/v1/nexus/1" } ], "id": "1", "refName": "US California" }, "state": { "links": [], "id": "CA", "refName": "California" }, "taxAgency": { "links": [ { "rel": "self", "href": "https://barochpatrik-runbox-parity-deuf1-001.eng.netsuite.com/services/rest/record/v1/vendor/2" } ], "id": "2", "refName": "Tax Agency CA" }, "taxDateFromFulfillment": false
}