通用接口

该接口为通用接口,购买其他两种接口都附赠该接口。类目查询:每天最大访问次数2000次,每月最大访问次数60000次。编码更新记录:每天最大访问次数10次,每月最大访问次数300次。

1. 类目查询

接口地址
http://api.hsciq.com/CodeMap/{ApiId}/{Code}

具体参数

参数描述
ApiIdApi标识
Code10位编码

返回参数

参数描述
CategoryId类目编号
CategoryName类目名称
List索引目录
Count目录内税则项目合计数

返回样例 (JSON)

{
  "CategoryId": 2,
  "CategoryName": "第二类 植物产品",
  "List": {
    "07": "食用蔬菜、根及块茎",
    "0712": "干蔬菜,整个、切块、切片、破碎或制成粉状,但未经进一步加工的",
    "071290": "其他蔬菜;什锦蔬菜",
    "07129099": "其他"
  },
  "Count": 5
}

2. 编码更新记录

接口地址
http://api.hsciq.com/CodeUpdates/{ApiId}?range={range}

具体参数

参数描述
ApiIdApi标识(路径参数)
range时间范围(查询参数):7d 最近7天,30d 最近30天(默认),3m 最近3个月

返回参数

参数描述
items更新记录数组
items[].hsCode海关编码
items[].field变更字段名
items[].changeType变更类型:创建 / 删除 / 修改
items[].dataType数据类型(CNCode)
items[].before变更前的值
items[].after变更后的值
items[].createTime变更时间
totalCount总记录数

返回样例 (JSON)

{
  "items": [
    {
      "hsCode": "8471300000",
      "field": "ExportTaxRebateRate",
      "changeType": "修改",
      "dataType": "CNCode",
      "before": "13",
      "after": "9",
      "createTime": "2026-05-15T10:30:00"
    },
    {
      "hsCode": "0101210000",
      "field": "Name",
      "changeType": "修改",
      "dataType": "CNCode",
      "before": "改良种用马",
      "after": "改良种用马(濒危除外)",
      "createTime": "2026-05-14T08:00:00"
    }
  ],
  "totalCount": 2
}