开放平台API
  • 海关数据
    • 出口报关单获取接口POST
    • 进口报关单获取接口POST
    • 进口税单获取接口POST
    • 保证金获取接口POST
    • 海关编码获取接口POST
    • 退税商品编码获取接口POST
  • 进项数据
  • 销项数据
  • 退税数据
  • 企业数据
  • 开票服务
  • 其他数据服务
logoPowered by Apifox
  1. 海关数据

海关编码获取接口

POST/post/rest/hscode/dii

此接口支持通过关键字（商品编码，商品名称）查询海关商品编码数据（含：商品编码，商品名称，计量单位，法定第一单位，增值税率，出口税率，进口优惠税率，出口退税税率，申报要素，所属类，章，品目等信息），帮助外贸企业提升工作效率，增加企业收益。

请求参数

Header 参数
Content-Type
string 
可选
示例值:
application/json
Body 参数application/json
authorize
object 
安全凭证
必需
appSecId
string 
密钥ID
必需

平台随机生成

appSec
string 
签名串
必需

根据密钥ID和KEY生成的签名串

globalInfo
object 
接口信息
必需
appId
string 
接口ID
必需

例：HGBM

version
string 
接口版本号
必需

例：V1.0

interfaceCode
string 
接口编码
必需

例：HSCODE.GET

enterpriseCode
string 
企业编码
必需
dataExchangeId
string 
接口数据加密
必需

例：默认值dataExchangeId

data
object 
获取条件参数
必需

由获取条件参数通过用Base64加密生成的字符串

code
string 
海关编码
可选
name
string 
商品名称
可选
endDate
string 
更新结束日期
可选

格式：yyyy-MM-dd

pageSize
integer 
页数
必需

默认10条

page
integer 
当前第几页
必需

默认从1开始

startDate
string 
更新开始日期
可选

格式：yyyy-MM-dd

示例1
{
    "authorize": {
        "appSecId": "2AE5415E6FBD2BE9E1B011E914FCA94C",
        "appSec": "S6+TfEEeGkV0M6+51YJXY3KioGw="
    },
    "globalInfo": {
        "appId": "HGBM",
        "version": "V1.0",
        "interfaceCode": "HSCODE.GET",
        "enterpriseCode": "ZSC",
        "dataExchangeId": "dataExchangeId"
    },
    "data": "eyJzdGFydERhdGUiOiIiLCJlbmREYXRlIjoiIiwicGFnZSI6MSwicGFnZVNpemUiOjIwLCJjb2RlIjoiIiwibmFtZSI6IuaUueiJr+enjeeUqOWutueJmyJ9"
}

//data加密前的数据
{
    "startDate": "",
    "endDate": "",
    "page": 1,
    "pageSize": 20,
    "code": "",
    "name": "改良种用家牛"
}

示例代码

返回响应

成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
data
object 
返回数据参数
必需

由返回的参数通过用Base64加密生成的字符串

result
array [object {40}] 
海关编码列表数据
必需
totalRows
integer 
数据的总条数
必需
returnStateInfo
object 
接口状态信息
必需
returnCode
string 
返回状态编码
必需

例：0000

returnMessage
string 
返回信息
必需

例：处理成功

示例
{
    "data": "eyJyZXN1bHQiOlt7ImNpcUNvZGUiOiIwMTAyMjEwMDAwMTAxIC...",
    "returnStateInfo": {
        "returnCode": "0000",
        "returnMessage": "处理成功"
    }
}

//data加密前的数据
{
    "result": [
        {
            "ciqCode": "0102210000101 ",
            "ciqName": " 改良种用家牛(种牛)",
            "cksl": "0",
            "cktssl": "9",
            "count": null,
            "dw": null,
            "elem": null,
            "firstUnit": "千克",
            "gxDate": 1671533358000,
            "hsBmkId": "12",
            "hsCode": "0102210000",
            "hsName": "改良种用家牛",
            "id": null,
            "jgtj": "AB",
            "jkptsl": "0",
            "jkyhsl": "0",
            "jyjylb": "P/Q",
            "lmc": "活动物;动物产品",
            "lno": "01",
            "note": null,
            "nsrdjNo": null,
            "optDate": null,
            "optId": null,
            "plist": null,
            "pmmc": "牛:",
            "pmno": "02",
            "qyId": null,
            "qyMc": null,
            "remark": null,
            "rn": 1,
            "sbys": "1:品名;2:品牌类型;3:出口享惠情况;4:是否改良种用;5:GTIN;6:CAS;7:其他;",
            "secondUnit": "头",
            "status": null,
            "xfsl": "0",
            "zdsl": "0",
            "zmc": "活动物",
            "zno": "01",
            "zt": "1",
            "zzjgId": null,
            "zzsl": "9"
        },
        {
            "ciqCode": "0102210000102",
            "ciqName": "改良种用家牛(屠宰牛)",
            "cksl": "0",
            "cktssl": "9",
            "count": null,
            "dw": null,
            "elem": null,
            "firstUnit": "千克",
            "gxDate": 1671533358000,
            "hsBmkId": "13",
            "hsCode": "0102210000",
            "hsName": "改良种用家牛",
            "id": null,
            "jgtj": "AB",
            "jkptsl": "0",
            "jkyhsl": "0",
            "jyjylb": "P/Q",
            "lmc": "活动物;动物产品",
            "lno": "01",
            "note": null,
            "nsrdjNo": null,
            "optDate": null,
            "optId": null,
            "plist": null,
            "pmmc": "牛:",
            "pmno": "02",
            "qyId": null,
            "qyMc": null,
            "remark": null,
            "rn": 2,
            "sbys": "1:品名;2:品牌类型;3:出口享惠情况;4:是否改良种用;5:GTIN;6:CAS;7:其他;",
            "secondUnit": "头",
            "status": null,
            "xfsl": "0",
            "zdsl": "0",
            "zmc": "活动物",
            "zno": "01",
            "zt": "1",
            "zzjgId": null,
            "zzsl": "9"
        },
        {
            "ciqCode": "0102210000103",
            "ciqName": "改良种用家牛(其他用途牛)",
            "cksl": "0",
            "cktssl": "9",
            "count": null,
            "dw": null,
            "elem": null,
            "firstUnit": "千克",
            "gxDate": 1671533358000,
            "hsBmkId": "14",
            "hsCode": "0102210000",
            "hsName": "改良种用家牛",
            "id": null,
            "jgtj": "AB",
            "jkptsl": "0",
            "jkyhsl": "0",
            "jyjylb": "P/Q",
            "lmc": "活动物;动物产品",
            "lno": "01",
            "note": null,
            "nsrdjNo": null,
            "optDate": null,
            "optId": null,
            "plist": null,
            "pmmc": "牛:",
            "pmno": "02",
            "qyId": null,
            "qyMc": null,
            "remark": null,
            "rn": 3,
            "sbys": "1:品名;2:品牌类型;3:出口享惠情况;4:是否改良种用;5:GTIN;6:CAS;7:其他;",
            "secondUnit": "头",
            "status": null,
            "xfsl": "0",
            "zdsl": "0",
            "zmc": "活动物",
            "zno": "01",
            "zt": "1",
            "zzjgId": null,
            "zzsl": "9"
        },
        {
            "ciqCode": "0102290000101 ",
            "ciqName": " 非改良种用家牛(种牛)",
            "cksl": "0",
            "cktssl": "9",
            "count": null,
            "dw": null,
            "elem": null,
            "firstUnit": "千克",
            "gxDate": 1671533358000,
            "hsBmkId": "15",
            "hsCode": "0102290000",
            "hsName": "非改良种用家牛",
            "id": null,
            "jgtj": "4xAB",
            "jkptsl": "30",
            "jkyhsl": "10",
            "jyjylb": "P/Q",
            "lmc": "活动物;动物产品",
            "lno": "01",
            "note": null,
            "nsrdjNo": null,
            "optDate": null,
            "optId": null,
            "plist": null,
            "pmmc": "牛:",
            "pmno": "02",
            "qyId": null,
            "qyMc": null,
            "remark": null,
            "rn": 4,
            "sbys": "1:品名;2:品牌类型;3:出口享惠情况;4:是否改良种用;5:GTIN;6:CAS;7:其他;",
            "secondUnit": "头",
            "status": null,
            "xfsl": "0",
            "zdsl": "0",
            "zmc": "活动物",
            "zno": "01",
            "zt": "1",
            "zzjgId": null,
            "zzsl": "9"
        },
        {
            "ciqCode": "0102290000102",
            "ciqName": "非改良种用家牛(屠宰牛)",
            "cksl": "0",
            "cktssl": "9",
            "count": null,
            "dw": null,
            "elem": null,
            "firstUnit": "千克",
            "gxDate": 1671533358000,
            "hsBmkId": "16",
            "hsCode": "0102290000",
            "hsName": "非改良种用家牛",
            "id": null,
            "jgtj": "4xAB",
            "jkptsl": "30",
            "jkyhsl": "10",
            "jyjylb": "P/Q",
            "lmc": "活动物;动物产品",
            "lno": "01",
            "note": null,
            "nsrdjNo": null,
            "optDate": null,
            "optId": null,
            "plist": null,
            "pmmc": "牛:",
            "pmno": "02",
            "qyId": null,
            "qyMc": null,
            "remark": null,
            "rn": 5,
            "sbys": "1:品名;2:品牌类型;3:出口享惠情况;4:是否改良种用;5:GTIN;6:CAS;7:其他;",
            "secondUnit": "头",
            "status": null,
            "xfsl": "0",
            "zdsl": "0",
            "zmc": "活动物",
            "zno": "01",
            "zt": "1",
            "zzjgId": null,
            "zzsl": "9"
        },
        {
            "ciqCode": "0102290000103",
            "ciqName": "非改良种用家牛(其他用途牛)",
            "cksl": "0",
            "cktssl": "9",
            "count": null,
            "dw": null,
            "elem": null,
            "firstUnit": "千克",
            "gxDate": 1671533358000,
            "hsBmkId": "17",
            "hsCode": "0102290000",
            "hsName": "非改良种用家牛",
            "id": null,
            "jgtj": "4xAB",
            "jkptsl": "30",
            "jkyhsl": "10",
            "jyjylb": "P/Q",
            "lmc": "活动物;动物产品",
            "lno": "01",
            "note": null,
            "nsrdjNo": null,
            "optDate": null,
            "optId": null,
            "plist": null,
            "pmmc": "牛:",
            "pmno": "02",
            "qyId": null,
            "qyMc": null,
            "remark": null,
            "rn": 6,
            "sbys": "1:品名;2:品牌类型;3:出口享惠情况;4:是否改良种用;5:GTIN;6:CAS;7:其他;",
            "secondUnit": "头",
            "status": null,
            "xfsl": "0",
            "zdsl": "0",
            "zmc": "活动物",
            "zno": "01",
            "zt": "1",
            "zzjgId": null,
            "zzsl": "9"
        }
    ],
    "totalRows": 6
}
最后修改时间： 1 年前