Tax Type
A tax type is associated with a nexus, and tells the system where to post the tax amounts on the balance sheet. For each nexus, you must assign at least one account in your general ledger for posting tax.
For more information about tax types in SuiteTax, see Understanding Tax Types and Tax Codes in SuiteTax.
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 tax type record, and about the HTTP methods, request parameters, and operations available to this record. For details, see the REST API Browser’s taxType reference page.
For information about using the REST API Browser, see The REST API Browser.
Record ID
The record ID for a taxtype REST record is taxType.
Subrecord
This record has the taxTypeNexusAccounts subrecord.
Prerequisites
The SuiteTax features must be enabled.
Actions
The tax type record has the following actions through REST web services:
-
Submit new
-
Submit
-
Reset
-
Delete
Code Samples
This code sample shows how to post the tax type record:
POST /services/rest/record/v1/taxType { "country": "US", "name": "US Tax Type", "description": "US Tax Type", "doesNotAddToTotal": true, "nexusAccounts": { "items": [ { "nexus": { "id": "1" }, "payablesAccount": { "id": "24" }, "receivablesAccount": { "id": "6" } } ] }
}
This code sample shows how to get the tax type records:
GET /services/rest/record/v1/taxType/13
{ "links": [ { "rel": "self", "href": "https://barochpatrik-runbox-parity-deuf1-001.eng.netsuite.com/services/rest/record/v1/taxType/13" } ], "country": { "id": "US", "refName": "United States" }, "description": "US Tax Type", "doesNotAddToTotal": true, "id": "13", "isInactive": false, "name": "US Tax Type", "nexusAccounts": { "links": [ { "rel": "self", "href": "https://barochpatrik-runbox-parity-deuf1-001.eng.netsuite.com/services/rest/record/v1/taxtype/13/nexusAccounts" } ] }, "postToItemCost": false, "reverseCharge": false, "taxInNetAmount": false
}