海关编码获取接口 - 开放平台API

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

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

请求参数

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

示例

{
    "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": "改良种用家牛"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

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
}