海关外贸
本数据域下各能力均通过统一网关调用。请求体须指定 domain=trade 及对应的 type。
| 能力名称 | type | 说明 |
|---|---|---|
| 海关编码查询 | hs_code_search |
按海关编码或税则品名（法定名称）检索税则条目。返回编码、品名、法定单位、出口退税率、监管条件、检验检疫与编码状态。分页对齐统一查询：条数用 top_k，翻页用 filters.offset。已知商品俗称需归类时请用 trade.hs_classify；取完整税率/申报要素用 trade.hs_code_detail。 |
| 海关编码详情 | hs_code_detail |
按 10 位海关编码查询完整税则：最惠国/暂定/普通进口税率、出口税率、增值税、消费税、出口退税、法定单位、申报要素、监管条件、检验检疫、协定税率 CT、RCEP、CIQ 等。编码可来自 trade.hs_code_search / trade.hs_classify 的 hits[].HSCode。本接口无分页。 |
| 海关归类查询 | hs_classify |
按具体商品名称（俗称/型号等）归类，返回对应海关编码、税则品名、法定单位、出口退税、监管条件、检验检疫与编码状态。分页对齐统一查询：条数用 top_k，翻页用 filters.offset。取完整税率与申报要素请再用 trade.hs_code_detail。 |
| 海关类目查询 | hs_code_map |
按 10 位海关编码查询所属税则类目与索引目录（章/目/子目层级）。返回 CategoryId、CategoryName、List（编码→名称映射）、Count。通用接口，购买税则/归类能力附赠。本接口无分页。 |
| 海关编码更新记录 | hs_code_updates |
按时间范围查询海关编码字段变更（新增/删除/修改）。range：7d 最近 7 天、30d 最近 30 天（默认）、3m 最近 3 个月。分页对齐统一查询：条数用 top_k，翻页用 filters.offset（本地切片）。通用接口，购买税则/归类能力附赠；日调用上限较低，请按需查询。 |
各能力的 filters、返回字段与调用示例见对应能力页；统一约定见 统一查询。