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

Connect Tax Engines Settings

Last updated

Mar 18, 2024
Save as PDF

Describes how to create, retrieve, update, and delete Connect Tax Engines through the Settings API.

Create a Connect Tax Engine

To create a new Connect Tax Engine, see the following request and a sample of 200 response.

HTTP request:

POST https://rest.zuora.com/settings/tax-engines/connector

Request body:

1{
2    "name": "Connect Tax Engine Test",
3    "taxEngineType": "ConnectTaxEngine",
4    "connectUrl": "https://tax.apps.zuora.com/api/v1/tax",
5    "password": "e3dce34b821e90d8712ead3f688xxxxx"
6}

The following fields are required in the request body:

name
taxEngineType
password: The unique 32-character API Token of the Tax app. To obtain your API Token:

From the left-hand navigation menu under Marketplace, click the name of the tax app.
Select the instance you would like to launch.
Navigate to the APP INFORMATION tab, the API token is listed near the top of the tab.

connectUrl

Response body:

1{
2    "id": "8ad08d3b7ceb0df5017cfe084449246e",
3    "name": "Connect Tax Engine Test",
4    "taxEngineType": "ConnectTaxEngine",
5    "connectUrl": "https://tax.apps.zuora.com/api/v1/tax",
6    "customFieldMetas": [],
7    "success": true
8}

Get a Connect Tax Engine

To get a specific Connect Tax Engine, the Id of the specific Connect Tax Engine is required as a path parameter. See the following request and a sample of 200 response.

HTTP request:

GET https://rest.zuora.com/settings/tax-engines/connector/{id}

Response body:

1{
2    "id": "2c92c0f8680e602b016812ae66354f16",
3    "name": "test tax engine 2021",
4    "taxEngineType": "ConnectTaxEngine",
5    "connectUrl": "https://tax.apps.zuora.com/api/v1/tax",
6    "customFieldMetas": [],
7    "success": true
8}

Update a Connect Tax Engine

To update a specific Connect Tax Engine, the Id of the specific Connect Tax Engine is required as a path parameter. See the following request and a sample of 200 response.

HTTP request:

PUT https://rest.zuora.com/settings/tax-engines/connector/{id}

Request body:

1{
2    "name":"Connect Tax Engine Test One",
3    "customFieldMetas": [
4        {
5            "customFieldMetaId": "2c92c0f9644627ff01645dc0c0de4fac",
6            "useLatestValue": true
7        }]
8}

Note: Do not include the taxEngineType parameter in the request body.

Response body:

01{
02    "id": "2c92c0f8680e602b016812ae66354f16",
03    "name": "Connect Tax Engine Test One",
04    "taxEngineType": "ConnectTaxEngine",
05    "connectUrl": "https://tax.apps.zuora.com/api/v1/tax",
06    "customFieldMetas": [
07        {
08            "customFieldMetaId": "2c92c0f9644627ff01645dc0c0de4fac",
09            "useLatestValue": true
10        }
11    ],
12    "success": true
13}

Delete a Connect Tax Engine

To delete a specific Connect Tax Engine, the Id of the specific Connect Tax Engine is required as a path parameter. See the following request and a sample of 200 response.

HTTP request:

DELETE https://rest.zuora.com/settings/tax-engines/connector/{id}

Response body:

1{
2    "success": true
3}

Global Hub Tax Engine Settings

Describes how to create, retrieve, and update the Global Tax Hub Engine through the Settings API. For more information, see Global Hub Tax Engine Settings.