# 税费 - 类别 #

本节列出了所有可用于创建、编辑或以其他方式操作税费类别的 API 端点。

## 税费属性 ##

| 属性     | 类型   | 描述                                                       |
| -------- | ------ | ---------------------------------------------------------- |
| `slug`   | string | 税费类别标识符 <i class="label label-info">只读</i>        |
| `name`   | string | 税费类别名称                                               |

## 创建税率类别 ##

此 API 可帮助您创建新的税率类别。

### HTTP 请求 ###

<div class="api-endpoint">
	<div class="endpoint-data">
		<i class="label label-post">POST</i>
		<h6>/wc-api/v3/taxes/classes</h6>
	</div>
</div>

```shell
curl -X POST https://example.com/wc-api/v3/taxes/classes \
    -u consumer_key:consumer_secret \
    -H "Content-Type: application/json" \
    -d '{
  "tax_class": {
    "name": "Zero Rate"
  }
}'
```

```javascript
var data = {
  tax_class: {
    name: 'Zero Rate'
  }
};

WooCommerce.post('taxes/classes', data, function(err, data, res) {
  console.log(res);
});
```

```php
<?php
$data = [
    'tax_class' => [
        'name' => 'Zero Rate'
    ]
];

print_r($woocommerce->post('taxes/classes', $data));
?>
```

```python
data = {
    "tax_class": {
        "name": "Zero Rate"
    }
}

print(wcapi.post("taxes/classes", data).json())
```

```ruby
data = {
  tax_class: {
    name: "Zero Rate"
  }
}

woocommerce.post("taxes/classes", data).parsed_response
```

> JSON 响应示例：

```json
{
  "tax_class": {
    "slug": "zero-rate",
    "name": "Zero Rate"
  }
}
```

<aside class="notice">
	此端点自 WooCommerce 2.5 版本起引入。
</aside>

## View List of Tax Classes ##

This API helps you to view all the tax classes.

### HTTP Request ###

<div class="api-endpoint">
	<div class="endpoint-data">
		<i class="label label-get">GET</i>
		<h6>/wc-api/v3/taxes/classes</h6>
	</div>
</div>

```shell
curl https://example.com/wc-api/v3/taxes/classes \
	-u consumer_key:consumer_secret
```

```javascript
WooCommerce.get('taxes/classes', function(err, data, res) {
  console.log(res);
});
```

```php
<?php print_r($woocommerce->get('taxes/classes')); ?>
```

```python
print(wcapi.get("taxes/classes").json())
```

```ruby
woocommerce.get("taxes/classes").parsed_response
```

> JSON response example:

```json
{
  "tax_classes": [
    {
      "slug": "standard",
      "name": "Standard Rate"
    },
    {
      "slug": "reduced-rate",
      "name": "Reduced Rate"
    },
    {
      "slug": "zero-rate",
      "name": "Zero Rate"
    }
  ]
}
```

<aside class="notice">
	Endpoint introduced since WooCommerce 2.5.
</aside>

## 删除税率类别 ##

此 API 可帮助您删除一个税率类别。

<aside class="warning">
	此操作也将删除所选类别中的所有税率。
</aside>

### HTTP 请求 ###

<div class="api-endpoint">
	<div class="endpoint-data">
		<i class="label label-delete">DELETE</i>
		<h6>/wc-api/v3/taxes/classes/&lt;slug&gt;</h6>
	</div>
</div>

```shell
curl -X DELETE https://example.com/wc-api/v3/taxes/classes/zero-rate \
	-u consumer_key:consumer_secret
```

```javascript
WooCommerce.delete('taxes/classes/zero-rate', function(err, data, res) {
  console.log(res);
});
```

```php
<?php print_r($woocommerce->delete('taxes/classes/zero-rate')); ?>
```

```python
print(wcapi.delete("taxes/classes/zero-rate").json())
```

```ruby
woocommerce.delete("taxes/classes/zero-rate").parsed_response
```

> JSON 响应示例：

```json
{
  "message": "Deleted tax_class"
}
```

<aside class="notice">
	此端点自 WooCommerce 2.5 版本引入。
</aside>

## 查看税率数量 ##

此 API 允许您检索所有税率的数量。

### HTTP 请求 ###

<div class="api-endpoint">
	<div class="endpoint-data">
		<i class="label label-get">GET</i>
		<h6>/wc-api/v3/taxes/classes/count</h6>
	</div>
</div>

```shell
curl https://example.com/wc-api/v3/taxes/classes/count \
	-u consumer_key:consumer_secret
```

```javascript
WooCommerce.get('taxes/classes/count', function(err, data, res) {
  console.log(res);
});
```

```php
<?php print_r($woocommerce->get('taxes/classes/count')); ?>
```

```python
print(wcapi.get("taxes/classes/count").json())
```

```ruby
woocommerce.get("taxes/classes/count").parsed_response
```

> JSON 响应示例：

```json
{
  "count": 3
}
```

<aside class="notice">
	此端点自 WooCommerce 2.5 版本引入。
</aside>