日本語のコンテンツは機械翻訳されており、補助的な参照を目的としています。機械翻訳の精度は保証できません。英語版が正となります。また、現時点では検索機能は日本語での検索をサポートしていません。翻訳に関するフィードバックについては、docs@zuora.comに送信してください。

Zuora Tax Rate Period Settings

Last updated

Aug 26, 2024
Save as PDF

Describes managing tax rate periods, including retrieval, creation, updating, and deletion through the Settings API.

Create Tax Rate Periods

To create a new Tax Rate Period, see the following request and a sample of 200 response:

HTTP request:

POST https://rest.apisandbox.zuora.com/settings/tax-rate-periods/{tax id}

Request body:

Key Value

Curl POST https://rest.apisandbox.zuora.com/settings/tax-rate-periods/{tax id}

Authorization Auth Type - Bearer Token <oauth_token>

Headers

Authorization - Bearer <oauth_token>
Content-Type - application/json

Body

--data {

"endDate": "string | null",

"id": "string",

"taxCodeId": "string",

"startDate": "string"

}

Example:

1{   "endDate": "2024-12-31",   
2    "id": "8ad09a3f7c7a82be017c7abf8e0a0001",
3    "taxCodeId": "47d2609fda26e8f15d7954299457f92e",
4    "startDate": "2024-01-01"
5 }

Response body:

1{
2   "id": "8ad0845b917ed52101918d374d8c7afb",
3   "startDate": "2024-01-01",
4   "endDate": "2024-12-31",
5   "taxCodeId": "47d2609fea983539f5ccb72c1c5a7540",
6   "success": true
7}

Get Tax Rate Periods

See the following request and a sample of 200 response to get the tax rate periods.

HTTP request:

GET https://rest.apisandbox.zuora.com/settings/tax-rate-periods

Request body:

Key	Value
Curl	GET`https://rest.apisandbox.zuora.com/settings/tax-rate-periods`
Authorization	Auth Type - Bearer Token <oauth_token>
Headers	Authorization - Bearer <oauth_token> Content-Type - application/j

Response body:

01{
02   "taxRatePeriods": [
03       {
04           "id": "47d2609f879ed615ad13264c0f0168ef",
05           "startDate": "2013-01-01",
06           "endDate": null,
07           "taxCodeId": "47d2609fea983539f5ccb72c1c5a7540"
08       },
09       {
10           "id": "8ad081dd90a5e74f0190ba7523d106b4",
11           "startDate": "2024-07-16",
12           "endDate": null,
13           "taxCodeId": "8ad09c9f8cf2eb2b018cf80cf14e1b13"
14       },
15       {
16           "id": "47d2609fcfa0611147fc0ef6a3eec6ea",
17           "startDate": "2012-01-01",
18           "endDate": null,
19           "taxCodeId": "47d2609f678df74e6ee2c68fb3572aa1"
20       }
21   ],
22   "success": true
23}

Update Tax Rate Periods

To update the Tax rate period, see the following request and a sample of 200 response:

HTTP request:

PUT https://rest.apisandbox.zuora.com/settings/tax-rate-periods/{id}

Request body:

Key	Value
Curl	PUT `https://rest.apisandbox.zuora.com/settings/tax-rate-periods/{id}`
Authorization	Auth Type - Bearer Token <oauth_token>
Headers	Authorization - Bearer <oauth_token> Content-Type - application/j
Body	{ "startDate": "string", "endDate": "srting" }

Response body:

1{
2   "id": "47d2609f879ed615ad13264c0f0168ef",
3   "startDate": "2025-01-01",
4   "endDate": "2025-12-31",
5   "taxCodeId": "47d2609fea983539f5ccb72c1c5a7540",
6   "success": true
7}

Delete Tax Rate Periods

To delete a tax rate period, see the following request and a sample of 200 response:

HTTP request:

DELETE https://rest.apisandbox.zuora.com/settings/tax-rate-periods/{id}

Request body:

Key	Value
Curl	DELETE `https://rest.apisandbox.zuora.com/settings/tax-rate-periods/{id}`
Authorization	Auth Type - Bearer Token <oauth_token>
Headers	Authorization - Bearer <oauth_token> Content-Type - application/j

Response body:

1{
2   "success": true
3}